@jtf19/vibecoding-kit 0.1.0

package/tools/vibe-runtime/runtime-cli-usage.mjs

@@ -0,0 +1,316 @@
+const runtimeCliUsageHeader = `Vibecoding Runtime
+
+Usage:
+`;
+
+const runtimeCliUsageCommands = `  node tools/vibe-runtime/index.mjs entry --advice --intent <feature|refactor|architecture|plan|parallel|workspace|subagent|debug|implementation|review|review-feedback|skill|context|completion> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs entry --contract [--intent <kind>|--prompt <text>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs status [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs validate-handoff --from-file <path> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs record-handoff --from-file <path> [--root <path>]
+  node tools/vibe-runtime/index.mjs next --dry-run [--dispatch-intent] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs next --confirm --dispatch [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --show <event-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --verify <event-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --claim <event-file> --actor <id> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --ack <event-file> --actor <id> --status <picked|skipped|failed> [--reason <text>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --claims [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --pickup <event-file> [--platform <claude|cursor|codex>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --pickup-verify <event-file> [--platform <claude|cursor|codex>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs dispatches --pickup-dry-run <event-file> [--platform <claude|cursor|codex>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --from-dispatch <event-file> --dry-run [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --preflight [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --from-dispatch <event-file> --preflight [--actor <id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --from-dispatch <event-file> --candidate [--actor <id>] [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --approval-package --approval <candidate-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --from-dispatch <event-file> --confirm --actor <id> [--run] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs execute --from-dispatch <event-file> --confirm --actor <id> --run --auto-run --approval <approval-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs actions --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs actions --show <action-id> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs actions --verify <action-id> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs approvals --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs approvals --show <approval-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs approvals --verify <approval-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs approvals --transition <approval-file> --status <approved|rejected|expired|revoked> --actor <id> --reason <text> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs policies --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs policies --summary [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs policies --list|--show <profile> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs queue --scan [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs queue --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs queue --show <queue-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs queue --verify <queue-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs leases --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs leases --show <lease-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs leases --verify <lease-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --preview [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --classify [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --apply <classification-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --list-classifications [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --show-classification <classification-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --verify-classification <classification-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --show <recovery-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs recovery --verify <recovery-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs observability --summary [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs readiness --score [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs readiness --gates [--from-file <local-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --plan [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --from-hook <hook-intent-file> --plan [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --once [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --once --recover [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --show <plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler --verify <plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler-policies --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs scheduler-policies --show <profile> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs retry --list-packages [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs retry --show-package <retry-package-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs retry --verify-package <retry-package-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs retry --run <retry-package-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs executions --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs executions --show <execution-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs executions --verify <execution-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --dry-run [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --scan --dry-run [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --once --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --loop --dry-run [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --worker-plan --from-file <approved-item-json> --dry-run [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --loop --confirm --max-iterations <n> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --stop --confirm --reason <text> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --loops --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --show <daemon-loop-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs daemon --verify <daemon-loop-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --draft [--source-bound] [--confirm] [--adapter <id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --review <draft-file> [--confirm] [--actor <id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --approve <draft-file> [--confirm] [--actor <id>] [--adapter <id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --outbox <approval-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --send <outbox-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --show <reply-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reply --verify <reply-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs traces --build [--dry-run|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs traces --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs traces --show <trace-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs traces --verify <trace-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --attest [--dry-run|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --compatibility --report [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --convergence --report [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --superpowers-gap --from-superpowers <local-superpowers-dir> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --superpowers-comparison --from-superpowers-root <local-superpowers-root> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --superpowers-regression-guard --from-superpowers <local-superpowers-dir> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --experience-friction --from-file <local-session-evidence-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --experience-dashboard --from-friction <local-friction-json> [--from-console <local-console-json>] [--from-token-budget <local-token-budget-json>] [--from-learning-pattern <local-learning-pattern-json>] [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --experience-upgrades --from-comparison <local-comparison-json> --from-dashboard <local-dashboard-json> [--from-install-experience <local-install-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --superpowers-parity-scorecard --from-comparison <local-comparison-json> --from-entry-discipline <local-discipline-json> --from-install-experience <local-install-json> --from-upgrades <local-upgrades-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --contributor-guardrails --from-scorecard <local-parity-scorecard-json> --from-evidence-prompts <local-evidence-prompts-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --subagent-permission --from-scorecard <local-parity-scorecard-json> --from-guardrails <local-guardrails-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --traceability-map [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --pr-readiness [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --pr-review-intake --from-file <local-evidence-file> [--from-readiness <pr-readiness-governance-file>] [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --advice --intent <closeout|review|release|pr-readiness|pr-review-intake|convergence|compatibility> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --surface [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --surface --drift-guard [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs automation --readiness [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs automation --plan --prompt <text> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs automation --one-shot-plan --from-file <local-plan-file> --subject <commit-subject> --confirm-plan <phrase> [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs automation --stage-runbook --from-plan <local-plan-file> [--from-executable-plan <local-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs automation --stage-scriptlet --from-runbook <local-runbook-json> [--from-console <local-console-json>] [--stage <stage-id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --suite-plan --from-file <local-release-check-run-summary-json> [--change-kind <runtime|release|execution|docs|unknown>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --close-loop-dashboard --from-file <local-plan-file> --subject <commit-subject> [--intent <kind>] [--confirm-plan <phrase>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --close-loop --from-file <local-plan-file> --subject <commit-subject> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --next-evidence --from-file <local-plan-file> [--evidence-file <local-evidence-json>] [--diff-file <local-diff-file>] [--review-file <local-review-json>] [--tdd-file <local-tdd-trace-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --show <governance-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs governance --verify <governance-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --route --intent <feature|refactor|architecture|plan|parallel|workspace|subagent|debug|implementation|review|review-feedback|skill|context|completion> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --readiness --intent <feature|implementation|review|completion|debug|plan|release|unknown> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --coverage-map --from-superpowers-root <local-superpowers-root> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --gate --kind <spec|plan|tdd|debug|review|completion|automation> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --gate --kind <product-discovery|product-spec|ui-design|product-acceptance|scenario-acceptance> --from-file <local-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --gate --kind <architecture-design|delivery-traceability> --from-file <local-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --gate --kind <implementation-plan> --from-file <local-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --show <gate-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs methodology --verify <gate-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --cockpit --intent <implementation|review|completion|debug|plan|unknown> [--from-file <local-plan-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --receipt --intent <implementation|review|completion|debug|plan|unknown> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --start [--intent <kind>|--prompt <text>] [--from-file <local-plan-file>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs session --start [--intent <kind>|--prompt <text>] [--from-file <local-plan-file>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs session --close [--from-file <local-completion-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs session --checkpoint [--intent <kind>|--prompt <text>] [--from-file <local-evidence-file>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs session --handoff [--intent <kind>|--prompt <text>] [--from-file <local-evidence-file>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs session --resume --from-file <local-session-checkpoint-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs skill --select --intent <implementation|review|completion|debug|plan|unknown> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --run-plan [--intent <kind>|--prompt <text>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --entry-summary [--intent <kind>|--prompt <text>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --entry-ux --prompt <text> [--from-gap <local-gap-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --entry-discipline --from-transcript <local-transcript-json> [--intent <kind>] [--profile vibe-guided] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --entry-tightening --from-discipline <local-discipline-json> --from-scorecard <local-parity-scorecard-json> [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --next-action-console --from-friction <local-friction-json> [--from-runbook <local-runbook-json>] [--from-evidence <local-evidence-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --next-evidence-prompts --from-console <local-console-json> --from-dashboard <local-dashboard-json> --from-upgrades <local-upgrades-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --sequence --intent <implementation|review|completion|debug|plan|release> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --loop-contract [--intent <kind>|--prompt <text>] [--from-file <local-plan-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --close-loop-dashboard --from-file <local-plan-file> --subject <commit-subject> [--intent <kind>] [--confirm-plan <phrase>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --close-loop --from-file <local-plan-file> --subject <commit-subject> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workflow --next-evidence --from-file <local-plan-file> [--evidence-file <local-evidence-json>] [--diff-file <local-diff-file>] [--review-file <local-review-json>] [--tdd-file <local-tdd-trace-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs verification --self-test-profile --from-file <local-plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs verification --evidence-intake --from-file <local-evidence-file> [--from-plan <local-plan-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs verification --tdd-trace --from-file <local-tdd-trace-file> [--from-plan <local-plan-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs verification --execution-evidence --from-runbook <local-runbook-json> --from-file <local-evidence-json> [--stage <id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs review --intake --from-file <local-review-file> [--from-plan <local-plan-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs review --resolution --from-file <local-review-intake-file> --from-evidence <local-evidence-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs completion --readiness [--from-file <local-completion-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs completion --evidence-bundle [--from-file <local-completion-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs completion --evidence-bundle [--from-product-discovery <local-product-discovery-md>] [--from-product-spec <local-product-spec-md>] [--from-ui-design <local-ui-design-contract-md>] [--from-architecture <local-architecture-design-md>] [--from-traceability <local-delivery-traceability-yaml>] [--from-plan <local-plan-file>] [--from-scenarios <local-scenario-acceptance-yaml>] [--from-product-acceptance <local-product-acceptance-md>] [--from-test-evidence <local-test-evidence-json>] [--from-diff-coverage <local-diff-coverage-json>] [--from-commit-readiness <local-commit-readiness-json>] [--from-evidence <local-engineering-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs completion --repair-plan --from-file <local-completion-bundle-json> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs bootstrap --acceptance [--prompt <text>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs onboarding --brief [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --preview [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --hook-run --max-iterations <n> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --show <hook-intent-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs hooks --verify <hook-intent-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --eligibility --task <task-id> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --dispatch --from-plan <scheduler-hook-plan-file> --eligibility <eligibility-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --run --from-dispatch <subagent-dispatch-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --ingest-result <subagent-run-result-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --review-gate <subagent-result-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --session-approval --from-dispatch <subagent-dispatch-file> --capability <platform-capability-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --adapter-dispatch --from-dispatch <subagent-dispatch-file> --capability <platform-capability-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --create-session --from-approval <platform-session-approval-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --cancel-session <platform-session-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --ingest-session-result <platform-session-result-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --review-session-result <platform-session-intake-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --show <subagent-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs subagents --verify <subagent-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --plan --from-plan <implementation-plan.md> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --task-brief --from-plan <implementation-plan.md> --task <task-id> [--profile superpowers-parity] [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --review-package --from-plan <implementation-plan.md> --task <task-id> --base <sha> --head <sha> [--profile superpowers-parity] [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --run-loop --from-plan <implementation-plan.md> --profile superpowers-parity --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --evidence-chain --from-plan <implementation-plan.md> --profile superpowers-parity --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs sdd --consume-adapter-result --from-plan <implementation-plan.md> --from-file <local-adapter-result-json> --profile superpowers-parity --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workspace --isolate-plan [--from-plan <implementation-plan.md>] --profile superpowers-parity [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workspace --create [--from-plan <implementation-plan.md>] --profile superpowers-parity --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workspace --status [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs workspace --cleanup-plan [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --bootstrap-matrix [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --entry-acceptance --from-file <local-adapter-transcript-json> [--adapter <claude|cursor|codex>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --session-start-shape --from-file <local-captured-session-start-output> --adapter <claude|cursor|codex|cursor-sdk> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --session-start-examples --from-shape <local-shape-json> --from-install-experience <local-install-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --adapter-packaging-consistency --from-bootstrap-matrix <local-bootstrap-matrix-json> --from-session-examples <local-session-examples-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --install-experience --from-bootstrap-matrix <local-bootstrap-matrix-json> --from-entry-acceptance <local-entry-acceptance-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --probe <platform> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --show <platform-capability-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs platforms --verify <platform-capability-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --candidate --from-session-review <platform-session-review-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --patch-plan --from-task <task-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --apply-sandbox <source-change-candidate-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --sandbox-apply <source-change-candidate-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --verify-change <source-sandbox-run-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --apply-to-worktree --approval <merge-approval-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --show <source-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs source --verify <source-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --readiness --from-verification <source-verification-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --approve <merge-readiness-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --apply <merge-approval-file> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --show <merge-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs merge --verify <merge-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --route --from-file <path> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --route --from-hook <hook-intent-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --decompose --from-route <planner-route-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --briefs --from-plan <planner-plan-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --lint --from-file <local-plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --action-manifest --from-file <local-plan-file> [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --executable-plan --from-file <local-plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --show <planner-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs planner --verify <planner-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs router --plan --from-briefs <planner-briefs-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs router --approve <router-plan-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs router --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs router --show <router-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs router --verify <router-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs orchestrator --plan --from-router <router-approval-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs orchestrator --dispatch-plan <orchestrator-plan-file> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs orchestrator --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs orchestrator --show <orchestrator-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs orchestrator --verify <orchestrator-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --run-contract <suite-id> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --run-scenario <suite-id> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --run-behavior <suite-id> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --run-adversarial <suite-id> [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --behavior-contract --from-file <local-transcript-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --transcript-intake --from-file <local-platform-transcript-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --superpowers-style-pack --from-comparison <local-comparison-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --local-behavior-contracts --from-style-pack <local-style-pack-json> --from-entry-tightening <local-entry-tightening-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs evals --verify <eval-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --gate --from-evals <eval-report-file>... [--with-convergence] [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --verify-gate <release-gate-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --notes --from-file <local-evidence-file> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --verify-notes <release-notes-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --commit-guard [--subject <commit-subject>|--from-file <local-evidence-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --commit-readiness --from-file <local-plan-file> --subject <commit-subject> [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --staged-commit-readiness --from-runbook <local-runbook-json> --from-evidence <local-execution-evidence-json> --stage <id> --subject <commit-subject> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --closeout-readiness --from-file <local-sdd-progress-ledger-json> --from-evidence <local-test-evidence-json> --from-diff-coverage <local-diff-coverage-json> --from-readiness <local-task-commit-readiness-json> --profile superpowers-parity [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --task-commit-readiness --from-task-result <local-task-result-json> --profile superpowers-parity-task-commits [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --task-commit --from-readiness <local-task-commit-readiness-json> --profile superpowers-parity-task-commits --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --diff-coverage --from-file <local-diff-file> --from-plan <local-plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs release --diff-read --from-plan <local-plan-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tests --run --profile <runtime-test-evidence-syntax|runtime-check|npm-check> --confirm [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs feedback --ledger [--from-planner <planner-artifact>...] [--from-router <router-artifact>...] [--from-orchestrator <orchestrator-artifact>...] [--from-evals <eval-report-file>...] [--from-release-gate <release-gate-file>...] [--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs feedback --verify-ledger <feedback-ledger-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --observe --from-file <session-evidence-file> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --observe-from-run --from-file <local-run-or-evidence-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --instincts --from-observations <learning-observation-file...> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --promote --instinct <candidate-instinct-file> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --advice [--intent <kind>] [--from-observations <learning-observation-file...>|--instinct <candidate-instinct-file>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --experience-pattern --from-friction <local-friction-json> [--from-observations <learning-observation-file...>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --list [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --show <learning-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs learning --verify <learning-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --catalog [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --compact-output --command <cmd-name> --from-file <output-file> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --profile --name minimal|balanced|full [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --advice [--intent <kind>] [--command <cmd-name>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --savior-budget --prompt <text> [--from-friction <local-friction-json>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --entry-defaults --from-budget <local-token-budget-json> --from-scorecard <local-parity-scorecard-json> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --metrics --from-compactions <token-compaction-file...> [--preview|--confirm] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --rewrite-preview --command <cmd-name> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs tokens --verify <token-artifact-file> [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs advice --hub [--intent <kind>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs artifacts [--dry-run|--write] [--root <path>]
+  node tools/vibe-runtime/index.mjs tasks [--dry-run|--write] [--task <task-id>] [--json] [--root <path>]
+  node tools/vibe-runtime/index.mjs reset --confirm [--root <path>]
+
+`;
+
+const runtimeCliUsageOptions = `Options:
+  --root <path>       Target root. Defaults to current working directory.
+  --from-file <path>  Workflow Handoff JSON handoff, markdown, or yaml-like file to validate or record.
+  --task <task-id>    Limit task artifact preview or write to one recorded task id.
+  --dry-run           Print next step suggestion, dispatch intent, or artifacts preview without writing files.
+  --dispatch-intent   Preview adapter-ready next skill intent for next --dry-run only.
+  --dispatch          Create a confirm-dispatch event for next --confirm only.
+  --write             Write generated artifacts into .vibecoding-state/.
+  --confirm           Required for reset.
+  --json              Print machine-readable JSON for read-only commands.
+  --help              Show this help.
+`;
+
+const runtimeCliUsageSections = [
+  runtimeCliUsageHeader,
+  runtimeCliUsageCommands,
+  runtimeCliUsageOptions,
+];
+
+export function usage() {
+  return runtimeCliUsageSections.join('');
+}

