ftown 0.26.0 → 0.28.0

package/dist/coordination/contract-b.d.ts

@@ -0,0 +1,206 @@
+/**
+ * FROZEN CONTRACT — coordination phase B: parent-first attention, manager brief +
+ * dashboard overview, optional bridge-owned worktrees. Types/constants/interfaces only.
+ * Implementers must not modify this file.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { AttentionAnswer, AttentionPrompt } from '../attention-prompt-protocol.js';
+import type { AttentionItem } from '../attention-events.js';
+import type { Session } from '../types.js';
+/**
+ * Routing rules (single hop; the tree is one level deep):
+ * - An attention item created by a session S (POST /api/sessions/:id/attention or /ask) gets
+ *   route 'parent' iff S.parentSessionId is set, the parent session exists, status 'running',
+ *   shellType !== 'shell', runner reports it running, AND the request did not ask `to: 'human'`.
+ *   Otherwise route 'human' (today's behaviour).
+ * - route 'parent': NO dashboard notice publish and NO push for this item. The parent receives ONE
+ *   waking mail, type 'escalation', from S, body = PARENT_QUESTION_MAIL(...) below. A tree event
+ *   kind 'attention' is emitted (phase A already emits it). S's card is untouched (the agent may set it).
+ *   The item IS visible in the human's inbox (greyed "with parent"), and the human may still answer it.
+ * - The parent answers → item answered exactly as a human answer (same delivery: live waiter or
+ *   mail from "You"; for parent answers the mail sender is the parent session), plus answeredBy.
+ * - The parent escalates (or the parent exits/stops/errors while the item is open and route==='parent')
+ *   → route flips to 'human', escalatedAt set, escalationNote set (parent note, or PARENT_UNAVAILABLE_NOTE),
+ *   and the normal dashboard notice + push flow fires NOW, as if the item had just been created.
+ * - No timers. Only the parent (or parent unavailability) moves an item to the human.
+ * - Repeating an identical open request keeps its current route (occurrence count only).
+ */
+export type AttentionRoute = 'parent' | 'human';
+export interface AttentionAnsweredBy {
+    kind: 'human' | 'session';
+    sessionId?: string;
+    name?: string;
+}
+/** Fields added to AttentionItem (declared optional on AttentionItem in attention-events.ts). */
+export interface AttentionRoutingFields {
+    route?: AttentionRoute;
+    routedTo?: string;
+    escalatedAt?: string;
+    escalationNote?: string;
+    answeredBy?: AttentionAnsweredBy;
+}
+export declare const ESCALATION_NOTE_MAX = 500;
+export declare const PARENT_UNAVAILABLE_NOTE = "Parent session is not running; routed to you.";
+/**
+ * Exact mail body to the parent (type 'escalation', threadId = item id):
+ *   `[ftown question id=<eventId> from=<childName> (<childId>)] <title>\n<message>\n` +
+ *   (options ? `Options: 1) <label> 2) <label> ...\n` : '') +
+ *   `Answer: ftown attention answer <childId> <eventId> --option <n> | --text "<reply>"\n` +
+ *   `Escalate to the human: ftown attention escalate <childId> <eventId> --note "<context>"`
+ * For multi-question prompts list each question as `Q<i>: <question>` with its options.
+ */
+export declare const PARENT_QUESTION_PREFIX = "[ftown question";
+/** AttentionStore additions (bridge/src/attention-store.ts). */
+export interface AttentionRoutingStoreApi {
+    /** set route fields on an existing open item; returns updated item or undefined if missing/resolved */
+    setRoute(sessionId: string, eventId: string, fields: AttentionRoutingFields): Promise<AttentionItem | undefined>;
+    /** open items (not resolved) of childId with route==='parent' */
+    listRouted(childId: string): Promise<AttentionItem[]>;
+}
+/** Local API (via dispatchSecure). Caller identity = x-ftown-session-id (local-cli principal). */
+export declare const ATTENTION_ROUTES: {
+    /** POST body { answers: AttentionAnswerEntry[] } — caller must be the child's parent (403 otherwise); 409 if resolved; 400 invalid answers. → { event: AttentionItem } */
+    readonly answer: "/api/sessions/:id/attention/:eventId/answer";
+    /** POST body { note?: string } — caller must be the parent; 409 if route already 'human' or resolved. → { event: AttentionItem } */
+    readonly escalate: "/api/sessions/:id/attention/:eventId/escalate";
+    /** GET → { items: Array<{ sessionId: string; sessionName: string; event: AttentionItem }> } — open parent-routed items of all children of :id */
+    readonly routed: "/api/sessions/:id/attention/routed";
+};
+/** Existing POST /api/sessions/:id/attention and /attention/ask accept a new optional body key `to: 'human'`. */
+/**
+ * CLI (new group `ftown attention`, bridge/src/attention-cli.ts):
+ *   ftown attention list [--json]                                   → routed items for my children (plain: `<child> <eventId> <title>` + options)
+ *   ftown attention answer <child-id> <event-id> (--option <n|label>... | --text <t> | --answers-json <json>) [--json]
+ *   ftown attention escalate <child-id> <event-id> [--note <t>] [--json]
+ * `ftown sessions attention ... --to human` bypasses the parent.
+ * Exit codes: 0 ok, 1 error, 2 usage, 4 forbidden (not the parent), 5 conflict (already resolved/escalated).
+ */
+/** Dashboard wire: AttentionItem fields above flow unchanged through existing attention reads. */
+export type AttentionPromptRef = AttentionPrompt;
+export type AttentionAnswerRef = AttentionAnswer;
+export declare const BRIEF_LIMITS: {
+    readonly text: 16384;
+    readonly note: 280;
+    readonly notes: 50;
+};
+export interface BriefNote {
+    ts: string;
+    text: string;
+}
+/** Stored on Session.brief (session.json) → flows to dashboard via toWireSession. */
+export interface SessionBrief {
+    text?: string;
+    notes: BriefNote[];
+    updatedAt: string;
+}
+export declare const BRIEF_ROUTES: {
+    /** GET → { brief: SessionBrief | null }; PUT body { text: string | null } → { brief }; DELETE → { ok: true } */
+    readonly brief: "/api/sessions/:id/brief";
+    /** POST body { text: string } → { brief } (appends one note) */
+    readonly notes: "/api/sessions/:id/brief/notes";
+};
+/**
+ * CLI (bridge/src/brief-cli.ts, group `ftown brief`):
+ *   ftown brief show [--json] [--session-id <id>]
+ *   ftown brief set (--file <path.md> | --text <t> | --clear) [--session-id <id>]
+ *   ftown brief note <text...> [--session-id <id>]
+ * Validation: control chars except \n\t stripped; text over limit → error exit 1 (no truncation).
+ * Every successful write publishes the session to the dashboard.
+ *
+ * Dashboard overview (UI): for a selected session that has ≥1 child, an "Overview" view showing:
+ * the brief (markdown, rendered like existing markdown previews, sanitized), the last 10 notes,
+ * and a table of children: name, card chip (state/headline/progress/blocked), activity + idle,
+ * PR link + check state, open attention count incl. "with parent" items, worktree branch.
+ * Rendered client-side from data the dashboard already has (sessions with card/brief/worktree,
+ * PR statuses hook, attention). Each card's age is shown ("updated 4m ago").
+ */
+/** Stored on Session.worktree. Only createdByBridge worktrees are ever removed by the bridge. */
+export interface SessionWorktree {
+    repoRoot: string;
+    path: string;
+    branch: string;
+    base: string;
+    createdByBridge: true;
+    retained?: {
+        reason: string;
+        at: string;
+    };
+}
+export interface WorktreeCreateRequest {
+    /** directory inside a git repo (the requested workdir, or the parent's workingDir when omitted) */
+    fromDir: string;
+    /** session name → default branch `ftown/<slug(name)>` and path `<repoRoot>/.claude/worktrees/<slug(name)>` */
+    name: string;
+    branch?: string;
+    base?: string;
+}
+export interface WorktreeStatus {
+    path: string;
+    branch: string;
+    base: string;
+    exists: boolean;
+    dirty: boolean;
+    ahead: number;
+    unpushed: number | null;
+    mergedIntoBase: boolean;
+}
+export type WorktreeRetireDecision = {
+    action: 'remove';
+    deleteBranch: boolean;
+} | {
+    action: 'retain';
+    reason: string;
+};
+/** Implementation: bridge/src/worktrees.ts — all git calls via execFile('git', [...]) with cwd, no shell, timeout 30s. */
+export interface WorktreeApi {
+    create(req: WorktreeCreateRequest): Promise<SessionWorktree>;
+    status(wt: SessionWorktree): Promise<WorktreeStatus>;
+    /** pure: retire iff exists && !dirty && (mergedIntoBase || (unpushed === 0)); else retain with reason */
+    decide(status: WorktreeStatus): WorktreeRetireDecision;
+    /** git worktree remove (no --force unless force) + optional `git branch -d` (never -D) */
+    remove(wt: SessionWorktree, opts: {
+        force: boolean;
+        deleteBranch: boolean;
+    }): Promise<void>;
+}
+export declare class WorktreeError extends Error {
+    readonly code: 'not_a_repo' | 'detached_head' | 'bad_branch' | 'exists' | 'git_failed';
+    constructor(code: 'not_a_repo' | 'detached_head' | 'bad_branch' | 'exists' | 'git_failed', message: string);
+}
+/**
+ * Create: POST /api/sessions body gains `worktree?: true | { branch?: string; base?: string }`.
+ *   CLI: `ftown sessions create --worktree [--branch <b>] [--base <ref>]` (with --workdir optional).
+ *   The worktree is created before the session launches; session.workingDir = worktree.path. On WorktreeError → 400 with message, no session created.
+ * Remove: DELETE /api/sessions/:id accepts query `worktree=keep|force` (default: auto-decide).
+ *   CLI: `ftown sessions remove <id> [--keep-worktree | --force-worktree]`; output states removed/retained + reason.
+ *   Auto: status → decide → remove or set worktree.retained. Errors never block archiving the session.
+ * List/prune:
+ *   GET  /api/worktrees → { worktrees: Array<{ sessionId: string; sessionName: string; archived: boolean; worktree: SessionWorktree; status: WorktreeStatus | null; error?: string }> }  (status null + error when the git probe failed for that row)
+ *   POST /api/worktrees/prune → { removed: string[]; retained: Array<{ path: string; reason: string }> }  (archived sessions only, same decide rule)
+ *   CLI (bridge/src/worktrees-cli.ts, group `ftown worktrees`): `list [--json]`, `prune [--json]`.
+ */
+export declare const WORKTREE_ROUTES: {
+    readonly list: "/api/worktrees";
+    readonly prune: "/api/worktrees/prune";
+};
+export interface RouteContext {
+    req: IncomingMessage;
+    res: ServerResponse;
+    method: string;
+    /** pathname without query */
+    path: string;
+    query: URLSearchParams;
+    /** x-ftown-session-id of a local-cli caller, else undefined */
+    callerSessionId?: string;
+    parseBody(): Promise<Record<string, unknown>>;
+    json(status: number, body: unknown): void;
+    loadSession(id: string): Promise<Session | null>;
+    saveSession(session: Session): Promise<void>;
+    publishSession(session: Session): void;
+}
+/** Each route module exports `handle(ctx): Promise<boolean>` (true = handled). Throw BadRequestError-like errors as `{ status, message }`. */
+export type RouteModule = (ctx: RouteContext) => Promise<boolean>;
+export declare class RouteError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}

