@sun-asterisk/sungen 3.2.34-beta.1 → 3.3.0-alpha.1

package/dist/hooks/pre-tool-guard-hook.js

@@ -0,0 +1,105 @@
+"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.preToolGuardHook = exports.GUARD_RULES = exports.meta = void 0;
+exports.evaluateGuard = evaluateGuard;
+/**
+ * Claude Code PreToolUse guard — approval artifacts are not the agent's to write (P0.1, takumi T4).
+ *
+ * `qa/**\/contracts.lock.yaml` and the decision records record what a HUMAN approved; they change
+ * only through the TTY path. For other assistants that is a soft barrier (git HEAD comparison,
+ * in-run flags). In Claude Code this hook makes it a hard floor — see guard-rules.ts for what each
+ * rule denies or asks, and guard-protected-paths.ts for the paths.
+ *
+ * The guard cannot be switched off by the agent it guards: `qa/sungen.config.yaml` does not disable
+ * it (only SUNGEN_HOOKS / SUNGEN_HOOK_PRE_TOOL_GUARD in the real environment do), and an agent edit
+ * of the files that control the hooks asks the user. The human path is editing those files by
+ * hand, then `sungen update`.
+ *
+ * The decision is a list of rules — the extension point. Phase 06 added two: no `sungen delivery`
+ * while the Test Contract verdict rebuilt from .feature + lock + git HEAD is not pass
+ * (guard-delivery-contract-rule.ts — it READS project state, so it declares `onError: 'ask'` and a
+ * read failure asks instead of denying blind), and ask before a human-confirmed command is run
+ * through a terminal emulator (guard-tty-spoof-rule.ts).
+ */
+const path = __importStar(require("path"));
+const hook_result_contract_1 = require("./hook-result-contract");
+const guard_rules_1 = require("./guard-rules");
+const guard_delivery_contract_rule_1 = require("./guard-delivery-contract-rule");
+const guard_tty_spoof_rule_1 = require("./guard-tty-spoof-rule");
+exports.meta = {
+    events: ['PreToolUse'],
+    matchers: { PreToolUse: 'Edit|Write|MultiEdit|Bash' },
+    timeout: 5,
+};
+/** The rules, in order (first deny wins, else first ask). */
+exports.GUARD_RULES = [guard_rules_1.protectedApprovalPaths, guard_rules_1.protectedHookControl, guard_rules_1.bashProtectedMention, guard_tty_spoof_rule_1.ttySpoof, guard_delivery_contract_rule_1.deliveryContractVerdict];
+/** First deny wins; otherwise the first ask; otherwise ok. */
+function evaluateGuard(call, ctx, rules = exports.GUARD_RULES) {
+    let ask = null;
+    for (const rule of rules) {
+        let r;
+        try {
+            r = rule.check(call, ctx);
+        }
+        catch {
+            if (rule.onError === 'ask')
+                ask ?? (ask = { status: 'ask', askReason: `sungen guard (${rule.id}) could not read the project state it decides on — confirm this call yourself.` });
+            continue;
+        }
+        if (r?.status === 'deny')
+            return r;
+        if (r?.status === 'ask')
+            ask ?? (ask = r);
+    }
+    return ask ?? { status: 'ok' };
+}
+const GUARDED_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'Bash']);
+exports.preToolGuardHook = {
+    name: 'pre-tool-guard',
+    meta: exports.meta,
+    // A payload too large to read (an agent can build one with a huge Write) is not a free pass.
+    onUnreadableInput: { status: 'ask', askReason: 'sungen guard: this tool call is too large to inspect — confirm it yourself.' },
+    run(input, ctx) {
+        const tool = typeof input.tool_name === 'string' ? input.tool_name : '';
+        if (!GUARDED_TOOLS.has(tool))
+            return hook_result_contract_1.NO_OP;
+        const ti = input.tool_input && typeof input.tool_input === 'object' ? input.tool_input : {};
+        const filePaths = tool !== 'Bash' && typeof ti.file_path === 'string' && ti.file_path ? [path.resolve(ctx.cwd, ti.file_path)] : [];
+        const bashCommand = tool === 'Bash' && typeof ti.command === 'string' ? ti.command : undefined;
+        return evaluateGuard({ tool, filePaths, bashCommand, cwd: ctx.cwd }, ctx);
+    },
+};
+//# sourceMappingURL=pre-tool-guard-hook.js.map

