baxian 0.0.1 → 0.2.0

package/dist/skills/pr-feedback/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: pr-feedback
+description: Use when the dev (PR author) must process review feedback, including project aliases like "pr N", qa callbacks, human comments, bot findings, threaded review comments, Fixed/Won't fix replies, follow-up issues, or recheck requests.
+---
+
+# PR Feedback
+
+## Overview
+
+Treat the pull request as the only durable source of review feedback. Fetch every review, inline comment, and conversation comment; judge each actionable item independently; then either fix it, decline it with a reason, or move out-of-scope work into a tracked issue.
+
+## Before You Start
+
+Read the consuming repository's agent instructions first. In particular, find:
+
+- Required PR feedback format.
+- Required test and push rules.
+- How to identify already-addressed comments.
+- Whether out-of-scope feedback must become an issue.
+- How to notify the qa agent after replies or new commits.
+- The transport skill or script used for notification, if any.
+
+Do not rely on another agent's chat transcript or tmux pane output. If the feedback is not in the PR, ask that it be written there before treating it as official review input.
+
+Project-specific trigger aliases such as `pr N` are compatibility shims. The reusable concept is "process PR feedback"; do not require other projects to adopt the same alias names.
+
+## Fetch Feedback
+
+**Tool selection.** Prefer the local `gh` CLI for all GitHub interactions; it is the lowest-friction, best-authenticated path on most workstations. Fall back to a GitHub MCP server or connector tool only when `gh` is missing, unauthenticated, or the required call has no `gh` equivalent. Do not start with a connector when `gh` would work.
+
+For GitHub, collect all three surfaces:
+
+```bash
+gh api --paginate repos/OWNER/REPO/pulls/N/reviews
+gh api --paginate repos/OWNER/REPO/pulls/N/comments
+gh api --paginate repos/OWNER/REPO/issues/N/comments
+```
+
+Also fetch PR metadata and current head:
+
+```bash
+gh pr view N --json title,body,headRefName,headRefOid,baseRefName,reviewDecision,url
+```
+
+The required result is full PR metadata plus every review body, inline review comment, and top-level conversation comment.
+
+## Classify Items
+
+Build a working list of every actionable item. Include comments from humans, review agents, and review bots. For each item, record:
+
+- Author and comment URL or ID.
+- File and line, when available.
+- Current status: unresolved, already fixed, invalid, duplicate, or out of scope.
+- The evidence you used to decide.
+
+Do not batch-dismiss findings because another reviewer said the same thing. Confirm each one against the code and tests.
+
+## Decide and Act
+
+For each actionable item:
+
+1. If it is correct and in scope, fix it.
+
+   Keep the change focused. Add or update tests for the behavior. Run the relevant local tests. Commit and push before claiming the fix is done.
+
+2. If it is incorrect or not appropriate for this PR, reply with a reason.
+
+   The first line must be:
+
+   ```text
+   Won't fix
+   ```
+
+   Then explain the concrete evidence. Do not use vague phrases such as "not needed" without backing.
+
+3. If it is real but out of scope, create a follow-up issue first.
+
+   Include enough context for a future agent to reproduce the concern, then reply to the review item with the issue link and why it is being split out.
+
+4. If it is already fixed by current head, verify that in the code and tests before replying.
+
+   The first line must be:
+
+   ```text
+   Fixed
+   ```
+
+   Include the commit SHA when a code change was pushed for that item.
+
+## Reply Rules
+
+Reply to every actionable item. Do not silently ignore duplicates; say they are duplicates and link or reference the primary response.
+
+Use the review platform's threaded reply for inline review comments when possible. Use a top-level PR comment only when the platform has no threaded reply surface for that item.
+
+Never announce "fixed", "done", or "complete" before code changes are committed and pushed to the PR branch.
+
+## Recheck Notification
+
+After all replies and commits are visible on the PR, follow the consuming repository's notification rule. Common patterns include:
+
+- Dispatching `recheck N` to the qa agent.
+- Requesting another review from a human or bot.
+- Leaving the PR ready for manual merge.
+
+If the project uses tmux for agent notification, use the `tmux-send` skill and the project-local routing table. Do not hardcode hostnames or session names in this skill.
+
+## Stop Conditions
+
+Stop and report current state to the human when:
+
+- The PR is approved and no actionable findings remain.
+- The remaining findings have all been answered with `Won't fix`.
+- The project-defined maximum review loop count is reached.
+- A new human instruction changes the task.
+
+When stopping, summarize the PR decision, unresolved items if any, and the exact next action.

