ftown 0.25.3 → 0.26.0

package/dist/coordination/contract.d.ts

@@ -0,0 +1,236 @@
+/**
+ * FROZEN CONTRACT — coordination phase A (session cards, board, tree events,
+ * nudge-once mail, digest). Types, constants and interfaces only; no logic.
+ * Implementers must not modify this file. Changes go through the orchestrator.
+ */
+import type { Activity } from '../attention-events.js';
+import type { PullRequestState } from '../pull-request-status-protocol.js';
+import type { MailMessage, Session, SessionStatus } from '../types.js';
+export declare const CARD_STATES: readonly ["working", "blocked", "waiting_review", "done", "failed"];
+export type CardState = typeof CARD_STATES[number];
+export declare const BLOCKED_ON_KINDS: readonly ["human", "parent", "session", "external"];
+export type BlockedOnKind = typeof BLOCKED_ON_KINDS[number];
+export declare const CARD_LIMITS: {
+    readonly headline: 140;
+    readonly next: 280;
+    readonly blockedText: 280;
+    /** progress.total upper bound; done must be 0..total. */
+    readonly progressTotal: 10000;
+};
+export interface CardProgress {
+    done: number;
+    total: number;
+}
+export interface CardBlockedOn {
+    kind: BlockedOnKind; /** session id when kind==='session' */
+    ref?: string;
+    text: string;
+}
+/** Stored on Session.card (session.json) so it flows to the dashboard via toWireSession. */
+export interface SessionCardDeclared {
+    state: CardState;
+    headline: string;
+    progress?: CardProgress;
+    blockedOn?: CardBlockedOn;
+    next?: string;
+    updatedAt: string;
+}
+/**
+ * Partial update. Omitted field = unchanged; null = remove.
+ * The first write to a session with no card must include state and headline.
+ * Setting state to anything other than 'blocked' clears blockedOn unless blockedOn is also given.
+ */
+export interface CardPatch {
+    state?: CardState;
+    headline?: string;
+    progress?: CardProgress | null;
+    blockedOn?: CardBlockedOn | null;
+    next?: string | null;
+}
+export declare class CardValidationError extends Error {
+    constructor(message: string);
+}
+export interface CardPr {
+    url: string;
+    state: PullRequestState;
+    stale: boolean;
+    checkedAt: string | null;
+}
+export interface CardDerived {
+    status: SessionStatus;
+    activity: Activity['state'];
+    /** activity.lastActivityAt when activity === 'idle'. */
+    idleSince?: string;
+    openAttention: number;
+    /** inbox messages without deliveredAt */
+    unreadMail: number;
+    pr?: CardPr;
+    previews: string[];
+    shellType?: string;
+    model?: string;
+}
+export interface SessionCard {
+    sessionId: string;
+    name: string;
+    parentSessionId?: string;
+    declared: SessionCardDeclared | null;
+    derived: CardDerived;
+    /** declared exists and activity.lastActivityAt is more than CARD_STALE_MS after declared.updatedAt */
+    stale: boolean;
+}
+export declare const CARD_STALE_MS: number;
+export interface CardStoreDeps {
+    loadSession(id: string): Promise<Session | null>;
+    saveSession(session: Session): Promise<void>;
+    /** called after a successful set/clear with the saved session (publish to dashboard + emit tree event) */
+    onChange?(session: Session, previous: SessionCardDeclared | null): void | Promise<void>;
+    now(): number;
+}
+/** Implementation: bridge/src/coordination/card-store.ts → `export class CardStore implements CardStoreApi { constructor(deps: CardStoreDeps) }` */
+export interface CardStoreApi {
+    get(sessionId: string): Promise<SessionCardDeclared | null>;
+    /** validates (CardValidationError), merges, stamps updatedAt, saves. Throws Error('Session not found') if missing. */
+    set(sessionId: string, patch: CardPatch): Promise<SessionCardDeclared>;
+    clear(sessionId: string): Promise<void>;
+}
+/** Root of a tree = session.parentSessionId ?? session.id (tree is one level deep). */
+export declare const TREE_EVENTS_FILE = "tree-events.jsonl";
+export declare const TREE_EVENTS_RETAIN = 5000;
+export declare const TREE_EVENTS_COMPACT_AT = 6000;
+export declare const TREE_EVENTS_MAX_WAIT_MS = 300000;
+export declare const TREE_EVENT_SUMMARY_MAX = 300;
+export declare const TREE_EVENT_KINDS: readonly ["status", "attention", "pr", "preview", "exit", "idle", "result", "mail"];
+export type TreeEventKind = typeof TREE_EVENT_KINDS[number];
+export interface TreeEvent {
+    seq: number;
+    ts: string;
+    sessionId: string;
+    sessionName: string;
+    kind: TreeEventKind;
+    summary: string;
+    ref?: string;
+}
+export type TreeEventInput = Omit<TreeEvent, 'seq' | 'ts'>;
+export interface TreeEventPage {
+    events: TreeEvent[]; /** highest seq returned, or `since` if none */
+    cursor: number;
+    timedOut?: boolean;
+}
+export interface TreeEventLogDeps {
+    sessionDir(id: string): string;
+    now(): number;
+}
+/** Implementation: bridge/src/coordination/tree-events.ts → `export class TreeEventLog implements TreeEventLogApi { constructor(deps: TreeEventLogDeps) }` */
+export interface TreeEventLogApi {
+    append(rootId: string, event: TreeEventInput): Promise<TreeEvent>;
+    /** events with seq > since (default 0), oldest first, at most limit (default 100, max 500) */
+    read(rootId: string, opts?: {
+        since?: number;
+        limit?: number;
+    }): Promise<TreeEventPage>;
+    /** resolves immediately if events exist after since; otherwise on next append or timeout (clamped to TREE_EVENTS_MAX_WAIT_MS) with timedOut: true */
+    wait(rootId: string, since: number, timeoutMs: number, signal?: AbortSignal): Promise<TreeEventPage>;
+    /** highest seq for root (0 if none) */
+    head(rootId: string): Promise<number>;
+}
+export type BoardRollupKey = CardState | 'unset';
+export interface Board {
+    rootId: string;
+    /** tree event head at render time; pass back as `since` */
+    cursor: number;
+    /** children of rootId (not the root itself), ordered by createdAt ascending; filtered when ready/since */
+    cards: SessionCard[];
+    rollup: Record<BoardRollupKey, number>;
+}
+export interface BoardQuery {
+    /** any session id; root is resolved */
+    sessionId: string;
+    /** only children with tree events of seq > since */
+    since?: number;
+    /** only children whose derived.pr.state === 'passed' and declared.state !== 'done' (approval/mergeable not tracked in phase A) */
+    ready?: boolean;
+    /** include archived/completed children; default false = status running|pending only plus any with events after since */
+    all?: boolean;
+}
+export interface BoardDeps {
+    loadSession(id: string): Promise<Session | null>;
+    listSessions(): Promise<Session[]>;
+    attention(id: string): Promise<{
+        activity: Activity;
+        openCount: number;
+    }>;
+    prStatus(url: string): Promise<{
+        state: PullRequestState;
+        stale: boolean;
+        checkedAt: string | null;
+    } | null>;
+    unreadMail(id: string): Promise<number>;
+    events: TreeEventLogApi;
+    now(): number;
+}
+/** Implementation: bridge/src/coordination/board.ts → `export class BoardService implements BoardServiceApi { constructor(deps: BoardDeps) }` */
+export interface BoardServiceApi {
+    card(sessionId: string): Promise<SessionCard | null>;
+    board(query: BoardQuery): Promise<Board>;
+    /** deterministic one-line digest of tree events after sinceSeq for the root of sessionId; null if nothing new */
+    digest(sessionId: string, sinceSeq: number): Promise<{
+        line: string | null;
+        cursor: number;
+    }>;
+}
+/**
+ * Digest line format (exact):
+ *   `[ftown] since HH:MM: <part> | <part> | ...`
+ * Parts, in order, one per child with events (latest event per child wins, max 6 children then `+N more`):
+ *   `<name> <state>` + (headline ? ` "<headline ≤60>"` : '') + (pr ? ` (PR <state>)` : '')
+ * then, if any: `<n> question(s) waiting`. Total line ≤ 500 chars. HH:MM is local time of the first event.
+ */
+export declare const DIGEST_MAX = 500;
+/** Plain `ftown board` row (exact column order, single spaces):
+ *   `<name> <state|-> <activity>[ idle <Nm>]  <headline>[  PR:<state>][  !<openAttention>][  ✉<unreadMail>][  (stale)]`
+ */
+/** Replaces MAIL_TYPES in mail-delivery.ts and wire-types.ts. */
+export declare const MAIL_TYPES_V2: readonly ["message", "task", "result", "escalation", "fyi"];
+export type MailTypeV2 = typeof MAIL_TYPES_V2[number];
+/** fyi never schedules a nudge or wake; collected only at the next natural drain/read. */
+export declare const NON_WAKING_MAIL_TYPES: ReadonlySet<MailTypeV2>;
+/** Max native-wake attempts (codex/muse) for one batch before the batch is stamped and left. */
+export declare const MAX_WAKE_ATTEMPTS = 3;
+/**
+ * Nudge-once rules (MailMessage.nudgedAt):
+ * 1. A nudge/wake fires only if ≥1 undelivered, waking message has no nudgedAt.
+ * 2. On firing (any path: PTY, codex, muse, plugin), stamp nudgedAt on every undelivered waking message → that is the batch.
+ * 3. A stamped message never causes another nudge on any path (new mail, recovery, retry).
+ * 4. Recovery (recoverPendingMail) skips stamped mail.
+ * 5. Nudge text: NUDGE_TEXT(counts, digest).
+ */
+export type MailCounts = Partial<Record<MailTypeV2, number>>;
+export interface DigestProvider {
+    /** one-line digest for the recipient (as tree root), or null. Must not throw; return null on error. */
+    digestFor(recipientSessionId: string): Promise<string | null>;
+}
+/** Event sink so mail-delivery can record child→parent `result` mail on the tree log without importing it. */
+export interface MailEventSink {
+    onAccepted(message: MailMessage, recipient: Session): void | Promise<void>;
+}
+export declare const COORDINATION_ROUTES: {
+    /** GET → SessionCard; PUT body CardPatch → SessionCard (400 on CardValidationError); DELETE → { ok: true } */
+    readonly card: "/api/sessions/:id/card";
+    /** GET ?since=<n>&ready=1&all=1 → Board */
+    readonly board: "/api/sessions/:id/board";
+    /** GET ?since=<n>&limit=<n>&waitSeconds=<0..300> → TreeEventPage (root of :id) */
+    readonly events: "/api/sessions/:id/events";
+};
+/**
+ * ftown status [--json] [--session-id <id>]                       → print own card (SessionCard)
+ * ftown status set [--state <s>] [--headline <t>] [--progress <d>/<t>|--no-progress]
+ *                  [--on human|parent|external|session:<id>] [--text <t>] [--next <t>|--no-next] [--session-id <id>]
+ * ftown status clear [--session-id <id>]
+ * ftown board [--json] [--since <n>] [--ready] [--all] [--session-id <id>]
+ *             [--wait --until any-change|any-done|any-blocked|all-done|any-ready [--timeout <s≤300>]]
+ * ftown events [--json] [--since <n>] [--limit <n>] [--wait [--timeout <s≤300>]] [--session-id <id>]
+ * Exit codes: 0 ok, 1 error, 2 usage, 3 wait timed out with condition unmet.
+ * Default session id: FTOWN_SESSION_ID.
+ */
+export declare const BOARD_WAIT_CONDITIONS: readonly ["any-change", "any-done", "any-blocked", "all-done", "any-ready"];
+export type BoardWaitCondition = typeof BOARD_WAIT_CONDITIONS[number];

