@sun-asterisk/sungen 3.2.34 → 3.3.0-alpha.2

package/dist/hooks/hook-toggles.js

@@ -0,0 +1,107 @@
+"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.hookEnvVar = exports.PROJECT_CONFIG = exports.KILL_SWITCH_ENV = void 0;
+exports.hooksKilled = hooksKilled;
+exports.configDisabledHooks = configDisabledHooks;
+exports.isHookEnabled = isHookEnabled;
+/**
+ * Turning sungen's Claude Code hooks off — all of them, or one at a time.
+ *
+ *   SUNGEN_HOOKS=off                      kill-switch, every hook is a no-op
+ *   SUNGEN_HOOK_<NAME>=off                one hook (e.g. SUNGEN_HOOK_PRE_TOOL_GUARD=off)
+ *   qa/sungen.config.yaml  hooks: false   persistent, for the whole project
+ *                          hooks: { stop-next-step: false }   persistent, one hook
+ *
+ * The env forms can live in the shell or in `.claude/settings.json` → `"env": { … }` (Claude Code
+ * applies that block to the session, so hook processes inherit it). The config file is also what
+ * `sungen init` / `sungen update` read: a hook it turns off is removed from settings.json.
+ *
+ * At RUN time the config file only switches off the advisory hooks. The guard ignores it — an
+ * agent could otherwise write `hooks: false` and walk past the guard it is subject to; only the real
+ * environment switches the guard off. (An agent edit of the config file or settings.json asks the
+ * user first — see guard-rules.ts.) The human path is editing these files by hand, then
+ * `sungen update`, which removes a turned-off hook's entry from settings.json.
+ *
+ * An unreadable config file disables nothing — the hooks fail open, they never fail silent-off.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const sungen_project_root_1 = require("./sungen-project-root");
+const OFF = /^(?:off|0|false|no|disabled?)$/i;
+exports.KILL_SWITCH_ENV = 'SUNGEN_HOOKS';
+exports.PROJECT_CONFIG = path.join('qa', 'sungen.config.yaml');
+/** `stop-next-step` → `SUNGEN_HOOK_STOP_NEXT_STEP`. */
+const hookEnvVar = (name) => `SUNGEN_HOOK_${name.toUpperCase().replace(/-/g, '_')}`;
+exports.hookEnvVar = hookEnvVar;
+const isOff = (v) => v === false || (typeof v === 'string' && OFF.test(v.trim()));
+function hooksKilled(env) {
+    return isOff(env[exports.KILL_SWITCH_ENV] ?? '');
+}
+/** Hooks the project config turns off: `'all'`, or the names set to false. */
+function configDisabledHooks(root) {
+    const off = new Set();
+    if (!root)
+        return off;
+    const file = path.join(root, exports.PROJECT_CONFIG);
+    if (!fs.existsSync(file))
+        return off;
+    try {
+        // Loaded lazily: the guard runs on every tool call and most projects have no config file.
+        const { parse } = require('yaml');
+        const doc = parse(fs.readFileSync(file, 'utf8'));
+        const hooks = doc && typeof doc === 'object' ? doc.hooks : undefined;
+        if (isOff(hooks))
+            return 'all';
+        if (hooks && typeof hooks === 'object') {
+            for (const [name, value] of Object.entries(hooks))
+                if (isOff(value))
+                    off.add(name);
+        }
+    }
+    catch { /* unreadable → nothing disabled (fail open) */ }
+    return off;
+}
+/** Hooks the project config may switch off at run time — never the guard. */
+const CONFIG_TOGGLEABLE = new Set(['stop-next-step', 'session-start-unit-state']);
+function isHookEnabled(name, ctx) {
+    if (hooksKilled(ctx.env) || isOff(ctx.env[(0, exports.hookEnvVar)(name)] ?? ''))
+        return false;
+    if (!CONFIG_TOGGLEABLE.has(name))
+        return true;
+    const off = configDisabledHooks((0, sungen_project_root_1.findSungenRoot)(ctx.cwd));
+    return off !== 'all' && !off.has(name);
+}
+//# sourceMappingURL=hook-toggles.js.map

package/dist/hooks/hook-toggles.js.map

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

package/dist/hooks/pre-tool-guard-hook.d.ts

@@ -0,0 +1,10 @@
+import { HookContext, HookMeta, HookResult, SungenHook } from './hook-result-contract';
+import { GuardedCall, GuardRule } from './guard-rules';
+export type { GuardedCall, GuardRule } from './guard-rules';
+export declare const meta: HookMeta;
+/** The rules, in order (first deny wins, else first ask). */
+export declare const GUARD_RULES: GuardRule[];
+/** First deny wins; otherwise the first ask; otherwise ok. */
+export declare function evaluateGuard(call: GuardedCall, ctx: HookContext, rules?: GuardRule[]): HookResult;
+export declare const preToolGuardHook: SungenHook;
+//# sourceMappingURL=pre-tool-guard-hook.d.ts.map

package/dist/hooks/pre-tool-guard-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-guard-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/pre-tool-guard-hook.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAS,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAsE,MAAM,eAAe,CAAC;AAI3H,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D,eAAO,MAAM,IAAI,EAAE,QAIlB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,SAAS,EAA4G,CAAC;AAEhJ,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,GAAE,SAAS,EAAgB,GAAG,UAAU,CAY/G;AAID,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC"}

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;AAMrE,eAAO,MAAM,IAAI,EAAE,QAIlB,CAAC;AAgBF,eAAO,MAAM,yBAAyB,EAAE,UAoBvC,CAAC"}

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

@@ -0,0 +1,57 @@
+"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 project_sungen_invocation_1 = require("../cli/project-sungen-invocation");
+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 sungen = (0, project_sungen_invocation_1.sungenInvocation)(root);
+        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, 4, root),
+            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":"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"}

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"}