@sun-asterisk/sungen 3.2.35 → 3.3.0-alpha.10

package/dist/orchestrator/ai-skills/command-partial-includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-partial-includes.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/command-partial-includes.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAE1C,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjD;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAS5E;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CASzH"}

package/dist/orchestrator/ai-skills/command-partial-includes.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialError = exports.REQUIRED_INCLUDES = void 0;
+exports.includesOf = includesOf;
+exports.assertRequiredIncludes = assertRequiredIncludes;
+exports.expandIncludes = expandIncludes;
+/**
+ * Per-assistant partials for command templates (P0.1, root cause c).
+ *
+ * A command pulls a shared block in with an explicit directive on its own line:
+ *
+ *   <!-- include: hand-back-rule -->
+ *
+ * and each assistant gets its OWN twin file — `templates/ai-src/partials/<name>.<adapter>.md` —
+ * chosen here by file name, never by branching inside the content (Claude asks with
+ * AskUserQuestion; Copilot/Codex have no such tool and end with a numbered list instead).
+ *
+ * Fails loud, like cap-fences: an unknown partial, a twin missing for one assistant, or a command
+ * without a REQUIRED include throws — a typo can never ship a command that silently lacks the rule.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const PARTIALS_DIR = path.resolve(__dirname, '..', 'templates', 'ai-src', 'partials');
+/** Every command must include these. The hand-back rule is the reason this module exists. */
+exports.REQUIRED_INCLUDES = ['hand-back-rule'];
+const DIRECTIVE = /^[ \t]*<!--\s*include:\s*([a-z0-9-]+)\s*-->[ \t]*$/;
+class PartialError extends Error {
+}
+exports.PartialError = PartialError;
+/** Partial names a body includes, in order of appearance. */
+function includesOf(body) {
+    const out = [];
+    for (const line of body.split('\n')) {
+        const m = line.match(DIRECTIVE);
+        if (m)
+            out.push(m[1]);
+    }
+    return out;
+}
+/** Throws when a command lacks a required include — the build-time gate. */
+function assertRequiredIncludes(body, commandId) {
+    const have = new Set(includesOf(body));
+    const missing = exports.REQUIRED_INCLUDES.filter((name) => !have.has(name));
+    if (missing.length > 0) {
+        throw new PartialError(`commands/${commandId}.md: missing required <!-- include: ${missing.join(' -->, <!-- include: ')} --> `
+            + '(every command carries the next-step hand-back rule; see ai-skills/command-partial-includes.ts)');
+    }
+}
+function readPartial(name, adapter, commandId) {
+    const file = path.join(PARTIALS_DIR, `${name}.${adapter}.md`);
+    if (!fs.existsSync(file)) {
+        throw new PartialError(`commands/${commandId}.md: <!-- include: ${name} --> has no partials/${name}.${adapter}.md`);
+    }
+    // A trailing newline is the file's, not the block's: the directive line's own break follows it.
+    return fs.readFileSync(file, 'utf8').replace(/\n+$/, '');
+}
+/**
+ * Replace each directive line with the adapter's partial, substituting `{{var}}` placeholders from
+ * `vars`. A placeholder with no value is an authoring error and fails loud.
+ */
+function expandIncludes(body, adapter, commandId, vars) {
+    return body.split('\n').map((line) => {
+        const m = line.match(DIRECTIVE);
+        if (!m)
+            return line;
+        return readPartial(m[1], adapter, commandId).replace(/\{\{(\w+)\}\}/g, (_all, key) => {
+            if (!(key in vars))
+                throw new PartialError(`partials/${m[1]}.${adapter}.md: unknown placeholder {{${key}}}`);
+            return vars[key];
+        });
+    }).join('\n');
+}
+//# sourceMappingURL=command-partial-includes.js.map

package/dist/orchestrator/ai-skills/command-partial-includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-partial-includes.js","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/command-partial-includes.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/ai-skills/commands.d.ts

@@ -1,4 +1,5 @@
 import { GenFile } from './generator';
