@astrosheep/keiyaku 1.0.0 → 1.0.2

package/build/cli/render/format.js

@@ -1,5 +1,11 @@
 import { getConfig } from "../../config/env.js";
 import { SECTION_ICONS } from "./response-style.js";
+/** Quote a shell argument only when the token is not already a single safe word. */
+export function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
 export const DISPLAY_TEXT_MAX_CHARS = 5000;
 export const FORMAT_MAYBE_MAX_CHARS = 1200;
 export const FORMAT_LIST_MAX_ITEMS = 20;

package/build/cli/render/line-width.js

@@ -0,0 +1,70 @@
+export const NON_TTY_LINE_COLUMNS = 120;
+function isCombining(codePoint) {
+    return (codePoint >= 0x0300 && codePoint <= 0x036f)
+        || (codePoint >= 0x1ab0 && codePoint <= 0x1aff)
+        || (codePoint >= 0x1dc0 && codePoint <= 0x1dff)
+        || (codePoint >= 0x20d0 && codePoint <= 0x20ff)
+        || (codePoint >= 0xfe20 && codePoint <= 0xfe2f)
+        || codePoint === 0xfe0f;
+}
+function isWide(codePoint) {
+    return codePoint >= 0x1100 && (codePoint <= 0x115f
+        || codePoint === 0x2329
+        || codePoint === 0x232a
+        || (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f)
+        || (codePoint >= 0xac00 && codePoint <= 0xd7a3)
+        || (codePoint >= 0xf900 && codePoint <= 0xfaff)
+        || (codePoint >= 0xfe10 && codePoint <= 0xfe19)
+        || (codePoint >= 0xfe30 && codePoint <= 0xfe6f)
+        || (codePoint >= 0xff00 && codePoint <= 0xff60)
+        || (codePoint >= 0xffe0 && codePoint <= 0xffe6)
+        || (codePoint >= 0x1f300 && codePoint <= 0x1faff)
+        || (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+function characterColumns(character) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint === undefined || codePoint === 0 || isCombining(codePoint))
+        return 0;
+    if (codePoint < 0x20 || (codePoint >= 0x7f && codePoint < 0xa0))
+        return 0;
+    return isWide(codePoint) ? 2 : 1;
+}
+export function displayColumns(value) {
+    let width = 0;
+    for (const character of value)
+        width += characterColumns(character);
+    return width;
+}
+export function truncateColumns(value, maxColumns) {
+    if (maxColumns <= 0)
+        return "";
+    if (displayColumns(value) <= maxColumns)
+        return value;
+    if (maxColumns === 1)
+        return "…";
+    const budget = maxColumns - 1;
+    let width = 0;
+    let output = "";
+    for (const character of value) {
+        const next = characterColumns(character);
+        if (width + next > budget)
+            break;
+        output += character;
+        width += next;
+    }
+    return `${output}…`;
+}
+export function resolveLineColumns(stream = process.stdout) {
+    return stream.isTTY === true && Number.isInteger(stream.columns) && stream.columns > 0
+        ? stream.columns
+        : NON_TTY_LINE_COLUMNS;
+}
+/** Preserve the fixed prefix and spend the remaining terminal columns on the variable tail. */
+export function fitVariableLine(fixedPrefix, variableTail, maxColumns) {
+    return `${fixedPrefix}${truncateColumns(variableTail, Math.max(0, maxColumns - displayColumns(fixedPrefix)))}`;
+}
+/** Preserve both decision-bearing affixes and truncate only the descriptive middle. */
+export function fitAffixedLine(fixedPrefix, variableMiddle, fixedSuffix, maxColumns) {
+    const middleBudget = Math.max(0, maxColumns - displayColumns(fixedPrefix) - displayColumns(fixedSuffix));
+    return `${fixedPrefix}${truncateColumns(variableMiddle, middleBudget)}${fixedSuffix}`;
+}

package/build/cli/render/misc.js

@@ -1,6 +1,7 @@
 import { assembleResponse, buildPayload, buildSection, colorizeErrorStatus, FORMAT_LIST_MAX_ITEM_CHARS, formatHints, } from "./format.js";
 import { RESPONSE_MARKERS } from "./response-style.js";
 import { formatReview, HINTS_LIST_MAX_ITEMS, REVIEW_SECTION_TITLE, toReviewPayload, } from "./shared.js";
+import { prependAddressReceipt, renderAddressCarrier } from "./address.js";
 export function buildErrorResponse(input) {
     const shouldRaiseProtocolError = input.errorType === "runtime_error";
     const text = buildErrorText(input);
@@ -24,7 +25,8 @@ function buildErrorText(input) {
     const errorSection = buildSection("Error", input.message);
     const reviewSection = input.review ? buildSection(REVIEW_SECTION_TITLE, formatReview(input.review)) : null;
     const hintsSection = buildSection("Hints", formatHints(input.hints, { maxItems: HINTS_LIST_MAX_ITEMS, maxItemChars: FORMAT_LIST_MAX_ITEM_CHARS }));
-    return assembleResponse(colorizeErrorStatus(`${RESPONSE_MARKERS.failure} Failed [${input.errorCode}]`), "Request could not be completed.", [errorSection, reviewSection, hintsSection].filter((section) => section !== null));
+    const body = assembleResponse(colorizeErrorStatus(`${RESPONSE_MARKERS.failure} Failed [${input.errorCode}]`), "Request could not be completed.", [errorSection, reviewSection, hintsSection].filter((section) => section !== null));
+    return input.addressCarrier ? `${renderAddressCarrier(input.addressCarrier)}\n${body}` : body;
 }
 export function buildHelpResponse(input) {
     return {
@@ -33,8 +35,9 @@ export function buildHelpResponse(input) {
     };
 }
 export function buildLogResponse(result) {
-    return {
+    const { address: _address, ...resultData } = result;
+    return prependAddressReceipt({
         text: result.markdown,
-        payload: buildPayload(result),
-    };
+        payload: buildPayload(resultData),
+    }, result.address);
 }

package/build/cli/render/petition.js

@@ -2,8 +2,9 @@ import { shortCommitHash } from "../../core/render.js";
 import { assembleResponse, buildPayload, buildSection, formatMaybe, formatWarnings, } from "./format.js";
 import { DIFF_OVERVIEW_SECTION_TITLE, RESPONSE_MARKERS, WARNING_SECTION_TITLE } from "./response-style.js";
 import { BRANCH_LABEL, INFO_BRANCH_MAX_CHARS, INFO_COMMIT_MAX_CHARS, INFO_PLEA_MAX_CHARS, } from "./shared.js";
+import { prependAddressReceipt } from "./address.js";
 export function buildPetitionClaimResponse(result, input) {
-    const { status: _status, ...resultData } = result;
+    const { status: _status, address: _address, ...resultData } = result;
     const renderedCommit = result.commit ? shortCommitHash(result.commit) : undefined;
     const commitSuffix = renderedCommit ? ` [${renderedCommit}]` : "";
     const summary = result.deletedBranch
@@ -25,8 +26,8 @@ export function buildPetitionClaimResponse(result, input) {
         ...formatMaybe("Oath", input.oath, INFO_PLEA_MAX_CHARS),
     ];
     const text = assembleResponse(`${RESPONSE_MARKERS.claim} Keiyaku Fulfilled (Claim)`, summary, [ledgerSection, diffSection, warningSection].filter((section) => section !== null), infoLines);
-    return {
+    return prependAddressReceipt({
         text,
         payload: buildPayload(resultData),
-    };
+    }, result.address);
 }

package/build/cli/render/projection-activity.js

@@ -0,0 +1,201 @@
+import { compactText } from "./compact-text.js";
+import { fitAffixedLine, fitVariableLine, resolveLineColumns } from "./line-width.js";
+import { presentFoldedToolActivity, } from "./tool-presentation.js";
+import { presentLedgerPath, summarizeToolLedger } from "./tool-ledger-rollup.js";
+const TIME_GUTTER_WIDTH = 6;
+const VERB_WIDTH = 7;
+const SILENCE_THRESHOLD_MS = 60_000;
+export function formatTimelineDuration(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1_000));
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (totalMinutes < 60)
+        return `${totalMinutes}m${String(seconds).padStart(2, "0")}s`;
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    if (hours < 24)
+        return `${hours}h${String(minutes).padStart(2, "0")}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d${String(hours % 24).padStart(2, "0")}h`;
+}
+function formatActionDuration(ms) {
+    if (ms === undefined)
+        return undefined;
+    if (ms < 10_000 && ms % 1_000 !== 0)
+        return `${(ms / 1_000).toFixed(1)}s`;
+    return formatTimelineDuration(ms);
+}
+function elapsedLabel(anchorMs, at) {
+    const eventMs = Date.parse(at);
+    if (!Number.isFinite(eventMs))
+        return "now";
+    return formatTimelineDuration(Math.max(0, anchorMs - eventMs));
+}
+function compactTokens(value) {
+    if (value < 1_000)
+        return String(value);
+    const compact = (value / 1_000).toFixed(value < 10_000 ? 1 : 0).replace(/\.0$/, "");
+    return `${compact}k`;
+}
+function warningText(row) {
+    const warning = row.warning;
+    const modelRoute = warning.originalModel && warning.fallbackModel
+        ? ` ${warning.originalModel}→${warning.fallbackModel}`
+        : warning.direction
+            ? ` ${warning.direction}`
+            : "";
+    return `provider ${warning.reason}${modelRoute}${row.count > 1 ? ` (${row.count})` : ""}`;
+}
+function renderPlan(plan, maxColumns) {
+    const width = 5;
+    const filled = plan.total === 0 ? 0 : Math.min(width, Math.round((plan.done / plan.total) * width));
+    const bar = `${"▰".repeat(filled)}${"▱".repeat(width - filled)}`;
+    const fixed = `${"now".padStart(TIME_GUTTER_WIDTH)}│ ${"plan".padEnd(VERB_WIDTH)} ${bar} ${plan.done}/${plan.total}`;
+    return fitVariableLine(fixed, plan.activeItem ? ` → ${compactText(plan.activeItem)}` : "", maxColumns);
+}
+function rollupCountLabel(semanticClass) {
+    return semanticClass === "run" ? "ran" : semanticClass;
+}
+function summarizeProjectionToolLedger(activity, workspaceRoot) {
+    return summarizeToolLedger(activity.ledgerActivities, activity.ledgerTurns, (value) => presentLedgerPath(value, workspaceRoot));
+}
+function toolCountSegments(summary) {
+    return summary.counts.map(({ semanticClass, count }) => `${count} ${rollupCountLabel(semanticClass)}`);
+}
+export function renderProjectionActivitySummary(activity, input) {
+    const summary = summarizeProjectionToolLedger(activity, input.workspaceRoot);
+    const segments = toolCountSegments(summary);
+    if (segments.length === 0)
+        return undefined;
+    const spine = input.state === "dead" || input.state === "lost" ? "┆" : "│";
+    return fitVariableLine(`${"".padStart(TIME_GUTTER_WIDTH)}${spine} `, segments.join(" · "), input.maxColumns ?? resolveLineColumns());
+}
+function renderTerminalRollup(activity, input) {
+    const summary = summarizeProjectionToolLedger(activity, input.workspaceRoot);
+    const segments = [
+        ...toolCountSegments(summary),
+        ...(summary.tokens === undefined ? [] : [`${compactTokens(summary.tokens)} tok`]),
+        ...(summary.costUsd === undefined ? [] : [`$${summary.costUsd.toFixed(2)}`]),
+    ];
+    const lines = input.diagnostic
+        ? [fitVariableLine(`${elapsedLabel(input.anchorMs, input.diagnostic.at).padStart(TIME_GUTTER_WIDTH)}┆ ${"warning".padEnd(VERB_WIDTH)} `, compactText(input.diagnostic.text), input.maxColumns)]
+        : [];
+    const endPrefix = `${"end".padStart(TIME_GUTTER_WIDTH)}└`;
+    lines.push(segments.length > 0
+        ? fitVariableLine(`${endPrefix} `, segments.join(" · "), input.maxColumns)
+        : endPrefix);
+    for (const file of summary.files) {
+        const repeat = file.count > 1 ? ` ×${file.count}` : "";
+        const diffstat = file.diffstat ? ` +${file.diffstat.additions} −${file.diffstat.deletions}` : "";
+        lines.push(fitVariableLine("", `${file.path}${repeat}${diffstat}`, input.maxColumns));
+    }
+    if (summary.hiddenFileCount > 0) {
+        lines.push(fitVariableLine("", `… ${summary.hiddenFileCount} more files`, input.maxColumns));
+    }
+    return { lines, hasMutationFiles: summary.files.length > 0 };
+}
+function timelineEntries(activity) {
+    const entries = [];
+    for (const row of activity.timeline) {
+        if (row.kind === "ran") {
+            for (const observation of row.observations) {
+                if (observation.order !== row.order)
+                    entries.push({ kind: "clock", order: observation.order, at: observation.at });
+            }
+        }
+        entries.push({ kind: "row", order: row.order, at: row.at, row });
+    }
+    return entries.sort((left, right) => left.order - right.order);
+}
+export function renderProjectionActivity(activity, input) {
+    const lines = [];
+    let priorAtMs;
+    let hasEndAnchor = false;
+    let lastRunningTool;
+    const maxColumns = input.maxColumns ?? resolveLineColumns();
+    const entries = timelineEntries(activity);
+    for (let index = 0; index < entries.length; index += 1) {
+        const entry = entries[index];
+        const atMs = Date.parse(entry.at);
+        if (entry.kind === "clock") {
+            if (Number.isFinite(atMs))
+                priorAtMs = atMs;
+            continue;
+        }
+        if (priorAtMs !== undefined && Number.isFinite(atMs) && atMs - priorAtMs >= SILENCE_THRESHOLD_MS) {
+            lines.push(fitVariableLine(`${"".padStart(TIME_GUTTER_WIDTH)}┆ `, `${formatTimelineDuration(atMs - priorAtMs)} pass in silence`, maxColumns));
+        }
+        if (Number.isFinite(atMs))
+            priorAtMs = atMs;
+        const row = entry.row;
+        const label = row.kind === "turn" ? "" : elapsedLabel(input.anchorMs, row.at);
+        const spine = row.kind === "turn"
+            ? "├"
+            : input.state === "dead" || input.state === "lost"
+                ? "┆"
+                : "│";
+        if (row.kind === "ran") {
+            const duration = formatActionDuration(row.durationMs);
+            const activityState = row.state === "completed"
+                ? "completed"
+                : input.state === "dead" || input.state === "lost"
+                    ? "interrupted"
+                    : input.state === "stalled" || input.state === "unknown"
+                        ? "unresolved"
+                        : "running";
+            const presentation = presentFoldedToolActivity(row, { state: activityState, ...(duration ? { duration } : {}) }, (value) => presentLedgerPath(value, input.workspaceRoot) ?? value);
+            const fixed = `${label.padStart(TIME_GUTTER_WIDTH)}${spine} ${(presentation.semanticClass === "run" ? "ran" : presentation.semanticClass).padEnd(VERB_WIDTH)} `;
+            lines.push(fitAffixedLine(fixed, presentation.variableText, presentation.fixedSuffix, maxColumns));
+            continue;
+        }
+        if (row.kind === "said") {
+            lines.push(fitVariableLine(`${label.padStart(TIME_GUTTER_WIDTH)}${spine} ${"said".padEnd(VERB_WIDTH)} `, `“${compactText(row.text)}”`, maxColumns));
+        }
+        else if (row.kind === "thought") {
+            const text = `${compactText(row.text)}${row.truncated && !row.text.endsWith("…") ? "…" : ""}`;
+            const duration = formatActionDuration(row.durationMs);
+            lines.push(fitVariableLine(`${label.padStart(TIME_GUTTER_WIDTH)}${spine} ${"thought".padEnd(VERB_WIDTH)} `, `${duration ? `${duration} — ` : ""}“${text}”`, maxColumns));
+        }
+        else if (row.kind === "warning") {
+            lines.push(fitVariableLine(`${label.padStart(TIME_GUTTER_WIDTH)}${spine} ${"warning".padEnd(VERB_WIDTH)} `, warningText(row), maxColumns));
+        }
+        else {
+            const usage = row.inputTokens !== undefined && row.outputTokens !== undefined
+                ? ` · ${compactTokens(row.inputTokens)}▸${compactTokens(row.outputTokens)} tok`
+                : "";
+            const cost = row.costUsd !== undefined ? ` · $${row.costUsd.toFixed(2)}` : "";
+            lines.push(fitVariableLine(`${"".padStart(TIME_GUTTER_WIDTH)}├ `, `turn ${row.turn} sealed${usage}${cost}`, maxColumns));
+        }
+    }
+    for (const row of activity.pinned) {
+        if (row.kind === "ran" && row.state === "running")
+            lastRunningTool = compactText(row.tool);
+    }
+    if (input.showPlan && activity.plan) {
+        const planAtMs = Date.parse(activity.plan.at);
+        if (priorAtMs !== undefined && Number.isFinite(planAtMs) && planAtMs - priorAtMs >= SILENCE_THRESHOLD_MS) {
+            lines.push(fitVariableLine(`${"".padStart(TIME_GUTTER_WIDTH)}┆ `, `${formatTimelineDuration(planAtMs - priorAtMs)} pass in silence`, maxColumns));
+        }
+        lines.push(renderPlan(activity.plan, maxColumns));
+    }
+    let hasMutationFiles = false;
+    if (["returned", "dead", "lost", "dismissed"].includes(input.state)) {
+        const rollup = renderTerminalRollup(activity, {
+            anchorMs: input.anchorMs,
+            ...(input.workspaceRoot ? { workspaceRoot: input.workspaceRoot } : {}),
+            ...(input.terminalDiagnostic ? { diagnostic: input.terminalDiagnostic } : {}),
+            maxColumns,
+        });
+        lines.push(...rollup.lines);
+        hasEndAnchor = true;
+        hasMutationFiles = rollup.hasMutationFiles;
+    }
+    return {
+        lines,
+        ...(lastRunningTool ? { lastRunningTool } : {}),
+        hasEndAnchor,
+        hasMutationFiles,
+    };
+}

package/build/cli/render/shared.js

@@ -1,8 +1,9 @@
 import * as path from "node:path";
 import * as fs from "node:fs";
-import { ACTOR_IDENTITY, KEIYAKU_FILE } from "../../keiyaku.js";
-import { assembleResponse, buildSection, DISPLAY_TEXT_MAX_CHARS, FORMAT_LIST_MAX_ITEM_CHARS, FORMAT_LIST_MAX_ITEMS, formatMaybe, formatWarnings, truncateForDisplay, } from "./format.js";
-import { RESPONSE_MARKERS, WARNING_SECTION_TITLE } from "./response-style.js";
+import { KEIYAKU_FILE } from "../../keiyaku.js";
+import { assembleResponse, buildSection, DISPLAY_TEXT_MAX_CHARS, FORMAT_LIST_MAX_ITEM_CHARS, FORMAT_LIST_MAX_ITEMS, formatMaybe, formatWarnings, shellQuote, truncateForDisplay, } from "./format.js";
+import { WARNING_SECTION_TITLE } from "./response-style.js";
+import { prependAddressReceipt } from "./address.js";
 export function textResponse(text) {
     return {
         text,
@@ -41,6 +42,7 @@ export function buildBindResponse(result, cwd) {
     });
 }
 export function buildForfeitResponse(result) {
+    const { address: _address, ...resultData } = result;
     const base = `Forfeited ${result.contractId}.`;
     const warnings = [
         ...(result.cleanup.worktreeRemoveFailure
@@ -55,10 +57,10 @@ export function buildForfeitResponse(result) {
             : []),
     ];
     if (warnings.length === 0) {
-        return coreTextResponse(base, result);
+        return prependAddressReceipt(coreTextResponse(base, resultData), result.address);
     }
     const warningSection = buildSection(WARNING_SECTION_TITLE, formatWarnings(warnings));
-    return coreTextResponse(assembleResponse(base, "", [warningSection].filter((section) => section !== null)), result);
+    return prependAddressReceipt(coreTextResponse(assembleResponse(base, "", [warningSection].filter((section) => section !== null)), resultData), result.address);
 }
 export const RULES_SECTION_MAX_CHARS = 5000;
 export const BRANCH_LABEL = "Workspace";
@@ -71,10 +73,8 @@ export const STATUS_COMMANDS_SECTION_TITLE = "Commands";
 export const CONTENT_SECTION_TITLE = "Content";
 export const STATUS_ACTIVE_SUMMARY_PREFIX = "● Active";
 export const STATUS_INACTIVE_SUMMARY = "○ Inactive";
-export const SUMMON_RESPONSE_HEADING = `${RESPONSE_MARKERS.arc} Summoned`;
 export const SAVED_TO_PREFIX = "Saved to";
-export const SUMMON_RESPONSE_PATH_HINT_PREFIX = `Run \`keiyaku resume <response-path>\` with this path to summon the same ${ACTOR_IDENTITY} again.`;
-export const INFO_AGENT_MAX_CHARS = 120;
+export const INFO_AKUMA_MAX_CHARS = 120;
 export const INFO_FROM_DRAFT_MAX_CHARS = 300;
 export const EXISTING_BRANCHES_MAX_ITEMS = FORMAT_LIST_MAX_ITEMS;
 export const INFO_BRANCH_MAX_CHARS = 200;
@@ -108,10 +108,44 @@ export function formatPersistenceSummary(responsePath) {
         return "";
     return `${SAVED_TO_PREFIX} ${responsePath}.`;
 }
-export function formatSummonPersistenceSummary(responsePath) {
-    if (!responsePath)
-        return "";
-    return `${formatPersistenceSummary(responsePath)} ${SUMMON_RESPONSE_PATH_HINT_PREFIX}`;
+export function formatCallCompletionHeading(projection) {
+    switch (projection?.phase) {
+        case "active":
+        case "quiescent": return "still out there";
+        case "done": return "returned";
+        case "failed": return "dead";
+        case "dismissed": return "dismissed";
+        case "lost": return undefined;
+        default: return "no record of this akuma";
+    }
+}
+/** Machine-generated durable revive command: artifactId + explicit repository coordinate. */
+export function formatDurableReviveCommand(input) {
+    return input.repositoryCoordinate
+        ? `keiyaku revive ${input.artifactId} --repo ${shellQuote(input.repositoryCoordinate)}`
+        : `keiyaku revive ${input.artifactId}`;
+}
+export function projectionRejoinHintLines(projectionId) {
+    return [
+        "Come back for the result:",
+        `  » keiyaku wait ${projectionId}`,
+        "Steer it while it works:",
+        `  » keiyaku tell ${projectionId} "your words"`,
+    ];
+}
+export function formatCallNextAction(input) {
+    if (input.projection?.phase === "active") {
+        return projectionRejoinHintLines(input.projection.id).join("\n");
+    }
+    if (input.projection?.phase === "done") {
+        return [
+            "The akuma is back.",
+            ...(input.artifactId ? [`record: ${input.artifactId}`] : []),
+            "talk to it:",
+            `  » keiyaku tell ${input.projection.id} "your words"`,
+        ].join("\n");
+    }
+    return "⟶ keiyaku status";
 }
 export function appendPersistenceSummary(base, responsePath) {
     const persistence = formatPersistenceSummary(responsePath);

package/build/cli/render/status.js

@@ -1,7 +1,8 @@
 import { formatSettingsDiseases } from "../../config/settings.js";
 import { formatAgeMs, projectionGlyph, renderKanshiBoard, shortCommitHash } from "../../core/render.js";
+import { renderProjectionActivitySummary, } from "./projection-activity.js";
 export const STATUS_DISEASES_SECTION_TITLE = "Diseases";
-export const STATUS_PROJECTION_SECTION_TITLE = "projection";
+export const STATUS_PROJECTION_SECTION_TITLE = "akuma";
 export const STATUS_CLAIM_RECEIPTS_SECTION_TITLE = "claim receipts";
 export function renderSettingsDiseasesSection(diseases) {
     if (diseases.length === 0)
@@ -21,22 +22,67 @@ function renderProjectionAge(row) {
         return "dismissed";
     if (row.state === "failed")
         return "failed";
-    return formatAgeMs(row.heartbeatAgeMs) ?? "lost";
+    if (row.state === "startup-timeout")
+        return "startup timed out";
+    if (row.state === "unknown")
+        return "unknown";
+    return formatAgeMs(row.activityAgeMs) ?? "";
+}
+function renderProjectionTellCounts(row) {
+    const { inbox, inflight, submitted, consumed } = row.tellCounts;
+    if (inbox === 0 && inflight === 0 && submitted === 0 && consumed === 0)
+        return "";
+    return ` tell ${inbox}▸${inflight}▸${submitted}▸${consumed}`;
+}
+function projectionActivityState(row) {
+    switch (row.state) {
+        case "done": return "returned";
+        case "failed":
+        case "dead": return "dead";
+        case "lost": return "lost";
+        case "dismissed": return "dismissed";
+        case "minting":
+        case "out": return "running";
+        case "startup-timeout": return "stalled";
+        case "unknown": return "unknown";
+    }
+}
+function renderProjectionActivityLine(row) {
+    if (row.state === "startup-timeout" || row.state === "unknown")
+        return undefined;
+    if (!row.activity)
+        return undefined;
+    return renderProjectionActivitySummary(row.activity, {
+        state: projectionActivityState(row),
+        ...(row.workspaceRoot ? { workspaceRoot: row.workspaceRoot } : {}),
+    });
 }
 function renderProjectionRow(row) {
-    const glyph = projectionGlyph(row.state === "failed" ? "lost" : row.state);
-    if (row.state === "minting") {
-        return `  ${glyph} ${row.id.padEnd(18)} (minting)${renderProjectionDiagnostics(row)}`.trimEnd();
+    const glyph = projectionGlyph(row.state === "failed"
+        ? "lost"
+        : row.state === "startup-timeout"
+            ? "minting"
+            : row.state);
+    let heading;
+    if (row.state === "startup-timeout" || row.state === "unknown") {
+        const akuma = (row.akuma ?? "(unknown)").padEnd(18);
+        heading = `  ${glyph} ${row.id}    ${akuma} ${renderProjectionAge(row)}`.trimEnd();
+    }
+    else if (row.state === "minting") {
+        heading = `  ${glyph} ${row.id.padEnd(18)} (minting)${renderProjectionDiagnostics(row)}`.trimEnd();
     }
-    const age = renderProjectionAge(row).padEnd(9);
-    const akuma = (row.akuma ?? "(unknown)").padEnd(18);
-    const tell = `tell ${row.tellCounts.inbox}▸${row.tellCounts.inflight}▸${row.tellCounts.submitted}▸${row.tellCounts.consumed}`;
-    return `  ${glyph} ${row.id}    ${akuma} ${age} ${tell}${renderProjectionDiagnostics(row)}`.trimEnd();
+    else {
+        const age = renderProjectionAge(row).padEnd(9);
+        const akuma = (row.akuma ?? "(unknown)").padEnd(18);
+        heading = `  ${glyph} ${row.id}    ${akuma} ${age}${renderProjectionTellCounts(row)}${renderProjectionDiagnostics(row)}`.trimEnd();
+    }
+    const activity = renderProjectionActivityLine(row);
+    return activity ? [heading, activity] : [heading];
 }
 export function renderProjectionStatusSection(board) {
     if (!board || board.rows.length === 0)
         return "";
-    return `${STATUS_PROJECTION_SECTION_TITLE}\n${board.rows.map(renderProjectionRow).join("\n")}\n`;
+    return `${STATUS_PROJECTION_SECTION_TITLE}\n${board.rows.flatMap(renderProjectionRow).join("\n")}\n`;
 }
 function renderClaimReconciliationSection(recon) {
     if (!recon)
@@ -59,6 +105,9 @@ export function renderStatusBoard(board) {
     if (!projectionText && !receiptsText && board.diseases.length === 0)
         return boardText;
     const sections = [boardText.trimEnd()];
+    if (board.targetFilter !== null) {
+        sections.push("repository-wide — not filtered by target");
+    }
     if (projectionText)
         sections.push(projectionText.trimEnd());
     if (receiptsText)

package/build/cli/render/tool-ledger-rollup.js

@@ -0,0 +1,74 @@
+import * as path from "node:path";
+import { activitySemanticClass } from "./tool-presentation.js";
+const CLASS_ORDER = ["run", "read", "write", "edit", "search", "tool"];
+export function presentLedgerPath(value, workspaceRoot) {
+    const candidate = value.trim();
+    if (!candidate)
+        return undefined;
+    if (!path.isAbsolute(candidate))
+        return candidate;
+    if (!workspaceRoot || !path.isAbsolute(workspaceRoot))
+        return candidate;
+    const relative = path.relative(workspaceRoot, candidate);
+    if (relative === "")
+        return ".";
+    if (path.isAbsolute(relative) || relative === ".." || relative.startsWith(`..${path.sep}`))
+        return candidate;
+    return relative.split(path.sep).join("/");
+}
+export function summarizeToolLedger(activities, turns, presentPath) {
+    const counts = new Map();
+    const files = new Map();
+    for (const row of activities) {
+        const semanticClass = activitySemanticClass(row.call);
+        counts.set(semanticClass, (counts.get(semanticClass) ?? 0) + 1);
+        if (row.call.kind !== "fileChange")
+            continue;
+        const pathDiffstat = row.call.changes.length === 1 && (row.call.omittedChanges ?? 0) === 0
+            ? row.result?.diffstat
+            : undefined;
+        for (const change of row.call.changes) {
+            if (change.op === "delete")
+                continue;
+            const visible = presentPath(change.path);
+            if (!visible)
+                continue;
+            const fileClass = change.op === "add" ? "write" : "edit";
+            const prior = files.get(visible);
+            if (prior) {
+                prior.semanticClass = fileClass;
+                prior.count += 1;
+                prior.allHaveDiffstat &&= pathDiffstat !== undefined;
+                prior.additions += pathDiffstat?.additions ?? 0;
+                prior.deletions += pathDiffstat?.deletions ?? 0;
+            }
+            else {
+                files.set(visible, {
+                    semanticClass: fileClass,
+                    count: 1,
+                    additions: pathDiffstat?.additions ?? 0,
+                    deletions: pathDiffstat?.deletions ?? 0,
+                    allHaveDiffstat: pathDiffstat !== undefined,
+                });
+            }
+        }
+    }
+    const visibleFiles = [...files].map(([visiblePath, file]) => ({
+        semanticClass: file.semanticClass,
+        path: visiblePath,
+        count: file.count,
+        ...(file.allHaveDiffstat ? { diffstat: { additions: file.additions, deletions: file.deletions } } : {}),
+    }));
+    const tokenFacts = turns.filter((turn) => turn.inputTokens !== undefined && turn.outputTokens !== undefined);
+    const costFacts = turns.filter((turn) => turn.costUsd !== undefined);
+    return {
+        counts: CLASS_ORDER.flatMap((semanticClass) => {
+            const count = counts.get(semanticClass);
+            return count === undefined ? [] : [{ semanticClass, count }];
+        }),
+        files: visibleFiles.slice(0, 10),
+        hiddenFileCount: Math.max(0, visibleFiles.length - 10),
+        ...(tokenFacts.length ? { tokens: tokenFacts.reduce((sum, turn) => sum + turn.inputTokens + turn.outputTokens, 0) } : {}),
+        ...(costFacts.length ? { costUsd: costFacts.reduce((sum, turn) => sum + turn.costUsd, 0) } : {}),
+    };
+}