package/dist/skills/pr-recheck/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: pr-recheck
+description: Use when the qa agent must re-evaluate a pull request after prior review feedback, including project aliases like "recheck N", dev replies, new commits, unchanged heads, finding closure, new test coverage, approval, and dev notification.
+---
+
+# PR Recheck
+
+## Overview
+
+Recheck the PR's latest state against the previous review context. This is not a fresh blind review: it verifies whether prior findings were closed, whether the dev's replies are technically sound, and whether new changes introduced new risks.
+
+Project-specific trigger aliases such as `recheck N` are compatibility shims. The reusable concept is "re-evaluate a PR after feedback".
+
+## Gather Context
+
+Read the consuming repository's agent instructions and fetch:
+
+- Current PR head SHA and diff.
+- Previous reviews, inline comments, issue comments, and dev replies.
+- Commits since the last reviewed head.
+- Checks and tests relevant to changed files.
+
+**Tool selection.** Prefer the local `gh` CLI for all GitHub interactions; it is the lowest-friction, best-authenticated path on most workstations. Fall back to a GitHub MCP server or connector tool only when `gh` is missing, unauthenticated, or the required call has no `gh` equivalent. Do not start with a connector when `gh` would work.
+
+```bash
+gh pr view N --json headRefOid,reviewDecision,comments,reviews,files
+gh pr diff N
+gh api --paginate repos/OWNER/REPO/pulls/N/reviews
+gh api --paginate repos/OWNER/REPO/pulls/N/comments
+gh api --paginate repos/OWNER/REPO/issues/N/comments
+```
+
+`gh pr view --json reviews` returns at most one unpaginated page; on PRs with many review rounds it silently truncates older verdicts. Always fetch the full review history via the paginated `gh api` line above before deciding any finding is "closed".
+
+## Decision Path
+
+- If the head changed, review the increment since the previous reviewed head, verify every prior finding is actually closed, and check that new or changed behavior has tests.
+- If the head did not change but the dev replied, judge the reply against the code and project rules. Do not accept "fixed" claims without evidence.
+- If neither code nor relevant replies changed, say the head has not changed and keep the prior unresolved findings.
+
+## Output
+
+Post the result to the PR. For unresolved issues, write findings with concrete evidence.
+
+If all findings are closed and no new issues are found, emit the host's approval signal. Step 1 is the durable verdict; Step 2 is courtesy reinforcement for human readers:
+
+1. Submit an approving review (`gh pr review N --approve`). On hosts that block self-approval, this step will fail; fall back to the host's documented self-PR mechanism (e.g., a structured `<!-- baxian:<agent>:approve -->` marker on its own line, outside fenced blocks).
+2. Submit a `:+1:` review comment (`gh pr review N --comment --body ':+1:'`).
+
+Each host defines its own recognized signals — check the host's agent rules. `:+1:` is not a universal verdict shorthand; only treat it as decisive if the host explicitly documents it.
+
+After the result is visible on the PR, notify the dev using the project rule. If the project uses a qa-to-dev callback, use `review-notify` or the configured transport.

