@skillcap/gdh 0.23.0 → 0.25.0

package/node_modules/@gdh/core/dist/state/migration-state.js

@@ -0,0 +1,186 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { writeFileAtomic } from "./atomic-write.js";
+import { isEnvelopeOutput } from "../migrations/envelopes/envelope-output-validator.js";
+/**
+ * Path of the GDH migration-state envelope (D-12 / D-15 / D-16).
+ *
+ * Holds the post-rebake `last_applied_at` provenance and a typed
+ * `deferred_actions` list. Closed-kind `verify.kind` enum + structured
+ * `verify.payload` (no shell strings) eliminates the shell-injection
+ * surface called out in T-72-05-01.
+ */
+export const MIGRATION_STATE_RELATIVE_PATH = ".gdh-state/migration.json";
+const KNOWN_VERIFY_KINDS = [
+    "agent_skill_metadata_reload",
+    "process_restart",
+];
+const KNOWN_STATUSES = [
+    "pending",
+    "clean",
+    "stale",
+];
+function isVerify(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (!KNOWN_VERIFY_KINDS.includes(v["kind"])) {
+        return false;
+    }
+    const payload = v["payload"];
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return false;
+    }
+    return true;
+}
+function isDeferredAction(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (typeof v["id"] !== "string")
+        return false;
+    if (typeof v["description"] !== "string")
+        return false;
+    if (!isVerify(v["verify"]))
+        return false;
+    if (!KNOWN_STATUSES.includes(v["status"])) {
+        return false;
+    }
+    if (v["last_checked_at"] !== undefined &&
+        typeof v["last_checked_at"] !== "string") {
+        return false;
+    }
+    return true;
+}
+function isAppliedAt(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v["package"] === "string" &&
+        typeof v["schema"] === "number" &&
+        typeof v["agentContract"] === "number");
+}
+function isAttempt(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const v = value;
+    if (typeof v["recorded_at"] !== "string")
+        return false;
+    if (typeof v["from_pin"] !== "string")
+        return false;
+    if (typeof v["to_pin"] !== "string")
+        return false;
+    if (!isEnvelopeOutput(v["output_contract"]))
+        return false;
+    return true;
+}
+function isEnvelopeSlot(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const v = value;
+    if (typeof v["recorded_at"] !== "string")
+        return false;
+    if (typeof v["from_pin"] !== "string")
+        return false;
+    if (typeof v["to_pin"] !== "string")
+        return false;
+    if (!isEnvelopeOutput(v["output_contract"]))
+        return false;
+    if (!Array.isArray(v["attempts"]))
+        return false;
+    return v["attempts"].every(isAttempt);
+}
+function isEnvelopeSlotMap(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const v = value;
+    return Object.values(v).every(isEnvelopeSlot);
+}
+function isPendingEnvelopeResumeMarker(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const v = value;
+    if (typeof v["envelope_ref"] !== "string" || v["envelope_ref"].length === 0)
+        return false;
+    if (typeof v["from_pin"] !== "string")
+        return false;
+    if (typeof v["to_pin"] !== "string")
+        return false;
+    return true;
+}
+function isMigrationState(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (v["migration_version"] !== 1)
+        return false;
+    if (!isAppliedAt(v["last_applied_at"]))
+        return false;
+    if (!Array.isArray(v["deferred_actions"]))
+        return false;
+    if (!v["deferred_actions"].every(isDeferredAction))
+        return false;
+    // Phase 73 D-08 — optional envelopes slot map.
+    if (v["envelopes"] !== undefined && !isEnvelopeSlotMap(v["envelopes"]))
+        return false;
+    // Phase 73 D-11 — optional in-flight resume marker.
+    if (v["pending_envelope_resume"] !== undefined &&
+        !isPendingEnvelopeResumeMarker(v["pending_envelope_resume"])) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Read the migration-state envelope if present.
+ *
+ * Returns null when missing, parse-failed, or schema-invalid (T-72-05-04
+ * mitigation: degraded fallback prevents corrupted manifest from crashing
+ * status). Caller treats null as "no prior state" and the advisory gate
+ * keeps `deferredActions: []` with `backupAdvisory: null`.
+ */
+export async function readMigrationState(targetPath) {
+    const filePath = path.join(targetPath, MIGRATION_STATE_RELATIVE_PATH);
+    const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+    if (raw === null)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isMigrationState(parsed))
+        return null;
+    return parsed;
+}
+/**
+ * Write the migration-state envelope atomically (D-15).
+ *
+ * Uses {@link writeFileAtomic} (temp-file + POSIX rename) so the destination
+ * is either the previous state or the new state — never half-written content
+ * if the process is interrupted between writeFile and rename.
+ */
+export async function writeMigrationState(targetPath, state) {
+    const filePath = path.join(targetPath, MIGRATION_STATE_RELATIVE_PATH);
+    await writeFileAtomic(filePath, `${JSON.stringify(state, null, 2)}\n`);
+}
+/**
+ * Idempotent first-run bootstrap (D-16).
+ *
+ * Returns the existing state when present; otherwise returns a fresh empty
+ * envelope using `defaultLastAppliedAt`. Never throws — corrupted state files
+ * degrade to a fresh empty envelope so the caller can re-establish provenance
+ * at the next rebake.
+ */
+export async function bootstrapMigrationStateOrEmpty(targetPath, defaultLastAppliedAt) {
+    const existing = await readMigrationState(targetPath);
+    if (existing !== null)
+        return existing;
+    return {
+        migration_version: 1,
+        last_applied_at: defaultLastAppliedAt,
+        deferred_actions: [],
+    };
+}
+//# sourceMappingURL=migration-state.js.map