package/dist/coordination/contract.js

@@ -0,0 +1,63 @@
+// ───────────────────────── Session card (declared by the agent) ─────────────────────────
+export const CARD_STATES = ['working', 'blocked', 'waiting_review', 'done', 'failed'];
+export const BLOCKED_ON_KINDS = ['human', 'parent', 'session', 'external'];
+export const CARD_LIMITS = {
+    headline: 140,
+    next: 280,
+    blockedText: 280,
+    /** progress.total upper bound; done must be 0..total. */
+    progressTotal: 10_000,
+};
+export class CardValidationError extends Error {
+    constructor(message) { super(message); this.name = 'CardValidationError'; }
+}
+export const CARD_STALE_MS = 10 * 60_000;
+// ───────────────────────── Tree event log ─────────────────────────
+/** Root of a tree = session.parentSessionId ?? session.id (tree is one level deep). */
+export const TREE_EVENTS_FILE = 'tree-events.jsonl'; // in sessionDir(rootId)
+export const TREE_EVENTS_RETAIN = 5_000; // keep newest N on compaction
+export const TREE_EVENTS_COMPACT_AT = 6_000;
+export const TREE_EVENTS_MAX_WAIT_MS = 300_000;
+export const TREE_EVENT_SUMMARY_MAX = 300;
+export const TREE_EVENT_KINDS = ['status', 'attention', 'pr', 'preview', 'exit', 'idle', 'result', 'mail'];
+/**
+ * Digest line format (exact):
+ *   `[ftown] since HH:MM: <part> | <part> | ...`
+ * Parts, in order, one per child with events (latest event per child wins, max 6 children then `+N more`):
+ *   `<name> <state>` + (headline ? ` "<headline ≤60>"` : '') + (pr ? ` (PR <state>)` : '')
+ * then, if any: `<n> question(s) waiting`. Total line ≤ 500 chars. HH:MM is local time of the first event.
+ */
+export const DIGEST_MAX = 500;
+/** Plain `ftown board` row (exact column order, single spaces):
+ *   `<name> <state|-> <activity>[ idle <Nm>]  <headline>[  PR:<state>][  !<openAttention>][  ✉<unreadMail>][  (stale)]`
+ */
+// ───────────────────────── Mail: nudge once + fyi ─────────────────────────
+/** Replaces MAIL_TYPES in mail-delivery.ts and wire-types.ts. */
+export const MAIL_TYPES_V2 = ['message', 'task', 'result', 'escalation', 'fyi'];
+/** fyi never schedules a nudge or wake; collected only at the next natural drain/read. */
+export const NON_WAKING_MAIL_TYPES = new Set(['fyi']);
+/** Max native-wake attempts (codex/muse) for one batch before the batch is stamped and left. */
+export const MAX_WAKE_ATTEMPTS = 3;
+// ───────────────────────── Local API (all via dispatchSecure, :id = target session) ─────────────────────────
+export const COORDINATION_ROUTES = {
+    /** GET → SessionCard; PUT body CardPatch → SessionCard (400 on CardValidationError); DELETE → { ok: true } */
+    card: '/api/sessions/:id/card',
+    /** GET ?since=<n>&ready=1&all=1 → Board */
+    board: '/api/sessions/:id/board',
+    /** GET ?since=<n>&limit=<n>&waitSeconds=<0..300> → TreeEventPage (root of :id) */
+    events: '/api/sessions/:id/events',
+};
+// ───────────────────────── CLI (new top-level groups in ftown-cli.ts) ─────────────────────────
+/**
+ * ftown status [--json] [--session-id <id>]                       → print own card (SessionCard)
+ * ftown status set [--state <s>] [--headline <t>] [--progress <d>/<t>|--no-progress]
+ *                  [--on human|parent|external|session:<id>] [--text <t>] [--next <t>|--no-next] [--session-id <id>]
+ * ftown status clear [--session-id <id>]
+ * ftown board [--json] [--since <n>] [--ready] [--all] [--session-id <id>]
+ *             [--wait --until any-change|any-done|any-blocked|all-done|any-ready [--timeout <s≤300>]]
+ * ftown events [--json] [--since <n>] [--limit <n>] [--wait [--timeout <s≤300>]] [--session-id <id>]
+ * Exit codes: 0 ok, 1 error, 2 usage, 3 wait timed out with condition unmet.
+ * Default session id: FTOWN_SESSION_ID.
+ */
+export const BOARD_WAIT_CONDITIONS = ['any-change', 'any-done', 'any-blocked', 'all-done', 'any-ready'];
+//# sourceMappingURL=contract.js.map