package/dist/hooks/pre-tool-guard-hook.js.map

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

package/dist/hooks/session-start-unit-state-hook.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Code SessionStart hook — a new, resumed or compacted session starts knowing where the unit
+ * stands (P0.1, takumi T1).
+ *
+ * After `/clear` or a context compaction the agent has lost the thread: it re-derives the state
+ * from memory, or worse, re-runs work that is already done. This injects what `sungen next`
+ * derives for the session's unit (the one cwd sits in, else the most recently active): what the
+ * project already holds — stated as "do not redo" — the audit verdict, and the next steps.
+ */
+import { HookMeta, SungenHook } from './hook-result-contract';
+export declare const meta: HookMeta;
+export declare const sessionStartUnitStateHook: SungenHook;
+//# sourceMappingURL=session-start-unit-state-hook.d.ts.map

package/dist/hooks/session-start-unit-state-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start-unit-state-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start-unit-state-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAS,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKrE,eAAO,MAAM,IAAI,EAAE,QAIlB,CAAC;AAgBF,eAAO,MAAM,yBAAyB,EAAE,UAmBvC,CAAC"}

package/dist/hooks/session-start-unit-state-hook.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionStartUnitStateHook = exports.meta = void 0;
+/**
+ * Claude Code SessionStart hook — a new, resumed or compacted session starts knowing where the unit
+ * stands (P0.1, takumi T1).
+ *
+ * After `/clear` or a context compaction the agent has lost the thread: it re-derives the state
+ * from memory, or worse, re-runs work that is already done. This injects what `sungen next`
+ * derives for the session's unit (the one cwd sits in, else the most recently active): what the
+ * project already holds — stated as "do not redo" — the audit verdict, and the next steps.
+ */
+const hook_result_contract_1 = require("./hook-result-contract");
+const hand_back_core_1 = require("./hand-back-core");
+const sungen_project_root_1 = require("./sungen-project-root");
+exports.meta = {
+    events: ['SessionStart'],
+    matchers: { SessionStart: 'startup|resume|clear|compact' },
+    timeout: 10,
+};
+/** What the unit already holds, in workflow order. */
+function held(s) {
+    const items = [
+        s.hasSpec && 'spec', s.hasViewpoint && 'test-viewpoint',
+        s.kind === 'flow' && s.hasContract && (s.hasFlowInventory ? 'flow contract + inventory' : 'flow contract'),
+        s.scenarioCount > 0 && `${s.scenarioCount} scenario(s)`,
+        s.hasSelectors && !s.selectorsArePlaceholder && 'selectors',
+        s.compiled && 'compiled spec',
+        s.hasResults && `run results${s.failedCount ? ` (${s.failedCount} failed)` : ''}`,
+        s.hasDeliverable && 'deliverable',
+    ].filter(Boolean);
+    return items.length ? items.join(' · ') : 'nothing yet';
+}
+exports.sessionStartUnitStateHook = {
+    name: 'session-start-unit-state',
+    meta: exports.meta,
+    run(input, ctx) {
+        const found = (0, hand_back_core_1.locateUnitState)(ctx);
+        if (!found)
+            return hook_result_contract_1.NO_OP;
+        const { root, unit, state } = found;
+        const others = (0, sungen_project_root_1.listUnits)(root).length - 1;
+        const lines = [
+            `[sungen] Unit in progress: ${unit.name} (${unit.kind})${others > 0 ? ` — the project holds ${others} other unit(s)` : ''}.`,
+            `Already done — do not redo: ${held(state)}.`,
+            state.audit ? `Audit: ${state.audit.overall}/10 [${state.audit.gateStatus}] · ${state.audit.findings.length} finding(s).` : '',
+            `Next (\`sungen next ${unit.name}\`, derived from the project state):`,
+            ...(0, hand_back_core_1.formatSteps)(state.steps),
+            input.source === 'compact' ? 'Context was compacted: re-read the unit\'s files before acting on them.' : '',
+            others > 0 ? 'Working on another unit? Ask `sungen next <unit>` (or `sungen next` for all).' : '',
+        ];
+        return { status: 'context', output: lines.filter(Boolean).join('\n') };
+    },
+};
+//# sourceMappingURL=session-start-unit-state-hook.js.map

