@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/lifecycle/stage-plan-types.d.ts

@@ -0,0 +1,102 @@
+import type { ToolCategory } from '../escalation/escalation-policy.js';
+import type { ProjectContext } from '../stores/project-context-registry.js';
+export interface StageRow {
+    rowId: string;
+    stageName: string;
+    schemaStage?: string;
+    runCondition: (state: LifecycleState) => boolean;
+    isRework: boolean;
+    handlerKey: string;
+    /**
+     * When true, this row's handler runs even after a prior row set
+     * `state.terminal = true`. Used by settle/compose/terminal/persist/flush
+     * rows that must populate authoritative chain-pass + envelope state on
+     * hard-fail paths. The driver loop honors this attribute; non-terminal-safe
+     * rows (the default) short-circuit when `state.terminal` is set.
+     */
+    runOnTerminal?: boolean;
+}
+export interface StagePlan {
+    toolCategory: ToolCategory;
+    rows: StageRow[];
+}
+/**
+ * Per-round review verdict shape. Matches the verdict values that
+ * spec-reviewer.ts and quality-reviewer.ts actually produce. `'concerns'` was
+ * removed in #45 Step 0 — no spec/quality reviewer in this codebase emits it
+ * (the diff reviewer's `kind: 'concerns'` is a separate, kind-typed value
+ * mapped to envelope `'approved'`; see Behavioral change #1 in the plan).
+ */
+type SpecRoundVerdict = 'approved' | 'changes_required' | 'error' | 'skipped';
+type QualityRoundVerdict = 'approved' | 'changes_required' | 'annotated' | 'error' | 'skipped';
+type DiffEnvelopeVerdict = 'approved' | 'changes_required' | 'error' | 'skipped';
+type DiffReviewKind = 'approve' | 'concerns' | 'reject' | 'transport_failure';
+export interface LifecycleState {
+    terminal: boolean;
+    workerStatus?: string;
+    reviewVerdict?: 'approved' | 'concerns' | 'changes_required' | 'error' | 'skipped';
+    attemptIndex: number;
+    attemptBudget: number;
+    reviewPolicy: 'full' | 'quality_only' | 'diff_only' | 'none';
+    shutdownInProgress: boolean;
+    route?: string;
+    toolCategory?: ToolCategory;
+    request?: unknown;
+    specReviewRound1Verdict?: SpecRoundVerdict;
+    specReviewRound2Verdict?: SpecRoundVerdict;
+    specReviewRound3Verdict?: SpecRoundVerdict;
+    qualityReviewRound1Verdict?: QualityRoundVerdict;
+    qualityReviewRound2Verdict?: QualityRoundVerdict;
+    qualityReviewRound3Verdict?: QualityRoundVerdict;
+    diffReviewVerdict?: DiffEnvelopeVerdict;
+    diffReviewKind?: DiffReviewKind;
+    specChainPassed?: boolean;
+    qualityChainPassed?: boolean;
+    specChainAttemptIndex?: number;
+    qualityChainAttemptIndex?: number;
+    specUnavailable?: import('../escalation/fallback.js').UnavailableMap;
+    qualityUnavailable?: import('../escalation/fallback.js').UnavailableMap;
+    diffUnavailable?: import('../escalation/fallback.js').UnavailableMap;
+    executor?: (rawRequest: unknown, state: LifecycleState) => Promise<unknown>;
+    executorResult?: unknown;
+    responseEnvelope?: unknown;
+    autoCommit?: boolean;
+    filesChanged?: string[];
+    readOnlyTask?: boolean;
+    verifyCommandPresent?: boolean;
+    contextBlockIds?: string[];
+    task?: unknown;
+    executionContext?: import('./lifecycle-context.js').ExecutionContext;
+    lastRunResult?: unknown;
+    verifyResult?: unknown;
+    commits?: unknown;
+    commitError?: string;
+    stageStats?: unknown;
+    terminalRunResult?: unknown;
+    currentStage?: string;
+    errorCode?: string | null;
+    terminalBlockId?: string;
+    taskTerminalEmitted?: boolean;
+    batchRegistryPersisted?: boolean;
+    telemetryFlushed?: boolean;
+    projectContext?: ProjectContext;
+    blockRegistration?: {
+        id: string;
+        size: number;
+        ttlMs: number;
+    };
+    cwd?: string;
+    runInput?: unknown;
+    systemPrompt?: string;
+    userMessage?: string;
+    maxTurns?: number;
+    callCache?: unknown;
+    taskIndex?: number;
+    artifactsCheck?: string;
+    verifyOutcome?: string;
+    guardFires?: string[];
+    terminalStatus?: string;
+    terminationReason?: string | null;
+}
+export {};
+//# sourceMappingURL=stage-plan-types.d.ts.map

