@gempack/squad-mcp 0.8.2 → 0.10.1

package/dist/runs/store.js

@@ -0,0 +1,406 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { AGENT_NAMES_TUPLE } from "../config/ownership-matrix.js";
+import { SquadError } from "../errors.js";
+import { ensureRelativeInsideRoot } from "../util/path-safety.js";
+import { withFileLock } from "../util/file-lock.js";
+import { logger } from "../observability/logger.js";
+import { SafeString } from "../tools/_shared/schemas.js";
+/**
+ * SQUAD RUNS STORE — telemetry journal for skill invocations. As of v0.10.0
+ * the legitimate writers are the squad skill (`/squad:implement` and
+ * `/squad:review`, invocations `implement | review | task`) and the debug
+ * skill (`/squad:debug`, invocation `debug`). Each writer follows the same
+ * two-phase contract: one row at start (`in_flight`) and one at end
+ * (`completed | aborted`), paired by id. Mirrored line-for-line after
+ * `src/learning/store.ts` — same lock + quarantine + mtime cache + atomic-
+ * append-under-PIPE_BUF discipline.
+ *
+ * Plan v4 (cycle 2 advisory consensus) explicit decisions:
+ *
+ *  - NO multi-row partial fallback. If `JSON.stringify(record)` exceeds
+ *    MAX_RECORD_BYTES the store rejects with `RECORD_TOO_LARGE` rather
+ *    than splitting into continuation rows. Five advisors converged on
+ *    "splitting erodes the one-row-per-record JSONL invariant and
+ *    reopens parsing ambiguities"; rejection puts the burden on the
+ *    caller to cap their `mode_warning.message` (already capped 512B)
+ *    or shorten their inputs.
+ *
+ *  - File mode 0o600 (user-only), directory mode 0o700. The journal
+ *    contains commit refs and prompt-length signals that can leak
+ *    business context (branch names like `feat/acme-acquisition`); on
+ *    shared workstations world-readable 0o644 would expose them to
+ *    co-tenants.
+ *
+ *  - Single-writer contract: the squad skill (`skills/squad/SKILL.md`)
+ *    AND the debug skill (`skills/debug/SKILL.md`) are the only legitimate
+ *    callers of `appendRun`. `apply_consolidation_rules` and other server-
+ *    side code MUST NOT emit terminal rows; doing so breaks the two-phase
+ *    `(in_flight, completed)` pair-by-id invariant.
+ */
+/**
+ * Hard cap per JSONL entry so a single line fits in POSIX PIPE_BUF
+ * (4096 bytes) and `fs.appendFile` remains atomic w.r.t. concurrent
+ * appenders. Length includes serialised JSON + trailing newline.
+ *
+ * Realistic finalization row with 9 agents + capped mode_warning.message
+ * lands around 1.5-2 KB — well under the limit. Oversize is a hard error,
+ * not a soft truncation (see RECORD_TOO_LARGE in errors.ts).
+ */
+export const MAX_RECORD_BYTES = 4_000;
+/**
+ * Default location for the JSONL file, relative to workspace_root.
+ * Defaults are gitignored at the v0.9.0 release — the journal contains
+ * local-only operational telemetry; users opting into team-wide sharing
+ * remove `.squad/runs.jsonl` from their `.gitignore` deliberately.
+ */
+export const DEFAULT_RUNS_PATH = ".squad/runs.jsonl";
+/**
+ * Severity tally compacted into a single sortable number. The cycle-1
+ * design carried `{ Blocker, Major, Minor, Suggestion }` per agent
+ * (~30 bytes / agent of JSON overhead); cycle 2 architects + dev flagged
+ * this as PIPE_BUF-budget waste on 9-agent runs. Collapsed to one number
+ * with positional digits: B*1000 + M*100 + m*10 + s. Inverse decode in
+ * aggregate.ts. Safe up to 9 of each severity per agent (more than that
+ * is itself a signal something went sideways).
+ */
+function severityScore(counts) {
+    return counts.Blocker * 1000 + counts.Major * 100 + counts.Minor * 10 + counts.Suggestion;
+}
+/** Inverse of `severityScore`. Used by aggregate.ts. */
+export function decodeSeverityScore(n) {
+    return {
+        Blocker: Math.floor(n / 1000),
+        Major: Math.floor((n % 1000) / 100),
+        Minor: Math.floor((n % 100) / 10),
+        Suggestion: n % 10,
+    };
+}
+/** Public re-export so callers can build records without re-implementing the encoding. */
+export { severityScore };
+/**
+ * Strip C0 (`\x00`-`\x1F` except `\t`), C1 (`\x7F`-`\x9F`), and ESC (`\x1B`)
+ * from a string before it lands on disk. This is the WRITER-side mirror of
+ * the renderer's `aggregate.stripControlChars` (security #5).
+ *
+ * Defense in depth: render-time sanitisation protects users running
+ * `/squad:stats`; writer-side sanitisation also protects users running
+ * `cat .squad/runs.jsonl` or any other tool that bypasses the aggregator.
+ * The regex is intentionally duplicated (3 lines, no runtime cost) rather
+ * than importing from `aggregate.ts` because that would invert the natural
+ * dep direction (store is foundational; aggregate consumes store).
+ */
+function stripWriterControlChars(s) {
+    return s.replace(/[\x00-\x08\x0A-\x1F\x7F-\x9F]/g, "");
+}
+/**
+ * Canonical tuple of accepted journal invocations. Single source of truth.
+ *
+ * Why a tuple, not just a Zod enum: the same set is consumed by FIVE call
+ * sites — this store's `InvocationEnum`, the tool boundary at
+ * `src/tools/record-run.ts`, the filter schema at `src/tools/list-runs.ts`,
+ * the Record literal in the aggregate output type, and the `invocation_counts`
+ * initialiser in `src/runs/aggregate.ts`. Exporting one tuple makes "add a
+ * new invocation" a single-line change instead of five-sites-must-stay-in-
+ * sync. Pattern parallels `AGENT_NAMES_TUPLE` in `src/config/ownership-matrix.ts`.
+ *
+ * `as const` (readonly tuple) is what Zod's `z.enum` requires.
+ */
+export const INVOCATION_VALUES = [
+    "implement",
+    "review",
+    "task",
+    "question",
+    "brainstorm",
+    "debug",
+];
+const InvocationEnum = z.enum(INVOCATION_VALUES);
+const ModeEnum = z.enum(["quick", "normal", "deep"]);
+const ModeSourceEnum = z.enum(["user", "auto"]);
+const StatusEnum = z.enum(["in_flight", "completed", "aborted"]);
+const WorkTypeEnum = z.enum([
+    "Feature",
+    "Bug Fix",
+    "Refactor",
+    "Performance",
+    "Security",
+    "Business Rule",
+]);
+const VerdictEnum = z.enum(["APPROVED", "CHANGES_REQUIRED", "REJECTED"]);
+const ModelEnum = z.enum(["haiku", "sonnet", "opus", "inherit"]);
+const GitRefSchema = z
+    .object({
+    kind: z.enum(["head", "diff_base", "pr_head"]),
+    value: SafeString(200),
+})
+    .nullable();
+/**
+ * Per-agent dispatch metrics captured by the squad skill orchestrator.
+ *
+ *  - `batch_duration_ms` (renamed from `duration_ms` in v0.9.0): wall-clock
+ *    from this agent's Task() dispatch to its result. Note that advisors in
+ *    a parallel batch overlap; this is "round-trip latency for this dispatch"
+ *    not "exclusive time spent on this agent's work". Reflected in the
+ *    /squad:stats output label.
+ *
+ *  - `prompt_chars` / `response_chars` (renamed from input/output_chars in
+ *    v0.9.0): orchestrator-visible character counts of the dispatch prompt
+ *    and the agent's returned string. EXCLUDES the agent's own internal
+ *    tool_use roundtrips (file reads, sub-dispatches like code-explorer).
+ *    For agents that read heavily, the recorded chars are a substantial
+ *    underestimate — documented in `est_tokens_method` and rendered in the
+ *    stats panel disclaimer.
+ *
+ *  - `severity_score`: encoded findings tally (see severityScore()).
+ */
+const AgentMetricsSchema = z.object({
+    name: z.enum(AGENT_NAMES_TUPLE),
+    model: ModelEnum,
+    score: z.number().int().min(0).max(100).nullable(),
+    severity_score: z.number().int().min(0).max(9999).nullable(),
+    batch_duration_ms: z.number().int().nonnegative().finite(),
+    prompt_chars: z.number().int().nonnegative().finite(),
+    response_chars: z.number().int().nonnegative().finite(),
+});
+/**
+ * RunRecord schema_version 1. PUBLIC STABLE CONTRACT from v0.9.0 — readers
+ * (the `list_runs` MCP tool, the `/squad:stats` skill) key on
+ * `schema_version` and quarantine unknown versions rather than failing.
+ *
+ * Discriminated by `status`:
+ *  - `in_flight` rows carry only the Phase-1-known fields (skill knows what
+ *    it's about to do; verdict/scores are still pending).
+ *  - `completed | aborted` rows carry full metrics + verdict.
+ *
+ * For ergonomics under Zod we keep finalisation fields optional on the base
+ * schema rather than splitting into two schemas; the writer validates the
+ * appropriate subset at the call site (`appendRun` vs `finalizeRun`).
+ */
+const runRecordSchema = z.object({
+    schema_version: z.literal(1),
+    id: SafeString(40),
+    status: StatusEnum,
+    started_at: SafeString(40),
+    completed_at: SafeString(40).optional(),
+    duration_ms: z.number().int().nonnegative().finite().optional(),
+    invocation: InvocationEnum,
+    mode: ModeEnum,
+    mode_source: ModeSourceEnum,
+    work_type: WorkTypeEnum.optional(),
+    git_ref: GitRefSchema,
+    files_count: z.number().int().nonnegative().finite(),
+    agents: z.array(AgentMetricsSchema).max(20),
+    verdict: VerdictEnum.nullable().optional(),
+    weighted_score: z.number().min(0).max(100).nullable().optional(),
+    est_tokens_method: z.literal("chars-div-3.5"),
+    mode_warning: z
+        .object({
+        code: SafeString(64),
+        message: SafeString(512),
+    })
+        .nullable()
+        .optional(),
+});
+export { runRecordSchema, WorkTypeEnum };
+const cache = new Map();
+/** Test-only: clear the per-process cache. Production code MUST NOT call this. */
+export function __resetRunsStoreCacheForTests() {
+    cache.clear();
+}
+function resolveRunsFile(workspaceRoot, configuredPath) {
+    const rel = configuredPath ?? DEFAULT_RUNS_PATH;
+    if (configuredPath !== undefined) {
+        ensureRelativeInsideRoot(workspaceRoot, rel, "runs.path");
+    }
+    return path.resolve(workspaceRoot, rel);
+}
+/**
+ * Generate a fresh run id. Date.now() base36 prefix + 6 chars from
+ * [a-z0-9] (36^6 = 2.18B unique values per millisecond — collision
+ * chance is effectively zero across realistic concurrent writers in
+ * the same ms).
+ */
+export function generateRunId() {
+    const ts = Date.now().toString(36);
+    let suffix = "";
+    const ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+    for (let i = 0; i < 6; i++) {
+        suffix += ALPHABET[Math.floor(Math.random() * ALPHABET.length)];
+    }
+    return `${ts}-${suffix}`;
+}
+/**
+ * Read all run records from the JSONL file. Returns `[]` if the file does
+ * not exist (fresh repo, first run). Corrupt lines are quarantined to a
+ * timestamped sibling file and logged once; the surviving entries return
+ * in append order.
+ *
+ * Unknown `schema_version` rows are quarantined too — readers must NEVER
+ * silently include rows they don't understand. The quarantine file is
+ * `.squad/runs.jsonl.corrupt-<ts>.jsonl` alongside the source.
+ */
+export async function readRuns(workspaceRoot, options = {}) {
+    const filePath = resolveRunsFile(workspaceRoot, options.configuredPath);
+    const absRoot = path.resolve(workspaceRoot);
+    let stat;
+    try {
+        stat = await fs.stat(filePath);
+    }
+    catch {
+        return [];
+    }
+    if (!stat.isFile())
+        return [];
+    const cached = cache.get(absRoot);
+    if (cached &&
+        cached.filePath === filePath &&
+        cached.mtimeMs === stat.mtimeMs &&
+        cached.size === stat.size) {
+        return cached.entries;
+    }
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch (err) {
+        throw new SquadError("CONFIG_READ_FAILED", `failed to read runs file ${filePath}: ${err.message}`, { source: filePath });
+    }
+    const lines = raw.split(/\r?\n/);
+    const entries = [];
+    const corruptLines = [];
+    let skippedUnknownVersion = 0;
+    let lineNo = 0;
+    for (const line of lines) {
+        lineNo++;
+        const trimmed = line.trim();
+        if (trimmed === "")
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (err) {
+            corruptLines.push({
+                line: lineNo,
+                raw: trimmed,
+                reason: `invalid JSON: ${err.message}`,
+            });
+            continue;
+        }
+        // Schema_version gate: skip+log instead of throwing. A future v2 writer
+        // would otherwise brick v1 readers; this lets a heterogeneous-version
+        // journal be partially read by older clients (architect A-6 + dev #11).
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "schema_version" in parsed &&
+            parsed.schema_version !== 1) {
+            skippedUnknownVersion++;
+            continue;
+        }
+        const validated = runRecordSchema.safeParse(parsed);
+        if (!validated.success) {
+            corruptLines.push({
+                line: lineNo,
+                raw: trimmed,
+                reason: `schema violation: ${validated.error.message}`,
+            });
+            continue;
+        }
+        entries.push(validated.data);
+    }
+    if (skippedUnknownVersion > 0) {
+        logger.warn("runs: skipped rows with unknown schema_version", {
+            details: { file: filePath, count: skippedUnknownVersion },
+        });
+    }
+    if (corruptLines.length > 0) {
+        const quarantinePath = `${filePath}.corrupt-${Date.now()}.jsonl`;
+        try {
+            const body = corruptLines.map((c) => `# line ${c.line}: ${c.reason}\n${c.raw}\n`).join("");
+            // Write quarantine with same restricted mode as the source.
+            await fs.writeFile(quarantinePath, body, { encoding: "utf8", mode: 0o600 });
+        }
+        catch {
+            // Diagnostic, not load-bearing.
+        }
+        logger.warn("runs: corrupt lines quarantined", {
+            details: {
+                file: filePath,
+                quarantine: quarantinePath,
+                count: corruptLines.length,
+                lines: corruptLines.map((c) => c.line),
+            },
+        });
+    }
+    cache.set(absRoot, { mtimeMs: stat.mtimeMs, size: stat.size, filePath, entries });
+    return entries;
+}
+/**
+ * Append one RunRecord. Validates against Zod, then enforces
+ * MAX_RECORD_BYTES (post-serialisation) before acquiring the file lock.
+ * Oversize records throw `RECORD_TOO_LARGE` — no silent split, no soft
+ * truncation. The caller (the squad skill) is responsible for keeping
+ * `mode_warning.message` capped and the agent list short enough that
+ * realistic records stay well under the cap.
+ */
+export async function appendRun(workspaceRoot, record, options = {}) {
+    const validated = runRecordSchema.safeParse(record);
+    if (!validated.success) {
+        throw new SquadError("INVALID_INPUT", `run record schema violation: ${validated.error.message}`, { issues: validated.error.issues.length });
+    }
+    // Defense in depth: strip control chars from `mode_warning.message` at the
+    // writer too. The aggregator's `stripControlChars` already runs at render
+    // (security #5 in v0.9.0), but direct file inspection (`cat`, `less`) sees
+    // raw bytes. Sanitising here keeps the recorded data terminal-safe for any
+    // future viewer that bypasses the aggregator. We strip only this one field
+    // because it's the documented free-form leak surface — other fields are
+    // schema-bounded to safer shapes (enums, ISO strings, numbers, sha refs).
+    const sanitized = validated.data.mode_warning != null
+        ? {
+            ...validated.data,
+            mode_warning: {
+                ...validated.data.mode_warning,
+                message: stripWriterControlChars(validated.data.mode_warning.message),
+            },
+        }
+        : validated.data;
+    const line = JSON.stringify(sanitized) + "\n";
+    const byteLen = Buffer.byteLength(line, "utf8");
+    if (byteLen > MAX_RECORD_BYTES) {
+        throw new SquadError("RECORD_TOO_LARGE", `run record exceeds MAX_RECORD_BYTES (${byteLen} > ${MAX_RECORD_BYTES}); ` +
+            `cap mode_warning.message or shorten inputs`, { byteLen, max: MAX_RECORD_BYTES, id: validated.data.id });
+    }
+    const filePath = resolveRunsFile(workspaceRoot, options.configuredPath);
+    const dir = path.dirname(filePath);
+    // Directory mode 0o700 — user-only. Subsequent runs inherit the existing
+    // mode if the dir already exists (mkdir recursive is idempotent on mode).
+    await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+    // Cross-process lock around the append. The lock file lives in the same
+    // directory; file-lock.ts cleans it up in a finally.
+    await withFileLock(filePath, async () => {
+        // Create the journal with explicit mode 0o600 on first write. fs.open
+        // honours mode only when O_CREAT applies (i.e. the file is being
+        // created); subsequent appends ride the existing mode.
+        const fh = await fs.open(filePath, "a", 0o600);
+        try {
+            await fh.writeFile(line, "utf8");
+        }
+        finally {
+            await fh.close();
+        }
+    });
+    // Invalidate cache so the next readRuns picks up the append.
+    const absRoot = path.resolve(workspaceRoot);
+    cache.delete(absRoot);
+    logger.info("run recorded", {
+        details: {
+            file: filePath,
+            id: validated.data.id,
+            status: validated.data.status,
+            invocation: validated.data.invocation,
+        },
+    });
+    return { filePath, record: validated.data };
+}
+//# sourceMappingURL=store.js.map