package/node_modules/@gdh/core/dist/state/migration-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-state.js","sourceRoot":"","sources":["../../src/state/migration-state.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/core/dist/state/processes-snapshot.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Path of the captured-process snapshot used by Plan 06's
+ * capture/stop/restart orchestration (WFL-01 / D-18).
+ *
+ * D-23: this file is GDH-owned machine-local state; it is OUT of the
+ * managed-surface classification scope (not a Class-1/2/3 surface in the
+ * migration sense). The name intentionally avoids `.gdh-state/inventory.json`
+ * (owned by `packages/scan/src/inventory-cache.ts`) and `.gdh-state/render-inventory.json`
+ * (owned by Plan 03 for the render set).
+ */
+export declare const PROCESSES_SNAPSHOT_RELATIVE_PATH = ".gdh-state/processes-snapshot.json";
+/** Closed enum for the kind of GDH-owned process captured in a snapshot row. */
+export type GdhCapturedProcessKind = "mcp" | "broker";
+/**
+ * Closed enum for how a captured process was stopped during the orchestration
+ * window. `null` indicates the row has been captured but stop has not yet been
+ * attempted (initial state). `"none"` indicates the stop attempt found the
+ * process already gone (idempotent stop).
+ */
+export type GdhCapturedProcessStopMethod = "graceful_sigterm" | "hard_kill" | "broker_prune" | "none";
+/**
+ * One captured process row. `pid`/`cmd`/`args`/`cwd` are the spawn fingerprint
+ * needed to re-spawn after VERIFY succeeds; `env_subset` is the allowlisted
+ * environment carried over (T-72-06-01 mitigation: never the full process.env).
+ */
+export interface GdhCapturedProcess {
+    readonly kind: GdhCapturedProcessKind;
+    readonly pid: number;
+    readonly cmd: string;
+    readonly args: readonly string[];
+    readonly cwd: string | null;
+    readonly env_subset: Record<string, string>;
+    readonly stop_method: GdhCapturedProcessStopMethod | null;
+}
+/**
+ * Snapshot envelope. `inventory_version`-style closed integer field for forward
+ * compatibility; readers refuse unknown versions and degrade to null (Pattern:
+ * Lean versioned envelope with degraded-null fallback).
+ */
+export interface GdhProcessesSnapshot {
+    readonly snapshot_version: 1;
+    readonly captured_at: string;
+    readonly processes: readonly GdhCapturedProcess[];
+}
+/**
+ * Read the captured-process snapshot if present.
+ *
+ * Returns null when missing, malformed, or schema-invalid (degraded fallback
+ * pattern from Plan 03). Never throws — caller treats null as "no captured
+ * processes" and skips stop/restart orchestration.
+ */
+export declare function readProcessesSnapshot(targetPath: string): Promise<GdhProcessesSnapshot | null>;
+/**
+ * Write the captured-process snapshot atomically (D-15: temp-file in same
+ * directory + rename). The destination is either the previous snapshot or the
+ * new one; never half-written content.
+ */
+export declare function writeProcessesSnapshot(targetPath: string, snapshot: GdhProcessesSnapshot): Promise<void>;
+/**
+ * Delete the captured-process snapshot. Returns `{ state: "deleted" }` if the
+ * file existed and is now removed; `{ state: "absent" }` if the file was not
+ * present. Never throws on absence.
+ *
+ * Plan 08 calls this after `restartFromSnapshot` reports `all_restarted` so
+ * subsequent runs do not see a stale snapshot (D-18 step 12 success path).
+ */
+export declare function deleteProcessesSnapshot(targetPath: string): Promise<{
+    readonly state: "deleted";
+} | {
+    readonly state: "absent";
+}>;
+//# sourceMappingURL=processes-snapshot.d.ts.map

