@telora/daemon 0.15.26 → 0.15.28

package/dist/audit-phase.js

@@ -0,0 +1,271 @@
+/**
+ * Autonomous reality-tree audit phase.
+ *
+ * Replaces the runAuditPhase scaffold with a one-shot LLM assessor session
+ * that compares the focus's observable state against the CRT/FRT and mutates
+ * the graph via reality_tree_* MCP tools. The session's narrated summary
+ * is captured to an `audit_runs` row for human review.
+ *
+ * Failure modes never throw -- each path returns outcome='continue' with
+ * an explanatory rationale and metadata.errors entries. This keeps the
+ * focus loop running so a transient audit failure does not stall execution.
+ */
+import { resolveAssemblyRecipe } from './assembly-engine.js';
+// Side-effect import: registers resolvers used by the audit recipe.
+import './assembly-resolvers.js';
+import { getRecentFocusCycleEvaluation, } from './queries/focus-cycle-evaluations.js';
+import { insertAuditRun, updateAuditRun } from './queries/audit-runs.js';
+import { getFocusDeliveries } from './queries/focuses.js';
+import { getConfig } from './queries/shared.js';
+import { spawnAuditAgent as spawnerSpawnAuditAgent, } from './spawner.js';
+// ---------------------------------------------------------------------------
+// Constants exposed for testing and reuse
+// ---------------------------------------------------------------------------
+/**
+ * Ordered assembly recipe for the audit prompt. Each entry resolves to a
+ * markdown section that gets composed into the assessor's input. Order
+ * matters: the assessor reads top-down so cycle context comes first, then
+ * code-level diff, then the live graph it must reconcile.
+ */
+export const AUDIT_ASSEMBLY_RECIPE = [
+    'focus.context',
+    'retired_injections',
+    'delivery.listing(scope=done_since_last_audit)',
+    'git.diff_against_base',
+    'agent_session_summaries',
+    'agent_escalations',
+    'reality_tree.snapshot',
+];
+/** MCP tool names the assessor session is permitted to call. */
+export const AUDIT_MCP_TOOLS = [
+    'mcp__telora-products__telora_reality_tree',
+    'mcp__telora-products__telora_reality_tree_node',
+    'mcp__telora-products__telora_reality_tree_edge',
+    'mcp__telora-products__telora_reality_tree_link',
+];
+/** Default Claude model for the audit assessor. Override via deps. */
+export const AUDIT_DEFAULT_MODEL = 'sonnet';
+/** Default timeout for the assessor session (15 minutes). */
+export const AUDIT_DEFAULT_TIMEOUT_MS = 15 * 60 * 1000;
+/**
+ * Audit prompt. The assessor is told its role, given the assembled context
+ * via stdin/CLI, and instructed to emit a fenced audit-summary tail block
+ * the daemon can parse.
+ */
+export const AUDIT_PROMPT = [
+    'You are the autonomous reality-tree audit assessor for a Telora focus.',
+    '',
+    'Your job is to compare observable reality against the focus\'s reality tree (CRT) and apply mutations directly via the reality_tree_* MCP tools so the graph reflects what actually happened during the just-completed audit cycle.',
+    '',
+    'You have read access to the worktree and full mutation surface on the focus\'s reality tree. You do NOT propose changes for human ratification -- you make the changes. Be conservative: only mutate when the evidence in the diff, narrations, or escalations is unambiguous.',
+    '',
+    'Common mutations:',
+    '- Add or refresh evidence on an entity node when the diff shows a related change.',
+    '- Retire an injection node (set status=verified, run reality_tree_node verify) when the FRT overlay is observably true.',
+    '- Add a new entity node for an observation the tree does not yet capture.',
+    '- Flip a UDE to a desired_effect via the verify mutation when the targeted injection has retired and reality has shifted.',
+    '- Adjust an edge when a dependency appears or dissolves.',
+    '',
+    'Do NOT mutate nodes you have no evidence for. Do NOT mutate workflow state -- only the reality tree.',
+    '',
+    'When you are done, emit ONE fenced markdown block as the very last thing in your output, exactly in this shape (do not skip any field):',
+    '',
+    '```audit-summary',
+    'nodes_touched: <integer>',
+    'edges_touched: <integer>',
+    'summary: |',
+    '  <markdown narrative -- one bullet per significant mutation, with seq numbers>',
+    '```',
+    '',
+    'If you make no changes, still emit the block with nodes_touched: 0 / edges_touched: 0 and a one-line summary explaining why no mutations were warranted.',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Summary parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse the audit-summary tail block from assessor stdout. Returns null
+ * fields when the block is missing or malformed; the caller treats those
+ * as advisory zeros and writes them to the audit_runs row.
+ */
+export function parseAuditSummary(stdout) {
+    const fenceRegex = /```audit-summary\s*\n([\s\S]*?)```/g;
+    let lastMatch = null;
+    let m;
+    while ((m = fenceRegex.exec(stdout)) !== null) {
+        lastMatch = m;
+    }
+    if (!lastMatch) {
+        return { summaryMd: null, nodesTouched: 0, edgesTouched: 0 };
+    }
+    const body = lastMatch[1];
+    let nodesTouched = 0;
+    let edgesTouched = 0;
+    let summaryMd = null;
+    const nodesMatch = /^\s*nodes_touched:\s*(\d+)\s*$/m.exec(body);
+    if (nodesMatch)
+        nodesTouched = parseInt(nodesMatch[1], 10);
+    const edgesMatch = /^\s*edges_touched:\s*(\d+)\s*$/m.exec(body);
+    if (edgesMatch)
+        edgesTouched = parseInt(edgesMatch[1], 10);
+    // summary: | <newline> then indented lines until end of block.
+    const summaryStart = /^\s*summary:\s*\|\s*$/m.exec(body);
+    if (summaryStart) {
+        const start = summaryStart.index + summaryStart[0].length;
+        const tail = body.slice(start);
+        // Each indented line (>= 2 spaces) is part of the summary; collect until
+        // we hit a non-indented non-empty line (none expected, but be safe).
+        const lines = tail.split('\n');
+        const collected = [];
+        for (const raw of lines) {
+            if (raw.trim().length === 0) {
+                collected.push('');
+                continue;
+            }
+            const dedented = raw.replace(/^ {2}/, '');
+            collected.push(dedented);
+        }
+        const joined = collected.join('\n').trim();
+        if (joined.length > 0)
+            summaryMd = joined;
+    }
+    return { summaryMd, nodesTouched, edgesTouched };
+}
+// ---------------------------------------------------------------------------
+// Default dependency wiring
+// ---------------------------------------------------------------------------
+async function defaultAssembleContext(focusId, recipe) {
+    const config = getConfig();
+    const deliveries = await getFocusDeliveries(focusId);
+    const ctx = {
+        focusId,
+        deliveryIds: deliveries.map(d => d.id),
+        worktreePath: null,
+        config,
+        organizationId: config.organizationId,
+        productId: config.productId,
+    };
+    return await resolveAssemblyRecipe([...recipe], ctx);
+}
+async function defaultGetCurrentCycleNumber(focusId) {
+    const prev = await getRecentFocusCycleEvaluation(focusId);
+    if (!prev)
+        return 1;
+    // The audit phase is the entry to a new cycle iff the prior tick was
+    // evaluate -> continue. Otherwise we're inside an existing cycle.
+    if (prev.phase === 'evaluate' && prev.outcome === 'continue') {
+        return prev.cycle_number + 1;
+    }
+    return prev.cycle_number;
+}
+export const defaultAuditDeps = {
+    assembleContext: defaultAssembleContext,
+    insertAuditRun: ({ focusId, cycleNumber, model, sessionId }) => insertAuditRun({ focusId, cycleNumber, model, sessionId }),
+    updateAuditRun: ({ auditRunId, summaryMd, nodesTouched, edgesTouched }) => updateAuditRun({ auditRunId, summaryMd, nodesTouched, edgesTouched }),
+    getCurrentCycleNumber: defaultGetCurrentCycleNumber,
+    spawnAuditAgent: (opts) => spawnerSpawnAuditAgent(opts),
+    parseAuditSummary,
+    getConfig,
+};
+// ---------------------------------------------------------------------------
+// Core phase
+// ---------------------------------------------------------------------------
+/**
+ * Run the audit phase for a focus. Spawns a one-shot assessor, captures
+ * the audit-summary tail block, and writes an audit_runs row. Always
+ * returns 'continue' so the focus loop advances regardless of audit
+ * outcome -- the row + metadata.errors describe what happened.
+ */
+export async function runAuditPhase(focusId, deps = defaultAuditDeps) {
+    const errors = [];
+    const metadata = {};
+    let cycleNumber = 1;
+    try {
+        cycleNumber = await deps.getCurrentCycleNumber(focusId);
+    }
+    catch (err) {
+        errors.push(`cycle_lookup: ${err.message}`);
+    }
+    metadata.cycleNumber = cycleNumber;
+    let assembled = '';
+    try {
+        assembled = await deps.assembleContext(focusId, AUDIT_ASSEMBLY_RECIPE);
+    }
+    catch (err) {
+        errors.push(`assembly: ${err.message}`);
+    }
+    let auditRunId = null;
+    try {
+        const row = await deps.insertAuditRun({
+            focusId, cycleNumber, model: AUDIT_DEFAULT_MODEL, sessionId: null,
+        });
+        auditRunId = row.id;
+        metadata.auditRunId = row.id;
+    }
+    catch (err) {
+        errors.push(`insert_audit_run: ${err.message}`);
+    }
+    const config = deps.getConfig();
+    const prompt = assembled
+        ? `${assembled}\n\n---\n\n${AUDIT_PROMPT}`
+        : AUDIT_PROMPT;
+    let spawnResult;
+    try {
+        spawnResult = await deps.spawnAuditAgent({
+            config,
+            prompt,
+            worktreePath: null,
+            focusId,
+            cycleNumber,
+            model: AUDIT_DEFAULT_MODEL,
+            timeoutMs: AUDIT_DEFAULT_TIMEOUT_MS,
+            allowedTools: AUDIT_MCP_TOOLS,
+        });
+    }
+    catch (err) {
+        errors.push(`spawn: ${err.message}`);
+        spawnResult = { exitCode: null, stdout: '', stderr: '', errorMessage: err.message };
+    }
+    if (spawnResult.errorMessage) {
+        errors.push(`spawn: ${spawnResult.errorMessage}`);
+    }
+    if (spawnResult.exitCode !== null && spawnResult.exitCode !== 0) {
+        errors.push(`exit_code: ${spawnResult.exitCode}`);
+        if (spawnResult.stderr) {
+            metadata.stderrTail = spawnResult.stderr.slice(-1000);
+        }
+    }
+    const parser = deps.parseAuditSummary ?? parseAuditSummary;
+    const summary = parser(spawnResult.stdout);
+    if (summary.summaryMd === null) {
+        errors.push('summary_block_missing');
+    }
+    metadata.nodesTouched = summary.nodesTouched;
+    metadata.edgesTouched = summary.edgesTouched;
+    if (auditRunId) {
+        try {
+            await deps.updateAuditRun({
+                auditRunId,
+                summaryMd: summary.summaryMd,
+                nodesTouched: summary.nodesTouched,
+                edgesTouched: summary.edgesTouched,
+            });
+        }
+        catch (err) {
+            errors.push(`update_audit_run: ${err.message}`);
+        }
+    }
+    if (errors.length > 0) {
+        metadata.errors = errors;
+        return {
+            outcome: 'continue',
+            rationale: `audit cycle ${cycleNumber} completed with ${errors.length} issue(s)`,
+            metadata,
+        };
+    }
+    return {
+        outcome: 'continue',
+        rationale: `audit cycle ${cycleNumber} -- ${summary.nodesTouched} nodes touched, ${summary.edgesTouched} edges touched`,
+        metadata,
+    };
+}
+//# sourceMappingURL=audit-phase.js.map

package/dist/audit-phase.js.map

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

package/dist/cli/session-state.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `telora-daemon session-state` subcommand.
+ *
+ * One-shot bootstrap helper for the Claude Code SessionStart and PreToolUse
+ * hooks. Reads `.telora/daemon.json` from cwd (or `--config <path>`), calls
+ * the product-api `session_state` action, and emits either:
+ *
+ *   - default: two-line invariant summary suitable for Claude's session
+ *     context. Line 1 is the connection (URL + org + product name); line 2
+ *     reminds the agent to resolve dynamic state (active focuses, branches,
+ *     deliveries) on demand via MCP. The plain path deliberately omits
+ *     dynamic state -- it changes during a session and stale snapshots in
+ *     the bootstrap are noise.
+ *   - `--json`: full structured payload (including activeFocus, branches,
+ *     deliveryCounts) for enforcement hooks and other programmatic consumers.
+ *
+ * Designed to be silent and fast at session open: missing daemon.json means
+ * "not Telora-connected" and the command exits 0 with no output. Backend
+ * errors and git errors degrade gracefully -- they print to stderr and the
+ * command still exits 0 so the hook never blocks Claude Code.
+ */
+interface SessionStateResponse {
+    success?: boolean;
+    connectedUrl?: string;
+    organizationId?: string;
+    organizationName?: string | null;
+    productId?: string;
+    productName?: string;
+    activeFocus?: null | {
+        id: string;
+        name: string;
+        assignedAgentRoleId: string | null;
+        assignedAgentRoleName: string | null;
+        pipelineConfig: Record<string, unknown> | null;
+    };
+    deliveryCounts?: Record<string, number>;
+    error?: string;
+}
+export interface SessionStateOptions {
+    /** Emit structured JSON instead of human-readable text. */
+    json?: boolean;
+    /** Override the daemon.json path (default: ./.telora/daemon.json). */
+    config?: string;
+}
+/**
+ * Two-line invariant summary. Dynamic state (active focus, branches,
+ * deliveries) is intentionally omitted -- it should be resolved on demand
+ * via MCP at the point of use, not baked into the bootstrap where it goes
+ * stale during the session. Exported for unit testing.
+ */
+export declare function formatPlain(state: SessionStateResponse): string;
+export declare function runSessionState(opts: SessionStateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=session-state.d.ts.map

package/dist/cli/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/cli/session-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAqBH,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,GAAG;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAChD,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwGD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAQ/D;AAiBD,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9E"}

package/dist/cli/session-state.js

@@ -0,0 +1,177 @@
+/**
+ * `telora-daemon session-state` subcommand.
+ *
+ * One-shot bootstrap helper for the Claude Code SessionStart and PreToolUse
+ * hooks. Reads `.telora/daemon.json` from cwd (or `--config <path>`), calls
+ * the product-api `session_state` action, and emits either:
+ *
+ *   - default: two-line invariant summary suitable for Claude's session
+ *     context. Line 1 is the connection (URL + org + product name); line 2
+ *     reminds the agent to resolve dynamic state (active focuses, branches,
+ *     deliveries) on demand via MCP. The plain path deliberately omits
+ *     dynamic state -- it changes during a session and stale snapshots in
+ *     the bootstrap are noise.
+ *   - `--json`: full structured payload (including activeFocus, branches,
+ *     deliveryCounts) for enforcement hooks and other programmatic consumers.
+ *
+ * Designed to be silent and fast at session open: missing daemon.json means
+ * "not Telora-connected" and the command exits 0 with no output. Backend
+ * errors and git errors degrade gracefully -- they print to stderr and the
+ * command still exits 0 so the hook never blocks Claude Code.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { resolve } from 'node:path';
+function loadDaemonJson(configPath) {
+    if (!existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch (err) {
+        process.stderr.write(`session-state: cannot parse ${configPath}: ${err.message}\n`);
+        return null;
+    }
+}
+function tryGit(args, cwd) {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function collectBranchInfo(integrationBranch, repoPath) {
+    // Verify the integration branch exists locally; if not, skip git work.
+    const verifyRef = tryGit(['rev-parse', '--verify', integrationBranch], repoPath);
+    if (!verifyRef)
+        return [];
+    const branchesRaw = tryGit(['for-each-ref', '--format=%(refname:short)', 'refs/heads/'], repoPath);
+    if (!branchesRaw)
+        return [];
+    const branches = branchesRaw.split('\n').filter(b => b && b !== integrationBranch);
+    const infos = [];
+    for (const branch of branches) {
+        // Skip the usual main-line branches to keep output focused on focus work.
+        if (branch === 'main' || branch === 'master')
+            continue;
+        const countStr = tryGit(['rev-list', '--count', `${integrationBranch}..${branch}`], repoPath);
+        if (!countStr)
+            continue;
+        const commitsAhead = parseInt(countStr, 10);
+        if (!Number.isFinite(commitsAhead) || commitsAhead <= 0)
+            continue;
+        const info = { branchName: branch, commitsAhead };
+        const oldestCommitTs = tryGit([
+            'log',
+            `${integrationBranch}..${branch}`,
+            '--reverse',
+            '--format=%ct',
+            '-1',
+        ], repoPath);
+        if (oldestCommitTs) {
+            const ts = parseInt(oldestCommitTs, 10);
+            if (Number.isFinite(ts)) {
+                info.oldestUnmergedAge = Math.max(0, Math.floor(Date.now() / 1000 - ts));
+            }
+        }
+        infos.push(info);
+    }
+    infos.sort((a, b) => b.commitsAhead - a.commitsAhead);
+    return infos;
+}
+async function callSessionState(cfg, productId) {
+    if (!cfg.teloraUrl || !cfg.trackerId) {
+        process.stderr.write('session-state: daemon.json missing teloraUrl or trackerId\n');
+        return null;
+    }
+    const url = `${cfg.teloraUrl}/functions/v1/product-api`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${cfg.trackerId}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ action: 'session_state', productId }),
+            signal: controller.signal,
+        });
+        const data = (await response.json());
+        if (!response.ok || data.error) {
+            process.stderr.write(`session-state: API error ${response.status}: ${data.error ?? 'unknown'}\n`);
+            return null;
+        }
+        return data;
+    }
+    catch (err) {
+        process.stderr.write(`session-state: fetch failed: ${err.message}\n`);
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Two-line invariant summary. Dynamic state (active focus, branches,
+ * deliveries) is intentionally omitted -- it should be resolved on demand
+ * via MCP at the point of use, not baked into the bootstrap where it goes
+ * stale during the session. Exported for unit testing.
+ */
+export function formatPlain(state) {
+    const url = state.connectedUrl ?? '';
+    const orgName = state.organizationName ?? 'unknown';
+    const productName = state.productName ?? 'unknown';
+    return [
+        `Telora connected: ${url} / ${orgName} / ${productName}`,
+        'Active focuses, branches, and deliveries are resolved on demand via Telora MCP.',
+    ].join('\n');
+}
+function resolveProductIdAndRepoPath(cfg) {
+    const cwd = process.cwd();
+    if (cfg.products && cfg.products.length > 0) {
+        const first = cfg.products[0];
+        return {
+            productId: first.id ?? cfg.productId ?? null,
+            repoPath: first.repoPath ?? cwd,
+        };
+    }
+    return { productId: cfg.productId ?? null, repoPath: cwd };
+}
+export async function runSessionState(opts) {
+    const configPath = resolve(opts.config ?? '.telora/daemon.json');
+    const cfg = loadDaemonJson(configPath);
+    if (!cfg) {
+        // Not Telora-connected -- silent success.
+        return;
+    }
+    const { productId, repoPath } = resolveProductIdAndRepoPath(cfg);
+    if (!productId) {
+        process.stderr.write('session-state: daemon.json has no productId\n');
+        return;
+    }
+    const state = await callSessionState(cfg, productId);
+    if (!state)
+        return;
+    if (cfg.teloraUrl)
+        state.connectedUrl = cfg.teloraUrl;
+    if (opts.json) {
+        // JSON path retains dynamic state for programmatic consumers
+        // (enforcement hooks, observability). The git work is only done here.
+        const integrationBranch = cfg.engines?.strategy?.integrationBranch ?? 'integration';
+        const branches = collectBranchInfo(integrationBranch, repoPath);
+        const payload = {
+            ...state,
+            branches,
+        };
+        process.stdout.write(`${JSON.stringify(payload)}\n`);
+        return;
+    }
+    process.stdout.write(`${formatPlain(state)}\n`);
+}
+//# sourceMappingURL=session-state.js.map

package/dist/cli/session-state.js.map

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

package/dist/focus-completion.d.ts

@@ -7,18 +7,77 @@
  */
 import type { DaemonConfig, FocusTeamState, FocusDeliveryInfo, Workflow, PolicyFailureMode } from './types.js';
 import type { StageAdvanceResult } from './delivery-lifecycle.js';
+import { mergeFocusBranch } from './focus-merge.js';
+import { branchHasUnmergedCommits } from './git.js';
 export { isStatusTerminal, isStatusAgentActionable } from './stage-classifier.js';
 /**
  * Decide whether to attempt mergeFocusBranch on team exit.
  *
+ * The gate asks "does the branch have clean committed work?" rather than
+ * "did the team session exit cleanly?" -- so a team that exits via review-
+ * cycle SIGTERM, role-clear, daemon crash, or manual termination still gets
+ * its committed work propagated to integration.
+ *
  * Skip merge when:
- * - The team did not succeed (failed exit or unclean shutdown), OR
- * - The team is still in its planning phase (no deliveries scoped, nothing
- *   to merge -- this covers cancellation mid-planning).
+ * - The team is still in its planning phase (cancellation mid-planning --
+ *   nothing scoped, nothing to merge), OR
+ * - The team is a read-only audit session (read-only violation; commits, if
+ *   any, are surfaced separately by the existing readOnly guard), OR
+ * - The branch has no committed work ahead of integration (clean exit with
+ *   no commits, e.g. audit team or planning-only team).
  *
  * Exported for unit testing the gate logic in isolation.
  */
-export declare function shouldAttemptMerge(succeeded: boolean, teamState: Pick<FocusTeamState, 'planningPhase'>): boolean;
+export declare function shouldAttemptMerge(teamState: Pick<FocusTeamState, 'planningPhase' | 'readOnly'>, branchHasCommits: boolean): boolean;
+/**
+ * Statuses for deliveries whose git state should be reported on team
+ * completion. Includes 'done' so a focus whose deliveries all reached done
+ * before the branch was merged (review SIGTERM, role-clear, deferred merge,
+ * etc.) still attempts the merge instead of being short-circuited as
+ * "no worked deliveries". Excludes 'queued'/'planning'/'paused'/'cancelled'
+ * — those represent work that never started or was abandoned.
+ *
+ * Exported for unit testing.
+ */
+export declare const REPORTABLE_DELIVERY_STATUSES: ReadonlySet<string>;
+/**
+ * Filter delivery list to those whose git state should be reported on team
+ * completion. Excludes already-merged deliveries so we don't re-report them.
+ *
+ * Exported for unit testing the filter logic without invoking handleTeamCompletion.
+ */
+export declare function selectWorkedDeliveryIds(deliveries: readonly {
+    id: string;
+    executionStatus: string | null;
+}[], alreadyMerged: ReadonlySet<string>): string[];
+export interface FocusMergeAttemptDeps {
+    branchHasUnmergedCommits: typeof branchHasUnmergedCommits;
+    mergeFocusBranch: typeof mergeFocusBranch;
+}
+export interface FocusMergeAttemptResult {
+    attempted: boolean;
+    mergeSucceeded: boolean;
+    exitReason: string | null;
+}
+/**
+ * Decide whether to merge the focus branch and, if so, run the merge.
+ *
+ * This is the integration of three separate concerns that the merge gate
+ * conflated before:
+ *   1. Branch state: does the focus branch actually have committed work?
+ *   2. Team gate: planningPhase + readOnly safety nets in shouldAttemptMerge.
+ *   3. Per-delivery telemetry: workedDeliveryIds is passed through for
+ *      git-state reporting inside mergeFocusBranch.
+ *
+ * Returns attempted=false when the gate skips the merge (clean exit with
+ * nothing to merge, planning-phase, or read-only). Returns attempted=true
+ * with the merge result otherwise.
+ *
+ * Exported so tests can verify the threading from done-only deliveries +
+ * branch-with-commits to a real mergeFocusBranch invocation, without having
+ * to mock all of handleTeamCompletion's other side effects.
+ */
+export declare function attemptFocusMerge(config: DaemonConfig, teamState: FocusTeamState, sessionId: string, workedDeliveryIds: string[], deps?: FocusMergeAttemptDeps): Promise<FocusMergeAttemptResult>;
 export interface TeamCompletionParams {
     config: DaemonConfig;
     teamState: FocusTeamState;

package/dist/focus-completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-completion.d.ts","sourceRoot":"","sources":["../src/focus-completion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAcpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAelE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIlF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAC/C,OAAO,CAET;AAID,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2VtF;AAID;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACtE,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5H,uBAAuB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7H,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,QAAQ,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACnC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,mBAAiC,GACtC,OAAO,CAAC,IAAI,CAAC,CA+Hf"}
+{"version":3,"file":"focus-completion.d.ts","sourceRoot":"","sources":["../src/focus-completion.ts"],"names":[],"mappings":"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"}