@jtf19/vibecoding-kit 0.1.0

package/tools/vibe-doctor/index.mjs

@@ -0,0 +1,1721 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { spawnSync } from 'node:child_process';
+import {
+  runtimeCliSurfaceFiles,
+  runtimeRequiredToolFiles,
+} from '../vibe-runtime/runtime-command-surface-registry.mjs';
+import { createSourceTextReader } from '../vibe-runtime-check/runtime-source-bundle.mjs';
+import { runtimeDocContractMarkerSpecs } from '../vibe-runtime-check/runtime-doc-contract-marker-specs.mjs';
+import {
+  runtimeToolCliSurfaceMarkerSpecs,
+  runtimeToolReadmeMarkerSpecs,
+} from '../vibe-runtime-check/runtime-tool-readme-marker-specs.mjs';
+
+const installedBase = '.vibecoding';
+const runtimeManifestFile = `${installedBase}/runtime-installed.json`;
+const installConfigFile = `${installedBase}/config.json`;
+
+const skillFiles = [
+  'skills/using-vibecoding/SKILL.md',
+  'skills/vibe-brainstorming/SKILL.md',
+  'skills/vibe-product-discovery/SKILL.md',
+  'skills/vibe-product-spec/SKILL.md',
+  'skills/vibe-ui-design/SKILL.md',
+  'skills/vibe-planning/SKILL.md',
+  'skills/vibe-writing-skills/SKILL.md',
+  'skills/vibe-writing-plans/SKILL.md',
+  'skills/vibe-workspace-isolation/SKILL.md',
+  'skills/vibe-subagent-driven-development/SKILL.md',
+  'skills/vibe-dispatching-parallel-work/SKILL.md',
+  'skills/vibe-test-driven-development/SKILL.md',
+  'skills/vibe-executing-plans/SKILL.md',
+  'skills/vibe-product-acceptance/SKILL.md',
+  'skills/vibe-debugging/SKILL.md',
+  'skills/vibe-systematic-debugging/SKILL.md',
+  'skills/vibe-implementation/SKILL.md',
+  'skills/vibe-requesting-code-review/SKILL.md',
+  'skills/vibe-review/SKILL.md',
+  'skills/vibe-receiving-code-review/SKILL.md',
+  'skills/vibe-verification/SKILL.md',
+  'skills/vibe-verification-before-completion/SKILL.md',
+  'skills/vibe-finishing-a-development-branch/SKILL.md',
+  'skills/vibe-context-compact/SKILL.md',
+];
+
+const workflowSkillFiles = skillFiles.filter((file) => !file.includes('using-vibecoding'));
+
+const platformNames = ['claude', 'codex', 'cursor', 'opencode', 'pi'];
+
+const platformAdapterFiles = {
+  claude: [
+    'adapters/claude/plugin.json',
+    'adapters/claude/install.md',
+    'adapters/claude/settings.example.json',
+  ],
+  codex: [
+    'adapters/codex/plugin.json',
+    'adapters/codex/hooks.example.json',
+    'adapters/codex/install.md',
+  ],
+  cursor: [
+    'adapters/cursor/plugin.json',
+    'adapters/cursor/hooks.example.json',
+    'adapters/cursor/install.md',
+  ],
+  opencode: [
+    'adapters/opencode/plugin.json',
+    'adapters/opencode/plugin.js',
+    'adapters/opencode/install.md',
+  ],
+  pi: [
+    'adapters/pi/plugin.json',
+    'adapters/pi/extension.ts',
+    'adapters/pi/install.md',
+  ],
+};
+
+const platformEntryFiles = {
+  claude: ['CLAUDE.md'],
+  codex: ['AGENTS.md'],
+  cursor: ['AGENTS.md'],
+  opencode: [],
+  pi: [],
+};
+
+const docs = [
+  'docs/phase-1-implementation.md',
+  'docs/phase-2-roadmap.md',
+  'docs/install-experience-roadmap.md',
+  'docs/runtime-roadmap.md',
+  'docs/runtime-contract.md',
+  'docs/workflow-chaining.md',
+  'docs/golden-path.md',
+  'docs/install.md',
+  'docs/user-guide.md',
+  'docs/team-adoption.md',
+  'docs/evidence-authoring.md',
+  'docs/ci-evidence-onboarding.md',
+  'docs/readiness-interpretation.md',
+  'docs/readiness-troubleshooting.md',
+  'docs/acceptance-checklist.md',
+  'docs/release-guide.md',
+  'docs/submodule-guide.md',
+  'docs/install-claude.md',
+  'docs/install-codex.md',
+  'docs/install-cursor.md',
+  'docs/skill-authoring-guide.md',
+];
+
+const repoGuideFiles = {
+  'README.md': [
+    'tools/vibe-init/README.md',
+    'tools/vibe-doctor/README.md',
+    'tools/vibe-plugin-pack/README.md',
+    'tools/vibe-runtime-check/README.md',
+    'tools/vibe-runtime/README.md',
+    'docs/runtime-roadmap.md',
+    'docs/runtime-contract.md',
+    'docs/golden-path.md',
+    'docs/evidence-authoring.md',
+    'docs/ci-evidence-onboarding.md',
+    'docs/readiness-interpretation.md',
+    'docs/readiness-troubleshooting.md',
+    'docs/acceptance-checklist.md',
+    'docs/release-guide.md',
+    'docs/install-experience-roadmap.md',
+  ],
+  'docs/release-guide.md': [
+    'docs/acceptance-checklist.md',
+    'docs/submodule-guide.md',
+    'docs/install-experience-roadmap.md',
+    'docs/runtime-roadmap.md',
+    'docs/runtime-contract.md',
+    'tools/vibe-plugin-pack/index.mjs',
+    'tools/vibe-release-check/index.mjs',
+  ],
+  'docs/acceptance-checklist.md': [
+    'docs/phase-2-roadmap.md',
+    'docs/install-experience-roadmap.md',
+    'docs/submodule-guide.md',
+    'tools/vibe-plugin-pack/index.mjs',
+    'tools/vibe-runtime-check/index.mjs',
+    'tools/vibe-runtime/index.mjs',
+    'tools/vibe-release-check/index.mjs',
+  ],
+};
+
+const submodulePaths = [
+  'fork/distill',
+  'fork/ECC',
+  'fork/superpowers',
+  'fork/token-savior',
+];
+
+const entryTemplateFiles = [
+  'templates/CLAUDE.md',
+  'templates/AGENTS.md',
+];
+
+const installedRulesTemplateFiles = [
+  'templates/VIBE-CODING.md',
+];
+
+const productArtifactTemplateFiles = [
+  'templates/product-discovery.md',
+  'templates/product-spec.md',
+  'templates/ui-design-contract.md',
+  'templates/product-acceptance.md',
+  'templates/scenario-acceptance.yaml',
+  'templates/architecture-design.md',
+  'templates/delivery-traceability.yaml',
+  'templates/implementation-plan.md',
+];
+
+const evidenceTemplateGuideFiles = [
+  'templates/evidence/README.md',
+];
+
+const evidenceTemplateFiles = [
+  'templates/evidence/test-evidence.json',
+  'templates/evidence/diff-coverage.json',
+];
+
+const templateFiles = [
+  ...entryTemplateFiles,
+  ...installedRulesTemplateFiles,
+  ...productArtifactTemplateFiles,
+  ...evidenceTemplateGuideFiles,
+  ...evidenceTemplateFiles,
+];
+
+const toolFiles = [
+  'bin/vibe.mjs',
+  'tools/vibe-init/README.md',
+  'tools/vibe-doctor/README.md',
+  'tools/vibe-lifecycle/index.mjs',
+  'tools/vibe-lifecycle/README.md',
+  'tools/vibe-plugin-pack/index.mjs',
+  'tools/vibe-plugin-pack/README.md',
+  'tools/vibe-compact/index.mjs',
+  'tools/vibe-compact/README.md',
+  'tools/vibe-runtime-check/index.mjs',
+  'tools/vibe-runtime-check/runtime-contract-registry.mjs',
+  'tools/vibe-runtime-check/runtime-contract-product-registry.mjs',
+  'tools/vibe-runtime-check/runtime-contract-delivery-registry.mjs',
+  'tools/vibe-runtime-check/runtime-contract-implementation-registry.mjs',
+  'tools/vibe-runtime-check/runtime-contract-local-evidence-registry.mjs',
+  'tools/vibe-runtime-check/product-artifact-contracts.mjs',
+  'tools/vibe-runtime-check/README.md',
+  'tools/vibe-architecture-check/index.mjs',
+  'tools/vibe-architecture-check/README.md',
+  ...runtimeRequiredToolFiles,
+  'tools/vibe-release-check/index.mjs',
+  'tools/vibe-release-check/release-check-runtime.mjs',
+  'tools/vibe-release-check/release-check-json-markers.mjs',
+  'tools/vibe-release-check/release-check-workflow-ux-smoke.mjs',
+  'tools/vibe-release-check/release-check-completion-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-ledger-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-ledger-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-handoff-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-task-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-dispatch-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-scheduler-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-scheduler-fixture-specs.mjs',
+  'tools/vibe-release-check/release-check-runtime-handoff-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-task-artifact-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-dispatch-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-execution-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-execution-base-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-execution-approval-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-execution-scheduler-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-execution-recovery-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-daemon-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-fixtures.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-methodology-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-subagents-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-platform-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-source-suite.mjs',
+  'tools/vibe-release-check/release-check-runtime-automation-governance-suite.mjs',
+  'tools/vibe-release-check/release-check-full-chain-suite.mjs',
+  'tools/vibe-release-check/release-check-golden-path-suite.mjs',
+  'tools/vibe-release-check/release-check-methodology-suite.mjs',
+  'tools/vibe-release-check/release-check-workflow-entry-suite.mjs',
+  'tools/vibe-release-check/release-check-learning-suite.mjs',
+  'tools/vibe-release-check/release-check-token-suite.mjs',
+  'tools/vibe-release-check/command-manifest/release-check-command-metadata.mjs',
+  'tools/vibe-release-check/command-manifest/release-check-full-chain-commands.mjs',
+  'tools/vibe-release-check/README.md',
+];
+
+const productArtifactFixtureFiles = [
+  'examples/runtime-fixtures/product-discovery.md',
+  'examples/runtime-fixtures/product-spec.md',
+  'examples/runtime-fixtures/ui-design-contract.md',
+  'examples/runtime-fixtures/product-acceptance.md',
+  'examples/runtime-fixtures/scenario-acceptance.yaml',
+  'examples/runtime-fixtures/evidence.json',
+  'examples/runtime-fixtures/architecture-design.md',
+  'examples/runtime-fixtures/delivery-traceability.yaml',
+  'examples/runtime-fixtures/implementation-plan.md',
+  'examples/runtime-fixtures/test-evidence.json',
+  'examples/runtime-fixtures/diff-coverage.json',
+  'examples/runtime-fixtures/commit-readiness.json',
+  'examples/runtime-fixtures/negative/delivery-traceability-bad-ref.yaml',
+  'examples/runtime-fixtures/negative/test-evidence-missing-output-digest.json',
+  'examples/runtime-fixtures/negative/diff-coverage-unexpected-file.json',
+  'examples/runtime-fixtures/negative/commit-readiness-boundary-escalated.json',
+  'examples/runtime-fixtures/negative/diff-coverage-changed-file-without-task-ref.json',
+  'examples/runtime-fixtures/negative/diff-coverage-required-task-missing.json',
+  'examples/runtime-fixtures/negative/diff-coverage-operation-mismatch.json',
+  'examples/runtime-fixtures/negative/test-evidence-risky-task-missing.json',
+  'examples/golden-path/README.md',
+  'examples/golden-path/product-spec.md',
+  'examples/golden-path/implementation-plan.md',
+  'examples/golden-path/test-evidence.json',
+  'examples/golden-path/diff-coverage.json',
+  'examples/full-chain/README.md',
+  'examples/full-chain/product-discovery.md',
+  'examples/full-chain/product-spec.md',
+  'examples/full-chain/ui-design-contract.md',
+  'examples/full-chain/product-acceptance.md',
+  'examples/full-chain/scenario-acceptance.yaml',
+  'examples/full-chain/evidence.json',
+  'examples/full-chain/architecture-design.md',
+  'examples/full-chain/delivery-traceability.yaml',
+  'examples/full-chain/implementation-plan.md',
+  'examples/full-chain/test-evidence.json',
+  'examples/full-chain/diff-coverage.json',
+  'examples/full-chain/commit-readiness.json',
+];
+
+const ciEvidenceExampleFiles = [
+  'examples/ci/README.md',
+  'examples/ci/ci-evidence-input.example.json',
+  'examples/ci/generate-test-evidence.mjs',
+  'examples/ci/generate-diff-coverage.mjs',
+  'examples/ci/github-actions-readiness.yml',
+];
+
+const hookFiles = [
+  'hooks/session-start/README.md',
+  'hooks/session-start/session-start.md',
+  'hooks/session-start/session-start.mjs',
+  'hooks/post-tool-compact/README.md',
+  'hooks/workflow-handoff/README.md',
+  'hooks/workflow-handoff/workflow-handoff.md',
+];
+
+const handoffMarkers = [
+  '## 下一步调用',
+  '## Workflow Handoff',
+  'current_skill:',
+  'next_skill:',
+  'handoff:',
+  'stop_condition:',
+];
+
+const acceptancePrompts = [
+  '我想给这个项目加一个新功能，先帮我规划一下。',
+  '这个功能不工作，帮我排查。',
+  '实现完成了，帮我确认能不能交付。',
+];
+
+const entryFileMarkers = {
+  'CLAUDE.md': ['Vibecoding Kit', '.vibecoding/skills/', 'using-vibecoding'],
+  'AGENTS.md': ['Vibecoding Kit', '.vibecoding/skills/'],
+};
+
+const entryWorkflowMarkers = [
+  'vibe-brainstorming',
+  'vibe-product-discovery',
+  'vibe-product-spec',
+  'vibe-ui-design',
+  'vibe-writing-skills',
+  'vibe-writing-plans',
+  'vibe-workspace-isolation',
+  'vibe-subagent-driven-development',
+  'vibe-dispatching-parallel-work',
+  'vibe-test-driven-development',
+  'vibe-executing-plans',
+  'vibe-product-acceptance',
+  'vibe-systematic-debugging',
+  'vibe-requesting-code-review',
+  'vibe-receiving-code-review',
+  'vibe-verification-before-completion',
+  'vibe-finishing-a-development-branch',
+];
+
+const installedEntryCardMarkers = [
+  '受控 agent 沙盒',
+  'using-vibecoding',
+  'workflow_start.entry_summary',
+  'entry_summary.state_gap_is_expected=true',
+  'completion_evidence.task_completion_summary',
+  'blocked_reasons',
+  'readiness gates',
+  '不授权自动执行命令',
+  'subagent',
+  '平台 API',
+  'git',
+  'push',
+  'PR',
+  'merge',
+  '.vibecoding/VIBE-CODING.md',
+];
+
+const installedEntryProtocolMarkers = [
+  '默认交互协议',
+  'Vibecoding workflow 是任务路由和质量护栏',
+  '任务分流',
+  '质量底线',
+  '升级到完整 workflow 的条件',
+  'vibe-brainstorming',
+  'vibe-product-discovery',
+  'vibe-product-spec',
+  'vibe-ui-design',
+  'vibe-planning',
+  'vibe-writing-plans',
+  'vibe-product-acceptance',
+  'vibe-systematic-debugging',
+  'vibe-verification-before-completion',
+  'vibe-finishing-a-development-branch',
+];
+
+const managedBlockStartMarker = '<!-- vibecoding:start';
+const managedBlockEndMarker = '<!-- vibecoding:end -->';
+const managedBlockPattern = /<!-- vibecoding:start[^>]*-->[\s\S]*?<!-- vibecoding:end -->/g;
+
+function usage() {
+  return `Vibecoding Kit Doctor\n\nUsage:\n  node tools/vibe-doctor/index.mjs [root]\n  node tools/vibe-doctor/index.mjs --workflow-entry [root]\n\nOptions:\n  --workflow-entry  Run Stage 95 workflow entry health checks only.\n  --help, -h        Show this help.\n\nChecks a Vibecoding Kit source repo or an installed business project layout.\n`;
+}
+
+function parseArgs(argv) {
+  const options = { help: false, workflowEntry: false, root: process.cwd() };
+  const positional = [];
+
+  for (const arg of argv) {
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--workflow-entry') {
+      options.workflowEntry = true;
+    } else if (arg.startsWith('-')) {
+      throw new Error(`Unknown argument: ${arg}`);
+    } else {
+      positional.push(arg);
+    }
+  }
+
+  if (positional.length > 1) throw new Error(`Expected at most one root path, received ${positional.length}.`);
+  if (positional.length === 1) options.root = path.resolve(positional[0]);
+
+  return options;
+}
+
+let options;
+try {
+  options = parseArgs(process.argv.slice(2));
+} catch (error) {
+  console.error(`Error: ${error.message}`);
+  console.error('');
+  console.error(usage());
+  process.exit(1);
+}
+
+if (options.help) {
+  console.log(usage());
+  process.exit(0);
+}
+
+const root = options.root;
+const results = [];
+
+function toNative(relativePath) {
+  return path.join(root, ...relativePath.split('/'));
+}
+
+function exists(relativePath) {
+  return fs.existsSync(toNative(relativePath));
+}
+
+function isDirectory(relativePath) {
+  try {
+    return fs.statSync(toNative(relativePath)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+function readText(relativePath) {
+  return fs.readFileSync(toNative(relativePath), 'utf8');
+}
+
+let sourceTextReader;
+
+function getSourceTextReader() {
+  if (!sourceTextReader) sourceTextReader = createSourceTextReader({ exists, readText });
+  return sourceTextReader;
+}
+
+function readExistingTextBundle(files) {
+  return getSourceTextReader().joinSourceTexts(files);
+}
+
+function add(status, label, detail = '', fix = '') {
+  results.push({ status, label, detail, fix });
+}
+
+function ok(label, detail = '') {
+  add('ok', label, detail);
+}
+
+function warn(label, detail = '', fix = '') {
+  add('warn', label, detail, fix);
+}
+
+function fail(label, detail = '', fix = '') {
+  add('fail', label, detail, fix);
+}
+
+function prefixed(base, relativePath) {
+  if (!base) return relativePath;
+  return `${base}/${relativePath}`;
+}
+
+function detectedInstalledPlatforms() {
+  const byAdapter = platformNames.filter((platform) => {
+    const adapterDirectory = `${installedBase}/adapters/${platform}`;
+    return isDirectory(adapterDirectory) || platformAdapterFiles[platform].some((file) => exists(prefixed(installedBase, file)));
+  });
+
+  if (byAdapter.length > 0) return byAdapter;
+
+  const byEntry = [];
+  if (exists('CLAUDE.md')) byEntry.push('claude');
+  if (exists('AGENTS.md')) byEntry.push('codex', 'cursor');
+  return [...new Set(byEntry)];
+}
+
+function detectLayout() {
+  if (isDirectory(installedBase) && isDirectory(`${installedBase}/skills`)) {
+    const platforms = detectedInstalledPlatforms();
+    const requiredEntryFiles = [...new Set(platforms.flatMap((platform) => platformEntryFiles[platform]))];
+
+    return {
+      name: 'installed',
+      base: installedBase,
+      platforms,
+      requiredDirectories: [
+        installedBase,
+        `${installedBase}/skills`,
+        `${installedBase}/adapters`,
+        `${installedBase}/hooks`,
+      ],
+      optionalDirectories: [
+        `${installedBase}/docs`,
+        `${installedBase}/examples`,
+      ],
+      requiredRootFiles: requiredEntryFiles,
+      optionalRootFiles: [],
+      requiredKitFiles: [`${installedBase}/VIBE-CODING.md`, installConfigFile],
+      optionalKitFiles: [runtimeManifestFile],
+      docsRequired: false,
+      examplesRequired: false,
+    };
+  }
+
+  return {
+    name: 'repo',
+    base: '',
+    platforms: platformNames,
+    requiredDirectories: ['skills', 'adapters', 'hooks', 'docs', 'examples', 'bin'],
+    optionalDirectories: [],
+    requiredRootFiles: ['README.md', 'package.json', 'CLAUDE.md', 'AGENTS.md'],
+    optionalRootFiles: [],
+    requiredKitFiles: [],
+    optionalKitFiles: [],
+    docsRequired: true,
+    examplesRequired: true,
+  };
+}
+
+function parseFrontmatter(text) {
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
+  if (!match) return null;
+
+  const body = match[1];
+  return {
+    name: /^name:\s*.+$/m.test(body),
+    description: /^description:\s*.+$/m.test(body),
+  };
+}
+
+function checkDirectories(layout) {
+  for (const directory of layout.requiredDirectories) {
+    if (isDirectory(directory)) {
+      ok(`${directory}/ exists`);
+    } else {
+      fail(`${directory}/ missing`, '', `Create or install required directory: ${directory}/`);
+    }
+  }
+
+  for (const directory of layout.optionalDirectories) {
+    if (isDirectory(directory)) {
+      ok(`${directory}/ exists`);
+    } else {
+      ok(`${directory}/ skipped`, 'Optional. Use --with-docs to install docs and examples.');
+    }
+  }
+}
+
+function checkEntryWorkflowMarkers(file, options = {}) {
+  const { required = true, onlyWhenVibecodingEntry = false } = options;
+  if (!exists(file)) return;
+
+  const text = readText(file);
+  if (onlyWhenVibecodingEntry && !text.includes('Vibecoding Kit') && !text.includes('.vibecoding/skills/')) {
+    return;
+  }
+
+  const missing = entryWorkflowMarkers.filter((marker) => !text.includes(marker));
+  if (missing.length === 0) {
+    ok(`${file} references current workflow skills`);
+    return;
+  }
+
+  const detail = `Missing workflow marker(s): ${missing.join(', ')}`;
+  const fix = `Update ${file} from the repo entry files so it references the full source-repo workflow table.`;
+  if (required) {
+    fail(`${file} workflow markers out of date`, detail, fix);
+  } else {
+    warn(`${file} workflow markers out of date`, detail, fix);
+  }
+}
+
+function checkEntryManagedBlock(file, options = {}) {
+  const { required = false, onlyWhenVibecodingEntry = false } = options;
+  if (!exists(file)) return;
+
+  const text = readText(file);
+  if (onlyWhenVibecodingEntry && !text.includes('Vibecoding Kit') && !text.includes('.vibecoding/skills/')) {
+    return;
+  }
+
+  const blocks = [...text.matchAll(managedBlockPattern)];
+  const hasStart = text.includes(managedBlockStartMarker);
+  const hasEnd = text.includes(managedBlockEndMarker);
+
+  if (blocks.length === 1) {
+    ok(`${file} has Vibecoding managed block`);
+    return;
+  }
+
+  if (blocks.length > 1) {
+    fail(
+      `${file} has multiple Vibecoding managed blocks`,
+      `Found ${blocks.length} managed blocks.`,
+      `Keep exactly one ${managedBlockStartMarker} / ${managedBlockEndMarker} block in ${file}.`,
+    );
+    return;
+  }
+
+  if (hasStart || hasEnd) {
+    fail(
+      `${file} has incomplete Vibecoding managed block`,
+      `Start marker present: ${hasStart}; end marker present: ${hasEnd}.`,
+      `Restore both ${managedBlockStartMarker} and ${managedBlockEndMarker}, or rerun vibe-init --merge=replace after fixing the block boundary.`,
+    );
+    return;
+  }
+
+  const fix = `Run vibe-init --merge=preview for this target, then use --merge=append to add a managed block without overwriting user content.`;
+  if (required) {
+    warn(`${file} managed block missing`, 'Entry references Vibecoding but is not managed for safe future updates.', fix);
+  } else {
+    ok(`${file} managed block not present`, 'Optional unless this entry is managed by vibe-init.');
+  }
+}
+
+function checkInstalledEntryCardMarkers(file, options = {}) {
+  const { required = true, onlyWhenVibecodingEntry = false } = options;
+  if (!exists(file)) return;
+
+  const text = readText(file);
+  if (onlyWhenVibecodingEntry && !text.includes('Vibecoding Kit') && !text.includes('.vibecoding/skills/')) {
+    return;
+  }
+
+  const missing = installedEntryCardMarkers.filter((marker) => !text.includes(marker));
+  if (missing.length === 0) {
+    ok(`${file} exposes lightweight user entry card`);
+    return;
+  }
+
+  const detail = `Missing entry card marker(s): ${missing.join(', ')}`;
+  const fix = `Update ${file} from templates/ so installed projects expose a concise sandbox entry and link to .vibecoding/VIBE-CODING.md for full rules.`;
+  if (required) {
+    fail(`${file} lightweight entry card out of date`, detail, fix);
+  } else {
+    warn(`${file} lightweight entry card out of date`, detail, fix);
+  }
+}
+
+function checkInstalledRulesProtocolMarkers(file, options = {}) {
+  const { required = true } = options;
+  if (!exists(file)) return;
+
+  const text = readText(file);
+  const missing = installedEntryProtocolMarkers.filter((marker) => !text.includes(marker));
+  if (missing.length === 0) {
+    ok(`${file} defines full installed interaction protocol`);
+    return;
+  }
+
+  const detail = `Missing protocol marker(s): ${missing.join(', ')}`;
+  const fix = `Update ${file} from templates/VIBE-CODING.md so installed projects keep full workflow routing, quality guardrails, and explicit upgrade conditions.`;
+  if (required) {
+    fail(`${file} full interaction protocol out of date`, detail, fix);
+  } else {
+    warn(`${file} full interaction protocol out of date`, detail, fix);
+  }
+}
+
+function checkInstalledEntryFile(file, required = false) {
+  if (!exists(file)) {
+    const detail = required ? 'Expected for detected installed platform.' : 'Expected when installing the matching platform.';
+    if (required) {
+      fail(`${file} missing`, detail, `Run vibe-init for the matching platform or manually add ${file} from templates/.`);
+    } else {
+      warn(`${file} missing`, detail, `Install the matching platform or add ${file} if this project should support it.`);
+    }
+    return;
+  }
+
+  ok(`${file} exists`);
+
+  const text = readText(file);
+  const missing = entryFileMarkers[file].filter((marker) => !text.includes(marker));
+
+  if (missing.length === 0) {
+    ok(`${file} references Vibecoding installed layout`);
+    checkEntryManagedBlock(file, { required: true });
+    checkInstalledEntryCardMarkers(file, { required: true });
+  } else {
+    warn(
+      `${file} may need manual Vibecoding merge`,
+      `Missing marker(s): ${missing.join(', ')}`,
+      `Run vibe-init --merge-preview for this target, then copy the suggested ${file} snippet into the existing entry file.`,
+    );
+    checkInstalledEntryCardMarkers(file, { required: false, onlyWhenVibecodingEntry: true });
+  }
+}
+
+function checkRootFiles(layout) {
+  for (const file of layout.requiredRootFiles) {
+    if (layout.name === 'installed' && entryFileMarkers[file]) {
+      checkInstalledEntryFile(file, true);
+    } else if (exists(file)) {
+      ok(`${file} exists`);
+      if (layout.name === 'repo' && entryFileMarkers[file]) {
+        checkEntryWorkflowMarkers(file, { required: true });
+      }
+    } else {
+      fail(`${file} missing`, '', `Restore ${file} in repo layout or run vibe-init for an installed target.`);
+    }
+  }
+
+  for (const file of layout.optionalRootFiles) {
+    if (layout.name === 'installed' && entryFileMarkers[file]) {
+      checkInstalledEntryFile(file);
+    } else if (exists(file)) {
+      ok(`${file} exists`);
+    } else {
+      warn(`${file} missing`, 'Expected when installing the matching platform.', `Install the matching platform or add ${file} from templates/.`);
+    }
+  }
+
+  for (const file of layout.requiredKitFiles) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+      if (file.endsWith('VIBE-CODING.md')) {
+        checkInstalledRulesProtocolMarkers(file, { required: true });
+      }
+    } else {
+      fail(`${file} missing`, '', `Run vibe-init again or restore ${file} from templates/VIBE-CODING.md.`);
+    }
+  }
+
+  for (const file of layout.optionalKitFiles || []) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else {
+      ok(`${file} skipped`, 'Optional. Install with --with-runtime to add explicit runtime opt-in boundary metadata.');
+    }
+  }
+}
+
+const standardPackageScripts = {
+  check: 'node tools/vibe-runtime-check/index.mjs',
+  'check:arch': 'node tools/vibe-architecture-check/index.mjs --root . --json',
+  'check:doctor': 'node tools/vibe-doctor/index.mjs',
+  'release:fast': 'node tools/vibe-release-check/index.mjs --suite fast --quiet',
+  'release:runtime': 'node tools/vibe-release-check/index.mjs --suite runtime --quiet',
+  'release:install': 'node tools/vibe-release-check/index.mjs --suite install --quiet',
+  'release:learning': 'node tools/vibe-release-check/index.mjs --suite learning --quiet',
+  'release:tokens': 'node tools/vibe-release-check/index.mjs --suite tokens --quiet',
+  'demo:golden-path': 'node tools/vibe-release-check/index.mjs --suite golden-path --quiet',
+  'demo:full-chain': 'node tools/vibe-release-check/index.mjs --suite full-chain --quiet',
+};
+
+function checkPackageScripts(layout) {
+  if (layout.name !== 'repo' || !exists('package.json')) return;
+
+  let manifest;
+  try {
+    manifest = JSON.parse(readText('package.json'));
+  } catch (error) {
+    fail('package.json is invalid JSON', error.message, 'Restore valid JSON before running package scripts.');
+    return;
+  }
+
+  const scripts = manifest.scripts || {};
+  const missing = Object.entries(standardPackageScripts).filter(([name, command]) => scripts[name] !== command);
+  if (missing.length === 0) {
+    ok('package.json exposes standard verification scripts');
+    return;
+  }
+
+  fail(
+    'package.json verification scripts incomplete',
+    `Missing or changed script(s): ${missing.map(([name]) => name).join(', ')}`,
+    'Keep npm scripts aligned with README.md and docs/release-guide.md so maintainers can run the standard checks consistently.',
+  );
+}
+
+function checkSkillFile(file) {
+  if (!exists(file)) {
+    fail(`${file} missing`, '', `Restore ${file} from skills/ or rerun vibe-init for installed layout.`);
+    return;
+  }
+
+  ok(`${file} exists`);
+
+  const text = readText(file);
+  const frontmatter = parseFrontmatter(text);
+
+  if (!frontmatter) {
+    fail(`${file} frontmatter missing`, '', 'Add YAML frontmatter with name and description.');
+    return;
+  }
+
+  if (frontmatter.name && frontmatter.description) {
+    ok(`${file} frontmatter has name and description`);
+  } else {
+    fail(`${file} frontmatter incomplete`, 'Expected name and description.', 'Add both name and description to the skill frontmatter.');
+  }
+}
+
+function checkSkills(layout) {
+  for (const file of skillFiles.map((entry) => prefixed(layout.base, entry))) {
+    checkSkillFile(file);
+  }
+}
+
+function checkHandoff(layout) {
+  for (const file of workflowSkillFiles.map((entry) => prefixed(layout.base, entry))) {
+    if (!exists(file)) continue;
+
+    const text = readText(file);
+    const missing = handoffMarkers.filter((marker) => !text.includes(marker));
+
+    if (missing.length === 0) {
+      ok(`${file} has workflow handoff markers`);
+    } else {
+      fail(`${file} handoff markers missing`, missing.join(', '), 'Add 下一步调用 and Workflow Handoff sections to keep explicit workflow chaining stable.');
+    }
+  }
+
+  const router = prefixed(layout.base, 'skills/using-vibecoding/SKILL.md');
+  if (exists(router)) {
+    const text = readText(router);
+    const routerMarkers = [
+      '## 分层交互协议',
+      '### L0：轻量路由层',
+      '### L1：标准执行层',
+      '### L2：完整 workflow 层',
+      '## Skill 选择表',
+      '## Workflow Handoff 规则',
+      '## 完整 workflow 参考',
+      '## 输出要求',
+      ...entryWorkflowMarkers,
+    ];
+    const missing = routerMarkers.filter((marker) => !text.includes(marker));
+
+    if (missing.length === 0) {
+      ok(`${router} defines lightweight routing and handoff rules`);
+    } else {
+      fail(`${router} routing markers missing`, missing.join(', '), 'Restore the lightweight routing, upgrade conditions, and handoff sections in using-vibecoding so it remains the workflow entry point.');
+    }
+  }
+}
+
+function validateRuntimeBridgeMetadata(file, manifest) {
+  const bridge = manifest.runtimeBridge;
+  if (!bridge || typeof bridge !== 'object' || Array.isArray(bridge)) {
+    fail(`${file} runtimeBridge metadata missing`, '', 'Add runtimeBridge metadata with manual mode and no automatic execution capabilities.');
+    return;
+  }
+
+  const expected = {
+    supported: true,
+    mode: 'manual',
+    canReadDispatchIntent: true,
+    canAutoExecuteSkill: false,
+    canCallSubagent: false,
+    canTouchGit: false,
+  };
+  const mismatches = Object.entries(expected)
+    .filter(([key, value]) => bridge[key] !== value)
+    .map(([key, value]) => `${key}=${value}`);
+
+  if (mismatches.length === 0) {
+    ok(`${file} declares manual runtime bridge capability`);
+  } else {
+    fail(
+      `${file} runtimeBridge capability unsafe`,
+      `Expected marker(s): ${mismatches.join(', ')}`,
+      'Keep Stage 5 adapter bridge read-only: manual mode, dispatch intent readable, no skill execution, no subagent, no git.',
+    );
+  }
+}
+
+function validateSessionStartBootstrapMetadata(file, manifest) {
+  const bootstrap = manifest.sessionStartBootstrap;
+  if (!bootstrap || typeof bootstrap !== 'object' || Array.isArray(bootstrap)) {
+    fail(`${file} sessionStartBootstrap metadata missing`, '', 'Add sessionStartBootstrap metadata that points to the lightweight session-start bootstrap command.');
+    return;
+  }
+
+  const expected = {
+    supported: true,
+    injectsFullSkill: false,
+    writesRuntimeState: false,
+    autoRunsNextSkill: false,
+  };
+  const mismatches = Object.entries(expected)
+    .filter(([key, value]) => bootstrap[key] !== value)
+    .map(([key, value]) => `${key}=${value}`);
+
+  if (typeof bootstrap.command !== 'string' || !bootstrap.command.includes('.vibecoding/hooks/session-start/session-start.mjs')) {
+    mismatches.push('command=.vibecoding/hooks/session-start/session-start.mjs');
+  }
+
+  if (mismatches.length === 0) {
+    ok(`${file} declares lightweight session-start bootstrap`);
+  } else {
+    fail(
+      `${file} sessionStartBootstrap capability unsafe`,
+      `Expected marker(s): ${mismatches.join(', ')}`,
+      'Keep session-start bootstrap lightweight: no full skill injection, no runtime state write, no automatic next_skill execution.',
+    );
+  }
+}
+
+function validateHookBootstrapReference(file, manifest) {
+  const text = JSON.stringify(manifest);
+  const required = [
+    'session-start/session-start.mjs',
+    'using-vibecoding',
+    'lightweight routing',
+  ];
+  const missing = required.filter((marker) => !text.includes(marker));
+
+  if (missing.length === 0) {
+    ok(`${file} references lightweight session-start bootstrap`);
+  } else {
+    fail(
+      `${file} session-start bootstrap reference missing`,
+      `Missing marker(s): ${missing.join(', ')}`,
+      'Keep adapter hook examples wired to .vibecoding/hooks/session-start/session-start.mjs and the lightweight routing message.',
+    );
+  }
+}
+
+function checkAdapters(layout) {
+  const expectedAdapterFiles = layout.platforms.flatMap((platform) => platformAdapterFiles[platform]);
+
+  if (layout.name === 'installed' && expectedAdapterFiles.length === 0) {
+    fail(
+      `${installedBase}/adapters/ platform missing`,
+      'Expected at least one installed platform adapter.',
+      'Run vibe-init with --platform claude|cursor|codex|all.',
+    );
+    return;
+  }
+
+  for (const file of expectedAdapterFiles.map((entry) => prefixed(layout.base, entry))) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else {
+      fail(`${file} missing`, '', `Install the matching platform adapter or restore ${file}.`);
+    }
+  }
+
+  for (const file of expectedAdapterFiles.filter((entry) => entry.endsWith('.json')).map((entry) => prefixed(layout.base, entry))) {
+    if (!exists(file)) continue;
+
+    try {
+      const manifest = JSON.parse(readText(file));
+      ok(`${file} is valid JSON`);
+      if (file.endsWith('plugin.json')) {
+        validateRuntimeBridgeMetadata(file, manifest);
+        validateSessionStartBootstrapMetadata(file, manifest);
+      } else if (file.endsWith('hooks.example.json')) {
+        validateHookBootstrapReference(file, manifest);
+      }
+    } catch (error) {
+      fail(`${file} invalid JSON`, error.message, 'Fix the JSON syntax or restore the adapter manifest from adapters/.');
+    }
+  }
+}
+
+function checkDocs(layout) {
+  for (const file of docs.map((entry) => prefixed(layout.base, entry))) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else if (layout.docsRequired) {
+      fail(`${file} missing`, '', `Restore ${file} in docs/.`);
+    } else {
+      ok(`${file} skipped`, 'Optional. Use --with-docs to install docs.');
+    }
+  }
+
+  const acceptance = prefixed(layout.base, 'docs/acceptance-checklist.md');
+  if (exists(acceptance)) {
+    const text = readText(acceptance);
+    const missing = acceptancePrompts.filter((prompt) => !text.includes(prompt));
+
+    if (missing.length === 0) {
+      ok(`${acceptance} includes acceptance prompts`);
+    } else {
+      warn(`${acceptance} acceptance prompts incomplete`, missing.join(' | '), 'Restore the expected smoke prompts in docs/acceptance-checklist.md.');
+    }
+
+    const runtimeAuditMarkers = ['execute --from-dispatch --preflight', 'policy snapshot', 'idempotency_key', 'daemon --scan --dry-run', 'retry preview', 'watcher disabled', 'pickup-dry-run', 'handoff_sha256', 'heartbeat_started'];
+    const missingRuntimeAudit = runtimeAuditMarkers.filter((marker) => !text.includes(marker));
+    if (missingRuntimeAudit.length === 0) {
+      ok(`${acceptance} includes enhanced runtime audit markers`);
+    } else if (layout.docsRequired) {
+      warn(`${acceptance} enhanced runtime audit markers incomplete`, `Missing marker(s): ${missingRuntimeAudit.join(', ')}`, 'Update docs/acceptance-checklist.md with Stage 7-10 enhanced runtime audit acceptance markers.');
+    }
+  }
+
+  const runtimeContract = prefixed(layout.base, 'docs/runtime-contract.md');
+  if (exists(runtimeContract)) {
+    const text = readText(runtimeContract);
+    const markers = ['Stage 7.5 stale claim audit', 'Stage 7.6 claim recovery policy preview', 'Stage 7.9 ack reason contract', 'Stage 7.10 claim event digest enforcement', 'Stage 8.4 pickup readiness audit', 'Stage 8.7 pickup package verification', 'Stage 8.8 platform capability matrix', 'Stage 8.9 no-session adapter dry-run', 'Stage 8.10 pickup handoff digest', 'Stage 9.5 idempotency / policy snapshot', 'Stage 10.6 retry policy preview', 'Stage 10.13 daemon lease / heartbeat model'];
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) {
+      ok(`${runtimeContract} includes enhanced Stage 7-10 runtime contract markers`);
+    } else if (layout.docsRequired) {
+      warn(`${runtimeContract} enhanced Stage 7-10 markers incomplete`, `Missing marker(s): ${missing.join(', ')}`, 'Update docs/runtime-contract.md with stale recovery, digest-bound pickup, policy snapshot, and scheduler audit contracts.');
+    }
+  }
+
+  const runtimeRoadmap = prefixed(layout.base, 'docs/runtime-roadmap.md');
+  if (exists(runtimeRoadmap)) {
+    const text = readText(runtimeRoadmap);
+    const markers = ['Stage 7.5 / 7.6', 'Stage 8.4 / 8.6', 'Stage 9.2 / 9.5', 'Stage 10.3-10.6', 'daemon --scan --dry-run'];
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) {
+      ok(`${runtimeRoadmap} includes enhanced Stage 7-10 roadmap markers`);
+    } else if (layout.docsRequired) {
+      warn(`${runtimeRoadmap} enhanced Stage 7-10 markers incomplete`, `Missing marker(s): ${missing.join(', ')}`, 'Update docs/runtime-roadmap.md with enhanced Stage 7-10 read-only audit roadmap markers.');
+    }
+  }
+
+  const workflowChaining = prefixed(layout.base, 'docs/workflow-chaining.md');
+  if (exists(workflowChaining)) {
+    const text = readText(workflowChaining);
+    const missing = entryWorkflowMarkers.filter((marker) => !text.includes(marker));
+
+    if (missing.length === 0) {
+      ok(`${workflowChaining} includes current workflow chain markers`);
+    } else if (layout.docsRequired) {
+      fail(
+        `${workflowChaining} workflow chain markers incomplete`,
+        `Missing marker(s): ${missing.join(', ')}`,
+        'Update docs/workflow-chaining.md so it documents every current workflow skill and next_skill rule.',
+      );
+    } else {
+      warn(
+        `${workflowChaining} workflow chain markers incomplete`,
+        `Missing marker(s): ${missing.join(', ')}`,
+        'Update the installed docs copy from the current kit if docs were installed with --with-docs.',
+      );
+    }
+  }
+}
+
+function checkExamples(layout) {
+  for (const platform of ['claude-project', 'codex-project', 'cursor-project']) {
+    const file = prefixed(layout.base, `examples/${platform}/README.md`);
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else if (layout.examplesRequired) {
+      warn(`${file} missing`, '', `Restore ${file} or document why this example is intentionally omitted.`);
+    } else {
+      ok(`${file} skipped`, 'Optional. Use --with-docs to install examples.');
+    }
+  }
+
+  if (layout.name === 'repo') {
+    for (const file of productArtifactFixtureFiles) {
+      if (exists(file)) ok(`${file} exists`);
+      else fail(`${file} missing`, '', 'Restore product/UI runtime fixtures so release smoke can validate artifact gates.');
+    }
+
+    for (const file of ciEvidenceExampleFiles) {
+      if (exists(file)) ok(`${file} exists`);
+      else fail(`${file} missing`, '', 'Restore CI evidence examples so teams can generate local evidence envelopes outside runtime.');
+    }
+  }
+}
+
+function checkTemplates(layout) {
+  if (layout.name !== 'repo') return;
+
+  for (const file of entryTemplateFiles) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+      checkInstalledEntryCardMarkers(file, { required: true });
+      checkEntryManagedBlock(file, { required: true });
+    } else {
+      fail(`${file} missing`, '', `Restore ${file}; vibe-init uses templates for business project entry files.`);
+    }
+  }
+
+  for (const file of installedRulesTemplateFiles) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+      checkInstalledRulesProtocolMarkers(file, { required: true });
+    } else {
+      fail(`${file} missing`, '', 'Restore templates/VIBE-CODING.md; installed projects use it for full Vibecoding rules.');
+    }
+  }
+
+  for (const file of productArtifactTemplateFiles) {
+    if (!exists(file)) {
+      fail(`${file} missing`, '', 'Restore product/UI artifact templates.');
+      continue;
+    }
+    const text = readText(file);
+    const markers = file.endsWith('delivery-traceability.yaml')
+      ? ['artifact_kind', 'source_skill', 'status', 'boundary:', 'links:', 'Evidence']
+      : ['artifact_kind', 'source_skill', 'status', 'Boundary', 'Evidence'];
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(`${file} defines product/UI delivery artifact contract markers`);
+    else fail(`${file} artifact template markers missing`, `Missing marker(s): ${missing.join(', ')}`, 'Keep product/UI and delivery templates checkable by methodology artifact gates.');
+  }
+
+  for (const file of evidenceTemplateGuideFiles) {
+    if (exists(file)) ok(`${file} exists`);
+    else fail(`${file} missing`, '', 'Restore evidence template onboarding guide so users can fill local evidence envelopes safely.');
+  }
+
+  for (const file of evidenceTemplateFiles) {
+    if (!exists(file)) {
+      fail(`${file} missing`, '', 'Restore local evidence JSON templates.');
+      continue;
+    }
+    const text = readText(file);
+    const markers = file.endsWith('test-evidence.json')
+      ? ['artifact_kind', 'test-evidence', 'runs', 'output_digest', 'task_refs', 'scenario_refs', 'boundary_assertions']
+      : ['artifact_kind', 'diff-coverage-evidence', 'planned_files', 'changed_files', 'task_coverage', 'unexpected_files', 'missing_files', 'boundary_assertions'];
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(`${file} defines local evidence template contract markers`);
+    else fail(`${file} evidence template markers missing`, `Missing marker(s): ${missing.join(', ')}`, 'Keep local evidence templates copy-ready for user or CI generated envelopes.');
+  }
+}
+
+function checkSessionStartBootstrap(layout) {
+  const script = prefixed(layout.base, 'hooks/session-start/session-start.mjs');
+  if (!exists(script)) return;
+
+  const boundaryContract = prefixed(layout.base, 'hooks/session-start/session-start-state-boundary-contract.mjs');
+  const boundaryContractText = exists(boundaryContract) ? readText(boundaryContract) : '';
+  const text = [
+    readText(script),
+    boundaryContractText,
+    boundaryContractText.includes('stateDirectoryName') ? '.vibecoding-state/' : '',
+  ].join('\n');
+  const markers = [
+    'additionalContext',
+    'additional_context',
+    'hookSpecificOutput',
+    'cursor-sdk',
+    '.vibecoding-state/',
+    'Do not inject the full skill content',
+    'Do not auto-run next_skill',
+    'using-vibecoding',
+    'selected_skill=using-vibecoding',
+    'visible_route=',
+    'next_manual_action=',
+    'context_policy=',
+    'hidden_execution=false',
+    'command_execution=false',
+    'skill_execution_claimed=false',
+    'subagent_dispatch_claimed=false',
+    'git_write_claimed=false',
+    'platform_api=false',
+    'model_invocation=false',
+    'business_source_write=false',
+  ];
+  const missing = markers.filter((marker) => !text.includes(marker));
+
+  if (missing.length === 0) {
+    ok(`${script} preserves lightweight bootstrap boundary`);
+  } else {
+    fail(
+      `${script} lightweight bootstrap boundary incomplete`,
+      `Missing marker(s): ${missing.join(', ')}`,
+      'Keep session-start.mjs lightweight and compatible with SDK, Cursor, and Claude hook output shapes.',
+    );
+  }
+}
+
+function checkHookFiles(layout) {
+  for (const file of hookFiles.map((entry) => prefixed(layout.base, entry))) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else {
+      fail(`${file} missing`, '', `Restore ${file}; hook-assisted workflow guidance depends on it.`);
+    }
+  }
+
+  checkSessionStartBootstrap(layout);
+}
+
+function checkToolFiles(layout) {
+  if (layout.name !== 'repo') return;
+
+  for (const file of toolFiles) {
+    if (exists(file)) {
+      ok(`${file} exists`);
+    } else {
+      fail(`${file} missing`, '', `Restore ${file}; it is part of the release tooling surface.`);
+    }
+  }
+}
+
+function checkPluginPackTool(layout) {
+  if (layout.name !== 'repo') return;
+  const tool = 'tools/vibe-plugin-pack/index.mjs';
+  if (!exists(tool)) return;
+
+  const text = [
+    readText(tool),
+    exists('tools/vibe-plugin-pack/plugin-pack-manifest.mjs') ? readText('tools/vibe-plugin-pack/plugin-pack-manifest.mjs') : '',
+  ].join('\n');
+  const markers = [
+    'adapters/claude/plugin.json',
+    'adapters/codex/plugin.json',
+    'adapters/cursor/plugin.json',
+    'adapters/opencode/plugin.json',
+    'adapters/pi/plugin.json',
+    '.claude-plugin',
+    '.codex-plugin',
+    '.cursor-plugin',
+    '.opencode-plugin',
+    '.pi-extension',
+    'sessionStartBootstrap',
+    '.vibecoding/hooks/session-start/session-start.mjs',
+    'projectInstallRequired',
+    'runtime-state',
+    '.vibecoding-state/',
+    '--check',
+    '--dry-run',
+  ];
+  const missing = markers.filter((marker) => !text.includes(marker));
+
+  if (missing.length === 0) {
+    ok(`${tool} preserves UX-6 plugin packaging contract`);
+  } else {
+    fail(
+      `${tool} UX-6 plugin packaging contract incomplete`,
+      `Missing marker(s): ${missing.join(', ')}`,
+      'Keep plugin pack generated from adapters/, with session-start bootstrap support, project install separation, dry-run/check modes, and no runtime state packaging.',
+    );
+  }
+}
+
+function checkRepoGuideLinks(layout) {
+  if (layout.name !== 'repo') return;
+
+  for (const [file, markers] of Object.entries(repoGuideFiles)) {
+    if (!exists(file)) continue;
+
+    const text = readText(file);
+    const missing = markers.filter((marker) => !text.includes(marker));
+
+    if (missing.length === 0) {
+      ok(`${file} includes key guide links`);
+    } else {
+      warn(
+        `${file} key guide links incomplete`,
+        `Missing marker(s): ${missing.join(', ')}`,
+        `Add the missing reference(s) so users can navigate installation, acceptance, release, and submodule docs.`,
+      );
+    }
+  }
+}
+
+function checkRepoLocalStateIgnore(layout) {
+  if (layout.name !== 'repo') return;
+
+  if (!exists('.gitignore')) {
+    warn('.gitignore missing', 'Cannot verify local runtime ledger ignore boundary.', 'Add .vibecoding-state/ to the repo ignore rules.');
+    return;
+  }
+
+  const text = readText('.gitignore');
+  if (text.includes('.vibecoding-state/')) {
+    ok('.gitignore excludes .vibecoding-state/');
+  } else {
+    fail('.gitignore does not exclude .vibecoding-state/', '', 'Add .vibecoding-state/ so explicit runtime ledger files are not committed.');
+  }
+}
+
+const repoRuntimeStage3MarkerChecks = {
+  'docs/runtime-contract.md': ['JSON handoff', 'JSON-first', 'legacy fallback', 'no automatic next_skill execution', 'Handoff quality:', 'artifacts --dry-run', 'artifacts --write', 'task-brief.md', 'review-gate.md', 'evidence.md', 'goal', 'key_decisions', 'tasks --dry-run', 'tasks --write', '.vibecoding-state/tasks/', 'brief.md', 'report.md', 'task id', 'Windows 保留设备名', '尾随', 'unique within a workflow handoff', 'depends_on', 'cyclic task dependency', 'Task readiness', 'review_status', 'needs_fix', 'waived', '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', 'dispatch_event', 'Stage 5 transition table', 'vibe-planning -> vibe-implementation', 'vibe-receiving-code-review -> vibe-implementation', 'vibe-dispatching-parallel-work -> vibe-executing-plans', 'vibe-workspace-isolation -> vibe-executing-plans', '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', 'Dispatch Claim / Ack Gate', 'Stage 7.1 claim input hardening', 'Stage 7.2 ack lifecycle hardening', 'Stage 7.3 claims audit hardening', 'dispatches --claim', 'dispatches --ack', 'dispatches --claims', 'dispatch-claims', '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', 'auto claim', 'session', 'Supervised Executor Gate', 'execute --from-dispatch', 'execution envelope', 'Stage 9.1 execution preflight gates', 'Stage 9.2 execution preflight audit / planned execution envelope', 'Stage 9.3 immutability guarantees', '.vibecoding-state/executions/', 'skill_execution', 'Optional Daemon / Watcher Gate', 'daemon --dry-run', 'daemon --once --confirm', 'Stage 10.1 daemon command gate', 'Stage 10.2 once-run envelope', 'Stage 10.3 scheduler scan dry-run / failure isolation', '.vibecoding-state/daemon-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, daemon, MCP, or business source file'],
+  'tools/vibe-runtime/index.mjs': ['JSON handoff', 'parseJsonHandoff', 'parseLegacyHandoff', 'Vibecoding Runtime Next Step', "status: 'ready'", 'Action: no skill was executed.', 'Action: status is read-only. No workflow state was changed.', 'Handoff quality:', 'Action: handoff was recorded. No next skill was executed.', 'Vibecoding Runtime Handoff Validation', 'handoff was validated. No workflow state was changed.', 'Vibecoding Runtime Artifacts', 'artifacts were previewed. No files were written.', 'artifacts were written. No next skill was executed.', 'task-brief.md', 'review-gate.md', 'evidence.md', 'Goal', 'Key decisions', 'Review focus', 'Risk gate', 'Evidence gate', 'Evidence gaps to fill', 'Decisions requiring evidence', 'Vibecoding Runtime Task Artifacts', 'task artifacts were previewed. No files were written.', 'task artifacts were written. No next skill was executed.', 'Task filter:', 'Tasks selected:', 'Duplicate task id:', 'Task ids must be unique within a workflow handoff.', 'validateTaskDependencies', 'Unknown task dependency', 'Self task dependency is not allowed', 'Cyclic task dependency detected', 'Task readiness:', 'Dependency readiness', 'taskArtifactsDirectoryName', 'brief.md', 'report.md', 'Spec compliance gate', 'validateTaskId', 'windowsReservedTaskBasenames', 'trailing dots or spaces', 'review_status', 'Review state', 'reviewSummaryStatus', 'jsonSchemaVersion', 'writeJsonEnvelope', "writeJsonEnvelope('status'", "writeJsonEnvelope('validate-handoff'", "writeJsonEnvelope('next'", 'tasks --json is only supported with dry-run output', 'reset does not support --json in this stage', 'record-handoff does not support --json in this stage', 'state_present', 'selected_count', 'artifact_paths', 'readinessSourceTasks', 'Vibecoding Runtime Dispatch Intent', 'dispatchIntentEnvelope', 'platform_hints', 'adapterRuntimeBridge', 'dispatch_event', 'next --dispatch-intent requires --dry-run', 'next --confirm --dispatch', 'confirm-dispatch', 'Vibecoding Runtime Confirm Dispatch', 'dispatch envelope', 'allowed transition', 'review gate', 'task readiness gate', 'dispatchesDirectoryName', 'forbiddenDispatchActions', 'Vibecoding Runtime Dispatch Audit', 'dispatches --list', 'dispatches --show', 'dispatches --verify', 'dispatchAuditEnvelope', 'verifyDispatchEvent', 'read-only dispatch audit', 'confirm-dispatch event verification', 'dispatchClaimsDirectoryName', 'dispatchClaimSafety', 'dispatch-claim', 'dispatch-ack', 'dispatch-claims-list', 'dispatch event was claimed for manual pickup', 'dispatch claim acknowledgement was recorded', 'dispatch claim state was listed', 'dispatches --pickup', 'dispatch-pickup', 'Vibecoding Runtime Dispatch Pickup', 'dispatch pickup package was generated for manual use', 'auto_claim', 'session_create', 'execute --from-dispatch', 'Vibecoding Runtime Supervised Executor', 'execution envelope', 'executionSafety', 'skill_execution=false', 'runtime_action', 'supervised-run', 'generate-supervised-handoff-package', 'stage11AllowedExecutionSkills', 'executionsDirectoryName', 'Vibecoding Runtime Execution Audit', 'executions-audit-list', 'executions-audit-show', 'executions-audit-verify', 'validateExecutionEnvelope', 'execute --run requires --confirm', 'supervisedRunBaseEnvelope', 'writeRunningThenCompleteExecution', 'writeExecutionPayload', 'execution.lifecycle is required', 'execution.lifecycle must start with running', 'execution.lifecycle terminal status must match execution.status', 'evidence.stdout_excerpt is required', 'daemon --dry-run', 'daemon --once --confirm', 'Vibecoding Runtime Daemon Gate', 'daemon once-run envelope', 'daemonSafety', 'daemonRunsDirectoryName', 'dispatch_scan_execution'],
+  'tools/vibe-runtime-check/index.mjs': ['Stage 3 JSON handoff', 'legacy fallback', 'Vibecoding Runtime Next Step', 'Handoff quality:', 'Stage 4 artifacts', 'artifacts --dry-run', 'artifacts --write', 'goal', 'key_decisions', 'Risk gate', 'Evidence gaps to fill', 'tasks --dry-run', 'tasks --write', '.vibecoding-state/tasks/', 'Spec compliance gate', 'review_status', 'depends_on', 'cyclic task dependency', 'Task readiness', 'validateTaskId', 'windowsReservedTaskBasenames', 'Vibecoding Runtime Handoff Validation', 'Task filter:', 'Duplicate task id:', 'status --json', 'validate-handoff --json', 'next --dry-run --json', 'tasks --dry-run --json', 'schema_version', 'state_present', 'selected_count', 'artifact_paths', 'next --dry-run --dispatch-intent', 'dispatch intent', 'runtimeBridge', 'platform_hints', 'next --confirm --dispatch', 'confirm-dispatch', 'dispatches --claim', 'dispatches --ack', 'dispatches --claims', 'dispatch-claims', 'Dispatch Claim / Ack Gate', 'Adapter Pickup Package Gate', 'dispatches --pickup', 'pickup package', 'Supervised Executor Gate', 'execute --from-dispatch', 'execution envelope', 'Supervised Real Executor v1', 'execute --confirm --run', 'supervised-run', 'runtime_action', 'executions --list', 'executions --show', 'executions --verify', 'execution lifecycle', 'allowlist', 'Optional Daemon / Watcher Gate', 'daemon --dry-run', 'daemon --once --confirm', 'daemon-runs'],
+  'tools/vibe-release-check/index.mjs': ['runtime-json-handoff.md', 'runtime-legacy-handoff.md', 'runtime-blocked-handoff.md', 'runtime-stopped-handoff.md', 'runtime-quality-handoff.md', 'runtime-clean-dispatch-intent-handoff.json', 'artifacts', 'task-brief.md', 'review-gate.md', 'evidence.md', 'Goal', 'Key decisions', 'Review focus', 'Risk gate', 'Evidence gaps to fill', 'Decisions requiring evidence', 'taskArtifactFiles', 'tasks', 'brief.md', 'report.md', 'Spec compliance gate', 'invalidTaskIdHandoffFile', 'reservedTaskIdHandoffFile', 'trailingDotTaskIdHandoffFile', 'duplicateTaskIdHandoffFile', 'unknownDependencyHandoffFile', 'selfDependencyHandoffFile', 'cyclicDependencyHandoffFile', 'Task readiness:', 'invalidFencedJsonTaskIdHandoffFile', 'invalidReviewWaiverHandoffFile', 'validate-handoff', 'taskFilterTarget', 'review_status', 'assertJsonMarkers', 'schema_version', 'status --json', 'validate-handoff --json', 'next --dry-run --json', 'next --dry-run --dispatch-intent --json', 'next --dispatch-intent', 'next --confirm --dispatch-intent', 'dispatch_event', 'adapter_bridge', 'platform_hints', 'adapter_ready', 'gates.dispatchable', 'tasks --dry-run --task --json', 'tasks --dry-run --task dependency --json', 'record-handoff does not support --json in this stage', 'artifacts --dry-run', '--json', 'tasks --write', 'reset', 'selected_count', 'next --confirm --dispatch', 'runtime-invalid-transition-dispatch-handoff.json', 'confirm-dispatch', 'dispatches', 'safety.confirmed', 'dispatches --list --json', 'dispatches --show --json', 'dispatches --verify --json', 'dispatches --claim', 'dispatches --ack', 'dispatches --claims', 'dispatch-claims', 'Dispatch event already has an active claim', 'Dispatch claim actor mismatch', 'Invalid dispatch ack status: consumed', 'manual-pickup-recorded', 'dispatches --pickup', 'dispatch-pickup', 'pickup package', 'dispatch claim status is skipped; pickup package is read-only and does not imply execution readiness', 'pickup.dispatch_event_path', 'pickup.claim_state_path', 'verification.ok', 'execute --from-dispatch', 'execute --dry-run', 'execute --confirm', 'execute --run requires --confirm', 'execute --confirm --run', 'supervised-run', 'runtime_action', 'execution.lifecycle.0.status', 'execution.allowlisted', 'executions --list --json', 'executions --show --json', 'executions --verify --json', 'Execution file must not include path separators', 'execution envelope', 'skill_execution', 'missing-lifecycle.execution.json', 'missing-running.execution.json', 'mismatched-terminal.execution.json', 'invalid-timestamp.execution.json', 'bad-runtime-action.execution.json', 'bad-skill-execution.execution.json', 'bad-platform-api.execution.json', 'bad-git.execution.json', 'bad-worktree.execution.json', 'Execution target skill is not allowlisted for supervised run', 'daemon --dry-run', 'daemon --once --confirm', 'daemon-runs', 'daemon once-run envelope', 'dispatch_scan_execution', 'invalid-json.json', 'invalid-mode.json', 'missing-forbidden-action.json'],
+};
+
+function readRuntimeCheckStage3MarkerText() {
+  return [
+    readText('tools/vibe-runtime-check/index.mjs'),
+    exists('tools/vibe-runtime-check/runtime-cli-surface-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-cli-surface-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-control-plane-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-control-plane-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-doc-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-doc-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-doc-marker-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-doc-marker-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-doc-contract-marker-specs.mjs') ? readText('tools/vibe-runtime-check/runtime-doc-contract-marker-specs.mjs') : '',
+    runtimeDocContractMarkerSpecs.flatMap((spec) => spec.markers).join('\n'),
+    exists('tools/vibe-runtime-check/runtime-tool-readme-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-tool-readme-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-tool-readme-marker-specs.mjs') ? readText('tools/vibe-runtime-check/runtime-tool-readme-marker-specs.mjs') : '',
+    runtimeToolReadmeMarkerSpecs.flatMap((spec) => spec.markers).join('\n'),
+    runtimeToolCliSurfaceMarkerSpecs.flatMap((spec) => spec.markers).join('\n'),
+    exists('tools/vibe-runtime-check/workflow-ux-contracts.mjs') ? readText('tools/vibe-runtime-check/workflow-ux-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-release-closeout-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-release-closeout-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-close-loop-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-close-loop-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-governance-learning-token-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-governance-learning-token-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-experience-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-experience-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-experience-cli-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-experience-cli-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-capability-registry-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-capability-registry-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-automation-readiness-contracts.mjs') ? readText('tools/vibe-runtime-check/runtime-automation-readiness-contracts.mjs') : '',
+    exists('tools/vibe-runtime-check/runtime-contract-registry.mjs') ? readText('tools/vibe-runtime-check/runtime-contract-registry.mjs') : '',
+    exists('tools/vibe-runtime-check/product-artifact-contracts.mjs') ? readText('tools/vibe-runtime-check/product-artifact-contracts.mjs') : '',
+  ].join('\n');
+}
+
+function readReleaseCheckStage3MarkerText() {
+  return [
+    readText('tools/vibe-release-check/index.mjs'),
+    exists('tools/vibe-release-check/release-check-runtime-ledger-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-ledger-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-ledger-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-ledger-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-handoff-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-handoff-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-handoff-fixture-specs.mjs') ? readText('tools/vibe-release-check/release-check-runtime-handoff-fixture-specs.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-handoff-smoke-specs.mjs') ? readText('tools/vibe-release-check/release-check-runtime-handoff-smoke-specs.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-task-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-task-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-task-fixture-specs.mjs') ? readText('tools/vibe-release-check/release-check-runtime-task-fixture-specs.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-dispatch-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-dispatch-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-scheduler-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-scheduler-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-handoff-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-handoff-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-task-artifact-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-task-artifact-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-dispatch-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-dispatch-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-flow-smoke.mjs') ? readText('tools/vibe-release-check/release-check-runtime-flow-smoke.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-execution-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-execution-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-execution-base-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-execution-base-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-execution-approval-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-execution-approval-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-execution-scheduler-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-execution-scheduler-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-execution-recovery-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-execution-recovery-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-daemon-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-daemon-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-daemon-bounded-run-smoke-helpers.mjs') ? readText('tools/vibe-release-check/release-check-runtime-daemon-bounded-run-smoke-helpers.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-fixtures.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-fixtures.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-methodology-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-methodology-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-subagents-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-subagents-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-platform-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-platform-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-source-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-source-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-runtime-automation-governance-suite.mjs') ? readText('tools/vibe-release-check/release-check-runtime-automation-governance-suite.mjs') : '',
+    exists('tools/vibe-release-check/release-check-command-manifest.mjs') ? readText('tools/vibe-release-check/release-check-command-manifest.mjs') : '',
+    exists('tools/vibe-release-check/release-check-dispatch.mjs') ? readText('tools/vibe-release-check/release-check-dispatch.mjs') : '',
+  ].join('\n');
+}
+
+function readRepoRuntimeStage3MarkerText(file) {
+  if (file === 'tools/vibe-runtime/index.mjs') return readExistingTextBundle(runtimeCliSurfaceFiles);
+  if (file === 'tools/vibe-runtime-check/index.mjs') return readRuntimeCheckStage3MarkerText();
+  if (file === 'tools/vibe-release-check/index.mjs') return readReleaseCheckStage3MarkerText();
+  return readText(file);
+}
+
+function checkRepoRuntimeStage3Markers(layout) {
+  if (layout.name !== 'repo') return;
+
+  for (const [file, markers] of Object.entries(repoRuntimeStage3MarkerChecks)) {
+    if (!exists(file)) continue;
+
+    const text = readRepoRuntimeStage3MarkerText(file);
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) {
+      ok(`${file} includes Stage 3/4 runtime markers`);
+    } else {
+      fail(
+        `${file} Stage 3/4 runtime markers incomplete`,
+        `Missing marker(s): ${missing.join(', ')}`,
+        'Keep JSON handoff, JSON-first parsing, legacy fallback, artifacts generation, and release smoke markers synchronized for repo layout.',
+      );
+    }
+  }
+}
+
+function checkInstalledPlatformEntries(layout) {
+  if (layout.name !== 'installed') return;
+
+  const hasClaudeEntry = exists('CLAUDE.md');
+  const hasAgentsEntry = exists('AGENTS.md');
+  const hasClaudeAdapter = layout.platforms.includes('claude');
+  const hasCodexAdapter = layout.platforms.includes('codex');
+  const hasCursorAdapter = layout.platforms.includes('cursor');
+
+  const missingEntries = layout.platforms.flatMap((platform) => platformEntryFiles[platform]).filter((file, index, files) => {
+    return files.indexOf(file) === index && !exists(file);
+  });
+
+  const extraEntryPlatforms = [];
+  if (hasClaudeEntry && !hasClaudeAdapter) extraEntryPlatforms.push('claude');
+  if (hasAgentsEntry && !hasCodexAdapter && !hasCursorAdapter) extraEntryPlatforms.push('codex/cursor');
+
+  if (missingEntries.length === 0) {
+    ok('installed platform entry files match detected adapters');
+  } else {
+    warn(
+      'installed platform entry files incomplete',
+      `Missing entry file(s): ${missingEntries.join(', ')}`,
+      'Run vibe-init for the matching platform or merge the corresponding template entry file.',
+    );
+  }
+
+  if (extraEntryPlatforms.length > 0) {
+    warn(
+      'installed entry files reference platforms without adapters',
+      `Entry-implied platform(s): ${extraEntryPlatforms.join(', ')}`,
+      'Install the missing adapter or remove the stale platform entry from the project entry file.',
+    );
+  }
+}
+
+function checkInstalledConfig(layout) {
+  if (layout.name !== 'installed') return;
+  if (!exists(installConfigFile)) return;
+
+  let config;
+  try {
+    config = JSON.parse(readText(installConfigFile));
+    ok(`${installConfigFile} is valid JSON`);
+  } catch (error) {
+    fail(`${installConfigFile} JSON invalid`, error.message, 'Run vibe repair --confirm to regenerate the install lifecycle config.');
+    return;
+  }
+
+  const failures = [];
+  if (config.version !== 1) failures.push('version must be 1');
+  if (config.profile !== 'standard') failures.push('profile must be standard');
+  if (!['lightweight', 'vibe-guided'].includes(config.interaction)) failures.push('interaction must be lightweight or vibe-guided');
+  if (!Array.isArray(config.platforms) || config.platforms.length === 0) failures.push('platforms must be a non-empty array');
+  else {
+    const invalidPlatforms = config.platforms.filter((platform) => !platformNames.includes(platform));
+    if (invalidPlatforms.length > 0) failures.push(`unsupported platform(s): ${invalidPlatforms.join(', ')}`);
+  }
+  if (typeof config.runtime?.enabled !== 'boolean') failures.push('runtime.enabled must be boolean');
+  if (!config.managed_entries || typeof config.managed_entries !== 'object' || Array.isArray(config.managed_entries)) failures.push('managed_entries must be an object');
+
+  const lifecycle = config.lifecycle || {};
+  for (const key of ['update', 'repair', 'uninstall']) {
+    if (typeof lifecycle[key] !== 'string') failures.push(`lifecycle.${key} must be documented`);
+  }
+
+  if (failures.length > 0) {
+    fail(
+      `${installConfigFile} lifecycle contract invalid`,
+      `Violation(s): ${failures.join(', ')}`,
+      'Run vibe repair --confirm to regenerate .vibecoding/config.json from the installed project state.',
+    );
+    return;
+  }
+
+  ok(`${installConfigFile} preserves install lifecycle contract`);
+
+  const configuredEntries = config.managed_entries || {};
+  for (const [file, managed] of Object.entries(configuredEntries)) {
+    if (!entryFileMarkers[file]) continue;
+    if (!exists(file)) {
+      if (managed === true) warn(`${installConfigFile} references missing managed entry`, file, `Run vibe repair --confirm to restore ${file}.`);
+      continue;
+    }
+
+    const blockCount = [...readText(file).matchAll(managedBlockPattern)].length;
+    if (managed === true && blockCount !== 1) {
+      warn(`${installConfigFile} managed entry state is stale`, `${file} expected one managed block, found ${blockCount}.`, 'Run vibe repair --dry-run to inspect the repair plan.');
+    } else if (managed === false && blockCount === 1) {
+      warn(`${installConfigFile} managed entry state is stale`, `${file} has a managed block but config marks it false.`, 'Run vibe repair --confirm to refresh .vibecoding/config.json.');
+    }
+  }
+}
+
+function checkInstalledRuntimeOptIn(layout) {
+  if (layout.name !== 'installed') return;
+  if (!exists(runtimeManifestFile)) return;
+
+  ok(`${runtimeManifestFile} exists`);
+  let manifest;
+  try {
+    manifest = JSON.parse(readText(runtimeManifestFile));
+  } catch {
+    fail(`${runtimeManifestFile} JSON invalid`, '', 'Reinstall runtime opt-in manifest with vibe-init --with-runtime.');
+    return;
+  }
+
+  const failures = [];
+  if (manifest.version !== 1) failures.push('version must be 1');
+  if (manifest.stage !== 'Stage 55') failures.push('stage must be Stage 55');
+  if (manifest.manifest_kind !== 'installed-runtime-opt-in') failures.push('manifest_kind must be installed-runtime-opt-in');
+  if (manifest.opt_in !== true) failures.push('opt_in must be true');
+  if (manifest.default_enabled !== false) failures.push('default_enabled must be false');
+  if (manifest.kit_directory !== installedBase) failures.push(`kit_directory must be ${installedBase}`);
+
+  const installedProjectEntrypoints = manifest.installed_project_entrypoints || {};
+  if (installedProjectEntrypoints.runtime_cli_present !== false) failures.push('installed_project_entrypoints.runtime_cli_present must be false');
+  if (installedProjectEntrypoints.doctor_cli_present !== false) failures.push('installed_project_entrypoints.doctor_cli_present must be false');
+
+  const runtimeInvocation = manifest.runtime_invocation || {};
+  if (runtimeInvocation.mode !== 'external-kit-repo-or-package') failures.push('runtime_invocation.mode must be external-kit-repo-or-package');
+  if (runtimeInvocation.project_argument !== '<project-root>') failures.push('runtime_invocation.project_argument must be <project-root>');
+  if (runtimeInvocation.local_project_tool_entrypoints !== false) failures.push('runtime_invocation.local_project_tool_entrypoints must be false');
+
+  const recommendedCommands = Array.isArray(manifest.recommended_commands) ? manifest.recommended_commands : [];
+  if (recommendedCommands.length < 2) failures.push('recommended_commands must contain external kit repo/package examples');
+  if (recommendedCommands.some((command) => /^node tools\//.test(String(command)))) failures.push('recommended_commands must not claim local project tools/ entrypoints');
+
+  const legacyEntrypoints = ['runtime_entrypoint', 'doctor_entrypoint'].filter((key) => key in manifest);
+  if (legacyEntrypoints.length > 0) failures.push(`legacy direct entrypoint fields must be removed: ${legacyEntrypoints.join(', ')}`);
+
+  const boundaries = manifest.boundaries || {};
+  for (const key of ['creates_state_directory_by_default', 'auto_runtime_enabled', 'hook_registration', 'daemon', 'watcher', 'mcp', 'platform_api', 'session_create', 'runtime_action', 'business_source_write', 'source_merge', 'git', 'worktree', 'external_network']) {
+    if (boundaries[key] !== false) failures.push(`boundaries.${key} must be false`);
+  }
+
+  if (failures.length === 0) {
+    ok(`${runtimeManifestFile} preserves Stage 55 installed runtime opt-in boundary`);
+  } else {
+    fail(
+      `${runtimeManifestFile} Stage 55 boundary invalid`,
+      `Violation(s): ${failures.join(', ')}`,
+      'Regenerate the installed runtime opt-in manifest so installed projects advertise opt-in metadata only, rely on an external Vibecoding kit runtime entrypoint, and keep hooks, daemon, MCP, state creation, and automatic runtime execution disabled by default.',
+    );
+  }
+}
+
+function checkWorkflowEntryHealth(layout) {
+  const skillFile = prefixed(layout.base, 'skills/using-vibecoding/SKILL.md');
+  const entryFiles = [...new Set([...layout.requiredRootFiles, ...layout.optionalRootFiles].filter((file) => entryFileMarkers[file]))];
+  const requiredMarkers = [
+    'using-vibecoding',
+    'workflow --start',
+    'workflow --receipt',
+    'entry --contract',
+    '不要声称已使用某个 skill',
+    '验证策略',
+    'subagent 只有在用户明确允许',
+  ];
+
+  if (exists(skillFile)) {
+    const text = readText(skillFile);
+    const missing = requiredMarkers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(`${skillFile} preserves Stage 95 workflow entry protocol`);
+    else fail(`${skillFile} Stage 95 workflow entry protocol incomplete`, `Missing marker(s): ${missing.join(', ')}`, 'Sync using-vibecoding with entry contract, visible receipt, workflow start, and permission boundaries.');
+  } else {
+    fail(`${skillFile} missing`, '', 'Restore using-vibecoding so workflow entry health can be checked.');
+  }
+
+  for (const file of entryFiles) {
+    if (!exists(file)) {
+      warn(`${file} unavailable for workflow entry health`, 'Entry file is absent for this layout.', 'Install or merge the matching Vibecoding entry template.');
+      continue;
+    }
+    const text = readText(file);
+    const markers = ['using-vibecoding', 'workflow --start', '验证策略', 'subagent 只有在用户明确允许'];
+    const missing = markers.filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(`${file} includes Stage 95 start-here guidance`);
+    else warn(`${file} Stage 95 start-here guidance incomplete`, `Missing marker(s): ${missing.join(', ')}`, `Update ${file} from templates/ so installed agents see the low-friction start-here protocol.`);
+  }
+
+  const runtimeReadme = layout.name === 'repo' ? 'tools/vibe-runtime/README.md' : '';
+  if (runtimeReadme && exists(runtimeReadme)) {
+    const text = readText(runtimeReadme);
+    const missing = ['Stage 91-95', 'workflow --start', 'workflow --receipt', 'entry --contract', 'onboarding --brief'].filter((marker) => !text.includes(marker));
+    if (missing.length === 0) ok(`${runtimeReadme} documents Stage 91-95 onboarding flow`);
+    else warn(`${runtimeReadme} Stage 91-95 onboarding docs incomplete`, `Missing marker(s): ${missing.join(', ')}`, 'Document the entry contract, visible receipt, start command, sequence, and onboarding brief.');
+  }
+}
+
+function checkArchitectureHealth(layout) {
+  if (layout.name !== 'repo') return;
+  const tool = 'tools/vibe-architecture-check/index.mjs';
+  if (!exists(tool)) {
+    warn(`${tool} missing`, 'Architecture-first coding warnings are unavailable.', 'Restore the project-level architecture check tool.');
+    return;
+  }
+
+  const result = spawnSync(process.execPath, [tool, '--root', root, '--json'], { cwd: root, encoding: 'utf8', timeout: 30000, maxBuffer: 5 * 1024 * 1024 });
+  if (result.status !== 0) {
+    warn('architecture check could not run', (result.stderr || result.stdout || '').trim(), 'Keep tools/vibe-architecture-check/index.mjs runnable and warning-only.');
+    return;
+  }
+
+  try {
+    const report = JSON.parse(result.stdout);
+    const warningCount = Number(report.warning_count || 0);
+    if (warningCount === 0) {
+      ok('architecture check reports no drift warnings');
+    } else {
+      const examples = (report.warnings || []).slice(0, 3).map((item) => `${item.file}:${item.rule}`).join(', ');
+      warn('architecture check reports warning-only drift signals', `${warningCount} warning(s). Examples: ${examples}`, 'Use these signals as module-boundary review prompts; warnings do not fail doctor.');
+    }
+  } catch (error) {
+    warn('architecture check JSON output invalid', error.message, 'Keep architecture check --json machine-readable.');
+  }
+}
+
+function checkSubmodules(layout) {
+  if (layout.name !== 'repo') return;
+
+  if (!exists('.gitmodules')) {
+    warn('.gitmodules missing', 'fork/ references cannot be tracked as submodules.', 'Restore .gitmodules or document why fork/ references are not used.');
+    return;
+  }
+
+  ok('.gitmodules exists');
+
+  const gitmodules = readText('.gitmodules');
+  for (const submodulePath of submodulePaths) {
+    if (!gitmodules.includes(`path = ${submodulePath}`)) {
+      warn(
+        `${submodulePath} not listed in .gitmodules`,
+        'Expected reference project submodule.',
+        `Register it with git submodule add --force <url> ${submodulePath}, or update docs/submodule-guide.md if intentionally removed.`,
+      );
+      continue;
+    }
+
+    if (!exists(submodulePath)) {
+      warn(
+        `${submodulePath} missing`,
+        'Submodule path is registered but not present in the working tree.',
+        'Run git submodule update --init --recursive.',
+      );
+    } else {
+      ok(`${submodulePath} submodule path exists`);
+    }
+  }
+}
+
+function doctorResultGroup(status) {
+  if (status === 'fail') return 'Blocking';
+  if (status === 'warn') return 'Warnings';
+  return 'Info';
+}
+
+function doctorNextManualAction(counts) {
+  if (counts.fail > 0) return 'Fix blocking diagnostics first, then re-run doctor.';
+  if (counts.warn > 0) return 'Review warnings and decide whether they block your local adoption path.';
+  return 'No doctor action required.';
+}
+
+function printResults(layout) {
+  const counts = results.reduce(
+    (acc, item) => {
+      acc[item.status] += 1;
+      return acc;
+    },
+    { ok: 0, warn: 0, fail: 0 },
+  );
+
+  console.log('Vibecoding Kit Doctor');
+  console.log(`Root: ${root}`);
+  console.log(`Layout: ${layout.name}`);
+  if (layout.platforms.length > 0) {
+    console.log(`Platforms: ${layout.platforms.join(', ')}`);
+  }
+  console.log(`Health summary: ${counts.fail} blocking, ${counts.warn} warning, ${counts.ok} info/pass`);
+  console.log(`Next manual action: ${doctorNextManualAction(counts)}`);
+  console.log('');
+
+  for (const status of ['fail', 'warn', 'ok']) {
+    const group = results.filter((item) => item.status === status);
+    if (group.length === 0) continue;
+    console.log(`${doctorResultGroup(status)}:`);
+    for (const item of group) {
+      const prefix = item.status === 'ok' ? '[ok]' : item.status === 'warn' ? '[warn]' : '[fail]';
+      console.log(`${prefix} ${item.label}`);
+      if (item.detail) {
+        console.log(`       ${item.detail}`);
+      }
+      if (item.fix) {
+        console.log(`       fix: ${item.fix}`);
+      }
+    }
+    console.log('');
+  }
+
+  console.log(`Result: ${counts.fail > 0 ? 'failed' : counts.warn > 0 ? 'passed with warnings' : 'passed'}`);
+  console.log(`Checks: ${counts.ok} ok, ${counts.warn} warn, ${counts.fail} fail`);
+
+  if (counts.fail > 0) {
+    process.exitCode = 1;
+  }
+}
+
+const layout = detectLayout();
+if (options.workflowEntry) {
+  checkWorkflowEntryHealth(layout);
+  printResults(layout);
+} else {
+  checkDirectories(layout);
+  checkRootFiles(layout);
+  checkPackageScripts(layout);
+  checkSkills(layout);
+  checkHandoff(layout);
+  checkAdapters(layout);
+  checkDocs(layout);
+  checkExamples(layout);
+  checkTemplates(layout);
+  checkHookFiles(layout);
+  checkToolFiles(layout);
+  checkArchitectureHealth(layout);
+  checkPluginPackTool(layout);
+  checkRepoGuideLinks(layout);
+  checkRepoLocalStateIgnore(layout);
+  checkRepoRuntimeStage3Markers(layout);
+  checkInstalledPlatformEntries(layout);
+  checkInstalledConfig(layout);
+  checkInstalledRuntimeOptIn(layout);
+  checkSubmodules(layout);
+  printResults(layout);
+}