package/node_modules/@gdh/core/dist/state/processes-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes-snapshot.d.ts","sourceRoot":"","sources":["../../src/state/processes-snapshot.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AAErF,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GACpC,kBAAkB,GAClB,WAAW,GACX,cAAc,GACd,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,4BAA4B,GAAG,IAAI,CAAC;CAC3D;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AA6CD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAWtC;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CASvE"}

package/node_modules/@gdh/core/dist/state/processes-snapshot.js

@@ -0,0 +1,113 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { writeFileAtomic } from "./atomic-write.js";
+/**
+ * Path of the captured-process snapshot used by Plan 06's
+ * capture/stop/restart orchestration (WFL-01 / D-18).
+ *
+ * D-23: this file is GDH-owned machine-local state; it is OUT of the
+ * managed-surface classification scope (not a Class-1/2/3 surface in the
+ * migration sense). The name intentionally avoids `.gdh-state/inventory.json`
+ * (owned by `packages/scan/src/inventory-cache.ts`) and `.gdh-state/render-inventory.json`
+ * (owned by Plan 03 for the render set).
+ */
+export const PROCESSES_SNAPSHOT_RELATIVE_PATH = ".gdh-state/processes-snapshot.json";
+const KNOWN_KINDS = ["mcp", "broker"];
+const KNOWN_STOP_METHODS = [
+    "graceful_sigterm",
+    "hard_kill",
+    "broker_prune",
+    "none",
+];
+function isCapturedProcess(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (!KNOWN_KINDS.includes(v["kind"]))
+        return false;
+    if (typeof v["pid"] !== "number" || !Number.isFinite(v["pid"]))
+        return false;
+    if (typeof v["cmd"] !== "string")
+        return false;
+    if (!Array.isArray(v["args"]))
+        return false;
+    if (!v["args"].every((entry) => typeof entry === "string"))
+        return false;
+    if (v["cwd"] !== null && typeof v["cwd"] !== "string")
+        return false;
+    const envSubset = v["env_subset"];
+    if (typeof envSubset !== "object" || envSubset === null || Array.isArray(envSubset)) {
+        return false;
+    }
+    if (!Object.values(envSubset).every((e) => typeof e === "string")) {
+        return false;
+    }
+    const stopMethod = v["stop_method"];
+    if (stopMethod !== null &&
+        !KNOWN_STOP_METHODS.includes(stopMethod)) {
+        return false;
+    }
+    return true;
+}
+function isProcessesSnapshot(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (v["snapshot_version"] !== 1)
+        return false;
+    if (typeof v["captured_at"] !== "string")
+        return false;
+    if (!Array.isArray(v["processes"]))
+        return false;
+    return v["processes"].every(isCapturedProcess);
+}
+/**
+ * Read the captured-process snapshot if present.
+ *
+ * Returns null when missing, malformed, or schema-invalid (degraded fallback
+ * pattern from Plan 03). Never throws — caller treats null as "no captured
+ * processes" and skips stop/restart orchestration.
+ */
+export async function readProcessesSnapshot(targetPath) {
+    const filePath = path.join(targetPath, PROCESSES_SNAPSHOT_RELATIVE_PATH);
+    const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+    if (raw === null)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    return isProcessesSnapshot(parsed) ? parsed : null;
+}
+/**
+ * Write the captured-process snapshot atomically (D-15: temp-file in same
+ * directory + rename). The destination is either the previous snapshot or the
+ * new one; never half-written content.
+ */
+export async function writeProcessesSnapshot(targetPath, snapshot) {
+    const filePath = path.join(targetPath, PROCESSES_SNAPSHOT_RELATIVE_PATH);
+    await writeFileAtomic(filePath, `${JSON.stringify(snapshot, null, 2)}\n`);
+}
+/**
+ * Delete the captured-process snapshot. Returns `{ state: "deleted" }` if the
+ * file existed and is now removed; `{ state: "absent" }` if the file was not
+ * present. Never throws on absence.
+ *
+ * Plan 08 calls this after `restartFromSnapshot` reports `all_restarted` so
+ * subsequent runs do not see a stale snapshot (D-18 step 12 success path).
+ */
+export async function deleteProcessesSnapshot(targetPath) {
+    const filePath = path.join(targetPath, PROCESSES_SNAPSHOT_RELATIVE_PATH);
+    const existed = await fs
+        .stat(filePath)
+        .then(() => true)
+        .catch(() => false);
+    if (!existed)
+        return { state: "absent" };
+    await fs.rm(filePath, { force: true });
+    return { state: "deleted" };
+}
+//# sourceMappingURL=processes-snapshot.js.map

