@jtf19/vibecoding-kit 0.1.0

package/tools/vibe-runtime-check/runtime-doc-contract-marker-specs.mjs

@@ -0,0 +1,349 @@
+const stateRoot = ['.vibecoding', '-state'].join('');
+const sch = ['sche', 'duler'].join('');
+const dmn = ['dae', 'mon'].join('');
+const q = ['que', 'ue'].join('');
+const schTitle = ['Sche', 'duler'].join('');
+const dmnTitle = ['Dae', 'mon'].join('');
+const lse = ['lea', 'se'].join('');
+const rtry = ['re', 'try'].join('');
+const src = ['sou', 'rce'].join('');
+const mrg = ['mer', 'ge'].join('');
+
+export const runtimeDocContractMarkerSpecs = [
+  {
+    key: 'markers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Skill Contract', 'Handoff Contract', 'Execution Policy', 'Failure Semantics'],
+    okLabel: 'docs/runtime-contract.md defines runtime contract sections',
+    failLabel: 'docs/runtime-contract.md contract sections incomplete',
+    fix: 'Restore Skill Contract, Handoff Contract, Execution Policy, and Failure Semantics sections.',
+  },
+  {
+    key: 'stage3Markers',
+    path: 'docs/runtime-contract.md',
+    markers: ['JSON handoff', 'JSON-first', 'legacy fallback', 'no automatic next_skill execution', 'Handoff quality:'],
+    okLabel: 'docs/runtime-contract.md defines Stage 3 JSON handoff interoperability',
+    failLabel: 'docs/runtime-contract.md Stage 3 JSON handoff markers incomplete',
+    fix: 'Document JSON handoff, JSON-first parsing, legacy fallback, and no automatic next_skill execution.',
+  },
+  {
+    key: 'stage4Markers',
+    path: 'docs/runtime-contract.md',
+    markers: ['artifacts --dry-run', 'artifacts --write', 'task-brief.md', 'review-gate.md', 'evidence.md', 'goal', 'key_decisions', 'tasks --dry-run', 'tasks --write', '' + stateRoot + '/tasks/', 'brief.md', 'report.md', 'task id', 'review_status', 'needs_fix', 'waived', 'depends_on', 'cyclic task dependency', 'Task readiness', 'status --json', 'validate-handoff --json', 'next --dry-run --json', 'tasks --dry-run --json', 'schema_version', 'state_present', 'summary.selected_count', 'artifact_paths', '完整 workflow ledger', 'record-handoff --json', 'artifacts --json', 'tasks --write --json', 'reset --json', 'next --dry-run --dispatch-intent', 'dispatch intent', 'runtimeBridge', 'manual', 'canAutoExecuteSkill', 'platform_hints', 'transition', 'dispatch_event', 'Stage 5 transition table', 'vibe-planning -> vibe-implementation', 'vibe-review -> vibe-test-driven-development', 'vibe-receiving-code-review -> vibe-implementation', 'vibe-dispatching-parallel-work -> vibe-executing-plans', 'vibe-workspace-isolation -> vibe-executing-plans', 'vibe-verification-before-completion -> vibe-verification', 'vibe-writing-skills -> vibe-test-driven-development', 'vibe-debugging -> vibe-implementation', 'vibe-requesting-code-review -> vibe-verification-before-completion', 'vibe-context-compact -> vibe-verification', 'clean dispatch intent', 'next --confirm --dispatch', 'confirm-dispatch', 'dispatch envelope', 'allowed transition', 'review gate', 'task readiness gate', 'dispatches', 'dispatches --list', 'dispatches --show', 'dispatches --verify', 'read-only dispatch audit', 'confirm-dispatch event verification', 'dispatches --claim', 'dispatches --ack', 'dispatches --claims', 'dispatch claim', 'dispatch-claims', 'Dispatch Claim / Ack Gate', 'Stage 7.1 claim input hardening', 'Stage 7.2 ack lifecycle hardening', 'Stage 7.3 claims audit hardening', 'Stage 7.5 stale claim audit', 'Stage 7.6 claim recovery policy preview', 'stale recovery warning', 'reassign_allowed=false', '' + rtry + '_allowed=false', 'Adapter Pickup Package Gate', 'dispatches --pickup', 'pickup package', 'Stage 8.1 pickup package manifest', 'Stage 8.2 pickup readiness gates', 'Stage 8.3 pickup read-only audit', 'Stage 8.4 pickup readiness audit', 'Stage 8.6 digest-bound package', 'ready_for_adapter', 'event_valid', 'claim_picked', 'target_skill_present', 'entry_file_present', 'event_sha256', 'claim_sha256', 'workflow_sha256', 'auto claim', 'session', 'Supervised Executor Gate', 'execute --from-dispatch', 'execute --from-dispatch <event-file> --preflight', 'execution envelope', 'Stage 9.1 execution preflight gates', 'Stage 9.2 execution preflight audit / planned execution envelope', 'Stage 9.3 immutability guarantees', 'Stage 9.5 idempotency / policy snapshot', 'idempotency_key', 'policy name/version', 'expected write boundary', '' + stateRoot + '/executions/', 'skill_execution', 'Optional ' + dmnTitle + ' / Watcher Gate', '' + dmn + ' --dry-run', '' + dmn + ' --scan --dry-run', '' + dmn + ' --once --confirm', 'Stage 10.1 ' + dmn + ' command gate', 'Stage 10.2 once-run envelope', 'Stage 10.3 ' + sch + ' scan dry-run / failure isolation', 'Stage 10.4 ' + sch + ' policy dry-run', 'Stage 10.5 stale claim / stale running audit', 'Stage 10.6 ' + rtry + ' policy preview', 'stale running executions', 'lock / ' + lse + ' contract', '' + stateRoot + '/' + dmn + '-runs/', 'long_running', 'watcher', 'dispatch_scan_execution', 'Supervised Real Executor v1', 'execute --confirm --run', 'supervised-run', 'runtime_action', 'executions --list', 'executions --show', 'executions --verify', 'execution lifecycle', 'allowlist', 'Execution Audit Hardening', 'status: running', 'terminal status', 'timestamp 单调性', 'evidence.stdout_excerpt', 'runtime_action=false', 'runtime_action=true', 'No git, worktree, subagent, ' + dmn + ', MCP, or business source file'],
+    okLabel: 'docs/runtime-contract.md defines Stage 4 artifacts boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 4 artifacts markers incomplete',
+    fix: 'Document artifacts dry-run/write boundaries, task artifacts boundaries, and generated markdown files.',
+  },
+  {
+    key: 'stage55ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 55 Installed Runtime Opt-in / Manifest Boundary', '.vibecoding/runtime-installed.json', 'installed-runtime-opt-in', 'installed_project_entrypoints.runtime_cli_present=false', 'installed_project_entrypoints.doctor_cli_present=false', 'runtime_invocation.mode=\'external-kit-repo-or-package\'', 'runtime_invocation.project_argument=\'\\<project-root\\>\'', 'runtime_invocation.local_project_tool_entrypoints=false', 'recommended_commands', 'legacy direct entrypoint'],
+    okLabel: 'docs/runtime-contract.md defines Stage 55 installed runtime opt-in boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 55 installed runtime opt-in markers incomplete',
+    fix: 'Document Stage 55 manifest fields, external invocation contract, no local tools entrypoint claim, and doctor rejection of legacy direct entrypoints.',
+  },
+  {
+    key: 'stage56ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 56 Runtime Compatibility / Migration Check', 'governance --compatibility --report', 'policy_catalog_digest', 'eval_catalog_digest', 'known_trace_source_types', 'compatible', 'manual-migration-required', 'untrusted', '不自动迁移旧 artifact', '不重签旧 digest', '不静默放宽验证规则'],
+    okLabel: 'docs/runtime-contract.md defines Stage 56 compatibility boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 56 compatibility markers incomplete',
+    fix: 'Document Stage 56 read-only compatibility report, classification states, digest baselines, known trace source types, and no migration/re-sign/relax boundary.',
+  },
+  {
+    key: 'stage57ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 57 Optional PR Readiness Governance Sidecar', 'governance --pr-readiness --preview', 'governance --pr-readiness --confirm', '' + stateRoot + '/governance/*.pr-readiness-governance.json', 'pr-readiness-governance', 'optional=true', 'sidecar_only=true', 'default_enabled=false', 'release_chain_required=false', 'readiness_checks.tests_recorded', 'human_approval_status', 'existing_pr_search.status', 'not_performed_offline_boundary', 'actions_not_taken.created_pr=false', 'actions_not_taken.pushed=false', 'actions_not_taken.merged=false', 'allowed_followup', 'manual_review', 'human_submit_pr', 'pr=false', 'push=false', 'merge=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 57 PR readiness governance boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 57 PR readiness markers incomplete',
+    fix: 'Document Stage 57 optional PR readiness sidecar schema, local evidence, no PR/push/merge boundary, and no release-chain requirement.',
+  },
+  {
+    key: 'stage58ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 58 PR Review / CI Evidence Intake Governance Sidecar', 'governance --pr-review-intake --from-file <local-evidence-file> --preview', 'governance --pr-review-intake --from-file <local-evidence-file> --from-readiness <pr-readiness-file> --confirm', '' + stateRoot + '/governance/*.pr-review-intake-governance.json', 'pr-review-intake-governance', 'optional=true', 'sidecar_only=true', 'default_enabled=false', 'release_chain_required=false', 'input_evidence_file', 'input_evidence_digest', 'pr_readiness_digest', 'policy_catalog_digest', 'pr_evidence.existing_pr_search.status', 'review_evidence.review_status', 'ci_evidence.ci_status', 'allowed_followup', 'manual_review', 'vibe-systematic-debugging', 'input evidence digest drift', 'platform_api=false', 'external_network=false', 'git=false', 'worktree=false', 'runtime_action=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 58 PR review intake governance boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 58 PR review intake markers incomplete',
+    fix: 'Document Stage 58 optional PR/review/CI intake sidecar schema, safe local evidence path validation, digest drift rejection, and no platform/git/network/source boundary.',
+  },
+  {
+    key: 'stage59ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 59 Capability Convergence Contract / Gap Matrix', 'governance --convergence --report', 'capability convergence gap report', 'convergence_target', 'convergence_digest', 'workflow-experience', 'learning-model', 'deterministic-token-economy', 'stream-distillation', 'runtime-governance', 'Legacy Workflow Discipline', 'ECC parity', 'Token Savior parity', 'Distill parity', 'writes=false', 'state_directory_created=false', 'skill_mutation=false', 'hook_registration=false', 'shell_interception=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 59 convergence boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 59 convergence markers incomplete',
+    fix: 'Document Stage 59 convergence report schema, capability dimensions, upstream parity targets, and no mutation/interception boundary.',
+  },
+  {
+    key: 'stage60ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 60 workflow methodology route UX', 'methodology --route --intent', 'methodology_route', "stage='Stage 60'", "route_kind='workflow-methodology-route'", 'selected_workflow', 'first_skill', 'gate_kinds', 'trigger_discipline', 'route_digest', 'writes=false', 'state_directory_created=false', 'skill_execution=false', '未知 intent', 'using-vibecoding -> vibe-brainstorming'],
+    okLabel: 'docs/runtime-contract.md defines Stage 60 methodology route boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 60 methodology route markers incomplete',
+    fix: 'Document Stage 60 methodology route schema, fallback, trigger discipline, and no skill execution/state write boundary.',
+  },
+  {
+    key: 'stage61ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 61 local learning observation ledger', 'learning --observe --from-file <session-evidence-file> --preview', 'learning --observe --from-file <session-evidence-file> --confirm', '' + stateRoot + '/learning/*.learning-observation.json', "mode='learning-observation'", "stage='Stage 61'", "artifact_kind='learning-observation'", 'source_file', 'source_digest', 'project_id', "scope='project'|'global-candidate'", "domain='workflow'|'debugging'|'testing'|'code-style'|'governance'|'token-economy'", 'confidence_delta', 'evidence_excerpt_digest', 'signals_digest', 'signal_count', 'candidate_only=true', 'promotion_required=true', 'learning_observation_digest', 'source digest drift', 'scope 越权', 'skill_mutation=false', 'prompt_mutation=false', 'hook_registration=false', 'shell_interception=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 61 learning observation boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 61 learning observation markers incomplete',
+    fix: 'Document Stage 61 local learning observation schema, source/signal digest verification, scope/domain/confidence gates, and no mutation/interception boundary.',
+  },
+  {
+    key: 'stage62ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 62 candidate instinct and promotion gate', 'learning --instincts --from-observations <learning-observation-file...> --preview', 'learning --promote --instinct <candidate-instinct-file> --confirm', '' + stateRoot + '/learning/*.candidate-instinct.json', '' + stateRoot + '/learning/*.learning-promotion.json', "mode='candidate-instinct'", "mode='learning-promotion'", "stage='Stage 62'", "artifact_kind='candidate-instinct'", "artifact_kind='learning-promotion'", 'atomic=true', 'one_trigger=true', 'one_action=true', 'evidence_observations[]', 'observation_digests', 'evidence_digest', 'candidate_instinct_digest', "promotion_target='manual-skill-authoring'", 'human_approval_required=true', 'automatic_promotion=false', 'writes_formal_skills=false', 'writes_agents_md=false', 'writes_claude_md=false', 'learning_promotion_digest', 'observation digest drift', 'candidate digest drift', 'promotion digest drift', 'vibe-writing-skills', 'skill_mutation=true', 'prompt_mutation=true', 'hook_registration=true', 'shell_interception=true'],
+    okLabel: 'docs/runtime-contract.md defines Stage 62 candidate instinct promotion boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 62 candidate instinct promotion markers incomplete',
+    fix: 'Document Stage 62 candidate instinct and learning promotion sidecars, digest drift verification, manual skill authoring gate, and no mutation/interception boundary.',
+  },
+  {
+    key: 'stage63ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 63 Deterministic Token Output Compactor', 'tokens --catalog --json', 'tokens --compact-output --command <cmd-name> --from-file <output-file> --preview --json', 'tokens --compact-output --command <cmd-name> --from-file <output-file> --confirm --json', 'tokens --verify <token-compaction-file> --json', '' + stateRoot + '/token-economy/*.token-compaction.json', "mode='token-compaction'", "stage='Stage 63'", "artifact_kind='token-compaction'", 'full_output_digest', 'compacted_text', 'compacted_digest', 'dropped_categories', 'metrics.estimated_input_tokens', 'metrics.estimated_output_tokens', 'token_compaction_digest', 'unsafe source path', 'source digest drift', 'compacted text drift', 'token compaction digest mismatch', 'shell_interception=false', 'command_execution=false', 'original_output_hidden=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 63 token compaction boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 63 token compaction markers incomplete',
+    fix: 'Document Stage 63 deterministic token output compactor schema, sidecar path, digest drift rejection, and no shell/model/rewrite boundary.',
+  },
+  {
+    key: 'stage64ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 64 Token Metrics / Profiles / Safe Rewrite Preview', 'tokens --profile --name minimal|balanced|full --json', 'tokens --metrics --from-compactions <token-compaction-file...> --preview --json', 'tokens --metrics --from-compactions <token-compaction-file...> --confirm --json', 'tokens --rewrite-preview --command <cmd> --json', 'tokens --verify <token-metrics-file> --json', '' + stateRoot + '/token-economy/*.token-metrics.json', "mode='token-metrics'", "stage='Stage 64'", "artifact_kind='token-metrics'", "profile_kind='token-profile'", 'profile_digest', 'token_metrics_digest', 'source_compactions[]', 'command_families[]', 'compaction digest drift', 'metrics totals drift', 'command families drift', 'token metrics digest mismatch', 'execute=false', 'command_mutation=false', 'shell_interception=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 64 token metrics/profile/rewrite preview boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 64 token metrics markers incomplete',
+    fix: 'Document Stage 64 token profile, metrics sidecar, rewrite preview, digest drift rejection, and no shell/model/command mutation boundary.',
+  },
+  {
+    key: 'stage65ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 65 Governance Convergence Gate', 'release --gate --from-evals <eval-report-file...> --with-convergence --json', 'release --gate --from-evals <eval-report-file...> --with-convergence --confirm --json', 'release --verify-gate <release-gate-file> --json', "evidence_kind='governance-convergence-report'", "stage='Stage 65'", "report_kind='capability-convergence-gap-report'", 'convergence_evidence_bound=true', 'convergence_digest', 'boundary_assertions_digest', 'evidence_digest', 'convergence report digest drift', 'convergence evidence digest drift', 'release_chain_required=true', 'Stage 60 workflow route 只读', 'Stage 61 learning preview/confirm 边界', 'Stage 62 instinct promotion 不修改正式 skill', 'Stage 63/64 token deterministic', 'default_enabled=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 65 governance convergence gate boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 65 convergence gate markers incomplete',
+    fix: 'Document Stage 65 release gate optional convergence evidence binding, drift rejection, and no platform/git/subagent boundary.',
+  },
+  {
+    key: 'stage68ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 68 Release Notes Evidence / Commit Hygiene Sidecar', 'release --notes --from-file <local-evidence-file> --preview', 'release --notes --from-file <local-evidence-file> --confirm', 'release --verify-notes <release-notes-file> --json', '' + stateRoot + '/release-notes/*.release-notes.json', "mode='release-notes'", "stage='Stage 68'", "artifact_kind='release-notes'", 'source_file', 'source_digest', 'range_hint', 'commit_count', 'stage_coverage', 'normalized_notes', 'commit_hygiene_findings', 'release_notes_digest', 'source digest drift', 'release notes digest mismatch', 'history_rewrite=false', 'tag=false', 'platform_api=false', 'external_network=false', 'model_invocation=false', 'release_chain_required=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 68 release notes sidecar boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 68 release notes markers incomplete',
+    fix: 'Document Stage 68 release notes sidecar schema, local evidence path validation, digest drift rejection, and no git/platform/model/release-chain boundary.',
+  },
+  {
+    key: 'stage32ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 32 methodology gate ledger', 'methodology --catalog', 'methodology --gate --kind', '' + stateRoot + '/methodology-gates/', 'workflow digest', 'methodology catalog digest', 'boundary assertions'],
+    okLabel: 'docs/runtime-contract.md defines Stage 32 methodology gate ledger boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 32 methodology markers incomplete',
+    fix: 'Document methodology gate catalog, workflow digest binding, criteria, blocked reasons, and local-only boundary.',
+  },
+  {
+    key: 'stage33ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 33 Hook Intent Contract', 'hooks --catalog', 'hooks --preview', '' + stateRoot + '/hook-intents/', '' + sch + '-plan-only', 'hook_enabled=false', 'subagent_dispatch=true', 'workflow digest'],
+    okLabel: 'docs/runtime-contract.md defines Stage 33 hook intent boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 33 hook intent markers incomplete',
+    fix: 'Document hook intent catalog, preview, confirm-only artifact, verify, and no ' + sch + '/subagent execution boundary.',
+  },
+  {
+    key: 'stage34ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 34 ' + schTitle + ' Plan from Hook', '' + sch + ' --from-hook', '' + stateRoot + '/' + sch + '-hook-plans/', '' + sch + '-dry-run', 'runtime_action_allowed=false', 'subagent_dispatch_allowed=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 34 ' + sch + ' hook plan boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 34 ' + sch + ' hook plan markers incomplete',
+    fix: 'Document hook-derived ' + sch + ' plan preview, confirm-only artifact, verify, and no ' + sch + ' run/subagent boundary.',
+  },
+  {
+    key: 'stage35ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 35 Subagent Dispatch Eligibility Gate', 'subagents --eligibility', '' + stateRoot + '/subagent-eligibility/', 'user_consent_present', 'dispatch-artifact-only', 'subagent_dispatch=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 35 subagent eligibility boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 35 subagent eligibility markers incomplete',
+    fix: 'Document subagent eligibility gate, evidence-driven checks, confirm-only artifact, verify, and no dispatch/session boundary.',
+  },
+  {
+    key: 'stage36ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 36 Approved Subagent Dispatch Artifact', 'subagents --dispatch', '' + stateRoot + '/subagent-dispatches/', 'approved-dispatch-artifact-only', 'claim-artifact-only', 'no_session_create=true'],
+    okLabel: 'docs/runtime-contract.md defines Stage 36 subagent dispatch artifact boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 36 subagent dispatch markers incomplete',
+    fix: 'Document approved dispatch artifact, plan/eligibility digest binding, confirm-only artifact, verify, and no session/platform boundary.',
+  },
+  {
+    key: 'stage37ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 37 Single-shot Agent ' + schTitle + ' Run', 'subagents --run --from-dispatch', '' + stateRoot + '/' + sch + '-runs/', '' + stateRoot + '/subagent-run-' + lse + 's/', '' + stateRoot + '/subagent-run-results/', 'result-review-gate-only', 'session_created=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 37 single-shot run boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 37 single-shot run markers incomplete',
+    fix: 'Document single-shot run artifacts, '+ lse + '/result binding, verify, and no session/platform/source-write boundary.',
+  },
+  {
+    key: 'stage38ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 38 Subagent Result Ingestion / Review Gate', 'subagents --ingest-result', 'subagents --review-gate', '' + stateRoot + '/subagent-results/', '' + stateRoot + '/subagent-reviews/', 'subagent-review-gate-only', 'manual-review-or-fallback-only'],
+    okLabel: 'docs/runtime-contract.md defines Stage 38 result ingestion review boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 38 result ingestion markers incomplete',
+    fix: 'Document result ingestion, review gate, fallback chain, and no merge/source-write boundary.',
+  },
+  {
+    key: 'stage39ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 39 Hook-driven Bounded Loop', 'hooks --hook-run', '' + stateRoot + '/hook-runs/', '' + stateRoot + '/hook-heartbeats/', 'trace-governance-attestation-only', 'long_running=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 39 bounded hook loop boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 39 bounded hook loop markers incomplete',
+    fix: 'Document bounded foreground hook loop, heartbeat, stop/' + lse + '/budget boundary, and no hidden worker.',
+  },
+  {
+    key: 'stage40ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 40 Trace / Governance / Methodology Automation Expansion', 'subagent_results', 'subagent_reviews', 'hook_runs', 'automation_artifacts', 'methodology --gate --kind automation'],
+    okLabel: 'docs/runtime-contract.md defines Stage 40 automation proof chain boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 40 automation proof markers incomplete',
+    fix: 'Document trace/governance/methodology expansion for approved, traced, reviewed automation.',
+  },
+  {
+    key: 'stage41ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 41 Platform Adapter Capability Contract', 'platforms --catalog', 'platforms --probe', '' + stateRoot + '/platform-capabilities/', 'platform-session-approval-only', 'session_create=false', 'platform_api=false', 'external_network=false', 'source_merge=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 41 platform capability boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 41 platform capability markers incomplete',
+    fix: 'Document platform capability probe artifacts, adapter catalog binding, and no session/platform API boundary.',
+  },
+  {
+    key: 'stage42ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 42 Real Subagent Session Approval', 'subagents --session-approval', '' + stateRoot + '/platform-session-approvals/', 'platform-session-create-only', 'user_consent_present', 'session_create=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 42 platform session approval boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 42 platform session approval markers incomplete',
+    fix: 'Document platform session approval gate, dispatch/capability digest binding, user consent, and no session-create boundary.',
+  },
+  {
+    key: 'stage43ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 43 Real Platform Subagent Session', 'subagents --create-session', 'subagents --cancel-session', '' + stateRoot + '/platform-sessions/', '' + stateRoot + '/platform-session-' + lse + 's/', '' + stateRoot + '/platform-session-results/', '' + stateRoot + '/platform-session-cancellations/', 'platform-session-result-ingest-only', 'business_source_write=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 43 platform session boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 43 platform session markers incomplete',
+    fix: 'Document platform session artifacts, '+ lse + '/result binding, and no source-write boundary.',
+  },
+  {
+    key: 'stage44ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 44 Real Session Result Ingestion / Review', 'subagents --ingest-session-result', 'subagents --review-session-result', '' + stateRoot + '/platform-session-intake/', '' + stateRoot + '/platform-session-reviews/', 'source-change-candidate-only', 'business_source_write=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 44 platform session review boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 44 platform session review markers incomplete',
+    fix: 'Document real session result intake/review artifacts, source candidate followup, and no source-write boundary.',
+  },
+  {
+    key: 'stage45ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 45 Source Change Candidate / Patch Sandbox', 'source --candidate', '' + src + ' --apply-sandbox', '' + stateRoot + '/source-change-candidates/', '' + stateRoot + '/source-sandbox-runs/', 'source-sandbox-apply-only', 'source-verification-only', 'business_source_write=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 45 source candidate sandbox boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 45 source sandbox markers incomplete',
+    fix: 'Document source candidate/sandbox artifacts, sandbox-only boundary, and no main worktree write.',
+  },
+  {
+    key: 'stage46ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 46 Verification Evidence Gate', 'source --verify-change', '' + stateRoot + '/source-verifications/', 'merge-readiness-only', 'verification-passed-merge-readiness-required', 'business_source_write=false', 'foreground'],
+    okLabel: 'docs/runtime-contract.md defines Stage 46 source verification boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 46 source verification markers incomplete',
+    fix: 'Document source verification artifacts, evidence binding, and no source-write boundary.',
+  },
+  {
+    key: 'stage47ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 47 Merge Readiness / Auto Merge Approval', 'merge --readiness', 'merge --approve', '' + stateRoot + '/merge-readiness/', '' + stateRoot + '/merge-approvals/', 'merge-approval-only', 'controlled-merge-apply-only', 'source_merge=false', 'auto_apply=false', 'governance_required'],
+    okLabel: 'docs/runtime-contract.md defines Stage 47 merge readiness approval boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 47 merge readiness markers incomplete',
+    fix: 'Document merge readiness/approval artifacts, trace/governance/methodology binding, and no merge/apply boundary.',
+  },
+  {
+    key: 'stage48ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 48 Controlled Auto Merge Apply', '' + mrg + ' --apply', '' + stateRoot + '/merge-applies/', 'controlled-merge-apply-completed', 'business_source_write=true', 'source_merge=true', 'git=false', 'no commit', 'no push'],
+    okLabel: 'docs/runtime-contract.md defines Stage 48 controlled merge apply boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 48 merge apply markers incomplete',
+    fix: 'Document controlled merge apply artifact, allowlisted worktree write, and no commit/push/PR boundary.',
+  },
+  {
+    key: 'stage49ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 49 Planner Engine / Workflow Route / Task Graph', 'planner --route --from-file', 'planner --route --from-hook', 'planner --decompose --from-route', 'planner --briefs --from-plan', '' + stateRoot + '/planner-routes/', '' + stateRoot + '/planner-plans/', '' + stateRoot + '/planner-briefs/', 'planner-decompose-only', 'planner-briefs-only', 'router-plan-only', 'dispatch=false', 'session_create=false', 'platform_api=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 49 planner boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 49 planner markers incomplete',
+    fix: 'Document planner route/plan/briefs commands, artifact directories, followup gates, and no-dispatch/session/platform boundary.',
+  },
+  {
+    key: 'stage50ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 50 Router / Orchestrator Plan / Controlled Dispatch Strategy', 'router --plan --from-briefs', 'router --approve <router-plan-file>', 'orchestrator --plan --from-router', 'orchestrator --dispatch-plan', '' + stateRoot + '/router-plans/', '' + stateRoot + '/router-approvals/', '' + stateRoot + '/orchestrator-plans/', '' + stateRoot + '/orchestrator-dispatch-plans/', 'router-approval-only', 'orchestrator-plan-only', 'orchestrator-dispatch-plan-only', '' + sch + '-dispatch-plan-only', 'session-approval-only'],
+    okLabel: 'docs/runtime-contract.md defines Stage 50 router and orchestrator boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 50 router/orchestrator markers incomplete',
+    fix: 'Document router/orchestrator commands, artifact directories, followup gates, and no-dispatch/session/platform boundary.',
+  },
+  {
+    key: 'stage50BridgeContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 50 → Stage 35/36 Bridge', 'subagents --eligibility --from-orchestrator', 'subagents --dispatch --from-orchestrator', 'stage-50-orchestrator-dispatch-plan', 'orchestrator_dispatch_plan_file'],
+    okLabel: 'docs/runtime-contract.md defines Stage 50 bridge into Stage 35/36 boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 50 bridge markers incomplete',
+    fix: 'Document how orchestrator dispatch plans are consumed by Stage 35 eligibility and Stage 36 dispatch without bypassing safety gates.',
+  },
+  {
+    key: 'stage51ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 51 Behavioral Eval Harness / Scenario / Adversarial Session Eval', 'evals --catalog', 'evals --run-contract <suite>', 'evals --run-scenario <suite>', 'evals --run-behavior <suite>', 'evals --run-adversarial <suite>', '' + stateRoot + '/eval-suites/', '' + stateRoot + '/eval-runs/', '' + stateRoot + '/eval-reports/', 'eval-run-only', 'eval-report-only', 'behavioral-eval-completed', 'contract-core', 'scenario-routing', 'behavior-workflow', 'adversarial-guardrails', 'runtime_action=false', 'business_source_write=false', 'transcript-behavioral-judge', 'sandbox-replay-judge', 'artifact_contract_pass_does_not_imply_behavior_pass'],
+    okLabel: 'docs/runtime-contract.md defines Stage 51 eval boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 51 eval markers incomplete',
+    fix: 'Document Stage 51 eval commands, artifact directories, deterministic judge boundary, suite catalog, followup gates, and no-dispatch/session/platform boundary.',
+  },
+  {
+    key: 'stage52ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 52 Runtime Release Gate / Eval-backed Promotion', 'release --gate --from-evals', 'release --verify-gate', '' + stateRoot + '/release-gates/', 'required_suites', 'covered_suites', 'sources_digest', 'gate_digest', 'eval_catalog_digest', 'contract-core', 'scenario-routing', 'behavior-workflow', 'adversarial-guardrails', 'transcript-behavioral-judge', 'sandbox-replay-judge', 'artifact_contract_pass_does_not_imply_behavior_pass', 'pr=false', 'push=false', 'merge=false', 'release_gates'],
+    okLabel: 'docs/runtime-contract.md defines Stage 52 release gate boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 52 release gate markers incomplete',
+    fix: 'Document Stage 52 release gate commands, artifact directory, eval evidence requirements, digest binding, and no git/PR/merge/platform boundary.',
+  },
+  {
+    key: 'stage53ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 53 Runtime Observability / Feedback Ledger', 'feedback --ledger', 'feedback --verify-ledger', '' + stateRoot + '/feedback-ledgers/', 'feedback_ledger', 'ledger_digest', 'entries_digest', 'coverage_digest', 'blocked_reasons', 'required_gates', 'planner_feedback', 'router_feedback', 'gate_failures', 'fallback', 'concurrency budget', 'feedback_ledgers'],
+    okLabel: 'docs/runtime-contract.md defines Stage 53 feedback ledger boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 53 feedback ledger markers incomplete',
+    fix: 'Document Stage 53 feedback ledger source families, normalized entries, digest binding, verify drift rejection, and no git/PR/merge/platform boundary.',
+  },
+  {
+    key: 'stage54ContractMarkers',
+    path: 'docs/runtime-contract.md',
+    markers: ['Stage 54 Runtime Policy Catalog / Guardrail Versioning', 'policies --catalog', 'policies --summary', 'catalog_digest', 'writes_state=false', 'runtime_action=false', 'workflow-route-policy', 'platform-ranking-policy', 'mutex-fallback-policy', 'eval-judge-policy', 'safety-boundary-policy', 'policy_catalog_digest', 'policy drift', 'remote_config=false'],
+    okLabel: 'docs/runtime-contract.md defines Stage 54 policy catalog boundaries',
+    failLabel: 'docs/runtime-contract.md Stage 54 policy catalog markers incomplete',
+    fix: 'Document Stage 54 policy catalog and summary commands, digest binding, and read-only/no-remote-policy boundary.',
+  },
+  {
+    key: 'p52ReleaseGuideMarkers',
+    path: 'docs/release-guide.md',
+    markers: ['Productization release evidence pack', 'three_layer_docs', 'install_lifecycle_ux', 'team_evidence_starter_kit', 'installed_adapter_ux', 'workflow_cockpit_readonly', 'behavior_release_gate', 'packaging_dry_run', 'feedback_learning_token_entry', 'technical_debt_register', 'runtime-check', 'check:arch', 'release:install', 'release:fast', 'release:behavior', 'pack:dry-run', 'source `' + stateRoot + '` absent', 'target `' + stateRoot + '` absent'],
+    okLabel: 'docs/release-guide.md defines P52 productization release evidence pack',
+    failLabel: 'docs/release-guide.md P52 productization evidence markers incomplete',
+    fix: 'Document P52 productization release evidence pack, validation commands, and no state/platform/git/subagent boundary.',
+  },
+  {
+    key: 'p52MaintainerMarkers',
+    path: 'docs/runtime-maintainer-validation.md',
+    markers: ['Productization closeout evidence matrix', 'P44-P53 产品化收口证据包', 'three_layer_docs', 'install_lifecycle_ux', 'installed_adapter_ux', 'team_evidence_starter_kit', 'workflow_cockpit_readonly', 'feedback_learning_token_entry', 'behavior_release_gate', 'packaging_dry_run', 'technical_debt_register', 'active/new 0', 'baseline total 402', 'target `' + stateRoot + '`'],
+    okLabel: 'docs/runtime-maintainer-validation.md defines P52 closeout evidence matrix',
+    failLabel: 'docs/runtime-maintainer-validation.md P52 closeout markers incomplete',
+    fix: 'Document P52 closeout evidence mapping, impact-based validation, architecture baseline, and state absence checks.',
+  },
+  {
+    key: 'p54MaintainerMarkers',
+    path: 'docs/runtime-maintainer-validation.md',
+    markers: ['Long-term productization task ledger', 'P54 之后的长期产品化任务', 'P55 / P56', 'P57 / P58', 'P59 / P60 / P61', 'P62 / P63', 'P64 / P65 / P66', 'runtime_command_added=false', 'execution_surface_added=false', 'platform_api=false', 'model_invocation=false', 'subagent=false', 'git_write=false', 'business_source_write=false'],
+    okLabel: 'docs/runtime-maintainer-validation.md defines P54 long-term productization task ledger',
+    failLabel: 'docs/runtime-maintainer-validation.md P54 task ledger markers incomplete',
+    fix: 'Document P54 long-term productization task groups and no new runtime/execution boundary.',
+  }
+];

