@skillcap/gdh 0.15.1 → 0.17.0

package/node_modules/@gdh/adapters/dist/index.js

@@ -4,17 +4,17 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
-import { readProjectConfig, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, readWorktreeState, resolveAuthoringStatus, } from "@gdh/authoring";
-import { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateHook, } from "./claude-update-hook-render.js";
-import { renderClaudeCheckUpdateWorker } from "./claude-update-worker-render.js";
-import { CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, } from "./claude-statusline-render.js";
-import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
-import { GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, resolveCurrentGdhInstall, resolveConfiguredGodotEditorBin, resolveGdhProductMetadata, } from "@gdh/core";
+import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, } from "@gdh/authoring";
+import { assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, resolveConfiguredGodotEditorBin, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { createDefaultGuidanceUnits, getGuidanceStatus, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
 import { inspectGuidanceAudit } from "@gdh/observability";
-import { inspectRuntimeBridgeSurface } from "@gdh/runtime";
+import { inspectRuntimeBridgeSurface, inspectRuntimeKnowledgeSurface } from "@gdh/runtime";
 import { readInventoryCacheOrScan } from "@gdh/scan";
 import { evaluateDonePolicy, recommendValidationForChange } from "@gdh/verify";
+import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
+import { CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, } from "./claude-statusline-render.js";
+import { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateHook, } from "./claude-update-hook-render.js";
+import { renderClaudeCheckUpdateWorker } from "./claude-update-worker-render.js";
 export const adaptersPackage = definePackageBoundary({
     name: "@gdh/adapters",
     layer: "integration",
@@ -29,7 +29,11 @@ export const adaptersPackage = definePackageBoundary({
         "@gdh/verify",
     ],
 });
-export const SUPPORTED_AGENTS = ["codex", "claude", "cursor"];
+export const SUPPORTED_AGENTS = [
+    "codex",
+    "claude",
+    "cursor",
+];
 export const CLAUDE_SHIM_RELATIVE_PATH = "CLAUDE.md";
 export const CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/onboard.md";
 export const PROJECT_MCP_RELATIVE_PATH = ".mcp.json";
@@ -199,9 +203,7 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
                 autoApplicable: false,
             },
         });