package/dist/coordination/contract-b.js

@@ -0,0 +1,58 @@
+export const ESCALATION_NOTE_MAX = 500;
+export const PARENT_UNAVAILABLE_NOTE = 'Parent session is not running; routed to you.';
+/**
+ * Exact mail body to the parent (type 'escalation', threadId = item id):
+ *   `[ftown question id=<eventId> from=<childName> (<childId>)] <title>\n<message>\n` +
+ *   (options ? `Options: 1) <label> 2) <label> ...\n` : '') +
+ *   `Answer: ftown attention answer <childId> <eventId> --option <n> | --text "<reply>"\n` +
+ *   `Escalate to the human: ftown attention escalate <childId> <eventId> --note "<context>"`
+ * For multi-question prompts list each question as `Q<i>: <question>` with its options.
+ */
+export const PARENT_QUESTION_PREFIX = '[ftown question';
+/** Local API (via dispatchSecure). Caller identity = x-ftown-session-id (local-cli principal). */
+export const ATTENTION_ROUTES = {
+    /** POST body { answers: AttentionAnswerEntry[] } — caller must be the child's parent (403 otherwise); 409 if resolved; 400 invalid answers. → { event: AttentionItem } */
+    answer: '/api/sessions/:id/attention/:eventId/answer',
+    /** POST body { note?: string } — caller must be the parent; 409 if route already 'human' or resolved. → { event: AttentionItem } */
+    escalate: '/api/sessions/:id/attention/:eventId/escalate',
+    /** GET → { items: Array<{ sessionId: string; sessionName: string; event: AttentionItem }> } — open parent-routed items of all children of :id */
+    routed: '/api/sessions/:id/attention/routed',
+};
+// ───────────────────────── C: manager brief + dashboard overview ─────────────────────────
+export const BRIEF_LIMITS = { text: 16_384, note: 280, notes: 50 };
+export const BRIEF_ROUTES = {
+    /** GET → { brief: SessionBrief | null }; PUT body { text: string | null } → { brief }; DELETE → { ok: true } */
+    brief: '/api/sessions/:id/brief',
+    /** POST body { text: string } → { brief } (appends one note) */
+    notes: '/api/sessions/:id/brief/notes',
+};
+export class WorktreeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'WorktreeError';
+    }
+}
+/**
+ * Create: POST /api/sessions body gains `worktree?: true | { branch?: string; base?: string }`.
+ *   CLI: `ftown sessions create --worktree [--branch <b>] [--base <ref>]` (with --workdir optional).
+ *   The worktree is created before the session launches; session.workingDir = worktree.path. On WorktreeError → 400 with message, no session created.
+ * Remove: DELETE /api/sessions/:id accepts query `worktree=keep|force` (default: auto-decide).
+ *   CLI: `ftown sessions remove <id> [--keep-worktree | --force-worktree]`; output states removed/retained + reason.
+ *   Auto: status → decide → remove or set worktree.retained. Errors never block archiving the session.
+ * List/prune:
+ *   GET  /api/worktrees → { worktrees: Array<{ sessionId: string; sessionName: string; archived: boolean; worktree: SessionWorktree; status: WorktreeStatus | null; error?: string }> }  (status null + error when the git probe failed for that row)
+ *   POST /api/worktrees/prune → { removed: string[]; retained: Array<{ path: string; reason: string }> }  (archived sessions only, same decide rule)
+ *   CLI (bridge/src/worktrees-cli.ts, group `ftown worktrees`): `list [--json]`, `prune [--json]`.
+ */
+export const WORKTREE_ROUTES = { list: '/api/worktrees', prune: '/api/worktrees/prune' };
+export class RouteError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'RouteError';
+    }
+}
+//# sourceMappingURL=contract-b.js.map

