@skillcap/gdh 0.1.2

package/node_modules/@gdh/core/dist/index.d.ts

@@ -0,0 +1,1632 @@
+export declare const GDH_PRODUCT_NAME = "GDH";
+export declare const GDH_PUBLIC_PACKAGE_NAMES: readonly ["gdh", "@skillcap/gdh"];
+export declare const GDH_SCANNER_VERSION = "phase-2-scan-v1";
+export declare const GDH_PROJECT_CONFIG_VERSION = 2;
+export declare const GDH_RECIPE_SCHEMA_VERSION = 2;
+export declare const GDH_SCENARIO_SCHEMA_VERSION = 2;
+export declare const GDH_RULES_SCHEMA_VERSION = 1;
+export declare const GDH_AGENT_CONTRACT_VERSION = 1;
+export declare const GDH_GUIDANCE_INDEX_VERSION = 1;
+export declare const GDH_GUIDANCE_UNIT_VERSION = 1;
+export declare const GDH_GUIDANCE_AUDIT_VERSION = 1;
+export declare const GDH_AUTHORING_SESSION_VERSION = 2;
+export declare const GDH_AUTHORING_DOGFOOD_VERSION = 1;
+export declare const GDH_AUTHORING_SLICE_REPORT_VERSION = 1;
+export declare const GDH_MCP_MANIFEST_VERSION = 1;
+export declare const GDH_CURSOR_RULE_VERSION = 1;
+export declare const GDH_MCP_LAUNCHER_VERSION = 1;
+export declare const GDH_RUNTIME_RECIPE_RUN_VERSION = 1;
+export declare const GDH_RUNTIME_RUN_BUNDLE_VERSION = 1;
+export declare const GDH_RUNTIME_CORPUS_ARTIFACT_VERSION = 1;
+export declare const GDH_RUNTIME_BRIDGE_SURFACE_VERSION = 1;
+export type GdhProductReleaseStage = "targeted_internal_use" | "broader_internal_release" | "external_or_public_preview";
+export type GdhCurrentInstallMode = "development_checkout" | "packaged_install";
+export type GdhProductCompatibilityState = "compatible" | "migration_available" | "migration_needed" | "migration_blocked" | "compatibility_degraded";
+export type GdhProductVersionSource = "root_package_json";
+export type GdhManagedProjectSurfaceId = "project_config" | "run_configuration_schema" | "verification_scenario_schema" | "rules_schema" | "agent_contract" | "guidance_index" | "guidance_unit" | "mcp_manifest" | "cursor_rule" | "mcp_launcher" | "runtime_bridge_surface";
+export type GdhProjectLifecycleSurfaceManagement = "project_owned" | "managed" | "merge_managed";
+export type GdhProjectLifecycleActionKind = "apply_migration" | "run_repair" | "manual_review";
+export interface GdhProjectLifecycleActionHint {
+    readonly kind: GdhProjectLifecycleActionKind;
+    readonly summary: string;
+    readonly command: readonly string[] | null;
+    readonly autoApplicable: boolean;
+}
+export interface GdhProjectLifecycleVersionProbe {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly present: boolean;
+    readonly expectedVersion: number | null;
+    readonly detectedVersion: number | null;
+}
+export interface GdhProjectLifecycleSurfaceStatus {
+    readonly surface: GdhManagedProjectSurfaceId;
+    readonly management: GdhProjectLifecycleSurfaceManagement;
+    readonly state: GdhProductCompatibilityState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly probes: readonly GdhProjectLifecycleVersionProbe[];
+    readonly action: GdhProjectLifecycleActionHint | null;
+}
+export interface GdhProjectLifecycleCompatibilityResult {
+    readonly targetPath: string;
+    readonly state: GdhProductCompatibilityState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly surfaces: readonly GdhProjectLifecycleSurfaceStatus[];
+}
+export interface GdhManagedProjectSurfaceVersion {
+    readonly surface: GdhManagedProjectSurfaceId;
+    readonly version: number;
+}
+export interface GdhProductMetadata {
+    readonly name: typeof GDH_PRODUCT_NAME;
+    readonly version: string;
+    readonly releaseStage: GdhProductReleaseStage;
+    readonly versionSource: GdhProductVersionSource;
+    readonly compatibilityStates: readonly GdhProductCompatibilityState[];
+    readonly managedProjectSurfaces: readonly GdhManagedProjectSurfaceVersion[];
+}
+export interface GdhCurrentInstall {
+    readonly rootPath: string;
+    readonly mode: GdhCurrentInstallMode;
+    readonly defaultDevRepoPath: string | null;
+}
+export declare function listGdhProductCompatibilityStates(): readonly GdhProductCompatibilityState[];
+export declare function listGdhManagedProjectSurfaceVersions(): readonly GdhManagedProjectSurfaceVersion[];
+export declare function resolveGdhProductMetadata(): GdhProductMetadata;
+export declare function resolveCurrentGdhInstall(startUrl?: string | URL): GdhCurrentInstall;
+export type GdhCapabilityId = "scan" | "authoring.readiness" | "authoring.lsp";
+export type GdhCapabilityPresetId = "core" | "authoring";
+export type GdhReadinessState = "undetected" | "detected" | "authorable" | "imports_needed" | "launchable" | "observable" | "verifiable";
+export type GdhCapabilityAvailabilityState = "available" | "unavailable" | "disabled";
+export type GdhAuthoringCheckStatus = "passed" | "diagnostics" | "degraded" | "unavailable";
+export type GdhValidationKind = "authoring_check" | "unit_tests" | "integration_tests" | "editor_validation" | "runtime_scenario" | "manual_review";
+export type GdhPackageName = "@gdh/core" | "@gdh/cli" | "@gdh/authoring" | "@gdh/scan" | "@gdh/docs" | "@gdh/adapters" | "@gdh/mcp" | "@gdh/observability" | "@gdh/runtime" | "@gdh/verify";
+export type GdhPackageLayer = "foundation" | "capability" | "integration" | "surface";
+export type GdhJsonPrimitive = string | number | boolean | null;
+export type GdhJsonValue = GdhJsonPrimitive | readonly GdhJsonValue[] | {
+    readonly [key: string]: GdhJsonValue;
+};
+export declare function presentPublicRuntimeTerms(value: unknown): unknown;
+export declare function canonicalizeRuntimeTerms(value: unknown): unknown;
+export interface GdhPackageBoundary {
+    readonly name: GdhPackageName;
+    readonly layer: GdhPackageLayer;
+    readonly responsibility: string;
+    readonly allowedInternalDependencies: readonly GdhPackageName[];
+}
+export interface GdhCapabilityAvailability {
+    readonly id: GdhCapabilityId;
+    readonly declared: boolean;
+    readonly effective: boolean;
+    readonly availability: GdhCapabilityAvailabilityState;
+    readonly reason: string | null;
+}
+export interface GdhCapabilityOverrides {
+    readonly enable: readonly GdhCapabilityId[];
+    readonly disable: readonly GdhCapabilityId[];
+}
+export interface GdhWorktreeStateSnapshot {
+    readonly inventoryPath: string;
+    readonly inventoryPresent: boolean;
+    readonly readinessPath: string;
+    readonly readinessPresent: boolean;
+    readonly authoringStatePath: string;
+    readonly authoringStatePresent: boolean;
+}
+export interface GdhAuthoringStatusResult {
+    readonly targetPath: string;
+    readonly readiness: GdhReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly detectedProjectCount: number;
+    readonly primaryProjectPath: string | null;
+    readonly capabilityPreset: GdhCapabilityPresetId | null;
+    readonly capabilityOverrides: GdhCapabilityOverrides;
+    readonly declaredCapabilities: readonly GdhCapabilityId[];
+    readonly effectiveCapabilities: readonly GdhCapabilityId[];
+    readonly capabilities: readonly GdhCapabilityAvailability[];
+    readonly inventoryObservedAt: string;
+    readonly worktreeState: GdhWorktreeStateSnapshot;
+}
+export interface GdhAuthoringDiagnostic {
+    readonly message: string;
+    readonly path: string | null;
+    readonly severity: "error" | "warning" | "info";
+    readonly source: "gdh" | "godot_lsp";
+}
+export interface GdhValidationExpectation {
+    readonly id: string;
+    readonly kind: GdhValidationKind;
+    readonly required: boolean;
+    readonly summary: string;
+}
+export interface GdhRuleEntry {
+    readonly id: string;
+    readonly summary: string;
+    readonly rationale: string | null;
+    readonly validationExpectations: readonly GdhValidationExpectation[];
+}
+export interface GdhPathScopeRules {
+    readonly id: string;
+    readonly summary: string;
+    readonly pathGlobs: readonly string[];
+    readonly hardRules: readonly GdhRuleEntry[];
+    readonly softGuidance: readonly GdhRuleEntry[];
+    readonly prohibitedPatterns: readonly GdhRuleEntry[];
+    readonly validationExpectations: readonly GdhValidationExpectation[];
+}
+export interface GdhRulesDocument {
+    readonly schemaVersion: typeof GDH_RULES_SCHEMA_VERSION;
+    readonly hardRules: readonly GdhRuleEntry[];
+    readonly softGuidance: readonly GdhRuleEntry[];
+    readonly prohibitedPatterns: readonly GdhRuleEntry[];
+    readonly pathScopes: readonly GdhPathScopeRules[];
+}
+export type GdhGuidanceStrength = "required" | "recommended";
+export interface GdhGuidanceWhen {
+    readonly taskTypes: readonly string[];
+    readonly capabilities: readonly string[];
+    readonly repoState: readonly string[];
+    readonly keywords: readonly string[];
+}
+export interface GdhGuidanceUnitMetadata {
+    readonly id: string;
+    readonly title: string;
+    readonly version: typeof GDH_GUIDANCE_UNIT_VERSION;
+    readonly strength: GdhGuidanceStrength;
+    readonly when: GdhGuidanceWhen;
+}
+export interface GdhGuidanceUnitDocument {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly metadata: GdhGuidanceUnitMetadata;
+    readonly body: string;
+}
+export interface GdhGuidanceIndexEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly relativePath: string;
+    readonly strength: GdhGuidanceStrength;
+}
+export interface GdhGuidanceIndexDocument {
+    readonly version: typeof GDH_GUIDANCE_INDEX_VERSION;
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly body: string;
+    readonly entries: readonly GdhGuidanceIndexEntry[];
+}
+export interface GdhGuidanceSurface {
+    readonly rules: GdhRulesDocument | null;
+    readonly index: GdhGuidanceIndexDocument | null;
+    readonly units: readonly GdhGuidanceUnitDocument[];
+}
+export type GdhGuidanceSurfaceState = "missing" | "partial" | "ready";
+export interface GdhGuidanceRulesStatus {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly present: boolean;
+    readonly hardRuleCount: number;
+    readonly softGuidanceCount: number;
+    readonly prohibitedPatternCount: number;
+    readonly pathScopeCount: number;
+}
+export interface GdhGuidanceIndexStatus {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly present: boolean;
+    readonly version: number | null;
+    readonly entryCount: number;
+}
+export interface GdhAgentContractStatus {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly present: boolean;
+    readonly hasManagedBlock: boolean;
+    readonly version: number | null;
+    readonly canonicalIndexRelativePath: string | null;
+}
+export interface GdhGuidanceUnitsStatus {
+    readonly directoryRelativePath: string;
+    readonly directoryAbsolutePath: string;
+    readonly count: number;
+    readonly entries: readonly GdhGuidanceIndexEntry[];
+}
+export interface GdhGuidanceStatusResult {
+    readonly targetPath: string;
+    readonly state: GdhGuidanceSurfaceState;
+    readonly summary: string;
+    readonly agentContract: GdhAgentContractStatus;
+    readonly rules: GdhGuidanceRulesStatus;
+    readonly index: GdhGuidanceIndexStatus;
+    readonly units: GdhGuidanceUnitsStatus;
+}
+export interface GdhGuidanceResolveRequest {
+    readonly taskTypes: readonly string[];
+    readonly capabilities: readonly string[];
+    readonly repoState: readonly string[];
+    readonly keywords: readonly string[];
+}
+export interface GdhGuidanceResolvedUnit extends GdhGuidanceIndexEntry {
+    readonly matchedOn: GdhGuidanceWhen;
+}
+export interface GdhGuidanceResolveResult {
+    readonly targetPath: string;
+    readonly status: GdhGuidanceStatusResult;
+    readonly request: GdhGuidanceResolveRequest;
+    readonly effectiveRepoState: readonly string[];
+    readonly rules: GdhRulesDocument | null;
+    readonly eligibleUnits: readonly GdhGuidanceResolvedUnit[];
+    readonly requiredUnits: readonly GdhGuidanceResolvedUnit[];
+    readonly recommendedUnits: readonly GdhGuidanceResolvedUnit[];
+}
+export type GdhGuidanceAuditLoadMode = "auto" | "manual";
+export type GdhGuidanceAuditHeuristicKind = "late_load" | "redundant_discovery" | "repeat_search" | "unused_guidance" | "miss_after_failure" | "reload_churn";
+export interface GdhGuidanceAuditEligibleUnit {
+    readonly id: string;
+    readonly strength: GdhGuidanceStrength;
+    readonly reasons: readonly string[];
+}
+export interface GdhGuidanceAuditLoadedUnit {
+    readonly id: string;
+    readonly strength: GdhGuidanceStrength;
+    readonly loadMode: GdhGuidanceAuditLoadMode;
+    readonly loadedAt: string;
+}
+export interface GdhGuidanceAuditFinding {
+    readonly kind: GdhGuidanceAuditHeuristicKind;
+    readonly summary: string;
+    readonly relatedUnitIds: readonly string[];
+}
+export interface GdhGuidanceAuditTurn {
+    readonly turnId: string;
+    readonly recordedAt: string;
+    readonly taskSummary: string | null;
+    readonly eligibleUnits: readonly GdhGuidanceAuditEligibleUnit[];
+    readonly loadedUnits: readonly GdhGuidanceAuditLoadedUnit[];
+    readonly findings: readonly GdhGuidanceAuditFinding[];
+}
+export interface GdhGuidanceAuditSession {
+    readonly sessionId: string;
+    readonly startedAt: string;
+    readonly lastUpdatedAt: string;
+    readonly turns: readonly GdhGuidanceAuditTurn[];
+}
+export interface GdhGuidanceAuditArtifact {
+    readonly version: typeof GDH_GUIDANCE_AUDIT_VERSION;
+    readonly targetPath: string;
+    readonly sessions: readonly GdhGuidanceAuditSession[];
+}
+export type GdhGuidanceAuditInspectionState = "missing" | "empty" | "available";
+export interface GdhGuidanceAuditInspectionResult {
+    readonly targetPath: string;
+    readonly artifactPath: string;
+    readonly state: GdhGuidanceAuditInspectionState;
+    readonly summary: string;
+    readonly sessionCount: number;
+    readonly turnCount: number;
+    readonly lastRecordedAt: string | null;
+    readonly artifact: GdhGuidanceAuditArtifact | null;
+}
+export interface GdhGuidanceStatusView {
+    readonly targetPath: string;
+    readonly projectConfigPresent: boolean;
+    readonly authoringReadiness: GdhReadinessState | null;
+    readonly effectiveRepoState: readonly string[];
+    readonly guidance: GdhGuidanceStatusResult;
+    readonly audit: GdhGuidanceAuditInspectionResult;
+}
+export type GdhAuthoringSessionEventKind = "onboard" | "status" | "bridge_status" | "bridge_install" | "bridge_repair" | "bridge_remove" | "authoring_check" | "target_prepare" | "imports_refresh" | "recipe_list" | "recipe_show" | "recipe_check" | "recipe_run" | "scenario_list" | "scenario_show" | "verify_run" | "verify_inspect" | "verify_readiness" | "guidance_status" | "guidance_resolve" | "guidance_audit" | "verify_recommend" | "verify_done";
+export type GdhAuthoringSessionEventState = "succeeded" | "blocked" | "failed";
+export interface GdhAuthoringSessionGuidanceSnapshot {
+    readonly effectiveRepoState: readonly string[];
+    readonly requiredUnitIds: readonly string[];
+    readonly recommendedUnitIds: readonly string[];
+}
+export interface GdhAuthoringSessionValidationSnapshot {
+    readonly changedFiles: readonly string[];
+    readonly recommendedKinds: readonly GdhValidationKind[];
+    readonly performedKinds: readonly GdhValidationKind[];
+}
+export interface GdhAuthoringSessionEvent {
+    readonly eventId: string;
+    readonly startedAt: string;
+    readonly recordedAt: string;
+    readonly finishedAt: string;
+    readonly durationMs: number | null;
+    readonly kind: GdhAuthoringSessionEventKind;
+    readonly command: string;
+    readonly state: GdhAuthoringSessionEventState;
+    readonly summary: string;
+    readonly changedFiles: readonly string[];
+    readonly producedArtifacts: readonly string[];
+    readonly guidance: GdhAuthoringSessionGuidanceSnapshot | null;
+    readonly validation: GdhAuthoringSessionValidationSnapshot | null;
+    readonly errorMessage: string | null;
+}
+export interface GdhAuthoringSession {
+    readonly sessionId: string;
+    readonly startedAt: string;
+    readonly lastUpdatedAt: string;
+    readonly events: readonly GdhAuthoringSessionEvent[];
+}
+export interface GdhAuthoringSessionArtifact {
+    readonly version: typeof GDH_AUTHORING_SESSION_VERSION;
+    readonly targetPath: string;
+    readonly sessions: readonly GdhAuthoringSession[];
+}
+export type GdhAuthoringSessionInspectionState = "missing" | "empty" | "available";
+export interface GdhAuthoringSessionInspectionResult {
+    readonly targetPath: string;
+    readonly artifactPath: string;
+    readonly state: GdhAuthoringSessionInspectionState;
+    readonly summary: string;
+    readonly sessionCount: number;
+    readonly eventCount: number;
+    readonly lastRecordedAt: string | null;
+    readonly session: GdhAuthoringSession | null;
+    readonly artifact: GdhAuthoringSessionArtifact | null;
+}
+export type GdhAuthoringEffectivenessState = "insufficient_data" | "effective" | "partial" | "ineffective";
+export interface GdhAuthoringEffectivenessGuidanceSummary {
+    readonly guidanceAware: boolean;
+    readonly effectiveRepoState: readonly string[];
+    readonly requiredUnitIds: readonly string[];
+    readonly recommendedUnitIds: readonly string[];
+}
+export interface GdhAuthoringEffectivenessValidationSummary {
+    readonly changedFiles: readonly string[];
+    readonly recommendedKinds: readonly GdhValidationKind[];
+    readonly performedKinds: readonly GdhValidationKind[];
+    readonly missingRecommendedKinds: readonly GdhValidationKind[];
+    readonly coverageRatio: number | null;
+}
+export interface GdhAuthoringEffectivenessWorkflowSummary {
+    readonly stepsToFirstGuidance: number | null;
+    readonly stepsToFirstValidationRecommendation: number | null;
+    readonly stepsToFirstAuthoringCheck: number | null;
+    readonly stepsToFirstRuntimeVerification: number | null;
+    readonly stepsToDoneEvaluation: number | null;
+    readonly guidanceBeforeValidationRecommendation: boolean | null;
+    readonly validationRecommendationBeforeDone: boolean | null;
+    readonly doneAfterRecommendedValidation: boolean | null;
+}
+export interface GdhAuthoringEffectivenessCoverageSummary {
+    readonly validationRecommended: boolean;
+    readonly doneEvaluated: boolean;
+    readonly authoringChecked: boolean;
+    readonly runtimeVerified: boolean;
+}
+export interface GdhAuthoringEffectivenessEvidenceSummary {
+    readonly producedArtifactCount: number;
+    readonly producedArtifacts: readonly string[];
+    readonly hasRuntimeRunRecordEvidence: boolean;
+}
+export interface GdhAuthoringEffectivenessFrictionSummary {
+    readonly blockedKinds: readonly GdhAuthoringSessionEventKind[];
+    readonly failedKinds: readonly GdhAuthoringSessionEventKind[];
+    readonly repeatedBlockedKinds: readonly GdhAuthoringSessionEventKind[];
+    readonly repeatedFailedKinds: readonly GdhAuthoringSessionEventKind[];
+}
+export interface GdhAuthoringEffectivenessSuggestion {
+    readonly code: string;
+    readonly summary: string;
+}
+export interface GdhAuthoringEffectivenessResult {
+    readonly targetPath: string;
+    readonly artifactPath: string;
+    readonly state: GdhAuthoringEffectivenessState;
+    readonly summary: string;
+    readonly sessionId: string | null;
+    readonly eventCount: number;
+    readonly succeededCount: number;
+    readonly blockedCount: number;
+    readonly failedCount: number;
+    readonly guidance: GdhAuthoringEffectivenessGuidanceSummary;
+    readonly validation: GdhAuthoringEffectivenessValidationSummary;
+    readonly workflow: GdhAuthoringEffectivenessWorkflowSummary;
+    readonly coverage: GdhAuthoringEffectivenessCoverageSummary;
+    readonly evidence: GdhAuthoringEffectivenessEvidenceSummary;
+    readonly friction: GdhAuthoringEffectivenessFrictionSummary;
+    readonly suggestions: readonly GdhAuthoringEffectivenessSuggestion[];
+    readonly session: GdhAuthoringSession | null;
+    readonly sessionInspection: GdhAuthoringSessionInspectionResult;
+}
+export type GdhAuthoringDogfoodTargetKind = "fixture" | "pilot";
+export type GdhAuthoringDogfoodExecutionStrategy = "temporary_copy";
+export type GdhAuthoringDogfoodTargetState = "passed" | "blocked" | "failed";
+export type GdhAuthoringDogfoodReportState = "healthy" | "degraded" | "failed";
+export interface GdhAuthoringDogfoodTarget {
+    readonly kind: GdhAuthoringDogfoodTargetKind;
+    readonly sourcePath: string;
+    readonly executionStrategy: GdhAuthoringDogfoodExecutionStrategy;
+}
+export interface GdhAuthoringDogfoodTargetResult {
+    readonly target: GdhAuthoringDogfoodTarget;
+    readonly state: GdhAuthoringDogfoodTargetState;
+    readonly summary: string;
+    readonly changedFiles: readonly string[];
+    readonly inventory: GdhProjectInventory | null;
+    readonly onboarding: GdhOnboardingResult | null;
+    readonly status: GdhAuthoringStatusResult | null;
+    readonly guidanceStatus: GdhGuidanceStatusResult | null;
+    readonly guidanceResolve: GdhGuidanceResolveResult | null;
+    readonly validationRecommendation: GdhValidationRecommendationResult | null;
+    readonly sessionInspection: GdhAuthoringSessionInspectionResult | null;
+    readonly blockedReason: string | null;
+    readonly errorMessage: string | null;
+}
+export interface GdhAuthoringDogfoodResult {
+    readonly version: typeof GDH_AUTHORING_DOGFOOD_VERSION;
+    readonly generatedAt: string;
+    readonly state: GdhAuthoringDogfoodReportState;
+    readonly summary: string;
+    readonly fixtureTargets: readonly string[];
+    readonly pilotTarget: string | null;
+    readonly results: readonly GdhAuthoringDogfoodTargetResult[];
+}
+export type GdhAuthoringSliceReportState = "ready" | "blocked" | "degraded" | "failed";
+export type GdhAuthoringSliceFailureClass = "project_issue" | "environment_issue" | "harness_gap" | "agent_judgment_issue" | "unknown";
+export interface GdhAuthoringSliceReport {
+    readonly version: typeof GDH_AUTHORING_SLICE_REPORT_VERSION;
+    readonly generatedAt: string;
+    readonly targetPath: string;
+    readonly state: GdhAuthoringSliceReportState;
+    readonly summary: string;
+    readonly failureClass: GdhAuthoringSliceFailureClass | null;
+    readonly reasons: readonly string[];
+    readonly adapters: GdhAgentAdaptersStatusResult | null;
+    readonly dogfood: GdhAuthoringDogfoodTargetResult;
+    readonly authoringCheck: GdhAuthoringCheckResult | null;
+    readonly donePolicy: GdhDonePolicyResult | null;
+}
+export type GdhMcpToolName = "status.get" | "guidance.resolve" | "docs.search" | "docs.fetch" | "target.prepare" | "authoring.check" | "verify.recommend" | "verify.done" | "run-config.check" | "run-config.run" | "bridge.session.start" | "bridge.entry.list" | "bridge.entry.invoke" | "bridge.session.stop" | "verify.run" | "verify.inspect" | "verify.readiness";
+export interface GdhMcpResourceManifestEntry {
+    readonly name: string;
+    readonly summary: string;
+    readonly mimeType: string;
+    readonly uri: string | null;
+    readonly uriTemplate: string | null;
+}
+export type GdhMcpTargetPathPolicy = "optional" | "required";
+export type GdhMcpSchemaType = "string" | "number" | "boolean" | "array" | "object";
+export interface GdhMcpSchemaProperty {
+    readonly type: GdhMcpSchemaType;
+    readonly description: string;
+    readonly items?: GdhMcpSchemaProperty;
+    readonly properties?: Readonly<Record<string, GdhMcpSchemaProperty>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean;
+}
+export interface GdhMcpToolManifestEntry {
+    readonly name: GdhMcpToolName;
+    readonly summary: string;
+    readonly targetPathPolicy: GdhMcpTargetPathPolicy;
+    readonly inputSchema: GdhMcpSchemaProperty;
+    readonly outputSchema: GdhMcpSchemaProperty;
+    readonly outputContract: string;
+}
+export interface GdhMcpManifest {
+    readonly version: typeof GDH_MCP_MANIFEST_VERSION;
+    readonly generatedAt: string;
+    readonly product: GdhProductMetadata;
+    readonly tools: readonly GdhMcpToolManifestEntry[];
+    readonly resources: readonly GdhMcpResourceManifestEntry[];
+}
+export interface GdhMcpInvokeRequest {
+    readonly toolName: GdhMcpToolName;
+    readonly targetPath: string | null;
+    readonly input: Readonly<Record<string, GdhJsonValue>>;
+}
+export type GdhMcpInvokeState = "succeeded" | "failed";
+export interface GdhMcpInvokeResult {
+    readonly manifestVersion: typeof GDH_MCP_MANIFEST_VERSION;
+    readonly toolName: GdhMcpToolName;
+    readonly targetPath: string | null;
+    readonly state: GdhMcpInvokeState;
+    readonly output: GdhJsonValue | null;
+    readonly error: string | null;
+}
+export type GdhSupportedAgent = "codex" | "claude" | "cursor";
+export type GdhAgentAdapterSurfaceKind = "canonical_entrypoint" | "symlink" | "command_file" | "skill_file" | "rule_file" | "mcp_file" | "launcher_file" | "user_registration";
+export type GdhAgentAdapterSurfaceState = "ready" | "missing" | "misconfigured";
+export type GdhAgentAdapterSurfaceScope = "repo" | "user";
+export type GdhAgentAdapterState = "ready" | "needs_install" | "misconfigured" | "visibility_broken";
+export interface GdhAgentAdapterSurfaceStatus {
+    readonly kind: GdhAgentAdapterSurfaceKind;
+    readonly scope: GdhAgentAdapterSurfaceScope;
+    readonly relativePath: string | null;
+    readonly absolutePath: string | null;
+    readonly present: boolean;
+    readonly state: GdhAgentAdapterSurfaceState;
+    readonly summary: string;
+    readonly version: number | null;
+    readonly expectedTarget: string | null;
+    readonly detectedTarget: string | null;
+}
+export interface GdhAgentAdapterStatus {
+    readonly agent: GdhSupportedAgent;
+    readonly state: GdhAgentAdapterState;
+    readonly summary: string;
+    readonly surfaces: readonly GdhAgentAdapterSurfaceStatus[];
+}
+export interface GdhAgentAdaptersStatusResult {
+    readonly targetPath: string;
+    readonly guidance: GdhGuidanceStatusResult;
+    readonly adapters: readonly GdhAgentAdapterStatus[];
+}
+export type GdhAgentAdapterInstallActionKind = "ensure_symlink" | "write_file" | "run_command";
+export type GdhAgentAdapterInstallActionState = "planned" | "applied" | "unchanged";
+export type GdhAgentAdapterInstallActionMode = "create" | "replace" | "unchanged";
+export type GdhAgentAdaptersInstallState = "blocked" | "planned" | "applied";
+export interface GdhAgentAdapterInstallAction {
+    readonly agent: GdhSupportedAgent;
+    readonly kind: GdhAgentAdapterInstallActionKind;
+    readonly scope: GdhAgentAdapterSurfaceScope;
+    readonly relativePath: string | null;
+    readonly absolutePath: string | null;
+    readonly state: GdhAgentAdapterInstallActionState;
+    readonly mode: GdhAgentAdapterInstallActionMode;
+    readonly summary: string;
+    readonly version: number | null;
+    readonly expectedTarget: string | null;
+    readonly content: string | null;
+    readonly command: readonly string[] | null;
+}
+export interface GdhAgentAdaptersInstallResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly state: GdhAgentAdaptersInstallState;
+    readonly summary: string;
+    readonly requestedAgents: readonly GdhSupportedAgent[];
+    readonly guidance: GdhGuidanceStatusResult;
+    readonly adapters: readonly GdhAgentAdapterStatus[];
+    readonly actions: readonly GdhAgentAdapterInstallAction[];
+}
+export type GdhWorkflowAdapter = "gsd";
+export type GdhWorkflowAdapterState = "available" | "disabled_by_default";
+export type GdhWorkflowAdapterProjectionState = "available" | "unavailable";
+export interface GdhWorkflowAdapterStatus {
+    readonly adapter: GdhWorkflowAdapter;
+    readonly enabledByDefault: boolean;
+    readonly state: GdhWorkflowAdapterState;
+    readonly summary: string;
+}
+export interface GdhWorkflowAdapterProjection<T> {
+    readonly state: GdhWorkflowAdapterProjectionState;
+    readonly summary: string;
+    readonly value: T | null;
+}
+export interface GdhGsdSnapshot {
+    readonly targetPath: string;
+    readonly adapter: GdhWorkflowAdapterStatus;
+    readonly files: readonly string[];
+    readonly performed: readonly GdhValidationKind[];
+    readonly status: GdhAuthoringStatusResult;
+    readonly guidanceStatus: GdhGuidanceStatusView;
+    readonly guidanceResolve: GdhGuidanceResolveResult;
+    readonly validationRecommendation: GdhWorkflowAdapterProjection<GdhValidationRecommendationResult>;
+    readonly donePolicy: GdhWorkflowAdapterProjection<GdhDonePolicyResult>;
+}
+export type GdhAuthoringImportStateStatus = "unknown" | "cold" | "seed_available" | "hydrated";
+export interface GdhAuthoringImportState {
+    readonly status: GdhAuthoringImportStateStatus;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly seedPath: string | null;
+    readonly worktreePath: string | null;
+}
+export type GdhAuthoringCaveatKind = "import_state" | "editor_validation";
+export type GdhAuthoringCaveatSeverity = "info" | "warning";
+export interface GdhAuthoringCaveat {
+    readonly id: string;
+    readonly kind: GdhAuthoringCaveatKind;
+    readonly severity: GdhAuthoringCaveatSeverity;
+    readonly summary: string;
+    readonly reason: string;
+    readonly evidencePaths: readonly string[];
+}
+export type GdhLspLifecycleStatus = "ready" | "degraded" | "unavailable";
+export type GdhLspTrustState = "trusted" | "degraded" | "stale";
+export type GdhLspLauncherKind = "godot_editor" | "test_fake";
+export type GdhLspValidationMode = "unimplemented" | "passed" | "diagnostics" | "degraded";
+export interface GdhWorktreeIdentity {
+    readonly rootPath: string;
+    readonly worktreeKey: string;
+    readonly projectKey: string | null;
+    readonly primaryProjectPath: string | null;
+    readonly stateRootPath: string;
+}
+export interface GdhLspLeaseSnapshot {
+    readonly leaseId: string;
+    readonly owner: string;
+    readonly acquiredAt: string;
+}
+export interface GdhManagedLspInstanceSnapshot {
+    readonly instanceId: string;
+    readonly launcher: GdhLspLauncherKind;
+    readonly port: number;
+    readonly pid: number | null;
+    readonly projectPath: string;
+    readonly command: readonly string[];
+    readonly trust: GdhLspTrustState;
+    readonly launchedAt: string;
+    readonly lastValidatedAt: string;
+}
+export interface GdhManagedLspSessionSnapshot {
+    readonly lease: GdhLspLeaseSnapshot | null;
+    readonly activeLeaseCount: number;
+    readonly reusedInstance: boolean;
+    readonly cleanedStaleInstance: boolean;
+}
+export interface GdhManagedLspStatusProvenance {
+    readonly source: "authoring.lsp";
+    readonly inventoryObservedAt: string;
+    readonly projectConfigPresent: boolean;
+    readonly stateRootPath: string;
+    readonly rawPayload: Readonly<Record<string, unknown>> | null;
+}
+export interface GdhManagedLspStatusResult {
+    readonly targetPath: string;
+    readonly capability: "authoring.lsp";
+    readonly readiness: GdhReadinessState;
+    readonly availability: GdhCapabilityAvailabilityState;
+    readonly status: GdhLspLifecycleStatus;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly worktree: GdhWorktreeIdentity;
+    readonly session: GdhManagedLspSessionSnapshot;
+    readonly instance: GdhManagedLspInstanceSnapshot | null;
+    readonly provenance: GdhManagedLspStatusProvenance;
+}
+export interface GdhAuthoringCheckLspSnapshot {
+    readonly status: GdhLspLifecycleStatus;
+    readonly trust: GdhLspTrustState | null;
+    readonly instanceId: string | null;
+    readonly port: number | null;
+    readonly leaseId: string | null;
+    readonly reusedInstance: boolean;
+    readonly validationMode: GdhLspValidationMode | null;
+}
+export interface GdhAuthoringCheckProvenance {
+    readonly source: "authoring.readiness" | "authoring.lsp";
+    readonly inventoryObservedAt: string;
+    readonly projectConfigPresent: boolean;
+    readonly lsp: GdhAuthoringCheckLspSnapshot | null;
+    readonly rawPayload: Readonly<Record<string, unknown>> | null;
+}
+export interface GdhAuthoringCheckResult {
+    readonly targetPath: string;
+    readonly capability: "authoring.lsp";
+    readonly readiness: GdhReadinessState;
+    readonly status: GdhAuthoringCheckStatus;
+    readonly summary: string;
+    readonly diagnostics: readonly GdhAuthoringDiagnostic[];
+    readonly importState: GdhAuthoringImportState;
+    readonly caveats: readonly GdhAuthoringCaveat[];
+    readonly reasons: readonly string[];
+    readonly provenance: GdhAuthoringCheckProvenance;
+}
+export type GdhValidationRequirementLevel = "required" | "recommended";
+export type GdhValidationAvailability = "available" | "manual" | "unavailable";
+export type GdhValidationSourceKind = "guidance" | "path_scope" | "content_signal" | "inventory";
+export interface GdhValidationSource {
+    readonly kind: GdhValidationSourceKind;
+    readonly id: string;
+    readonly summary: string;
+}
+export interface GdhValidationScopeMatch {
+    readonly id: string;
+    readonly summary: string;
+    readonly matchedFiles: readonly string[];
+    readonly validationExpectationIds: readonly string[];
+}
+export interface GdhValidationRecommendationItem {
+    readonly id: string;
+    readonly kind: GdhValidationKind;
+    readonly level: GdhValidationRequirementLevel;
+    readonly availability: GdhValidationAvailability;
+    readonly summary: string;
+    readonly reason: string;
+    readonly matchedFiles: readonly string[];
+    readonly sources: readonly GdhValidationSource[];
+}
+export interface GdhValidationRecommendationResult {
+    readonly targetPath: string;
+    readonly files: readonly string[];
+    readonly readiness: GdhReadinessState;
+    readonly impactedAreas: readonly string[];
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly guidance: GdhGuidanceResolveResult;
+    readonly pathScopeMatches: readonly GdhValidationScopeMatch[];
+    readonly recommendations: readonly GdhValidationRecommendationItem[];
+}
+export type GdhPerformedValidationSource = "gdh" | "operator";
+export interface GdhPerformedValidation {
+    readonly kind: GdhValidationKind;
+    readonly source: GdhPerformedValidationSource;
+    readonly summary: string;
+}
+export type GdhDoneRequirementStatus = "satisfied" | "missing" | "failed" | "unavailable" | "recommended";
+export interface GdhDoneRequirementEvaluation extends GdhValidationRecommendationItem {
+    readonly status: GdhDoneRequirementStatus;
+    readonly resultSummary: string;
+    readonly satisfiedBy: GdhPerformedValidation | null;
+}
+export type GdhDonePolicyStatus = "done" | "not_done" | "blocked";
+export interface GdhDonePolicyResult {
+    readonly targetPath: string;
+    readonly files: readonly string[];
+    readonly readiness: GdhReadinessState;
+    readonly status: GdhDonePolicyStatus;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recommendation: GdhValidationRecommendationResult;
+    readonly performedValidations: readonly GdhPerformedValidation[];
+    readonly authoringCheck: GdhAuthoringCheckResult | null;
+    readonly evaluations: readonly GdhDoneRequirementEvaluation[];
+}
+export type GdhProjectPlacement = "root" | "nested" | "submodule" | "vendored";
+export interface GdhScanProvenance {
+    readonly source: "filesystem_scan";
+    readonly scannerVersion: string;
+    readonly targetPath: string;
+    readonly observedAt: string;
+    readonly evidenceFiles: readonly string[];
+}
+export interface GdhStalenessMetadata {
+    readonly status: "fresh";
+    readonly observedAt: string;
+    readonly invalidationHint: string;
+}
+export interface GdhDiscoveredAddon {
+    readonly name: string;
+    readonly configPath: string;
+}
+export interface GdhDiscoveredAutoload {
+    readonly name: string;
+    readonly scriptPath: string;
+}
+export interface GdhDiscoveredScene {
+    readonly path: string;
+    readonly configuredAsMainScene: boolean;
+}
+export interface GdhDiscoveredTest {
+    readonly path: string;
+    readonly kind: "gdscript" | "typescript" | "generic";
+}
+export interface GdhLikelyEntryPoint {
+    readonly kind: "main_scene" | "autoload" | "likely_scene";
+    readonly path: string;
+    readonly reason: string;
+}
+export interface GdhDetectedGodotProject {
+    readonly name: string | null;
+    readonly rootPath: string;
+    readonly relativePath: string;
+    readonly placement: GdhProjectPlacement;
+    readonly projectFilePath: string;
+    readonly engineVersionHints: readonly string[];
+    readonly addons: readonly GdhDiscoveredAddon[];
+    readonly autoloads: readonly GdhDiscoveredAutoload[];
+    readonly scenes: readonly GdhDiscoveredScene[];
+    readonly tests: readonly GdhDiscoveredTest[];
+    readonly likelyEntryPoints: readonly GdhLikelyEntryPoint[];
+    readonly provenance: GdhScanProvenance;
+    readonly staleness: GdhStalenessMetadata;
+}
+export interface GdhProjectInventory {
+    readonly targetPath: string;
+    readonly projects: readonly GdhDetectedGodotProject[];
+    readonly provenance: GdhScanProvenance;
+    readonly staleness: GdhStalenessMetadata;
+}
+export type GdhRecipeStatus = "draft" | "observed" | "verified" | "broken";
+export type GdhRecipeProviderId = string;
+export type GdhRecipeParameterResolutionStatus = "resolved" | "missing";
+export type GdhRecipeFeatureFlagResolutionSource = "default" | "input";
+export type GdhRecipeEnvironmentResolutionStatus = "resolved" | "missing";
+export type GdhRecipePrecheckKind = "project_path_exists" | "godot_project_exists" | "godot_editor_configured" | "launch_adapter_exists" | "env_var_present";
+export type GdhRecipePrecheckStatus = "passed" | "failed" | "skipped";
+export type GdhRuntimeRecipeSurfaceState = "ready" | "unavailable";
+export type GdhRuntimeRecipeCheckState = "runnable" | "blocked" | "misconfigured";
+export type GdhRuntimeBridgeReadinessState = "not_required" | "missing" | "ready";
+export type GdhRuntimeBridgeManagedArtifactState = "present" | "missing" | "drifted";
+export type GdhRuntimeBridgeSurfaceState = "ready" | "needs_install" | "drifted" | "blocked";
+export type GdhRuntimeBridgeCompatibilityState = Extract<GdhProductCompatibilityState, "compatible" | "migration_available">;
+export type GdhRuntimeBridgeEntryKind = "probe" | "action" | "waiter";
+export type GdhRuntimeBridgeEntryShape = "leaf" | "composite";
+export type GdhRuntimeBridgeEntrySource = "core" | "project";
+export type GdhRuntimeBridgeExecutionRoute = "player_reachable" | "internal_route";
+export type GdhRuntimeBridgeSafetyLevel = "read_only" | "controlled" | "destructive";
+export type GdhRuntimeWorkspaceMode = "isolated_copy" | "live_workspace";
+export type GdhRuntimeRecipeRunState = "passed" | "failed" | "blocked";
+export type GdhRuntimeStatusPromotion = "none" | "candidate_observed";
+export type GdhScenarioStatus = "draft" | "observed" | "verified" | "stale" | "broken";
+export type GdhScenarioAssertionSource = "launch" | "stdout_json" | "stderr_json" | "stdout_text" | "stderr_text" | "recipe_report";
+export type GdhScenarioAssertionOperator = "equals" | "includes" | "excludes";
+export type GdhScenarioAssertionStatus = "passed" | "failed" | "blocked";
+export type GdhRuntimeVerificationOutcome = "passed" | "flaky" | "failed" | "blocked";
+export type GdhRuntimeInspectionSourceState = "available" | "missing" | "invalid";
+export type GdhRuntimeRunBundleState = "available" | "missing";
+export type GdhRuntimeEvidenceFreshness = "fresh" | "stale" | "unknown";
+export type GdhRuntimeBridgeSessionState = "starting" | "ready" | "failed" | "closed";
+export type GdhRuntimeBridgeSessionStartState = "ready" | "blocked" | "failed";
+export type GdhRuntimeBridgeEntryListState = "ready" | "missing";
+export type GdhRuntimeBridgeStopState = "stopped" | "missing";
+export type GdhRuntimeBridgeInvocationState = "ok" | "unavailable" | "busy" | "failed" | "cancelled";
+export type GdhFailureAttribution = "project_issue" | "environment_issue" | "recipe_issue" | "scenario_issue" | "gdh_gap" | "agent_judgment_issue" | "unknown";
+export interface GdhProjectRootReference {
+    readonly path: string;
+    readonly name: string | null;
+    readonly placement: GdhProjectPlacement;
+    readonly engineVersionHints: readonly string[];
+    readonly primary: boolean;
+}
+export interface GdhRuntimeBridgeConfig {
+    readonly enabled: boolean;
+    readonly managed: boolean;
+    readonly projectPath: string;
+    readonly addonPath: string;
+    readonly autoloadName: string;
+    readonly autoloadScriptPath: string;
+}
+export interface GdhProjectConfig {
+    readonly schemaVersion: typeof GDH_PROJECT_CONFIG_VERSION;
+    readonly projectName: string;
+    readonly projectKeySeed: string;
+    readonly primaryGodotProjectPath: string;
+    readonly godotProjects: readonly GdhProjectRootReference[];
+    readonly defaultRecipeId: string | null;
+    readonly mcp: {
+        readonly enabled: boolean;
+    };
+    readonly runtimeBridge: GdhRuntimeBridgeConfig | null;
+    readonly allowedProviders: readonly string[];
+    readonly capabilityPreset: GdhCapabilityPresetId | null;
+    readonly capabilityOverrides: GdhCapabilityOverrides;
+    readonly enabledCapabilities: readonly GdhCapabilityId[];
+}
+export type GdhCacheScope = "worktree_local" | "project_machine" | "shared_machine";
+export interface GdhCacheNamespace {
+    readonly cacheRootPath: string;
+    readonly projectKey: string;
+    readonly projectCacheRootPath: string;
+    readonly authoringProjectCachePath: string;
+    readonly sharedCacheRootPath: string;
+    readonly worktreeStateRootPath: string;
+    readonly worktreeReadinessPath: string;
+    readonly authoringWorktreeStatePath: string;
+    readonly importSeedPath: string;
+    readonly worktreeImportStatePath: string;
+}
+export type GdhWarmupActionKind = "seed_worktree_state" | "rebuild_worktree_state" | "ensure_project_cache";
+export type GdhWarmupActionStatus = "planned" | "applied";
+export interface GdhWarmupAction {
+    readonly id: string;
+    readonly kind: GdhWarmupActionKind;
+    readonly scope: GdhCacheScope;
+    readonly status: GdhWarmupActionStatus;
+    readonly sourcePath: string | null;
+    readonly targetPath: string;
+    readonly reason: string;
+}
+export interface GdhWarmupResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly readiness: GdhReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly capabilityPreset: GdhCapabilityPresetId | null;
+    readonly capabilityOverrides: GdhCapabilityOverrides;
+    readonly declaredCapabilities: readonly GdhCapabilityId[];
+    readonly effectiveCapabilities: readonly GdhCapabilityId[];
+    readonly capabilities: readonly GdhCapabilityAvailability[];
+    readonly cacheNamespace: GdhCacheNamespace | null;
+    readonly actions: readonly GdhWarmupAction[];
+    readonly inventoryObservedAt: string;
+    readonly projectConfigPresent: boolean;
+}
+export interface GdhStatusResult extends GdhAuthoringStatusResult {
+    readonly product: GdhProductMetadata;
+    readonly projectLifecycle: GdhProjectLifecycleCompatibilityResult;
+}
+export interface GdhLocalPathHints {
+    readonly sourceTargets: readonly string[];
+    readonly gdhDevRepoPath: string | null;
+    readonly godotEditorBinPath: string | null;
+}
+export type GdhTargetPrepareActionKind = "authoring_warmup" | "hydrate_godot_state" | "refresh_imports";
+export type GdhTargetPrepareActionStatus = "planned" | "applied" | "skipped" | "blocked" | "failed";
+export interface GdhTargetPrepareAction {
+    readonly id: string;
+    readonly kind: GdhTargetPrepareActionKind;
+    readonly status: GdhTargetPrepareActionStatus;
+    readonly sourcePath: string | null;
+    readonly targetPath: string | null;
+    readonly command: readonly string[] | null;
+    readonly reason: string;
+}
+export type GdhImportRefreshState = "planned" | "applied" | "blocked" | "failed";
+export interface GdhImportRefreshResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly readiness: GdhReadinessState;
+    readonly state: GdhImportRefreshState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly primaryProjectPath: string | null;
+    readonly projectRootPath: string | null;
+    readonly command: readonly string[] | null;
+    readonly exitCode: number | null;
+    readonly projectConfigPresent: boolean;
+}
+export type GdhTargetPrepareState = "ready" | "blocked";
+export interface GdhTargetPrepareResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly readiness: GdhReadinessState;
+    readonly state: GdhTargetPrepareState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly projectConfigPresent: boolean;
+    readonly sourceTargets: readonly string[];
+    readonly selectedSourceTargetPath: string | null;
+    readonly warmup: GdhWarmupResult | null;
+    readonly importRefresh: GdhImportRefreshResult | null;
+    readonly actions: readonly GdhTargetPrepareAction[];
+}
+export interface GdhCacheEntry {
+    readonly id: string;
+    readonly scope: GdhCacheScope;
+    readonly entryType: "directory" | "file";
+    readonly path: string;
+    readonly present: boolean;
+    readonly summary: string;
+}
+export interface GdhCacheInspectResult {
+    readonly targetPath: string;
+    readonly readiness: GdhReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly cacheNamespace: GdhCacheNamespace | null;
+    readonly importState: GdhAuthoringImportState;
+    readonly entries: readonly GdhCacheEntry[];
+    readonly projectConfigPresent: boolean;
+}
+export type GdhCachePruneScope = "worktree" | "project" | "all";
+export type GdhCachePruneActionStatus = "planned" | "applied" | "skipped";
+export interface GdhCachePruneAction {
+    readonly id: string;
+    readonly scope: GdhCacheScope;
+    readonly status: GdhCachePruneActionStatus;
+    readonly targetPath: string;
+    readonly removed: boolean;
+    readonly reason: string;
+}
+export interface GdhCachePruneResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly scope: GdhCachePruneScope;
+    readonly readiness: GdhReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly cacheNamespace: GdhCacheNamespace | null;
+    readonly actions: readonly GdhCachePruneAction[];
+    readonly projectConfigPresent: boolean;
+}
+export interface GdhRecipeProvenance {
+    readonly source: "scan_inventory";
+    readonly observedAt: string;
+    readonly evidenceFiles: readonly string[];
+    readonly reason: string;
+}
+export interface GdhRecipeParameterDefinition {
+    readonly id: string;
+    readonly summary: string;
+    readonly required: boolean;
+    readonly defaultValue: string | null;
+    readonly argumentTokens: readonly string[];
+    readonly envVarName: string | null;
+}
+export interface GdhRecipeFeatureFlagDefinition {
+    readonly id: string;
+    readonly summary: string;
+    readonly enabledByDefault: boolean;
+    readonly argumentTokens: readonly string[];
+    readonly envVarName: string | null;
+    readonly envValue: string | null;
+}
+export interface GdhRecipeEnvironmentVariableDefinition {
+    readonly name: string;
+    readonly summary: string;
+    readonly source: "inline" | "process_env";
+    readonly value: string | null;
+    readonly required: boolean;
+}
+export interface GdhRecipePrecheckDefinition {
+    readonly id: string;
+    readonly kind: GdhRecipePrecheckKind;
+    readonly summary: string;
+    readonly required: boolean;
+    readonly relativePath: string | null;
+    readonly envVarName: string | null;
+}
+export interface GdhGodotProjectLaunchDefinition {
+    readonly kind: "godot_project";
+    readonly scenePath: string;
+    readonly entryPointKind: "main_scene" | "likely_scene";
+    readonly arguments: readonly string[];
+}
+export interface GdhProjectLaunchAdapterDefinition {
+    readonly kind: "project_launch_adapter";
+    readonly scriptPath: string;
+    readonly interpreter: string | null;
+    readonly arguments: readonly string[];
+    readonly workingDirectory: string | null;
+}
+export type GdhRecipeLaunchDefinition = GdhGodotProjectLaunchDefinition | GdhProjectLaunchAdapterDefinition;
+export interface GdhRecipeDefinition {
+    readonly schemaVersion: typeof GDH_RECIPE_SCHEMA_VERSION;
+    readonly id: string;
+    readonly name: string;
+    readonly status: GdhRecipeStatus;
+    readonly draftReason: string | null;
+    readonly projectPath: string;
+    readonly providers: readonly GdhRecipeProviderId[];
+    readonly parameters: readonly GdhRecipeParameterDefinition[];
+    readonly featureFlags: readonly GdhRecipeFeatureFlagDefinition[];
+    readonly environment: readonly GdhRecipeEnvironmentVariableDefinition[];
+    readonly preChecks: readonly GdhRecipePrecheckDefinition[];
+    readonly launch: GdhRecipeLaunchDefinition;
+    readonly provenance: GdhRecipeProvenance;
+}
+export interface GdhRuntimeRecipeListEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly status: GdhRecipeStatus;
+    readonly projectPath: string;
+    readonly launchKind: GdhRecipeLaunchDefinition["kind"];
+    readonly providers: readonly GdhRecipeProviderId[];
+}
+export interface GdhRuntimeRecipeListResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeRecipeSurfaceState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly projectConfigPresent: boolean;
+    readonly recipes: readonly GdhRuntimeRecipeListEntry[];
+}
+export interface GdhRuntimeRecipeShowResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeRecipeSurfaceState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recipe: GdhRecipeDefinition | null;
+}
+export interface GdhRecipeParameterResolution {
+    readonly id: string;
+    readonly summary: string;
+    readonly status: GdhRecipeParameterResolutionStatus;
+    readonly required: boolean;
+    readonly value: string | null;
+    readonly source: "input" | "default" | "missing";
+    readonly argumentTokens: readonly string[];
+    readonly envVarName: string | null;
+}
+export interface GdhRecipeFeatureFlagResolution {
+    readonly id: string;
+    readonly summary: string;
+    readonly enabled: boolean;
+    readonly source: GdhRecipeFeatureFlagResolutionSource;
+    readonly argumentTokens: readonly string[];
+    readonly envVarName: string | null;
+    readonly envValue: string | null;
+}
+export interface GdhRecipeEnvironmentResolution {
+    readonly name: string;
+    readonly summary: string;
+    readonly status: GdhRecipeEnvironmentResolutionStatus;
+    readonly required: boolean;
+    readonly value: string | null;
+    readonly source: "input" | "inline" | "process_env" | "missing";
+}
+export interface GdhRecipePrecheckResult {
+    readonly id: string;
+    readonly kind: GdhRecipePrecheckKind;
+    readonly status: GdhRecipePrecheckStatus;
+    readonly required: boolean;
+    readonly summary: string;
+    readonly relativePath: string | null;
+    readonly envVarName: string | null;
+    readonly reason: string | null;
+}
+export interface GdhRuntimeProviderResolution {
+    readonly requested: GdhRecipeProviderId | null;
+    readonly resolved: GdhRecipeProviderId | null;
+    readonly allowedProviders: readonly GdhRecipeProviderId[];
+    readonly supported: boolean;
+    readonly summary: string;
+}
+export interface GdhRuntimeBridgeReadiness {
+    readonly required: boolean;
+    readonly state: GdhRuntimeBridgeReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+}
+export interface GdhRuntimeBridgeManagedArtifactStatus {
+    readonly id: string;
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly managed: boolean;
+    readonly state: GdhRuntimeBridgeManagedArtifactState;
+    readonly summary: string;
+    readonly expectedVersion: number | null;
+    readonly detectedVersion: number | null;
+}
+export interface GdhRuntimeBridgeStatusResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeBridgeSurfaceState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly projectConfigPresent: boolean;
+    readonly compatibility: GdhRuntimeBridgeCompatibilityState;
+    readonly runtimeBridge: GdhRuntimeBridgeConfig | null;
+    readonly targetProjectPath: string | null;
+    readonly projectGodotPath: string | null;
+    readonly addonRootPath: string | null;
+    readonly autoloadRegistered: boolean;
+    readonly customEntryPaths: readonly string[];
+    readonly managedArtifacts: readonly GdhRuntimeBridgeManagedArtifactStatus[];
+}
+export type GdhRuntimeBridgeActionKind = "write_file" | "update_project_godot" | "remove_file" | "remove_project_godot_entry";
+export type GdhRuntimeBridgeActionState = "planned" | "applied" | "unchanged";
+export type GdhRuntimeBridgeApplyState = "planned" | "applied" | "blocked";
+export type GdhRuntimeBridgeOperation = "install" | "repair" | "remove";
+export interface GdhRuntimeBridgeAction {
+    readonly id: string;
+    readonly kind: GdhRuntimeBridgeActionKind;
+    readonly state: GdhRuntimeBridgeActionState;
+    readonly relativePath: string;
+    readonly summary: string;
+}
+export interface GdhRuntimeBridgeApplyResult {
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly operation: GdhRuntimeBridgeOperation;
+    readonly state: GdhRuntimeBridgeApplyState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly actions: readonly GdhRuntimeBridgeAction[];
+    readonly status: GdhRuntimeBridgeStatusResult | null;
+}
+export interface GdhRuntimeBridgeEntrySummary {
+    readonly id: string;
+    readonly summary: string;
+    readonly kind: GdhRuntimeBridgeEntryKind;
+    readonly shape: GdhRuntimeBridgeEntryShape;
+    readonly source: GdhRuntimeBridgeEntrySource;
+    readonly executionRoute: GdhRuntimeBridgeExecutionRoute | null;
+    readonly safetyLevel: GdhRuntimeBridgeSafetyLevel;
+}
+export interface GdhRuntimeBridgeSessionSummary {
+    readonly sessionId: string;
+    readonly targetPath: string;
+    readonly recipeId: string;
+    readonly state: GdhRuntimeBridgeSessionState;
+    readonly startedAt: string;
+    readonly finishedAt: string | null;
+    readonly workspaceMode: GdhRuntimeWorkspaceMode;
+    readonly workingCopyPath: string | null;
+    readonly artifactDirectory: string;
+    readonly entries: readonly GdhRuntimeBridgeEntrySummary[];
+}
+export interface GdhRuntimeBridgeSessionStartResult {
+    readonly targetPath: string;
+    readonly recipeId: string;
+    readonly state: GdhRuntimeBridgeSessionStartState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly bridge: GdhRuntimeBridgeReadiness;
+    readonly launchCommand: readonly string[] | null;
+    readonly session: GdhRuntimeBridgeSessionSummary | null;
+}
+export interface GdhRuntimeBridgeEntryListResult {
+    readonly sessionId: string;
+    readonly state: GdhRuntimeBridgeEntryListState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly entries: readonly GdhRuntimeBridgeEntrySummary[];
+}
+export interface GdhRuntimeBridgeInvocationResult {
+    readonly sessionId: string;
+    readonly entryId: string;
+    readonly state: GdhRuntimeBridgeInvocationState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly result: GdhJsonValue | null;
+    readonly transcriptPath: string | null;
+}
+export interface GdhRuntimeBridgeSessionStopResult {
+    readonly sessionId: string;
+    readonly state: GdhRuntimeBridgeStopState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly session: GdhRuntimeBridgeSessionSummary | null;
+    readonly transcriptPath: string | null;
+    readonly exitCode: number | null;
+}
+export interface GdhRuntimeLaunchPreview {
+    readonly command: readonly string[] | null;
+    readonly cwd: string | null;
+    readonly env: readonly {
+        readonly name: string;
+        readonly value: string;
+    }[];
+    readonly workspaceMode: GdhRuntimeWorkspaceMode;
+}
+export interface GdhRuntimeRecipeCheckResult {
+    readonly targetPath: string;
+    readonly recipeId: string;
+    readonly state: GdhRuntimeRecipeCheckState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recipe: GdhRecipeDefinition | null;
+    readonly provider: GdhRuntimeProviderResolution | null;
+    readonly parameters: readonly GdhRecipeParameterResolution[];
+    readonly featureFlags: readonly GdhRecipeFeatureFlagResolution[];
+    readonly environment: readonly GdhRecipeEnvironmentResolution[];
+    readonly preChecks: readonly GdhRecipePrecheckResult[];
+    readonly bridge: GdhRuntimeBridgeReadiness;
+    readonly launchPreview: GdhRuntimeLaunchPreview | null;
+}
+export interface GdhRuntimeSessionIdentity {
+    readonly launchMode: "gdh_launch";
+    readonly workspaceMode: GdhRuntimeWorkspaceMode;
+    readonly targetPath: string;
+    readonly workingCopyPath: string | null;
+}
+export interface GdhRuntimeArtifactReference {
+    readonly id: string;
+    readonly path: string;
+    readonly description: string;
+}
+export interface GdhRuntimeRecipeRunResult {
+    readonly version: typeof GDH_RUNTIME_RECIPE_RUN_VERSION;
+    readonly targetPath: string;
+    readonly recipeId: string;
+    readonly state: GdhRuntimeRecipeRunState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recipe: GdhRecipeDefinition | null;
+    readonly check: GdhRuntimeRecipeCheckResult;
+    readonly session: GdhRuntimeSessionIdentity | null;
+    readonly startedAt: string | null;
+    readonly finishedAt: string;
+    readonly exitCode: number | null;
+    readonly launchCommand: readonly string[] | null;
+    readonly artifacts: readonly GdhRuntimeArtifactReference[];
+    readonly statusPromotion: GdhRuntimeStatusPromotion;
+}
+export interface GdhScenarioAssertionDefinition {
+    readonly id: string;
+    readonly summary: string;
+    readonly source: GdhScenarioAssertionSource;
+    readonly path: string;
+    readonly operator: GdhScenarioAssertionOperator;
+    readonly expected: GdhJsonValue;
+    readonly required: boolean;
+}
+export interface GdhScenarioArtifactPolicy {
+    readonly captureState: boolean;
+    readonly screenshots: "never" | "fallback";
+}
+export interface GdhScenarioExecutionPolicy {
+    readonly maxRuntimeSeconds: number | null;
+}
+export interface GdhScenarioRetryPolicy {
+    readonly maxAttempts: number;
+}
+export interface GdhScenarioDefinition {
+    readonly schemaVersion: typeof GDH_SCENARIO_SCHEMA_VERSION;
+    readonly id: string;
+    readonly name: string;
+    readonly status: GdhScenarioStatus;
+    readonly goal: string;
+    readonly recipeId: string;
+    readonly setupSteps: readonly string[];
+    readonly actions: readonly string[];
+    readonly assertions: readonly GdhScenarioAssertionDefinition[];
+    readonly artifactPolicy: GdhScenarioArtifactPolicy;
+    readonly executionPolicy: GdhScenarioExecutionPolicy;
+    readonly retryPolicy: GdhScenarioRetryPolicy;
+    readonly doneRelevance: readonly string[];
+}
+export interface GdhRuntimeScenarioListEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly status: GdhScenarioStatus;
+    readonly recipeId: string;
+}
+export interface GdhRuntimeScenarioListResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeRecipeSurfaceState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly scenarios: readonly GdhRuntimeScenarioListEntry[];
+}
+export interface GdhRuntimeScenarioShowResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeRecipeSurfaceState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly scenario: GdhScenarioDefinition | null;
+}
+export interface GdhRuntimeInspectionSource {
+    readonly id: GdhScenarioAssertionSource;
+    readonly state: GdhRuntimeInspectionSourceState;
+    readonly summary: string;
+    readonly artifactPath: string | null;
+    readonly value: GdhJsonValue | null;
+}
+export interface GdhScenarioAssertionResult {
+    readonly id: string;
+    readonly summary: string;
+    readonly required: boolean;
+    readonly status: GdhScenarioAssertionStatus;
+    readonly source: GdhScenarioAssertionSource;
+    readonly path: string;
+    readonly operator: GdhScenarioAssertionOperator;
+    readonly expected: GdhJsonValue;
+    readonly actual: GdhJsonValue | null;
+    readonly reason: string | null;
+}
+export interface GdhRuntimeInputTrackedFile {
+    readonly relativePath: string;
+    readonly digest: string;
+}
+export interface GdhRuntimeInputTrackedEnvironment {
+    readonly name: string;
+    readonly value: string | null;
+}
+export interface GdhRuntimeInputSignature {
+    readonly algorithm: "sha256";
+    readonly digest: string;
+    readonly trackedFiles: readonly GdhRuntimeInputTrackedFile[];
+    readonly trackedEnvironment: readonly GdhRuntimeInputTrackedEnvironment[];
+}
+export interface GdhRuntimeEvidenceFreshnessResult {
+    readonly state: GdhRuntimeEvidenceFreshness;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly bundleSignature: GdhRuntimeInputSignature | null;
+    readonly currentSignature: GdhRuntimeInputSignature | null;
+}
+export interface GdhHarnessFeedbackItem {
+    readonly id: string;
+    readonly attribution: GdhFailureAttribution;
+    readonly code: string;
+    readonly summary: string;
+    readonly details: readonly string[];
+}
+export interface GdhRuntimeScenarioAttemptResult {
+    readonly attemptNumber: number;
+    readonly startedAt: string;
+    readonly finishedAt: string;
+    readonly outcome: GdhRuntimeVerificationOutcome;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recipeRun: GdhRuntimeRecipeRunResult;
+    readonly inspection: readonly GdhRuntimeInspectionSource[];
+    readonly assertions: readonly GdhScenarioAssertionResult[];
+    readonly feedback: readonly GdhHarnessFeedbackItem[];
+}
+export interface GdhRuntimeRunBundle {
+    readonly version: typeof GDH_RUNTIME_RUN_BUNDLE_VERSION;
+    readonly bundleId: string;
+    readonly bundlePath: string;
+    readonly targetPath: string;
+    readonly recipeId: string;
+    readonly scenarioId: string;
+    readonly outcome: GdhRuntimeVerificationOutcome;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly scenario: GdhScenarioDefinition;
+    readonly attempts: readonly GdhRuntimeScenarioAttemptResult[];
+    readonly retainedFirstFailureAttempt: number | null;
+    readonly feedback: readonly GdhHarnessFeedbackItem[];
+    readonly startedAt: string;
+    readonly finishedAt: string;
+    readonly inputSignature: GdhRuntimeInputSignature;
+    readonly artifacts: readonly GdhRuntimeArtifactReference[];
+}
+export interface GdhRuntimeRunBundleInspectionResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeRunBundleState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly freshness: GdhRuntimeEvidenceFreshnessResult | null;
+    readonly bundle: GdhRuntimeRunBundle | null;
+}
+export interface GdhRuntimeFeedbackAggregate {
+    readonly code: string;
+    readonly attribution: GdhFailureAttribution;
+    readonly count: number;
+    readonly latestBundleId: string | null;
+    readonly latestFinishedAt: string | null;
+    readonly summaries: readonly string[];
+}
+export type GdhRuntimeVerificationReadinessState = "ready" | "needs_verification" | "blocked";
+export interface GdhRuntimeVerificationReadinessResult {
+    readonly targetPath: string;
+    readonly state: GdhRuntimeVerificationReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly recipeCount: number;
+    readonly scenarioCount: number;
+    readonly bundleCount: number;
+    readonly latestBundle: GdhRuntimeRunBundleInspectionResult | null;
+    readonly recurringFeedback: readonly GdhRuntimeFeedbackAggregate[];
+}
+export type GdhRuntimeCorpusEntryKind = "local_fixture" | "pinned_external_repo";
+export interface GdhRuntimeCorpusManifestEntry {
+    readonly id: string;
+    readonly kind: GdhRuntimeCorpusEntryKind;
+    readonly path?: string;
+    readonly repo?: string;
+    readonly ref?: string;
+    readonly requiredForLocalMatrix: boolean;
+    readonly requiredForReleaseSubset: boolean;
+    readonly coverage: readonly string[];
+    readonly notes: string;
+}
+export interface GdhRuntimeCorpusManifest {
+    readonly version: number;
+    readonly updatedAt: string;
+    readonly entries: readonly GdhRuntimeCorpusManifestEntry[];
+}
+export interface GdhRuntimeCorpusValidationRecord {
+    readonly entryId: string;
+    readonly entryKind: GdhRuntimeCorpusEntryKind;
+    readonly targetPath: string;
+    readonly recordedAt: string;
+    readonly readinessState: GdhRuntimeVerificationReadinessState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly latestBundleId: string | null;
+    readonly latestBundleOutcome: GdhRuntimeVerificationOutcome | null;
+    readonly latestBundleFreshness: GdhRuntimeEvidenceFreshness | null;
+}
+export interface GdhRuntimeCorpusArtifact {
+    readonly version: typeof GDH_RUNTIME_CORPUS_ARTIFACT_VERSION;
+    readonly workspaceRoot: string;
+    readonly manifestPath: string;
+    readonly updatedAt: string;
+    readonly records: readonly GdhRuntimeCorpusValidationRecord[];
+}
+export type GdhRuntimeCorpusEntryStatusState = "missing" | "recorded_ready" | "recorded_needs_verification" | "recorded_blocked";
+export interface GdhRuntimeCorpusEntryStatus {
+    readonly entry: GdhRuntimeCorpusManifestEntry;
+    readonly state: GdhRuntimeCorpusEntryStatusState;
+    readonly summary: string;
+    readonly latestRecord: GdhRuntimeCorpusValidationRecord | null;
+}
+export type GdhRuntimeCorpusStatusState = "ready" | "needs_validation" | "blocked";
+export interface GdhRuntimeCorpusStatusResult {
+    readonly workspaceRoot: string;
+    readonly manifestPath: string;
+    readonly artifactPath: string;
+    readonly state: GdhRuntimeCorpusStatusState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly requiredForLocalMatrixRemaining: readonly string[];
+    readonly requiredForReleaseSubsetRemaining: readonly string[];
+    readonly entries: readonly GdhRuntimeCorpusEntryStatus[];
+    readonly artifact: GdhRuntimeCorpusArtifact | null;
+}
+export type GdhRuntimeCorpusRecordResultState = "recorded" | "blocked";
+export interface GdhRuntimeCorpusRecordResult {
+    readonly workspaceRoot: string;
+    readonly manifestPath: string;
+    readonly artifactPath: string;
+    readonly state: GdhRuntimeCorpusRecordResultState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly entry: GdhRuntimeCorpusManifestEntry;
+    readonly record: GdhRuntimeCorpusValidationRecord | null;
+    readonly readiness: GdhRuntimeVerificationReadinessResult;
+}
+export type GdhRuntimeCorpusMaterializeState = "ready" | "blocked";
+export interface GdhRuntimeCorpusMaterializeResult {
+    readonly workspaceRoot: string;
+    readonly manifestPath: string;
+    readonly state: GdhRuntimeCorpusMaterializeState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly entry: GdhRuntimeCorpusManifestEntry | null;
+    readonly sourcePath: string | null;
+    readonly materializedRef: string | null;
+}
+export interface GdhRuntimeCorpusExerciseWarning {
+    readonly code: string;
+    readonly summary: string;
+    readonly artifactPath: string | null;
+}
+export type GdhRuntimeCorpusExerciseState = "ready" | "blocked" | "failed";
+export interface GdhRuntimeCorpusExerciseResult {
+    readonly workspaceRoot: string;
+    readonly manifestPath: string;
+    readonly state: GdhRuntimeCorpusExerciseState;
+    readonly summary: string;
+    readonly reasons: readonly string[];
+    readonly entry: GdhRuntimeCorpusManifestEntry | null;
+    readonly materialization: GdhRuntimeCorpusMaterializeResult | null;
+    readonly sourcePath: string | null;
+    readonly workingTargetPath: string | null;
+    readonly onboarding: GdhOnboardingResult | null;
+    readonly status: GdhAuthoringStatusResult | null;
+    readonly targetPrepare: GdhTargetPrepareResult | null;
+    readonly runConfigurations: GdhRuntimeRecipeListResult | null;
+    readonly defaultRunConfigurationId: string | null;
+    readonly verificationScenarios: GdhRuntimeScenarioListResult | null;
+    readonly defaultVerificationScenarioId: string | null;
+    readonly runConfigurationCheck: GdhRuntimeRecipeCheckResult | null;
+    readonly runConfigurationRun: GdhRuntimeRecipeRunResult | null;
+    readonly verificationScenarioRun: GdhRuntimeRunBundle | null;
+    readonly verificationReadiness: GdhRuntimeVerificationReadinessResult | null;
+    readonly warnings: readonly GdhRuntimeCorpusExerciseWarning[];
+}
+export type GdhOnboardingArtifactScope = "durable_truth" | "derived_state";
+export type GdhOnboardingArtifactFormat = "yaml" | "json" | "markdown";
+export type GdhOnboardingArtifactMode = "create" | "overwrite" | "unchanged";
+export type GdhOnboardingArtifactWriteStrategy = "exclusive" | "merge_managed";
+export interface GdhOnboardingArtifactWrite {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly scope: GdhOnboardingArtifactScope;
+    readonly format: GdhOnboardingArtifactFormat;
+    readonly mode: GdhOnboardingArtifactMode;
+    readonly writeStrategy: GdhOnboardingArtifactWriteStrategy;
+    readonly content: string;
+}
+export type GdhOnboardingStatus = "ready" | "unresolved";
+export type GdhOnboardingQuestionResponseKind = "single_select" | "free_text";
+export type GdhOnboardingQuestionSubject = "godot_project_root" | "launch_surface";
+export interface GdhOnboardingQuestionOption {
+    readonly value: string;
+    readonly label: string;
+    readonly evidenceSummary: string;
+}
+export interface GdhOnboardingQuestion {
+    readonly id: string;
+    readonly subject: GdhOnboardingQuestionSubject;
+    readonly responseKind: GdhOnboardingQuestionResponseKind;
+    readonly prompt: string;
+    readonly options: readonly GdhOnboardingQuestionOption[];
+}
+export interface GdhOnboardingGap {
+    readonly id: string;
+    readonly summary: string;
+    readonly reason: string;
+    readonly missingEvidence: readonly string[];
+    readonly question: GdhOnboardingQuestion;
+}
+export interface GdhOnboardingResult {
+    readonly status: GdhOnboardingStatus;
+    readonly targetPath: string;
+    readonly dryRun: boolean;
+    readonly inventory: GdhProjectInventory;
+    readonly selectedProject: GdhDetectedGodotProject | null;
+    readonly projectConfig: GdhProjectConfig | null;
+    readonly recipes: readonly GdhRecipeDefinition[];
+    readonly gaps: readonly GdhOnboardingGap[];
+    readonly writes: readonly GdhOnboardingArtifactWrite[];
+}
+export declare function definePackageBoundary(boundary: GdhPackageBoundary): GdhPackageBoundary;
+export declare const corePackage: GdhPackageBoundary;
+export * from "./godot-docs-version.js";
+export * from "./local-path-hints.js";
+export * from "./official-docs.js";
+//# sourceMappingURL=index.d.ts.map