package/dist/lifecycle/stage-plan-types.d.ts.map

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

package/dist/lifecycle/stage-plan-types.js

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

package/dist/lifecycle/stage-plan-types.js.map

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

package/dist/lifecycle/stage-stats.d.ts

@@ -0,0 +1,88 @@
+import type { StageStatsMap, ReviewVerdict, VerifyOutcome, VerifySkipReason } from '../types.js';
+export declare const READ_ONLY_TOOL_NAMES: Set<string>;
+export declare function emptyStats(): StageStatsMap;
+export declare function modelFamily(model: string): string;
+export declare function endBaseStage(stats: StageStatsMap, name: 'implementing' | 'spec_rework' | 'quality_rework' | 'committing', t0: number, c0: number | null, agent: {
+    tier: 'standard' | 'complex';
+    model: string;
+}, finalCostUSD: number | null, idle: {
+    maxIdleMs: number;
+    totalIdleMs: number;
+    activityEvents: number;
+} | null, metrics?: {
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedReadTokens?: number;
+    cachedNonReadTokens?: number;
+    turnCount?: number;
+    toolCallCount?: number;
+    filesReadCount?: number;
+    filesWrittenCount?: number;
+    costUSD?: number;
+}): void;
+export declare function endReviewStage(stats: StageStatsMap, name: 'spec_review' | 'quality_review' | 'diff_review', t0: number, c0: number | null, agent: {
+    tier: 'standard' | 'complex';
+    model: string;
+}, finalCostUSD: number | null, idle: {
+    maxIdleMs: number;
+    totalIdleMs: number;
+    activityEvents: number;
+} | null, verdict: ReviewVerdict, roundsUsed: number, metrics?: {
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedReadTokens?: number;
+    cachedNonReadTokens?: number;
+    turnCount?: number;
+    toolCallCount?: number;
+    filesReadCount?: number;
+    filesWrittenCount?: number;
+    costUSD?: number;
+    durationMs?: number;
+}): void;
+export interface ReworkAccumulator {
+    occurred: boolean;
+    durationMs: number;
+    costUSD: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedReadTokens: number;
+    cachedNonReadTokens: number;
+    turnCount: number;
+    toolCallCount: number;
+    filesReadCount: number;
+    filesWrittenCount: number;
+    maxIdleMs: number;
+    totalIdleMs: number;
+    activityEvents: number;
+}
+export declare function emptyReworkAcc(): ReworkAccumulator;
+export declare function accumulateReworkIteration(acc: ReworkAccumulator, result: {
+    usage?: {
+        inputTokens?: number | null;
+        outputTokens?: number | null;
+        costUSD?: number | null;
+        cachedReadTokens?: number | null;
+        cachedNonReadTokens?: number | null;
+    } | null;
+    turns?: number;
+    toolCalls?: unknown[];
+    filesRead?: unknown[];
+    filesWritten?: unknown[];
+}, iterDurationMs: number, idle: {
+    maxIdleMs: number;
+    totalIdleMs: number;
+    activityEvents: number;
+} | null): void;
+export declare function commitReworkStage(stats: StageStatsMap, name: 'spec_rework' | 'quality_rework', acc: ReworkAccumulator, agent: {
+    tier: 'standard' | 'complex';
+    model: string;
+}): void;
+export declare function endVerifyStage(stats: StageStatsMap, t0: number, c0: number | null, agent: {
+    tier: 'standard' | 'complex';
+    model: string;
+}, finalCostUSD: number | null, idle: {
+    maxIdleMs: number;
+    totalIdleMs: number;
+    activityEvents: number;
+} | null, outcome: VerifyOutcome, skipReason: VerifySkipReason | null): void;
+//# sourceMappingURL=stage-stats.d.ts.map

package/dist/lifecycle/stage-stats.d.ts.map

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

package/dist/lifecycle/stage-stats.js