package/tools/vibe-runtime/runtime-cli-value-options.mjs

@@ -0,0 +1,74 @@
+const runtimeCliValueOptionContractSyncSurface = 'runtime-cli-usage runtime-cli-args JSON envelope';
+
+function requireValue(argv, index, message) {
+  const value = argv[index + 1];
+  if (!value) throw new Error(message);
+  return value;
+}
+
+function ensureCommand(options, commands, message) {
+  if (!commands.includes(options.command)) throw new Error(message);
+}
+
+function parseTokenCommandName(argv, index) {
+  const values = [];
+  let cursor = index + 1;
+  while (cursor < argv.length && !String(argv[cursor]).startsWith('--')) {
+    values.push(argv[cursor]);
+    cursor += 1;
+  }
+  if (values.length === 0) throw new Error('--command requires a command name');
+  return { value: values.join(' '), nextIndex: cursor - 1 };
+}
+
+function assertRuntimeCliValueOptionContractSurface() {
+  if (!runtimeCliValueOptionContractSyncSurface.includes('runtime-cli-args')) {
+    throw new Error('runtime CLI value-option contract marker missing');
+  }
+}
+
+export function parseLowRiskRuntimeCliValueOption(options, argv, index) {
+  assertRuntimeCliValueOptionContractSurface();
+
+  const arg = argv[index];
+
+  if (arg === '--kind') {
+    const value = requireValue(argv, index, '--kind requires a methodology gate kind');
+    options.methodologyKind = value;
+    return { handled: true, index: index + 1 };
+  }
+
+  if (arg === '--intent') {
+    const value = requireValue(argv, index, '--intent requires an entry, methodology, workflow, planner action manifest, verification, release, automation, token, learning, or governance advice/dashboard intent');
+    ensureCommand(
+      options,
+      ['methodology', 'workflow', 'session', 'skill', 'entry', 'planner', 'verification', 'release', 'automation', 'tokens', 'learning', 'governance', 'advice'],
+      '--intent is only supported by advice --hub, entry --advice, workflow --cockpit, workflow --start, session --start, skill --select, workflow --run-plan, workflow --entry-summary, workflow --sequence, workflow --loop-contract, workflow --close-loop-dashboard, workflow --close-loop, workflow --next-evidence, planner --action-manifest, verification --self-test-profile, release --commit-readiness, automation --one-shot-plan, methodology --route, methodology --readiness, tokens --advice, learning --advice, learning --experience-pattern, governance --experience-dashboard, or governance --advice',
+    );
+    options.methodologyIntent = value;
+    return { handled: true, index: index + 1 };
+  }
+
+  if (arg === '--command') {
+    ensureCommand(options, ['tokens'], '--command is only supported by tokens --compact-output, --rewrite-preview, or --advice');
+    const parsed = parseTokenCommandName(argv, index);
+    options.tokenCommandName = parsed.value;
+    return { handled: true, index: parsed.nextIndex };
+  }
+
+  if (arg === '--change-kind') {
+    const value = requireValue(argv, index, '--change-kind requires a value');
+    ensureCommand(options, ['release'], '--change-kind is only supported by release --suite-plan');
+    options.changeKind = value;
+    return { handled: true, index: index + 1 };
+  }
+
+  if (arg === '--name') {
+    const value = requireValue(argv, index, '--name requires a name');
+    ensureCommand(options, ['tokens'], '--name is only supported by tokens --profile');
+    options.tokenProfileName = value;
+    return { handled: true, index: index + 1 };
+  }
+
+  return { handled: false, index };
+}