@orchestrator-claude/definitions 3.32.2 → 3.34.0

package/dist/install/ProjectSettingsNeutralizer.d.ts

@@ -0,0 +1,39 @@
+export declare class ProjectSettingsNeutralizer {
+    private readonly projectSettingsPath;
+    constructor(projectSettingsPath: string);
+    /**
+     * Copies `projectSettingsPath` to `<path>.orch-install-bak` (R-2). Safe to
+     * call more than once — always re-copies the CURRENT on-disk content, so
+     * a caller that already backed up before calling `neutralize()` (which
+     * also backs up internally) never loses the true pre-mutation state.
+     */
+    backup(): string;
+    /**
+     * Removes only the `hooks` key from `projectSettingsPath`, preserving
+     * every other key untouched. Calls `backup()` unconditionally as its
+     * first action (R-2) — no branch in this method mutates the file before
+     * a backup exists.
+     */
+    neutralize(): {
+        neutralized: boolean;
+    };
+    /**
+     * Restores `projectSettingsPath` from a previously-created backup path
+     * (as returned by `backup()`). Called by the ORCHESTRATOR's own `catch` —
+     * see module JSDoc — never invoked internally by this class.
+     */
+    restore(bakPath: string): void;
+    private backupPath;
+    private readSettings;
+    /**
+     * Stage-then-swap for a SINGLE file (ADR-003 discipline, scaled down from
+     * `Materializer`'s per-category directory rename): write to a sibling
+     * temp path, then `renameSync` over the target. A failure at either step
+     * never touches `projectSettingsPath` — the temp file is the only thing
+     * that can be left in an inconsistent state, and it is cleaned up in the
+     * `catch`.
+     */
+    private writeAtomic;
+    private tmpPath;
+}
+//# sourceMappingURL=ProjectSettingsNeutralizer.d.ts.map

package/dist/install/ProjectSettingsNeutralizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectSettingsNeutralizer.d.ts","sourceRoot":"","sources":["../../src/install/ProjectSettingsNeutralizer.ts"],"names":[],"mappings":"AA8BA,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,MAAM;IAExD;;;;;OAKG;IACH,MAAM,IAAI,MAAM;IAMhB;;;;;OAKG;IACH,UAAU,IAAI;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE;IAYtC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAKpB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,OAAO;CAGhB"}

package/dist/install/ProjectSettingsNeutralizer.js