package/dist/hooks/session-start-unit-state-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start-unit-state-hook.js","sourceRoot":"","sources":["../../src/hooks/session-start-unit-state-hook.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,iEAAqE;AACrE,qDAAgE;AAChE,+DAAkD;AAGrC,QAAA,IAAI,GAAa;IAC5B,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,QAAQ,EAAE,EAAE,YAAY,EAAE,8BAA8B,EAAE;IAC1D,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,sDAAsD;AACtD,SAAS,IAAI,CAAC,CAAY;IACxB,MAAM,KAAK,GAAG;QACZ,CAAC,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC,YAAY,IAAI,gBAAgB;QACvD,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,eAAe,CAAC;QAC1G,CAAC,CAAC,aAAa,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,aAAa,cAAc;QACvD,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,uBAAuB,IAAI,WAAW;QAC3D,CAAC,CAAC,QAAQ,IAAI,eAAe;QAC7B,CAAC,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QACjF,CAAC,CAAC,cAAc,IAAI,aAAa;KAClC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;AAC1D,CAAC;AAEY,QAAA,yBAAyB,GAAe;IACnD,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAJ,YAAI;IACJ,GAAG,CAAC,KAAK,EAAE,GAAG;QACZ,MAAM,KAAK,GAAG,IAAA,gCAAe,EAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,4BAAK,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QACpC,MAAM,MAAM,GAAG,IAAA,+BAAS,EAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG;YACZ,8BAA8B,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,MAAM,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG;YAC5H,+BAA+B,IAAI,CAAC,KAAK,CAAC,GAAG;YAC7C,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,QAAQ,KAAK,CAAC,KAAK,CAAC,UAAU,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE;YAC9H,uBAAuB,IAAI,CAAC,IAAI,sCAAsC;YACtE,GAAG,IAAA,4BAAW,EAAC,KAAK,CAAC,KAAK,CAAC;YAC3B,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,yEAAyE,CAAC,CAAC,CAAC,EAAE;YAC3G,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,+EAA+E,CAAC,CAAC,CAAC,EAAE;SAClG,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACzE,CAAC;CACF,CAAC"}

package/dist/hooks/stop-next-step-hook.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code Stop hook — a turn that ran sungen work never ends without the next step (P0.1).
+ *
+ * A slash command has no CLI exit, so the CLI's `Next: sungen next …` footer cannot reach a session
+ * that ends inside `/sungen:create-test`; the hand-back rule in the command template is only an
+ * instruction. This makes it deterministic for Claude Code: when the turn that just ended ran
+ * sungen and did not hand back (no AskUserQuestion after the last sungen call), the hand-back core's
+ * answer is injected as context and Claude continues once to present it.
+ *
+ * Loop-safe: `stop_hook_active` (Claude Code is already continuing because of a stop hook) is a
+ * no-op, and so is anything the hook cannot read — a missing transcript, a non-sungen directory.
+ */
+import { HookMeta, SungenHook } from './hook-result-contract';
+export declare const meta: HookMeta;
+export declare const stopNextStepHook: SungenHook;
+//# sourceMappingURL=stop-next-step-hook.d.ts.map

package/dist/hooks/stop-next-step-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-next-step-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/stop-next-step-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAS,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIrE,eAAO,MAAM,IAAI,EAAE,QAA4C,CAAC;AAEhE,eAAO,MAAM,gBAAgB,EAAE,UAkB9B,CAAC"}

