ftown 0.26.0 → 0.28.0

package/dist/coordination/routes-brief.js

@@ -0,0 +1,149 @@
+import { BRIEF_LIMITS, RouteError } from './contract-b.js';
+const BRIEF_PATTERN = /^\/api\/sessions\/([^/]+)\/brief$/;
+const NOTES_PATTERN = /^\/api\/sessions\/([^/]+)\/brief\/notes$/;
+function hasOwn(record, key) {
+    return Object.prototype.hasOwnProperty.call(record, key);
+}
+/** Strips control characters except \n and \t (C0, DEL, and C1 U+0080–U+009F). */
+function stripControlChars(value) {
+    return [...value].map((char) => {
+        const code = char.codePointAt(0) ?? 0;
+        const isControl = (code <= 31 && code !== 9 && code !== 10)
+            || code === 127
+            || (code >= 0x80 && code <= 0x9f);
+        return isControl ? '' : char;
+    }).join('');
+}
+function requireOnlyKeys(body, allowed) {
+    for (const key of Object.keys(body)) {
+        if (!allowed.includes(key))
+            throw new RouteError(400, `Unknown body key: ${key}`);
+    }
+}
+/** Cleans markdown brief text; keeps newlines/tabs; over-limit → 400. Blank-after-cleaning clears the text. */
+function parseBriefText(value) {
+    if (value === null)
+        return null;
+    if (typeof value !== 'string')
+        throw new RouteError(400, 'text must be a string or null');
+    const cleaned = stripControlChars(value);
+    if ([...cleaned].length > BRIEF_LIMITS.text) {
+        throw new RouteError(400, `text must be at most ${BRIEF_LIMITS.text} characters`);
+    }
+    return cleaned.trim() === '' ? null : cleaned;
+}
+/** Cleans a single note: control chars stripped, single line, 1..BRIEF_LIMITS.note characters. */
+function parseNoteText(value) {
+    if (typeof value !== 'string')
+        throw new RouteError(400, 'text must be a string');
+    const cleaned = stripControlChars(value).replace(/\s+/g, ' ').trim();
+    const length = [...cleaned].length;
+    if (length < 1)
+        throw new RouteError(400, 'text must not be empty');
+    if (length > BRIEF_LIMITS.note) {
+        throw new RouteError(400, `text must be at most ${BRIEF_LIMITS.note} characters`);
+    }
+    return cleaned;
+}
+function parseBodyText(body) {
+    requireOnlyKeys(body, ['text']);
+    const hasText = hasOwn(body, 'text') && body.text !== undefined;
+    if (!hasText)
+        throw new RouteError(400, 'text is required');
+    return body.text;
+}
+function buildBrief(existing, text) {
+    const brief = { notes: existing?.notes ?? [], updatedAt: new Date().toISOString() };
+    if (text !== null)
+        brief.text = text;
+    return brief;
+}
+function appendNote(existing, note) {
+    const brief = { notes: [...(existing?.notes ?? []), note], updatedAt: new Date().toISOString() };
+    if (existing?.text !== undefined)
+        brief.text = existing.text;
+    // Newest last, capped by dropping the oldest.
+    brief.notes = brief.notes.slice(-BRIEF_LIMITS.notes);
+    return brief;
+}
+async function loadSessionOr404(ctx, id) {
+    const session = await ctx.loadSession(id);
+    if (!session)
+        throw new RouteError(404, 'Session not found');
+    return session;
+}
+/**
+ * Reloads the session just before saving and derives the next brief from it via `mutate`,
+ * so concurrent writers never lose each other's changes. undefined removes the brief.
+ */
+async function mutateBrief(ctx, id, mutate) {
+    const fresh = await ctx.loadSession(id);
+    if (!fresh)
+        throw new RouteError(404, 'Session not found');
+    const next = mutate(fresh.brief);
+    const saved = { ...fresh };
+    if (next === undefined) {
+        delete saved.brief;
+    }
+    else {
+        saved.brief = next;
+    }
+    await ctx.saveSession(saved);
+    ctx.publishSession(saved);
+    return next;
+}
+/**
+ * Route module for BRIEF_ROUTES:
+ *   GET    /api/sessions/:id/brief       → { brief: SessionBrief | null }
+ *   PUT    /api/sessions/:id/brief       → { brief }   (body { text: string | null })
+ *   DELETE /api/sessions/:id/brief       → { ok: true }
+ *   POST   /api/sessions/:id/brief/notes → { brief }   (body { text: string })
+ * Returns false when the path does not match. Throws RouteError for HTTP errors.
+ */
+export async function handleBriefRoutes(ctx) {
+    const briefMatch = BRIEF_PATTERN.exec(ctx.path);
+    if (briefMatch) {
+        const id = briefMatch[1];
+        if (ctx.method === 'GET') {
+            const session = await loadSessionOr404(ctx, id);
+            ctx.json(200, { brief: session.brief ?? null });
+            return true;
+        }
+        if (ctx.method === 'PUT') {
+            await loadSessionOr404(ctx, id);
+            const text = parseBodyText(await ctx.parseBody());
+            const parsed = parseBriefText(text);
+            const next = await mutateBrief(ctx, id, (existing) => {
+                const brief = buildBrief(existing, parsed);
+                return brief.text === undefined && brief.notes.length === 0 ? undefined : brief;
+            });
+            ctx.json(200, { brief: next ?? null });
+            return true;
+        }
+        if (ctx.method === 'DELETE') {
+            await loadSessionOr404(ctx, id);
+            await mutateBrief(ctx, id, () => undefined);
+            ctx.json(200, { ok: true });
+            return true;
+        }
+        throw new RouteError(405, 'Method not allowed');
+    }
+    const notesMatch = NOTES_PATTERN.exec(ctx.path);
+    if (notesMatch) {
+        const id = notesMatch[1];
+        if (ctx.method === 'POST') {
+            await loadSessionOr404(ctx, id);
+            const text = parseBodyText(await ctx.parseBody());
+            const noteText = parseNoteText(text);
+            const next = await mutateBrief(ctx, id, (existing) => {
+                const note = { ts: new Date().toISOString(), text: noteText };
+                return appendNote(existing, note);
+            });
+            ctx.json(200, { brief: next });
+            return true;
+        }
+        throw new RouteError(405, 'Method not allowed');
+    }
+    return false;
+}
+//# sourceMappingURL=routes-brief.js.map