+import type { AdapterKey } from './adapters';
 export interface CommandSource {
     id: string;
     name: string;
@@ -8,6 +9,8 @@ export interface CommandSource {
     claudeTools: string;
     copilotTools: string;
     codexTrigger: string;
+    /** What `{{unitArg}}` renders as inside a partial — the unit placeholder the command takes. */
+    unitArg: string;
     body: string;
 }
 /** Parse a source command file into a CommandSource. */
@@ -18,5 +21,6 @@ export declare function renderClaudeCommand(c: CommandSource): string;
 export declare function renderCopilotCommand(c: CommandSource): string;
 /** Codex command-skill — command folds into a skill with an explicit trigger (decision P2). */
 export declare function renderCodexCommand(c: CommandSource): string;
-export declare function generateCommand(c: CommandSource, adapter: 'claude' | 'copilot' | 'codex'): GenFile;
+/** The build path: a command that lacks a required include never renders (fails loud). */
+export declare function generateCommand(c: CommandSource, adapter: AdapterKey): GenFile;
 //# sourceMappingURL=commands.d.ts.map

package/dist/orchestrator/ai-skills/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/commands.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CA2B1E;AAMD,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAU5D;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW7D;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW3D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAIlG"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/commands.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CA4B1E;AASD,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAU5D;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW7D;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW3D;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAK9E"}

package/dist/orchestrator/ai-skills/commands.js

@@ -19,10 +19,13 @@ exports.generateCommand = generateCommand;
  *   claude-tools: "Read, Grep, ..."          # verbatim allowed-tools line for Claude
  *   codex-trigger: "Run when the user asks to ..."   # explicit trigger for Codex (P2 mitigation)
  *   copilot-tools: "[vscode, execute, ...]"  # optional; default used if absent
+ *   unit-arg: "<screen-name>"                # optional; fills {{unitArg}} in partials (default <unit>)
  *   ---
+ *   <!-- include: hand-back-rule -->         # REQUIRED — see command-partial-includes.ts
  *   <body with cap-fences>
  */
 const cap_stripper_1 = require("./cap-stripper");