package/dist/hooks/stop-next-step-hook.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopNextStepHook = exports.meta = void 0;
+/**
+ * Claude Code Stop hook — a turn that ran sungen work never ends without the next step (P0.1).
+ *
+ * A slash command has no CLI exit, so the CLI's `Next: sungen next …` footer cannot reach a session
+ * that ends inside `/sungen:create-test`; the hand-back rule in the command template is only an
+ * instruction. This makes it deterministic for Claude Code: when the turn that just ended ran
+ * sungen and did not hand back (no AskUserQuestion after the last sungen call), the hand-back core's
+ * answer is injected as context and Claude continues once to present it.
+ *
+ * Loop-safe: `stop_hook_active` (Claude Code is already continuing because of a stop hook) is a
+ * no-op, and so is anything the hook cannot read — a missing transcript, a non-sungen directory.
+ */
+const hook_result_contract_1 = require("./hook-result-contract");
+const hand_back_core_1 = require("./hand-back-core");
+const claude_transcript_turn_1 = require("./claude-transcript-turn");
+exports.meta = { events: ['Stop'], timeout: 10 };
+exports.stopNextStepHook = {
+    name: 'stop-next-step',
+    meta: exports.meta,
+    run(input, ctx) {
+        if (input.stop_hook_active === true)
+            return hook_result_contract_1.NO_OP;
+        const turn = (0, claude_transcript_turn_1.summarizeTurn)(input.transcript_path);
+        if (!turn || !turn.sungenActivity || turn.askedAfter)
+            return hook_result_contract_1.NO_OP;
+        const core = (0, hand_back_core_1.run)({ unit: turn.lastUnit }, ctx);
+        if (core.status !== 'context')
+            return hook_result_contract_1.NO_OP;
+        return {
+            status: 'context',
+            output: [
+                '[sungen] This turn ran sungen work but ended without the next-step hand-back.',
+                'Hand back now: present these steps to the user with AskUserQuestion and stop — do not run them yourself.',
+                core.output,
+            ].join('\n'),
+        };
+    },
+};
+//# sourceMappingURL=stop-next-step-hook.js.map

package/dist/hooks/stop-next-step-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-next-step-hook.js","sourceRoot":"","sources":["../../src/hooks/stop-next-step-hook.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,iEAAqE;AACrE,qDAAuD;AACvD,qEAAyD;AAE5C,QAAA,IAAI,GAAa,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAEnD,QAAA,gBAAgB,GAAe;IAC1C,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAJ,YAAI;IACJ,GAAG,CAAC,KAAK,EAAE,GAAG;QACZ,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI;YAAE,OAAO,4BAAK,CAAC;QAClD,MAAM,IAAI,GAAG,IAAA,sCAAa,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,4BAAK,CAAC;QACnE,MAAM,IAAI,GAAG,IAAA,oBAAY,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,4BAAK,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE;gBACN,+EAA+E;gBAC/E,0GAA0G;gBAC1G,IAAI,CAAC,MAAM;aACZ,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/hooks/sungen-project-root.d.ts

@@ -0,0 +1,19 @@
+export type UnitKind = 'screen' | 'flow' | 'api';
+export interface UnitRef {
+    name: string;
+    kind: UnitKind;
+    dir: string;
+}
+export declare function isSungenRoot(dir: string): boolean;
+/** The nearest sungen project at or above `start`, or null outside one. */
+export declare function findSungenRoot(start: string): string | null;
+/** Every unit directory the project holds (`qa/api/flows` is a container, not a unit). */
+export declare function listUnits(root: string): UnitRef[];
+/** The unit with this name, when exactly one directory holds it (an ambiguous name is no answer). */
+export declare function findUnit(root: string, name: string): UnitRef | null;
+/**
+ * The unit a session is most likely on: the one `cwd` sits inside, else the one with the most
+ * recent activity — its ledger, its audit report, or its directory, whichever moved last.
+ */
+export declare function nearestUnit(root: string, cwd: string): UnitRef | null;
+//# sourceMappingURL=sungen-project-root.d.ts.map

package/dist/hooks/sungen-project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sungen-project-root.d.ts","sourceRoot":"","sources":["../../src/hooks/sungen-project-root.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AACjD,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAMtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS3D;AAED,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAWjD;AAED,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGnE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAmBrE"}

package/dist/hooks/sungen-project-root.js

