frontier-mcp 0.1.0

package/dist/tools/get-board.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { Effort, TicketSummary } from '../domain.ts';
+export declare const getBoardInputSchema: {
+    effort: z.ZodString;
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const getBoardDescription: string;
+export interface Board {
+    readonly effort: Effort;
+    readonly tickets: readonly TicketSummary[];
+    /** The Tickets takeable right now. Computed repo-wide; never read from a file. */
+    readonly frontier: ReadonlySet<TicketSummary>;
+    /** Every Ticket in the workspace, because Edges resolve repo-wide. */
+    readonly byId: ReadonlyMap<string, TicketSummary>;
+}
+/**
+ * A Board is three views of one array — the Effort's slice of it, the Frontier
+ * over all of it, and an id lookup across all of it. Building them here keeps
+ * the identity relationship they depend on in one place: `frontier.has(ticket)`
+ * only works because every view derives from the same objects.
+ */
+export declare function boardFor(effort: Effort, all: readonly TicketSummary[]): Board;
+/**
+ * One line per Ticket, and nothing an agent has to open a file to interpret.
+ * The whole point is that this costs a fraction of reading the Effort, so every
+ * character here is spent deliberately.
+ */
+export declare function renderBoard(board: Board): string;
+//# sourceMappingURL=get-board.d.ts.map

package/dist/tools/get-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-board.d.ts","sourceRoot":"","sources":["../../src/tools/get-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG1D,eAAO,MAAM,mBAAmB;IAC9B,MAAM;IACN,IAAI;CACL,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAEwC,CAAC;AAEzE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,aAAa,EAAE,GAAG,KAAK,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAgChD"}

package/dist/tools/get-board.js

@@ -0,0 +1,190 @@
+import { z } from 'zod';
+import { frontierOf, indexById } from '../frontier.js';
+export const getBoardInputSchema = {
+    effort: z.string().describe('Effort slug, as reported by list_efforts.'),
+    root: z.string().optional().describe('Workspace directory. Defaults to the session workspace.'),
+};
+export const getBoardDescription = "An Effort's Destination, then one line per Ticket — id, title, kind, status, Edges — with the " +
+    'Frontier marked. Never returns bodies; fetch those with get_tickets.';
+/**
+ * A Board is three views of one array — the Effort's slice of it, the Frontier
+ * over all of it, and an id lookup across all of it. Building them here keeps
+ * the identity relationship they depend on in one place: `frontier.has(ticket)`
+ * only works because every view derives from the same objects.
+ */
+export function boardFor(effort, all) {
+    return {
+        effort,
+        tickets: all.filter(ticket => ticket.effort === effort.slug),
+        frontier: frontierOf(all),
+        byId: indexById(all),
+    };
+}
+/**
+ * One line per Ticket, and nothing an agent has to open a file to interpret.
+ * The whole point is that this costs a fraction of reading the Effort, so every
+ * character here is spent deliberately.
+ */
+export function renderBoard(board) {
+    const { effort, tickets, frontier } = board;
+    const lines = [`effort: ${effort.slug}`];
+    // Header-doc prose is the author's, wrapped however they wrote it. Indenting
+    // continuation lines keeps a multi-paragraph Destination from being read as
+    // more Ticket lines, which are strictly one per line.
+    if (effort.destination !== undefined)
+        lines.push(labelled('destination', effort.destination));
+    else if (effort.specOpening !== undefined)
+        lines.push(labelled('spec', effort.specOpening));
+    if (tickets.length === 0) {
+        lines.push('', '(no tickets)');
+        return lines.join('\n');
+    }
+    const takeable = tickets.filter(ticket => frontier.has(ticket));
+    lines.push(takeable.length === 0
+        ? 'frontier: none takeable in this Effort'
+        : `frontier: ${takeable.length} marked >`, '');
+    for (const ticket of tickets) {
+        const line = renderLine(ticket, board);
+        lines.push(frontier.has(ticket) ? `> ${line}` : line);
+    }
+    const warnings = collectWarnings(board);
+    if (warnings.length > 0)
+        lines.push('', 'warnings:', ...warnings.map(entry => `  ${entry}`));
+    return lines.join('\n');
+}
+/**
+ * How long a claim may sit before it looks abandoned. Long enough that an agent
+ * working steadily is never flagged, short enough that a session which died
+ * overnight is visible the next morning.
+ */
+const STALE_AFTER_HOURS = 24;
+/**
+ * A claim held past the threshold is reported and nothing more. Auto-expiry is
+ * explicitly out of scope: a long-running agent must never be silently robbed
+ * of its Ticket, so releasing one stays a human decision.
+ */
+function isStaleClaim(ticket) {
+    if (ticket.status !== 'claimed' || ticket.claimedAt === undefined)
+        return false;
+    const taken = Date.parse(ticket.claimedAt);
+    if (Number.isNaN(taken))
+        return false;
+    return Date.now() - taken > STALE_AFTER_HOURS * 60 * 60 * 1000;
+}
+function labelled(label, prose) {
+    return `${label}: ${prose.split('\n').join('\n  ')}`;
+}
+/**
+ * Fields are separated by two spaces, so any author-written value has its own
+ * whitespace collapsed first — a title containing a double space would
+ * otherwise forge a field boundary that is not there.
+ */
+function flat(prose) {
+    return prose.replace(/\s+/g, ' ').trim();
+}
+function renderLine(ticket, board) {
+    const parts = [
+        ticket.handle,
+        flat(ticket.title),
+        `${ticket.kind}/${ticket.status}`,
+        ticket.triage === undefined ? undefined : `triage=${ticket.triage}`,
+        ticket.blockedBy.length > 0
+            ? `blocked_by=${ticket.blockedBy.map(id => renderEdge(id, ticket, board)).join(',')}`
+            : undefined,
+        ticket.answerGist === undefined ? undefined : `gist=${flat(ticket.answerGist)}`,
+        ticket.droppedReason === undefined ? undefined : `dropped=${flat(ticket.droppedReason)}`,
+        ticket.claimedBy === undefined ? undefined : `claimed_by=${flat(ticket.claimedBy)}`,
+    ].filter(part => part !== undefined);
+    return parts.join('  ');
+}
+/**
+ * An Edge is a plain id. A blocker living in another Effort is annotated with
+ * its owning Effort so it stays followable — there is no compound reference
+ * form to carry that, and without it a foreign blocker is a dead end.
+ */
+function renderEdge(id, from, board) {
+    const blocker = board.byId.get(id);
+    if (blocker === undefined)
+        return `${id}?`;
+    return blocker.effort === from.effort ? id : `${id}@${blocker.effort}`;
+}
+/**
+ * Broken Edges surface here rather than through a separate validation tool,
+ * because a validation tool nobody calls is a validator that does not exist.
+ *
+ * Every warning is grouped, never itemized per Ticket. An Effort of Legacy
+ * Tickets can carry a dangling Edge on nearly every one of them, and a warnings
+ * block longer than the Board it annotates would undo the saving the Board
+ * exists to deliver.
+ */
+function collectWarnings(board) {
+    const warnings = [];
+    const dangling = new Set();
+    const orphaned = new Set();
+    const unrecognized = new Set();
+    const collapsed = new Set();
+    const declined = new Set();
+    const stale = new Set();
+    for (const ticket of board.tickets) {
+        for (const edge of ticket.blockedBy) {
+            const blocker = board.byId.get(edge);
+            if (blocker === undefined)
+                dangling.add(edge);
+            else if (blocker.status === 'dropped')
+                orphaned.add(ticket.handle);
+        }
+        if (ticket.unrecognizedStatus !== undefined) {
+            unrecognized.add(`${ticket.handle} "${ticket.unrecognizedStatus}"`);
+        }
+        // Still takeable as far as the graph is concerned — a Triage role never
+        // moves the Frontier — but somebody has declined it, which is worth saying
+        // before an agent picks it up.
+        if (ticket.status === 'open' && ticket.triage === 'wontfix')
+            declined.add(ticket.handle);
+        for (const ref of ticket.collapsedRefs)
+            collapsed.add(ref);
+        if (isStaleClaim(ticket))
+            stale.add(`${ticket.handle} (${ticket.claimedBy ?? '?'})`);
+    }
+    if (dangling.size > 0) {
+        warnings.push(`dangling Edges (${String(dangling.size)}), pointing at no Ticket in this workspace: ` +
+            [...dangling].toSorted().join(' '));
+    }
+    if (orphaned.size > 0) {
+        warnings.push(`blocked by a dropped Ticket, which never unblocks (${String(orphaned.size)}): ` +
+            [...orphaned].toSorted().join(' '));
+    }
+    if (unrecognized.size > 0) {
+        warnings.push(`unrecognized status, read as open (${String(unrecognized.size)}): ` +
+            [...unrecognized].toSorted().join(' '));
+    }
+    if (collapsed.size > 0) {
+        warnings.push(`sub-slice Edges coarsened to their parent Ticket (${String(collapsed.size)}): ` +
+            [...collapsed].toSorted().join(' '));
+    }
+    if (declined.size > 0) {
+        warnings.push(`takeable but triaged wontfix — somebody declined these (${String(declined.size)}): ` +
+            [...declined].toSorted().join(' '));
+    }
+    if (stale.size > 0) {
+        warnings.push(`stale claim, held longer than ${String(STALE_AFTER_HOURS)}h (${String(stale.size)}): ` +
+            `${[...stale].toSorted().join(' ')} — flagged only, never released; ask the holder`);
+    }
+    const legacy = board.tickets.filter(ticket => ticket.legacy);
+    if (legacy.length > 0) {
+        warnings.push(`${String(legacy.length)}/${String(board.tickets.length)} Tickets are Legacy — title, ` +
+            'status and Edges are inferred from prose. Run migrate_effort to normalize.');
+    }
+    // Tracked separately from Legacy, because normalizing a Legacy file gives it
+    // frontmatter without giving it an id. It would otherwise leave the Legacy
+    // count and take its need for migration silently with it, while still being
+    // unaddressable by anything but its handle.
+    const unidentified = board.tickets.filter(ticket => ticket.id === undefined);
+    if (unidentified.length > 0) {
+        warnings.push(`no id (${String(unidentified.length)}): ` +
+            `${unidentified.map(ticket => ticket.handle).join(' ')} — fetch by the handle shown; ` +
+            'nothing can declare an Edge on them until migrate_effort mints one.');
+    }
+    return warnings;
+}
+//# sourceMappingURL=get-board.js.map

package/dist/tools/get-board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-board.js","sourceRoot":"","sources":["../../src/tools/get-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAChG,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAC9B,gGAAgG;IAChG,sEAAsE,CAAC;AAWzE;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,GAA6B;IACpE,OAAO;QACL,MAAM;QACN,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC;QAC5D,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC;QACzB,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;KACrB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEzC,6EAA6E;IAC7E,4EAA4E;IAC5E,sDAAsD;IACtD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;SACzF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CACR,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,wCAAwC;QAC1C,CAAC,CAAC,aAAa,QAAQ,CAAC,MAAM,WAAW,EAC3C,EAAE,CACH,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;GAIG;AACH,SAAS,YAAY,CAAC,MAAqB;IACzC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEhF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACjE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,OAAO,GAAG,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB,EAAE,KAAY;IACrD,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,MAAM;QACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAClB,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE;QACjC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE;QACnE,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACrF,CAAC,CAAC,SAAS;QACb,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAC/E,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QACxF,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;KACpF,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAErC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,EAAU,EAAE,IAAmB,EAAE,KAAY;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,GAAG,EAAE,GAAG,CAAC;IAE3C,OAAO,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;AACzE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,KAAY;IACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBACzC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC5C,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,wEAAwE;QACxE,2EAA2E;QAC3E,+BAA+B;QAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa;YAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,mBAAmB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,8CAA8C;YACpF,CAAC,GAAG,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,sDAAsD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK;YAC9E,CAAC,GAAG,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CACX,sCAAsC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK;YAClE,CAAC,GAAG,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACzC,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,qDAAqD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK;YAC9E,CAAC,GAAG,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACtC,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,2DAA2D,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK;YACnF,CAAC,GAAG,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CACX,iCAAiC,MAAM,CAAC,iBAAiB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;YACrF,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,iDAAiD,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,+BAA+B;YACrF,4EAA4E,CAC/E,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,4EAA4E;IAC5E,4CAA4C;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAC7E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CACX,UAAU,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK;YACxC,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC;YACtF,qEAAqE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/get-tickets.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { Ticket } from '../domain.ts';
+export declare const getTicketsInputSchema: {
+    ids: z.ZodArray<z.ZodString>;
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const getTicketsDescription: string;
+/**
+ * Bodies verbatim, under a header carrying the fields a reader needs in hand
+ * while reading one. Ids that resolve to nothing are named rather than dropped,
+ * so a typo does not look like an empty Ticket.
+ */
+export declare function renderTickets(requested: readonly string[], found: readonly Ticket[]): string;
+//# sourceMappingURL=get-tickets.d.ts.map

package/dist/tools/get-tickets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tickets.d.ts","sourceRoot":"","sources":["../../src/tools/get-tickets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,qBAAqB;IAChC,GAAG;IAOH,IAAI;CACL,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAEJ,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAwB5F"}

package/dist/tools/get-tickets.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const getTicketsInputSchema = {
+    ids: z
+        .array(z.string())
+        .min(1)
+        .describe('Ticket ids, e.g. ["T12","T14"], resolved repo-wide. A Legacy Ticket with no id is ' +
+        'fetched by the <effort>#<order> handle its Board line shows.'),
+    root: z.string().optional().describe('Workspace directory. Defaults to the session workspace.'),
+};
+export const getTicketsDescription = 'Full bodies for a list of Ticket ids, in one call. Use after get_board, only for the ' +
+    'Tickets you actually work.';
+/**
+ * Bodies verbatim, under a header carrying the fields a reader needs in hand
+ * while reading one. Ids that resolve to nothing are named rather than dropped,
+ * so a typo does not look like an empty Ticket.
+ */
+export function renderTickets(requested, found) {
+    // Addressable by id when it has one, and by its handle either way — an
+    // id-less Legacy Ticket has no other route to its own body.
+    const byName = new Map();
+    for (const ticket of found) {
+        byName.set(ticket.handle, ticket);
+        if (ticket.id !== undefined)
+            byName.set(ticket.id, ticket);
+    }
+    const blocks = [];
+    const missing = [];
+    for (const name of requested) {
+        const ticket = byName.get(name);
+        if (ticket === undefined) {
+            missing.push(name);
+            continue;
+        }
+        blocks.push(renderOne(ticket));
+    }
+    if (missing.length > 0)
+        blocks.push(`not found: ${missing.join(' ')}`);
+    return blocks.join('\n\n---\n\n');
+}
+function renderOne(ticket) {
+    const fields = [
+        `effort=${ticket.effort}`,
+        `kind=${ticket.kind}`,
+        ticket.type === undefined ? undefined : `type=${ticket.type}`,
+        `status=${ticket.status}`,
+        ticket.triage === undefined ? undefined : `triage=${ticket.triage}`,
+        ticket.blockedBy.length > 0 ? `blocked_by=${ticket.blockedBy.join(',')}` : undefined,
+        ticket.claimedBy === undefined ? undefined : `claimed_by=${ticket.claimedBy}`,
+        ticket.claimedAt === undefined ? undefined : `claimed_at=${ticket.claimedAt}`,
+        ticket.answerGist === undefined ? undefined : `answer_gist=${ticket.answerGist}`,
+        ticket.droppedReason === undefined ? undefined : `dropped_reason=${ticket.droppedReason}`,
+        ticket.legacy ? 'legacy' : undefined,
+    ].filter(field => field !== undefined);
+    return `# ${ticket.handle} — ${ticket.title}\n${fields.join('  ')}\n\n${ticket.body}`;
+}
+//# sourceMappingURL=get-tickets.js.map

package/dist/tools/get-tickets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tickets.js","sourceRoot":"","sources":["../../src/tools/get-tickets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,oFAAoF;QAClF,8DAA8D,CACjE;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAChG,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAChC,uFAAuF;IACvF,4BAA4B,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAA4B,EAAE,KAAwB;IAClF,uEAAuE;IACvE,4DAA4D;IAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEvE,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,MAAM,GAAG;QACb,UAAU,MAAM,CAAC,MAAM,EAAE;QACzB,QAAQ,MAAM,CAAC,IAAI,EAAE;QACrB,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE;QAC7D,UAAU,MAAM,CAAC,MAAM,EAAE;QACzB,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE;QACnE,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QACpF,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,SAAS,EAAE;QAC7E,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,SAAS,EAAE;QAC7E,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE;QAChF,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,aAAa,EAAE;QACzF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAEvC,OAAO,KAAK,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/tools/list-efforts.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { Effort, TicketSummary } from '../domain.ts';
+/**
+ * `root` is the per-call workspace override. It is the only argument, and it is
+ * optional, because the workspace normally resolves from the session itself.
+ */
+export declare const listEffortsInputSchema: {
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const listEffortsDescription = "List the Efforts in a repo, each with its Ticket count and which header docs it holds.";
+/**
+ * One line per Effort, preceded by the workspace that produced them so that a
+ * caller can tell which repo it just read.
+ */
+export declare function renderEfforts(root: string, efforts: readonly Effort[], frontier: ReadonlySet<TicketSummary>): string;
+//# sourceMappingURL=list-efforts.d.ts.map

package/dist/tools/list-efforts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-efforts.d.ts","sourceRoot":"","sources":["../../src/tools/list-efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IACjC,IAAI;CAML,CAAC;AAEF,eAAO,MAAM,sBAAsB,2FACuD,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,GACnC,MAAM,CAiBR"}

package/dist/tools/list-efforts.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+/**
+ * `root` is the per-call workspace override. It is the only argument, and it is
+ * optional, because the workspace normally resolves from the session itself.
+ */
+export const listEffortsInputSchema = {
+    root: z
+        .string()
+        .optional()
+        .describe('Workspace directory. Defaults to $FRONTIER_ROOT, then the session working directory.'),
+};
+export const listEffortsDescription = 'List the Efforts in a repo, each with its Ticket count and which header docs it holds.';
+/**
+ * One line per Effort, preceded by the workspace that produced them so that a
+ * caller can tell which repo it just read.
+ */
+export function renderEfforts(root, efforts, frontier) {
+    const lines = [`root: ${root}`];
+    if (efforts.length === 0) {
+        lines.push('(no efforts)');
+    }
+    else {
+        const takeable = countByEffort(frontier);
+        for (const effort of efforts) {
+            const docs = effort.headerDocs.length === 0 ? 'none' : effort.headerDocs.join(',');
+            const size = takeable.get(effort.slug) ?? 0;
+            lines.push(`${effort.slug}  tickets=${effort.ticketCount}  docs=${docs}  frontier=${String(size)}`);
+        }
+    }
+    return lines.join('\n');
+}
+function countByEffort(frontier) {
+    const counts = new Map();
+    for (const ticket of frontier)
+        counts.set(ticket.effort, (counts.get(ticket.effort) ?? 0) + 1);
+    return counts;
+}
+//# sourceMappingURL=list-efforts.js.map

package/dist/tools/list-efforts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-efforts.js","sourceRoot":"","sources":["../../src/tools/list-efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sFAAsF,CACvF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GACjC,wFAAwF,CAAC;AAE3F;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAA0B,EAC1B,QAAoC;IAEpC,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,WAAW,UAAU,IAAI,cAAc,MAAM,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,QAAoC;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE/F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/migrate-effort.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { MigrationReport } from '../domain.ts';
+export declare const migrateEffortInputSchema: {
+    effort: z.ZodString;
+    preview: z.ZodOptional<z.ZodBoolean>;
+    rename: z.ZodOptional<z.ZodBoolean>;
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const migrateEffortDescription: string;
+export declare function renderMigration(report: MigrationReport): string;
+//# sourceMappingURL=migrate-effort.d.ts.map

package/dist/tools/migrate-effort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-effort.d.ts","sourceRoot":"","sources":["../../src/tools/migrate-effort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,eAAO,MAAM,wBAAwB;IACnC,MAAM;IACN,OAAO;IAIP,MAAM;IAMN,IAAI;CACL,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAGoD,CAAC;AAE1F,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAkB/D"}

package/dist/tools/migrate-effort.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export const migrateEffortInputSchema = {
+    effort: z.string().describe('Effort slug whose Legacy Tickets to normalize.'),
+    preview: z
+        .boolean()
+        .optional()
+        .describe('Report every change and write nothing. Defaults to false.'),
+    rename: z
+        .boolean()
+        .optional()
+        .describe('Rename files to <NN>-T<n>-<slug>.md. Off by default so relative links keep resolving.'),
+    root: z.string().optional().describe('Workspace directory. Defaults to the session workspace.'),
+};
+export const migrateEffortDescription = 'Normalize Legacy Tickets in an Effort: schema frontmatter, preserve existing ids, mint ' +
+    'ids for Tickets that have none, turn prose Edges into blocked_by. Preview writes nothing. ' +
+    'Filename rewriting is opt-in. Unrecognized files in the Effort directory are ignored.';
+export function renderMigration(report) {
+    const count = report.changes.length;
+    const verb = report.preview ? 'would migrate' : 'migrated';
+    const rename = report.renamed ? ' (renamed)' : '';
+    const lines = [
+        `${report.effort}: ${report.preview ? 'preview — ' : ''}${verb} ${String(count)}${rename}`,
+    ];
+    if (count === 0) {
+        lines.push('(nothing to migrate)');
+        return lines.join('\n');
+    }
+    for (const change of report.changes) {
+        lines.push(renderChange(change));
+    }
+    return lines.join('\n');
+}
+function renderChange(change) {
+    const flags = [
+        change.normalized ? 'normalize' : undefined,
+        change.minted ? 'mint' : undefined,
+    ].filter(part => part !== undefined);
+    const rename = change.fromName !== undefined && change.toName !== undefined
+        ? `${change.fromName} -> ${change.toName}`
+        : undefined;
+    const was = change.minted && change.beforeHandle !== change.id ? `was ${change.beforeHandle}` : undefined;
+    const edges = change.blockedBy.length === 0 ? undefined : `blocked_by=${change.blockedBy.join(',')}`;
+    return [
+        change.id,
+        change.title,
+        flags.length === 0 ? undefined : flags.join('+'),
+        was,
+        rename,
+        edges,
+    ]
+        .filter(part => part !== undefined)
+        .join('  ');
+}
+//# sourceMappingURL=migrate-effort.js.map

package/dist/tools/migrate-effort.js.map

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

package/dist/tools/spec.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { SpecDocument } from '../domain.ts';
+export declare const specInputSchema: {
+    effort: z.ZodString;
+    create: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodOptional<z.ZodString>;
+    expected_revision: z.ZodOptional<z.ZodString>;
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const specDescription: string;
+export declare function renderSpec(effort: string, document: SpecDocument): string;
+//# sourceMappingURL=spec.d.ts.map

package/dist/tools/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/tools/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAO,MAAM,eAAe;IAC1B,MAAM;IACN,MAAM;IAIN,OAAO;IAOP,iBAAiB;IAQjB,IAAI;CACL,CAAC;AAEF,eAAO,MAAM,eAAe,QAGuE,CAAC;AAEpG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEzE"}

package/dist/tools/spec.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export const specInputSchema = {
+    effort: z.string().describe('Effort slug whose Spec to get or put.'),
+    create: z
+        .boolean()
+        .optional()
+        .describe('Start the Effort and its Spec if neither exists. Otherwise an unknown slug fails.'),
+    content: z
+        .string()
+        .optional()
+        .describe('When set, replace the Spec wholesale (conventionally a document with YAML frontmatter). ' +
+        'When omitted, return the current document.'),
+    expected_revision: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Revision from a prior spec read. Required when overwriting an existing Spec; ' +
+        'omitted when creating one.'),
+    root: z.string().optional().describe('Workspace directory. Defaults to the session workspace.'),
+};
+export const specDescription = 'Get or put a Spec as a whole opaque document (conventionally with YAML frontmatter). ' +
+    'Nothing edits a Spec section by section — an Effort may hold both a Map and a Spec. ' +
+    'Puts pass expected_revision from a prior read so concurrent sessions cannot clobber each other.';
+export function renderSpec(effort, document) {
+    return [`effort: ${effort}`, `spec revision: ${document.revision}`, '', document.body].join('\n');
+}
+//# sourceMappingURL=spec.js.map

package/dist/tools/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/tools/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACpE,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAChG,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0FAA0F;QACxF,4CAA4C,CAC/C;IACH,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E;QAC7E,4BAA4B,CAC/B;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAChG,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAC1B,uFAAuF;IACvF,sFAAsF;IACtF,iGAAiG,CAAC;AAEpG,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,QAAsB;IAC/D,OAAO,CAAC,WAAW,MAAM,EAAE,EAAE,kBAAkB,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC"}

package/dist/tools/update-ticket.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import type { Ticket, TicketEdit } from '../domain.ts';
+import type { TriageRole } from '../domain.ts';
+export declare const updateTicketInputSchema: {
+    id: z.ZodString;
+    claim: z.ZodOptional<z.ZodObject<{
+        by: z.ZodString;
+    }, z.core.$strip>>;
+    resolve: z.ZodOptional<z.ZodObject<{
+        answer_gist: z.ZodString;
+        answer: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    drop: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        claimed: "claimed";
+        dropped: "dropped";
+        open: "open";
+        resolved: "resolved";
+    }>>;
+    triage: z.ZodOptional<z.ZodEnum<{
+        "needs-info": "needs-info";
+        "needs-triage": "needs-triage";
+        "ready-for-agent": "ready-for-agent";
+        "ready-for-human": "ready-for-human";
+        wontfix: "wontfix";
+    }>>;
+    blocked_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    comment: z.ZodOptional<z.ZodString>;
+    tick: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    root: z.ZodOptional<z.ZodString>;
+};
+export declare const updateTicketDescription: string;
+export interface UpdateRequest {
+    readonly claim?: {
+        by: string;
+    } | undefined;
+    readonly resolve?: {
+        answer_gist: string;
+        answer?: string | undefined;
+    } | undefined;
+    readonly drop?: {
+        reason: string;
+    } | undefined;
+    readonly triage?: TriageRole | undefined;
+    readonly status?: string | undefined;
+    readonly blocked_by?: readonly string[] | undefined;
+    readonly comment?: string | undefined;
+    readonly tick?: readonly string[] | undefined;
+}
+/**
+ * Turn a request into the edit the driver applies, refusing anything the Status
+ * model or the Edge graph does not allow. Validation lives here rather than in
+ * the driver because it is a rule about the domain, not about storage.
+ *
+ * `all` is every Ticket in the workspace, because Edges resolve repo-wide and a
+ * cycle can run through an Effort this call never names.
+ */
+export declare function editFor(ticket: Ticket, all: readonly Ticket[], request: UpdateRequest, now: string): TicketEdit;
+export declare function renderUpdate(ticket: Ticket, warnings?: readonly string[]): string;
+//# sourceMappingURL=update-ticket.d.ts.map

package/dist/tools/update-ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-ticket.d.ts","sourceRoot":"","sources":["../../src/tools/update-ticket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,eAAO,MAAM,uBAAuB;IAClC,EAAE;IACF,KAAK;;;IAIL,OAAO;;;;IAOP,IAAI;;;IAIJ,MAAM;;;;;;IAIN,MAAM;;;;;;;IAIN,UAAU;IAOV,OAAO;IAKP,IAAI;IAQJ,IAAI;CACL,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAIuC,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,GACV,UAAU,CA+DZ;AAsDD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAYrF"}