@@ -0,0 +1,156 @@
+import { findModelProfile } from '../config/model-profile-registry.js';
+export const READ_ONLY_TOOL_NAMES = new Set([
+    'audit', 'review', 'verify', 'investigate', 'debug',
+]);
+const _emptyMetrics = { inputTokens: null, outputTokens: null, cachedReadTokens: null, cachedNonReadTokens: null, turnCount: null, toolCallCount: null, filesReadCount: null, filesWrittenCount: null };
+export function emptyStats() {
+    return {
+        implementing: { stage: 'implementing', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, ..._emptyMetrics },
+        spec_rework: { stage: 'spec_rework', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, ..._emptyMetrics },
+        quality_rework: { stage: 'quality_rework', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, ..._emptyMetrics },
+        committing: { stage: 'committing', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, ..._emptyMetrics },
+        verifying: { stage: 'verifying', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, outcome: null, skipReason: null, ..._emptyMetrics },
+        spec_review: { stage: 'spec_review', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, verdict: null, roundsUsed: null, ..._emptyMetrics },
+        quality_review: { stage: 'quality_review', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, verdict: null, roundsUsed: null, ..._emptyMetrics },
+        diff_review: { stage: 'diff_review', entered: false, durationMs: null, costUSD: null, agentTier: null, modelFamily: null, model: null, maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0, verdict: null, roundsUsed: null, ..._emptyMetrics },
+    };
+}
+export function modelFamily(model) {
+    return findModelProfile(model).family;
+}
+export function endBaseStage(stats, name, t0, c0, agent, finalCostUSD, idle, metrics) {
+    stats[name] = {
+        stage: name,
+        entered: true,
+        durationMs: Date.now() - t0,
+        costUSD: metrics?.costUSD !== undefined ? metrics.costUSD
+            : finalCostUSD !== null && c0 !== null ? finalCostUSD - c0 : null,
+        agentTier: agent.tier,
+        modelFamily: modelFamily(agent.model),
+        model: agent.model,
+        maxIdleMs: idle?.maxIdleMs ?? 0,
+        totalIdleMs: idle?.totalIdleMs ?? 0,
+        activityEvents: idle?.activityEvents ?? 0,
+        inputTokens: metrics?.inputTokens ?? null,
+        outputTokens: metrics?.outputTokens ?? null,
+        cachedReadTokens: metrics?.cachedReadTokens ?? null,
+        cachedNonReadTokens: metrics?.cachedNonReadTokens ?? null,
+        turnCount: metrics?.turnCount ?? null,
+        toolCallCount: metrics?.toolCallCount ?? null,
+        filesReadCount: metrics?.filesReadCount ?? null,
+        filesWrittenCount: metrics?.filesWrittenCount ?? null,
+    };
+}
+export function endReviewStage(stats, name, t0, c0, agent, finalCostUSD, idle, verdict, roundsUsed, metrics) {
+    const durationMs = metrics?.durationMs !== undefined ? metrics.durationMs : Date.now() - t0;
+    // Idle-tracker leak guard: tail events from cross-runner async cleanup can
+    // land after the stage's wall-clock end, producing totalIdleMs values that
+    // exceed durationMs. Clamping prevents impossible values from reaching the
+    // dashboard while preserving the legitimate per-stage signal in the common case.
+    const rawTotalIdle = idle?.totalIdleMs ?? 0;
+    const rawMaxIdle = idle?.maxIdleMs ?? 0;
+    const clampedTotalIdle = Math.min(rawTotalIdle, Math.max(0, durationMs));
+    const clampedMaxIdle = Math.min(rawMaxIdle, Math.max(0, durationMs));
+    stats[name] = {
+        stage: name,
+        entered: true,
+        durationMs,
+        // != null covers undefined AND null — null means "pricing unavailable,
+        // fall through to runningCostUSD computation" rather than masking unknown as 0.
+        costUSD: metrics?.costUSD != null ? metrics.costUSD
+            : finalCostUSD !== null && c0 !== null ? finalCostUSD - c0 : null,
+        agentTier: agent.tier,
+        modelFamily: modelFamily(agent.model),
+        model: agent.model,
+        maxIdleMs: clampedMaxIdle,
+        totalIdleMs: clampedTotalIdle,
+        activityEvents: idle?.activityEvents ?? 0,
+        inputTokens: metrics?.inputTokens ?? null,
+        outputTokens: metrics?.outputTokens ?? null,
+        cachedReadTokens: metrics?.cachedReadTokens ?? null,
+        cachedNonReadTokens: metrics?.cachedNonReadTokens ?? null,
+        turnCount: metrics?.turnCount ?? null,
+        toolCallCount: metrics?.toolCallCount ?? null,
+        filesReadCount: metrics?.filesReadCount ?? null,
+        filesWrittenCount: metrics?.filesWrittenCount ?? null,
+        verdict,
+        roundsUsed,
+    };
+}
+export function emptyReworkAcc() {
+    return {
+        occurred: false,
+        durationMs: 0, costUSD: 0,
+        inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0,
+        turnCount: 0, toolCallCount: 0, filesReadCount: 0, filesWrittenCount: 0,
+        maxIdleMs: 0, totalIdleMs: 0, activityEvents: 0,
+    };
+}
+export function accumulateReworkIteration(acc, result, iterDurationMs, idle) {
+    acc.occurred = true;
+    acc.durationMs += iterDurationMs;
+    acc.costUSD += result.usage?.costUSD ?? 0;
+    acc.inputTokens += result.usage?.inputTokens ?? 0;
+    acc.outputTokens += result.usage?.outputTokens ?? 0;
+    acc.cachedReadTokens += result.usage?.cachedReadTokens ?? 0;
+    acc.cachedNonReadTokens += result.usage?.cachedNonReadTokens ?? 0;
+    acc.turnCount += result.turns ?? 0;
+    acc.toolCallCount += result.toolCalls?.length ?? 0;
+    acc.filesReadCount += result.filesRead?.length ?? 0;
+    acc.filesWrittenCount += result.filesWritten?.length ?? 0;
+    if (idle) {
+        if (idle.maxIdleMs > acc.maxIdleMs)
+            acc.maxIdleMs = idle.maxIdleMs;
+        acc.totalIdleMs += idle.totalIdleMs;
+        acc.activityEvents += idle.activityEvents;
+    }
+}
+export function commitReworkStage(stats, name, acc, agent) {
+    if (!acc.occurred)
+        return;
+    stats[name] = {
+        stage: name,
+        entered: true,
+        durationMs: acc.durationMs,
+        costUSD: acc.costUSD,
+        agentTier: agent.tier,
+        modelFamily: modelFamily(agent.model),
+        model: agent.model,
+        maxIdleMs: acc.maxIdleMs,
+        totalIdleMs: acc.totalIdleMs,
+        activityEvents: acc.activityEvents,
+        inputTokens: acc.inputTokens,
+        outputTokens: acc.outputTokens,
+        cachedReadTokens: acc.cachedReadTokens,
+        cachedNonReadTokens: acc.cachedNonReadTokens,
+        turnCount: acc.turnCount,
+        toolCallCount: acc.toolCallCount,
+        filesReadCount: acc.filesReadCount,
+        filesWrittenCount: acc.filesWrittenCount,
+    };
+}
+export function endVerifyStage(stats, t0, c0, agent, finalCostUSD, idle, outcome, skipReason) {
+    stats.verifying = {
+        stage: 'verifying',
+        entered: true,
+        durationMs: Date.now() - t0,
+        costUSD: finalCostUSD !== null && c0 !== null ? finalCostUSD - c0 : null,
+        agentTier: agent.tier,
+        modelFamily: modelFamily(agent.model),
+        model: agent.model,
+        maxIdleMs: idle?.maxIdleMs ?? 0,
+        totalIdleMs: idle?.totalIdleMs ?? 0,
+        activityEvents: idle?.activityEvents ?? 0,
+        inputTokens: null,
+        outputTokens: null,
+        cachedReadTokens: null,
+        cachedNonReadTokens: null,
+        turnCount: null,
+        toolCallCount: null,
+        filesReadCount: null,
+        filesWrittenCount: null,
+        outcome,
+        skipReason,
+    };
+}
+//# sourceMappingURL=stage-stats.js.map