package/dist/coordination/contract-b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-b.js","sourceRoot":"","sources":["../../src/coordination/contract-b.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,+CAA+C,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAUxD,kGAAkG;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,0KAA0K;IAC1K,MAAM,EAAE,6CAA6C;IACrD,oIAAoI;IACpI,QAAQ,EAAE,+CAA+C;IACzD,iJAAiJ;IACjJ,MAAM,EAAE,oCAAoC;CACpC,CAAC;AAgBX,4FAA4F;AAE5F,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAW,CAAC;AAU5E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gHAAgH;IAChH,KAAK,EAAE,yBAAyB;IAChC,gEAAgE;IAChE,KAAK,EAAE,+BAA+B;CAC9B,CAAC;AA8DX,MAAM,OAAO,aAAc,SAAQ,KAAK;IACV;IAA5B,YAA4B,IAA6E,EAAE,OAAe;QACxH,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,SAAI,GAAJ,IAAI,CAAyE;QACvF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9C,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,sBAAsB,EAAW,CAAC;AAsBlG,MAAM,OAAO,UAAW,SAAQ,KAAK;IACP;IAA5B,YAA4B,MAAc,EAAE,OAAe;QAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAAlD,WAAM,GAAN,MAAM,CAAQ;QAAqC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAAC,CAAC;CAC3G"}