-        return summarizeProjectLifecycleCompatibility(resolvedTargetPath, [
-            blockedSurface,
-        ]);
+        return summarizeProjectLifecycleCompatibility(resolvedTargetPath, [blockedSurface]);
     }
     const guidanceStatus = await getGuidanceStatus(resolvedTargetPath);
     const bridgeStatus = await inspectRuntimeBridgeSurface({
@@ -227,6 +229,10 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
 export async function buildGdhStatusResult(targetPath) {
     const context = await buildAuthoringContext(targetPath);
     const projectLifecycle = await inspectProjectLifecycleCompatibility(targetPath);
+    const runtimeKnowledge = await inspectRuntimeKnowledgeSurface({
+        targetPath: context.status.targetPath,
+        runtimeKnowledgePath: context.projectConfig?.runtimeKnowledge.path ?? null,
+    });
     const recoveryHints = resolveRecoveryHints(projectLifecycle.reasons);
     const capabilities = await addOperationalCapabilityStatus(context.status.capabilities, context.status.targetPath);
     const detectedProjects = summarizeDetectedProjects(context.inventory.projects, context.status.primaryProjectPath);
@@ -236,6 +242,7 @@ export async function buildGdhStatusResult(targetPath) {
         detectedProjects,
         product: resolveGdhProductMetadata(),
         projectLifecycle,
+        runtimeKnowledge,
         recoveryHints,
     };
 }
@@ -716,7 +723,7 @@ export function renderClaudeMigrateCommand(pinnedVersion) {
         "",
         `1. Run \`npx -y @skillcap/gdh@${pinnedVersion} migrate\` to preview pending migrations (this is a dry-run; the JSON \`mode\` field will be \`"preview"\`).`,
         "2. Inspect `compatibility.blockingReasons` vs `compatibility.coupledReasons` — if `blockingReasons` is non-empty, STOP: `migrate --apply` cannot fix them (recommend `/gdh-update` or manual intervention per each reason's recovery hint). If only `coupledReasons` is non-empty, proceed.",
-        "3. Explain what each migration step will change and why (use \"would\" verb forms — \"would delete\", \"would create\", \"would refresh\").",
+        '3. Explain what each migration step will change and why (use "would" verb forms — "would delete", "would create", "would refresh").',
         `4. Offer to run \`npx -y @skillcap/gdh@${pinnedVersion} migrate --apply\` if the user approves — after apply, the JSON \`mode\` field becomes \`"applied"\` and verbs switch to past tense ("deleted", "created", "refreshed").`,
         "5. After apply, read `terminal.state` in the stdout JSON.",
         "6. If `terminal.state` is `healthy`, confirm no further migration action is required and stop.",
@@ -761,7 +768,7 @@ export function renderCodexMigrateSkill(pinnedVersion) {
         "",
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} migrate\` to preview pending migrations (this is a dry-run; the JSON \`mode\` field will be \`"preview"\`)`,
         "- inspect `compatibility.blockingReasons` vs `compatibility.coupledReasons` — if `blockingReasons` is non-empty, STOP: `migrate --apply` cannot fix them (recommend `/gdh-update` or manual intervention per each reason's recovery hint); if only `coupledReasons` is non-empty, proceed",
-        "- explain what each migration step will change and why (use \"would\" verb forms — \"would delete\", \"would create\", \"would refresh\")",
+        '- explain what each migration step will change and why (use "would" verb forms — "would delete", "would create", "would refresh")',
         `- offer to run \`npx -y @skillcap/gdh@${pinnedVersion} migrate --apply\` if the user approves — after apply, the JSON \`mode\` field becomes \`"applied"\` and verbs switch to past tense ("deleted", "created", "refreshed")`,
         "- after apply, read `terminal.state` in the stdout JSON",
         "- if `terminal.state` is `healthy`, confirm no further migration action is required and stop",
@@ -804,7 +811,7 @@ export function renderCursorMigrateSkill(pinnedVersion) {
         "",
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} migrate\` to preview pending migrations (this is a dry-run; the JSON \`mode\` field will be \`"preview"\`)`,
         "- inspect `compatibility.blockingReasons` vs `compatibility.coupledReasons` — if `blockingReasons` is non-empty, STOP: `migrate --apply` cannot fix them (recommend `/gdh-update` or manual intervention per each reason's recovery hint); if only `coupledReasons` is non-empty, proceed",
-        "- explain what each migration step will change and why (use \"would\" verb forms — \"would delete\", \"would create\", \"would refresh\")",
+        '- explain what each migration step will change and why (use "would" verb forms — "would delete", "would create", "would refresh")',
         `- offer to run \`npx -y @skillcap/gdh@${pinnedVersion} migrate --apply\` if the user approves — after apply, the JSON \`mode\` field becomes \`"applied"\` and verbs switch to past tense ("deleted", "created", "refreshed")`,
         "- after apply, read `terminal.state` in the stdout JSON",
         "- if `terminal.state` is `healthy`, confirm no further migration action is required and stop",
@@ -999,15 +1006,20 @@ export function renderClaudeCheckCommand(pinnedVersion) {
         "<process>",
         "Follow this order:",
         "",
-        `1. Run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\`.`,
-        "2. Explain each diagnostic finding with severity and provenance.",
-        "3. Surface any import-state caveats or editor-side warnings.",
-        "4. If issues found, suggest concrete remediation steps.",
+        `1. Run \`npx -y @skillcap/gdh@${pinnedVersion} lsp status\` only for lifecycle visibility; do not treat lifecycle readiness as diagnostic evidence.`,
+        `2. Run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\` to collect validator evidence.`,
+        "3. Explain each diagnostic finding with severity, provenance, and validator family (`gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`).",
+        "4. Surface any import-state caveats or editor-side warnings.",
+        `5. If stale managed LSP state is suspected, use bounded GDH cleanup such as \`npx -y @skillcap/gdh@${pinnedVersion} lsp prune\` or \`npx -y @skillcap/gdh@${pinnedVersion} lsp stop\`; do not hand-manage Godot LSP processes.`,
+        "6. If issues found, suggest concrete remediation steps.",
         "</process>",
         "",
         "<rules>",
         "- Do not fix issues automatically unless asked.",
+        "- Do not hand-manage Godot LSP processes; use GDH lifecycle commands.",
+        "- The gdh lsp lifecycle commands are status, prune, and stop.",
         "- Explain diagnostics in human-readable terms.",
+        "- A ready `authoring.lsp` lifecycle is not proof that the authoring check collected diagnostics.",
         "- Report both hard failures and informational caveats.",
         "</rules>",
         "",
@@ -1039,15 +1051,20 @@ export function renderCodexCheckSkill(pinnedVersion) {
         "<process>",
         "Follow this order:",
         "",
-        `- run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\``,
-        "- explain each diagnostic finding with severity and provenance",
+        `- run \`npx -y @skillcap/gdh@${pinnedVersion} lsp status\` only for lifecycle visibility; do not treat lifecycle readiness as diagnostic evidence`,
+        `- run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\` to collect validator evidence`,
+        "- explain each diagnostic finding with severity, provenance, and validator family (`gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`)",
         "- surface any import-state caveats or editor-side warnings",
+        `- if stale managed LSP state is suspected, use bounded GDH cleanup such as \`npx -y @skillcap/gdh@${pinnedVersion} lsp prune\` or \`npx -y @skillcap/gdh@${pinnedVersion} lsp stop\`; do not hand-manage Godot LSP processes`,
         "- if issues found, suggest concrete remediation steps",
         "</process>",
         "",
         "<rules>",
         "- Do not fix issues automatically unless asked.",
+        "- Do not hand-manage Godot LSP processes; use GDH lifecycle commands.",
+        "- The gdh lsp lifecycle commands are status, prune, and stop.",
         "- Explain diagnostics in human-readable terms.",
+        "- A ready `authoring.lsp` lifecycle is not proof that the authoring check collected diagnostics.",
         "- Report both hard failures and informational caveats.",
         "</rules>",
         "",
@@ -1077,15 +1094,20 @@ export function renderCursorCheckSkill(pinnedVersion) {
         "<process>",
         "Follow this order:",
         "",
-        `- run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\``,
-        "- explain each diagnostic finding with severity and provenance",
+        `- run \`npx -y @skillcap/gdh@${pinnedVersion} lsp status\` only for lifecycle visibility; do not treat lifecycle readiness as diagnostic evidence`,
+        `- run \`npx -y @skillcap/gdh@${pinnedVersion} authoring check\` to collect validator evidence`,
+        "- explain each diagnostic finding with severity, provenance, and validator family (`gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`)",
         "- surface any import-state caveats or editor-side warnings",
+        `- if stale managed LSP state is suspected, use bounded GDH cleanup such as \`npx -y @skillcap/gdh@${pinnedVersion} lsp prune\` or \`npx -y @skillcap/gdh@${pinnedVersion} lsp stop\`; do not hand-manage Godot LSP processes`,
         "- if issues found, suggest concrete remediation steps",
         "</process>",
         "",
         "<rules>",
         "- Do not fix issues automatically unless asked.",
+        "- Do not hand-manage Godot LSP processes; use GDH lifecycle commands.",
+        "- The gdh lsp lifecycle commands are status, prune, and stop.",
         "- Explain diagnostics in human-readable terms.",
+        "- A ready `authoring.lsp` lifecycle is not proof that the authoring check collected diagnostics.",
         "- Report both hard failures and informational caveats.",
         "</rules>",
         "",
@@ -1228,8 +1250,9 @@ export function renderClaudeVerifyCommand(pinnedVersion) {
         "1. Identify changed files from git diff or user input.",
         `2. Run \`npx -y @skillcap/gdh@${pinnedVersion} verify recommend\` with those files to get recommended validation kinds.`,
         `3. Run \`npx -y @skillcap/gdh@${pinnedVersion} verify done\` with performed validations to check done eligibility.`,
-        "4. Summarize gaps between recommended and performed validation.",
-        "5. Suggest specific next verification steps.",
+        "4. For authoring checks, explain validator-family expectations: `gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`, and manual validation for unsupported authoring files.",
+        "5. Summarize gaps between recommended and performed validation, including unavailable/degraded authoring evidence.",
+        "6. Suggest specific next verification steps.",
         "</process>",
         "",
         "<rules>",
@@ -1269,7 +1292,8 @@ export function renderCodexVerifySkill(pinnedVersion) {
         "- identify changed files from git diff or user input",
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} verify recommend\` with those files to get recommended validation kinds`,
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} verify done\` with performed validations to check done eligibility`,
-        "- summarize gaps between recommended and performed validation",
+        "- for authoring checks, explain validator-family expectations: `gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`, and manual validation for unsupported authoring files",
+        "- summarize gaps between recommended and performed validation, including unavailable/degraded authoring evidence",
         "- suggest specific next verification steps",
         "</process>",
         "",
@@ -1308,7 +1332,8 @@ export function renderCursorVerifySkill(pinnedVersion) {
         "- identify changed files from git diff or user input",
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} verify recommend\` with those files to get recommended validation kinds`,
         `- run \`npx -y @skillcap/gdh@${pinnedVersion} verify done\` with performed validations to check done eligibility`,
-        "- summarize gaps between recommended and performed validation",
+        "- for authoring checks, explain validator-family expectations: `gdscript_lsp` for `.gd`, `godot_scene_resource` for `.tscn`/`.tres`, and manual validation for unsupported authoring files",
+        "- summarize gaps between recommended and performed validation, including unavailable/degraded authoring evidence",
         "- suggest specific next verification steps",
         "</process>",
         "",
@@ -1329,7 +1354,9 @@ async function inspectProjectMcpSupport(targetPath, options) {
     const [projectFile, cursorFile, codexProjectContent, localPathHints] = await Promise.all([
         inspectJsonFile(path.join(options.integrationRootPath, PROJECT_MCP_RELATIVE_PATH)),
         inspectJsonFile(path.join(options.integrationRootPath, CURSOR_MCP_RELATIVE_PATH)),
-        fs.readFile(path.join(options.integrationRootPath, CODEX_PROJECT_CONFIG_RELATIVE_PATH), "utf8").catch(() => null),
+        fs
+            .readFile(path.join(options.integrationRootPath, CODEX_PROJECT_CONFIG_RELATIVE_PATH), "utf8")
+            .catch(() => null),
         readLocalPathHints(options.integrationRootPath),
     ]);
     const codexConfigPath = path.join(os.homedir(), ".codex/config.toml");
@@ -1534,11 +1561,7 @@ function inspectCodexSkillSurface(targetPath, relativePath, content, expectedCon
             targetPath,
             relativePath,
             present: content !== null,
-            state: content === null
-                ? "missing"
-                : content === expectedContent
-                    ? "ready"
-                    : "misconfigured",
+            state: content === null ? "missing" : content === expectedContent ? "ready" : "misconfigured",
             summary: content === null
                 ? `Codex \`/${skillName}\` skill is missing and should install under .codex/skills/.`
                 : content === expectedContent
@@ -1570,11 +1593,7 @@ function inspectClaudeCommandSurface(targetPath, relativePath, content, expected
             targetPath,
             relativePath,
             present: content !== null,
-            state: content === null
-                ? "missing"
-                : content === expectedContent
-                    ? "ready"
-                    : "misconfigured",
+            state: content === null ? "missing" : content === expectedContent ? "ready" : "misconfigured",
             summary: content === null
                 ? `Claude \`/${commandName}\` command is missing and should install under .claude/commands/gdh/.`
                 : content === expectedContent
@@ -1606,11 +1625,7 @@ function inspectCursorSkillSurface(targetPath, relativePath, content, expectedCo
             targetPath,
             relativePath,
             present: content !== null,
-            state: content === null
-                ? "missing"
-                : content === expectedContent
-                    ? "ready"
-                    : "misconfigured",
+            state: content === null ? "missing" : content === expectedContent ? "ready" : "misconfigured",
             summary: content === null
                 ? `Cursor \`/${skillName}\` skill is missing and should install under .cursor/skills/.`
                 : content === expectedContent
@@ -1623,17 +1638,31 @@ function inspectCursorSkillSurface(targetPath, relativePath, content, expectedCo
 async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersion, options) {
     const codexSkillPath = path.join(targetPath, CODEX_ONBOARD_SKILL_RELATIVE_PATH);
     const codexSkillContent = await fs.readFile(codexSkillPath, "utf8").catch(() => null);
-    const codexStatusContent = await fs.readFile(path.join(targetPath, CODEX_STATUS_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const codexMigrateContent = await fs.readFile(path.join(targetPath, CODEX_MIGRATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    const codexStatusContent = await fs
+        .readFile(path.join(targetPath, CODEX_STATUS_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const codexMigrateContent = await fs
+        .readFile(path.join(targetPath, CODEX_MIGRATE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     // Phase 13 Plan 13-03 deliverable — /gdh-update skill for Codex. Inspection
     // wiring is required so planSkillInstallAction can see the surface state;
     // otherwise the planner returns `unchanged` for a missing file and install
     // becomes a no-op (Plan 13-05 integration-test Rule 2 fix).
-    const codexUpdateContent = await fs.readFile(path.join(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const codexCheckContent = await fs.readFile(path.join(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const codexPrepareContent = await fs.readFile(path.join(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const codexVerifyContent = await fs.readFile(path.join(targetPath, CODEX_VERIFY_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const codexScanContent = await fs.readFile(path.join(targetPath, CODEX_SCAN_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    const codexUpdateContent = await fs
+        .readFile(path.join(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const codexCheckContent = await fs
+        .readFile(path.join(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const codexPrepareContent = await fs
+        .readFile(path.join(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const codexVerifyContent = await fs
+        .readFile(path.join(targetPath, CODEX_VERIFY_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const codexScanContent = await fs
+        .readFile(path.join(targetPath, CODEX_SCAN_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     const expectedCodexOnboardSkill = pinnedVersion === null ? null : renderCodexOnboardSkill(pinnedVersion);
     const expectedCodexStatusSkill = pinnedVersion === null ? null : renderCodexStatusSkill(pinnedVersion);
     const expectedCodexMigrateSkill = pinnedVersion === null ? null : renderCodexMigrateSkill(pinnedVersion);
@@ -1723,20 +1752,40 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const onboardCommandPath = path.join(targetPath, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH);
     const lstat = await fs.lstat(absolutePath).catch(() => null);
     const onboardCommandContent = await fs.readFile(onboardCommandPath, "utf8").catch(() => null);
-    const claudeStatusContent = await fs.readFile(path.join(targetPath, CLAUDE_STATUS_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeMigrateContent = await fs.readFile(path.join(targetPath, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
+    const claudeStatusContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_STATUS_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeMigrateContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     // Phase 13 Plan 13-03 deliverable — /gdh-update slash command for Claude.
     // Inspection wiring is required so planSkillInstallAction can see the surface
     // state; otherwise the planner returns `unchanged` for a missing file and
     // install becomes a no-op (Plan 13-05 integration-test Rule 2 fix).
-    const claudeUpdateContent = await fs.readFile(path.join(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeCheckContent = await fs.readFile(path.join(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudePrepareContent = await fs.readFile(path.join(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeVerifyContent = await fs.readFile(path.join(targetPath, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeScanContent = await fs.readFile(path.join(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeCheckUpdateHookContent = await fs.readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeCheckUpdateWorkerContent = await fs.readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH), "utf8").catch(() => null);
-    const claudeStatuslineContent = await fs.readFile(path.join(targetPath, CLAUDE_STATUSLINE_RELATIVE_PATH), "utf8").catch(() => null);
+    const claudeUpdateContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeCheckContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudePrepareContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeVerifyContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeScanContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeCheckUpdateHookContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeCheckUpdateWorkerContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const claudeStatuslineContent = await fs
+        .readFile(path.join(targetPath, CLAUDE_STATUSLINE_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     let detectedTarget = null;
     if (lstat?.isSymbolicLink()) {
         detectedTarget = await fs.readlink(absolutePath).catch(() => null);
@@ -1827,17 +1876,31 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
     const onboardSkillPath = path.join(targetPath, CURSOR_ONBOARD_SKILL_RELATIVE_PATH);
     const content = await fs.readFile(absolutePath, "utf8").catch(() => null);
     const onboardSkillContent = await fs.readFile(onboardSkillPath, "utf8").catch(() => null);
-    const cursorStatusContent = await fs.readFile(path.join(targetPath, CURSOR_STATUS_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const cursorMigrateContent = await fs.readFile(path.join(targetPath, CURSOR_MIGRATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    const cursorStatusContent = await fs
+        .readFile(path.join(targetPath, CURSOR_STATUS_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const cursorMigrateContent = await fs
+        .readFile(path.join(targetPath, CURSOR_MIGRATE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     // Phase 13 Plan 13-03 deliverable — /gdh-update skill for Cursor. Inspection
     // wiring required so planSkillInstallAction sees the surface state; otherwise
     // the planner returns `unchanged` for a missing file and install becomes a
     // no-op (Plan 13-05 integration-test Rule 2 fix).
-    const cursorUpdateContent = await fs.readFile(path.join(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const cursorCheckContent = await fs.readFile(path.join(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const cursorPrepareContent = await fs.readFile(path.join(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const cursorVerifyContent = await fs.readFile(path.join(targetPath, CURSOR_VERIFY_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
-    const cursorScanContent = await fs.readFile(path.join(targetPath, CURSOR_SCAN_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    const cursorUpdateContent = await fs
+        .readFile(path.join(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const cursorCheckContent = await fs
+        .readFile(path.join(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const cursorPrepareContent = await fs
+        .readFile(path.join(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const cursorVerifyContent = await fs
+        .readFile(path.join(targetPath, CURSOR_VERIFY_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
+    const cursorScanContent = await fs
+        .readFile(path.join(targetPath, CURSOR_SCAN_SKILL_RELATIVE_PATH), "utf8")
+        .catch(() => null);
     const expectedContent = renderCursorRule();
     const version = readCursorRuleVersion(content);
     const expectedCursorOnboardSkill = pinnedVersion === null ? null : renderCursorOnboardSkill(pinnedVersion);
@@ -1855,11 +1918,7 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
             targetPath,
             relativePath: CURSOR_RULE_RELATIVE_PATH,
             present: content !== null,
-            state: content === null
-                ? "missing"
-                : content === expectedContent
-                    ? "ready"
-                    : "misconfigured",
+            state: content === null ? "missing" : content === expectedContent ? "ready" : "misconfigured",
             summary: content === null
                 ? "Cursor reinforcement is missing and should point back to AGENTS.md."
                 : content === expectedContent
@@ -2145,12 +2204,7 @@ function planCodexUserInstallActions(targetPath, projectMcp, integrationRootPath
     }
     const resolvedTargetPath = path.resolve(targetPath);
     const resolvedIntegrationRootPath = path.resolve(integrationRootPath);
-    const codexCommandArgs = [
-        "-y",
-        `@skillcap/gdh@${pinnedVersion}`,
-        "mcp",
-        "serve",
-    ];
+    const codexCommandArgs = ["-y", `@skillcap/gdh@${pinnedVersion}`, "mcp", "serve"];
     if (resolvedTargetPath !== resolvedIntegrationRootPath) {
         codexCommandArgs.push("--target", resolvedTargetPath);
     }
@@ -2259,11 +2313,7 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
         targetPath,
         relativePath: CLAUDE_SETTINGS_RELATIVE_PATH,
         state: settingsIsUnchanged ? "unchanged" : "planned",
-        mode: settingsIsUnchanged
-            ? "unchanged"
-            : settingsExistedOnDisk
-                ? "replace"
-                : "create",
+        mode: settingsIsUnchanged ? "unchanged" : settingsExistedOnDisk ? "replace" : "create",
         summary: settingsIsUnchanged
             ? "GDH SessionStart hook + statusline already registered in .claude/settings.json."
             : settingsExistedOnDisk
@@ -2423,8 +2473,7 @@ function isMatchingManagedMcpServerEntry(entry, expectedEntry) {
     if (entry === null) {
         return false;
     }
-    return (JSON.stringify(normalizeJson(entry)) ===
-        JSON.stringify(normalizeJson(expectedEntry)));
+    return JSON.stringify(normalizeJson(entry)) === JSON.stringify(normalizeJson(expectedEntry));
 }
 function renderManagedMcpConfig(absolutePath, managedEntry) {
     const existing = readExistingMcpConfig(absolutePath);
@@ -2502,10 +2551,7 @@ function extractManagedCodexSection(content) {
             break;
         }
     }
-    return lines
-        .slice(start, end)
-        .join("\n")
-        .replace(/\s+$/, "");
+    return lines.slice(start, end).join("\n").replace(/\s+$/, "");
 }
 function normalizeJson(value) {
     if (Array.isArray(value)) {
@@ -2648,12 +2694,7 @@ async function listCodexMcpServers() {
 function isMatchingCodexRegistration(registration, input) {
     const resolvedTargetPath = path.resolve(input.targetPath);
     const resolvedIntegrationRootPath = path.resolve(input.integrationRootPath);
-    const expectedArgs = [
-        "-y",
-        `@skillcap/gdh@${input.pinnedVersion}`,
-        "mcp",
-        "serve",
-    ];
+    const expectedArgs = ["-y", `@skillcap/gdh@${input.pinnedVersion}`, "mcp", "serve"];
     if (resolvedTargetPath !== resolvedIntegrationRootPath) {
         expectedArgs.push("--target", resolvedTargetPath);
     }
@@ -2663,9 +2704,7 @@ function isMatchingCodexRegistration(registration, input) {
 }
 async function inspectProjectConfigLifecycleSurface(targetPath) {
     const relativePath = ".gdh/project.yaml";
-    const content = await fs
-        .readFile(path.join(targetPath, relativePath), "utf8")
-        .catch(() => null);
+    const content = await fs.readFile(path.join(targetPath, relativePath), "utf8").catch(() => null);
     const detectedVersion = readYamlVersionHeader(content);
     const probes = [
         createVersionProbe({
@@ -2768,9 +2807,7 @@ async function inspectVerificationScenarioLifecycleSurface(targetPath) {
 }
 async function inspectRulesLifecycleSurface(targetPath) {
     const relativePath = ".gdh/rules.yaml";
-    const content = await fs
-        .readFile(path.join(targetPath, relativePath), "utf8")
-        .catch(() => null);
+    const content = await fs.readFile(path.join(targetPath, relativePath), "utf8").catch(() => null);
     const detectedVersion = readYamlVersionHeader(content);
     const probes = [
         createVersionProbe({
@@ -2869,9 +2906,7 @@ function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
 }
 async function inspectGuidanceIndexLifecycleSurface(targetPath) {
     const relativePath = "docs/agent/README.md";
-    const content = await fs
-        .readFile(path.join(targetPath, relativePath), "utf8")
-        .catch(() => null);
+    const content = await fs.readFile(path.join(targetPath, relativePath), "utf8").catch(() => null);
     const detectedVersion = readTaggedVersion(content, /<!-- GDH GUIDANCE INDEX VERSION: (\d+) -->/);
     const probes = [
         createVersionProbe({
@@ -3079,9 +3114,7 @@ function inspectCursorRuleLifecycleSurface(targetPath, adapterStatus) {
         management: "managed",
         state: surface?.present ? "migration_available" : "migration_needed",
         summary: "Cursor rule file needs to be created or refreshed through the adapter install flow.",
-        reasons: surface?.present
-            ? ["cursor_rule_misconfigured"]
-            : ["cursor_rule_missing"],
+        reasons: surface?.present ? ["cursor_rule_misconfigured"] : ["cursor_rule_missing"],
         probes,
         action: {
             kind: "run_repair",
@@ -3528,8 +3561,7 @@ function readTaggedVersion(content, pattern) {
 function findAdapterSurface(adapterStatus, agent, kind) {
     return (adapterStatus.adapters
         .find((entry) => entry.agent === agent)
-        ?.surfaces.find((surface) => surface.kind === kind && surface.scope === "repo") ??
-        null);
+        ?.surfaces.find((surface) => surface.kind === kind && surface.scope === "repo") ?? null);
 }
 async function pathExists(targetPath) {
     try {
@@ -3575,6 +3607,9 @@ async function addOperationalCapabilityStatus(capabilities, targetPath) {
                 operationalAvailability: "available",
                 operationalReason: null,
                 operationalSummary: "Machine-local Godot editor path is configured, so managed authoring.lsp can launch or reuse an instance.",
+                diagnosticAvailability: "available",
+                diagnosticReason: null,
+                diagnosticSummary: "Machine-local Godot editor path is configured. `gdh authoring check` can launch the GDScript LSP and scene/resource validators, but capability status alone is not diagnostic evidence.",
             };
         }
         return {
@@ -3582,6 +3617,9 @@ async function addOperationalCapabilityStatus(capabilities, targetPath) {
             operationalAvailability: "unavailable",
             operationalReason: "godot_editor_not_configured",
             operationalSummary: "Managed authoring.lsp is enabled for this target, but no machine-local Godot editor path is configured yet.",
+            diagnosticAvailability: "unavailable",
+            diagnosticReason: "godot_editor_not_configured",
+            diagnosticSummary: "Authoring diagnostics require `gdh authoring check` plus a machine-local Godot editor path; declared `authoring.lsp` capability is not diagnostic evidence.",
         };
     });
 }
@@ -3610,9 +3648,9 @@ function deriveRepoState(context) {
 function normalizeChangedFiles(files) {
     return [...new Set(files.map((file) => file.trim()).filter((file) => file.length > 0))];
 }
-export { bumpAndRebakePin, } from "./self-update-mechanics.js";
-export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
 export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
+export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
+export { bumpAndRebakePin, } from "./self-update-mechanics.js";
 // Internal aggregator exposed for Wave 0 unit tests
 // (packages/adapters/src/lifecycle-compatibility.test.ts). Callers outside this
 // package should continue to use inspectProjectLifecycleCompatibility, which