@skillcap/gdh 0.23.0 → 0.25.0

package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts

@@ -0,0 +1,294 @@
+export type GdhManagedTargetSurfaceOwner = "gdh" | "project" | "agent_vendor" | "mixed";
+export type GdhManagedTargetSurfaceDiscoveryRequirement = "root_agent_instruction" | "provider_skill" | "provider_command_legacy" | "provider_mcp_config" | "provider_hook_config" | "provider_rule" | "durable_gdh_truth" | "project_native";
+export type GdhManagedTargetSurfaceFinalDisposition = "keep_discoverability_shim" | "move_under_gdh" | "move_into_skill" | "replace_with_hook_mcp_or_cli_behavior" | "delete" | "keep_project_native";
+export type GdhManagedTargetSurfaceFollowUpPhase = "77" | "78" | "79" | null;
+export interface GdhManagedTargetSurfaceInventoryEntry {
+    readonly surfaceId: string;
+    readonly purpose: string;
+    readonly owner: GdhManagedTargetSurfaceOwner;
+    readonly targetLocations: readonly string[];
+    readonly discoveryRequirement: GdhManagedTargetSurfaceDiscoveryRequirement;
+    readonly migrationBehavior: string;
+    readonly staleBehavior: string;
+    readonly finalDisposition: GdhManagedTargetSurfaceFinalDisposition;
+    readonly dispositionRationale: string;
+    readonly followUpPhase: GdhManagedTargetSurfaceFollowUpPhase;
+}
+export declare const GDH_MANAGED_TARGET_SURFACE_INVENTORY: readonly [...{
+    surfaceId: string;
+    purpose: string;
+    owner: "gdh";
+    targetLocations: string[];
+    discoveryRequirement: "provider_skill";
+    migrationBehavior: string;
+    staleBehavior: string;
+    finalDisposition: "replace_with_hook_mcp_or_cli_behavior" | "move_into_skill";
+    dispositionRationale: string;
+    followUpPhase: "78" | null;
+}[], {
+    readonly surfaceId: "cursor_rule";
+    readonly purpose: "Minimal Cursor rule that routes GDH work to the installed GDH skills and target-local surfaces.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".cursor/rules/gdh-agent.mdc"];
+    readonly discoveryRequirement: "provider_rule";
+    readonly migrationBehavior: "Deterministically re-render when adapter surfaces are installed or repaired.";
+    readonly staleBehavior: "Replace marker-owned drift; keep user-authored Cursor rules outside the managed file untouched.";
+    readonly finalDisposition: "keep_discoverability_shim";
+    readonly dispositionRationale: "Cursor rules are a provider-native discovery hook. They should stay thin and point to skills instead of duplicating guidance.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_onboard_command";
+    readonly purpose: "Legacy Claude command compatibility for the onboard workflow.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-onboard/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/onboard.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "The onboard workflow belongs in the gdh-onboard skill; command shims should not carry separate instructions.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_status_command";
+    readonly purpose: "Legacy Claude command compatibility for status interpretation.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-status/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/status.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Status interpretation belongs in the gdh-status skill, backed by structured GDH CLI output.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_scan_command";
+    readonly purpose: "Legacy Claude command compatibility for Godot target discovery.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-scan/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/scan.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Scan workflow instructions belong in the gdh-scan skill, not in a second command document.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_migrate_command";
+    readonly purpose: "Legacy Claude command compatibility for managed surface migration.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-migrate/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/migrate.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Migration approval and terminal-state guidance belongs in the gdh-migrate skill.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_update_command";
+    readonly purpose: "Legacy Claude command compatibility for GDH self-update.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-update/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/update.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Update workflow guidance belongs in the gdh-update skill and should not be duplicated as a command doc.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_check_command";
+    readonly purpose: "Legacy Claude command compatibility for authoring validation checks.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-check/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/check.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "Validation should be driven by hook, MCP, and CLI behavior. The legacy command and generated check skill are retired.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "claude_prepare_command";
+    readonly purpose: "Legacy Claude command compatibility for target preparation.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-prepare/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/prepare.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Preparation workflow guidance belongs in the gdh-prepare skill, backed by GDH commands.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "claude_run_game_command";
+    readonly purpose: "Legacy Claude command compatibility for run configuration execution.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/skills/gdh-run-game/SKILL.md"];
+    readonly discoveryRequirement: "provider_skill";
+    readonly migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/run-game.md files are removed when GDH owns them.";
+    readonly staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.";
+    readonly finalDisposition: "move_into_skill";
+    readonly dispositionRationale: "Runtime workflow guidance belongs in the gdh-run-game skill and should reference .gdh run configurations.";
+    readonly followUpPhase: "78";
+}, {
+    readonly surfaceId: "mcp_config_entry";
+    readonly purpose: "Managed GDH MCP server entry inside Claude and Cursor project MCP files.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".mcp.json#mcpServers.gdh", ".cursor/mcp.json#mcpServers.gdh"];
+    readonly discoveryRequirement: "provider_mcp_config";
+    readonly migrationBehavior: "Patch only the GDH-owned MCP entry; leave surrounding project/user MCP config as project-native data.";
+    readonly staleBehavior: "Replace only the managed server entry when pin or invocation drifts.";
+    readonly finalDisposition: "keep_discoverability_shim";
+    readonly dispositionRationale: "Claude and Cursor require provider-visible MCP config. GDH should own the smallest possible entry, not the whole file.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "codex_project_mcp_section";
+    readonly purpose: "Managed GDH MCP server section inside repo-local Codex config.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".codex/config.toml#[mcp_servers.gdh]"];
+    readonly discoveryRequirement: "provider_mcp_config";
+    readonly migrationBehavior: "Patch the GDH-owned TOML section in repo-local config; do not register user-local Codex MCP as part of normal setup.";
+    readonly staleBehavior: "Replace the managed section when the pin or invocation drifts.";
+    readonly finalDisposition: "keep_discoverability_shim";
+    readonly dispositionRationale: "Codex needs a provider-readable MCP declaration. GDH should keep it repo-local and marker-bounded where possible.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "codex_authoring_hook_block";
+    readonly purpose: "Codex authoring hook registration for post-edit GDH validation behavior.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".codex/config.toml#GDH managed authoring hooks"];
+    readonly discoveryRequirement: "provider_hook_config";
+    readonly migrationBehavior: "Patch the managed hook block and feature flag in repo-local Codex config.";
+    readonly staleBehavior: "Replace the managed hook block when version, command, or path drifts.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "Validation enforcement should be behavior, not guidance. The config block exists only to wire the behavior.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "authoring_hook";
+    readonly purpose: "Provider hook script that turns authoring edits into GDH diagnostics/check feedback.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/hooks/gdh-authoring-guard.js", ".codex/hooks/gdh-authoring-guard.js"];
+    readonly discoveryRequirement: "provider_hook_config";
+    readonly migrationBehavior: "Deterministically re-render hook scripts for providers that support GDH hooks.";
+    readonly staleBehavior: "Replace marker-owned script drift; never depend on agents remembering validation instructions.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "Authoring validation should run through hooks and GDH CLI evidence rather than prose instructions.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "claude_update_hook";
+    readonly purpose: "Claude SessionStart hook that checks whether the pinned GDH install is stale.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/hooks/gdh-check-update.js"];
+    readonly discoveryRequirement: "provider_hook_config";
+    readonly migrationBehavior: "Deterministically re-render the managed hook script.";
+    readonly staleBehavior: "Replace marker-owned script drift; stale update awareness should not live in docs.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "Update awareness is event-driven behavior. Guidance should only explain outcomes when surfaced.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "claude_update_worker";
+    readonly purpose: "Background worker used by the Claude update-check hook.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/hooks/gdh-check-update-worker.js"];
+    readonly discoveryRequirement: "provider_hook_config";
+    readonly migrationBehavior: "Deterministically re-render the managed worker script.";
+    readonly staleBehavior: "Replace marker-owned worker drift with the current version.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "This is implementation machinery for a hook, not a target-project documentation surface.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "claude_statusline";
+    readonly purpose: "Optional Claude statusline script for surfacing GDH target status.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".claude/hooks/gdh-statusline.js"];
+    readonly discoveryRequirement: "provider_hook_config";
+    readonly migrationBehavior: "Deterministically re-render the optional script; statusline registration remains opt-in.";
+    readonly staleBehavior: "Replace marker-owned script drift; do not overwrite unrelated statusline settings.";
+    readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
+    readonly dispositionRationale: "Statusline behavior belongs in an executable script with opt-in registration, not in general guidance.";
+    readonly followUpPhase: "79";
+}, {
+    readonly surfaceId: "agents_md_managed_block";
+    readonly purpose: "Root agent-instruction pointer that tells agents this target is GDH-managed.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly ["AGENTS.md#GDH managed block"];
+    readonly discoveryRequirement: "root_agent_instruction";
+    readonly migrationBehavior: "Patch only the GDH-owned marker block; preserve user-authored AGENTS.md content around it.";
+    readonly staleBehavior: "Replace the managed block when its version or target pointers drift.";
+    readonly finalDisposition: "keep_discoverability_shim";
+    readonly dispositionRationale: "A tiny root pointer is useful for discoverability, but full GDH docs must not live in root instructions.";
+    readonly followUpPhase: "77";
+}, {
+    readonly surfaceId: "guidance_unit_set";
+    readonly purpose: "Generated GDH guidance units currently emitted as target-local docs.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".gdh/guidance/*.md"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Current versions deterministically re-render units from package templates.";
+    readonly staleBehavior: "Version drift replaces generated units in the GDH-owned guidance directory.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "Durable GDH target guidance belongs under .gdh. Command-specific/onboarding guidance should be folded into skills during the skill repack.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "guidance_index";
+    readonly purpose: "Generated index for GDH guidance units.";
+    readonly owner: "gdh";
+    readonly targetLocations: readonly [".gdh/guidance/README.md"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Current versions deterministically re-render the index from generated units.";
+    readonly staleBehavior: "Version drift replaces the generated index in the GDH-owned guidance directory.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "The index should move with the guidance corpus under .gdh, leaving only minimal root/provider pointers.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "gdh_project_yaml";
+    readonly purpose: "Durable GDH project configuration and pinned GDH version.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".gdh/project.yaml"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Schema migrations preserve user-selected values while updating GDH-owned shape.";
+    readonly staleBehavior: "Schema/pin drift is handled by migration planning and explicit apply.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "This already lives in the correct durable GDH namespace.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "gdh_rules_yaml";
+    readonly purpose: "Durable GDH project rules and policy defaults.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".gdh/rules.yaml"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Byte-equal defaults can be upgraded automatically; user-customized rules require conflict-aware migration.";
+    readonly staleBehavior: "Default drift is auto-replaceable only when prior content is still known GDH default content.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "Rules are durable GDH target truth and already live under .gdh.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "run_configuration_set";
+    readonly purpose: "User-authored run configurations managed by GDH schema.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".gdh/run-configurations/*.yaml"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Schema migrations preserve user-authored run intent and route semantic changes through review.";
+    readonly staleBehavior: "Schema drift requires migration; user values are not overwritten as deterministic render output.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "Run configurations are durable GDH target truth and already live under .gdh.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "verification_scenario_set";
+    readonly purpose: "User-authored verification scenarios managed by GDH schema.";
+    readonly owner: "mixed";
+    readonly targetLocations: readonly [".gdh/verification-scenarios/*.yaml"];
+    readonly discoveryRequirement: "durable_gdh_truth";
+    readonly migrationBehavior: "Schema migrations preserve user-authored verification intent and route semantic changes through review.";
+    readonly staleBehavior: "Schema drift requires migration; user values are not overwritten as deterministic render output.";
+    readonly finalDisposition: "move_under_gdh";
+    readonly dispositionRationale: "Verification scenarios are durable GDH target truth and already live under .gdh.";
+    readonly followUpPhase: null;
+}, {
+    readonly surfaceId: "project_godot";
+    readonly purpose: "Godot project manifest touched only through explicit allowlisted project-native operations.";
+    readonly owner: "project";
+    readonly targetLocations: readonly ["project.godot"];
+    readonly discoveryRequirement: "project_native";
+    readonly migrationBehavior: "GDH may only apply registered allowlisted operations such as autoload/plugin updates.";
+    readonly staleBehavior: "Unallowlisted drift is project-owned and must not be treated as GDH stale content.";
+    readonly finalDisposition: "keep_project_native";
+    readonly dispositionRationale: "This is not GDH-owned target guidance. It remains Godot project truth with explicit operation allowlists.";
+    readonly followUpPhase: null;
+}];
+export declare function assertManagedTargetSurfaceInventoryComplete(): void;
+//# sourceMappingURL=managed-target-surface-inventory.d.ts.map

package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-target-surface-inventory.d.ts","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAExF,MAAM,MAAM,2CAA2C,GACnD,wBAAwB,GACxB,gBAAgB,GAChB,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,eAAe,GACf,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,MAAM,uCAAuC,GAC/C,2BAA2B,GAC3B,gBAAgB,GAChB,iBAAiB,GACjB,uCAAuC,GACvC,QAAQ,GACR,qBAAqB,CAAC;AAE1B,MAAM,MAAM,oCAAoC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7E,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,2CAA2C,CAAC;IAC3E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;IACnE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,oCAAoC,CAAC;CAC9D;AAsZD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGoB,CAAC;AAEtE,wBAAgB,2CAA2C,IAAI,IAAI,CA0BlE"}