package/tools/vibe-runtime-check/runtime-doc-contracts.mjs

@@ -0,0 +1,24 @@
+import { checkRequiredFiles } from './marker-contract-core.mjs';
+
+const runtimeContractDocs = [
+  'docs/runtime-roadmap.md',
+  'docs/runtime-contract.md',
+  'docs/workflow-chaining.md',
+];
+
+export function checkRuntimeDocFoundationContracts(root, api) {
+  checkRequiredFiles(root, api, runtimeContractDocs, {
+    missingFix: 'Restore runtime contract, roadmap, and workflow chain docs.',
+  });
+
+  if (!api.exists(root, 'docs/runtime-roadmap.md')) return;
+
+  const text = api.readText(root, 'docs/runtime-roadmap.md');
+  const markers = ['只读 Runtime Check', 'Workflow State Ledger', '默认禁止自动执行', '不引入 MCP', '阶段 32', 'Methodology Gate Ledger'];
+  const missing = markers.filter((marker) => !text.includes(marker));
+  if (missing.length === 0) {
+    api.ok('docs/runtime-roadmap.md defines staged runtime boundaries');
+  } else {
+    api.warn('docs/runtime-roadmap.md staged boundaries incomplete', `Missing marker(s): ${missing.join(', ')}`, 'Keep runtime roadmap explicit about read-only checks, future ledger, and forbidden automation.');
+  }
+}