package/dist/lifecycle/stage-stats.js.map

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

package/dist/lifecycle/task-completion-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-completion-summary.d.ts","sourceRoot":"","sources":["../../src/lifecycle/task-completion-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AA+BD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,qBAAqB,CA+CxB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAMnE"}

package/dist/lifecycle/task-completion-summary.js

@@ -0,0 +1,93 @@
+import { clampStageCost, clampTaskCost, clampInputTokens, clampOutputTokens, clampDurationMsTotal, } from '../events/clamp.js';
+// Derive each total INDEPENDENTLY from stage stats, mirroring event-builder
+// exactly. Top-level totals must NEVER depend on runResult.usage — that field
+// only carries the last implementer attempt and would lose reviewer + earlier
+// rework cost (the same Gap 2 bug we already fixed in event-builder).
+//
+// Clamping is identical to event-builder via shared helpers from
+// packages/core/src/telemetry/clamp.ts — guarantees the summary line and
+// the V3 event never disagree on cost/token/duration values.
+function deriveTerminalStatus(rr) {
+    const tr = rr.terminationReason;
+    if (tr === 'all_tiers_unavailable')
+        return 'unavailable';
+    if (tr === 'cost_ceiling')
+        return 'cost_exceeded';
+    if (tr === 'round_cap')
+        return 'incomplete';
+    if (!tr || typeof tr !== 'object')
+        return 'incomplete';
+    switch (tr.cause) {
+        case 'finished': return 'ok';
+        case 'incomplete':
+        case 'degenerate_exhausted': return 'incomplete';
+        case 'timeout': return 'timeout';
+        case 'cost_exceeded': return 'cost_exceeded';
+        case 'brief_too_vague': return 'brief_too_vague';
+        case 'api_error':
+        case 'provider_transport_failure':
+        case 'api_aborted':
+        case 'error': return 'error';
+        default: return 'incomplete';
+    }
+}
+export function computeTaskCompletionSummary(args) {
+    const { runResult, taskIndexZero, totalTasks, batchId } = args;
+    const stageEntries = Object.values(runResult.stageStats ?? {}).filter((s) => s.entered);
+    // Sum across entered stages with per-stage clamping, then apply
+    // top-level clamping — exactly mirroring the two-level clamping in
+    // event-builder.ts (extractStageData + buildTaskCompletedEvent).
+    const sumFinite = (key, clampStage, clampTotal) => {
+        let total = 0;
+        let anyFinite = false;
+        for (const s of stageEntries) {
+            const v = s[key];
+            if (typeof v === 'number' && Number.isFinite(v)) {
+                total += clampStage(v);
+                anyFinite = true;
+            }
+        }
+        return anyFinite ? clampTotal(total) : null;
+    };
+    const totalDurationMs = clampDurationMsTotal(stageEntries.reduce((s, st) => {
+        const v = st['durationMs'];
+        return s + (typeof v === 'number' && Number.isFinite(v) ? v : 0);
+    }, 0));
+    return {
+        batchId,
+        taskIndexZero,
+        totalTasks,
+        terminalStatus: deriveTerminalStatus(runResult),
+        totalDurationMs,
+        totalCostUSD: sumFinite('costUSD', clampStageCost, clampTaskCost),
+        totalInputTokens: sumFinite('inputTokens', clampInputTokens, clampInputTokens),
+        totalOutputTokens: sumFinite('outputTokens', clampOutputTokens, clampOutputTokens),
+        turns: runResult.turns ?? 0,
+        filesWrittenCount: runResult.filesWritten?.length ?? 0,
+        specReviewVerdict: runResult.specReviewStatus ?? 'not_applicable',
+        qualityReviewVerdict: runResult.qualityReviewStatus ?? 'not_applicable',
+    };
+}
+export function formatTaskDoneLine(s) {
+    const idx = `task=${s.taskIndexZero + 1}/${s.totalTasks} taskIndex=${s.taskIndexZero}`;
+    const dur = formatDur(s.totalDurationMs);
+    const tokens = formatTokens(s.totalInputTokens, s.totalOutputTokens);
+    const cost = s.totalCostUSD === null ? '$unknown' : `$${s.totalCostUSD.toFixed(2)}`;
+    return `[mmagent] batch=${s.batchId.slice(0, 8)} ${idx} done: ${s.terminalStatus} in ${dur}, ${tokens}, ${cost}, ${s.turns} turns, ${s.filesWrittenCount} file(s) written, reviews [spec=${s.specReviewVerdict}, quality=${s.qualityReviewVerdict}]`;
+}
+function formatDur(ms) {
+    if (ms < 60_000)
+        return `${Math.round(ms / 1000)}s`;
+    const m = Math.floor(ms / 60_000);
+    const sec = Math.round((ms % 60_000) / 1000);
+    return `${m}m ${sec}s`;
+}
+function formatTokens(input, output) {
+    if (input === null && output === null)
+        return 'tokens=unknown';
+    const total = (input ?? 0) + (output ?? 0);
+    if (total < 1000)
+        return `${total} tokens`;
+    return `${Math.ceil(total / 1000)}k tokens`;
+}
+//# sourceMappingURL=task-completion-summary.js.map

