@agent-arc-status/reference 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joe Fisher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# `@agent-arc-status/reference`: Node reference implementation
+
+Reference TypeScript implementation of the [Agent Arc Status Protocol](../../README.md) v0.2.
+
+Provides:
+
+- Types matching the wire schema (`ArcStatusEvent`, `ArcStatusPhase`)
+- A structural validator (`validate`)
+- A sequence validator for per-arc phase ordering (`validateSequence`)
+- JSON / JSON Lines parsers that never throw (`parse`, `parseJsonl`)
+- A default human-line renderer (`render`)
+- Cadence helpers (`CadenceController` and `SilenceWatchdog`) that drive the
+  silence backstop and cadence-floor gating
+- `reduceArc`, which folds an event stream into current arc state
+
+Zero runtime dependencies.
+
+## Install
+
+```bash
+npm install @agent-arc-status/reference
+```
+
+> Working from a clone instead? This package is a workspace in the
+> [monorepo](https://github.com/joethefisher/agent-arc-status); run `npm install` at the repo
+> root and the `prepare` script builds `dist/`. The surface is small enough to vendor `src/` too.
+
+## Use
+
+### Emit and validate an event
+
+```ts
+import { validate, type ArcStatusEvent } from "@agent-arc-status/reference";
+
+const event: ArcStatusEvent = {
+  arc_id: crypto.randomUUID(),
+  phase: "milestone",
+  title: "receiver booted, smoke test passes",
+  step: 5,
+  total: 11,
+  eta_minutes: 25,
+  sent_at: new Date().toISOString(),
+  protocol_version: "0.1",
+};
+
+const result = validate(event);
+if (!result.ok) {
+  for (const issue of result.issues) {
+    console.error(`${issue.path}: ${issue.message}`);
+  }
+  throw new Error("malformed arc.status event");
+}
+
+await postWebhook("https://...", JSON.stringify(result.event));
+```
+
+### Parse a JSON Lines stream of events
+
+```ts
+import { parseJsonl, validateSequence } from "@agent-arc-status/reference";
+import { readFileSync } from "node:fs";
+
+const { events, errors } = parseJsonl(readFileSync("./arc.jsonl", "utf8"));
+
+if (errors.length > 0) {
+  console.warn(`${errors.length} malformed events skipped`);
+}
+
+const seq = validateSequence(events);
+if (!seq.ok) {
+  console.error("arc phase ordering invalid:", seq.issues);
+}
+```
+
+### Render for human surfaces
+
+```ts
+import { render } from "@agent-arc-status/reference";
+
+// "▶ build Pulsefeed v0.1"
+render({ ... phase: "started", title: "build Pulsefeed v0.1" });
+
+// "✓ [5/11] receiver booted (ETA 25m)"
+render({ ... phase: "milestone", title: "receiver booted", step: 5, total: 11, eta_minutes: 25 });
+
+// "⛔ need finance sign-off on plan-B reclassification\ndetails about what would unblock"
+render(event, { body: true });
+```
+
+## Development
+
+```bash
+npm install
+npm test         # vitest
+npm run build    # tsc → dist/
+npm run typecheck
+```
+
+Tests include end-to-end runs against the shipped [`examples/`](../../examples/) JSONL fixtures, so any deviation from the documented examples is caught immediately.
+
+## Scope
+
+This package implements **structural conformance plus cadence discipline**. It does not implement:
+
+- Transport (HTTP/queue/etc.): the Protocol is transport-agnostic; bring your own.
+- Persistence: emitters and consumers store events as fits their architecture.
+
+The silence backstop and cadence-floor gating ship as `CadenceController` and
+`SilenceWatchdog` (see [`src/cadence.ts`](src/cadence.ts)); drive them from a
+timer independent of your work loop, since an emitter that heartbeats from its
+own work loop cannot signal liveness in the one case that matters: when that
+loop has stalled.
+
+For the canonical schema, see [`spec/schema.json`](../../spec/schema.json). For the full specification, see [`spec/v0.2.md`](../../spec/v0.2.md).

package/dist/cadence.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Cadence discipline as executable code: the part of the Protocol that the
+ * v0.1 reference left as prose.
+ *
+ *   - `CadenceController` drives one arc's emission discipline: it gates
+ *     sub-floor arcs (§5.1), emits a (possibly retroactive) `started` once the
+ *     cadence floor is crossed, and fires a `heartbeat` when the silence window
+ *     (§5.2) would otherwise elapse with no event.
+ *   - `SilenceWatchdog` is a consumer/sidecar that detects stalls across many
+ *     arcs using LOCAL receipt time, never the event's `sent_at` (§7.5).
+ *
+ * Both take an injectable `now()` so behaviour is deterministic under test, and
+ * are meant to be driven by a timer INDEPENDENT of the work loop (§5.2): an
+ * emitter that drives its own heartbeat from the work loop cannot honour the
+ * silence backstop in the one case it exists for: when the work loop is what
+ * stalled. Zero dependencies.
+ */
+import type { ArcStatusEvent } from "./types.js";
+export interface CadenceConfig {
+    /** Minimum arc age before any event is emitted. Default 5 min (§5.1). */
+    cadenceFloorMs?: number;
+    /** Max silence before a heartbeat is required. Default 20 min (§5.2). */
+    silenceWindowMs?: number;
+    /** Injectable clock in ms epoch. Default `Date.now`. */
+    now?: () => number;
+}
+/** The minimum an arc needs to begin emitting; threaded onto generated events. */
+export interface ArcSeed {
+    arc_id: string;
+    title: string;
+    arc_kind?: string;
+    protocol_version?: string;
+}
+/**
+ * Per-arc emission controller. Owns the `started` and `heartbeat` events; the
+ * caller emits `milestone`/`blocked`/`done` itself and reports them via
+ * {@link CadenceController.onEmit} so the silence timer resets.
+ */
+export declare class CadenceController {
+    private readonly floorMs;
+    private readonly windowMs;
+    private readonly now;
+    private seed;
+    private beganAt;
+    private startedEmitted;
+    private terminal;
+    private lastEmitAt;
+    constructor(config?: CadenceConfig);
+    /**
+     * Register the start of an arc. Per §5.1 the floor is a DELAY threshold, not
+     * a prediction: nothing is emitted until the arc has been alive for the
+     * cadence floor, so an arc that was expected to be short but runs long still
+     * becomes visible at the floor. Returns a `started` event immediately only
+     * when the floor is 0.
+     */
+    begin(seed: ArcSeed): ArcStatusEvent | null;
+    /**
+     * Report an event the caller emitted (milestone, blocked, done) so the
+     * silence timer resets. `done` marks the arc terminal.
+     */
+    onEmit(event: ArcStatusEvent): void;
+    /**
+     * Drive the cadence. Call on a timer independent of the work loop. Returns an
+     * event to emit, or null: the (possibly retroactive) `started` once the floor
+     * is crossed, then a `heartbeat` once the silence window elapses with no
+     * emit. `currentActivity` becomes the heartbeat title (§4.3).
+     */
+    tick(currentActivity?: string): ArcStatusEvent | null;
+    /** True once a `done` has been reported. */
+    isTerminal(): boolean;
+    private maybeEmitStarted;
+    private emit;
+}
+/** An arc that has been silent past the window. */
+export interface StalledArc {
+    arc_id: string;
+    /** Local receipt time of the arc's most recent event. */
+    lastReceiptMs: number;
+    /** How long the arc has been silent, in ms. */
+    silentMs: number;
+}
+/**
+ * Multi-arc stall detector for a consumer or sidecar. Tracks the LOCAL receipt
+ * time of each arc's most recent event and reports the arcs that have gone
+ * quiet past the silence window, including those whose own heartbeat is
+ * missing, which is the failure the backstop exists to surface.
+ */
+export declare class SilenceWatchdog {
+    private readonly windowMs;
+    private readonly now;
+    private readonly lastReceipt;
+    constructor(config?: CadenceConfig);
+    /**
+     * Record receipt of an event for an arc. Uses LOCAL receipt time, never the
+     * event's `sent_at` (§7.5: `sent_at` is for ordering/display, so a sender
+     * with a skewed clock or a delayed delivery must not be able to look alive).
+     */
+    record(arcId: string, receiptMs?: number): void;
+    /** Arcs whose last receipt is older than the silence window. */
+    stalled(nowMs?: number): StalledArc[];
+    /** Stop tracking an arc (e.g. after it reaches a terminal event). */
+    forget(arcId: string): void;
+}
+//# sourceMappingURL=cadence.d.ts.map

package/dist/cadence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../src/cadence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAKjE,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAK;gBAEX,MAAM,GAAE,aAAkB;IAMtC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI;IAS3C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAMnC;;;;;OAKG;IACH,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IASrD,4CAA4C;IAC5C,UAAU,IAAI,OAAO;IAIrB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,IAAI;CAcb;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE7C,MAAM,GAAE,aAAkB;IAKtC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmB,GAAG,IAAI;IAI3D,gEAAgE;IAChE,OAAO,CAAC,KAAK,GAAE,MAAmB,GAAG,UAAU,EAAE;IASjD,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG5B"}

package/dist/cadence.js

@@ -0,0 +1,147 @@
+/**
+ * Cadence discipline as executable code: the part of the Protocol that the
+ * v0.1 reference left as prose.
+ *
+ *   - `CadenceController` drives one arc's emission discipline: it gates
+ *     sub-floor arcs (§5.1), emits a (possibly retroactive) `started` once the
+ *     cadence floor is crossed, and fires a `heartbeat` when the silence window
+ *     (§5.2) would otherwise elapse with no event.
+ *   - `SilenceWatchdog` is a consumer/sidecar that detects stalls across many
+ *     arcs using LOCAL receipt time, never the event's `sent_at` (§7.5).
+ *
+ * Both take an injectable `now()` so behaviour is deterministic under test, and
+ * are meant to be driven by a timer INDEPENDENT of the work loop (§5.2): an
+ * emitter that drives its own heartbeat from the work loop cannot honour the
+ * silence backstop in the one case it exists for: when the work loop is what
+ * stalled. Zero dependencies.
+ */
+const DEFAULT_FLOOR_MS = 5 * 60_000;
+const DEFAULT_WINDOW_MS = 20 * 60_000;
+/**
+ * Per-arc emission controller. Owns the `started` and `heartbeat` events; the
+ * caller emits `milestone`/`blocked`/`done` itself and reports them via
+ * {@link CadenceController.onEmit} so the silence timer resets.
+ */
+export class CadenceController {
+    floorMs;
+    windowMs;
+    now;
+    seed = null;
+    beganAt = 0;
+    startedEmitted = false;
+    terminal = false;
+    lastEmitAt = 0;
+    constructor(config = {}) {
+        this.floorMs = config.cadenceFloorMs ?? DEFAULT_FLOOR_MS;
+        this.windowMs = config.silenceWindowMs ?? DEFAULT_WINDOW_MS;
+        this.now = config.now ?? (() => Date.now());
+    }
+    /**
+     * Register the start of an arc. Per §5.1 the floor is a DELAY threshold, not
+     * a prediction: nothing is emitted until the arc has been alive for the
+     * cadence floor, so an arc that was expected to be short but runs long still
+     * becomes visible at the floor. Returns a `started` event immediately only
+     * when the floor is 0.
+     */
+    begin(seed) {
+        this.seed = seed;
+        this.beganAt = this.now();
+        this.startedEmitted = false;
+        this.terminal = false;
+        this.lastEmitAt = 0;
+        return this.maybeEmitStarted();
+    }
+    /**
+     * Report an event the caller emitted (milestone, blocked, done) so the
+     * silence timer resets. `done` marks the arc terminal.
+     */
+    onEmit(event) {
+        this.lastEmitAt = this.now();
+        if (event.phase === "started")
+            this.startedEmitted = true;
+        if (event.phase === "done")
+            this.terminal = true;
+    }
+    /**
+     * Drive the cadence. Call on a timer independent of the work loop. Returns an
+     * event to emit, or null: the (possibly retroactive) `started` once the floor
+     * is crossed, then a `heartbeat` once the silence window elapses with no
+     * emit. `currentActivity` becomes the heartbeat title (§4.3).
+     */
+    tick(currentActivity) {
+        if (this.terminal || !this.seed)
+            return null;
+        if (!this.startedEmitted)
+            return this.maybeEmitStarted();
+        if (this.now() - this.lastEmitAt >= this.windowMs) {
+            return this.emit("heartbeat", currentActivity ?? "still working");
+        }
+        return null;
+    }
+    /** True once a `done` has been reported. */
+    isTerminal() {
+        return this.terminal;
+    }
+    maybeEmitStarted() {
+        if (this.startedEmitted || this.terminal || !this.seed)
+            return null;
+        if (this.now() - this.beganAt < this.floorMs)
+            return null;
+        this.startedEmitted = true;
+        return this.emit("started", this.seed.title);
+    }
+    emit(phase, title) {
+        const t = this.now();
+        this.lastEmitAt = t;
+        const seed = this.seed;
+        const event = {
+            arc_id: seed.arc_id,
+            phase,
+            title,
+            sent_at: new Date(t).toISOString(),
+        };
+        if (seed.arc_kind)
+            event.arc_kind = seed.arc_kind;
+        if (seed.protocol_version)
+            event.protocol_version = seed.protocol_version;
+        return event;
+    }
+}
+/**
+ * Multi-arc stall detector for a consumer or sidecar. Tracks the LOCAL receipt
+ * time of each arc's most recent event and reports the arcs that have gone
+ * quiet past the silence window, including those whose own heartbeat is
+ * missing, which is the failure the backstop exists to surface.
+ */
+export class SilenceWatchdog {
+    windowMs;
+    now;
+    lastReceipt = new Map();
+    constructor(config = {}) {
+        this.windowMs = config.silenceWindowMs ?? DEFAULT_WINDOW_MS;
+        this.now = config.now ?? (() => Date.now());
+    }
+    /**
+     * Record receipt of an event for an arc. Uses LOCAL receipt time, never the
+     * event's `sent_at` (§7.5: `sent_at` is for ordering/display, so a sender
+     * with a skewed clock or a delayed delivery must not be able to look alive).
+     */
+    record(arcId, receiptMs = this.now()) {
+        this.lastReceipt.set(arcId, receiptMs);
+    }
+    /** Arcs whose last receipt is older than the silence window. */
+    stalled(nowMs = this.now()) {
+        const out = [];
+        for (const [arc_id, lastReceiptMs] of this.lastReceipt) {
+            const silentMs = nowMs - lastReceiptMs;
+            if (silentMs >= this.windowMs)
+                out.push({ arc_id, lastReceiptMs, silentMs });
+        }
+        return out;
+    }
+    /** Stop tracking an arc (e.g. after it reaches a terminal event). */
+    forget(arcId) {
+        this.lastReceipt.delete(arcId);
+    }
+}
+//# sourceMappingURL=cadence.js.map

package/dist/cadence.js.map

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

package/dist/forest.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Delegation-tree tooling built on the INTERIM `x_parent_arc_id` convention
+ * (spec §12.1). This does NOT promote `parent_arc_id` to a first-class field:
+ * the parent link is read from the `x_`-prefixed extension, so every event
+ * stays schema-valid and no wire change is implied. The final field shape will
+ * be derived from real delegation usage and only then promoted in a future
+ * minor. Consumers MUST tolerate the convention's absence — with no
+ * `x_parent_arc_id` present this degrades to a flat list of roots.
+ *
+ * `reduceArcForest` groups per-arc event streams into parent/child trees;
+ * `renderArcForest` prints an indented tree. Orphans (a named parent absent from
+ * the input) are surfaced AND rooted so delegated work is never hidden; cycles
+ * are broken deterministically so the result is always a forest.
+ */
+import { type ArcState } from "./state.js";
+import type { ArcStatusEvent } from "./types.js";
+export interface ArcTreeNode {
+    state: ArcState;
+    children: ArcTreeNode[];
+    /** Distance from a root (0 for roots). */
+    depth: number;
+}
+export interface ArcForest {
+    roots: ArcTreeNode[];
+    /** Nodes whose `x_parent_arc_id` names a parent not present in the input.
+     *  These are also included in `roots` so nothing is hidden. */
+    orphans: ArcTreeNode[];
+    /** arc_ids whose parent link was dropped to break a cycle. */
+    cycleBroken: string[];
+}
+/**
+ * Group per-arc event streams into a forest by the `x_parent_arc_id` convention.
+ * Empty streams are skipped. Returns roots, orphans, and any arc_ids whose link
+ * was cut to break a cycle.
+ */
+export declare function reduceArcForest(eventsByArc: Map<string, ArcStatusEvent[]> | Record<string, ArcStatusEvent[]>): ArcForest;
+export interface RenderForestOptions {
+    /** Indent unit per depth level. Default two spaces. */
+    indent?: string;
+    /** Render one node's state to a line. Default: phase symbol + title + status. */
+    line?: (state: ArcState) => string;
+}
+/** Render a forest to an indented, newline-joined tree of arc states. */
+export declare function renderArcForest(forest: ArcForest, options?: RenderForestOptions): string;
+//# sourceMappingURL=forest.d.ts.map

package/dist/forest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forest.d.ts","sourceRoot":"","sources":["../src/forest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;mEAC+D;IAC/D,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAyBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,GAC5E,SAAS,CAyEX;AAED,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAC;CACpC;AAeD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAY5F"}

package/dist/forest.js

@@ -0,0 +1,143 @@
+/**
+ * Delegation-tree tooling built on the INTERIM `x_parent_arc_id` convention
+ * (spec §12.1). This does NOT promote `parent_arc_id` to a first-class field:
+ * the parent link is read from the `x_`-prefixed extension, so every event
+ * stays schema-valid and no wire change is implied. The final field shape will
+ * be derived from real delegation usage and only then promoted in a future
+ * minor. Consumers MUST tolerate the convention's absence — with no
+ * `x_parent_arc_id` present this degrades to a flat list of roots.
+ *
+ * `reduceArcForest` groups per-arc event streams into parent/child trees;
+ * `renderArcForest` prints an indented tree. Orphans (a named parent absent from
+ * the input) are surfaced AND rooted so delegated work is never hidden; cycles
+ * are broken deterministically so the result is always a forest.
+ */
+import { reduceArc } from "./state.js";
+import { render } from "./render.js";
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/** Read the interim parent link: the `started` event's `x_parent_arc_id` if
+ *  present, else the first event that carries one. Non-string values are ignored. */
+function parentIdOf(events) {
+    const started = events.find((e) => e.phase === "started");
+    const fromStarted = started ? asString(started["x_parent_arc_id"]) : undefined;
+    if (fromStarted !== undefined)
+        return fromStarted;
+    for (const e of events) {
+        const v = asString(e["x_parent_arc_id"]);
+        if (v !== undefined)
+            return v;
+    }
+    return undefined;
+}
+function toEntries(input) {
+    return input instanceof Map ? [...input.entries()] : Object.entries(input);
+}
+/**
+ * Group per-arc event streams into a forest by the `x_parent_arc_id` convention.
+ * Empty streams are skipped. Returns roots, orphans, and any arc_ids whose link
+ * was cut to break a cycle.
+ */
+export function reduceArcForest(eventsByArc) {
+    const nodes = new Map();
+    const rawParent = new Map();
+    for (const [arcId, events] of toEntries(eventsByArc)) {
+        const state = reduceArc(events);
+        if (state === null)
+            continue;
+        nodes.set(arcId, { state, children: [], depth: 0 });
+        const pid = parentIdOf(events);
+        if (pid !== undefined)
+            rawParent.set(arcId, pid);
+    }
+    // Effective parent links: only those whose parent is present in the input.
+    const parentOf = new Map();
+    for (const [arcId, pid] of rawParent) {
+        if (nodes.has(pid))
+            parentOf.set(arcId, pid);
+    }
+    // Break cycles: the parent graph is functional (≤1 parent per node), so a
+    // cycle is a simple loop. Walk up from each node; on revisiting a node, cut
+    // that node's parent link (making it a root) and record it.
+    const cycleBroken = [];
+    for (const start of nodes.keys()) {
+        const seen = new Set();
+        let cur = start;
+        while (cur !== undefined) {
+            if (seen.has(cur)) {
+                if (parentOf.has(cur)) {
+                    parentOf.delete(cur);
+                    cycleBroken.push(cur);
+                }
+                break;
+            }
+            seen.add(cur);
+            cur = parentOf.get(cur);
+        }
+    }
+    const roots = [];
+    const orphans = [];
+    for (const [arcId, node] of nodes) {
+        const parent = parentOf.get(arcId);
+        if (parent !== undefined) {
+            const parentNode = nodes.get(parent);
+            if (parentNode)
+                parentNode.children.push(node);
+            continue;
+        }
+        roots.push(node);
+        const pid = rawParent.get(arcId);
+        if (pid !== undefined && !nodes.has(pid))
+            orphans.push(node);
+    }
+    const byStart = (a, b) => a.state.startedAt < b.state.startedAt
+        ? -1
+        : a.state.startedAt > b.state.startedAt
+            ? 1
+            : a.state.arc_id < b.state.arc_id
+                ? -1
+                : a.state.arc_id > b.state.arc_id
+                    ? 1
+                    : 0;
+    const assignDepth = (node, depth) => {
+        node.depth = depth;
+        node.children.sort(byStart);
+        for (const child of node.children)
+            assignDepth(child, depth + 1);
+    };
+    roots.sort(byStart);
+    for (const root of roots)
+        assignDepth(root, 0);
+    return { roots, orphans, cycleBroken };
+}
+function defaultLine(state) {
+    const event = {
+        arc_id: state.arc_id,
+        phase: state.phase,
+        title: state.title,
+        sent_at: state.lastEventAt,
+    };
+    if (state.step !== undefined)
+        event.step = state.step;
+    if (state.total !== undefined)
+        event.total = state.total;
+    if (state.eta_minutes !== undefined)
+        event.eta_minutes = state.eta_minutes;
+    return `${render(event)}  (${state.status})`;
+}
+/** Render a forest to an indented, newline-joined tree of arc states. */
+export function renderArcForest(forest, options = {}) {
+    const indent = options.indent ?? "  ";
+    const line = options.line ?? defaultLine;
+    const out = [];
+    const walk = (node) => {
+        out.push(indent.repeat(node.depth) + line(node.state));
+        for (const child of node.children)
+            walk(child);
+    };
+    for (const root of forest.roots)
+        walk(root);
+    return out.join("\n");
+}
+//# sourceMappingURL=forest.js.map

package/dist/forest.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Agent Arc Status Protocol: reference implementation (v0.2).
+ *
+ * Spec: https://github.com/joethefisher/agent-arc-status
+ *
+ * This package provides:
+ *   - TypeScript types matching the wire schema
+ *   - Structural validator (single event)
+ *   - Sequence validator (phase-ordering rules per arc)
+ *   - JSON / JSON Lines parsers
+ *   - A default human-line renderer
+ *
+ * It is intentionally tiny and has zero runtime dependencies. If you need
+ * canonical-schema validation against `spec/schema.json`, use any standard
+ * JSON Schema validator (ajv, etc.). The schema is the source of truth and
+ * this validator mirrors it.
+ */
+export { ARC_STATUS_PHASES, type ArcStatusEvent, type ArcStatusPhase, type EmitFn, } from "./types.js";
+export { validate, validateSequence, RFC3339_PATTERN, type ValidationResult, type ValidationIssue, type SequenceIssue, type SequenceOptions, } from "./validate.js";
+export { parse, parseJsonl, type JsonlParseResult, } from "./parse.js";
+export { render, type RenderOptions, } from "./render.js";
+export { CadenceController, SilenceWatchdog, type CadenceConfig, type ArcSeed, type StalledArc, } from "./cadence.js";
+export { reduceArc, type ArcState, type ArcMilestone, } from "./state.js";
+export { reduceArcForest, renderArcForest, type ArcForest, type ArcTreeNode, type RenderForestOptions, } from "./forest.js";
+/** The Protocol version this package implements. */
+export declare const PROTOCOL_VERSION = "0.2.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,MAAM,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,EACL,UAAU,EACV,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,MAAM,EACN,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * Agent Arc Status Protocol: reference implementation (v0.2).
+ *
+ * Spec: https://github.com/joethefisher/agent-arc-status
+ *
+ * This package provides:
+ *   - TypeScript types matching the wire schema
+ *   - Structural validator (single event)
+ *   - Sequence validator (phase-ordering rules per arc)
+ *   - JSON / JSON Lines parsers
+ *   - A default human-line renderer
+ *
+ * It is intentionally tiny and has zero runtime dependencies. If you need
+ * canonical-schema validation against `spec/schema.json`, use any standard
+ * JSON Schema validator (ajv, etc.). The schema is the source of truth and
+ * this validator mirrors it.
+ */
+export { ARC_STATUS_PHASES, } from "./types.js";
+export { validate, validateSequence, RFC3339_PATTERN, } from "./validate.js";
+export { parse, parseJsonl, } from "./parse.js";
+export { render, } from "./render.js";
+export { CadenceController, SilenceWatchdog, } from "./cadence.js";
+export { reduceArc, } from "./state.js";
+export { reduceArcForest, renderArcForest, } from "./forest.js";
+/** The Protocol version this package implements. */
+export const PROTOCOL_VERSION = "0.2.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,iBAAiB,GAIlB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAKhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,EACL,UAAU,GAEX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,MAAM,GAEP,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,SAAS,GAGV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,eAAe,GAIhB,MAAM,aAAa,CAAC;AAErB,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}