package/node_modules/@gdh/core/dist/state/processes-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes-snapshot.js","sourceRoot":"","sources":["../../src/state/processes-snapshot.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/core/dist/state/render-inventory.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Path of the migration render inventory.
+ *
+ * Critical: NOT `.gdh-state/inventory.json` — that path is owned by
+ * `packages/scan/src/inventory-cache.ts` (GdhProjectInventory schema for the
+ * Godot project scan cache). See 72-RESEARCH.md Pitfall 1 and the explicit
+ * collision-check unit test in `render-inventory.test.ts`.
+ */
+export declare const RENDER_INVENTORY_RELATIVE_PATH = ".gdh-state/render-inventory.json";
+/**
+ * Rendered-at metadata: the package version and version-pair the inventory was
+ * written under. Caller is responsible for setting these to the post-rebake
+ * state. The rendered_at field is informational only — the sweep does not
+ * use it to gate behaviour; it exists to make stale render-inventory.json
+ * files diagnosable.
+ */
+export interface GdhRenderInventoryRenderedAt {
+    readonly package: string;
+    readonly schema: number;
+    readonly agentContract: number;
+}
+/**
+ * Render inventory envelope (D-11). Lean by design — set-diff orphan
+ * detection is the only consumer today. `inventory_version` allows future
+ * fields without breaking existing readers (degraded fallback returns null
+ * for unknown versions; caller treats as "no prior inventory").
+ */
+export interface GdhRenderInventory {
+    readonly inventory_version: 1;
+    readonly rendered_at: GdhRenderInventoryRenderedAt;
+    /** Workspace-relative POSIX paths, sorted ascending for stable diffs. */
+    readonly paths: readonly string[];
+}
+/**
+ * Read the render inventory if present.
+ *
+ * Returns null when missing or schema-invalid (degraded fallback per D-16
+ * legacy first-run bootstrap). Never throws — caller treats null as
+ * "no prior inventory" and skips set-diff input from this source.
+ */
+export declare function readRenderInventory(targetPath: string): Promise<GdhRenderInventory | null>;
+/**
+ * Write the render inventory atomically.
+ *
+ * Paths are sorted ascending before serialisation (stable diff property:
+ * the same input produces byte-equal output across repeat runs, regardless
+ * of caller insertion order).
+ *
+ * Atomic write via {@link writeFileAtomic} — no partial-write survives a
+ * crash; the destination is either the previous inventory or the new
+ * inventory, never half-written content.
+ */
+export declare function writeRenderInventory(targetPath: string, inventory: GdhRenderInventory): Promise<void>;
+//# sourceMappingURL=render-inventory.d.ts.map

package/node_modules/@gdh/core/dist/state/render-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-inventory.d.ts","sourceRoot":"","sources":["../../src/state/render-inventory.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,qCAAqC,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAqBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAYpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CASf"}

