@rasensio/aidlc 1.66.0 → 1.72.0

package/dist/autopilot/state.d.ts

@@ -8,7 +8,9 @@
  *
  * @module
  */
+import type { CodexProgress, SessionEnd } from './result.js';
 import type { PausePhase, StopAt, Stops } from './stops.js';
+import type { Harness } from './typed.js';
 /** A lock older than this belongs to a pass that died. */
 export declare const STALE_LOCK_MS: number;
 export interface AutopilotPaths {
@@ -31,6 +33,46 @@ export type ItemStep = 'building' | 'pr-open' | 'queued' | 'awaiting-review' | '
 export type ResumeStep = Exclude<ItemStep, 'error'>;
 /** The checks on an item's pull request, as the driver last read them (autopilot-live-progress/AC-13). */
 export type CiState = 'waiting' | 'pending' | 'passed' | 'failed';
+/**
+ * A launch that asked for a typed result, recorded on the item so that a pass in any
+ * process reads that launch's result — not only the one that spawned it
+ * (autopilot-reads-agent-result/AC-32).
+ */
+export interface TypedLaunch {
+    harness: Harness;
+    /** When it was launched. */
+    at: string;
+    /** The cap its budget was worked out from; absent when none was set (AC-7, AC-17). */
+    cap_usd?: number;
+    /** Where this launch's output starts in `logs/<item>.log`. */
+    log_offset: number;
+    /** Codex: the `-o` file, emptied before the launch so an earlier result cannot be read as this one's (AC-6). */
+    outcome_file?: string;
+    /** Codex: the next byte of the log no pass has folded yet, and what was folded. */
+    read_offset?: number;
+    progress?: CodexProgress;
+    /** Codex: the model once read, and when to look for the thread's rollout — its first launch. */
+    model?: string;
+    rollout_at?: string;
+    /** Codex: rollout lookups so far; three, then the launch is unpriced (design D10). */
+    model_lookups?: number;
+    /** The session id this launch resumed (AC-27). */
+    resumes?: string;
+    /** Absent: not read yet. null: read, and nothing readable (AC-15). */
+    end?: SessionEnd | null;
+}
+/**
+ * A session waiting to be resumed (autopilot-reads-agent-result/AC-23, AC-24, AC-26). An
+ * `ended-early` session ended before the release boundary with no stop autopilot honours
+ * (unattended-agent-ends-turn-to-wait/AC-3).
+ */
+export interface ResumeWait {
+    kind: 'session-limit' | 'connection' | 'ended-early';
+    /** For a dropped connection or an early ending, the pass that decided it: the resume is the next pass. */
+    until: string;
+    /** Checked against UUID_RE again where it is used: this file can be edited by hand. */
+    session: string;
+}
 export interface AutopilotItem {
     name: string;
     file: string;
@@ -81,6 +123,15 @@ export interface AutopilotItem {
     ci?: CiState;
     bump?: string;
     version?: string;
+    /** The last launch, while its result can still decide. Absent: handled as before (AC-31). */
+    launch?: TypedLaunch;
+    /** What the item's typed sessions cost, in micro-USD; absent is 0 (AC-19). */
+    spent_micro_usd?: number;
+    /** Each session's last recorded cost, so a resumed session adds only its increase (AC-19). */
+    session_costs?: Record<string, number>;
+    resume_wait?: ResumeWait;
+    /** Said once for the item that its Codex usage cannot be priced (AC-21). */
+    unpriced_noted?: boolean;
 }
 export interface AutopilotState {
     items: AutopilotItem[];

package/dist/autopilot/state.d.ts.map

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

package/dist/autopilot/state.js.map

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

package/dist/autopilot/typed.d.ts

@@ -0,0 +1,98 @@
+/**
+ * What autopilot sends a preset agent so that it can read back how the session ended
+ * (autopilot-reads-agent-result/AC-1..AC-5, AC-17, AC-18, AC-23, AC-33).
+ *
+ * The read side is `result.ts`. Both are pure; the driver sequences them. Nothing here
+ * is saved to the machine config: the flags are added at launch, so a machine set up
+ * before this change gets them without running setup again.
+ *
+ * @module
+ */
+export type Harness = 'claude' | 'codex';
+export declare const OUTCOMES: readonly ["shipped", "paused", "parked", "blocked"];
+export type Outcome = (typeof OUTCOMES)[number];
+export interface AgentOutcome {
+    outcome: Outcome;
+    reason: string;
+    instance: string;
+    phase: string;
+}
+/**
+ * The outcome the agent ends with: exactly these four keys, each a required string
+ * (autopilot-reads-agent-result/AC-4). `additionalProperties: false` with every key
+ * required is also what Codex's `--output-schema` insists on.
+ */
+export declare const OUTCOME_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly outcome: {
+            readonly type: "string";
+            readonly enum: readonly ["shipped", "paused", "parked", "blocked"];
+        };
+        readonly reason: {
+            readonly type: "string";
+        };
+        readonly instance: {
+            readonly type: "string";
+        };
+        readonly phase: {
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["outcome", "reason", "instance", "phase"];
+    readonly additionalProperties: false;
+};
+/**
+ * 8, 4, 4, 4 and 12 hexadecimal digits. The only session id that reaches an argv or a
+ * park reason: the cost providers' `SESSION_ID_RE` accepts `--dangerously-skip-permissions`,
+ * which `--resume` would read as a flag (autopilot-reads-agent-result/AC-33).
+ */
+export declare const UUID_RE: RegExp;
+/**
+ * The harness whose preset this exact argv is, or null for a custom command, which is
+ * launched as configured (autopilot-reads-agent-result/AC-1..AC-3). Exact, not "starts
+ * with `claude`": a custom command may be a wrapper that rejects the flags.
+ */
+export declare function typedHarness(command: readonly string[]): Harness | null;
+export interface TypedArgs {
+    harness: Harness;
+    prompt: string;
+    /** Codex only: both under `<git-common-dir>/aidlc/autopilot/` (autopilot-reads-agent-result/AC-2). */
+    schemaFile: string;
+    outcomeFile: string;
+    /** Claude only: `--max-budget-usd` in whole cents; null adds no flag (autopilot-reads-agent-result/AC-17). */
+    maxBudgetCents: number | null;
+    /** The session to resume; null for a fresh launch (autopilot-reads-agent-result/AC-23). */
+    resume: string | null;
+}
+/**
+ * The preset argv with `{prompt}` substituted and the typed flags added; null when
+ * `resume` is not a UUID. Checked here, where the id enters the argv, and not only where
+ * it was read: it reaches this call through `state.json`, which a person or a scoped
+ * agent can edit (autopilot-reads-agent-result/AC-33).
+ *
+ * Codex's flags go before the prompt so that a resume is a splice — `resume <id>` where
+ * the prompt was, after every option `codex exec` defines (design D4).
+ */
+export declare function typedArgv(command: readonly string[], args: TypedArgs): string[] | null;
+export declare function withOutcomeContract(prompt: string): string;
+export type StopLabel = 'connection dropped' | 'session limit' | 'ended before the release boundary';
+/**
+ * Autopilot's own words for a resumed session, never text from the agent: the session
+ * already holds its original instructions (autopilot-reads-agent-result/AC-23). A session
+ * that ended early is told why it most likely did — it ended its turn to wait for a
+ * command, which the end of the turn killed (unattended-agent-ends-turn-to-wait/AC-4).
+ */
+export declare function resumePrompt(item: {
+    name: string;
+}, why: StopLabel): string;
+/**
+ * Whole cents of budget left: the cap, less what the item spent, less 10% of the cap,
+ * rounded down (autopilot-reads-agent-result/AC-17). In integer micro-dollars, as the
+ * rate table prices: in dollars, 4.50 can come out as 449 cents. Negative when the item
+ * is past the cap less the margin.
+ */
+export declare function budgetCents(capUsd: number, spentMicro: number): number;
+/** '13.50' for 1350. */
+export declare function centsText(cents: number): string;
+//# sourceMappingURL=typed.d.ts.map

package/dist/autopilot/typed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/autopilot/typed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzC,eAAO,MAAM,QAAQ,qDAAsD,CAAC;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;CAUjB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,OAAO,QAAoE,CAAC;AAKzF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAIvE;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8GAA8G;IAC9G,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2FAA2F;IAC3F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAoBtF;AAUD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,eAAe,GAAG,mCAAmC,CAAC;AAErG;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAa3E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAwB;AACxB,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/autopilot/typed.js

@@ -0,0 +1,122 @@
+/**
+ * What autopilot sends a preset agent so that it can read back how the session ended
+ * (autopilot-reads-agent-result/AC-1..AC-5, AC-17, AC-18, AC-23, AC-33).
+ *
+ * The read side is `result.ts`. Both are pure; the driver sequences them. Nothing here
+ * is saved to the machine config: the flags are added at launch, so a machine set up
+ * before this change gets them without running setup again.
+ *
+ * @module
+ */
+import { AGENT_PRESETS } from './presets.js';
+export const OUTCOMES = ['shipped', 'paused', 'parked', 'blocked'];
+/**
+ * The outcome the agent ends with: exactly these four keys, each a required string
+ * (autopilot-reads-agent-result/AC-4). `additionalProperties: false` with every key
+ * required is also what Codex's `--output-schema` insists on.
+ */
+export const OUTCOME_SCHEMA = {
+    type: 'object',
+    properties: {
+        outcome: { type: 'string', enum: [...OUTCOMES] },
+        reason: { type: 'string' },
+        instance: { type: 'string' },
+        phase: { type: 'string' },
+    },
+    required: ['outcome', 'reason', 'instance', 'phase'],
+    additionalProperties: false,
+};
+/**
+ * 8, 4, 4, 4 and 12 hexadecimal digits. The only session id that reaches an argv or a
+ * park reason: the cost providers' `SESSION_ID_RE` accepts `--dangerously-skip-permissions`,
+ * which `--resume` would read as a flag (autopilot-reads-agent-result/AC-33).
+ */
+export const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const sameArgv = (a, b) => a.length === b.length && a.every((x, i) => x === b[i]);
+/**
+ * The harness whose preset this exact argv is, or null for a custom command, which is
+ * launched as configured (autopilot-reads-agent-result/AC-1..AC-3). Exact, not "starts
+ * with `claude`": a custom command may be a wrapper that rejects the flags.
+ */
+export function typedHarness(command) {
+    const preset = AGENT_PRESETS.find((p) => sameArgv(p.command, command));
+    if (preset === undefined)
+        return null;
+    return preset.platform === 'codex' ? 'codex' : 'claude';
+}
+/**
+ * The preset argv with `{prompt}` substituted and the typed flags added; null when
+ * `resume` is not a UUID. Checked here, where the id enters the argv, and not only where
+ * it was read: it reaches this call through `state.json`, which a person or a scoped
+ * agent can edit (autopilot-reads-agent-result/AC-33).
+ *
+ * Codex's flags go before the prompt so that a resume is a splice — `resume <id>` where
+ * the prompt was, after every option `codex exec` defines (design D4).
+ */
+export function typedArgv(command, args) {
+    if (args.resume !== null && !UUID_RE.test(args.resume))
+        return null;
+    if (args.harness === 'claude') {
+        const argv = command.map((a) => (a === '{prompt}' ? args.prompt : a));
+        argv.push('--output-format', 'json', '--json-schema', JSON.stringify(OUTCOME_SCHEMA));
+        if (args.maxBudgetCents !== null)
+            argv.push('--max-budget-usd', centsText(args.maxBudgetCents));
+        if (args.resume !== null)
+            argv.push('--resume', args.resume);
+        return argv;
+    }
+    const at = command.indexOf('{prompt}');
+    if (at === -1)
+        return null;
+    return [
+        ...command.slice(0, at),
+        '--json',
+        '--output-schema', args.schemaFile,
+        '-o', args.outcomeFile,
+        ...(args.resume === null ? [] : ['resume', args.resume]),
+        args.prompt,
+        ...command.slice(at + 1),
+    ];
+}
+/** What each outcome means, told to every typed launch (autopilot-reads-agent-result/AC-5). */
+const OUTCOME_CONTRACT = ' When you stop, end with the JSON object the output schema asks for. Its "outcome" is ' +
+    '"shipped" when what this prompt asked for is done and committed; "paused" when you stopped ' +
+    'at a review boundary; "parked" when you parked the item; "blocked" when you stopped for any ' +
+    'other reason, which "reason" gives. Its "instance" and "phase" name the instance and its ' +
+    'current phase.';
+export function withOutcomeContract(prompt) {
+    return prompt + OUTCOME_CONTRACT;
+}
+/**
+ * Autopilot's own words for a resumed session, never text from the agent: the session
+ * already holds its original instructions (autopilot-reads-agent-result/AC-23). A session
+ * that ended early is told why it most likely did — it ended its turn to wait for a
+ * command, which the end of the turn killed (unattended-agent-ends-turn-to-wait/AC-4).
+ */
+export function resumePrompt(item, why) {
+    const lead = `You are running unattended (AIDLC_UNATTENDED=1). Follow .aidlc/resources/rules/unattended.md. `;
+    const carryOn = `Carry on from where it stopped, with the same instructions as before.`;
+    if (why === 'ended before the release boundary') {
+        return (lead +
+            `Your session for the AIDLC instance "${item.name}" ended before the release boundary. ` +
+            `In this mode the end of a turn is the end of the session, and a command still running when it ends dies with it. ` +
+            `Run any such command again in the foreground and wait for it inside the turn. ` +
+            carryOn);
+    }
+    return lead + `Your session for the AIDLC instance "${item.name}" stopped before it finished (${why}). ` + carryOn;
+}
+/**
+ * Whole cents of budget left: the cap, less what the item spent, less 10% of the cap,
+ * rounded down (autopilot-reads-agent-result/AC-17). In integer micro-dollars, as the
+ * rate table prices: in dollars, 4.50 can come out as 449 cents. Negative when the item
+ * is past the cap less the margin.
+ */
+export function budgetCents(capUsd, spentMicro) {
+    const cents = Math.floor((Math.round(capUsd * 1e6) - spentMicro - Math.round(capUsd * 1e5)) / 1e4);
+    return Number.isFinite(cents) ? cents : 0;
+}
+/** '13.50' for 1350. */
+export function centsText(cents) {
+    return (cents / 100).toFixed(2);
+}
+//# sourceMappingURL=typed.js.map

package/dist/autopilot/typed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.js","sourceRoot":"","sources":["../../src/autopilot/typed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAU5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE;QAChD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;IACpD,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAEzF,MAAM,QAAQ,GAAG,CAAC,CAAoB,EAAE,CAAoB,EAAW,EAAE,CACvE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1D,CAAC;AAcD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B,EAAE,IAAe;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;QACtF,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAChG,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACvB,QAAQ;QACR,iBAAiB,EAAE,IAAI,CAAC,UAAU;QAClC,IAAI,EAAE,IAAI,CAAC,WAAW;QACtB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;QACX,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,gBAAgB,GACpB,wFAAwF;IACxF,6FAA6F;IAC7F,8FAA8F;IAC9F,2FAA2F;IAC3F,gBAAgB,CAAC;AAEnB,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,MAAM,GAAG,gBAAgB,CAAC;AACnC,CAAC;AAID;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAsB,EAAE,GAAc;IACjE,MAAM,IAAI,GAAG,gGAAgG,CAAC;IAC9G,MAAM,OAAO,GAAG,uEAAuE,CAAC;IACxF,IAAI,GAAG,KAAK,mCAAmC,EAAE,CAAC;QAChD,OAAO,CACL,IAAI;YACJ,wCAAwC,IAAI,CAAC,IAAI,uCAAuC;YACxF,mHAAmH;YACnH,gFAAgF;YAChF,OAAO,CACR,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,GAAG,wCAAwC,IAAI,CAAC,IAAI,iCAAiC,GAAG,KAAK,GAAG,OAAO,CAAC;AACrH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAAkB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACnG,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAyCtC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,GAAG,SAA2B,GAC1C,OAAO,CAQT"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkCpC;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA0CtC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,GAAG,SAA2B,GAC1C,OAAO,CAQT"}

package/dist/cli.js

@@ -48,6 +48,7 @@ import { registerConstitution } from './commands/constitution.js';
 import { registerRoadmap } from './commands/roadmap.js';
 import { registerAutopilot } from './commands/autopilot.js';
 import { registerSpec } from './commands/spec.js';
+import { registerHook } from './commands/hook.js';
 import { registerMenu } from './commands/menu.js';
 import { isBareInvocation } from './menu/invocation.js';
 import { openMenu } from './menu/index.js';
@@ -92,6 +93,7 @@ export function buildProgram() {
     registerRoadmap(program);
     registerAutopilot(program);
     registerSpec(program);
+    registerHook(program);
     // Last, so `menu` renders last in `aidlc --help` (interactive-cli-menu/AC-5).
     // Takes the factory, not `program`: the menu dispatches on a throwaway copy so
     // the caller's program never carries an `exitOverride` it cannot undo.

package/dist/cli.js.map

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

package/dist/commands/hook.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `aidlc hook` — lifecycle hooks for agent harnesses.
+ *
+ * Two subcommands run inside a harness hook and two install them:
+ *
+ * - `session-start` prints the claimed instance, its phase and its next step,
+ *   for a `SessionStart` hook to add to the agent's context after startup,
+ *   resume, `/clear` or compaction.
+ * - `guard` answers a Claude Code `PreToolUse` call with `ask` while the claimed
+ *   instance is being planned, and with silence otherwise.
+ * - `install` / `remove` write those into `.claude/settings.json`, and the
+ *   session-start hook into `.codex/hooks.json` only when asked by name.
+ *
+ * The two hook-mode subcommands exit 0 on every path and print nothing when they
+ * have nothing to say: a hook that fails must never stop a session starting or a
+ * file being edited (hooks-carry-lifecycle-state/AC-7, AC-12, AC-13).
+ *
+ * Design: design.md C5
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Hook mode. stdin is never read (AC-8): the output does not depend on why the
+ * session started, so the payload cannot steer it and a manual run cannot hang.
+ */
+export declare function runSessionStart(from?: string): void;
+export declare function runGuard(from?: string): Promise<void>;
+interface InstallOpts {
+    platform?: string;
+    guard?: boolean;
+}
+export declare function runInstall(opts: InstallOpts): void;
+export declare function runRemove(opts: InstallOpts): void;
+export declare function registerHook(program: Command): void;
+export {};
+//# sourceMappingURL=hook.d.ts.map

package/dist/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAUnD;AAED,wBAAsB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3D;AAwBD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA6ClD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA8BjD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoCnD"}

package/dist/commands/hook.js

@@ -0,0 +1,208 @@
+/**
+ * `aidlc hook` — lifecycle hooks for agent harnesses.
+ *
+ * Two subcommands run inside a harness hook and two install them:
+ *
+ * - `session-start` prints the claimed instance, its phase and its next step,
+ *   for a `SessionStart` hook to add to the agent's context after startup,
+ *   resume, `/clear` or compaction.
+ * - `guard` answers a Claude Code `PreToolUse` call with `ask` while the claimed
+ *   instance is being planned, and with silence otherwise.
+ * - `install` / `remove` write those into `.claude/settings.json`, and the
+ *   session-start hook into `.codex/hooks.json` only when asked by name.
+ *
+ * The two hook-mode subcommands exit 0 on every path and print nothing when they
+ * have nothing to say: a hook that fails must never stop a session starting or a
+ * file being edited (hooks-carry-lifecycle-state/AC-7, AC-12, AC-13).
+ *
+ * Design: design.md C5
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { findProjectRoot, resolveProjectRoot } from '../core/project-root.js';
+import { sessionStartLines } from '../hooks/lifecycle-context.js';
+import { guardDecision, guardOutput } from '../hooks/guard.js';
+import { LIFECYCLE_PLATFORMS, installCommand, installLifecycleHooks, needsConsent, removeLifecycleHooks, supportsGuard, trustStep, } from '../hooks/install.js';
+/**
+ * The whole of stdin. A TTY means a manual run with no payload, so it resolves
+ * empty rather than waiting — as `cost.ts` does for its hook-mode commands.
+ */
+function readStdin() {
+    return new Promise((resolveInput) => {
+        if (process.stdin.isTTY) {
+            resolveInput('');
+            return;
+        }
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => (data += chunk));
+        process.stdin.on('end', () => resolveInput(data));
+        process.stdin.on('error', () => resolveInput(''));
+    });
+}
+/**
+ * Hook mode. stdin is never read (AC-8): the output does not depend on why the
+ * session started, so the payload cannot steer it and a manual run cannot hang.
+ */
+export function runSessionStart(from) {
+    try {
+        const root = findProjectRoot(from);
+        if (root === null)
+            return;
+        const lines = sessionStartLines(root);
+        if (lines.length > 0)
+            process.stdout.write(`${lines.join('\n')}\n`);
+    }
+    catch {
+        // Silence is the failure mode: no context is today's behaviour, a failed
+        // session start is not (AC-7).
+    }
+}
+export async function runGuard(from) {
+    try {
+        const raw = await readStdin();
+        const root = findProjectRoot(from);
+        if (root === null)
+            return;
+        const decision = guardDecision(root, raw);
+        if (decision !== null)
+            process.stdout.write(`${guardOutput(decision)}\n`);
+    }
+    catch {
+        // Fail open: the normal permission flow decides (AC-12, design D5).
+    }
+}
+/** Platforms listed in `.aidlc/config.yaml`, or none when it cannot be read. */
+function configuredPlatforms(root) {
+    const path = join(root, '.aidlc', 'config.yaml');
+    if (!existsSync(path))
+        return [];
+    try {
+        const config = parseYaml(readFileSync(path, 'utf8'));
+        return Array.isArray(config?.platforms) ? config.platforms.filter((p) => typeof p === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+function parsePlatform(value) {
+    if (value === undefined)
+        return null;
+    return LIFECYCLE_PLATFORMS.includes(value) ? value : 'invalid';
+}
+function refuse(message) {
+    process.stderr.write(`Error: ${message}\n`);
+    process.exitCode = 2;
+}
+export function runInstall(opts) {
+    const root = resolveProjectRoot();
+    const platform = parsePlatform(opts.platform);
+    if (platform === 'invalid') {
+        refuse(`no lifecycle hooks for '${opts.platform}' — supported: ${LIFECYCLE_PLATFORMS.join(', ')}`);
+        return;
+    }
+    if (platform !== null && opts.guard && !supportsGuard(platform)) {
+        refuse(`the phase guard is Claude Code only — ${platform} hooks can deny or rewrite a call, not ask`);
+        return;
+    }
+    const target = platform ?? 'claude-code';
+    let result;
+    try {
+        result = installLifecycleHooks(root, { platform: target, guard: opts.guard });
+    }
+    catch (err) {
+        // An unparsable hook file is left as it is rather than overwritten.
+        process.stderr.write(`Error: could not install the lifecycle hooks: ${err.message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const file = relative(root, result.path);
+    const what = opts.guard ? 'session-start hook and phase guard' : 'session-start hook';
+    process.stdout.write(result.written ? `Installed the ${what} in ${file}\n` : `The ${what} is already installed in ${file}\n`);
+    if (opts.guard) {
+        process.stdout.write('The guard asks before a project file outside .aidlc/ is edited during ideation, requirements or design. ' +
+            'Remove it with `aidlc hook remove --guard`.\n');
+    }
+    const step = trustStep(target);
+    if (step !== null)
+        process.stdout.write(`${step}\n`);
+    if (platform === null) {
+        // A consent-gated platform needs the user's say-so by name; a bare install
+        // never writes it, only names the command that does (AC-20).
+        const configured = configuredPlatforms(root);
+        for (const other of LIFECYCLE_PLATFORMS.filter((p) => needsConsent(p) && configured.includes(p))) {
+            process.stdout.write(`${other} is configured too: add its session-start hook with \`${installCommand(other)}\`. ${trustStep(other)}\n`);
+        }
+    }
+}
+export function runRemove(opts) {
+    const root = resolveProjectRoot();
+    const platform = parsePlatform(opts.platform);
+    if (platform === 'invalid') {
+        refuse(`no lifecycle hooks for '${opts.platform}' — supported: ${LIFECYCLE_PLATFORMS.join(', ')}`);
+        return;
+    }
+    if (platform !== null && opts.guard && !supportsGuard(platform)) {
+        refuse(`the phase guard is Claude Code only — ${platform} has none to remove`);
+        return;
+    }
+    const all = platform ? [platform] : [...LIFECYCLE_PLATFORMS];
+    const targets = opts.guard ? all.filter(supportsGuard) : all;
+    let removed = 0;
+    for (const target of targets) {
+        let result;
+        try {
+            result = removeLifecycleHooks(root, { platform: target, guardOnly: opts.guard });
+        }
+        catch (err) {
+            // An unparsable hook file is left as it is, as install leaves it.
+            process.stderr.write(`Error: could not remove the lifecycle hooks: ${err.message}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (result.written) {
+            removed += 1;
+            process.stdout.write(`Removed the ${opts.guard ? 'phase guard' : 'lifecycle hooks'} from ${relative(root, result.path)}\n`);
+        }
+    }
+    if (removed === 0)
+        process.stdout.write('No lifecycle hooks to remove\n');
+}
+export function registerHook(program) {
+    const hook = program
+        .command('hook')
+        .description('Lifecycle hooks: session-start context and the opt-in phase guard');
+    hook
+        .command('session-start')
+        .description('Print the claimed instance, its phase and next step (SessionStart hook mode)')
+        .action(() => {
+        runSessionStart();
+    });
+    hook
+        .command('guard')
+        .description('Ask before code is edited during planning (PreToolUse hook mode)')
+        .action(async () => {
+        await runGuard();
+    });
+    hook
+        .command('install')
+        .description('Install the session-start hook (and, with --guard, the phase guard)')
+        .option('--platform <name>', `Platform to install for (${LIFECYCLE_PLATFORMS.join(', ')}; default claude-code)`)
+        .option('--guard', 'Also install the phase guard (Claude Code only; off by default)')
+        .action((opts) => {
+        runInstall(opts);
+    });
+    hook
+        .command('remove')
+        .description('Remove the lifecycle hooks, or only the phase guard with --guard')
+        .option('--platform <name>', `Limit to one platform (${LIFECYCLE_PLATFORMS.join(', ')})`)
+        .option('--guard', 'Remove only the phase guard')
+        .action((opts) => {
+        runRemove(opts);
+    });
+}
+//# sourceMappingURL=hook.js.map