@@ -0,0 +1,100 @@
+/**
+ * ProjectSettingsNeutralizer - backup + atomic removal of the `hooks` key
+ * from the target project's `.claude/settings.json`, with rollback
+ * (RF-003/RF-006, R-2).
+ *
+ * Two independent safety nets protect against a partial mutation corrupting
+ * the project's settings file:
+ *   1. **Atomic write** (this module, `writeAtomic()`): `neutralize()` never
+ *      writes through `projectSettingsPath` directly — it writes the next
+ *      content to a sibling temp file and `renameSync`s it over the target
+ *      (same stage-then-swap discipline as `Materializer`, ADR-003). A
+ *      rename replaces whatever directory entry currently sits at the
+ *      target path (including a symlink, FA-002) without following it, so a
+ *      mid-write failure (e.g. a mocked `ENOSPC`) always leaves the
+ *      ORIGINAL file untouched — never a half-written one.
+ *   2. **Backup + restore** (R-2, AC-006): `neutralize()` unconditionally
+ *      calls `backup()` as its very first action — there is no code path
+ *      that mutates `projectSettingsPath` without a `.orch-install-bak`
+ *      copy already on disk. `restore(bakPath)` is the counterpart the
+ *      ORCHESTRATOR (`InstallCommand`, TASK-032, Fase 6 — out of this
+ *      module's scope) calls from its own `catch` if a LATER step of the
+ *      overall install sequence fails after `neutralize()` already
+ *      succeeded. This class only implements the primitive — it never
+ *      calls `restore()` on itself.
+ *
+ * `neutralize()` removes ONLY the `hooks` key — every other key (`env`,
+ * `permissions`, `enabledPlugins`, ...) is preserved untouched.
+ */
+import { copyFileSync, existsSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+export class ProjectSettingsNeutralizer {
+    projectSettingsPath;
+    constructor(projectSettingsPath) {
+        this.projectSettingsPath = projectSettingsPath;
+    }
+    /**
+     * Copies `projectSettingsPath` to `<path>.orch-install-bak` (R-2). Safe to
+     * call more than once — always re-copies the CURRENT on-disk content, so
+     * a caller that already backed up before calling `neutralize()` (which
+     * also backs up internally) never loses the true pre-mutation state.
+     */
+    backup() {
+        const bakPath = this.backupPath();
+        copyFileSync(this.projectSettingsPath, bakPath);
+        return bakPath;
+    }
+    /**
+     * Removes only the `hooks` key from `projectSettingsPath`, preserving
+     * every other key untouched. Calls `backup()` unconditionally as its
+     * first action (R-2) — no branch in this method mutates the file before
+     * a backup exists.
+     */
+    neutralize() {
+        this.backup();
+        const current = this.readSettings();
+        const hadHooks = Object.prototype.hasOwnProperty.call(current, 'hooks');
+        const { hooks: _hooks, ...rest } = current;
+        this.writeAtomic(JSON.stringify(rest, null, 2));
+        return { neutralized: hadHooks };
+    }
+    /**
+     * Restores `projectSettingsPath` from a previously-created backup path
+     * (as returned by `backup()`). Called by the ORCHESTRATOR's own `catch` —
+     * see module JSDoc — never invoked internally by this class.
+     */
+    restore(bakPath) {
+        copyFileSync(bakPath, this.projectSettingsPath);
+    }
+    backupPath() {
+        return `${this.projectSettingsPath}.orch-install-bak`;
+    }
+    readSettings() {
+        const raw = readFileSync(this.projectSettingsPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    /**
+     * Stage-then-swap for a SINGLE file (ADR-003 discipline, scaled down from
+     * `Materializer`'s per-category directory rename): write to a sibling
+     * temp path, then `renameSync` over the target. A failure at either step
+     * never touches `projectSettingsPath` — the temp file is the only thing
+     * that can be left in an inconsistent state, and it is cleaned up in the
+     * `catch`.
+     */
+    writeAtomic(content) {
+        const tmpPath = this.tmpPath();
+        try {
+            writeFileSync(tmpPath, content, 'utf-8');
+            renameSync(tmpPath, this.projectSettingsPath);
+        }
+        catch (error) {
+            if (existsSync(tmpPath)) {
+                rmSync(tmpPath, { force: true });
+            }
+            throw new Error(`ProjectSettingsNeutralizer.neutralize() failed writing "${this.projectSettingsPath}": ${error.message}`, { cause: error });
+        }
+    }
+    tmpPath() {
+        return `${this.projectSettingsPath}.orch-neutralize-tmp-${process.pid}`;
+    }
+}
+//# sourceMappingURL=ProjectSettingsNeutralizer.js.map

package/dist/install/ProjectSettingsNeutralizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectSettingsNeutralizer.js","sourceRoot":"","sources":["../../src/install/ProjectSettingsNeutralizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpG,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,mBAA2B;QAA3B,wBAAmB,GAAnB,mBAAmB,CAAQ;IAAG,CAAC;IAE5D;;;;;OAKG;IACH,MAAM;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,YAAY,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAE3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEhD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAe;QACrB,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClD,CAAC;IAEO,UAAU;QAChB,OAAO,GAAG,IAAI,CAAC,mBAAmB,mBAAmB,CAAC;IACxD,CAAC;IAEO,YAAY;QAClB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACK,WAAW,CAAC,OAAe;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2DAA2D,IAAI,CAAC,mBAAmB,MAAO,KAAe,CAAC,OAAO,EAAE,EACnH,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,OAAO;QACb,OAAO,GAAG,IAAI,CAAC,mBAAmB,wBAAwB,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1E,CAAC;CACF"}

package/dist/install/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Types for the `orch-defs install` command (RFC-040 §9.1).
+ *
+ * These types define the public contract used across the install pipeline
+ * (detection, MCP server registration, hooks wiring, project neutralization).
+ */
+export interface InstallCommandOptions {
+    dryRun?: boolean;
+    devCheckoutAck?: boolean;
+    homeDir?: string;
+    monorepoRoot?: string;
+    cwd?: string;
+}
+export interface InstallResult {
+    success: boolean;
+    mode: 'clean-install' | 'dev-checkout';
+    dryRun: boolean;
+    summary: {
+        filesWritten: number;
+        filesUnchanged: number;
+        mcpServersRegistered: number;
+        mcpServersSkipped: number;
+        hooksWired: boolean;
+        projectNeutralized: boolean;
+    };
+    warnings: string[];
+    errors: string[];
+}
+export interface DetectionResult {
+    mode: 'clean-install' | 'dev-checkout';
+    matchedSlugs: string[];
+    reason: string;
+}
+export interface McpServerSpec {
+    name: string;
+    type?: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+}
+export interface HooksTemplate {
+    hooks: Record<string, Array<{
+        matcher: string;
+        hooks: Array<{
+            type: 'command';
+            command: string;
+            timeout: number;
+        }>;
+    }>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/install/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/install/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,GAAG,cAAc,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,GAAG,cAAc,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CACX,MAAM,EACN,KAAK,CAAC;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,SAAS,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC,CACH,CAAC;CACH"}

package/dist/install/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for the `orch-defs install` command (RFC-040 §9.1).
+ *
+ * These types define the public contract used across the install pipeline
+ * (detection, MCP server registration, hooks wiring, project neutralization).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/install/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/install/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/manifest/ManifestLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManifestLoader.d.ts","sourceRoot":"","sources":["../../src/manifest/ManifestLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAItF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,IAAI,IAAI,cAAc;IAqBtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAuBxC;;;OAGG;IACH,eAAe,IAAI;QAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,OAAO,EAAE,eAAe,EAAE,CAAA;KAAE;IAgC3E;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAQrD;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC,eAAe,GAAG;QAAE,QAAQ,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAc1E,cAAc,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"ManifestLoader.d.ts","sourceRoot":"","sources":["../../src/manifest/ManifestLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAItF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,IAAI,IAAI,cAAc;IAqBtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAuBxC;;;OAGG;IACH,eAAe,IAAI;QAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,OAAO,EAAE,eAAe,EAAE,CAAA;KAAE;IAiC3E;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAQrD;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC,eAAe,GAAG;QAAE,QAAQ,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAc1E,cAAc,IAAI,MAAM;CAGzB"}

package/dist/manifest/ManifestLoader.js

@@ -40,7 +40,7 @@ export class ManifestLoader {
         if (!manifest.version || typeof manifest.version !== 'string') {
             throw new Error('Manifest must have a version string.');
         }
-        const categories = ['agents', 'skills', 'hooks', 'kb'];
+        const categories = ['agents', 'skills', 'hooks', 'personas', 'kb'];
         for (const cat of categories) {
             if (!Array.isArray(manifest.definitions[cat])) {
                 throw new Error(`Manifest definitions.${cat} must be an array.`);
@@ -59,6 +59,7 @@ export class ManifestLoader {
             ...manifest.definitions.agents,
             ...manifest.definitions.skills,
             ...manifest.definitions.hooks,
+            ...manifest.definitions.personas,
             ...manifest.definitions.kb,
         ];
         for (const entry of allEntries) {
@@ -94,7 +95,7 @@ export class ManifestLoader {
     getAllEntries() {
         const manifest = this.load();
         const entries = [];
-        const categories = ['agents', 'skills', 'hooks', 'kb'];
+        const categories = ['agents', 'skills', 'hooks', 'personas', 'kb'];
         for (const cat of categories) {
             for (const entry of manifest.definitions[cat]) {
                 entries.push({ ...entry, category: cat });

package/dist/manifest/ManifestLoader.js.map

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

package/dist/manifest/types.d.ts

@@ -18,6 +18,7 @@ export interface ManifestSchema {
         agents: DefinitionEntry[];
         skills: DefinitionEntry[];
         hooks: DefinitionEntry[];
+        personas: DefinitionEntry[];
         kb: DefinitionEntry[];
     };
 }
@@ -35,6 +36,8 @@ export interface SeedResult {
         skillsFailed: number;
         hooksSeeded: number;
         hooksFailed: number;
+        personasSeeded: number;
+        personasFailed: number;
         kbSeeded: number;
         kbFailed: number;
     };

package/dist/manifest/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,6BAA6B,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;QACzB,EAAE,EAAE,eAAe,EAAE,CAAC;KACvB,CAAC;CACH;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAC;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,6BAA6B,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;QACzB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,EAAE,EAAE,eAAe,EAAE,CAAC;KACvB,CAAC;CACH;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAC;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/scripts/bundle-hooks.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+export interface BundledHook {
+    entryFile: string;
+    outputFile: string;
+}
+/**
+ * Lists TOP-LEVEL `.ts` files directly under `hooksDir` — never recursing
+ * into `lib/` (or any other subdirectory). `hooks/lib/*.ts` files are
+ * imported BY these entry points, not separate install-time artifacts once
+ * bundled (their code is inlined into whichever top-level bundle(s)
+ * reference them).
+ */
+export declare function discoverTopLevelHookEntryPoints(hooksDir: string): string[];
+/**
+ * Bundles ONE entry point to `outputPath` via esbuild, using the exact
+ * options the real build relies on (ESM + Node platform + the CJS-interop
+ * `require` shim banner — see module JSDoc for why each option is needed).
+ *
+ * IMPORTANT (empirically verified — TASK freshness-guard probe): esbuild's
+ * generated bytes depend on the ENTRY file's real on-disk path (its
+ * relative depth from `process.cwd()` affects both an embedded path comment
+ * and, less obviously, the generated CJS-interop helper call for `yaml`).
+ * Only `outputPath` is safe to redirect to a throwaway location — copying
+ * the `.ts` SOURCE to a different absolute path before bundling changes the
+ * output for reasons unrelated to source drift. Callers that need a
+ * freshness/drift check (bundle now, compare against a committed file) MUST
+ * bundle the entry from its real location and only redirect `outputPath`.
+ */
+export declare function bundleOneHook(entryPath: string, outputPath: string): void;
+/**
+ * Bundles every top-level hook entry point discovered under
+ * `<packageRoot>/hooks` into a co-located, self-contained `<name>.mjs` file.
+ * Pure side effect is writing those `.mjs` files (esbuild `buildSync`) —
+ * mirrors the `generateManifest`/`writeManifest` split in spirit (this
+ * module has no separate "pure" variant since bundling IS the write), but
+ * is safe to call repeatedly: each run fully regenerates its own outputs.
+ */
+export declare function bundleHooks(packageRoot?: string): BundledHook[];
+//# sourceMappingURL=bundle-hooks.d.ts.map

package/dist/scripts/bundle-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-hooks.d.ts","sourceRoot":"","sources":["../../src/scripts/bundle-hooks.ts"],"names":[],"mappings":";AA4FA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAYzE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,GAAE,MAA6B,GAAG,WAAW,EAAE,CAmBrF"}

package/dist/scripts/bundle-hooks.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+/**
+ * Build-time script: bundles every TOP-LEVEL hook entry point
+ * (`hooks/*.ts`, excluding `hooks/lib/*.ts`) into a self-contained ESM
+ * `.mjs` bundle, co-located next to its `.ts` source (RFC-040 installer,
+ * TASK-043 "hook bundling", inserted between Fase 9 and Fase 10).
+ *
+ * ROOT CAUSE this fixes (measured by the AC-008 probe re-run, Fase 9):
+ * `Materializer` stages manifested hook entries as bare TypeScript source
+ * (a raw text copy driven by `manifest.json`), and `HooksWirer` wires them
+ * as `npx tsx <target>/hooks/<hook>.ts`. On a genuinely fresh install
+ * target (no monorepo, no INTERIM/C6-TD-204 symlink farm masking this on a
+ * dev machine), every hook that imports a non-builtin package (`yaml`,
+ * `@orchestrator-claude/project-root-resolver`, transitively `glob` via
+ * `lib/finops-parser.ts` — verified empirically, NOT just the `yaml` +
+ * `project-root-resolver` surface originally hypothesized) crashes at
+ * import time with `MODULE_NOT_FOUND`, before the hook's own logic ever
+ * runs.
+ *
+ * BUILD-TIME vs INSTALL-TIME bundling (verify-before-assert decision):
+ * bundling happens HERE, as a `packages/definitions` build step (wired into
+ * `npm run build` / `prepublishOnly`, alongside the existing `tsc` +
+ * `generate-manifest` steps) — NOT inside `Materializer` at install-time.
+ * Reasons, confirmed by reading the package's real build/publish flow
+ * (`package.json` `build`/`prepublishOnly` scripts) before choosing:
+ *   1. `esbuild` bundling here needs to resolve `yaml` and the WORKSPACE
+ *      package `@orchestrator-claude/project-root-resolver` from
+ *      node_modules — reliably available inside this monorepo (where
+ *      `npm run build` always runs) but NOT guaranteed on an end user's
+ *      fresh install target (the exact absence that causes the bug).
+ *   2. A single deterministic bundle is produced once at publish time and
+ *      shipped as the actual package artifact (`hooks/*.mjs` is covered by
+ *      the existing `files: ["hooks", ...]` entry) — every `orch-defs
+ *      install` run then just copies pre-verified bytes (unchanged
+ *      `Materializer`/manifest-driven flow), instead of re-invoking esbuild
+ *      (and re-trusting whatever esbuild version happens to be installed)
+ *      on every end-user machine at install time.
+ *
+ * ESM + a `createRequire` banner shim (not CJS, not bare `.js`) — verified
+ * empirically, not by extension convention alone:
+ *   - `import.meta.url` (used by several hooks/libs for `__dirname`
+ *     derivation) is used natively and correctly ONLY in esbuild's `esm`
+ *     output format; the `cjs` format empties `import.meta` at build time
+ *     (esbuild's own documented behavior), which crashes
+ *     `fileURLToPath(import.meta.url)` at runtime (`ERR_INVALID_ARG_TYPE`,
+ *     confirmed empirically during this task's Verify-Before-Assert probe).
+ *   - `.mjs` (not bare `.js`) guarantees Node interprets the bundle as an ES
+ *     module regardless of Node version or the absence of any nearby
+ *     `package.json` `"type"` field at the install target (a bare `.js`
+ *     bundle's module-type is otherwise version-dependent on Node's
+ *     experimental CommonJS/ESM entry-point sniffing heuristic).
+ *   - `yaml` is a genuine CommonJs package (`"type": "commonjs"`) whose
+ *     internal modules `require()` Node builtins (e.g. `require('process')`
+ *     in `yaml/dist/compose/composer.js`). When esbuild bundles such a
+ *     lazily-wrapped CJS dependency into an `esm` bundle, its generated
+ *     `require()`-forwarding shim throws `Dynamic require of "..." is not
+ *     supported` at runtime UNLESS a real `require` function exists in
+ *     scope — confirmed empirically. The `banner` below injects exactly
+ *     that (`createRequire(import.meta.url)`), which resolves Node builtins
+ *     natively; this is the standard, documented esbuild fix for this exact
+ *     ESM+CJS-interop class of bug.
+ *
+ * `bundleHooks(packageRoot)` (like `generateManifest`) is written to be
+ * called directly from `scripts/sync-hook-mirrors.ts` in the future (its
+ * write-mode currently regenerates `manifest.json` after syncing hook
+ * mirrors but does NOT yet re-run this bundler — see the TASK-043
+ * implementation report's flagged follow-up finding, deliberately NOT
+ * fixed here to keep this fix's blast radius to the RFC-040 installer
+ * pipeline, per the "document, don't silently expand scope" rule).
+ *
+ * Usage: npx tsx src/scripts/bundle-hooks.ts
+ */
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import { resolve, join, dirname, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildSync } from 'esbuild';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_PACKAGE_ROOT = resolve(__dirname, '../..');
+/**
+ * esbuild's generated `require()`-forwarding shim throws `Dynamic require of
+ * "..." is not supported` for CJS dependencies (e.g. `yaml`) that `require()`
+ * a Node builtin from inside a lazily-invoked CommonJS wrapper, when the
+ * output format is `esm` and no real `require` exists at runtime. Injecting
+ * a real one via `createRequire` (Node's own documented mechanism) resolves
+ * this — verified empirically against every real distributable hook.
+ */
+const REQUIRE_SHIM_BANNER = "import { createRequire as __createRequireShim } from 'node:module'; " +
+    'const require = __createRequireShim(import.meta.url);';
+/**
+ * Lists TOP-LEVEL `.ts` files directly under `hooksDir` — never recursing
+ * into `lib/` (or any other subdirectory). `hooks/lib/*.ts` files are
+ * imported BY these entry points, not separate install-time artifacts once
+ * bundled (their code is inlined into whichever top-level bundle(s)
+ * reference them).
+ */
+export function discoverTopLevelHookEntryPoints(hooksDir) {
+    if (!existsSync(hooksDir)) {
+        return [];
+    }
+    return readdirSync(hooksDir)
+        .filter((name) => name.endsWith('.ts') && statSync(join(hooksDir, name)).isFile())
+        .sort();
+}
+/**
+ * Bundles ONE entry point to `outputPath` via esbuild, using the exact
+ * options the real build relies on (ESM + Node platform + the CJS-interop
+ * `require` shim banner — see module JSDoc for why each option is needed).
+ *
+ * IMPORTANT (empirically verified — TASK freshness-guard probe): esbuild's
+ * generated bytes depend on the ENTRY file's real on-disk path (its
+ * relative depth from `process.cwd()` affects both an embedded path comment
+ * and, less obviously, the generated CJS-interop helper call for `yaml`).
+ * Only `outputPath` is safe to redirect to a throwaway location — copying
+ * the `.ts` SOURCE to a different absolute path before bundling changes the
+ * output for reasons unrelated to source drift. Callers that need a
+ * freshness/drift check (bundle now, compare against a committed file) MUST
+ * bundle the entry from its real location and only redirect `outputPath`.
+ */
+export function bundleOneHook(entryPath, outputPath) {
+    buildSync({
+        entryPoints: [entryPath],
+        bundle: true,
+        platform: 'node',
+        format: 'esm',
+        target: 'node20',
+        banner: { js: REQUIRE_SHIM_BANNER },
+        sourcemap: false,
+        logLevel: 'silent',
+        outfile: outputPath,
+    });
+}
+/**
+ * Bundles every top-level hook entry point discovered under
+ * `<packageRoot>/hooks` into a co-located, self-contained `<name>.mjs` file.
+ * Pure side effect is writing those `.mjs` files (esbuild `buildSync`) —
+ * mirrors the `generateManifest`/`writeManifest` split in spirit (this
+ * module has no separate "pure" variant since bundling IS the write), but
+ * is safe to call repeatedly: each run fully regenerates its own outputs.
+ */
+export function bundleHooks(packageRoot = DEFAULT_PACKAGE_ROOT) {
+    const hooksDir = resolve(packageRoot, 'hooks');
+    const entryNames = discoverTopLevelHookEntryPoints(hooksDir);
+    const results = [];
+    for (const entryName of entryNames) {
+        const entryPath = join(hooksDir, entryName);
+        const outputName = `${basename(entryName, '.ts')}.mjs`;
+        const outputPath = join(hooksDir, outputName);
+        bundleOneHook(entryPath, outputPath);
+        results.push({
+            entryFile: `hooks/${entryName}`,
+            outputFile: `hooks/${outputName}`,
+        });
+    }
+    return results;
+}
+// ─── CLI Entry Guard ──────────────────────────────────────────────────────────
+const isCli = process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1];
+if (isCli) {
+    const results = bundleHooks();
+    console.log(`Bundled ${String(results.length)} hook(s):`);
+    for (const { entryFile, outputFile } of results) {
+        console.log(`  ${entryFile} -> ${outputFile}`);
+    }
+}
+//# sourceMappingURL=bundle-hooks.js.map

package/dist/scripts/bundle-hooks.js.map

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

package/dist/scripts/generate-manifest.d.ts

@@ -3,8 +3,27 @@
  * Build-time script: generates manifest.json with SHA256 checksums
  * for all definition files in the package.
  *
- * Usage: node --loader ts-node/esm src/scripts/generate-manifest.ts
- * Or:    npx tsx src/scripts/generate-manifest.ts
+ * generateManifest(packageRoot) is a PURE, in-memory computation (no writes) —
+ * safe to import from other packages/scripts (e.g. scripts/sync-hook-mirrors.ts,
+ * RFC-040/TD-204 follow-up) without triggering a manifest.json write as a side
+ * effect of module import. The CLI entry point (writeManifest + isCli guard,
+ * mirroring the pattern in scripts/sync-hook-mirrors.ts) performs the actual
+ * write and is the only thing that runs when this file is executed directly.
+ *
+ * Usage: npx tsx src/scripts/generate-manifest.ts
+ */
+import type { ManifestSchema } from '../manifest/types.js';
+/**
+ * Pure, in-memory computation of the definitions manifest for `packageRoot`.
+ * Performs NO writes — safe to call repeatedly (e.g. from a check-mode drift
+ * detector) without side effects. Defaults to this package's own root when
+ * called with no argument (preserves the original CLI behavior).
+ */
+export declare function generateManifest(packageRoot?: string): ManifestSchema;
+/**
+ * Thin writer: computes the manifest via generateManifest() and writes it to
+ * <packageRoot>/manifest.json. This is the only function in this module that
+ * performs I/O writes.
  */
-export {};
+export declare function writeManifest(packageRoot?: string): ManifestSchema;
 //# sourceMappingURL=generate-manifest.d.ts.map

package/dist/scripts/generate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/scripts/generate-manifest.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}
+{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/scripts/generate-manifest.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAkF5E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,GAAE,MAA6B,GAAG,cAAc,CAuC3F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAA6B,GAAG,cAAc,CAKxF"}