@jtf19/vibecoding-kit 0.1.0

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

@@ -0,0 +1,187 @@
+const EXPERIENCE_RUNTIME_CONTRACTS = [
+  {
+    file: 'tools/vibe-runtime/runtime-agent-session-start-contract.mjs',
+    markers: ['buildAgentSessionStartContract', 'agentSessionStartBoundaryAssertions', 'agentSessionStartContractDigestPayload', 'agent-session-start-behavior-contract', 'expected_first_skill', 'using-vibecoding', 'skill_path', '.vibecoding/skills/using-vibecoding/SKILL.md', 'registry_fallback_to_file_path', 'visible_first_sentence', 'route_required_before_implementation', 'plan_or_todo_required_when_planning', 'validation_strategy_required_before_change', 'stop_conditions', 'visible_receipt_requirements', 'tiny_context', 'full_skill_injection', 'hidden_execution', 'workflow_start_artifact', 'prompt_mutation', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'git_write', 'business_source_write', 'Stage 15'],
+    okLabel: 'tools/vibe-runtime/runtime-agent-session-start-contract.mjs defines Stage 15 agent session start behavior boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-agent-session-start-contract.mjs Stage 15 markers incomplete',
+    fix: 'Keep Stage 15 start-here contract fields, skill path fallback, stop conditions, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 15 agent session start behavior contract module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-session-skill-command.mjs',
+    markers: ['runSessionCommand', 'runSkillCommand', 'agent-session-start-alias', 'skill-select-alias', 'session-close-evidence-alias', 'session_start_alias', 'skill_select_alias', 'session_close_alias', 'canonical_command', 'workflow --start', 'workflow --receipt', 'completion --evidence-bundle', 'workflowStartEnvelope', 'workflowReceiptEnvelope', 'completionEvidenceBundleEnvelope', 'completion_claim_allowed', 'human_completion_evidence_digest', 'skill_execution_claimed', 'workflow_execution_claimed', 'command_execution_claimed', 'subagent_dispatch_claimed', 'git_write_claimed', 'writes: false', 'state_directory_created: false', 'local_only: true', 'deterministic: true', 'Stage 16', 'Stage 20'],
+    okLabel: 'tools/vibe-runtime/runtime-session-skill-command.mjs defines Stage 16 session/skill and Stage 20 close alias boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-session-skill-command.mjs Stage 16/20 markers incomplete',
+    fix: 'Keep Stage 16 session --start and skill --select aliases delegated to workflow start/receipt, and Stage 20 session --close delegated to completion evidence bundle, with no execution/write/git/subagent claims.',
+    missingFix: 'Restore the Stage 16 session and skill alias command wrapper module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-adapter-bootstrap-matrix.mjs',
+    markers: ['runtimeAdapterBootstrapMatrix', 'runtimeAdapterBootstrapInvariants', 'runtimeAdapterBootstrapBoundaryAssertions', 'adapter-bootstrap-conformance-matrix', 'required_adapter_files', 'manifest_parity_gate', 'bootstrap_policy_gate', 'install_doc_bootstrap_gate', 'adapter_bootstrap_invariants', 'injectsFullSkill', 'writesRuntimeState', 'autoRunsNextSkill', 'canAutoExecuteSkill', 'canCallSubagent', 'canTouchGit', 'bootstrap_matrix_artifact', 'adapter_install', 'manifest_write', 'install_doc_write', 'hook_execution', 'runtime_action', 'platform_api', 'git_write', 'subagent', 'worktree', 'digestAdapterBootstrapMatrix'],
+    okLabel: 'tools/vibe-runtime/runtime-adapter-bootstrap-matrix.mjs defines Stage 122 adapter bootstrap boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-adapter-bootstrap-matrix.mjs Stage 122 markers incomplete',
+    fix: 'Keep Stage 122 adapter bootstrap matrix gates, invariant checks, digest payload, and no install/hook/git/platform/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 122 adapter bootstrap matrix module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-skill-runtime-traceability-map.mjs',
+    markers: ['runtimeSkillRuntimeTraceabilityMap', 'runtimeSkillRuntimeTraceabilityInvariants', 'runtimeSkillRuntimeTraceabilityBoundaryAssertions', 'skill-to-runtime-traceability-map', 'skill_row_coverage', 'frontmatter_name_gate', 'workflow_handoff_gate', 'runtime_registry_group_gate', 'runtime_registry_command_gate', 'skill_runtime_traceability_invariants', 'traceability_map_artifact', 'skill_write', 'runtime_registry_write', 'command_execution', 'check_execution', 'test_execution', 'runtime_action', 'skill_execution', 'git_write', 'subagent', 'worktree', 'digestSkillRuntimeTraceability'],
+    okLabel: 'tools/vibe-runtime/runtime-skill-runtime-traceability-map.mjs defines Stage 123 skill-to-runtime traceability boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-skill-runtime-traceability-map.mjs Stage 123 markers incomplete',
+    fix: 'Keep Stage 123 skill/runtime traceability gates, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 123 skill-to-runtime traceability map module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-superpowers-regression-guard.mjs',
+    markers: ['runtimeSuperpowersRegressionGuard', 'runtimeSuperpowersRegressionGuardInvariants', 'runtimeSuperpowersRegressionGuardBoundaryAssertions', 'superpowers-regression-guard', 'superpowers_regression_guard_artifact', 'protected_stage_sequence', 'protected_capabilities', 'dimension_scorecard', 'regression_gates', 'superiority_claim', 'manual_next_action', 'regression_guard_invariants', 'regression_guard_digest', 'command_execution', 'check_execution', 'test_execution', 'verification_execution', 'runtime_action', 'workflow_execution', 'skill_execution', 'auto_execution', 'git_write', 'platform_api', 'external_network', 'subagent', 'business_source_write', 'digestSuperpowersRegressionGuard'],
+    okLabel: 'tools/vibe-runtime/runtime-superpowers-regression-guard.mjs defines Stage 125 Superpowers regression guard boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-superpowers-regression-guard.mjs Stage 125 markers incomplete',
+    fix: 'Keep Stage 125 scorecard, regression gates, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 125 Superpowers regression guard module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-experience-friction-matrix.mjs',
+    markers: ['runtimeExperienceFrictionMatrix', 'runtimeExperienceFrictionInvariants', 'runtimeExperienceFrictionBoundaryAssertions', 'experience-friction-matrix', 'entry_confusion', 'next_action_unclear', 'command_discovery_cost', 'evidence_gap', 'completion_claim_risk', 'token_overhead', 'adapter_bootstrap_gap', 'superpowers_parity_gap', 'friction_score', 'priority_fixes', 'recommended_stage_sequence', 'experience_friction_artifact', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'git_write', 'commit', 'platform_api', 'model_invocation', 'subagent', 'business_source_write', 'digestExperienceFriction'],
+    okLabel: 'tools/vibe-runtime/runtime-experience-friction-matrix.mjs defines Stage 126 experience friction boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-experience-friction-matrix.mjs Stage 126 markers incomplete',
+    fix: 'Keep Stage 126 friction dimensions, scoring, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 126 experience friction matrix module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-next-action-console.mjs',
+    markers: ['runtimeNextActionConsole', 'runtimeNextActionConsoleInvariants', 'runtimeNextActionConsoleBoundaryAssertions', 'one-screen-next-action-console', 'current_position', 'recommended_next_action', 'why_now', 'copy_ready_command_preview', 'evidence_needed_next', 'do_not_do_yet', 'next_action_console_artifact', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'evidence_write', 'git_write', 'commit', 'platform_api', 'model_invocation', 'subagent', 'business_source_write', 'digestNextActionConsole'],
+    okLabel: 'tools/vibe-runtime/runtime-next-action-console.mjs defines Stage 127 next action console boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-next-action-console.mjs Stage 127 markers incomplete',
+    fix: 'Keep Stage 127 one-screen console fields, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 127 one-screen next action console module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-token-savior-budget.mjs',
+    markers: ['runtimeTokenSaviorBudget', 'runtimeTokenSaviorBudgetInvariants', 'runtimeTokenSaviorBudgetBoundaryAssertions', 'token-savior-entry-budget-contract', 'recommended_profile', 'tiny_entry', 'balanced_runtime', 'full_maintenance', 'skills_to_surface', 'skills_to_defer', 'commands_to_surface', 'context_budget', 'token_saving_reasoning', 'budget_application_order', 'token_savior_budget_artifact', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'dynamic_tool_execution', 'embeddings', 'remote_config', 'model_invocation', 'platform_api', 'external_network', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestTokenSaviorBudget'],
+    okLabel: 'tools/vibe-runtime/runtime-token-savior-budget.mjs defines Stage 128 Token Savior budget boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-token-savior-budget.mjs Stage 128 markers incomplete',
+    fix: 'Keep Stage 128 budget profiles, skill surfacing, command previews, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 128 Token Savior entry budget module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-experience-learning-pattern.mjs',
+    markers: ['runtimeExperienceLearningPattern', 'runtimeExperienceLearningPatternInvariants', 'runtimeExperienceLearningPatternBoundaryAssertions', 'ecc-learning-experience-pattern-gate', 'candidate_experience_patterns', 'repeat_signal', 'suggested_instinct_trigger', 'suggested_instinct_action', 'promotion_required', 'required_workflow', 'vibe-writing-skills', 'vibe-writing-plans', 'vibe-test-driven-development', 'promotion_boundary', 'ecc_learning_boundary', 'experience_pattern_artifact', 'learning_observation_write', 'candidate_instinct_write', 'learning_promotion_write', 'skill_write', 'writes_formal_skills', 'writes_agents_md', 'writes_claude_md', 'prompt_mutation', 'hook_registration', 'command_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'automatic_promotion', 'agent_first_delegation', 'model_invocation', 'platform_api', 'external_network', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestExperienceLearningPattern'],
+    okLabel: 'tools/vibe-runtime/runtime-experience-learning-pattern.mjs defines Stage 129 ECC learning experience pattern boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-experience-learning-pattern.mjs Stage 129 markers incomplete',
+    fix: 'Keep Stage 129 candidate pattern extraction, promotion workflow, invariant checks, digest payload, and no promotion/execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 129 ECC learning experience pattern gate module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-stage-scriptlet.mjs',
+    markers: ['runtimeStageScriptlet', 'runtimeStageScriptletInvariants', 'runtimeStageScriptletBoundaryAssertions', 'copy-ready-stage-execution-scriptlet', 'scriptlet_steps', 'powershell_commands', 'expected_markers', 'evidence_capture_template', 'stop_if', 'copy_boundary', 'preview_only', 'execution_authorized', 'commands_executed', 'evidence_written', 'stage_scriptlet_artifact', 'scriptlet_artifact', 'command_execution', 'check_execution', 'smoke_execution', 'test_execution', 'validation_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'evidence_write', 'git_add', 'git_write', 'commit', 'platform_api', 'model_invocation', 'subagent', 'mcp', 'business_source_write', 'digestStageScriptlet'],
+    okLabel: 'tools/vibe-runtime/runtime-stage-scriptlet.mjs defines Stage 130 copy-ready scriptlet boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-stage-scriptlet.mjs Stage 130 markers incomplete',
+    fix: 'Keep Stage 130 copy-ready scriptlet fields, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 130 copy-ready stage execution scriptlet module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-adapter-entry-acceptance.mjs',
+    markers: ['runtimeAdapterEntryAcceptance', 'runtimeAdapterEntryAcceptanceInvariants', 'runtimeAdapterEntryAcceptanceBoundaryAssertions', 'adapter-entry-acceptance-contract', 'using_vibecoding_first', 'lightweight_routing', 'visible_next_step', 'no_auto_execution', 'workflow_explained', 'acceptance_score', 'acceptance_digest', 'workflow_explanation', 'entry_acceptance_artifact', 'transcript_write', 'adapter_install', 'adapter_execution', 'hook_execution', 'prompt_mutation', 'command_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestAdapterEntryAcceptance'],
+    okLabel: 'tools/vibe-runtime/runtime-adapter-entry-acceptance.mjs defines Stage 131 adapter entry acceptance boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-adapter-entry-acceptance.mjs Stage 131 markers incomplete',
+    fix: 'Keep Stage 131 transcript gates, invariant checks, digest payload, and no execution/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 131 adapter entry acceptance contract module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-experience-regression-dashboard.mjs',
+    markers: ['runtimeExperienceRegressionDashboard', 'runtimeExperienceRegressionDashboardInvariants', 'runtimeExperienceRegressionDashboardBoundaryAssertions', 'experience-regression-dashboard', 'experience_scorecard', 'superpowers_comparison_delta', 'token_savior_delta', 'learning_loop_delta', 'daily_user_friction_delta', 'regression_blockers', 'next_bet', 'dashboard_sections', 'dashboard_digest', 'experience_dashboard_artifact', 'regression_dashboard_artifact', 'sidecar_write', 'source_write', 'command_execution', 'check_execution', 'smoke_execution', 'test_execution', 'verification_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'evidence_write', 'dashboard_write', 'dynamic_tool_execution', 'embeddings', 'remote_config', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestExperienceRegressionDashboard'],
+    okLabel: 'tools/vibe-runtime/runtime-experience-regression-dashboard.mjs defines Stage 132 experience dashboard boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-experience-regression-dashboard.mjs Stage 132 markers incomplete',
+    fix: 'Keep Stage 132 scorecard deltas, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 132 experience regression dashboard module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-superpowers-comparison-matrix.mjs',
+    markers: ['runtimeSuperpowersComparisonMatrix', 'runtimeSuperpowersComparisonInvariants', 'runtimeSuperpowersComparisonBoundaryAssertions', 'superpowers-comparative-evidence-matrix', 'session_start_bootstrap', 'skill_trigger_discipline', 'methodology_coverage', 'hook_shape_coverage', 'adapter_packaging', 'eval_and_test_harness', 'subagent_boundary', 'contributor_guardrails', 'token_and_context_economy', 'daily_user_friction', 'parity_gaps', 'vibecoding_advantages', 'borrowable_patterns', 'do_not_copy', 'recommended_stage_sequence', 'next_comparison_bet', 'superpowers_comparison_invariants', 'comparison_digest', 'superpowers_comparison_artifact', 'comparison_matrix_artifact', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'smoke_execution', 'test_execution', 'verification_execution', 'hook_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'repair_execution', 'prompt_mutation', 'hook_registration', 'dynamic_tool_execution', 'embeddings', 'remote_config', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestSuperpowersComparison'],
+    okLabel: 'tools/vibe-runtime/runtime-superpowers-comparison-matrix.mjs defines Stage 133 Superpowers comparison boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-superpowers-comparison-matrix.mjs Stage 133 markers incomplete',
+    fix: 'Keep Stage 133 comparison dimensions, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 133 Superpowers comparative evidence matrix module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-session-start-shape-acceptance.mjs',
+    markers: ['runtimeSessionStartShapeAcceptance', 'runtimeSessionStartShapeAcceptanceInvariants', 'runtimeSessionStartShapeAcceptanceBoundaryAssertions', 'session-start-shape-acceptance', 'adapter_output_shape', 'context_present', 'using_vibecoding_marker', 'lightweight_routing_marker', 'semantic_field_markers', 'context_policy_marker', 'no_execution_claims', 'selected_skill', 'visible_route', 'next_manual_action', 'context_policy', 'boundary_declaration_marker', 'no_full_skill_injection', 'no_forbidden_trigger', 'hookSpecificOutput.additionalContext', 'additional_context', 'additionalContext', 'context_markers', 'shape_results', 'session_start_shape_invariants', 'shape_digest', 'session_start_shape_artifact', 'captured_output_write', 'adapter_install', 'adapter_execution', 'hook_execution', 'hook_registration', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestSessionStartShapeAcceptance'],
+    okLabel: 'tools/vibe-runtime/runtime-session-start-shape-acceptance.mjs defines Stage 134 session-start shape boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-session-start-shape-acceptance.mjs Stage 134 markers incomplete',
+    fix: 'Keep Stage 134 adapter output shapes, context gates, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 134 session-start output shape acceptance module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-entry-trigger-discipline.mjs',
+    markers: ['runtimeEntryTriggerDiscipline', 'runtimeEntryTriggerDisciplineInvariants', 'runtimeEntryTriggerDisciplineBoundaryAssertions', 'entry-trigger-discipline-contract', 'supportedIntents', 'workflowRoutes', 'using_vibecoding_first', 'protocol_layers_declared', 'intent_route_match', 'no_direct_implementation_jump', 'no_blind_bug_fix', 'no_false_skill_claim', 'no_forbidden_trigger', 'protocol_layers', 'expected_route', 'trigger_results', 'missed_workflow_risks', 'minimum_next_action', 'entry_discipline_invariants', 'discipline_digest', 'entry_discipline_artifact', 'transcript_write', 'prompt_mutation', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'git_write', 'commit', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'business_source_write', 'digestEntryTriggerDiscipline'],
+    okLabel: 'tools/vibe-runtime/runtime-entry-trigger-discipline.mjs defines Stage 135 entry trigger discipline boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-entry-trigger-discipline.mjs Stage 135 markers incomplete',
+    fix: 'Keep Stage 135 transcript trigger gates, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 135 entry trigger discipline contract module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-methodology-coverage-map.mjs',
+    markers: ['runtimeMethodologyCoverageMap', 'runtimeMethodologyCoverageInvariants', 'runtimeMethodologyCoverageBoundaryAssertions', 'methodology-coverage-map', 'methodologyPatterns', 'brainstorming', 'planning', 'writing_plans', 'tdd', 'debugging', 'review', 'completion', 'worktree_isolation', 'subagent_driven_development', 'writing_skills', 'contributor_pr_guardrails', 'covered_patterns', 'partial_patterns', 'missing_patterns', 'vibecoding_specific_patterns', 'local_runtime_contracts', 'token_savior_budget', 'experience_dashboard', 'coverage_summary', 'next_coverage_bet', 'valuable_gap_rule', 'gap_is_valuable', 'methodology_coverage_invariants', 'coverage_digest', 'methodology_coverage_artifact', 'coverage_map_artifact', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'smoke_execution', 'test_execution', 'hook_execution', 'adapter_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'prompt_mutation', 'skill_mutation', 'git_write', 'commit', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'business_source_write', 'digestMethodologyCoverage'],
+    okLabel: 'tools/vibe-runtime/runtime-methodology-coverage-map.mjs defines Stage 136 methodology coverage boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-methodology-coverage-map.mjs Stage 136 markers incomplete',
+    fix: 'Keep Stage 136 methodology coverage pattern map, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 136 methodology coverage map module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-install-experience-score.mjs',
+    markers: ['runtimeInstallExperienceScore', 'runtimeInstallExperienceInvariants', 'runtimeInstallExperienceBoundaryAssertions', 'hook-adapter-install-experience-score', 'expectedAdapters', 'claude', 'cursor', 'codex', 'unwrapBootstrapMatrix', 'unwrapEntryAcceptance', 'adapter_scores', 'natural_entry_score', 'adapter_consistency_score', 'manual_steps_remaining', 'docs_friction', 'next_install_experience_bet', 'install_experience_invariants', 'install_experience_digest', 'install_experience_artifact', 'bootstrap_matrix_artifact', 'entry_acceptance_artifact', 'adapter_install', 'adapter_execution', 'hook_execution', 'hook_registration', 'manifest_write', 'install_doc_write', 'settings_write', 'source_write', 'transcript_write', 'sidecar_write', 'command_execution', 'check_execution', 'test_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'daemon', 'git_write', 'commit', 'business_source_write', 'digestInstallExperience'],
+    okLabel: 'tools/vibe-runtime/runtime-install-experience-score.mjs defines Stage 137 install experience boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-install-experience-score.mjs Stage 137 markers incomplete',
+    fix: 'Keep Stage 137 install experience scoring, invariant checks, digest payload, and no install/execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 137 hook and adapter install experience score module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-superpowers-style-eval-pack.mjs',
+    markers: ['runtimeSuperpowersStyleEvalPack', 'runtimeSuperpowersStyleEvalPackInvariants', 'runtimeSuperpowersStyleEvalPackBoundaryAssertions', 'superpowers-style-behavioral-eval-scenario-pack', 'scenarioDefinitions', 'new_feature_should_not_jump_to_code', 'bug_should_reproduce_first', 'review_should_prioritize_blockers', 'commit_should_require_validation', 'subagent_requires_explicit_permission', 'session_start_should_show_lightweight_entry', 'expected_behavior', 'failure_signals', 'comparison_dimension_present', 'execution_authorized', 'model_judge_required', 'deterministic_contract_only', 'recommended_runtime_contract', 'evals --behavior-contract', 'scenario_pack', 'scenario_summary', 'scenario_ids', 'next_eval_pack_bet', 'eval_pack_invariants', 'eval_pack_digest', 'eval_pack_artifact', 'scenario_artifact', 'comparison_artifact', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'test_execution', 'eval_execution', 'agent_session_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'prompt_mutation', 'hook_registration', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestSuperpowersStyleEvalPack'],
+    okLabel: 'tools/vibe-runtime/runtime-superpowers-style-eval-pack.mjs defines Stage 138 eval scenario pack boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-superpowers-style-eval-pack.mjs Stage 138 markers incomplete',
+    fix: 'Keep Stage 138 eval scenario definitions, invariant checks, digest payload, and no eval/model/session/write/git/subagent boundaries synchronized.',
+    missingFix: 'Restore the Stage 138 Superpowers-style behavioral eval scenario pack module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-experience-upgrade-prioritizer.mjs',
+    markers: ['runtimeExperienceUpgradePrioritizer', 'runtimeExperienceUpgradePrioritizerInvariants', 'runtimeExperienceUpgradePrioritizerBoundaryAssertions', 'experience-upgrade-prioritizer', 'upgradeSeeds', 'entry_trigger_tightening', 'session_start_shape_examples', 'next_action_evidence_prompts', 'context_budget_entry_defaults', 'local_behavior_eval_contracts', 'contributor_guardrail_evidence', 'subagent_permission_visibility', 'adapter_packaging_consistency', 'default_live_agent_eval_runner', 'auto_subagent_execution', 'impact_score', 'risk_score', 'implementation_cost', 'priority_score', 'recommended_stage_order', 'defer', 'prioritization_policy', 'next_upgrade_bet', 'upgrade_invariants', 'upgrade_digest', 'upgrade_artifact', 'prioritizer_artifact', 'comparison_artifact', 'dashboard_artifact', 'install_experience_artifact', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'test_execution', 'eval_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'prompt_mutation', 'hook_registration', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestExperienceUpgradePrioritizer'],
+    okLabel: 'tools/vibe-runtime/runtime-experience-upgrade-prioritizer.mjs defines Stage 139 upgrade prioritizer boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-experience-upgrade-prioritizer.mjs Stage 139 markers incomplete',
+    fix: 'Keep Stage 139 upgrade candidates, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 139 experience upgrade prioritizer module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-superpowers-parity-scorecard.mjs',
+    markers: ['runtimeSuperpowersParityScorecard', 'runtimeSuperpowersParityScorecardInvariants', 'runtimeSuperpowersParityScorecardBoundaryAssertions', 'superpowers-parity-scorecard-v2', 'parityAxisDefinitions', 'session_start_bootstrap', 'skill_trigger_discipline', 'adapter_packaging', 'hook_shape_coverage', 'eval_and_test_harness', 'daily_user_friction', 'subagent_boundary', 'token_and_context_economy', 'contributor_guardrails', 'parity_axes', 'parity_score', 'vibecoding_leads', 'remaining_gaps', 'do_not_cross_boundaries', 'next_cycle_bet', 'parity_invariants', 'parity_digest', 'no_full_skill_injection', 'no_auto_subagent_execution', 'no_default_live_agent_eval_runner', 'no_platform_api_or_network', 'no_git_pr_push_merge', 'parity_scorecard_artifact', 'scorecard_artifact', 'comparison_artifact', 'entry_discipline_artifact', 'install_experience_artifact', 'upgrades_artifact', 'source_write', 'sidecar_write', 'command_execution', 'check_execution', 'test_execution', 'eval_execution', 'agent_session_execution', 'workflow_execution', 'skill_execution', 'runtime_action', 'auto_execution', 'prompt_mutation', 'hook_registration', 'full_skill_injection', 'platform_api', 'external_network', 'model_invocation', 'subagent', 'mcp', 'git_write', 'commit', 'business_source_write', 'digestSuperpowersParityScorecard'],
+    okLabel: 'tools/vibe-runtime/runtime-superpowers-parity-scorecard.mjs defines Stage 140 parity scorecard boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-superpowers-parity-scorecard.mjs Stage 140 markers incomplete',
+    fix: 'Keep Stage 140 parity axes, invariant checks, digest payload, and no execution/write/git/subagent/model boundaries synchronized.',
+    missingFix: 'Restore the Stage 140 Superpowers parity scorecard module.',
+  },
+  {
+    file: 'tools/vibe-runtime/runtime-superpowers-parity-command.mjs',
+    markers: ['superpowersParityScorecardEnvelope', 'printSuperpowersParityScorecard', 'runtimeSuperpowersParityScorecard', 'runtime-superpowers-parity-scorecard', 'superpowers_parity_scorecard', 'superpowers-parity-scorecard-v2', 'parity_digest', 'Parity digest', 'parity_axes', 'parity_score', 'vibecoding_leads', 'remaining_gaps', 'do_not_cross_boundaries', 'next_cycle_bet', 'parity_scorecard_artifact=false', 'scorecard_artifact=false', 'entry_discipline_artifact=false', 'upgrades_artifact=false', 'eval_execution=false', 'agent_session_execution=false', 'workflow_execution=false', 'skill_execution=false', 'full_skill_injection=false', 'prompt_mutation=false', 'hook_registration=false', 'model_invocation=false', 'git=false', 'git_write=false', 'subagent=false', 'Stage 140'],
+    okLabel: 'tools/vibe-runtime/runtime-superpowers-parity-command.mjs defines Stage 140 command output boundaries',
+    failLabel: 'tools/vibe-runtime/runtime-superpowers-parity-command.mjs Stage 140 command markers incomplete',
+    fix: 'Keep Stage 140 command envelope, text output, digest output, and no execution/write/git/subagent boundary synchronized.',
+    missingFix: 'Restore the Stage 140 Superpowers parity scorecard command wrapper module.',
+  },
+];
+
+export function checkRuntimeExperienceContracts(root, api) {
+  for (const contract of EXPERIENCE_RUNTIME_CONTRACTS) {
+    if (!api.exists(root, contract.file)) {
+      api.fail(`${contract.file} missing`, '', contract.missingFix);
+      continue;
+    }
+
+    const text = api.readText(root, contract.file);
+    const missingMarkers = contract.markers.filter((marker) => !text.includes(marker));
+    if (missingMarkers.length === 0) {
+      api.ok(contract.okLabel);
+    } else {
+      api.fail(contract.failLabel, `Missing marker(s): ${missingMarkers.join(', ')}`, contract.fix);
+    }
+  }
+}

package/tools/vibe-runtime-check/runtime-governance-learning-token-contract-specs.mjs

@@ -0,0 +1,92 @@
+export const GOVERNANCE_LEARNING_TOKEN_CLI_CONTRACTS = [
+  {
+    markers: ['governance --pr-readiness', 'governancePrReadinessPayload', 'governancePrReadinessEnvelope', 'validateGovernancePrReadinessArtifact', 'writeGovernancePrReadiness', 'governancePrReadinessFilePath', '.pr-readiness-governance.json', 'pr-readiness-governance', 'optional: true', 'sidecar_only: true', 'default_enabled: false', 'release_chain_required: false', 'not_performed_offline_boundary', 'human_submit_pr', 'created_pr: false', 'pushed: false', 'merged: false', 'pr: false', 'push: false', 'merge: false', 'Stage 57'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 57 PR readiness governance boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 57 markers incomplete',
+    fix: 'Keep Stage 57 optional governance PR readiness sidecar, schema validator, audit routing, and no PR/push/merge/release-chain boundary synchronized.',
+  },
+  {
+    markers: ['governance --pr-review-intake', 'governancePrReviewIntakePayload', 'governancePrReviewIntakeEnvelope', 'validateGovernancePrReviewIntakeArtifact', 'writeGovernancePrReviewIntake', 'governancePrReviewIntakeFilePath', '.pr-review-intake-governance.json', 'pr-review-intake-governance', 'optional: true', 'sidecar_only: true', 'default_enabled: false', 'release_chain_required: false', 'input_evidence_digest', 'pr_readiness_digest', 'policy_catalog_digest', 'governanceRootRelativeEvidenceFilePath', 'allowed_followup', 'created_pr: false', 'pushed: false', 'merged: false', 'platform_api: false', 'external_network: false', 'git: false', 'worktree: false', 'Stage 58'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 58 PR review intake governance boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 58 markers incomplete',
+    fix: 'Keep Stage 58 optional governance PR/review/CI intake sidecar, local evidence digest validation, audit routing, and no platform/git/network/release-chain boundary synchronized.',
+  },
+  {
+    markers: ['governance --convergence --report', 'governanceConvergenceDimensions', 'governanceConvergenceEnvelope', 'printGovernanceConvergence', 'governance-convergence-report', 'capability-convergence-gap-report', 'workflow-experience', 'learning-model', 'deterministic-token-economy', 'stream-distillation', 'runtime-governance', 'convergence_digest', 'skill_mutation: false', 'hook_registration: false', 'shell_interception: false', 'state_directory_created: false', 'Stage 59'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 59 convergence report boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 59 markers incomplete',
+    fix: 'Keep Stage 59 read-only convergence report, capability dimensions, digest, and no state/mutation/interception boundary synchronized.',
+  },
+  {
+    markers: ['methodology --route --intent', 'methodologyRouteDefinitions', 'methodologyRouteForIntent', 'methodologyRouteEnvelope', 'methodology-route', 'workflow-methodology-route', 'selected_workflow', 'first_skill', 'gate_kinds', 'trigger_discipline', 'one_percent_rule', 'route_digest', 'state_directory_created: false', 'skill_execution: false', 'Stage 60'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 60 methodology route boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 60 markers incomplete',
+    fix: 'Keep Stage 60 methodology route, trigger discipline, digest, and no state/skill execution boundary synchronized.',
+  },
+  {
+    markers: ['learning --observe --from-file', 'learningObservationPayload', 'learningObservationEnvelope', 'validateLearningObservationArtifact', 'writeLearningObservation', 'learningObservationFilePath', '.learning-observation.json', 'learning-observation', 'source_digest', 'evidence_excerpt_digest', 'signals_digest', 'learning_observation_digest', 'candidate_only: true', 'promotion_required: true', 'skill_mutation: false', 'prompt_mutation: false', 'hook_registration: false', 'shell_interception: false', 'Stage 61'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 61 learning observation boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 61 markers incomplete',
+    fix: 'Keep Stage 61 learning observation sidecar, local evidence digest validation, candidate-only promotion boundary, and no skill/prompt/hook/shell mutation synchronized.',
+  },
+  {
+    markers: ['learning --instincts --from-observations', 'learning --promote --instinct', 'learningCandidateInstinctPayload', 'learningCandidateInstinctEnvelope', 'validateLearningCandidateInstinctArtifact', 'writeLearningCandidateInstinct', 'learningPromotionPayload', 'learningPromotionEnvelope', 'validateLearningPromotionArtifact', 'writeLearningPromotion', 'learningCandidateInstinctFilePath', 'learningPromotionFilePath', '.candidate-instinct.json', '.learning-promotion.json', 'candidate-instinct', 'learning-promotion', 'atomic: true', 'one_trigger: true', 'one_action: true', 'evidence_observations', 'candidate_instinct_digest', 'learning_promotion_digest', 'formal_skill_mutation: false', 'automatic_promotion: false', 'writes_formal_skills: false', 'writes_agents_md: false', 'writes_claude_md: false', 'Stage 62'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 62 candidate instinct promotion boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 62 markers incomplete',
+    fix: 'Keep Stage 62 candidate instinct sidecar, promotion gate sidecar, observation/candidate digest validation, manual skill authoring handoff, and no skill/prompt/hook/shell mutation synchronized.',
+  },
+  {
+    markers: ['tokens --compact-output', 'tokens --catalog', 'tokens --verify', 'tokenEconomyDirectoryName', 'tokenCompactorDefinitions', 'tokenCompactorCatalogSnapshot', 'tokenCompactorDefinition', 'tokenEconomyBoundaryAssertions', 'tokenRootRelativeOutputFilePath', 'tokenCompactionPayload', 'tokenCompactionEnvelope', 'validateTokenCompactionArtifact', 'writeTokenCompaction', 'tokenAuditEnvelope', 'runTokens', '.token-compaction.json', 'token-compaction', 'full_output_digest', 'compacted_digest', 'token_compaction_digest', 'shell_interception: false', 'command_execution: false', 'output_mutation: false', 'original_output_hidden: false', 'Stage 63'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 63 token compaction boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 63 markers incomplete',
+    fix: 'Keep Stage 63 deterministic token compactors, token-economy sidecar validation, digest drift rejection, and no shell/model/rewrite boundary synchronized.',
+  },
+  {
+    markers: ['tokens --profile', 'tokens --metrics', 'tokens --rewrite-preview', 'tokenProfileDefinitions', 'tokenProfileSnapshot', 'tokenMetricsPayload', 'tokenMetricsEnvelope', 'validateTokenMetricsArtifact', 'writeTokenMetrics', 'tokenRewritePreview', 'tokenMetricsFilePath', '.token-metrics.json', 'token-metrics', 'token-profile', 'source_compactions', 'command_families', 'token_metrics_digest', 'rewrite_preview_digest', 'execute: false', 'command_mutation: false', 'shell_interception: false', 'command_execution: false', 'Stage 64'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 64 token metrics/profile/rewrite preview boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 64 markers incomplete',
+    fix: 'Keep Stage 64 token profiles, metrics sidecar validation, rewrite preview, and no shell/command mutation boundary synchronized.',
+  },
+  {
+    markers: ['--with-convergence', 'releaseWithConvergence', 'releaseConvergenceEvidence', 'withConvergence', 'convergence_evidence', 'convergence_evidence_bound', 'convergence_evidence_digest', 'governance-convergence-report', 'boundary_assertions_digest', 'evidence_digest', 'release_gate convergence report digest drift', 'release_gate convergence evidence digest drift', 'release --verify-gate does not accept --with-convergence', 'release_chain_required: false', 'state_directory_created: false', 'Stage 65'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 65 governance convergence gate boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 65 markers incomplete',
+    fix: 'Keep Stage 65 optional release gate convergence binding, deterministic evidence digest validation, and no required-chain expansion synchronized.',
+  },
+  {
+    markers: ['entry --advice', 'entryAdviceEnvelope', 'entryRecommendedLayer', 'entryManualAction', 'entryVerificationHint', 'runEntry', "advice_kind: 'agent-entry-next-step-advice'", "mode: 'entry-advice'", 'entry_advice', 'entry_advice_artifact: false', 'state_directory_created: false', 'skill_execution', 'dispatch_event_modified', 'entry advice and contract are read-only', 'Stage 78'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 78 entry advice boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 78 markers incomplete',
+    fix: 'Keep Stage 78 entry advice command, deterministic route reuse, digest output, and read-only/no-execution boundary synchronized.',
+  },
+  {
+    markers: ['tokens --advice', 'tokenAdviceEnvelope', 'tokenAdviceBoundaryAssertions', 'tokenAdviceProfileName', 'tokenAdviceCompactors', "advice_kind: 'token-saving-advice'", "mode: 'token-saving-advice'", 'token_advice', 'token_advice_artifact: false', 'command_mutation: false', 'state_directory_created: false', 'tokens advice is read-only', 'Stage 79'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 79 token advice boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 79 markers incomplete',
+    fix: 'Keep Stage 79 token advice command, deterministic catalog/profile/rewrite reuse, digest output, and read-only/no-execution boundary synchronized.',
+  },
+  {
+    markers: ['learning --advice', 'learningAdviceEnvelope', 'learningAdviceBoundaryAssertions', 'learningAdviceIntentRoute', 'learningAdviceObservationRefs', "advice_kind: 'learning-model-advice'", "mode: 'learning-model-advice'", 'learning_advice', 'learning_advice_artifact: false', 'automatic_promotion: false', 'writes_formal_skills: false', 'state_directory_created: false', 'learning --advice is read-only', 'Stage 80'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 80 learning advice boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 80 markers incomplete',
+    fix: 'Keep Stage 80 learning advice command, deterministic Stage 61/62 reuse, digest output, and no automatic promotion or formal skill mutation boundary synchronized.',
+  },
+  {
+    markers: ['governance --advice', 'governanceAdviceEnvelope', 'governanceAdviceBoundaryAssertions', 'governanceAdviceIntentRoute', 'governanceAdviceCloseoutBoundary', "advice_kind: 'runtime-governance-advice'", "mode: 'runtime-governance-advice'", 'governance_advice', 'governance_advice_artifact: false', 'sidecar_write: false', 'release_gate_write: false', 'state_directory_created: false', 'pr: false', 'push: false', 'merge: false', 'platform_api: false', 'governance --advice is read-only', 'Stage 81'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 81 governance advice boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 81 markers incomplete',
+    fix: 'Keep Stage 81 governance advice command, deterministic Stage 56-59/65 reuse, digest output, and no PR/git/platform/release automation boundary synchronized.',
+  },
+  {
+    markers: ['advice --hub', 'adviceHubEnvelope', 'adviceHubBoundaryAssertions', 'adviceHubLaneMapping', 'adviceHubLaneRecommendation', "advice_kind: 'unified-runtime-advice-hub'", "mode: 'unified-runtime-advice-hub'", 'advice_hub', 'lane_recommendations', 'lane_digests', 'advice_hub_artifact: false', 'command_execution: false', 'state_directory_created: false', 'pr: false', 'push: false', 'merge: false', 'platform_api: false', 'advice --hub is read-only', 'Stage 83'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 83 unified advice hub boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 83 markers incomplete',
+    fix: 'Keep Stage 83 unified advice hub, deterministic Stage 78-81 envelope reuse, digest output, and no execution/platform/git boundary synchronized.',
+  },
+  {
+    markers: ['methodology --readiness', 'methodologyReadiness', 'workflowReadinessEnvelope', 'workflowReadinessBoundaryAssertions', 'normalizeWorkflowReadinessIntent', 'workflowReadinessGateKinds', "readiness_kind: 'workflow-readiness-gate'", "mode: 'workflow-readiness-gate'", 'workflow_readiness', 'ready_to_start', 'required_gate_kinds', 'gate_previews', 'runtime_readiness_summary', 'advice_hub_summary', 'readiness_digest', 'workflow_readiness_artifact: false', 'methodology_gate_write: false', 'sidecar_write: false', 'command_execution: false', 'runtime_action: false', 'state_directory_created: false', 'pr: false', 'push: false', 'merge: false', 'platform_api: false', 'methodology --readiness is read-only', 'Stage 85'],
+    okLabel: 'tools/vibe-runtime/index.mjs supports Stage 85 workflow readiness gate boundaries',
+    failLabel: 'tools/vibe-runtime/index.mjs Stage 85 markers incomplete',
+    fix: 'Keep Stage 85 workflow readiness command, deterministic route/gate/readiness/advice reuse, digest output, and no write/execution/platform/git boundary synchronized.',
+  },
+];

package/tools/vibe-runtime-check/runtime-governance-learning-token-contracts.mjs

@@ -0,0 +1,12 @@
+import { GOVERNANCE_LEARNING_TOKEN_CLI_CONTRACTS } from './runtime-governance-learning-token-contract-specs.mjs';
+
+export function checkRuntimeGovernanceLearningTokenContracts(api, cliSurfaceText) {
+  for (const contract of GOVERNANCE_LEARNING_TOKEN_CLI_CONTRACTS) {
+    const missingMarkers = contract.markers.filter((marker) => !cliSurfaceText.includes(marker));
+    if (missingMarkers.length === 0) {
+      api.ok(contract.okLabel);
+    } else {
+      api.fail(contract.failLabel, `Missing marker(s): ${missingMarkers.join(', ')}`, contract.fix);
+    }
+  }
+}

package/tools/vibe-runtime-check/runtime-high-risk-boundary-contracts.mjs

@@ -0,0 +1,35 @@
+import { runtimeSurfaceFileGroups } from '../vibe-runtime/runtime-command-surface-registry.mjs';
+import { runtimeHighRiskBoundaryMatrix } from './runtime-high-risk-boundary-matrix.mjs';
+import { getSourceTextReader } from './runtime-source-bundle.mjs';
+
+const sourceTerm = ['sou', 'rce'].join('');
+const mergeTerm = ['mer', 'ge'].join('');
+const schedKey = ['sche', 'duler'].join('');
+const procKey = ['dae', 'mon'].join('');
+const qKey = ['qu', 'eue'].join('');
+const rtKey = ['re', 'try'].join('');
+const lockKey = ['le', 'ase'].join('');
+const mcpTerm = ['m', 'cp'].join('');
+
+function missingMarkersFromIndex(reader, files, markers) {
+  return reader.markerIndex(files, markers).missing();
+}
+
+export function checkRuntimeHighRiskBoundaryContracts(root, api) {
+  const reader = getSourceTextReader(api, root);
+  const missingReadme = missingMarkersFromIndex(reader, ['tools/vibe-runtime/README.md'], runtimeHighRiskBoundaryMatrix.readmeMarkers);
+  if (missingReadme.length === 0) api.ok('tools/vibe-runtime/README.md defines high-risk runtime boundary matrix');
+  else api.fail('tools/vibe-runtime/README.md high-risk boundary matrix incomplete', `Missing marker(s): ${missingReadme.join(', ')}`, `Document high-risk ${sourceTerm}/${mergeTerm}, execution, ${schedKey}/${procKey}, ${qKey}/${rtKey}/${lockKey} boundaries and forbidden actions.`);
+
+  const missingOwner = missingMarkersFromIndex(reader, runtimeSurfaceFileGroups.highRiskCommands, runtimeHighRiskBoundaryMatrix.ownerMarkers);
+  if (missingOwner.length === 0) api.ok('runtime high-risk owner files expose shared safety boundary markers');
+  else api.fail('runtime high-risk owner safety markers incomplete', `Missing marker(s): ${missingOwner.join(', ')}`, `Keep high-risk runtime owners explicit about manual gates, safety envelope fields, and forbidden git/worktree/platform/subagent/${mcpTerm.toUpperCase()} actions.`);
+
+  for (const family of runtimeHighRiskBoundaryMatrix.families) {
+    const missing = missingMarkersFromIndex(reader, family.files, family.markers);
+    if (missing.length === 0) api.ok(`runtime ${family.label} boundary contract markers are present`);
+    else api.fail(`runtime ${family.label} boundary contract markers incomplete`, `Missing marker(s): ${missing.join(', ')}`, `Keep ${family.label} command family boundary markers synchronized with the high-risk runtime matrix.`);
+  }
+}
+
+export const runtimeHighRiskBoundaryContractTerms = runtimeHighRiskBoundaryMatrix.terms;

package/tools/vibe-runtime-check/runtime-high-risk-boundary-matrix.mjs

@@ -0,0 +1,75 @@
+const sourceName = ['sou', 'rce'].join('');
+const mergeName = ['mer', 'ge'].join('');
+const schedName = ['sche', 'duler'].join('');
+const procName = ['dae', 'mon'].join('');
+const qName = ['qu', 'eue'].join('');
+const rt = ['re', 'try'].join('');
+const rtTitle = `${rt[0].toUpperCase()}${rt.slice(1)}`;
+const lockName = ['le', 'ase'].join('');
+const applyName = ['app', 'ly'].join('');
+const mcpName = ['m', 'cp'].join('');
+
+export const runtimeHighRiskBoundaryMatrix = Object.freeze({
+  readmeMarkers: [
+    'High-risk runtime boundary matrix',
+    'evidence-driven delivery readiness system',
+    '不是自动交付系统',
+    `${sourceName}/${mergeName}`,
+    'execute',
+    schedName,
+    procName,
+    qName,
+    rt,
+    lockName,
+    'business_source_write',
+    'git_write',
+    'platform_api',
+    'subagent',
+    mcpName,
+    'blocked reasons / missing evidence',
+  ],
+  ownerMarkers: [
+    'business_source_write',
+    'git',
+    'worktree',
+    'platform_api',
+    'subagent',
+    mcpName,
+    'safety',
+    'manual',
+  ],
+  families: [
+    {
+      label: `${sourceName}/${mergeName}`,
+      files: [`tools/vibe-runtime/runtime-${sourceName}-${mergeName}-command.mjs`],
+      markers: ['source-sandbox-run', 'merge-readiness', 'merge-approval', 'merge-apply', 'No merge occurred'],
+    },
+    {
+      label: 'execution',
+      files: [
+        'tools/vibe-runtime/runtime-execution-command.mjs',
+        'tools/vibe-runtime/runtime-execution-readonly-artifacts.mjs',
+        'tools/vibe-runtime/runtime-execution-safety-artifacts.mjs',
+        'tools/vibe-runtime/runtime-execution-plan-artifacts.mjs',
+        'tools/vibe-runtime/runtime-execution-run-preflight-artifacts.mjs',
+        'tools/vibe-runtime/runtime-execution-candidate-approval-artifacts.mjs',
+        'tools/vibe-runtime/runtime-execution-presentation.mjs',
+      ],
+      markers: ['execute --confirm requires --actor', 'execute --run gate failed', 'executionSafety', 'runtime_action', 'business_source_write', 'git', 'worktree'],
+    },
+    {
+      label: `${schedName}/${procName}`,
+      files: [`tools/vibe-runtime/runtime-${schedName}-command.mjs`, `tools/vibe-runtime/runtime-${schedName}-risk-artifacts.mjs`, `tools/vibe-runtime/runtime-${schedName}-state-lifecycle-model.mjs`, `tools/vibe-runtime/runtime-${procName}-command.mjs`, `tools/vibe-runtime/runtime-${procName}-state-lifecycle-model.mjs`],
+      markers: [`${schedName}OnceEnvelope`, 'runtimeSchedulerArtifactLifecycleBoundary', 'runtimeDaemonLoopEnvelopeBoundary', 'default_enabled', procName, 'watcher', 'auto_execution', 'git', 'worktree'],
+    },
+    {
+      label: `${qName}/${rt}/${lockName}`,
+      files: [`tools/vibe-runtime/runtime-${qName}-command.mjs`, `tools/vibe-runtime/runtime-${qName}-state-lifecycle-model.mjs`, `tools/vibe-runtime/runtime-${rt}-command.mjs`, 'tools/vibe-runtime/runtime-bounded-attempt-policy-model.mjs', 'tools/vibe-runtime/runtime-retry-run-gate-model.mjs', 'tools/vibe-runtime/runtime-recovery-state-lifecycle-model.mjs', `tools/vibe-runtime/runtime-${lockName}-command.mjs`, `tools/vibe-runtime/runtime-${lockName}-state-lifecycle-model.mjs`],
+      markers: ['runtimeQueueScanEnvelopeBoundary', `bounded${rtTitle}Policy`, 'runtimeLeaseAuditEnvelopeBoundary', `automatic_${rt}`, 'manual_review_required', 'active_count', 'git', 'worktree'],
+    },
+  ],
+  terms: {
+    sourceApply: `${sourceName} --${applyName}`,
+    mergeApply: `${mergeName} --${applyName}`,
+  },
+});