package/dist/coordination/routes-brief.js.map

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

package/dist/coordination/routes-plan.d.ts

@@ -0,0 +1,13 @@
+import { type PlanStore } from './plan.js';
+import { type RouteModule } from './contract-b.js';
+/**
+ * Route module factory for PLAN_ROUTES:
+ *   GET    /api/sessions/:id/plan            → PlanView (ordered via orderPlan)
+ *   POST   /api/sessions/:id/plan            → { item }  (body { title, note?, after?, priority? })
+ *   PATCH  /api/sessions/:id/plan/:itemId    → { item }  (body { title?, note?: string|null, after?, priority?, state?, sessionId?: string|null })
+ *   DELETE /api/sessions/:id/plan/:itemId    → { ok: true }
+ * Strict bodies (unknown keys → 400), PlanValidationError → 400 (a store-reported missing
+ * item or session → 404), unknown session/item → 404, wrong method → 405.
+ * Item ids must match p\d{1,6}; other paths fall through (returns false).
+ */
+export declare function createPlanRoutes(store: PlanStore): RouteModule;

package/dist/coordination/routes-plan.js

@@ -0,0 +1,182 @@
+import { PLAN_STATES, PlanValidationError } from './contract-c.js';
+import { orderPlan } from './plan.js';
+import { RouteError } from './contract-b.js';
+const PLAN_PATTERN = /^\/api\/sessions\/([^/]+)\/plan$/;
+const ITEM_PATTERN = /^\/api\/sessions\/([^/]+)\/plan\/(p\d{1,6})$/;
+function hasOwn(record, key) {
+    return Object.prototype.hasOwnProperty.call(record, key);
+}
+function requireOnlyKeys(body, allowed) {
+    for (const key of Object.keys(body)) {
+        if (!allowed.includes(key))
+            throw new RouteError(400, `Unknown body key: ${key}`);
+    }
+}
+function requireString(body, key) {
+    const value = body[key];
+    if (typeof value !== 'string')
+        throw new RouteError(400, `${key} must be a string`);
+    return value;
+}
+function parseOptionalString(body, key) {
+    if (!hasOwn(body, key) || body[key] === undefined)
+        return undefined;
+    return requireString(body, key);
+}
+function parseNullableString(body, key) {
+    if (!hasOwn(body, key) || body[key] === undefined)
+        return undefined;
+    if (body[key] === null)
+        return null;
+    return requireString(body, key);
+}
+function parseOptionalAfter(body) {
+    if (!hasOwn(body, 'after') || body.after === undefined)
+        return undefined;
+    const value = body.after;
+    if (!Array.isArray(value) || value.some((id) => typeof id !== 'string')) {
+        throw new RouteError(400, 'after must be an array of item ids');
+    }
+    return value;
+}
+function parseOptionalPriority(body) {
+    if (!hasOwn(body, 'priority') || body.priority === undefined)
+        return undefined;
+    const value = body.priority;
+    if (value !== 1 && value !== 2 && value !== 3)
+        throw new RouteError(400, 'priority must be 1, 2 or 3');
+    return value;
+}
+function parseOptionalState(body) {
+    if (!hasOwn(body, 'state') || body.state === undefined)
+        return undefined;
+    const value = body.state;
+    if (typeof value !== 'string' || !PLAN_STATES.includes(value)) {
+        throw new RouteError(400, `state must be one of: ${PLAN_STATES.join(', ')}`);
+    }
+    return value;
+}
+function parseAddBody(body) {
+    requireOnlyKeys(body, ['title', 'note', 'after', 'priority']);
+    if (!hasOwn(body, 'title') || body.title === undefined)
+        throw new RouteError(400, 'title is required');
+    const input = { title: requireString(body, 'title') };
+    const note = parseOptionalString(body, 'note');
+    if (note !== undefined)
+        input.note = note;
+    const after = parseOptionalAfter(body);
+    if (after !== undefined)
+        input.after = after;
+    const priority = parseOptionalPriority(body);
+    if (priority !== undefined)
+        input.priority = priority;
+    return input;
+}
+function parsePatchBody(body) {
+    requireOnlyKeys(body, ['title', 'note', 'after', 'priority', 'state', 'sessionId']);
+    const input = {};
+    const title = parseOptionalString(body, 'title');
+    if (title !== undefined)
+        input.title = title;
+    const note = parseNullableString(body, 'note');
+    if (note !== undefined)
+        input.note = note;
+    const after = parseOptionalAfter(body);
+    if (after !== undefined)
+        input.after = after;
+    const priority = parseOptionalPriority(body);
+    if (priority !== undefined)
+        input.priority = priority;
+    const state = parseOptionalState(body);
+    if (state !== undefined)
+        input.state = state;
+    const sessionId = parseNullableString(body, 'sessionId');
+    if (sessionId !== undefined)
+        input.sessionId = sessionId;
+    return input;
+}
+/**
+ * Maps the store's errors to HTTP statuses: a vanished item or session → 404,
+ * any other PlanValidationError → 400, everything else untouched.
+ */
+async function storeCall(call) {
+    try {
+        return await call();
+    }
+    catch (error) {
+        if (error instanceof PlanValidationError) {
+            if (/does not exist/.test(error.message))
+                throw new RouteError(404, error.message);
+            throw new RouteError(400, error.message);
+        }
+        if (error instanceof Error && error.message === 'Session not found') {
+            throw new RouteError(404, 'Session not found');
+        }
+        throw error;
+    }
+}
+async function loadSessionOr404(ctx, id) {
+    const session = await ctx.loadSession(id);
+    if (!session)
+        throw new RouteError(404, 'Session not found');
+    return session;
+}
+function requireItemOr404(session, itemId) {
+    if (!session.plan?.items.some((item) => item.id === itemId)) {
+        throw new RouteError(404, 'Plan item not found');
+    }
+}
+/**
+ * Route module factory for PLAN_ROUTES:
+ *   GET    /api/sessions/:id/plan            → PlanView (ordered via orderPlan)
+ *   POST   /api/sessions/:id/plan            → { item }  (body { title, note?, after?, priority? })
+ *   PATCH  /api/sessions/:id/plan/:itemId    → { item }  (body { title?, note?: string|null, after?, priority?, state?, sessionId?: string|null })
+ *   DELETE /api/sessions/:id/plan/:itemId    → { ok: true }
+ * Strict bodies (unknown keys → 400), PlanValidationError → 400 (a store-reported missing
+ * item or session → 404), unknown session/item → 404, wrong method → 405.
+ * Item ids must match p\d{1,6}; other paths fall through (returns false).
+ */
+export function createPlanRoutes(store) {
+    return async (ctx) => {
+        const planMatch = PLAN_PATTERN.exec(ctx.path);
+        if (planMatch) {
+            const id = planMatch[1];
+            if (ctx.method === 'GET') {
+                await loadSessionOr404(ctx, id);
+                const plan = await store.get(id);
+                ctx.json(200, orderPlan(plan?.items ?? []));
+                return true;
+            }
+            if (ctx.method === 'POST') {
+                await loadSessionOr404(ctx, id);
+                const input = parseAddBody(await ctx.parseBody());
+                const item = await storeCall(() => store.add(id, input));
+                ctx.json(200, { item });
+                return true;
+            }
+            throw new RouteError(405, 'Method not allowed');
+        }
+        const itemMatch = ITEM_PATTERN.exec(ctx.path);
+        if (itemMatch) {
+            const [id, itemId] = [itemMatch[1], itemMatch[2]];
+            if (ctx.method === 'PATCH') {
+                const session = await loadSessionOr404(ctx, id);
+                requireItemOr404(session, itemId);
+                const input = parsePatchBody(await ctx.parseBody());
+                const item = await storeCall(() => store.patch(id, itemId, input));
+                ctx.json(200, { item });
+                return true;
+            }
+            if (ctx.method === 'DELETE') {
+                const session = await loadSessionOr404(ctx, id);
+                requireItemOr404(session, itemId);
+                await storeCall(() => store.remove(id, itemId));
+                ctx.json(200, { ok: true });
+                return true;
+            }
+            throw new RouteError(405, 'Method not allowed');
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=routes-plan.js.map

package/dist/coordination/routes-plan.js.map

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

package/dist/coordination/routes-worktrees.d.ts

@@ -0,0 +1,29 @@
+import { type RouteModule, type SessionWorktree, type WorktreeApi, type WorktreeStatus } from './contract-b.js';
+import type { Session } from '../types.js';
+export interface WorktreeRoutesDeps {
+    listLive(): Promise<Session[]>;
+    listArchived(): Promise<Session[]>;
+    worktrees: WorktreeApi;
+    markRetained(sessionId: string, reason: string): Promise<void>;
+}
+export interface WorktreeRouteEntry {
+    sessionId: string;
+    sessionName: string;
+    archived: boolean;
+    worktree: SessionWorktree;
+    status: WorktreeStatus | null;
+    error?: string;
+}
+export interface WorktreePruneResponse {
+    removed: string[];
+    retained: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+/**
+ * Factory for WORKTREE_ROUTES:
+ *   GET  /api/worktrees       → { worktrees: WorktreeRouteEntry[] }
+ *   POST /api/worktrees/prune → { removed: string[]; retained: Array<{ path: string; reason: string }> }
+ */
+export declare function createWorktreeRoutes(deps: WorktreeRoutesDeps): RouteModule;

package/dist/coordination/routes-worktrees.js

@@ -0,0 +1,138 @@
+import { RouteError, WORKTREE_ROUTES, } from './contract-b.js';
+async function safeMarkRetained(deps, sessionId, reason) {
+    try {
+        await deps.markRetained(sessionId, reason);
+    }
+    catch (error) {
+        console.warn('[WorktreeRoutes] Failed to mark worktree retained:', error instanceof Error ? error.message : String(error));
+    }
+}
+function hasBridgeWorktree(session) {
+    return Boolean(session.worktree && session.worktree.createdByBridge);
+}
+/**
+ * Deduplicate archived tombstones (newest wins per session id) and exclude
+ * sessions or worktree paths that are currently live.
+ */
+function selectArchivedWithWorktree(archived, liveIds, livePaths) {
+    const lastIndexById = new Map();
+    for (let i = 0; i < archived.length; i++) {
+        lastIndexById.set(archived[i].id, i);
+    }
+    const selected = [];
+    for (let i = 0; i < archived.length; i++) {
+        const session = archived[i];
+        if (lastIndexById.get(session.id) !== i)
+            continue;
+        if (liveIds.has(session.id))
+            continue;
+        if (!hasBridgeWorktree(session))
+            continue;
+        if (livePaths.has(session.worktree.path))
+            continue;
+        selected.push(session);
+    }
+    return selected;
+}
+function requireNoQuery(ctx) {
+    for (const key of ctx.query.keys()) {
+        throw new RouteError(400, `Unknown query parameter: ${key}`);
+    }
+}
+/**
+ * Factory for WORKTREE_ROUTES:
+ *   GET  /api/worktrees       → { worktrees: WorktreeRouteEntry[] }
+ *   POST /api/worktrees/prune → { removed: string[]; retained: Array<{ path: string; reason: string }> }
+ */
+export function createWorktreeRoutes(deps) {
+    return async function routeWorktrees(ctx) {
+        if (ctx.path === WORKTREE_ROUTES.list) {
+            if (ctx.method !== 'GET') {
+                throw new RouteError(405, 'Method not allowed');
+            }
+            requireNoQuery(ctx);
+            const [live, archived] = await Promise.all([
+                deps.listLive(),
+                deps.listArchived(),
+            ]);
+            const liveWithWorktree = live.filter(hasBridgeWorktree);
+            const liveIds = new Set(live.map((s) => s.id));
+            const livePaths = new Set(liveWithWorktree.map((s) => s.worktree.path));
+            const archivedWithWorktree = selectArchivedWithWorktree(archived, liveIds, livePaths);
+            const candidates = [
+                ...liveWithWorktree.map((session) => ({ session, archived: false })),
+                ...archivedWithWorktree.map((session) => ({ session, archived: true })),
+            ];
+            const worktrees = [];
+            for (const { session, archived: isArchived } of candidates) {
+                try {
+                    const status = await deps.worktrees.status(session.worktree);
+                    worktrees.push({
+                        sessionId: session.id,
+                        sessionName: session.name,
+                        archived: isArchived,
+                        worktree: session.worktree,
+                        status,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    worktrees.push({
+                        sessionId: session.id,
+                        sessionName: session.name,
+                        archived: isArchived,
+                        worktree: session.worktree,
+                        status: null,
+                        error: message,
+                    });
+                }
+            }
+            ctx.json(200, { worktrees });
+            return true;
+        }
+        if (ctx.path === WORKTREE_ROUTES.prune) {
+            if (ctx.method !== 'POST') {
+                throw new RouteError(405, 'Method not allowed');
+            }
+            requireNoQuery(ctx);
+            const [live, archived] = await Promise.all([
+                deps.listLive(),
+                deps.listArchived(),
+            ]);
+            const liveWithWorktree = live.filter(hasBridgeWorktree);
+            const liveIds = new Set(live.map((s) => s.id));
+            const livePaths = new Set(liveWithWorktree.map((s) => s.worktree.path));
+            const archivedWithWorktree = selectArchivedWithWorktree(archived, liveIds, livePaths);
+            const removed = [];
+            const retained = [];
+            for (const session of archivedWithWorktree) {
+                const wt = session.worktree;
+                try {
+                    const status = await deps.worktrees.status(wt);
+                    const decision = deps.worktrees.decide(status);
+                    if (decision.action === 'remove') {
+                        await deps.worktrees.remove(wt, {
+                            force: false,
+                            deleteBranch: decision.deleteBranch,
+                        });
+                        removed.push(wt.path);
+                    }
+                    else {
+                        await safeMarkRetained(deps, session.id, decision.reason);
+                        retained.push({ path: wt.path, reason: decision.reason });
+                    }
+                }
+                catch (error) {
+                    const reason = error instanceof Error ? error.message : String(error);
+                    await safeMarkRetained(deps, session.id, reason);
+                    retained.push({ path: wt.path, reason });
+                }
+            }
+            const result = { removed, retained };
+            ctx.json(200, result);
+            return true;
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=routes-worktrees.js.map

package/dist/coordination/routes-worktrees.js.map

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

package/dist/coordination/wiring.d.ts

@@ -1,11 +1,15 @@
-import type { Activity } from '../attention-events.js';
+import type { Activity, AttentionItem } from '../attention-events.js';
 import type { PullRequestState } from '../pull-request-status-protocol.js';
 import type { Session } from '../types.js';
+import type { AttentionRoute, AttentionRoutingFields } from './contract-b.js';
 import type { BoardDeps, BoardServiceApi, CardStoreApi, CardStoreDeps, DigestProvider, MailEventSink, TreeEventKind, TreeEventLogApi, TreeEventLogDeps } from './contract.js';
+import { PlanStore } from './plan.js';
 export interface CoordinationSessionStore {
     loadSession(id: string): Promise<Session | null>;
     saveSession(session: Session): Promise<void>;
     listSessions(): Promise<Session[]>;
+    /** Archive tombstones, same source the worktree routes read. */
+    listArchived?(): Promise<Session[]>;
     sessionDir(id: string): string;
 }
 export interface CoordinationAttentionStore {
@@ -13,6 +17,8 @@ export interface CoordinationAttentionStore {
         activity: Activity;
         openCount: number;
     }>;
+    listRouted?(childId: string): Promise<AttentionItem[]>;
+    setRoute?(sessionId: string, eventId: string, fields: AttentionRoutingFields, expectRoute?: AttentionRoute): Promise<AttentionItem | undefined>;
 }
 export interface CoordinationPrStatusResult {
     state: PullRequestState;
@@ -29,19 +35,28 @@ export interface CoordinationDeps {
     mail: CoordinationMailStore;
     publishSession: (s: Session) => void;
     now: () => number;
+    onAttentionEscalated?: (sessionId: string, item: AttentionItem) => void;
     /** Optional factory seams for unit tests using *Api fakes. */
     createCards?: (deps: CardStoreDeps) => CardStoreApi;
     createEvents?: (deps: TreeEventLogDeps) => TreeEventLogApi;
     createBoard?: (deps: BoardDeps) => BoardServiceApi;
+    createPlan?: (deps: ConstructorParameters<typeof PlanStore>[0]) => PlanStore;
 }
 export interface Coordination {
     cards: CardStoreApi;
     events: TreeEventLogApi;
     board: BoardServiceApi;
+    /** Same instance handed to session create (`--plan-item`) and the plan routes. */
+    plan: PlanStore;
     digest: DigestProvider;
     mailSink: MailEventSink;
     emit(session: Session, kind: TreeEventKind, summary: string, ref?: string): Promise<void>;
-    onSessionExit(sessionId: string): Promise<void>;
+    /**
+     * `snapshot`, when passed, is the session as it existed before the record was
+     * deleted. Callers that already hold it (stop, remove/archive) must pass it:
+     * reloading after delete returns null and skips escalation.
+     */
+    onSessionExit(sessionId: string, snapshot?: Session): Promise<void>;
     onSessionStart(sessionId: string): void;
 }
 export declare function rootOf(session: Pick<Session, 'id' | 'parentSessionId'>): string;