package/dist/skills/pr-review/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: pr-review
+description: Use when the qa agent must perform a full independent pull request review, including project aliases like "review N", PR diffs, tests, prior comments, human authorization context, findings, approval, and dev notification.
+---
+
+# PR Review
+
+## Overview
+
+Review the pull request as the independent qa. Treat the PR, commits, comments, checks, issues, and repository instructions as the durable source of truth; do not rely on another agent's private transcript or summary.
+
+Project-specific trigger aliases such as `review N` are compatibility shims. The reusable concept is "perform a full PR review".
+
+## Before Reviewing
+
+Read the consuming repository's agent instructions first. Identify:
+
+- Review scope and finding format.
+- Required test-review expectations.
+- Whether approval is allowed.
+- How qa results must be written to the PR.
+- How to notify the dev after the review.
+
+Fetch PR metadata, current head, diff, existing reviews, inline comments, issue comments, checks, and linked issue context.
+
+**Tool selection.** Prefer the local `gh` CLI for all GitHub interactions; it is the lowest-friction, best-authenticated path on most workstations. Fall back to a GitHub MCP server or connector tool only when `gh` is missing, unauthenticated, or the required call has no `gh` equivalent. Do not start with a connector when `gh` would work.
+
+```bash
+gh pr view N --json title,body,headRefName,headRefOid,baseRefName,reviewDecision,url,files
+gh pr diff N
+gh api --paginate repos/OWNER/REPO/pulls/N/reviews
+gh api --paginate repos/OWNER/REPO/pulls/N/comments
+gh api --paginate repos/OWNER/REPO/issues/N/comments
+```
+
+## Review Scope
+
+Prioritize findings that affect behavior or maintainability:
+
+- Bugs, regressions, security issues, lifecycle problems, and concurrency risks.
+- Missing, weak, skipped, or non-assertive tests.
+- Coverage gaps for new branches, errors, edge cases, or invariants.
+- Mismatches between the PR, linked issue, and repository rules.
+
+Human authorization in the PR description, commits, or comments is input, not a bypass. Judge whether it actually covers the risk.
+
+## Findings
+
+Write actionable findings to the PR, preferably as inline review comments on the smallest relevant range. Include concrete evidence and the expected fix. Avoid restating the diff as a summary.
+
+If no findings remain, emit the host's approval signal. Step 1 is the durable verdict; Step 2 is courtesy reinforcement for human readers:
+
+1. Submit an approving review (`gh pr review N --approve`). On hosts that block self-approval (the qa and dev share a GitHub identity), this step will fail; in that case fall back to the host's documented self-PR mechanism (e.g., a structured `<!-- baxian:<agent>:approve -->` marker on its own line, outside fenced blocks).
+2. Submit a `:+1:` review comment (`gh pr review N --comment --body ':+1:'`).
+
+Each host defines its own recognized signals — check the host's agent rules. `:+1:` is not a universal verdict shorthand; only treat it as decisive if the host explicitly documents it.
+
+## Notify Author
+
+After the review result is durable on the PR, follow the project notification rule. If the project uses a qa-to-dev callback, use `review-notify` or the configured transport. Do not dispatch before the PR review/comment is visible.