package/dist/coordination/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/coordination/contract.ts"],"names":[],"mappings":"AASA,2FAA2F;AAE3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAG/F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,GAAG;IAChB,yDAAyD;IACzD,aAAa,EAAE,MAAM;CACb,CAAC;AA4BX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACpF;AA8BD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,MAAM,CAAC;AAoBzC,qEAAqE;AAErE,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,CAAC,wBAAwB;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAG,8BAA8B;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAwEpH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAE9B;;GAEG;AAEH,6EAA6E;AAE7E,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAU,CAAC;AAEzF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAA4B,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,gGAAgG;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAsBnC,+GAA+G;AAE/G,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,8GAA8G;IAC9G,IAAI,EAAE,wBAAwB;IAC9B,2CAA2C;IAC3C,KAAK,EAAE,yBAAyB;IAChC,kFAAkF;IAClF,MAAM,EAAE,0BAA0B;CAC1B,CAAC;AAEX,iGAAiG;AACjG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC"}

package/dist/coordination/format.d.ts

@@ -0,0 +1,5 @@
+import { type Board, type SessionCard, type TreeEvent } from './contract.js';
+export declare function formatLocalHHMM(iso: string): string;
+export declare function formatBoardRow(card: SessionCard, nowMs: number): string;
+export declare function formatBoard(board: Board, nowMs: number): string;
+export declare function formatEvent(e: TreeEvent): string;