package/node_modules/@gdh/core/dist/state/render-inventory.js

@@ -0,0 +1,77 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { writeFileAtomic } from "./atomic-write.js";
+/**
+ * Path of the migration render inventory.
+ *
+ * Critical: NOT `.gdh-state/inventory.json` — that path is owned by
+ * `packages/scan/src/inventory-cache.ts` (GdhProjectInventory schema for the
+ * Godot project scan cache). See 72-RESEARCH.md Pitfall 1 and the explicit
+ * collision-check unit test in `render-inventory.test.ts`.
+ */
+export const RENDER_INVENTORY_RELATIVE_PATH = ".gdh-state/render-inventory.json";
+function isRenderedAt(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v["package"] === "string" &&
+        typeof v["schema"] === "number" &&
+        typeof v["agentContract"] === "number");
+}
+function isRenderInventory(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (v["inventory_version"] !== 1)
+        return false;
+    if (!isRenderedAt(v["rendered_at"]))
+        return false;
+    if (!Array.isArray(v["paths"]))
+        return false;
+    return v["paths"].every((entry) => typeof entry === "string");
+}
+/**
+ * Read the render inventory if present.
+ *
+ * Returns null when missing or schema-invalid (degraded fallback per D-16
+ * legacy first-run bootstrap). Never throws — caller treats null as
+ * "no prior inventory" and skips set-diff input from this source.
+ */
+export async function readRenderInventory(targetPath) {
+    const filePath = path.join(targetPath, RENDER_INVENTORY_RELATIVE_PATH);
+    const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+    if (raw === null)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isRenderInventory(parsed))
+        return null;
+    return parsed;
+}
+/**
+ * Write the render inventory atomically.
+ *
+ * Paths are sorted ascending before serialisation (stable diff property:
+ * the same input produces byte-equal output across repeat runs, regardless
+ * of caller insertion order).
+ *
+ * Atomic write via {@link writeFileAtomic} — no partial-write survives a
+ * crash; the destination is either the previous inventory or the new
+ * inventory, never half-written content.
+ */
+export async function writeRenderInventory(targetPath, inventory) {
+    const sortedPaths = [...inventory.paths].sort((a, b) => a.localeCompare(b));
+    const normalised = {
+        inventory_version: 1,
+        rendered_at: inventory.rendered_at,
+        paths: sortedPaths,
+    };
+    const filePath = path.join(targetPath, RENDER_INVENTORY_RELATIVE_PATH);
+    await writeFileAtomic(filePath, `${JSON.stringify(normalised, null, 2)}\n`);
+}
+//# sourceMappingURL=render-inventory.js.map

package/node_modules/@gdh/core/dist/state/render-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-inventory.js","sourceRoot":"","sources":["../../src/state/render-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,kCAAkC,CAAC;AA4BjF,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB;IAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,SAA6B;IAE7B,MAAM,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAuB;QACrC,iBAAiB,EAAE,CAAC;QACpB,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,KAAK,EAAE,WAAW;KACnB,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;IACvE,MAAM,eAAe,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/node_modules/@gdh/core/package.json

@@ -10,5 +10,5 @@
       "import": "./dist/index.js"
     }
   },
-  "version": "0.23.0"
+  "version": "0.25.0"
 }

package/node_modules/@gdh/docs/dist/agent-contract.d.ts

@@ -2,7 +2,8 @@ import { type GdhAgentContractStatus, type GdhOnboardingArtifactWrite } from "@g
 export declare const AGENT_CONTRACT_RELATIVE_PATH = "AGENTS.md";
 export declare const AGENT_CONTRACT_BEGIN_MARKER = "<!-- BEGIN GDH AGENT CONTRACT -->";
 export declare const AGENT_CONTRACT_END_MARKER = "<!-- END GDH AGENT CONTRACT -->";