package/dist/skills/spells/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: spells
+description: Routes the shortcut trigger phrases an agent recognizes in chat — `pr N`, `review N`, `recheck N`, `merged`, `merged N`, `issue N` — to the corresponding skill in this repo. Apply when any of these phrases appears in an incoming message.
+---
+
+# Spells
+
+## Overview
+
+A spell is a short trigger phrase a human or peer agent sends in chat. Each spell is a shortcut into one of the other skills in this repo. When any of the phrases below appears in an incoming message, run the linked skill. The skill itself owns the workflow, the rules, the stop conditions, the reply format — this file is only the routing table.
+
+Spells are recognized in natural-language input; they are not slash commands and are not parsed by the host CLI. Each spell takes at most one argument, always a single token (a PR number, an issue number) separated from the spell by one space.
+
+## Spell → Skill Routing
+
+| Spell        | Skill                                     | Use when                                                              |
+| ------------ | ----------------------------------------- | --------------------------------------------------------------------- |
+| `pr N`       | [`pr-feedback`](../pr-feedback/SKILL.md)  | Process all reviewer feedback on pull request `N`.                    |
+| `review N`   | [`pr-review`](../pr-review/SKILL.md)      | First-time full review of pull request `N`.                           |
+| `recheck N`  | [`pr-recheck`](../pr-recheck/SKILL.md)    | Re-evaluate pull request `N` after the dev responded to findings.     |
+| `merged`     | [`merge-sync`](../merge-sync/SKILL.md)    | The PR you just pushed has been merged (see form note below).         |
+| `merged N`   | [`merge-sync`](../merge-sync/SKILL.md)    | Peer agent telling you PR `N` has been merged (see form note below).  |
+| `issue N`    | [`issue-check`](../issue-check/SKILL.md)  | Verify and handle GitHub issue `N`.                                   |
+
+## `merged` vs `merged N`
+
+This is the only spell where the form (bare vs parameterized) is part of the contract — it tells the receiver who sent it and which path inside `merge-sync` to run.
+
+- **Bare `merged`** — human-triggered, sent to the agent that just pushed the now-merged PR. Run [`merge-sync` § Human-Originated Sync](../merge-sync/SKILL.md#human-originated-sync), which includes deleting the merged feature branch locally and dispatching `merged N` to the peer.
+- **`merged N`** — peer-agent dispatched, with the PR number explicit because the peer is in a different context. Run [`merge-sync` § Peer-Originated Sync](../merge-sync/SKILL.md#peer-originated-sync), which syncs trunk and rereads changed rule sources but does not delete the current branch and does not re-dispatch.
+- If a human types `merged N` by mistake, treat it as the peer path (so it does no damage) and remind the human in the reply that the bare form is what triggers full local cleanup plus peer notification.
+
+The other spells in the table do not have this dual form.
+
+## Dispatch Channels
+
+How a spell arrives depends on who sent it; the receiver's behavior is owned by the linked skill, not by the channel.
+
+- **Human → agent**: typed into the agent's chat. No transport tooling needed.
+- **Agent → peer agent**: use the [`tmux-send`](../tmux-send/SKILL.md) skill rather than calling `ssh` and `tmux send-keys` directly. Routing details (which host, which session, which spells are valid in which direction) live in the consuming project's configuration, not in this skill.
+- **Bot or webhook → agent**: same as agent-to-agent — the trigger needs to land in the agent's input stream the same way a human message would; transport is project-specific.

package/dist/skills/task-check/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: task-check
+description: How to analyze a baxian-managed task before starting development
+---
+
+# Task Check
+
+Before writing any code, thoroughly read the `<task>` block in your prompt.
+
+## Steps
+1. Read the full title and description from the `<task>` block at the bottom of this prompt — that is the authoritative task (Phase 2 inlines the task body directly; there is no `.baxian/task.md` file to read).
+2. Understand the acceptance criteria — what does "done" look like?
+3. Plan your approach before coding: which files to modify, what tests to write.
+
+## What to look for
+- Explicit requirements vs. implied requirements
+- Edge cases mentioned in description
+- References to specific files, functions, or behaviors
+- Links to design docs, screenshots, or specs
+
+## When to ask vs. proceed
+- If the task is clear enough to start, start.
+- If critical information is missing **and a PR already exists**, record concerns in the PR description.
+- If critical information is missing **and no PR exists yet** (initial triage), pick the most reasonable interpretation, write your assumption + concern as the first paragraph **after** the `<!-- baxian:managed -->` marker (the marker MUST stay on the very first line of the PR description per `baxian-rules` — putting text before it makes the PR look unmanaged to the platform), or create a new baxian task to track the missing info if it blocks all progress.
+- Do not block on minor ambiguities — make a reasonable choice and note it in the PR description.
+- Never silently proceed without recording the assumption somewhere reachable (PR description, new task, or commit message).

package/dist/state/agent-store.d.ts

@@ -0,0 +1,21 @@
+import type { AgentBindingFacts } from '../shared/index.js';
+export type AgentStoreChangeKind = 'set' | 'delete';
+export type AgentStoreListener = (kind: AgentStoreChangeKind, agentId: string) => void;
+export declare const AGENT_STORE_NOOP: unique symbol;
+export type AgentStoreUpdateResult = AgentBindingFacts | null | typeof AGENT_STORE_NOOP;
+export declare class AgentStore {
+    private dir;
+    private listeners;
+    private mutex;
+    constructor(dir: string);
+    onChange(fn: AgentStoreListener): () => void;
+    get(id: string): Promise<AgentBindingFacts | null>;
+    set(state: AgentBindingFacts): Promise<void>;
+    /** Per-agent serialized RMW. Updater returns: binding=write, null=delete, AGENT_STORE_NOOP=skip. Non-reentrant. */
+    update(id: string, updater: (existing: AgentBindingFacts | null) => AgentStoreUpdateResult): Promise<void>;
+    list(): Promise<AgentBindingFacts[]>;
+    delete(id: string): Promise<void>;
+    private path;
+    private fire;
+}
+//# sourceMappingURL=agent-store.d.ts.map

package/dist/state/agent-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-store.d.ts","sourceRoot":"","sources":["../../src/state/agent-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvF,eAAO,MAAM,gBAAgB,eAAyC,CAAC;AACvE,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,IAAI,GAAG,OAAO,gBAAgB,CAAC;AAExF,qBAAa,UAAU;IAIT,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,KAAK,CAAuC;gBAEhC,GAAG,EAAE,MAAM;IAE/B,QAAQ,CAAC,EAAE,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAKtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IASlD,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,mHAAmH;IAC7G,MAAM,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,KAAK,sBAAsB,GACtE,OAAO,CAAC,IAAI,CAAC;IAoBV,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAoBpC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,IAAI;CASb"}

package/dist/state/agent-store.js

@@ -0,0 +1,145 @@
+import { readFile, writeFile, readdir, unlink, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+export const AGENT_STORE_NOOP = Symbol.for('@baxian/agent-store-noop');
+export class AgentStore {
+    dir;
+    listeners = new Set();
+    mutex = new Map();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    onChange(fn) {
+        this.listeners.add(fn);
+        return () => this.listeners.delete(fn);
+    }
+    async get(id) {
+        try {
+            const content = await readFile(this.path(id), 'utf-8');
+            return normalizeBinding(JSON.parse(content), id);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(state) {
+        const binding = normalizeBinding(state, state.id);
+        const final = this.path(state.id);
+        const tmp = `${final}.${process.pid}.${Date.now()}.tmp`;
+        await writeFile(tmp, JSON.stringify(binding, null, 2) + '\n');
+        await rename(tmp, final);
+        this.fire('set', state.id);
+    }
+    /** Per-agent serialized RMW. Updater returns: binding=write, null=delete, AGENT_STORE_NOOP=skip. Non-reentrant. */
+    async update(id, updater) {
+        const prev = this.mutex.get(id) ?? Promise.resolve();
+        const task = prev.then(async () => {
+            const existing = await this.get(id);
+            const result = updater(existing);
+            if (result === AGENT_STORE_NOOP)
+                return;
+            if (result === null) {
+                await this.delete(id);
+                return;
+            }
+            await this.set(result);
+        });
+        // map 存 swallow-catch 版本以维持 mutex 链；删除前校验 still-current 防止误删后来者。
+        const chain = task.catch(() => undefined).finally(() => {
+            if (this.mutex.get(id) === chain)
+                this.mutex.delete(id);
+        });
+        this.mutex.set(id, chain);
+        return task;
+    }
+    async list() {
+        let files;
+        try {
+            files = await readdir(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const states = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const content = await readFile(join(this.dir, file), 'utf-8');
+                states.push(normalizeBinding(JSON.parse(content), file.replace(/\.json$/, '')));
+            }
+            catch (err) {
+                console.warn(`[AgentStore] skipping unreadable file ${file}:`, err);
+            }
+        }
+        return states;
+    }
+    async delete(id) {
+        try {
+            await unlink(this.path(id));
+        }
+        catch (err) {
+            // ENOENT is idempotent; other errors mean file still on disk → don't broadcast.
+            const code = err?.code;
+            if (code !== 'ENOENT') {
+                console.error(`[AgentStore] delete ${id} failed; not broadcasting:`, err);
+                return;
+            }
+        }
+        this.fire('delete', id);
+    }
+    path(id) {
+        return join(this.dir, `${id}.json`);
+    }
+    fire(kind, id) {
+        for (const fn of [...this.listeners]) {
+            try {
+                fn(kind, id);
+            }
+            catch (err) {
+                console.error(`[AgentStore] listener threw on ${kind} ${id}:`, err);
+            }
+        }
+    }
+}
+function normalizeBinding(raw, fallbackId) {
+    const id = typeof raw.id === 'string' ? raw.id : fallbackId;
+    const projectId = typeof raw.projectId === 'string' ? raw.projectId : '';
+    const updatedAt = typeof raw.updatedAt === 'string' ? raw.updatedAt : new Date(0).toISOString();
+    const binding = { id, projectId, updatedAt };
+    if (typeof raw.taskId === 'string')
+        binding.taskId = raw.taskId;
+    if (typeof raw.worktreePath === 'string')
+        binding.worktreePath = raw.worktreePath;
+    if (typeof raw.repoPath === 'string')
+        binding.repoPath = raw.repoPath;
+    if (typeof raw.startedAt === 'string')
+        binding.startedAt = raw.startedAt;
+    if (typeof raw.paneId === 'string')
+        binding.paneId = raw.paneId;
+    if (typeof raw.creationToken === 'string')
+        binding.creationToken = raw.creationToken;
+    if (raw.status === 'awaiting_human')
+        binding.status = 'awaiting_human';
+    if (typeof raw.awaitingPhase === 'string')
+        binding.awaitingPhase = raw.awaitingPhase;
+    if (typeof raw.awaitingReason === 'string')
+        binding.awaitingReason = raw.awaitingReason;
+    if (typeof raw.awaitingSince === 'string')
+        binding.awaitingSince = raw.awaitingSince;
+    const injected = normalizeInjectedSkills(raw.injectedSkills);
+    if (injected)
+        binding.injectedSkills = injected;
+    return binding;
+}
+function normalizeInjectedSkills(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const obj = raw;
+    if (typeof obj.taskId !== 'string' || typeof obj.paneId !== 'string')
+        return undefined;
+    if (!Array.isArray(obj.skills))
+        return undefined;
+    const skills = obj.skills.filter((s) => typeof s === 'string');
+    return { taskId: obj.taskId, paneId: obj.paneId, skills };
+}
+//# sourceMappingURL=agent-store.js.map

package/dist/state/agent-store.js.map

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

package/dist/state/error-record-store.d.ts

@@ -0,0 +1,40 @@
+import type { AgentErrorSummary } from '../shared/index.js';
+export interface ErrorRecordInput {
+    agentId: string;
+    projectId: string;
+    taskId?: string;
+    operation: string;
+    reason: string;
+    message: string;
+    occurredAt?: string;
+    observation?: Record<string, unknown>;
+    recommendation?: string;
+}
+export interface ErrorRecord extends Required<Omit<ErrorRecordInput, 'taskId' | 'observation' | 'recommendation'>> {
+    id: string;
+    taskId?: string;
+    observation?: Record<string, unknown>;
+    recommendation?: string;
+}
+export declare class ErrorRecordStore {
+    private dir;
+    private chain;
+    constructor(dir: string);
+    append(input: ErrorRecordInput): Promise<ErrorRecord>;
+    latestForAgent(agentId: string): Promise<ErrorRecord | undefined>;
+    latestBootstrapForAgent(agentId: string): Promise<ErrorRecord | undefined>;
+    latestBootstrapByAgent(): Promise<Map<string, ErrorRecord>>;
+    purgeAgent(agentId: string): Promise<{
+        removed: number;
+    }>;
+    purgeBootstrapForAgent(agentId: string): Promise<{
+        removed: number;
+    }>;
+    sweepStaleBootstrapErrors(activeAgentIds: Set<string>): Promise<{
+        removed: number;
+    }>;
+    private rewriteFiltered;
+    toSummary(record: ErrorRecord): AgentErrorSummary;
+    private readAll;
+}
+//# sourceMappingURL=error-record-store.d.ts.map

package/dist/state/error-record-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-record-store.d.ts","sourceRoot":"","sources":["../../src/state/error-record-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC,CAAC;IAChH,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAGf,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAuC;gBAEhC,GAAG,EAAE,MAAM;IAEzB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBrD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAOjE,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAS1E,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAgB3D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAWzD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBrE,yBAAyB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAa1F,OAAO,CAAC,eAAe;IA8DvB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;YAUnC,OAAO;CAwBtB"}