@zhixuan92/multi-model-agent-core 3.6.7 → 3.8.0

package/README.md

@@ -102,6 +102,10 @@ mmagent logs --follow --batch=<id>   # tail + filter
 
 As of 3.4.0 every task-execution event the worker emits to the verbose stderr stream is also written to the JSONL log via a single `emit(TaskEvent)` writer — schema parity across both sinks. Crash/disconnect events (`startup`, `request_start`, `request_complete`, `shutdown`, `error`) are written unconditionally; per-task events (`heartbeat`, `stage_change`, `tool_call`, `turn_complete`, etc.) flow through the same writer.
 
+## What's new
+
+Latest: **3.8.0** — read-only reviewed lifecycle: all 5 read-only routes (audit, review, verify, investigate, debug) now run a single `quality_only` review with bounded rework, structured `findings[]` worker output, and forced cross-tier review (worker complex, reviewer standard). Verify worker tier upgraded to complex. `MMAGENT_READ_ONLY_REVIEW` kill switch for rollback. Full history: [CHANGELOG](https://github.com/zhixuan312/multi-model-agent/blob/master/CHANGELOG.md).
+
 ## Full documentation
 
 → **[github.com/zhixuan312/multi-model-agent](https://github.com/zhixuan312/multi-model-agent)**

package/dist/config/read-only-review-flag.d.ts

@@ -0,0 +1,8 @@
+declare const READ_ONLY_ROUTES: readonly ["audit_document", "review_code", "verify_work", "investigate_codebase", "debug_task"];
+type ReadOnlyRoute = (typeof READ_ONLY_ROUTES)[number];
+export interface ReadOnlyReviewFlag {
+    isEnabledFor(route: ReadOnlyRoute): boolean;
+}
+export declare function resolveReadOnlyReviewFlag(): ReadOnlyReviewFlag;
+export {};
+//# sourceMappingURL=read-only-review-flag.d.ts.map

package/dist/config/read-only-review-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-review-flag.d.ts","sourceRoot":"","sources":["../../src/config/read-only-review-flag.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,gBAAgB,iGAEZ,CAAC;AAEX,KAAK,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;CAC7C;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,CAM9D"}

package/dist/config/read-only-review-flag.js

@@ -0,0 +1,13 @@
+const READ_ONLY_ROUTES = [
+    'audit_document', 'review_code', 'verify_work', 'investigate_codebase', 'debug_task',
+];
+export function resolveReadOnlyReviewFlag() {
+    const raw = process.env['MMAGENT_READ_ONLY_REVIEW'];
+    if (raw === undefined)
+        return { isEnabledFor: () => true };
+    if (raw === 'disabled')
+        return { isEnabledFor: () => false };
+    const allowed = new Set(raw.split(',').map((s) => s.trim()).filter(Boolean));
+    return { isEnabledFor: (route) => allowed.has(route) };
+}
+//# sourceMappingURL=read-only-review-flag.js.map

package/dist/config/read-only-review-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-review-flag.js","sourceRoot":"","sources":["../../src/config/read-only-review-flag.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;IACvB,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,YAAY;CAC5E,CAAC;AAQX,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACpD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,OAAO,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/delegate-with-escalation.d.ts

@@ -1,4 +1,4 @@
-import type { TaskSpec, RunResult, Provider } from './types.js';
+import type { TaskSpec, RunResult, Provider, AgentType } from './types.js';
 import type { InternalRunnerEvent } from './runners/types.js';
 export interface DelegateOptions {
     explicitlyPinned?: boolean;
@@ -17,6 +17,12 @@ export interface DelegateOptions {
      * fallback loops short-circuit so the user gets *something* back.
      */
     abortSignal?: AbortSignal;
+    /**
+     * Tier the caller is invoking this delegate for. Forwarded onto the
+     * per-attempt `worker_start` runner event so observability can attribute
+     * each provider attempt to its assigned tier.
+     */
+    assignedTier?: AgentType;
 }
 export declare function delegateWithEscalation(task: TaskSpec, chain: Provider[], options?: DelegateOptions): Promise<RunResult>;
 //# sourceMappingURL=delegate-with-escalation.d.ts.map

package/dist/delegate-with-escalation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegate-with-escalation.d.ts","sourceRoot":"","sources":["../src/delegate-with-escalation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAiBD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,SAAS,CAAC,CA+KpB"}
+{"version":3,"file":"delegate-with-escalation.d.ts","sourceRoot":"","sources":["../src/delegate-with-escalation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAiBD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAmMpB"}

package/dist/delegate-with-escalation.js

@@ -74,6 +74,19 @@ export async function delegateWithEscalation(task, chain, options = {}) {
                         ? Math.min(effectiveTimeoutMs, remainingClamped)
                         : remainingClamped;
             }
+            // ProviderConfig.type is one of: 'claude' | 'claude-compatible' | 'openai-compatible' | 'codex'.
+            // InternalRunnerEvent.providerType only allows the three runner families;
+            // map 'claude-compatible' onto 'claude' (same runner backend).
+            const cfgType = provider.config.type;
+            const providerTypeName = cfgType === 'claude' || cfgType === 'claude-compatible' ? 'claude' :
+                cfgType === 'codex' ? 'codex' :
+                    'openai-compatible';
+            safeSink?.({
+                kind: 'worker_start',
+                model: provider.config.model,
+                providerType: providerTypeName,
+                tier: options.assignedTier ?? 'standard',
+            });
             result = await provider.run(task.prompt, {
                 tools: task.tools,
                 timeoutMs: effectiveTimeoutMs,
@@ -124,10 +137,15 @@ export async function delegateWithEscalation(task, chain, options = {}) {
         };
         attempts.push({ result, record });
         if (result.status === 'ok') {
-            return {
-                ...result,
-                escalationLog: attempts.map((a) => a.record),
+            const terminationReason = {
+                cause: 'finished',
+                turnsUsed: result.turns,
+                hasFileArtifacts: result.filesWritten.length > 0,
+                usedShell: result.toolCalls.some(tc => extractToolName(tc) === 'runShell'),
+                workerSelfAssessment: result.workerStatus ?? null,
+                wasPromoted: false,
             };
+            return { ...result, terminationReason, escalationLog: attempts.map((a) => a.record) };
         }
         // Skip the next provider in the fallback chain if the task-level
         // deadline has been hit or the stall watchdog aborted.
@@ -162,7 +180,7 @@ export async function delegateWithEscalation(task, chain, options = {}) {
     const finalStatus = baseStatus === 'incomplete' &&
         best.workerStatus === 'done' &&
         outputIsSubstantive &&
-        (best.filesWritten.length > 0 || hasCompletedWork(best.toolCalls) || hasShellVerification)
+        (best.filesWritten.length > 0 || hasCompletedWork(best.toolCalls) || hasShellVerification || task.skipCompletionHeuristic === true)
         ? 'ok'
         : baseStatus;
     const wasPromoted = finalStatus === 'ok' && baseStatus === 'incomplete';

package/dist/delegate-with-escalation.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegate-with-escalation.js","sourceRoot":"","sources":["../src/delegate-with-escalation.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,mDAAmD;AASnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE7E,SAAS,WAAW,CAAC,MAAiB,EAAE,SAAkB;IACxD,IAAI,SAAS,KAAK,sBAAsB;QAAE,OAAO,sBAAsB,CAAC;IACxE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC;IACvC,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IACjD,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAqBD,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;AACxF,MAAM,cAAc,GAAG,SAAS,CAAC;AACjC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,WAAW,CAAC;IACvD,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAc,EACd,KAAiB,EACjB,UAA2B,EAAE;IAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,QAAQ,GAAuD,OAAO,CAAC,UAAU;QACrF,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,CAAC;gBACH,OAAO,CAAC,UAAW,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;YACT,CAAC;QACH,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,QAAQ,GAAmD,EAAE,CAAC;IAEpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE1B,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAClD,QAAQ,CAAC;gBACP,IAAI,EAAE,kBAAkB;gBACxB,gBAAgB,EAAE,IAAI,CAAC,QAAQ;gBAC/B,cAAc,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtD,YAAY,EAAE,QAAQ,CAAC,IAAI;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,wBAAwB,GAAG,CAAC,CAAC;QACjC,IAAI,iBAAiB,GAAG,EAAE,CAAC;QAE3B,IAAI,MAAiB,CAAC;QACtB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,MAAM,kBAAkB,GACtB,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE/F,oEAAoE;YACpE,qEAAqE;YACrE,gEAAgE;YAChE,iCAAiC;YACjC,IAAI,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC;YACxC,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACtD,MAAM,gBAAgB,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,kBAAkB;oBAChB,kBAAkB,KAAK,SAAS;wBAC9B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;wBAChD,CAAC,CAAC,gBAAgB,CAAC;YACzB,CAAC;YAED,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE;gBACvC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,kBAAkB;gBAC7B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;gBACrD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,kBAAkB;gBAC9B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,UAAU,EAAE,QAAQ;gBACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE;oBACzB,wBAAwB,GAAG,IAAI,CAAC,WAAW,CAAC;oBAC5C,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;gBAClC,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,UAAU,KAAK,CAAC,IAAI,OAAO,IAAI,UAAU;gBAAE,MAAM;YAE/E,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAC9C,iBAAiB,IAAI,WAAW,CAAC;YACjC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,iBAAiB,IAAI,IAAI,CAAC,UAAU;gBAAE,MAAM;YAEjF,kEAAkE;YAClE,uEAAuE;YACvE,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,cAAc;gBAAE,MAAM;YACxF,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO;gBAAE,MAAM;YAExC,MAAM,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrD,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5F,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,MAAM,GAAkB;YAC5B,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;YACvC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;YAC7B,wBAAwB;YACxB,iBAAiB;YACjB,MAAM,EACJ,MAAM,CAAC,MAAM,KAAK,IAAI;gBACpB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;SAClD,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,MAAM;gBACT,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aAC7C,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,uDAAuD;QACvD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YACjF,MAAM;QACR,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YACjC,MAAM;QACR,CAAC;QAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC7B,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM;gBAC5C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC1D,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aAC7C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE7E,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAChD,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAErE,2FAA2F;IAC3F,uEAAuE;IACvE,MAAM,mBAAmB,GACvB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAC5D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC;IAC3F,MAAM,WAAW,GACf,UAAU,KAAK,YAAY;QAC3B,IAAI,CAAC,YAAY,KAAK,MAAM;QAC5B,mBAAmB;QACnB,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,oBAAoB,CAAC;QACxF,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,WAAW,GAAG,WAAW,KAAK,IAAI,IAAI,UAAU,KAAK,YAAY,CAAC;IACxE,MAAM,iBAAiB,GAAsB;QAC3C,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;QAC/C,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAC9C,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC;QACxE,oBAAoB,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;QAC/C,WAAW;KACZ,CAAC;IAEF,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,WAAW;QACnB,iBAAiB;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,WAAW;QACxC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,WAAW,CAAC;QACtD,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;KAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"delegate-with-escalation.js","sourceRoot":"","sources":["../src/delegate-with-escalation.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics/http-server-log.d.ts

@@ -0,0 +1,63 @@
+import type { ShutdownCause, SessionCloseReason } from './types.js';
+import type { JsonlWriter } from './jsonl-writer.js';
+export type { ShutdownCause, SessionCloseReason };
+export interface HttpServerLog {
+    startup(version: string, extras?: {
+        transport?: 'stdio' | 'http';
+    }): void;
+    requestStart(params: {
+        tool: string;
+        requestId: string;
+        sessionId?: string;
+        cwd?: string;
+    }): void;
+    requestComplete(params: {
+        tool: string;
+        requestId: string;
+        durationMs: number;
+        responseBytes: number;
+        status: 'ok' | 'error';
+        sessionId?: string;
+        cwd?: string;
+    }): void;
+    error(kind: string, err: unknown): void;
+    shutdown(cause: ShutdownCause): void;
+    expectedPath(): string;
+    sessionOpen(params: {
+        sessionId: string;
+        cwd: string;
+        remoteAddr?: string;
+    }): void;
+    sessionClose(params: {
+        sessionId: string;
+        cwd: string;
+        reason: SessionCloseReason;
+        durationMs: number;
+    }): void;
+    connectionRejected(params: {
+        reason: string;
+        httpStatus: number;
+        cwd?: string;
+        remoteAddr?: string;
+    }): void;
+    requestRejected(params: {
+        reason: string;
+        httpStatus: number;
+        sessionIdAttempted?: string;
+    }): void;
+    projectCreated(params: {
+        cwd: string;
+    }): void;
+    projectEvicted(params: {
+        cwd: string;
+        idleMs: number;
+    }): void;
+}
+export interface CreateHttpServerLogOptions {
+    enabled: boolean;
+    writer: JsonlWriter;
+    now?: () => Date;
+    stderrWrite?: (data: string) => void;
+}
+export declare function createHttpServerLog(options: CreateHttpServerLogOptions): HttpServerLog;
+//# sourceMappingURL=http-server-log.d.ts.map

package/dist/diagnostics/http-server-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server-log.d.ts","sourceRoot":"","sources":["../../src/diagnostics/http-server-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,YAAY,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,eAAe,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,YAAY,IAAI,MAAM,CAAC;IAEvB,WAAW,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnF,YAAY,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/G,kBAAkB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5G,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,cAAc,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAmBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CA0Kf"}

package/dist/diagnostics/http-server-log.js

@@ -0,0 +1,188 @@
+function normaliseError(err) {
+    if (err instanceof Error) {
+        return {
+            message: err.message,
+            ...(typeof err.stack === 'string' && err.stack.length > 0 ? { stack: err.stack } : {}),
+        };
+    }
+    if (typeof err === 'string')
+        return { message: err };
+    if (err === null)
+        return { message: 'null' };
+    if (err === undefined)
+        return { message: 'undefined' };
+    try {
+        return { message: JSON.stringify(err) };
+    }
+    catch {
+        return { message: String(err) };
+    }
+}
+export function createHttpServerLog(options) {
+    const { enabled, writer, now, stderrWrite } = options;
+    const getNow = now ?? (() => new Date());
+    const warn = stderrWrite ?? ((_data) => { });
+    if (!enabled) {
+        return {
+            startup: () => { },
+            requestStart: () => { },
+            requestComplete: () => { },
+            error: () => { },
+            shutdown: () => { },
+            expectedPath: () => '',
+            sessionOpen: () => { },
+            sessionClose: () => { },
+            connectionRejected: () => { },
+            requestRejected: () => { },
+            projectCreated: () => { },
+            projectEvicted: () => { },
+        };
+    }
+    const processStartTime = getNow().getTime();
+    const inFlight = new Map();
+    let startupEmitted = false;
+    let shutdownEmitted = false;
+    function writeLine(obj) {
+        writer.writeLine(obj);
+    }
+    return {
+        startup: (version, extras) => {
+            if (startupEmitted)
+                return;
+            startupEmitted = true;
+            writeLine({
+                event: 'startup',
+                ts: getNow().toISOString(),
+                pid: process.pid,
+                version,
+                transport: extras?.transport ?? 'stdio',
+            });
+        },
+        requestStart: ({ requestId, tool, sessionId, cwd }) => {
+            const startedAt = getNow();
+            if (inFlight.has(requestId)) {
+                writeLine({
+                    event: 'error',
+                    ts: startedAt.toISOString(),
+                    kind: 'duplicate_request_id',
+                    message: `requestStart called twice for requestId=${requestId}; previous in-flight entry replaced`,
+                });
+            }
+            inFlight.set(requestId, {
+                tool,
+                startedAt: startedAt.toISOString(),
+                startedAtMs: startedAt.getTime(),
+            });
+            writeLine({
+                event: 'request_start',
+                ts: startedAt.toISOString(),
+                requestId,
+                tool,
+                ...(sessionId !== undefined ? { sessionId } : {}),
+                ...(cwd !== undefined ? { cwd } : {}),
+            });
+        },
+        requestComplete: ({ requestId, tool, durationMs, responseBytes, status, sessionId, cwd }) => {
+            inFlight.delete(requestId);
+            writeLine({
+                event: 'request_complete',
+                ts: getNow().toISOString(),
+                requestId,
+                tool,
+                durationMs,
+                status,
+                responseBytes,
+                ...(sessionId !== undefined ? { sessionId } : {}),
+                ...(cwd !== undefined ? { cwd } : {}),
+            });
+        },
+        error: (kind, err) => {
+            const normalised = normaliseError(err);
+            writeLine({
+                event: 'error',
+                ts: getNow().toISOString(),
+                kind,
+                message: normalised.message,
+                ...(normalised.stack !== undefined ? { stack: normalised.stack } : {}),
+            });
+        },
+        shutdown: (cause) => {
+            if (shutdownEmitted)
+                return;
+            shutdownEmitted = true;
+            const ts = getNow();
+            let lastRequestInFlight;
+            for (const [requestId, entry] of inFlight.entries()) {
+                if (!lastRequestInFlight || entry.startedAtMs > inFlight.get(lastRequestInFlight.requestId).startedAtMs) {
+                    lastRequestInFlight = {
+                        requestId,
+                        tool: entry.tool,
+                        startedAt: entry.startedAt,
+                    };
+                }
+            }
+            writeLine({
+                event: 'shutdown',
+                ts: ts.toISOString(),
+                cause,
+                uptimeMs: ts.getTime() - processStartTime,
+                ...(lastRequestInFlight !== undefined ? { lastRequestInFlight } : {}),
+            });
+        },
+        expectedPath: () => writer.currentPath,
+        sessionOpen: ({ sessionId, cwd, remoteAddr }) => {
+            writeLine({
+                event: 'session_open',
+                ts: getNow().toISOString(),
+                sessionId,
+                cwd,
+                ...(remoteAddr !== undefined ? { remoteAddr } : {}),
+            });
+        },
+        sessionClose: ({ sessionId, cwd, reason, durationMs }) => {
+            writeLine({
+                event: 'session_close',
+                ts: getNow().toISOString(),
+                sessionId,
+                cwd,
+                reason,
+                durationMs,
+            });
+        },
+        connectionRejected: ({ reason, httpStatus, cwd, remoteAddr }) => {
+            writeLine({
+                event: 'connection_rejected',
+                ts: getNow().toISOString(),
+                reason,
+                httpStatus,
+                ...(cwd !== undefined ? { cwd } : {}),
+                ...(remoteAddr !== undefined ? { remoteAddr } : {}),
+            });
+        },
+        requestRejected: ({ reason, httpStatus, sessionIdAttempted }) => {
+            writeLine({
+                event: 'request_rejected',
+                ts: getNow().toISOString(),
+                reason,
+                httpStatus,
+                ...(sessionIdAttempted !== undefined ? { sessionIdAttempted } : {}),
+            });
+        },
+        projectCreated: ({ cwd }) => {
+            writeLine({
+                event: 'project_created',
+                ts: getNow().toISOString(),
+                cwd,
+            });
+        },
+        projectEvicted: ({ cwd, idleMs }) => {
+            writeLine({
+                event: 'project_evicted',
+                ts: getNow().toISOString(),
+                cwd,
+                idleMs,
+            });
+        },
+    };
+}
+//# sourceMappingURL=http-server-log.js.map

package/dist/diagnostics/http-server-log.js.map

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

package/dist/diagnostics/jsonl-writer.d.ts

@@ -0,0 +1,24 @@
+import * as nodeFs from 'node:fs';
+export interface JsonlWriterOptions {
+    dir: string;
+    openSync?: typeof nodeFs.openSync;
+    writeSync?: typeof nodeFs.writeSync;
+    closeSync?: typeof nodeFs.closeSync;
+    mkdirSync?: typeof nodeFs.mkdirSync;
+    now?: () => Date;
+}
+export declare class JsonlWriter {
+    private fd;
+    private currentDate;
+    private readonly dir;
+    private readonly openSync;
+    private readonly writeSync;
+    private readonly closeSync;
+    private readonly now;
+    constructor(opts: JsonlWriterOptions);
+    private filenameFor;
+    writeLine(record: Record<string, unknown>): void;
+    get currentPath(): string;
+    close(): void;
+}
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/dist/diagnostics/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../../src/diagnostics/jsonl-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAGlC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,IAAI,EAAE,kBAAkB;IASpC,OAAO,CAAC,WAAW;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYhD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,IAAI,IAAI;CAGd"}

package/dist/diagnostics/jsonl-writer.js

@@ -0,0 +1,57 @@
+import * as nodeFs from 'node:fs';
+import { join } from 'node:path';
+export class JsonlWriter {
+    fd = null;
+    currentDate = null;
+    dir;
+    openSync;
+    writeSync;
+    closeSync;
+    now;
+    constructor(opts) {
+        this.dir = process.env.MMAGENT_LOG_DIR ?? opts.dir;
+        this.openSync = opts.openSync ?? nodeFs.openSync;
+        this.writeSync = opts.writeSync ?? nodeFs.writeSync;
+        this.closeSync = opts.closeSync ?? nodeFs.closeSync;
+        this.now = opts.now ?? (() => new Date());
+        (opts.mkdirSync ?? nodeFs.mkdirSync)(this.dir, { recursive: true });
+    }
+    filenameFor(date) {
+        const yyyy = date.getUTCFullYear();
+        const mm = String(date.getUTCMonth() + 1).padStart(2, '0');
+        const dd = String(date.getUTCDate()).padStart(2, '0');
+        return `mmagent-${yyyy}-${mm}-${dd}.jsonl`;
+    }
+    writeLine(record) {
+        const dateKey = this.filenameFor(this.now());
+        if (this.currentDate !== dateKey) {
+            if (this.fd !== null) {
+                try {
+                    this.closeSync(this.fd);
+                }
+                catch { /* rotate */ }
+            }
+            this.fd = this.openSync(join(this.dir, dateKey), 'a');
+            this.currentDate = dateKey;
+        }
+        if (this.fd === null)
+            return;
+        try {
+            this.writeSync(this.fd, JSON.stringify(record) + '\n');
+        }
+        catch { /* swallow write errors */ }
+    }
+    get currentPath() {
+        return join(this.dir, this.filenameFor(this.now()));
+    }
+    close() {
+        if (this.fd !== null) {
+            try {
+                this.closeSync(this.fd);
+            }
+            catch { /* best effort */ }
+            this.fd = null;
+        }
+    }
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/dist/diagnostics/jsonl-writer.js.map

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

package/dist/diagnostics/types.d.ts

@@ -0,0 +1,54 @@
+import type { RunStatus } from '../runners/types.js';
+import type { AgentType } from '../types.js';
+export type ShutdownCause = 'stdin_end' | 'stdout_epipe' | 'stdout_other_error' | 'uncaughtException' | 'unhandledRejection' | 'SIGTERM' | 'SIGINT' | 'SIGPIPE' | 'SIGHUP' | 'SIGABRT' | 'event_loop_empty' | 'SIGTERM_drain_timeout';
+export type SessionCloseReason = 'client_closed' | 'transport_error' | 'session_expired' | 'daemon_shutdown' | 'handshake_failed';
+export type EventPrimitive = string | number | boolean | null;
+export interface TaskEvent {
+    event: string;
+    batchId: string;
+    taskIndex: number;
+    [key: string]: EventPrimitive | undefined;
+}
+export type DiagLoop = 'spec' | 'quality' | 'diff';
+export type DiagRole = 'implementer' | 'specReviewer' | 'qualityReviewer' | 'diffReviewer';
+export type DiagReason = 'transport_failure' | 'not_configured';
+export interface EscalationEventParams {
+    batchId: string;
+    taskIndex: number;
+    loop: DiagLoop;
+    attempt: number;
+    baseTier: AgentType;
+    implTier: AgentType;
+    reviewerTier: AgentType;
+}
+export interface EscalationUnavailableEventParams {
+    batchId: string;
+    taskIndex: number;
+    loop: DiagLoop;
+    attempt: number;
+    role: DiagRole;
+    wantedTier: AgentType;
+    reason: DiagReason;
+}
+export interface FallbackEventParams {
+    batchId: string;
+    taskIndex: number;
+    loop: DiagLoop;
+    attempt: number;
+    role: DiagRole;
+    assignedTier: AgentType;
+    usedTier: AgentType;
+    reason: DiagReason;
+    triggeringStatus?: RunStatus;
+    violatesSeparation: boolean;
+}
+export interface FallbackUnavailableEventParams {
+    batchId: string;
+    taskIndex: number;
+    loop: DiagLoop;
+    attempt: number;
+    role: DiagRole;
+    assignedTier: AgentType;
+    reason: DiagReason;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/diagnostics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/diagnostics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAElI,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC9D,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CAAE;AAE5H,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,cAAc,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAC3F,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,SAAS,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,SAAS,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;CACpB"}

package/dist/diagnostics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diagnostics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diagnostics/types.ts"],"names":[],"mappings":""}

package/dist/executors/_shared/findings-schema.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Structured finding shape emitted by all 5 read-only mma-* workers.
+ * Used by the quality-review stage to iterate per-finding judgments.
+ *
+ * - `severity` is lowercase to match RunResult.concerns[].severity.
+ * - `file` and `line` are independently nullable: project-level findings
+ *   have both null; multi-line findings keep `line` pointing at the start
+ *   of the cited region and use `sourceQuote` for the full text.
+ * - `line` is 1-indexed (editor convention).
+ * - `sourceQuote` and `suggestedFix` are optional.
+ */
+export declare const findingSchema: z.ZodObject<{
+    id: z.ZodString;
+    severity: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    file: z.ZodNullable<z.ZodString>;
+    line: z.ZodNullable<z.ZodNumber>;
+    claim: z.ZodString;
+    sourceQuote: z.ZodOptional<z.ZodString>;
+    suggestedFix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const findingsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    severity: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    file: z.ZodNullable<z.ZodString>;
+    line: z.ZodNullable<z.ZodNumber>;
+    claim: z.ZodString;
+    sourceQuote: z.ZodOptional<z.ZodString>;
+    suggestedFix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type Finding = z.infer<typeof findingSchema>;
+//# sourceMappingURL=findings-schema.d.ts.map

package/dist/executors/_shared/findings-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-schema.d.ts","sourceRoot":"","sources":["../../../src/executors/_shared/findings-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAQxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;kBAAyB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}