package/dist/runs/store.js.map

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

package/dist/tools/list-runs.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type AgentName } from "../config/ownership-matrix.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodEffects<z.ZodString, string, string>;
+    /** ISO 8601 lower bound on `started_at`. */
+    since: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    /** Cap output to the most recent N folded runs. */
+    limit: z.ZodOptional<z.ZodNumber>;
+    /** Restrict to runs that included this agent in any role. */
+    agent: z.ZodOptional<z.ZodEnum<[AgentName, ...AgentName[]]>>;
+    /** Restrict to a single terminal verdict. */
+    verdict: z.ZodOptional<z.ZodEnum<["APPROVED", "CHANGES_REQUIRED", "REJECTED"]>>;
+    /** Restrict to a single dispatch mode. */
+    mode: z.ZodOptional<z.ZodEnum<["quick", "normal", "deep"]>>;
+    /** Restrict to a single invocation kind. */
+    invocation: z.ZodOptional<z.ZodEnum<["implement", "review", "task", "question", "brainstorm", "debug"]>>;
+    /** Restrict to a single work type. */
+    work_type: z.ZodOptional<z.ZodEnum<["Feature", "Bug Fix", "Refactor", "Performance", "Security", "Business Rule"]>>;
+    /**
+     * If true, return aggregate views (outcomes + health + trend) instead of
+     * the folded raw rows. The /squad:stats skill uses this; CLI inspections
+     * default to the raw list.
+     */
+    aggregate: z.ZodOptional<z.ZodBoolean>;
+    /** Days of trend sparkline data to compute when aggregate=true. Default 14. */
+    trend_days: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    work_type?: "Feature" | "Bug Fix" | "Refactor" | "Performance" | "Security" | "Business Rule" | undefined;
+    agent?: AgentName | undefined;
+    mode?: "quick" | "normal" | "deep" | undefined;
+    limit?: number | undefined;
+    invocation?: "debug" | "review" | "task" | "implement" | "question" | "brainstorm" | undefined;
+    verdict?: "APPROVED" | "CHANGES_REQUIRED" | "REJECTED" | undefined;
+    since?: string | undefined;
+    aggregate?: boolean | undefined;
+    trend_days?: number | undefined;
+}, {
+    workspace_root: string;
+    work_type?: "Feature" | "Bug Fix" | "Refactor" | "Performance" | "Security" | "Business Rule" | undefined;
+    agent?: AgentName | undefined;
+    mode?: "quick" | "normal" | "deep" | undefined;
+    limit?: number | undefined;
+    invocation?: "debug" | "review" | "task" | "implement" | "question" | "brainstorm" | undefined;
+    verdict?: "APPROVED" | "CHANGES_REQUIRED" | "REJECTED" | undefined;
+    since?: string | undefined;
+    aggregate?: boolean | undefined;
+    trend_days?: number | undefined;
+}>;
+export declare const listRunsToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/list-runs.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { SafeString } from "./_shared/schemas.js";
+import { AGENT_NAMES_TUPLE } from "../config/ownership-matrix.js";
+import { readRuns, INVOCATION_VALUES } from "../runs/store.js";
+import { foldById, applyFilters, aggregateOutcomes, aggregateHealth, trendByDay, getEstTokens, } from "../runs/aggregate.js";
+/**
+ * Read tool: load runs from `.squad/runs.jsonl`, fold the two-phase
+ * (in_flight, terminal) pair by id, apply filters, and either return the
+ * folded raw list or a precomputed aggregate bundle.
+ *
+ * Plan v4 architect A-3: collapse the original `list_runs + aggregate_runs`
+ * pair into one tool with an `aggregate: boolean` flag. The skill calls
+ * the aggregate form for `/squad:stats`; humans (or other tools) call the
+ * non-aggregate form to inspect raw rows.
+ *
+ * No writes here. The single-writer contract belongs to `record_run`.
+ */
+const InvocationEnum = z.enum(INVOCATION_VALUES);
+const ModeEnum = z.enum(["quick", "normal", "deep"]);
+const VerdictEnum = z.enum(["APPROVED", "CHANGES_REQUIRED", "REJECTED"]);
+const WorkTypeEnum = z.enum([
+    "Feature",
+    "Bug Fix",
+    "Refactor",
+    "Performance",
+    "Security",
+    "Business Rule",
+]);
+const schema = z.object({
+    workspace_root: SafeString(4096),
+    /** ISO 8601 lower bound on `started_at`. */
+    since: SafeString(40).optional(),
+    /** Cap output to the most recent N folded runs. */
+    limit: z.number().int().positive().max(5000).optional(),
+    /** Restrict to runs that included this agent in any role. */
+    agent: z.enum(AGENT_NAMES_TUPLE).optional(),
+    /** Restrict to a single terminal verdict. */
+    verdict: VerdictEnum.optional(),
+    /** Restrict to a single dispatch mode. */
+    mode: ModeEnum.optional(),
+    /** Restrict to a single invocation kind. */
+    invocation: InvocationEnum.optional(),
+    /** Restrict to a single work type. */
+    work_type: WorkTypeEnum.optional(),
+    /**
+     * If true, return aggregate views (outcomes + health + trend) instead of
+     * the folded raw rows. The /squad:stats skill uses this; CLI inspections
+     * default to the raw list.
+     */
+    aggregate: z.boolean().optional(),
+    /** Days of trend sparkline data to compute when aggregate=true. Default 14. */
+    trend_days: z.number().int().positive().max(90).optional(),
+});
+function serializeFolded(f) {
+    return {
+        id: f.id,
+        status: f.status,
+        synthesized_aborted: f.synthesized_aborted,
+        record: f.record,
+        est_tokens: getEstTokens(f.record),
+    };
+}
+function workTypeFilter(folded, wt) {
+    return folded.filter((f) => f.record.work_type === wt);
+}
+async function handler(input) {
+    // Read raw records. readRuns swallows ENOENT and returns []; missing-journal
+    // is a normal "no runs yet" state, not an error.
+    const records = await readRuns(input.workspace_root);
+    const totalInStore = records.length;
+    const folded = foldById(records);
+    // Apply work_type FIRST so it composes with limit semantically. If we applied
+    // it after applyFilters, `limit: N` would truncate by started_at BEFORE the
+    // work_type predicate, giving "bug fixes within the last N runs" instead of
+    // "last N bug fixes" — silently wrong. (senior-developer cycle-2 Major.)
+    let prefiltered = folded;
+    if (input.work_type) {
+        prefiltered = workTypeFilter(prefiltered, input.work_type);
+    }
+    const filtered = applyFilters(prefiltered, {
+        ...(input.since !== undefined && { since: input.since }),
+        ...(input.limit !== undefined && { limit: input.limit }),
+        ...(input.agent !== undefined && { agent: input.agent }),
+        ...(input.verdict !== undefined && { verdict: input.verdict }),
+        ...(input.mode !== undefined && { mode: input.mode }),
+        ...(input.invocation !== undefined && { invocation: input.invocation }),
+    });
+    // Filepath surfacing: we don't currently resolve the configured path here
+    // (the store handles its own resolution); reporting null when no records is
+    // honest about the "fresh repo" state.
+    const filePath = totalInStore > 0 ? `${input.workspace_root}/.squad/runs.jsonl` : null;
+    if (!input.aggregate) {
+        return {
+            ok: true,
+            file: filePath,
+            total_in_store: totalInStore,
+            total_folded: filtered.length,
+            runs: filtered.map(serializeFolded),
+        };
+    }
+    const outcomes = aggregateOutcomes(filtered);
+    const health = aggregateHealth(filtered);
+    const trendBuckets = trendByDay(filtered, input.trend_days ?? 14);
+    return {
+        ok: true,
+        file: filePath,
+        total_in_store: totalInStore,
+        total_folded: filtered.length,
+        outcomes: {
+            total_runs: outcomes.total_runs,
+            verdict_counts: outcomes.verdict_counts,
+            verdict_total: outcomes.verdict_total,
+            score_buckets: outcomes.score_buckets,
+            invocation_counts: outcomes.invocation_counts,
+            est_tokens_total: outcomes.est_tokens_total,
+            est_tokens_per_run_avg: outcomes.est_tokens_per_run_avg,
+            est_tokens_per_agent: Array.from(outcomes.est_tokens_per_agent.entries()).map(([agent, t]) => ({ agent, ...t })),
+            is_empty: outcomes.is_empty,
+        },
+        health: {
+            total_runs: health.total_runs,
+            in_flight: health.in_flight,
+            completed: health.completed,
+            aborted: health.aborted,
+            synthesized_aborted: health.synthesized_aborted,
+            avg_batch_duration_ms_per_agent: Array.from(health.avg_batch_duration_ms_per_agent.entries()).map(([agent, avg_ms]) => ({ agent, avg_ms })),
+            avg_total_duration_ms: health.avg_total_duration_ms,
+        },
+        trend: { days: input.trend_days ?? 14, counts: trendBuckets },
+    };
+}
+export const listRunsToolDef = {
+    name: "list_runs",
+    description: "Read tool for `.squad/runs.jsonl`. Folds the two-phase (in_flight, terminal) row pair by id, " +
+        "applies filters (since / limit / agent / verdict / mode / invocation / work_type), and returns " +
+        "either the folded list (aggregate=false, default) or a precomputed aggregate bundle " +
+        "(outcomes + health + trend sparkline buckets) when aggregate=true. Missing-journal returns " +
+        "an empty result, not an error. Read-only — never writes.",
+    schema,
+    handler,
+};
+//# sourceMappingURL=list-runs.js.map

package/dist/tools/list-runs.js.map

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