package/dist/lifecycle/task-completion-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-completion-summary.js","sourceRoot":"","sources":["../../src/lifecycle/task-completion-summary.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAiB5B,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,EAAE;AACF,iEAAiE;AACjE,yEAAyE;AACzE,6DAA6D;AAC7D,SAAS,oBAAoB,CAAC,EAAa;IACzC,MAAM,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC;IAChC,IAAI,EAAE,KAAK,uBAAuB;QAAE,OAAO,aAAa,CAAC;IACzD,IAAI,EAAE,KAAK,cAAc;QAAE,OAAO,eAAe,CAAC;IAClD,IAAI,EAAE,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC;IAC5C,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC;IACvD,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC;QAC7B,KAAK,YAAY,CAAC;QAClB,KAAK,sBAAsB,CAAC,CAAC,OAAO,YAAY,CAAC;QACjD,KAAK,SAAS,CAAC,CAAC,OAAO,SAAS,CAAC;QACjC,KAAK,eAAe,CAAC,CAAC,OAAO,eAAe,CAAC;QAC7C,KAAK,iBAAiB,CAAC,CAAC,OAAO,iBAAiB,CAAC;QACjD,KAAK,WAAW,CAAC;QACjB,KAAK,4BAA4B,CAAC;QAClC,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC;QAC7B,OAAO,CAAC,CAAC,OAAO,YAAY,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAK5C;IACC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/D,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CACjB,CAAC;IAEF,gEAAgE;IAChE,mEAAmE;IACnE,iEAAiE;IACjE,MAAM,SAAS,GAAG,CAChB,GAAW,EACX,UAAiC,EACjC,UAAiC,EAClB,EAAE;QACjB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAI,CAAwC,CAAC,GAAG,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;gBACvB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,oBAAoB,CAC1C,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAI,EAAyC,CAAC,YAAY,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,EAAE,CAAC,CAAC,CACN,CAAC;IAEF,OAAO;QACL,OAAO;QACP,aAAa;QACb,UAAU;QACV,cAAc,EAAE,oBAAoB,CAAC,SAAS,CAAC;QAC/C,eAAe;QACf,YAAY,EAAE,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,aAAa,CAAC;QACjE,gBAAgB,EAAE,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAC9E,iBAAiB,EAAE,SAAS,CAAC,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;QAClF,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;QAC3B,iBAAiB,EAAE,SAAS,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;QACtD,iBAAiB,EAAG,SAAS,CAAC,gBAA2B,IAAI,gBAAgB;QAC7E,oBAAoB,EAAG,SAAS,CAAC,mBAA8B,IAAI,gBAAgB;KACpF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAwB;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,cAAc,CAAC,CAAC,aAAa,EAAE,CAAC;IACvF,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,OAAO,mBAAmB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,cAAc,OAAO,GAAG,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,iBAAiB,mCAAmC,CAAC,CAAC,iBAAiB,aAAa,CAAC,CAAC,oBAAoB,GAAG,CAAC;AACvP,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;IACpD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC;AACzB,CAAC;AAED,SAAS,YAAY,CAAC,KAAoB,EAAE,MAAqB;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,gBAAgB,CAAC;IAC/D,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,SAAS,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;AAC9C,CAAC"}