package/dist/coordination/contract-c.d.ts

@@ -0,0 +1,117 @@
+/**
+ * FROZEN CONTRACT — coordination phase C: plan list (todo with precedence), retired
+ * history on the board, removed/plan tree events, dashboard board snapshot RPC, board v3
+ * Overview. Types/constants/interfaces only. Implementers must not modify this file.
+ */
+import type { Board, SessionCard, TreeEvent } from './contract.js';
+import type { AttentionItem } from '../attention-events.js';
+export declare const PLAN_LIMITS: {
+    readonly items: 200;
+    readonly title: 140;
+    readonly note: 500;
+    readonly after: 20;
+};
+export declare const PLAN_STATES: readonly ["todo", "started", "done", "dropped"];
+export type PlanState = typeof PLAN_STATES[number];
+export type PlanPriority = 1 | 2 | 3;
+export interface PlanItem {
+    id: string;
+    title: string;
+    note?: string;
+    after: string[];
+    priority: PlanPriority;
+    state: PlanState;
+    sessionId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Stored on the PARENT session: Session.plan (session.json) → flows to dashboard via toWireSession. */
+export interface SessionPlan {
+    items: PlanItem[];
+    seq: number;
+}
+/**
+ * Derived ordering (pure helper `orderPlan(items)` in bridge/src/coordination/plan.ts, also re-implemented
+ * identically in the UI — see PLAN_ORDER_RULE):
+ *   ready   = state 'todo' && every `after` item is 'done' or 'dropped'
+ *   waiting = state 'todo' && not ready
+ * Order: ready (priority asc, createdAt asc), then waiting (same), then started (updatedAt asc),
+ * then done (updatedAt desc), then dropped (updatedAt desc).
+ */
+export declare const PLAN_ORDER_RULE: "ready>waiting>started>done>dropped; within ready/waiting: priority asc, createdAt asc";
+export interface PlanView {
+    items: PlanItem[];
+    ready: string[];
+}
+/** Routes (via dispatchSecure; :id = parent session). Caller: local-cli principal; any session may edit the plan of :id (owner-only enforcement is out of scope). */
+export declare const PLAN_ROUTES: {
+    /** GET → PlanView; POST body { title, note?, after?, priority? } → { item } */
+    readonly plan: "/api/sessions/:id/plan";
+    /** PATCH body { title?, note?: string|null, after?, priority?, state?, sessionId?: string|null } → { item }; DELETE → { ok: true } (removes id from others' `after`) */
+    readonly item: "/api/sessions/:id/plan/:itemId";
+};
+export declare class PlanValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Automatic transitions (bridge wiring):
+ * - `ftown sessions create --parent --plan-item <id>`: after the child exists, item.state = 'started', item.sessionId = child.id.
+ *   Unknown/non-todo item → create fails 400 BEFORE the session is created.
+ * - When a child's declared card becomes 'done' and an item of its parent has sessionId === child.id and state 'started' → 'done'.
+ *   'failed' card → item back to 'todo' with sessionId cleared? NO: leave 'started' (manager decides).
+ * - Every plan change emits ONE tree event kind 'plan' on the parent's log with summary
+ *   `<id> <state>: <title>` ; when items become ready because of it, append ` → ready: <id>, <id>`.
+ *
+ * CLI (bridge/src/plan-cli.ts, group `ftown plan`, default session = FTOWN_SESSION_ID = the manager):
+ *   ftown plan [--json] [--session-id <id>]                       list in order: `<mark> <id> [P<prio>] <title>  (after p1,p2 | → <child name>)`
+ *                                                                  marks: `→` ready, `·` waiting, `▸` started, `✓` done, `✗` dropped
+ *   ftown plan add <title...> [--note <t>] [--after <id,id>] [--priority 1|2|3]
+ *   ftown plan start <id> --session <child-id>
+ *   ftown plan done <id> | drop <id> | todo <id>
+ *   ftown plan edit <id> [--title <t>] [--note <t>|--no-note] [--after <ids>|--no-after] [--priority n]
+ *   ftown plan rm <id>
+ *   ftown sessions create --parent --plan-item <id> ...  (in sessions-commands.ts)
+ * Exit codes: 0 ok, 1 error, 2 usage.
+ */
+/** Added to TREE_EVENT_KINDS in contract.ts (phase C edit): 'plan' and 'removed'. */
+export declare const PHASE_C_EVENT_KINDS: readonly ["plan", "removed"];
+/** 'removed': emitted when a child session is removed/archived while not already exited; summary `removed`. */
+/** SessionCard gains (in contract.ts, phase C edit): `archived?: boolean`. Board gains `plan?: PlanView`. */
+export interface BoardPhaseCFields {
+    archived?: boolean;
+}
+/**
+ * BoardService (phase C):
+ * - BoardDeps gains `listArchived(): Promise<Session[]>` (archive store records).
+ * - board({ all: true }) includes archived children (archived: true, derived.status as recorded, activity 'unknown'),
+ *   ordered after live children by archived time desc, capped at 50 most recent.
+ * - Board.plan = the parent's PlanView when the root has a plan (always included).
+ * - Plain `ftown board`: after child rows, a `planned` section: up to 5 ready items `→ <id> <title>` then `+N more`.
+ *
+ * `ftown board --wait --until any-done|any-blocked|any-ready` (phase C fix): the condition must hold for a child
+ * whose tree events arrived AFTER the starting cursor (any-done: a changed child is now done, etc.).
+ * `all-done` stays global. `any-change` unchanged.
+ */
+/** command-rpc command `get_session_board`, payload { bridgeId, sessionId } → BoardSnapshot. Read-only. */
+export interface BoardSnapshot {
+    board: Board;
+    events: TreeEvent[];
+    attention: Array<{
+        sessionId: string;
+        event: AttentionItem;
+    }>;
+}
+export declare const BOARD_SNAPSHOT_EVENTS = 50;
+/**
+ * UI (board v3 Overview, see .ftown-previews/board-v3-notes.md in the phase B worktree — copied to
+ * docs/design/board-v3.md in this phase):
+ * - hook `useSessionBoard(bridgeId, sessionId, enabled)` calls get_session_board on mount, on any session update
+ *   for that tree, and every 15 s while the Overview is visible; never while hidden.
+ * - SessionOverview renders: manager line; "needs attention · n" (failed | blocked | escalated question; owner
+ *   `you` or manager name); "active · n"; folds: planned (PlanView order), done (incl. archived/retired),
+ *   events, brief. Row expand shows details (state/progress/age/stale, blocked, question, next, activity +
+ *   idle duration, pr, worktree, mail, preview, agent, that session's last 3 events).
+ * - Idle duration: the UI records the timestamp when a session's activity becomes 'idle' (from hook events)
+ *   and shows `idle <n>m`.
+ */
+export type OverviewChild = SessionCard;

package/dist/coordination/contract-c.js

@@ -0,0 +1,47 @@
+// ───────────────────────── Plan (todo list with precedence) ─────────────────────────
+export const PLAN_LIMITS = { items: 200, title: 140, note: 500, after: 20 };
+export const PLAN_STATES = ['todo', 'started', 'done', 'dropped'];
+/**
+ * Derived ordering (pure helper `orderPlan(items)` in bridge/src/coordination/plan.ts, also re-implemented
+ * identically in the UI — see PLAN_ORDER_RULE):
+ *   ready   = state 'todo' && every `after` item is 'done' or 'dropped'
+ *   waiting = state 'todo' && not ready
+ * Order: ready (priority asc, createdAt asc), then waiting (same), then started (updatedAt asc),
+ * then done (updatedAt desc), then dropped (updatedAt desc).
+ */
+export const PLAN_ORDER_RULE = 'ready>waiting>started>done>dropped; within ready/waiting: priority asc, createdAt asc';
+/** Routes (via dispatchSecure; :id = parent session). Caller: local-cli principal; any session may edit the plan of :id (owner-only enforcement is out of scope). */
+export const PLAN_ROUTES = {
+    /** GET → PlanView; POST body { title, note?, after?, priority? } → { item } */
+    plan: '/api/sessions/:id/plan',
+    /** PATCH body { title?, note?: string|null, after?, priority?, state?, sessionId?: string|null } → { item }; DELETE → { ok: true } (removes id from others' `after`) */
+    item: '/api/sessions/:id/plan/:itemId',
+};
+export class PlanValidationError extends Error {
+    constructor(message) { super(message); this.name = 'PlanValidationError'; }
+}
+/**
+ * Automatic transitions (bridge wiring):
+ * - `ftown sessions create --parent --plan-item <id>`: after the child exists, item.state = 'started', item.sessionId = child.id.
+ *   Unknown/non-todo item → create fails 400 BEFORE the session is created.
+ * - When a child's declared card becomes 'done' and an item of its parent has sessionId === child.id and state 'started' → 'done'.
+ *   'failed' card → item back to 'todo' with sessionId cleared? NO: leave 'started' (manager decides).
+ * - Every plan change emits ONE tree event kind 'plan' on the parent's log with summary
+ *   `<id> <state>: <title>` ; when items become ready because of it, append ` → ready: <id>, <id>`.
+ *
+ * CLI (bridge/src/plan-cli.ts, group `ftown plan`, default session = FTOWN_SESSION_ID = the manager):
+ *   ftown plan [--json] [--session-id <id>]                       list in order: `<mark> <id> [P<prio>] <title>  (after p1,p2 | → <child name>)`
+ *                                                                  marks: `→` ready, `·` waiting, `▸` started, `✓` done, `✗` dropped
+ *   ftown plan add <title...> [--note <t>] [--after <id,id>] [--priority 1|2|3]
+ *   ftown plan start <id> --session <child-id>
+ *   ftown plan done <id> | drop <id> | todo <id>
+ *   ftown plan edit <id> [--title <t>] [--note <t>|--no-note] [--after <ids>|--no-after] [--priority n]
+ *   ftown plan rm <id>
+ *   ftown sessions create --parent --plan-item <id> ...  (in sessions-commands.ts)
+ * Exit codes: 0 ok, 1 error, 2 usage.
+ */
+// ───────────────────────── Tree events: new kinds ─────────────────────────
+/** Added to TREE_EVENT_KINDS in contract.ts (phase C edit): 'plan' and 'removed'. */
+export const PHASE_C_EVENT_KINDS = ['plan', 'removed'];
+export const BOARD_SNAPSHOT_EVENTS = 50;
+//# sourceMappingURL=contract-c.js.map

package/dist/coordination/contract-c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-c.js","sourceRoot":"","sources":["../../src/coordination/contract-c.ts"],"names":[],"mappings":"AAQA,uFAAuF;AAEvF,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAW,CAAC;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAmB3E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,uFAAgG,CAAC;AAIhI,qKAAqK;AACrK,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,+EAA+E;IAC/E,IAAI,EAAE,wBAAwB;IAC9B,wKAAwK;IACxK,IAAI,EAAE,gCAAgC;CAC9B,CAAC;AAEX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACpF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,6EAA6E;AAE7E,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;AA6BhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/coordination/contract.d.ts

@@ -5,6 +5,7 @@
  */
 import type { Activity } from '../attention-events.js';
 import type { PullRequestState } from '../pull-request-status-protocol.js';
+import type { PlanView } from './contract-c.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];
@@ -70,6 +71,8 @@ export interface CardDerived {
     model?: string;
 }
 export interface SessionCard {
+    /** phase C: true for retired (archived) children included by board(all) */
+    archived?: boolean;
     sessionId: string;
     name: string;
     parentSessionId?: string;
@@ -99,7 +102,7 @@ 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 declare const TREE_EVENT_KINDS: readonly ["status", "attention", "pr", "preview", "exit", "idle", "result", "mail", "plan", "removed"];
 export type TreeEventKind = typeof TREE_EVENT_KINDS[number];
 export interface TreeEvent {
     seq: number;
@@ -135,6 +138,8 @@ export interface TreeEventLogApi {
 }
 export type BoardRollupKey = CardState | 'unset';
 export interface Board {
+    /** phase C: the root's plan, ordered */
+    plan?: PlanView;
     rootId: string;
     /** tree event head at render time; pass back as `since` */
     cursor: number;
@@ -153,6 +158,8 @@ export interface BoardQuery {
     all?: boolean;
 }
 export interface BoardDeps {
+    /** phase C: archived session records */
+    listArchived?(): Promise<Session[]>;
     loadSession(id: string): Promise<Session | null>;
     listSessions(): Promise<Session[]>;
     attention(id: string): Promise<{

package/dist/coordination/contract.js

@@ -19,7 +19,7 @@ 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'];
+export const TREE_EVENT_KINDS = ['status', 'attention', 'pr', 'preview', 'exit', 'idle', 'result', 'mail', 'plan', 'removed'];
 /**
  * Digest line format (exact):
  *   `[ftown] since HH:MM: <part> | <part> | ...`

package/dist/coordination/contract.js.map

@@ -1 +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"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/coordination/contract.ts"],"names":[],"mappings":"AAUA,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;AAgCD,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,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AA4EvI;;;;;;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.js

@@ -1,8 +1,12 @@
 import { CARD_STATES, } from './contract.js';
 const ROLLUP_ORDER = [...CARD_STATES, 'unset'];
+const BLOCKED_TEXT_MAX = 60;
 function pad2(n) {
     return String(n).padStart(2, '0');
 }
+function truncate(text, max) {
+    return [...text].slice(0, max).join('');
+}
 export function formatLocalHHMM(iso) {
     const d = new Date(iso);
     return `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
@@ -22,6 +26,15 @@ export function formatBoardRow(card, nowMs) {
     }
     const headline = card.declared?.headline || '-';
     let suffix = '';
+    const progress = card.declared?.progress;
+    if (progress && state !== 'done') {
+        suffix += `  ${progress.done}/${progress.total}`;
+    }
+    const blockedOn = card.declared?.blockedOn;
+    if (blockedOn) {
+        const ref = blockedOn.ref ? `:${blockedOn.ref}` : '';
+        suffix += `  blocked on ${blockedOn.kind}${ref}: ${truncate(blockedOn.text, BLOCKED_TEXT_MAX)}`;
+    }
     if (card.derived.pr) {
         suffix += `  PR:${card.derived.pr.state}`;
     }
@@ -34,24 +47,50 @@ export function formatBoardRow(card, nowMs) {
     if (card.stale) {
         suffix += '  (stale)';
     }
+    if (card.archived) {
+        suffix += '  (retired)';
+    }
     return `${card.name} ${state} ${activity}${idlePart}  ${headline}${suffix}`;
 }
+const PLANNED_READY_LIMIT = 5;
+function formatPlannedLines(board) {
+    const ready = board.plan?.ready ?? [];
+    if (ready.length === 0)
+        return [];
+    const titleById = new Map((board.plan?.items ?? []).map((item) => [item.id, item.title]));
+    const shown = ready.slice(0, PLANNED_READY_LIMIT);
+    const lines = ['planned'];
+    for (const id of shown) {
+        const title = titleById.get(id) ?? '';
+        lines.push(title === '' ? `→ ${id}` : `→ ${id} ${title}`);
+    }
+    const more = ready.length - shown.length;
+    if (more > 0)
+        lines.push(`+${more} more`);
+    return lines;
+}
 export function formatBoard(board, nowMs) {
+    const lines = [];
     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}`);
-        }
+        lines.push('no child sessions');
     }
-    if (rollupParts.length > 0) {
-        rows.push(rollupParts.join(', '));
+    else {
+        for (const card of board.cards) {
+            lines.push(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) {
+            lines.push(rollupParts.join(', '));
+        }
     }
-    return rows.join('\n');
+    lines.push(...formatPlannedLines(board));
+    return lines.join('\n');
 }
 export function formatEvent(e) {
     const hhmm = formatLocalHHMM(e.ts);

package/dist/coordination/format.js.map

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