@zhixuan92/multi-model-agent-core 5.0.3 → 5.1.0

package/dist/events/plain-log-entry.d.ts

@@ -32,7 +32,7 @@ export declare const PlainLogEntrySchema: z.ZodObject<{
     fields: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
 }, z.core.$strict>;
 export type PlainLogEntry = z.infer<typeof PlainLogEntrySchema>;
-export declare const PROVIDER_EVENT_NAMES: readonly ["claude_session_starting", "claude_turn_started", "claude_error", "claude_turn_completed", "claude_text_emission", "claude_tool_call", "claude_session_closed", "codex_subprocess_starting", "codex_spawn_failed", "codex_subprocess_started", "codex_subprocess_exited", "codex_thread_started", "codex_turn_started", "codex_command_started", "codex_command_completed", "codex_turn_completed", "codex_turn_failed", "codex_error", "codex_agent_message", "codex_file_change"];
+export declare const PROVIDER_EVENT_NAMES: readonly ["claude_session_starting", "claude_turn_started", "claude_error", "claude_turn_completed", "claude_text_emission", "claude_tool_call", "claude_session_closed", "claude_compaction", "codex_subprocess_starting", "codex_spawn_failed", "codex_subprocess_started", "codex_subprocess_exited", "codex_thread_started", "codex_turn_started", "codex_command_started", "codex_command_completed", "codex_turn_completed", "codex_turn_failed", "codex_error", "codex_agent_message", "codex_file_change"];
 export type ProviderEventName = (typeof PROVIDER_EVENT_NAMES)[number];
 /** Per-event field shapes are NOT pre-declared — `mapProviderEventToPlainEntry`
  *  passes through all primitive fields from the raw event payload (object-valued

package/dist/events/plain-log-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plain-log-entry.d.ts","sourceRoot":"","sources":["../../src/events/plain-log-entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;EAQ3B,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;kBAIrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB,+dAQvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;GAKG;AAEH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5B,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,aAAa,CAUf"}
+{"version":3,"file":"plain-log-entry.d.ts","sourceRoot":"","sources":["../../src/events/plain-log-entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;EAQ3B,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;kBAIrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB,ofAYvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;GAKG;AAEH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5B,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,aAAa,CAUf"}

package/dist/events/plain-log-entry.js

@@ -16,9 +16,13 @@ export const PlainLogEntrySchema = z.object({
     fields: z.record(z.string(), FieldValue),
 }).strict();
 export const PROVIDER_EVENT_NAMES = [
-    // Claude (7)
+    // Claude (8)
     'claude_session_starting', 'claude_turn_started', 'claude_error',
     'claude_turn_completed', 'claude_text_emission', 'claude_tool_call', 'claude_session_closed',
+    // Compaction observability (5.1.0, goal mode): emitted on the SDK's
+    // compact_boundary system message so long goal-set runs are no longer
+    // blind to context compaction. Observe-only — carries {trigger, preTokens, postTokens}.
+    'claude_compaction',
     // Codex (13)
     'codex_subprocess_starting', 'codex_spawn_failed', 'codex_subprocess_started', 'codex_subprocess_exited',
     'codex_thread_started', 'codex_turn_started', 'codex_command_started', 'codex_command_completed',

package/dist/events/plain-log-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"plain-log-entry.js","sourceRoot":"","sources":["../../src/events/plain-log-entry.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,gBAAgB,EAAC,gBAAgB;IACjC,eAAe,EAAC,kBAAkB,EAAC,iBAAiB;IACpD,iBAAiB,EAAC,cAAc;IAChC,iBAAiB;IACjB,sBAAsB,EAAC,sBAAsB;IAC7C,gBAAgB;IAChB,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa;IACb,yBAAyB,EAAC,qBAAqB,EAAC,cAAc;IAC9D,uBAAuB,EAAC,sBAAsB,EAAC,kBAAkB,EAAC,uBAAuB;IACzF,aAAa;IACb,2BAA2B,EAAC,oBAAoB,EAAC,0BAA0B,EAAC,yBAAyB;IACrG,sBAAsB,EAAC,oBAAoB,EAAC,uBAAuB,EAAC,yBAAyB;IAC7F,sBAAsB,EAAC,mBAAmB,EAAC,aAAa,EAAC,qBAAqB,EAAC,mBAAmB;CAC1F,CAAC;AAGX;;;;;GAKG;AAEH,MAAM,UAAU,4BAA4B,CAC1C,QAA4B,EAC5B,KAAwB,EACxB,SAAkC;IAElC,MAAM,MAAM,GAAqD,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3F,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"plain-log-entry.js","sourceRoot":"","sources":["../../src/events/plain-log-entry.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,gBAAgB,EAAC,gBAAgB;IACjC,eAAe,EAAC,kBAAkB,EAAC,iBAAiB;IACpD,iBAAiB,EAAC,cAAc;IAChC,iBAAiB;IACjB,sBAAsB,EAAC,sBAAsB;IAC7C,gBAAgB;IAChB,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa;IACb,yBAAyB,EAAC,qBAAqB,EAAC,cAAc;IAC9D,uBAAuB,EAAC,sBAAsB,EAAC,kBAAkB,EAAC,uBAAuB;IACzF,oEAAoE;IACpE,sEAAsE;IACtE,wFAAwF;IACxF,mBAAmB;IACnB,aAAa;IACb,2BAA2B,EAAC,oBAAoB,EAAC,0BAA0B,EAAC,yBAAyB;IACrG,sBAAsB,EAAC,oBAAoB,EAAC,uBAAuB,EAAC,yBAAyB;IAC7F,sBAAsB,EAAC,mBAAmB,EAAC,aAAa,EAAC,qBAAqB,EAAC,mBAAmB;CAC1F,CAAC;AAGX;;;;;GAKG;AAEH,MAAM,UAAU,4BAA4B,CAC1C,QAA4B,EAC5B,KAAwB,EACxB,SAAkC;IAElC,MAAM,MAAM,GAAqD,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3F,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC"}

package/dist/events/wire-schema.d.ts

@@ -394,12 +394,12 @@ export declare const TaskCompletedEventSchema: z.ZodObject<{
         research: "research";
         review: "review";
         delegate: "delegate";
+        "execute-plan": "execute-plan";
+        "journal-record": "journal-record";
         audit: "audit";
         debug: "debug";
         investigate: "investigate";
-        "execute-plan": "execute-plan";
         retry: "retry";
-        "journal-record": "journal-record";
         "journal-recall": "journal-recall";
         "register-context-block": "register-context-block";
     }>;
@@ -719,12 +719,12 @@ export declare const ValidatedTaskCompletedEventSchema: z.ZodObject<{
         research: "research";
         review: "review";
         delegate: "delegate";
+        "execute-plan": "execute-plan";
+        "journal-record": "journal-record";
         audit: "audit";
         debug: "debug";
         investigate: "investigate";
-        "execute-plan": "execute-plan";
         retry: "retry";
-        "journal-record": "journal-record";
         "journal-recall": "journal-recall";
         "register-context-block": "register-context-block";
     }>;

package/dist/lifecycle/derive-completion.d.ts

@@ -13,6 +13,10 @@ export interface CompletionInputs {
     unaddressedFindingIds: string[] | undefined;
     commitKind: 'committed' | 'no_op' | undefined;
     criteriaSucceeded: string[] | undefined;
+    /** Goal mode (write routes): commits in baseSha..HEAD. When defined, the
+     *  goal branch applies — completion = implement advanced AND ≥1 commit
+     *  (the agent self-commits; there is no MMA review verdict / commit gate). */
+    goalCommitCount?: number;
 }
 export interface CompletionResult {
     completed: boolean;

package/dist/lifecycle/derive-completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive-completion.d.ts","sourceRoot":"","sources":["../../src/lifecycle/derive-completion.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5G,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qBAAqB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CA8B3E;AAMD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAwB/E"}
+{"version":3,"file":"derive-completion.d.ts","sourceRoot":"","sources":["../../src/lifecycle/derive-completion.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5G,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qBAAqB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC;;kFAE8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAwC3E;AAMD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CA2B/E"}

package/dist/lifecycle/derive-completion.js

@@ -22,7 +22,17 @@ export function deriveCompletion(inputs) {
             reasons.push('no successful criteria');
         return { completed: implementOk && criteriaOk, reasons };
     }
-    // 3. Write routes: review + commit must pass
+    // 3a. Goal-mode write routes: the agent self-commits and there is no MMA
+    // review verdict / commit gate. Completion = implementer advanced AND at
+    // least one commit landed in baseSha..HEAD (mirrors the status truth table:
+    // failed only on zero commits).
+    if (inputs.goalCommitCount !== undefined) {
+        const committed = inputs.goalCommitCount > 0;
+        if (!committed)
+            reasons.push('no commits landed');
+        return { completed: implementOk && committed, reasons };
+    }
+    // 3. Write routes (legacy non-goal): review + commit must pass
     const reviewOk = inputs.reviewPolicy === 'none' ||
         inputs.reviewVerdict === 'approved' ||
         (inputs.reviewVerdict === 'changes_required' &&
@@ -61,6 +71,9 @@ export function extractCompletionInputs(state) {
         unaddressedFindingIds: state.unaddressedFindingIds ?? last?.unaddressedFindingIds,
         commitKind,
         criteriaSucceeded: last?.criteriaSucceeded,
+        ...(state.goalCommitCount !== undefined && {
+            goalCommitCount: state.goalCommitCount,
+        }),
     };
 }
 //# sourceMappingURL=derive-completion.js.map

package/dist/lifecycle/derive-completion.js.map

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

package/dist/lifecycle/git-exec.d.ts

@@ -0,0 +1,62 @@
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+/**
+ * Run a git subcommand in `cwd`. Never throws — a non-zero exit (or spawn
+ * failure) is returned as `{ code, stderr }`. Shared by the goal-set executor
+ * (preconditions, baseSha capture, git-log report) so git plumbing lives in one
+ * place rather than inline in a handler.
+ */
+export declare function gitC(cwd: string, args: string[]): Promise<GitResult>;
+/** True when `cwd` is inside a git work-tree. */
+export declare function isInsideWorkTree(cwd: string): Promise<boolean>;
+/** Resolved HEAD sha, or null when HEAD is unborn / unresolvable. */
+export declare function currentHead(cwd: string): Promise<string | null>;
+/**
+ * True when the work-tree has no uncommitted changes (tracked or untracked).
+ * Uses `git status --porcelain` — empty output means clean.
+ */
+export declare function isCleanWorkTree(cwd: string): Promise<boolean>;
+/** True when `ancestor` is an ancestor of (or equal to) `descendant`. */
+export declare function isAncestor(cwd: string, ancestor: string, descendant: string): Promise<boolean>;
+/** Number of commits in `base..HEAD` (0 when none / base unresolved). */
+export declare function commitCount(cwd: string, base: string): Promise<number>;
+export interface GitLogCommit {
+    sha: string;
+    subject: string;
+    filesChanged: string[];
+}
+/**
+ * Structured commit list for `base..HEAD`, oldest-first. Subjects + changed
+ * files only (no patch bodies) so the payload stays bounded — see the spec's
+ * git-log-format note. Returns [] when base is unresolved or there are none.
+ */
+export declare function gitLogCommits(cwd: string, base: string): Promise<GitLogCommit[]>;
+/**
+ * Render `base..HEAD` as `git log --stat`-style text for the phase-2 handoff,
+ * truncated to `maxBytes` with a marker. Subjects + per-commit file lists, no
+ * patch body.
+ */
+export declare function renderGitLogStat(cwd: string, base: string, maxBytes?: number): Promise<{
+    text: string;
+    truncated: boolean;
+}>;
+/**
+ * Render the UNCOMMITTED working-tree state for the phase-2 prompt: `git status
+ * --short` plus a `--stat` of staged+unstaged changes (no patch body). This is
+ * what lets the review-fix tier see work the implementer wrote but did NOT
+ * commit — without it, an implementer that under-commits leaves phase 2 blind.
+ * Returns '(clean working tree)' when there are no uncommitted changes.
+ */
+export declare function renderWorkingTreeStatus(cwd: string, maxBytes?: number): Promise<string>;
+/**
+ * Ensure a committer identity is resolvable for the agent's own `git commit`
+ * calls. The agent commits in its own subprocess, so env overrides won't reach
+ * it — instead, when the repo/global config has no identity, set a goal-set
+ * identity in the **local repo config** so the agent's commits inherit it.
+ * Returns true when it set one, false when an identity already existed.
+ */
+export declare function ensureGitIdentity(cwd: string, goalId: string): Promise<boolean>;
+//# sourceMappingURL=git-exec.d.ts.map

package/dist/lifecycle/git-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-exec.d.ts","sourceRoot":"","sources":["../../src/lifecycle/git-exec.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAY1E;AAED,iDAAiD;AACjD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGpE;AAED,qEAAqE;AACrE,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKrE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnE;AAED,yEAAyE;AACzE,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIpG;AAED,yEAAyE;AACzE,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBtF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAa,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAOtI;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAShG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrF"}

package/dist/lifecycle/git-exec.js

@@ -0,0 +1,135 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileP = promisify(execFile);
+/**
+ * Run a git subcommand in `cwd`. Never throws — a non-zero exit (or spawn
+ * failure) is returned as `{ code, stderr }`. Shared by the goal-set executor
+ * (preconditions, baseSha capture, git-log report) so git plumbing lives in one
+ * place rather than inline in a handler.
+ */
+export async function gitC(cwd, args) {
+    try {
+        const { stdout, stderr } = await execFileP('git', ['-C', cwd, ...args], { windowsHide: true });
+        return { stdout, stderr, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: e.stdout ?? '',
+            stderr: e.stderr ?? e.message ?? String(err),
+            code: typeof e.code === 'number' ? e.code : 1,
+        };
+    }
+}
+/** True when `cwd` is inside a git work-tree. */
+export async function isInsideWorkTree(cwd) {
+    const r = await gitC(cwd, ['rev-parse', '--is-inside-work-tree']);
+    return r.code === 0 && r.stdout.trim() === 'true';
+}
+/** Resolved HEAD sha, or null when HEAD is unborn / unresolvable. */
+export async function currentHead(cwd) {
+    const r = await gitC(cwd, ['rev-parse', 'HEAD']);
+    if (r.code !== 0)
+        return null;
+    const sha = r.stdout.trim();
+    return sha.length > 0 ? sha : null;
+}
+/**
+ * True when the work-tree has no uncommitted changes (tracked or untracked).
+ * Uses `git status --porcelain` — empty output means clean.
+ */
+export async function isCleanWorkTree(cwd) {
+    const r = await gitC(cwd, ['status', '--porcelain']);
+    return r.code === 0 && r.stdout.trim() === '';
+}
+/** True when `ancestor` is an ancestor of (or equal to) `descendant`. */
+export async function isAncestor(cwd, ancestor, descendant) {
+    if (ancestor === descendant)
+        return true;
+    const r = await gitC(cwd, ['merge-base', '--is-ancestor', ancestor, descendant]);
+    return r.code === 0;
+}
+/** Number of commits in `base..HEAD` (0 when none / base unresolved). */
+export async function commitCount(cwd, base) {
+    const r = await gitC(cwd, ['rev-list', '--count', `${base}..HEAD`]);
+    if (r.code !== 0)
+        return 0;
+    const n = Number.parseInt(r.stdout.trim(), 10);
+    return Number.isFinite(n) ? n : 0;
+}
+/**
+ * Structured commit list for `base..HEAD`, oldest-first. Subjects + changed
+ * files only (no patch bodies) so the payload stays bounded — see the spec's
+ * git-log-format note. Returns [] when base is unresolved or there are none.
+ */
+export async function gitLogCommits(cwd, base) {
+    // %x00 record sep, %x1e field sep: sha, subject. Then --name-only file lines.
+    const r = await gitC(cwd, [
+        'log', '--reverse', '--name-only', '--no-color',
+        '--pretty=format:%x1e%H%x1f%s', `${base}..HEAD`,
+    ]);
+    if (r.code !== 0 || r.stdout.trim() === '')
+        return [];
+    const commits = [];
+    const records = r.stdout.split('\x1e').filter((s) => s.length > 0);
+    for (const rec of records) {
+        const nlIdx = rec.indexOf('\n');
+        const header = nlIdx === -1 ? rec : rec.slice(0, nlIdx);
+        const [sha, subject] = header.split('\x1f');
+        const fileBlock = nlIdx === -1 ? '' : rec.slice(nlIdx + 1);
+        const filesChanged = fileBlock.split('\n').map((l) => l.trim()).filter((l) => l.length > 0);
+        commits.push({ sha: (sha ?? '').trim(), subject: (subject ?? '').trim(), filesChanged });
+    }
+    return commits;
+}
+/**
+ * Render `base..HEAD` as `git log --stat`-style text for the phase-2 handoff,
+ * truncated to `maxBytes` with a marker. Subjects + per-commit file lists, no
+ * patch body.
+ */
+export async function renderGitLogStat(cwd, base, maxBytes = 128 * 1024) {
+    const r = await gitC(cwd, ['log', '--stat', '--no-patch', '--no-color', `${base}..HEAD`]);
+    const full = r.code === 0 ? r.stdout : '';
+    if (Buffer.byteLength(full, 'utf8') <= maxBytes)
+        return { text: full, truncated: false };
+    // Truncate on a UTF-8-safe boundary.
+    const buf = Buffer.from(full, 'utf8').subarray(0, maxBytes);
+    return { text: buf.toString('utf8') + '\n…[git_log_truncated]…\n', truncated: true };
+}
+/**
+ * Render the UNCOMMITTED working-tree state for the phase-2 prompt: `git status
+ * --short` plus a `--stat` of staged+unstaged changes (no patch body). This is
+ * what lets the review-fix tier see work the implementer wrote but did NOT
+ * commit — without it, an implementer that under-commits leaves phase 2 blind.
+ * Returns '(clean working tree)' when there are no uncommitted changes.
+ */
+export async function renderWorkingTreeStatus(cwd, maxBytes = 64 * 1024) {
+    const status = await gitC(cwd, ['status', '--short']);
+    if (status.code !== 0)
+        return '(working-tree status unavailable)';
+    if (status.stdout.trim() === '')
+        return '(clean working tree — nothing uncommitted)';
+    const stat = await gitC(cwd, ['diff', 'HEAD', '--stat', '--no-color']);
+    const text = `Uncommitted changes (git status --short):\n${status.stdout}\n` +
+        (stat.code === 0 && stat.stdout.trim() ? `\nDiff stat vs HEAD:\n${stat.stdout}` : '');
+    if (Buffer.byteLength(text, 'utf8') <= maxBytes)
+        return text;
+    return Buffer.from(text, 'utf8').subarray(0, maxBytes).toString('utf8') + '\n…[truncated]…\n';
+}
+/**
+ * Ensure a committer identity is resolvable for the agent's own `git commit`
+ * calls. The agent commits in its own subprocess, so env overrides won't reach
+ * it — instead, when the repo/global config has no identity, set a goal-set
+ * identity in the **local repo config** so the agent's commits inherit it.
+ * Returns true when it set one, false when an identity already existed.
+ */
+export async function ensureGitIdentity(cwd, goalId) {
+    const name = await gitC(cwd, ['config', 'user.name']);
+    const email = await gitC(cwd, ['config', 'user.email']);
+    if (name.code === 0 && name.stdout.trim() && email.code === 0 && email.stdout.trim())
+        return false;
+    await gitC(cwd, ['config', 'user.name', `MMA Goal ${goalId}`]);
+    await gitC(cwd, ['config', 'user.email', 'noreply@mmagent.local']);
+    return true;
+}
+//# sourceMappingURL=git-exec.js.map

package/dist/lifecycle/git-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-exec.js","sourceRoot":"","sources":["../../src/lifecycle/git-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAQtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAW,EAAE,IAAc;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4E,CAAC;QACvF,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;YACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;YAC5C,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;AACpD,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,QAAgB,EAAE,UAAkB;IAChF,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,IAAY;IACzD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAQD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY;IAC3D,8EAA8E;IAC9E,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE;QACxB,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY;QAC/C,8BAA8B,EAAE,GAAG,IAAI,QAAQ;KAChD,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACtD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAY,EAAE,QAAQ,GAAG,GAAG,GAAG,IAAI;IACrF,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzF,qCAAqC;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5D,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,2BAA2B,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACvF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAW,EAAE,QAAQ,GAAG,EAAE,GAAG,IAAI;IAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,mCAAmC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,4CAA4C,CAAC;IACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,8CAA8C,MAAM,CAAC,MAAM,IAAI;QAC1E,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC;AAChG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,MAAc;IACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACnG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lifecycle/goal-builder.d.ts

@@ -0,0 +1,35 @@
+import type { Goal, GoalPhase, GoalSource, GoalReviewPolicy } from '../types/goal.js';
+import type { ToolMode, SandboxPolicy } from '../types/task-spec.js';
+export interface TaskInput {
+    heading: string;
+    body: string;
+    /** 1-based plan-phase; defaults to 1 (single checkpoint). */
+    phase?: number;
+}
+export interface AssembleGoalArgs {
+    source: GoalSource;
+    cwd: string;
+    tasks: TaskInput[];
+    /** Phase tiers. [implement] or [implement, review-fix]. */
+    phases: GoalPhase[];
+    reviewPolicy: GoalReviewPolicy;
+    tools: ToolMode;
+    sandboxPolicy: SandboxPolicy;
+    skills?: string[];
+    contextBlockIds?: string[];
+    goalId?: string;
+    /** Route-specific procedure prepended to both phase prompts. */
+    preamble?: string;
+    /** Operator's per-task wall-clock budget (config.defaults.timeoutMs); the phase
+     *  deadline scales off it. Falls back to PER_TASK_DEFAULT_MS when unset. */
+    perTaskTimeoutMs?: number;
+}
+export declare function assembleGoal(args: AssembleGoalArgs): Goal;
+/**
+ * Map a goal into the single TaskSpec the executor dispatches. The implement
+ * prompt is materialized into `prompt`; phase-1 tier becomes `agentType`;
+ * `reviewPolicy` collapses to the lifecycle's none/full axis (the review-fix
+ * stage only distinguishes none vs run).
+ */
+export declare function goalToTaskSpec(goal: Goal, implementPrompt: string, timeoutMs: number): import('../types.js').TaskSpec;
+//# sourceMappingURL=goal-builder.d.ts.map

package/dist/lifecycle/goal-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-builder.d.ts","sourceRoot":"","sources":["../../src/lifecycle/goal-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAY,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,2DAA2D;IAC3D,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;gFAC4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA2BzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,aAAa,EAAE,QAAQ,CAchC"}

package/dist/lifecycle/goal-builder.js

@@ -0,0 +1,56 @@
+// Shared Goal assembler. Each write route's briefSlot derives its task list +
+// tiers + reviewPolicy and calls assembleGoal, which renders the planText and
+// fills the Goal. This is the single construction point — adding a write route
+// means a new briefSlot calling this, nothing else.
+import { randomUUID } from 'node:crypto';
+import { renderPlanText, derivePhaseTimeoutMs, GOAL_IDLE_STALL_MS } from './goal-prompts.js';
+export function assembleGoal(args) {
+    const goalTasks = args.tasks.map((t, i) => ({
+        n: i + 1,
+        heading: t.heading.trim() || `task ${i + 1}`,
+        body: t.body,
+        phase: t.phase ?? 1,
+    }));
+    const phaseCount = new Set(goalTasks.map((t) => t.phase)).size;
+    // reviewPolicy='none' collapses to phase-1 only (configured phase-1 tier).
+    const phases = args.reviewPolicy === 'none' ? [args.phases[0]] : args.phases;
+    return {
+        goalId: args.goalId ?? randomUUID(),
+        cwd: args.cwd,
+        source: args.source,
+        tasks: goalTasks,
+        phaseCount,
+        planText: renderPlanText(goalTasks, phaseCount),
+        ...(args.preamble && { preamble: args.preamble }),
+        phases,
+        reviewPolicy: args.reviewPolicy,
+        sandboxPolicy: args.sandboxPolicy,
+        tools: args.tools,
+        ...(args.skills && args.skills.length > 0 && { skills: args.skills }),
+        ...(args.contextBlockIds && args.contextBlockIds.length > 0 && { contextBlockIds: args.contextBlockIds }),
+        goalPhaseTimeoutMs: derivePhaseTimeoutMs(goalTasks.length, args.perTaskTimeoutMs),
+        goalIdleStallMs: GOAL_IDLE_STALL_MS,
+    };
+}
+/**
+ * Map a goal into the single TaskSpec the executor dispatches. The implement
+ * prompt is materialized into `prompt`; phase-1 tier becomes `agentType`;
+ * `reviewPolicy` collapses to the lifecycle's none/full axis (the review-fix
+ * stage only distinguishes none vs run).
+ */
+export function goalToTaskSpec(goal, implementPrompt, timeoutMs) {
+    return {
+        prompt: implementPrompt,
+        goal,
+        agentType: goal.phases[0].tier,
+        reviewPolicy: goal.reviewPolicy === 'none' ? 'none' : 'full',
+        cwd: goal.cwd,
+        tools: goal.tools,
+        sandboxPolicy: goal.sandboxPolicy,
+        timeoutMs: goal.goalPhaseTimeoutMs ?? timeoutMs,
+        ...(goal.goalIdleStallMs !== undefined && { idleStallMs: goal.goalIdleStallMs }),
+        ...(goal.skills && { skills: goal.skills }),
+        ...(goal.contextBlockIds && { contextBlockIds: goal.contextBlockIds }),
+    };
+}
+//# sourceMappingURL=goal-builder.js.map

package/dist/lifecycle/goal-builder.js.map

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

package/dist/lifecycle/goal-preconditions.d.ts

@@ -0,0 +1,21 @@
+import type { Goal } from '../types/goal.js';
+export type GoalPreconditionCode = 'empty_plan' | 'plan_too_large' | 'not_a_git_repo' | 'dirty_working_tree';
+export type GoalPreconditionResult = {
+    ok: true;
+    baseSha: string;
+} | {
+    ok: false;
+    code: GoalPreconditionCode;
+    message: string;
+};
+/** Synchronous build-time guards (no git): empty plan, oversized plan. */
+export declare function checkGoalShape(goal: Goal): {
+    ok: true;
+} | {
+    ok: false;
+    code: GoalPreconditionCode;
+    message: string;
+};
+/** Git preconditions + baseSha capture. Run inside withWriteGoalLock. */
+export declare function checkGitPreconditions(goal: Goal): Promise<GoalPreconditionResult>;
+//# sourceMappingURL=goal-preconditions.d.ts.map

package/dist/lifecycle/goal-preconditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-preconditions.d.ts","sourceRoot":"","sources":["../../src/lifecycle/goal-preconditions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASpH;AAED,yEAAyE;AACzE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAcvF"}

package/dist/lifecycle/goal-preconditions.js

@@ -0,0 +1,33 @@
+// Hard-fail preconditions for a write goal-set, plus baseSha capture. ALL of
+// this runs INSIDE withWriteGoalLock so the clean-tree-at-baseSha guarantee
+// holds against other serialized goal-sets on the same repo.
+import { isInsideWorkTree, currentHead, isCleanWorkTree, ensureGitIdentity } from './git-exec.js';
+import { MAX_PLAN_TEXT_BYTES } from './goal-prompts.js';
+/** Synchronous build-time guards (no git): empty plan, oversized plan. */
+export function checkGoalShape(goal) {
+    if (!goal.tasks || goal.tasks.length === 0) {
+        return { ok: false, code: 'empty_plan', message: 'goal has no tasks' };
+    }
+    const bytes = Buffer.byteLength(goal.planText, 'utf8');
+    if (bytes > MAX_PLAN_TEXT_BYTES) {
+        return { ok: false, code: 'plan_too_large', message: `planText ${bytes}B exceeds ${MAX_PLAN_TEXT_BYTES}B` };
+    }
+    return { ok: true };
+}
+/** Git preconditions + baseSha capture. Run inside withWriteGoalLock. */
+export async function checkGitPreconditions(goal) {
+    const cwd = goal.cwd;
+    if (!(await isInsideWorkTree(cwd))) {
+        return { ok: false, code: 'not_a_git_repo', message: `${cwd} is not inside a git work-tree` };
+    }
+    const head = await currentHead(cwd);
+    if (!head) {
+        return { ok: false, code: 'not_a_git_repo', message: `${cwd} has no resolvable HEAD (unborn branch)` };
+    }
+    if (!(await isCleanWorkTree(cwd))) {
+        return { ok: false, code: 'dirty_working_tree', message: `${cwd} has uncommitted changes; goal mode requires a clean tree` };
+    }
+    await ensureGitIdentity(cwd, goal.goalId);
+    return { ok: true, baseSha: head };
+}
+//# sourceMappingURL=goal-preconditions.js.map

package/dist/lifecycle/goal-preconditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-preconditions.js","sourceRoot":"","sources":["../../src/lifecycle/goal-preconditions.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,6DAA6D;AAC7D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAaxD,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,mBAAmB,GAAG,EAAE,CAAC;IAC9G,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAU;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,GAAG,gCAAgC,EAAE,CAAC;IAChG,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,GAAG,yCAAyC,EAAE,CAAC;IACzG,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,GAAG,2DAA2D,EAAE,CAAC;IAC/H,CAAC;IACD,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/lifecycle/goal-prompts.d.ts

@@ -0,0 +1,27 @@
+import type { Goal, GoalTask } from '../types/goal.js';
+export declare const PER_TASK_DEFAULT_MS = 600000;
+export declare const GOAL_IDLE_STALL_MS: number;
+export declare const MAX_PLAN_TEXT_BYTES: number;
+export declare const MAX_GIT_LOG_BYTES: number;
+/**
+ * Per-phase wall-clock for a goal-set of `taskCount` tasks. Scales with the task
+ * count off the operator's configured per-task budget (`config.defaults.timeoutMs`),
+ * falling back to PER_TASK_DEFAULT_MS only when no config timeout is set. A goal
+ * runs all N tasks in one send, so the phase budget is N × the per-task budget.
+ */
+export declare function derivePhaseTimeoutMs(taskCount: number, perTaskMs?: number): number;
+/** First non-empty line of `text`, trimmed to `max` chars (heading derivation). */
+export declare function firstLine(text: string, max?: number): string;
+/** Render the goal's tasks into one prompt body with PHASE + [task N] markers. */
+export declare function renderPlanText(tasks: GoalTask[], phaseCount: number): string;
+/** Phase-1 implement prompt over the whole plan. */
+export declare function implementGoalPrompt(goal: Goal): string;
+/**
+ * Phase-2 review-fix prompt. You are the COMPLETION GUARANTOR, not just a
+ * reviewer of commits. The implementer (a cheaper tier) attempted every task but
+ * may have left some incomplete, wrong, OR done-but-uncommitted. Your job is to
+ * make sure EVERY task ends up correctly implemented AND committed — walking the
+ * tasks one by one against both the commit log and the uncommitted working tree.
+ */
+export declare function reviewFixGoalPrompt(goal: Goal, gitLog: string, workingTree: string): string;
+//# sourceMappingURL=goal-prompts.d.ts.map

package/dist/lifecycle/goal-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-prompts.d.ts","sourceRoot":"","sources":["../../src/lifecycle/goal-prompts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGvD,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAiC,CAAC;AACjE,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,eAAO,MAAM,iBAAiB,QAAa,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAIxD;AAqDD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAW5E;AA8CD,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAiD3F"}