ftown 0.25.2 → 0.26.0

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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"}

package/dist/coordination/wiring.d.ts

@@ -0,0 +1,48 @@
+import type { Activity } from '../attention-events.js';
+import type { PullRequestState } from '../pull-request-status-protocol.js';
+import type { Session } from '../types.js';
+import type { BoardDeps, BoardServiceApi, CardStoreApi, CardStoreDeps, DigestProvider, MailEventSink, TreeEventKind, TreeEventLogApi, TreeEventLogDeps } from './contract.js';
+export interface CoordinationSessionStore {
+    loadSession(id: string): Promise<Session | null>;
+    saveSession(session: Session): Promise<void>;
+    listSessions(): Promise<Session[]>;
+    sessionDir(id: string): string;
+}
+export interface CoordinationAttentionStore {
+    list(id: string): Promise<{
+        activity: Activity;
+        openCount: number;
+    }>;
+}
+export interface CoordinationPrStatusResult {
+    state: PullRequestState;
+    stale: boolean;
+    checkedAt: string | null;
+}
+export interface CoordinationMailStore {
+    unreadCount(id: string): Promise<number>;
+}
+export interface CoordinationDeps {
+    store: CoordinationSessionStore;
+    attention: CoordinationAttentionStore;
+    prStatus: (url: string) => Promise<CoordinationPrStatusResult | null>;
+    mail: CoordinationMailStore;
+    publishSession: (s: Session) => void;
+    now: () => number;
+    /** Optional factory seams for unit tests using *Api fakes. */
+    createCards?: (deps: CardStoreDeps) => CardStoreApi;
+    createEvents?: (deps: TreeEventLogDeps) => TreeEventLogApi;
+    createBoard?: (deps: BoardDeps) => BoardServiceApi;
+}
+export interface Coordination {
+    cards: CardStoreApi;
+    events: TreeEventLogApi;
+    board: BoardServiceApi;
+    digest: DigestProvider;
+    mailSink: MailEventSink;
+    emit(session: Session, kind: TreeEventKind, summary: string, ref?: string): Promise<void>;
+    onSessionExit(sessionId: string): Promise<void>;
+    onSessionStart(sessionId: string): void;
+}
+export declare function rootOf(session: Pick<Session, 'id' | 'parentSessionId'>): string;
+export declare function createCoordination(deps: CoordinationDeps): Coordination;

package/dist/coordination/wiring.js