-export declare const AGENT_CONTRACT_INDEX_RELATIVE_PATH = "docs/agent/README.md";
+export declare const AGENT_CONTRACT_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
+export declare const AGENT_CONTRACT_AUTHORING_RELATIVE_PATH = ".gdh/guidance/authoring-and-validation.md";
 export type GdhAgentContractMode = "root_router" | "target_contract";
 export interface GdhAgentContractRenderOptions {
     readonly mode?: GdhAgentContractMode;

package/node_modules/@gdh/docs/dist/agent-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,WAAW,CAAC;AAInB,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,kCAAkC,yBAAyB,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAErE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAOR;AAqCD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAeR;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAWrC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}
+{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,WAAW,CAAC;AAMnB,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,kCAAkC,4BAA4B,CAAC;AAC5E,eAAO,MAAM,sCAAsC,8CACN,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAErE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAOR;AAqCD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAeR;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAWrC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}

package/node_modules/@gdh/docs/dist/agent-contract.js

@@ -1,11 +1,13 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { GDH_AGENT_CONTRACT_VERSION, } from "@gdh/core";
+import { GDH_AGENT_CONTRACT_VERSION, assertClassRegistered, } from "@gdh/core";
 import { createArtifactWrite } from "./files.js";
+assertClassRegistered("agents_md_managed_block", "deterministic");
 export const AGENT_CONTRACT_RELATIVE_PATH = "AGENTS.md";
 export const AGENT_CONTRACT_BEGIN_MARKER = "<!-- BEGIN GDH AGENT CONTRACT -->";
 export const AGENT_CONTRACT_END_MARKER = "<!-- END GDH AGENT CONTRACT -->";
-export const AGENT_CONTRACT_INDEX_RELATIVE_PATH = "docs/agent/README.md";
+export const AGENT_CONTRACT_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
+export const AGENT_CONTRACT_AUTHORING_RELATIVE_PATH = ".gdh/guidance/authoring-and-validation.md";
 export function renderManagedAgentContractBlock(options = {}) {
     const mode = options.mode ?? "target_contract";
     if (mode === "root_router") {
@@ -22,7 +24,7 @@ function renderManagedTargetContractBlock() {
         "",
         "GDH is active for this Godot project.",
         `Before substantive work, load the canonical guidance index at [${AGENT_CONTRACT_INDEX_RELATIVE_PATH}](${AGENT_CONTRACT_INDEX_RELATIVE_PATH}).`,
-        "For runtime bridge usage, load [docs/agent/authoring-and-validation.md](docs/agent/authoring-and-validation.md) and follow its runtime bridge section.",
+        `For runtime bridge usage, load [${AGENT_CONTRACT_AUTHORING_RELATIVE_PATH}](${AGENT_CONTRACT_AUTHORING_RELATIVE_PATH}) and follow its runtime bridge section.`,
         "If the canonical guidance chain cannot be fully read, stop and report that GDH visibility is broken.",
         "Use GDH's structured surfaces (`gdh status`, `gdh guidance`, and `gdh authoring check`) instead of ad hoc repo guesses for project truth and code-validity evidence.",
         AGENT_CONTRACT_END_MARKER,

package/node_modules/@gdh/docs/dist/agent-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/docs/dist/guidance.d.ts

@@ -1,4 +1,6 @@
 import { type GdhGuidanceIndexDocument, type GdhGuidanceSurface, type GdhGuidanceUnitDocument, type GdhGuidanceUnitMetadata, type GdhOnboardingArtifactWrite, type GdhProjectConfig } from "@gdh/core";
+export declare const GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH = ".gdh/guidance";
+export declare const GUIDANCE_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
 interface DefaultGuidanceUnitDefinition {
     readonly relativePath: string;
     readonly metadata: GdhGuidanceUnitMetadata;

package/node_modules/@gdh/docs/dist/guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAQnB,UAAU,6BAA6B;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,GAC9B,SAAS,6BAA6B,EAAE,CA6W1C;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,EAC/B,KAAK,EAAE,SAAS,6BAA6B,EAAE,GAC9C,MAAM,CAsBR;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAuBhD;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAqB1C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA4B7C;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYzF"}
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAUnB,eAAO,MAAM,oCAAoC,kBAAkB,CAAC;AACpE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,UAAU,6BAA6B;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,GAC9B,SAAS,6BAA6B,EAAE,CAuI1C;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,EAC/B,KAAK,EAAE,SAAS,6BAA6B,EAAE,GAC9C,MAAM,CAsBR;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAuBhD;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAqB1C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA4B7C;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYzF"}