@@ -0,0 +1,130 @@
+"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.isSungenRoot = isSungenRoot;
+exports.findSungenRoot = findSungenRoot;
+exports.listUnits = listUnits;
+exports.findUnit = findUnit;
+exports.nearestUnit = nearestUnit;
+/**
+ * Where the sungen project is, and which unit a session is working on — read cheaply off disk.
+ *
+ * A hook runs from wherever Claude Code's shell happens to be, and in a monorepo the sungen project
+ * can sit below the repository root. So a project root is found by walking UP from a start path to
+ * the nearest directory holding `qa/` plus a sungen marker (`.sungen/` or `qa/capabilities.yaml`);
+ * the marker keeps an unrelated `~/qa/` folder higher up from being mistaken for a project.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const unit_paths_1 = require("../harness/unit-paths");
+const KIND_DIRS = [['screens', 'screen'], ['flows', 'flow'], ['api', 'api']];
+const isDir = (p) => { try {
+    return fs.statSync(p).isDirectory();
+}
+catch {
+    return false;
+} };
+const mtime = (p) => { try {
+    return fs.statSync(p).mtimeMs;
+}
+catch {
+    return 0;
+} };
+function isSungenRoot(dir) {
+    return isDir(path.join(dir, 'qa'))
+        && (isDir(path.join(dir, '.sungen')) || fs.existsSync(path.join(dir, 'qa', 'capabilities.yaml')));
+}
+/** The nearest sungen project at or above `start`, or null outside one. */
+function findSungenRoot(start) {
+    let dir = path.resolve(start);
+    for (let i = 0; i < 40; i++) {
+        if (isSungenRoot(dir))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+/** Every unit directory the project holds (`qa/api/flows` is a container, not a unit). */
+function listUnits(root) {
+    const out = [];
+    for (const [sub, kind] of KIND_DIRS) {
+        let entries = [];
+        try {
+            entries = fs.readdirSync(path.join(root, 'qa', sub), { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory() || (kind === 'api' && e.name === 'flows'))
+                continue;
+            out.push({ name: e.name, kind, dir: path.join(root, 'qa', sub, e.name) });
+        }
+    }
+    return out;
+}
+/** The unit with this name, when exactly one directory holds it (an ambiguous name is no answer). */
+function findUnit(root, name) {
+    const hits = listUnits(root).filter((u) => u.name === name);
+    return hits.length === 1 ? hits[0] : null;
+}
+/**
+ * The unit a session is most likely on: the one `cwd` sits inside, else the one with the most
+ * recent activity — its ledger, its audit report, or its directory, whichever moved last.
+ */
+function nearestUnit(root, cwd) {
+    const units = listUnits(root);
+    const rel = path.relative(root, path.resolve(cwd)).split(path.sep);
+    if (rel[0] === 'qa' && rel.length >= 3) {
+        const inside = units.find((u) => u.dir === path.join(root, 'qa', rel[1], rel[2]));
+        if (inside)
+            return inside;
+    }
+    let best = null;
+    let bestAt = -1;
+    for (const u of units) {
+        const slug = (0, unit_paths_1.reportSlug)(u.name);
+        const at = Math.max(mtime(path.join(root, '.sungen', 'ledger', `${slug}.jsonl`)), mtime(path.join(root, '.sungen', 'reports', `${slug}-audit.json`)), mtime(u.dir));
+        if (at > bestAt) {
+            best = u;
+            bestAt = at;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=sungen-project-root.js.map

package/dist/hooks/sungen-project-root.js.map

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

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

@@ -0,0 +1,15 @@
+import type { AdapterKey } from './adapters';
+/** Every command must include these. The hand-back rule is the reason this module exists. */
+export declare const REQUIRED_INCLUDES: readonly ["hand-back-rule"];
+export declare class PartialError extends Error {
+}
+/** Partial names a body includes, in order of appearance. */
+export declare function includesOf(body: string): string[];
+/** Throws when a command lacks a required include — the build-time gate. */
+export declare function assertRequiredIncludes(body: string, commandId: string): void;
+/**
+ * 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.
+ */
+export declare function expandIncludes(body: string, adapter: AdapterKey, commandId: string, vars: Record<string, string>): string;
+//# sourceMappingURL=command-partial-includes.d.ts.map

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;AAID,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"}