package/dist/lifecycle/task-executor.d.ts

@@ -0,0 +1,24 @@
+import type { ToolConfig } from './tool-config-types.js';
+import type { ExecutionContext } from './lifecycle-context.js';
+import type { ExecutorOutput } from './executor-output-types.js';
+/**
+ * Generic per-task orchestrator. Takes a ToolConfig (which encodes all
+ * tool-specific behavior: brief compilation, TaskSpec building, headline
+ * composition, report parsing), an ExecutionContext, and raw tool input,
+ * and runs the standard pipeline:
+ *
+ *   1. Compile briefs via config.briefSlot(input)
+ *   2. Resolve agent via resolveAgent(config.agentType, config)
+ *   3. Build TaskSpec per brief via config.buildTaskSpec
+ *   4. Dispatch each task via runTaskViaDispatcher
+ *   5. Auto-register context block from usable outputs
+ *   6. Compute batch timings + aggregate cost
+ *   7. Parse structured report via config.reportSchema
+ *   8. Compose headline via config.headlineTemplate
+ *   9. Map review verdicts
+ *  10. Return ExecutorOutput
+ *
+ * Target: ≤ 200 LOC. If it grows past 250, factor helpers back out.
+ */
+export declare function executeTask<Input, Brief, Report>(config: ToolConfig<Input, Brief, Report>, ctx: ExecutionContext, input: Input): Promise<ExecutorOutput>;
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/lifecycle/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/lifecycle/task-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAUjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EACpD,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EACxC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,cAAc,CAAC,CAgLzB"}