Validation & Quality Checks
Run the automated validation suite locally:
# Install the pinned toolchain (once)
bun install
# Fast runner frontmatter contract check (~1s, pure AST comparison)
bun run contract:check
# Render all diagrams to diagrams/
bun run render-diagrams
# Validate frontmatter, symlinks, templates, scripts, mermaid syntax & a11y
bun run validate
# Unit tests for every script under scripts/
bun test scripts/
# Trigger prompts vs the Snipset database (skips cleanly where no database exists)
bun run snippets:check
# Fast knowledge graph verification (coverage and boundary rules, ~2s)
bun scripts/vault-index-verify.mjs --no-graphify
# OpenCode history exporter dry run
bun run export:history --dry-run --limit 1
Or run the whole gate in order with bun run ci. For a commit or PR, run bun run ci:targeted instead and quote its --rencana plan; it chooses the full CI itself when the change needs it.
Verifies:
- YAML frontmatter syntax (
name,description,triggers). - Master file integrity, the debt-sweep contract, and the estimated token budget (~34k tokens, measured at ~4 chars/token).
- Symlink validity in
skills/super-ultra-code-plan/SKILL.md. - Presence of all required templates and executable scripts.
- Mermaid syntax validity for every
```mermaidblock in the repo (exits 1 on any error). accTitleandaccDescrpresent on every diagram.- Both mermaid config files parse and pin
theme+fontFamily. - The committed README hero exists in light and dark.
ultra-plan-runnerenforces the visual map: task headings, task nodes, anddepends_onmatching the Mermaid edges in both directions.- Trigger snippets carry the mandatory subagent contract and use Bun rather than the prohibited runtimes.
- The Confirmation Protocol is pinned (block 3l of
scripts/validate-skill.mjs):sucp-rulesholds the section and its key rules, the orchestrator and every phase skill point at it by name, the debt sweep and its follow-up template state the 4-option cap, and the old typed-approval phrases (wait for explicit yes,nod sufficient,wait for explicit approval before plan) are gone. TheCONFIRMATIONS:paragraph in every trigger snippet is pinned bybun test scripts/. snippets.manifest.jsonis consistent: valid, complete, no duplicate uuid or keyword, and every trigger snippet is tracked.- The plan-publishing contract is documented: publisher CLI reference, idempotency marker, and a valid
plans.publish.json.
Not covered by bun run ci, on purpose: mirror:check, which needs a vault this runner
cannot see. Run it locally when you own the vault.