@@ -0,0 +1,143 @@
+import { BoardService } from './board.js';
+import { CardStore } from './card-store.js';
+import { TreeEventLog } from './tree-events.js';
+export function rootOf(session) {
+    return session.parentSessionId ?? session.id;
+}
+function sameBlockedOn(a, b) {
+    if (a === undefined && b === undefined)
+        return true;
+    if (a === undefined || b === undefined)
+        return false;
+    return a.kind === b.kind && a.text === b.text && a.ref === b.ref;
+}
+function statusChanged(current, previous) {
+    if (!previous)
+        return true;
+    if (current.state !== previous.state)
+        return true;
+    if (current.headline !== previous.headline)
+        return true;
+    return !sameBlockedOn(current.blockedOn, previous.blockedOn);
+}
+function formatStatusSummary(card) {
+    const base = `${card.state}: ${card.headline}`;
+    if (card.state === 'blocked' && card.blockedOn) {
+        return `${base} — blocked on ${card.blockedOn.kind}: ${card.blockedOn.text}`;
+    }
+    return base;
+}
+export function createCoordination(deps) {
+    const events = (deps.createEvents ?? ((d) => new TreeEventLog(d)))({
+        sessionDir: (id) => deps.store.sessionDir(id),
+        now: deps.now,
+    });
+    const exitedSessions = new Set();
+    function onSessionStart(sessionId) {
+        exitedSessions.delete(sessionId);
+    }
+    async function emit(session, kind, summary, ref) {
+        if (kind === 'exit') {
+            if (exitedSessions.has(session.id))
+                return;
+            exitedSessions.add(session.id);
+        }
+        try {
+            const rootId = rootOf(session);
+            await events.append(rootId, {
+                sessionId: session.id,
+                sessionName: session.name,
+                kind,
+                summary,
+                ...(ref !== undefined ? { ref } : {}),
+            });
+        }
+        catch (error) {
+            console.warn('[Coordination] Failed to emit tree event:', error instanceof Error ? error.message : String(error));
+        }
+    }
+    async function onSessionExit(sessionId) {
+        if (exitedSessions.has(sessionId))
+            return;
+        await deps.store
+            .loadSession(sessionId)
+            .then((session) => {
+            if (session && (session.status === 'completed' || session.status === 'error')) {
+                return emit(session, 'exit', `exited: ${session.status}`);
+            }
+        })
+            .catch((error) => {
+            console.warn('[Coordination] Failed to load session on exit:', error instanceof Error ? error.message : String(error));
+        });
+    }
+    const cards = (deps.createCards ?? ((d) => new CardStore(d)))({
+        loadSession: (id) => deps.store.loadSession(id),
+        saveSession: (session) => deps.store.saveSession(session),
+        now: deps.now,
+        onChange: async (saved, previous) => {
+            try {
+                deps.publishSession(saved);
+            }
+            catch (error) {
+                console.warn('[Coordination] Failed to publish session update:', error instanceof Error ? error.message : String(error));
+            }
+            if (saved.card && statusChanged(saved.card, previous)) {
+                await emit(saved, 'status', formatStatusSummary(saved.card));
+            }
+        },
+    });
+    const board = (deps.createBoard ?? ((d) => new BoardService(d)))({
+        loadSession: (id) => deps.store.loadSession(id),
+        listSessions: () => deps.store.listSessions(),
+        attention: async (id) => {
+            const page = await deps.attention.list(id);
+            return { activity: page.activity, openCount: page.openCount };
+        },
+        prStatus: (url) => deps.prStatus(url),
+        unreadMail: (id) => deps.mail.unreadCount(id),
+        events,
+        now: deps.now,
+    });
+    const digestCursors = new Map();
+    const digest = {
+        async digestFor(recipientSessionId) {
+            try {
+                const sessions = await deps.store.listSessions();
+                const hasChildren = sessions.some((s) => s.parentSessionId === recipientSessionId && s.id !== recipientSessionId);
+                if (!hasChildren)
+                    return null;
+                let since = digestCursors.get(recipientSessionId);
+                if (since === undefined) {
+                    since = await events.head(recipientSessionId);
+                    digestCursors.set(recipientSessionId, since);
+                }
+                const result = await board.digest(recipientSessionId, since);
+                digestCursors.set(recipientSessionId, result.cursor);
+                return result.line;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+    const mailSink = {
+        async onAccepted(message, recipient) {
+            try {
+                if (message.type !== 'result')
+                    return;
+                const sender = await deps.store.loadSession(message.from);
+                if (!sender)
+                    return;
+                if (rootOf(sender) !== recipient.id)
+                    return;
+                const firstLine = (message.body.split(/\r?\n/, 1)[0] ?? '').slice(0, 200);
+                await emit(sender, 'result', firstLine);
+            }
+            catch (error) {
+                console.warn('[Coordination] Failed to handle accepted mail event:', error instanceof Error ? error.message : String(error));
+            }
+        },
+    };
+    return { cards, events, board, digest, mailSink, emit, onSessionExit, onSessionStart };
+}
+//# sourceMappingURL=wiring.js.map

package/dist/coordination/wiring.js.map

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

package/dist/coordination-cli.d.ts

@@ -0,0 +1,34 @@
+import { type Board, type BoardWaitCondition, type CardPatch, type CardProgress, type TreeEvent } from './coordination/contract.js';
+/** One local-API call; injectable so tests need no bridge. */
+export type CoordinationApiFn = (method: string, path: string, body?: unknown) => Promise<unknown>;
+export interface CoordinationCliDeps {
+    api: CoordinationApiFn;
+    now: () => number;
+    env: NodeJS.ProcessEnv;
+    log: (text: string) => void;
+    errorLog: (text: string) => void;
+}
+export declare const WAIT_DEFAULT_TIMEOUT_SECONDS = 300;
+export declare const WAIT_MAX_TIMEOUT_SECONDS = 300;
+/** Usage problem: message printed, exit code 2. */
+export declare class UsageError extends Error {
+    readonly usage?: string | undefined;
+    constructor(message: string, usage?: string | undefined);
+}
+export declare function parseProgress(value: string): CardProgress;
+export interface StatusSetFlags {
+    state?: string;
+    headline?: string;
+    /** string value, false for --no-progress, undefined when absent */
+    progress?: string | boolean;
+    on?: string;
+    text?: string;
+    /** string value, false for --no-next, undefined when absent */
+    next?: string | boolean;
+}
+export declare function buildCardPatch(flags: StatusSetFlags): CardPatch;
+/** Pure wait-condition evaluation over a fetched board and the events that arrived. */
+export declare function evaluateWaitCondition(condition: BoardWaitCondition, board: Board, events: readonly TreeEvent[]): boolean;
+export declare function runStatus(argv: string[], deps?: Partial<CoordinationCliDeps>): Promise<number>;
+export declare function runBoard(argv: string[], deps?: Partial<CoordinationCliDeps>): Promise<number>;
+export declare function runEvents(argv: string[], deps?: Partial<CoordinationCliDeps>): Promise<number>;