+const command_partial_includes_1 = require("./command-partial-includes");
 const DEFAULT_COPILOT_TOOLS = '[vscode, execute, read, edit, search, todo]';
 /** Parse a source command file into a CommandSource. */
 function parseCommandSource(text, id) {
@@ -57,10 +60,13 @@ function parseCommandSource(text, id) {
         claudeTools: dec('claude-tools'),
         copilotTools: raw['copilot-tools'] ? dec('copilot-tools') : DEFAULT_COPILOT_TOOLS,
         codexTrigger: dec('codex-trigger'),
+        unitArg: dec('unit-arg') || '<unit>',
         body,
     };
 }
 const unquote = (s) => s.replace(/^['"]|['"]$/g, '');
+/** The body as one assistant sees it: its own partials pulled in, then its cap-fences resolved. */
+const bodyFor = (c, adapter, caps) => (0, cap_stripper_1.stripCaps)((0, command_partial_includes_1.expandIncludes)(c.body, adapter, c.id, { unitArg: c.unitArg }), caps, `cmd:${c.id}`);
 /** A YAML single-quoted scalar: an apostrophe is written twice, or it ends the value early (#899). */
 const sq = (s) => `'${s.replace(/'/g, "''")}'`;
 /** Claude command file — MUST reproduce the exact existing format (byte-identical gate). */
@@ -73,7 +79,7 @@ function renderClaudeCommand(c) {
         `allowed-tools: ${c.claudeTools}`,
         '---',
     ].join('\n');
-    return fm + '\n\n' + (0, cap_stripper_1.stripCaps)(c.body, ['parallel-subagents'], `cmd:${c.id}`);
+    return fm + '\n\n' + bodyFor(c, 'claude', ['parallel-subagents']);
 }
 /** Copilot prompt file — re-derived (lenient). */
 function renderCopilotCommand(c) {
@@ -86,7 +92,7 @@ function renderCopilotCommand(c) {
         `tools: ${c.copilotTools}`,
         '---',
     ].join('\n');
-    return fm + '\n\n' + (0, cap_stripper_1.stripCaps)(c.body, [], `cmd:${c.id}`);
+    return fm + '\n\n' + bodyFor(c, 'copilot', []);
 }
 /** Codex command-skill — command folds into a skill with an explicit trigger (decision P2). */
 function renderCodexCommand(c) {
@@ -99,9 +105,11 @@ function renderCodexCommand(c) {
         ...(c.order != null ? [`order: ${c.order}`] : []),
         '---',
     ].join('\n');
-    return fm + '\n\n' + (0, cap_stripper_1.stripCaps)(c.body, [], `cmd:${c.id}`);
+    return fm + '\n\n' + bodyFor(c, 'codex', []);
 }
+/** The build path: a command that lacks a required include never renders (fails loud). */
 function generateCommand(c, adapter) {
+    (0, command_partial_includes_1.assertRequiredIncludes)(c.body, c.id);
     if (adapter === 'claude')
         return { outputPath: `.claude/commands/sungen/${c.id}.md`, content: renderClaudeCommand(c) };
     if (adapter === 'copilot')

package/dist/orchestrator/ai-skills/commands.js.map

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

package/dist/orchestrator/assets-drift.d.ts

@@ -19,6 +19,11 @@ export interface AssetsDrift {
     total: number;
 }
 export declare function checkAssetsDrift(cwd: string): AssetsDrift | null;
+/**
+ * The note's text. The update command is the one this project runs (`npx sungen` with a local install)
+ * on the channel it runs (`--alpha` / `--beta`): a plain `sungen update` would switch to stable (#939).
+ */
+export declare function assetsDriftNote(drift: AssetsDrift, cwd: string, paint?: (cmd: string) => string): string;
 /** One line, on stderr so `--json` output stays machine-readable. */
 export declare function warnAssetsDrift(cwd: string): void;
 //# sourceMappingURL=assets-drift.d.ts.map

package/dist/orchestrator/assets-drift.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets-drift.d.ts","sourceRoot":"","sources":["../../src/orchestrator/assets-drift.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4BhE;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWjD"}
+{"version":3,"file":"assets-drift.d.ts","sourceRoot":"","sources":["../../src/orchestrator/assets-drift.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4BhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAiB,GAAG,MAAM,CAIlH;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOjD"}

package/dist/orchestrator/assets-drift.js

@@ -34,11 +34,13 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkAssetsDrift = checkAssetsDrift;
+exports.assetsDriftNote = assetsDriftNote;
 exports.warnAssetsDrift = warnAssetsDrift;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const package_info_1 = require("../exporters/package-info");
 const config_file_1 = require("../harness/config-file");
+const project_sungen_invocation_1 = require("../cli/project-sungen-invocation");
 function checkAssetsDrift(cwd) {
     const manifestPath = path.join(cwd, '.sungen', 'manifest.json');
     if (!fs.existsSync(manifestPath))
@@ -70,6 +72,15 @@ function checkAssetsDrift(cwd) {
     }
     return { recordedVersion, runningVersion, changed, total };
 }
+/**
+ * The note's text. The update command is the one this project runs (`npx sungen` with a local install)
+ * on the channel it runs (`--alpha` / `--beta`): a plain `sungen update` would switch to stable (#939).
+ */
+function assetsDriftNote(drift, cwd, paint = (c) => c) {
+    return `note: this project's AI commands/skills were written by sungen ${drift.recordedVersion}, ` +
+        `you are running ${drift.runningVersion} — run ${paint((0, project_sungen_invocation_1.updateCommand)(cwd, drift.runningVersion))} to refresh them ` +
+        '(upgrading the package alone does not).';
+}
 /** One line, on stderr so `--json` output stays machine-readable. */
 function warnAssetsDrift(cwd) {
     const drift = checkAssetsDrift(cwd);
@@ -78,8 +89,6 @@ function warnAssetsDrift(cwd) {
     const gray = '\x1b[90m';
     const cyan = '\x1b[36m';
     const reset = '\x1b[0m';
-    process.stderr.write(`${gray}note: this project's AI commands/skills were written by sungen ${drift.recordedVersion}, ` +
-        `you are running ${drift.runningVersion} — run ${cyan}sungen update${reset}${gray} to refresh them ` +
-        `(upgrading the package alone does not).${reset}\n`);
+    process.stderr.write(`${gray}${assetsDriftNote(drift, cwd, (c) => `${cyan}${c}${reset}${gray}`)}${reset}\n`);
 }
 //# sourceMappingURL=assets-drift.js.map

package/dist/orchestrator/assets-drift.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets-drift.js","sourceRoot":"","sources":["../../src/orchestrator/assets-drift.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,4CA4BC;AAGD,0CAWC;AApED,uCAAyB;AACzB,2CAA6B;AAC7B,4DAA8D;AAC9D,wDAA8E;AAuB9E,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC,CAAG,6BAA6B;IAE9E,MAAM,IAAI,GAAG,IAAA,4BAAc,EAAyD,YAAY,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QAChC,0FAA0F;QAC1F,6FAA6F;QAC7F,oFAAoF;QACpF,IAAA,kCAAoB,EAAC,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,2EAA2E,CAAC,CAAC;QAC5H,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAC5B,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAA,gCAAiB,GAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,CAAC,eAAe,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,2EAA2E;IAC3E,IAAI,eAAe,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAEpD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED,qEAAqE;AACrE,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,kEAAkE,KAAK,CAAC,eAAe,IAAI;QAClG,mBAAmB,KAAK,CAAC,cAAc,UAAU,IAAI,gBAAgB,KAAK,GAAG,IAAI,mBAAmB;QACpG,0CAA0C,KAAK,IAAI,CACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"assets-drift.js","sourceRoot":"","sources":["../../src/orchestrator/assets-drift.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,4CA4BC;AAMD,0CAIC;AAGD,0CAOC;AA3ED,uCAAyB;AACzB,2CAA6B;AAC7B,4DAA8D;AAC9D,wDAA8E;AAC9E,gFAAiE;AAuBjE,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC,CAAG,6BAA6B;IAE9E,MAAM,IAAI,GAAG,IAAA,4BAAc,EAAyD,YAAY,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QAChC,0FAA0F;QAC1F,6FAA6F;QAC7F,oFAAoF;QACpF,IAAA,kCAAoB,EAAC,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,2EAA2E,CAAC,CAAC;QAC5H,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAC5B,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAA,gCAAiB,GAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,CAAC,eAAe,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,2EAA2E;IAC3E,IAAI,eAAe,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAEpD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAkB,EAAE,GAAW,EAAE,QAAiC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxG,OAAO,kEAAkE,KAAK,CAAC,eAAe,IAAI;QAChG,mBAAmB,KAAK,CAAC,cAAc,UAAU,KAAK,CAAC,IAAA,yCAAa,EAAC,GAAG,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,mBAAmB;QACnH,yCAAyC,CAAC;AAC9C,CAAC;AAED,qEAAqE;AACrE,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAC/G,CAAC"}

package/dist/orchestrator/claude-hooks-install.d.ts

@@ -0,0 +1,27 @@
+import type { SungenHook } from '../hooks/hook-result-contract';
+export declare const LAUNCHER_REL: string;
+/** The launcher as the hook entry names it: Claude Code substitutes the placeholder, no shell does. */
+export declare const LAUNCHER_ARG = "${CLAUDE_PROJECT_DIR}/.claude/hooks/sungen-hook.cjs";
+type Settings = Record<string, unknown> & {
+    hooks?: Record<string, unknown>;
+};
+export interface HooksInstallReport {
+    settings: 'created' | 'updated' | 'unchanged' | 'unreadable';
+    launcher: 'written' | 'unchanged' | 'removed' | 'absent';
+    /** Hooks registered after this run. */
+    installed: string[];
+    /** sungen entries no longer registered (stale, or turned off). */
+    removed: number;
+    /** The backup written THIS run (only the first change writes one). */
+    backup?: string;
+    error?: string;
+}
+/** Pure: every sungen-owned entry removed, the wanted hooks appended, everything else as it was. */
+export declare function mergeSungenHooks(settings: Settings, wanted: SungenHook[]): Settings;
+export declare function installClaudeHooks(cwd: string, opts?: {
+    dryRun?: boolean;
+}): HooksInstallReport;
+/** One summary line for init/update output. */
+export declare function describeHooksInstall(r: HooksInstallReport): string;
+export {};
+//# sourceMappingURL=claude-hooks-install.d.ts.map

package/dist/orchestrator/claude-hooks-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hooks-install.d.ts","sourceRoot":"","sources":["../../src/orchestrator/claude-hooks-install.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,eAAO,MAAM,YAAY,QAAmD,CAAC;AAC7E,uGAAuG;AACvG,eAAO,MAAM,YAAY,wDAAwD,CAAC;AAOlF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAS9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7D,QAAQ,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzD,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAqBnF;AAyBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,kBAAkB,CAiDnG;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAKlE"}

package/dist/orchestrator/claude-hooks-install.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAUNCHER_ARG = exports.LAUNCHER_REL = void 0;
+exports.mergeSungenHooks = mergeSungenHooks;
+exports.installClaudeHooks = installClaudeHooks;
+exports.describeHooksInstall = describeHooksInstall;
+/**
+ * Install sungen's Claude Code hooks into `.claude/settings.json` — by MERGING (P0.1, takumi T1).
+ *
+ * A team commits that file, so it holds the user's own hooks, permissions and env. The installer
+ * owns exactly one thing in it: hook entries that run the sungen launcher
+ * (`.claude/hooks/sungen-hook.cjs`, matched exactly — a user's `my-sungen-hook.cjs` is not ours).
+ * Each run removes every such entry and appends the wanted ones, so a hook turned off in
+ * `qa/sungen.config.yaml`, or dropped by a later version, leaves — and nothing else does. That is
+ * also the rollback path: `sungen update` takes out sungen's entries without touching anyone's.
+ *
+ * The first change backs the file up byte for byte, and that pristine backup is never overwritten;
+ * the file keeps its own indentation; an unreadable file is never rewritten; a run that changes
+ * nothing writes nothing.
+ *
+ * Entries use EXEC FORM — `{ command: 'node', args: ['${CLAUDE_PROJECT_DIR}/…/sungen-hook.cjs', hook] }`
+ * (Claude Code ≥ 2.1.139). No shell is involved and Claude Code substitutes the placeholder itself.
+ * A shell-form `node "$CLAUDE_PROJECT_DIR/…"` runs in PowerShell on Windows without Git Bash, where
+ * that variable is empty, and since 2.1.299 a FAILING shell-form PreToolUse hook there blocks every
+ * tool call. `onFailure` is left unset: its default (continue) is the fail-open one, and versions
+ * before 2.1.295 do not know the field.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const hook_registry_1 = require("../hooks/hook-registry");
+const hook_toggles_1 = require("../hooks/hook-toggles");
+const read_text_1 = require("../harness/read-text");
+const write_atomic_1 = require("../harness/write-atomic");
+exports.LAUNCHER_REL = path.join('.claude', 'hooks', 'sungen-hook.cjs');
+/** The launcher as the hook entry names it: Claude Code substitutes the placeholder, no shell does. */
+exports.LAUNCHER_ARG = '${CLAUDE_PROJECT_DIR}/.claude/hooks/sungen-hook.cjs';
+const SETTINGS_REL = path.join('.claude', 'settings.json');
+const BACKUP_SUFFIX = '.sungen-backup';
+const LAUNCHER_SRC = path.join(__dirname, 'templates', 'claude-hooks', 'sungen-hook.cjs');
+/** What marks an entry as sungen's: it runs exactly this launcher (exec form `args[0]` or a shell command). */
+const OWNED = /\.claude\/hooks\/sungen-hook\.cjs(?:["'\s]|$)/;
+const entriesOf = (g) => g && typeof g === 'object' && Array.isArray(g.hooks) ? g.hooks : null;
+const argsOf = (e) => (Array.isArray(e?.args) ? e.args.filter((a) => typeof a === 'string') : []);
+const isOwned = (e) => (typeof e?.command === 'string' && OWNED.test(e.command)) || OWNED.test(argsOf(e)[0] ?? '');
+const keyOf = (e) => [String(e?.command ?? ''), ...argsOf(e)].join(' ');
+function hookEntry(hook) {
+    return { type: 'command', command: 'node', args: [exports.LAUNCHER_ARG, hook.name], ...(hook.meta.timeout ? { timeout: hook.meta.timeout } : {}) };
+}
+/** Pure: every sungen-owned entry removed, the wanted hooks appended, everything else as it was. */
+function mergeSungenHooks(settings, wanted) {
+    const hooks = { ...(settings.hooks ?? {}) };
+    for (const [event, groups] of Object.entries(hooks)) {
+        if (!Array.isArray(groups))
+            continue; // readSettings refuses this shape; never rewrite it here
+        const kept = groups.flatMap((g) => {
+            const entries = entriesOf(g);
+            if (!entries || !entries.some(isOwned))
+                return [g];
+            const rest = entries.filter((e) => !isOwned(e));
+            return rest.length ? [{ ...g, hooks: rest }] : [];
+        });
+        if (kept.length || !groups.length)
+            hooks[event] = kept;
+        else
+            delete hooks[event];
+    }
+    for (const hook of wanted) {
+        for (const event of hook.meta.events) {
+            const matcher = hook.meta.matchers?.[event];
+            hooks[event] = [...(Array.isArray(hooks[event]) ? hooks[event] : []), { ...(matcher ? { matcher } : {}), hooks: [hookEntry(hook)] }];
+        }
+    }
+    const out = { ...settings };
+    if (Object.keys(hooks).length || settings.hooks !== undefined)
+        out.hooks = hooks;
+    return out;
+}
+const ownedKeys = (s) => Object.values(s.hooks ?? {})
+    .flatMap((groups) => (Array.isArray(groups) ? groups : []).flatMap((g) => entriesOf(g) ?? []))
+    .filter(isOwned).map(keyOf);
+/** The file's own indentation (a tab, or N spaces); 2 for a file that has none yet. */
+function indentOf(raw) {
+    const m = raw.match(/^[{[][^\S\n]*\r?\n([ \t]+)\S/);
+    if (!m)
+        return 2;
+    return m[1].startsWith('\t') ? '\t' : m[1].length;
+}
+function readSettings(file) {
+    const raw = (0, read_text_1.readTextFile)(file);
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        throw new Error('not a JSON object');
+    const hooks = parsed.hooks;
+    if (hooks !== undefined && (!hooks || typeof hooks !== 'object' || Array.isArray(hooks)))
+        throw new Error('"hooks" is not an object');
+    // An event that is not a list is a shape we cannot merge into without replacing it.
+    const odd = Object.entries(hooks ?? {}).find(([, groups]) => !Array.isArray(groups));
+    if (odd)
+        throw new Error(`"hooks.${odd[0]}" is not a list`);
+    return { settings: parsed, indent: indentOf(raw) };
+}
+function installClaudeHooks(cwd, opts = {}) {
+    const settingsPath = path.join(cwd, SETTINGS_REL);
+    const existed = fs.existsSync(settingsPath);
+    let current = {};
+    let indent = 2;
+    if (existed) {
+        try {
+            ({ settings: current, indent } = readSettings(settingsPath));
+        }
+        catch (e) {
+            return { settings: 'unreadable', launcher: 'absent', installed: [], removed: 0, error: `${SETTINGS_REL}: ${e.message.split('\n')[0]}` };
+        }
+    }
+    const off = (0, hook_toggles_1.configDisabledHooks)(cwd);
+    const wanted = off === 'all' ? [] : (0, hook_registry_1.allHooks)().filter((h) => !off.has(h.name));
+    const merged = mergeSungenHooks(current, wanted);
+    const after = ownedKeys(merged);
+    const changed = existed ? JSON.stringify(merged) !== JSON.stringify(current) : wanted.length > 0;
+    const report = {
+        settings: !changed ? 'unchanged' : existed ? 'updated' : 'created',
+        launcher: 'absent',
+        installed: wanted.map((h) => h.name),
+        removed: ownedKeys(current).filter((k) => !after.includes(k)).length,
+    };
+    const launcherPath = path.join(cwd, exports.LAUNCHER_REL);
+    const onDisk = fs.existsSync(launcherPath) ? fs.readFileSync(launcherPath, 'utf8') : null;
+    const src = wanted.length ? fs.readFileSync(LAUNCHER_SRC, 'utf8') : null;
+    if (src !== null)
+        report.launcher = onDisk === src ? 'unchanged' : 'written';
+    else if (onDisk !== null)
+        report.launcher = 'removed';
+    if (opts.dryRun)
+        return report;
+    const writeSettings = () => {
+        if (!changed)
+            return;
+        fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+        const backup = settingsPath + BACKUP_SUFFIX;
+        if (existed && !fs.existsSync(backup)) { // keep the pristine original: never overwrite it
+            fs.copyFileSync(settingsPath, backup);
+            report.backup = SETTINGS_REL + BACKUP_SUFFIX;
+        }
+        (0, write_atomic_1.writeFileAtomic)(settingsPath, `${JSON.stringify(merged, null, indent)}\n`);
+    };
+    // settings.json must never point at a launcher that is not there: install the launcher BEFORE the
+    // entries that run it, and remove it only AFTER the entries are gone.
+    if (src !== null) {
+        if (onDisk !== src) {
+            fs.mkdirSync(path.dirname(launcherPath), { recursive: true });
+            (0, write_atomic_1.writeFileAtomic)(launcherPath, src);
+        }
+        writeSettings();
+    }
+    else {
+        writeSettings();
+        if (onDisk !== null)
+            fs.rmSync(launcherPath, { force: true });
+    }
+    return report;
+}
+/** One summary line for init/update output. */
+function describeHooksInstall(r) {
+    if (r.settings === 'unreadable')
+        return `${r.error} — Claude Code hooks not installed; fix the JSON and re-run`;
+    const what = r.installed.length ? `Claude Code hooks: ${r.installed.join(', ')}` : 'Claude Code hooks: none (turned off in qa/sungen.config.yaml)';
+    const extra = [r.removed ? `${r.removed} stale removed` : '', r.backup ? `backup ${r.backup}` : ''].filter(Boolean).join(', ');
+    return `${SETTINGS_REL} (${what}${extra ? `; ${extra}` : ''})`;
+}
+//# sourceMappingURL=claude-hooks-install.js.map

package/dist/orchestrator/claude-hooks-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hooks-install.js","sourceRoot":"","sources":["../../src/orchestrator/claude-hooks-install.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,4CAqBC;AAyBD,gDAiDC;AAGD,oDAKC;AAvKD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,0DAAkD;AAClD,wDAA4D;AAE5D,oDAAoD;AACpD,0DAA0D;AAE7C,QAAA,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC7E,uGAAuG;AAC1F,QAAA,YAAY,GAAG,qDAAqD,CAAC;AAClF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;AAC1F,+GAA+G;AAC/G,MAAM,KAAK,GAAG,+CAA+C,CAAC;AAI9D,MAAM,SAAS,GAAG,CAAC,CAAU,EAAkB,EAAE,CAC/C,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,CAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACzH,MAAM,MAAM,GAAG,CAAC,CAAQ,EAAY,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChI,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAW,EAAE,CACpC,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9F,MAAM,KAAK,GAAG,CAAC,CAAQ,EAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAcvF,SAAS,SAAS,CAAC,IAAgB;IACjC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,oBAAY,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7I,CAAC;AAED,oGAAoG;AACpG,SAAgB,gBAAgB,CAAC,QAAkB,EAAE,MAAoB;IACvE,MAAM,KAAK,GAA4B,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,yDAAyD;QAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAI,CAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;;YAAM,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;YAC5C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACpJ,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACjF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAW,EAAY,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;KACtE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAC7F,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAE9B,uFAAuF;AACvF,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,GAAG,GAAG,IAAA,wBAAY,EAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzG,MAAM,KAAK,GAAI,MAAmB,CAAC,KAAK,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtI,oFAAoF;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,IAAI,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC5D,OAAO,EAAE,QAAQ,EAAE,MAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAW,EAAE,OAA6B,EAAE;IAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAoB,CAAC,CAAC;IAChC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAC/E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,YAAY,KAAM,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACrJ,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,wBAAQ,GAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACjG,MAAM,MAAM,GAAuB;QACjC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAClE,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;KACrE,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAY,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;SACxE,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IACtD,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAE/B,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;QAC5C,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,iDAAiD;YACxF,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;QAC/C,CAAC;QACD,IAAA,8BAAe,EAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC;IACF,kGAAkG;IAClG,sEAAsE;IACtE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,IAAA,8BAAe,EAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QAC1H,aAAa,EAAE,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,aAAa,EAAE,CAAC;QAChB,IAAI,MAAM,KAAK,IAAI;YAAE,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,SAAgB,oBAAoB,CAAC,CAAqB;IACxD,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY;QAAE,OAAO,GAAG,CAAC,CAAC,KAAK,6DAA6D,CAAC;IAChH,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,+DAA+D,CAAC;IACnJ,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/H,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;AACjE,CAAC"}

package/dist/orchestrator/lockstep-version.d.ts

@@ -12,11 +12,21 @@ export declare function coreVersion(): string;
 /**
  * Resolve the version to install for a family package, given the running `core` version.
  *
- * Lockstep wants the EXACT `core` version. But the beta channel publishes `<core>-beta.N` before a
- * stable `<core>` ever exists — so a released core (e.g. 3.2.10) asking for `@3.2.10` hits ETARGET
- * out-of-the-box when npm only has `3.2.10-beta.2` (`sungen capability add` then fails for a fresh
- * user). Fall back on the SAME version line: prefer exact `core`, else the highest `core-beta.N`,
- * else the `beta` dist-tag as a last resort. Keeps the driver's pinned core-dep on the same line.
+ * Lockstep wants the EXACT `core` version. But the prerelease channels publish `<core>-beta.N`
+ * (beta branch) and `<core>-alpha.N` (alpha branch) before a stable `<core>` ever exists — so a
+ * released core (e.g. 3.2.10) asking for `@3.2.10` hits ETARGET out-of-the-box when npm only has
+ * `3.2.10-beta.2` (`sungen capability add` then fails for a fresh user). Fall back on the SAME
+ * version line — see `pickDriverVersion`. Keeps the driver's pinned core-dep on the same line.
  */
 export declare function resolveDriverVersion(pkg: string, core: string): string;
+/**
+ * Pick from a package's published `versions`: the exact `core`, else the highest same-line
+ * prerelease of core's OWN channel, else that channel's dist-tag. The channel is `alpha` for an
+ * alpha core and `beta` for any other (stable or beta): a stable or beta core never takes an alpha
+ * driver — alpha builds are the next big update, and an alpha driver pins an alpha core.
+ *
+ * The line is core without its prerelease suffix (as `sameVersionLine` in capabilities/discover.ts
+ * reads it), so `3.3.0-alpha.4` with no exact driver still finds `3.3.0-alpha.3`.
+ */
+export declare function pickDriverVersion(versions: readonly string[], core: string): string;
 //# sourceMappingURL=lockstep-version.d.ts.map

package/dist/orchestrator/lockstep-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lockstep-version.d.ts","sourceRoot":"","sources":["../../src/orchestrator/lockstep-version.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,sGAAsG;AACtG,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBtE"}
+{"version":3,"file":"lockstep-version.d.ts","sourceRoot":"","sources":["../../src/orchestrator/lockstep-version.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,sGAAsG;AACtG,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnF"}