package/dist/coordination/format.js

@@ -0,0 +1,60 @@
+import { CARD_STATES, } from './contract.js';
+const ROLLUP_ORDER = [...CARD_STATES, 'unset'];
+function pad2(n) {
+    return String(n).padStart(2, '0');
+}
+export function formatLocalHHMM(iso) {
+    const d = new Date(iso);
+    return `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+}
+export function formatBoardRow(card, nowMs) {
+    const state = card.declared?.state ?? '-';
+    const activity = card.derived.activity;
+    let idlePart = '';
+    if (activity === 'idle') {
+        const idleSinceMs = card.derived.idleSince !== undefined
+            ? Date.parse(card.derived.idleSince)
+            : NaN;
+        const idleMin = Number.isNaN(idleSinceMs)
+            ? 0
+            : Math.max(0, Math.floor((nowMs - idleSinceMs) / 60_000));
+        idlePart = ` idle ${idleMin}m`;
+    }
+    const headline = card.declared?.headline || '-';
+    let suffix = '';
+    if (card.derived.pr) {
+        suffix += `  PR:${card.derived.pr.state}`;
+    }
+    if (card.derived.openAttention > 0) {
+        suffix += `  !${card.derived.openAttention}`;
+    }
+    if (card.derived.unreadMail > 0) {
+        suffix += `  ✉${card.derived.unreadMail}`;
+    }
+    if (card.stale) {
+        suffix += '  (stale)';
+    }
+    return `${card.name} ${state} ${activity}${idlePart}  ${headline}${suffix}`;
+}
+export function formatBoard(board, nowMs) {
+    if (board.cards.length === 0) {
+        return 'no child sessions';
+    }
+    const rows = board.cards.map((card) => formatBoardRow(card, nowMs));
+    const rollupParts = [];
+    for (const key of ROLLUP_ORDER) {
+        const count = board.rollup[key] ?? 0;
+        if (count > 0) {
+            rollupParts.push(`${count} ${key}`);
+        }
+    }
+    if (rollupParts.length > 0) {
+        rows.push(rollupParts.join(', '));
+    }
+    return rows.join('\n');
+}
+export function formatEvent(e) {
+    const hhmm = formatLocalHHMM(e.ts);
+    return `#${e.seq} ${hhmm} ${e.sessionName} ${e.kind}: ${e.summary}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/coordination/format.js.map

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

package/dist/coordination/tree-events.d.ts

@@ -0,0 +1,31 @@
+import { type TreeEvent, type TreeEventInput, type TreeEventLogApi, type TreeEventLogDeps, type TreeEventPage } from './contract.js';
+/** Per-root JSONL log of tree events (one JSON object per line, seq survives compaction). */
+export declare class TreeEventLog implements TreeEventLogApi {
+    private deps;
+    private locks;
+    /** Highest seq seen per root, cached after the first file read. */
+    private heads;
+    /** Valid event lines per root, cached alongside the head to trigger compaction without recounting. */
+    private counts;
+    /** Wake callbacks of long-poll waiters, keyed by root. */
+    private waiters;
+    constructor(deps: TreeEventLogDeps);
+    private file;
+    private requireValidId;
+    private withLock;
+    /** Parses the log, keeping only well-formed events; a truncated/corrupt tail is tolerated. */
+    private events;
+    /** Cold-fills the head cache. Must run while holding the per-root lock, so it can never
+     *  overwrite a newer head written by a concurrent append. */
+    private stateLocked;
+    private cleaned;
+    append(rootId: string, input: TreeEventInput): Promise<TreeEvent>;
+    /** Rewrites the log down to the newest TREE_EVENTS_RETAIN events via tmp file + rename. Seqs are preserved. */
+    private compact;
+    read(rootId: string, opts?: {
+        since?: number;
+        limit?: number;
+    }): Promise<TreeEventPage>;
+    wait(rootId: string, since: number, timeoutMs: number, signal?: AbortSignal): Promise<TreeEventPage>;
+    head(rootId: string): Promise<number>;
+}

package/dist/coordination/tree-events.js

@@ -0,0 +1,226 @@
+import { appendFile, mkdir, open, readFile, rename, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { TREE_EVENTS_COMPACT_AT, TREE_EVENTS_FILE, TREE_EVENTS_MAX_WAIT_MS, TREE_EVENTS_RETAIN, TREE_EVENT_KINDS, TREE_EVENT_SUMMARY_MAX, } from './contract.js';
+const ID_PATTERN = /^[A-Za-z0-9_-]{1,200}$/;
+const SESSION_NAME_MAX = 200;
+const REF_MAX = 500;
+const READ_LIMIT_DEFAULT = 100;
+const READ_LIMIT_MAX = 500;
+function clampInt(value, fallback, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+/** Replaces control characters and whitespace with spaces, then collapses runs of spaces. */
+function cleanLine(text) {
+    return (typeof text === 'string' ? text : '')
+        .replace(/[\u0000-\u001f\u007f\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Hard-truncates to `max` characters total, marking the cut with an ellipsis. */
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+/** Accepts only lines that parse to a well-formed tree event; anything else (truncated tail included) is skipped. */
+function parseEvent(line) {
+    if (!line.trim())
+        return null;
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const record = value;
+    const { seq, ts, sessionId, sessionName, kind, summary, ref } = record;
+    if (typeof seq !== 'number' || !Number.isInteger(seq) || seq < 1)
+        return null;
+    if (typeof ts !== 'string' || typeof sessionId !== 'string' || typeof sessionName !== 'string' || typeof summary !== 'string')
+        return null;
+    if (typeof kind !== 'string' || !TREE_EVENT_KINDS.includes(kind))
+        return null;
+    if (ref !== undefined && typeof ref !== 'string')
+        return null;
+    return { seq, ts, sessionId, sessionName, kind: kind, summary, ...(ref !== undefined ? { ref } : {}) };
+}
+/** Per-root JSONL log of tree events (one JSON object per line, seq survives compaction). */
+export class TreeEventLog {
+    deps;
+    locks = new Map();
+    /** Highest seq seen per root, cached after the first file read. */
+    heads = new Map();
+    /** Valid event lines per root, cached alongside the head to trigger compaction without recounting. */
+    counts = new Map();
+    /** Wake callbacks of long-poll waiters, keyed by root. */
+    waiters = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    file(rootId) {
+        return join(this.deps.sessionDir(rootId), TREE_EVENTS_FILE);
+    }
+    requireValidId(rootId) {
+        if (!ID_PATTERN.test(rootId))
+            throw new Error('Invalid session id');
+    }
+    withLock(rootId, fn) {
+        const previous = this.locks.get(rootId) ?? Promise.resolve();
+        const next = previous.then(fn, fn);
+        const settled = next.catch(() => undefined);
+        this.locks.set(rootId, settled);
+        void settled.then(() => { if (this.locks.get(rootId) === settled)
+            this.locks.delete(rootId); });
+        return next;
+    }
+    /** Parses the log, keeping only well-formed events; a truncated/corrupt tail is tolerated. */
+    async events(rootId) {
+        let content;
+        try {
+            content = await readFile(this.file(rootId), 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const events = [];
+        for (const line of content.split('\n')) {
+            const event = parseEvent(line);
+            if (event)
+                events.push(event);
+        }
+        return events;
+    }
+    /** Cold-fills the head cache. Must run while holding the per-root lock, so it can never
+     *  overwrite a newer head written by a concurrent append. */
+    async stateLocked(rootId) {
+        const cachedHead = this.heads.get(rootId);
+        const cachedCount = this.counts.get(rootId);
+        if (cachedHead !== undefined && cachedCount !== undefined)
+            return { head: cachedHead, count: cachedCount };
+        const events = await this.events(rootId);
+        const head = events.reduce((max, event) => Math.max(max, event.seq), 0);
+        this.heads.set(rootId, head);
+        this.counts.set(rootId, events.length);
+        return { head, count: events.length };
+    }
+    cleaned(input) {
+        if (!ID_PATTERN.test(input.sessionId))
+            throw new Error('Invalid session id');
+        if (typeof input.kind !== 'string' || !TREE_EVENT_KINDS.includes(input.kind)) {
+            throw new Error('Invalid event kind');
+        }
+        const summary = truncate(cleanLine(input.summary), TREE_EVENT_SUMMARY_MAX);
+        const sessionName = cleanLine(input.sessionName).slice(0, SESSION_NAME_MAX);
+        const ref = input.ref === undefined ? undefined : cleanLine(input.ref);
+        return { sessionId: input.sessionId, sessionName, kind: input.kind, summary, ...(ref ? { ref: ref.slice(0, REF_MAX) } : {}) };
+    }
+    async append(rootId, input) {
+        this.requireValidId(rootId);
+        const fields = this.cleaned(input);
+        const event = { seq: 0, ts: new Date(this.deps.now()).toISOString(), ...fields };
+        await this.withLock(rootId, async () => {
+            const { head, count } = await this.stateLocked(rootId);
+            event.seq = head + 1;
+            const dir = this.deps.sessionDir(rootId);
+            await mkdir(dir, { recursive: true, mode: 0o700 });
+            await appendFile(this.file(rootId), `${JSON.stringify(event)}\n`, { mode: 0o600 });
+            this.heads.set(rootId, event.seq);
+            this.counts.set(rootId, count + 1);
+            if (count + 1 > TREE_EVENTS_COMPACT_AT) {
+                // The event is already durable: a failed compaction must not fail the append.
+                // The count stays above the threshold, so the next append retries compaction.
+                await this.compact(rootId).catch((error) => {
+                    console.warn(`[Bridge] Tree event compaction failed for session ${rootId}:`, error);
+                });
+            }
+        });
+        for (const wake of Array.from(this.waiters.get(rootId) ?? []))
+            wake();
+        return event;
+    }
+    /** Rewrites the log down to the newest TREE_EVENTS_RETAIN events via tmp file + rename. Seqs are preserved. */
+    async compact(rootId) {
+        const retained = (await this.events(rootId)).sort((a, b) => a.seq - b.seq).slice(-TREE_EVENTS_RETAIN);
+        const file = this.file(rootId);
+        const tmp = `${file}.${randomUUID()}.tmp`;
+        try {
+            const handle = await open(tmp, 'wx', 0o600);
+            try {
+                await handle.writeFile(retained.map((event) => JSON.stringify(event)).join('\n') + (retained.length ? '\n' : ''), 'utf8');
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await rename(tmp, file);
+        }
+        catch (error) {
+            await rm(tmp, { force: true }).catch(() => undefined);
+            throw error;
+        }
+        this.counts.set(rootId, retained.length);
+    }
+    async read(rootId, opts = {}) {
+        this.requireValidId(rootId);
+        const since = clampInt(opts.since, 0, 0, Number.MAX_SAFE_INTEGER);
+        const limit = clampInt(opts.limit, READ_LIMIT_DEFAULT, 1, READ_LIMIT_MAX);
+        const matching = (await this.events(rootId)).filter((event) => event.seq > since).sort((a, b) => a.seq - b.seq);
+        const events = matching.slice(0, limit);
+        return { events, cursor: events.length ? events[events.length - 1].seq : since };
+    }
+    async wait(rootId, since, timeoutMs, signal) {
+        this.requireValidId(rootId);
+        const start = clampInt(since, 0, 0, Number.MAX_SAFE_INTEGER);
+        const ms = clampInt(timeoutMs, 0, 0, TREE_EVENTS_MAX_WAIT_MS);
+        // The wake callback is registered and armed before the first read, so an append
+        // committing while that read is in flight cannot be lost.
+        let wake;
+        const waiters = this.waiters.get(rootId) ?? new Set();
+        const waiter = () => wake?.();
+        waiters.add(waiter);
+        this.waiters.set(rootId, waiters);
+        let timer;
+        let removeAbort;
+        try {
+            if (signal?.aborted)
+                return { events: [], cursor: start, timedOut: true };
+            const settled = new Promise((resolve) => {
+                wake = () => resolve(false);
+                timer = setTimeout(() => resolve(true), ms);
+                timer.unref?.();
+                if (signal) {
+                    const onAbort = () => resolve(true);
+                    signal.addEventListener('abort', onAbort, { once: true });
+                    removeAbort = () => signal.removeEventListener('abort', onAbort);
+                }
+            });
+            const immediate = await this.read(rootId, { since: start });
+            if (immediate.events.length)
+                return immediate;
+            const timedOut = await settled;
+            if (timedOut)
+                return { events: [], cursor: start, timedOut: true };
+            // Woken by an append: return the page as of now (empty if the append was for an already-seen seq).
+            return await this.read(rootId, { since: start });
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+            removeAbort?.();
+            waiters.delete(waiter);
+            if (!waiters.size)
+                this.waiters.delete(rootId);
+        }
+    }
+    async head(rootId) {
+        this.requireValidId(rootId);
+        return this.withLock(rootId, async () => (await this.stateLocked(rootId)).head);
+    }
+}
+//# sourceMappingURL=tree-events.js.map

package/dist/coordination/tree-events.js.map

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