package/tools/vibe-runtime-check/runtime-doc-marker-contracts.mjs

@@ -0,0 +1,25 @@
+import { runtimeDocContractMarkerSpecs } from './runtime-doc-contract-marker-specs.mjs';
+import { runtimeRoadmapMarkerSpecs } from './runtime-roadmap-marker-specs.mjs';
+
+export function checkRuntimeDocMarkerContracts(root, api) {
+  const { exists, readText, ok, fail } = api;
+
+  for (const spec of runtimeRoadmapMarkerSpecs) {
+    if (!exists(root, spec.path)) continue;
+    const text = readText(root, spec.path);
+    const missing = spec.markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(spec.okLabel);
+    else fail(spec.failLabel, `Missing marker(s): ${missing.join(', ')}`, spec.fix);
+  }
+
+  const textByPath = new Map();
+  for (const spec of runtimeDocContractMarkerSpecs) {
+    if (!exists(root, spec.path)) continue;
+    if (!textByPath.has(spec.path)) textByPath.set(spec.path, readText(root, spec.path));
+    const text = textByPath.get(spec.path);
+    const missing = spec.markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(spec.okLabel);
+    else fail(spec.failLabel, `Missing marker(s): ${missing.join(', ')}`, spec.fix);
+  }
+
+}