light-plan 0.0.0-stage → 0.1.0

package/dist/mcp/index.d.ts

@@ -0,0 +1,49 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardPaths } from '../core/index.js';
+/**
+ * light-plan as an MCP server, so an agent can use the board the way a person
+ * does.
+ *
+ * The tools mirror the CLI rather than exposing the engine directly: an agent
+ * that splits a story gets the same rewiring a person dragging nodes gets,
+ * because both go through the planners in `src/shared` and the replay in
+ * `src/sync`. That is what lets a planning agent, a working agent and a human
+ * share one board without any of them seeing a structure the others would not
+ * recognise.
+ *
+ *   read/       what is on the board
+ *   plan/       structuring it
+ *   templates/  the reusable pieces of plan somebody already worked out
+ *   work/       picking work up, recording how it went
+ *   remote/     the tracker the board mirrors: status and preview always,
+ *               the gated sync under `--allow-remote`
+ *
+ * Identity is per session (`--user`), never written to `.lpm/local.json`, so a
+ * dozen agents can work one checkout without overwriting each other's answer to
+ * "who am I". `--profile` is the same promise for "what is mine": it narrows
+ * what the listing and recommendation tools offer, and never what an id can
+ * reach — an agent handed a dependency it cannot read would be worse off than
+ * one shown work it should leave alone.
+ */
+export declare const MCP_SERVER_NAME = "light-plan";
+export interface McpOptions {
+    /** The resource this session acts as: an id or a name. */
+    user?: string | null;
+    /**
+     * A profile file for this session: who the agent is, and which part of the
+     * board it is offered. Per session, like `user` and for the same reason.
+     */
+    profile?: string | null;
+    /** Register only the tools that do not write. */
+    readOnly?: boolean;
+    /**
+     * Register `remote_sync`, the one tool that writes to a tracker outside the
+     * checkout. Off by default, and independent of `readOnly`: a read-only
+     * server never registers it, even with this flag.
+     */
+    allowRemote?: boolean;
+    version?: string;
+}
+export declare function createMcpServer(paths: BoardPaths, options?: McpOptions): McpServer;
+/** Serve over stdio, which is how an agent host launches this. */
+export declare function startMcpServer(paths: BoardPaths, options?: McpOptions): Promise<void>;

package/dist/mcp/index.js

@@ -0,0 +1,90 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { BoardContext } from './context.js';
+import { registerPlanTools } from './tools/plan.js';
+import { registerReadTools } from './tools/read.js';
+import { registerRemoteTools } from './tools/remote.js';
+import { registerTemplateTools } from './tools/templates.js';
+import { registerWorkTools } from './tools/work.js';
+/**
+ * light-plan as an MCP server, so an agent can use the board the way a person
+ * does.
+ *
+ * The tools mirror the CLI rather than exposing the engine directly: an agent
+ * that splits a story gets the same rewiring a person dragging nodes gets,
+ * because both go through the planners in `src/shared` and the replay in
+ * `src/sync`. That is what lets a planning agent, a working agent and a human
+ * share one board without any of them seeing a structure the others would not
+ * recognise.
+ *
+ *   read/       what is on the board
+ *   plan/       structuring it
+ *   templates/  the reusable pieces of plan somebody already worked out
+ *   work/       picking work up, recording how it went
+ *   remote/     the tracker the board mirrors: status and preview always,
+ *               the gated sync under `--allow-remote`
+ *
+ * Identity is per session (`--user`), never written to `.lpm/local.json`, so a
+ * dozen agents can work one checkout without overwriting each other's answer to
+ * "who am I". `--profile` is the same promise for "what is mine": it narrows
+ * what the listing and recommendation tools offer, and never what an id can
+ * reach — an agent handed a dependency it cannot read would be worse off than
+ * one shown work it should leave alone.
+ */
+export const MCP_SERVER_NAME = 'light-plan';
+export function createMcpServer(paths, options = {}) {
+    const context = new BoardContext(paths, {
+        user: options.user ?? null,
+        profile: options.profile ?? null,
+        readOnly: options.readOnly === true,
+        allowRemote: options.allowRemote === true,
+    });
+    const server = new McpServer({ name: MCP_SERVER_NAME, version: options.version ?? '0.1.0' }, {
+        instructions: 'This is a light-plan board: a file-based issue tracker where the plan lives in a ' +
+            '.lpm folder as markdown, versioned with git.\n\n' +
+            'Call board_overview first. Boards define their own document types, hierarchy and ' +
+            'statuses, and every other tool speaks in those names — do not assume "epic" or ' +
+            '"done" exist until you have seen them.\n\n' +
+            'Three collections: issues (what gets built, nested by scope), periods (when — ' +
+            'sprints and increments) and resources (who — people and the generic pools work can ' +
+            'wait in). An issue at any level can be scheduled into any period and assigned to ' +
+            'any resource.\n\n' +
+            'Before you write anything, call list_templates. The registry holds reusable pieces of ' +
+            'plan this team has already worked out — a feature with its standard stories, the steps ' +
+            'a particular kind of change has to go through. If one covers what you are about to ' +
+            'create, instantiate_template is both faster and the process they agreed on; creating ' +
+            'the same thing by hand quietly skips it.\n\n' +
+            'To plan: create documents, link them with link_issues, and reshape with split_issue, ' +
+            'insert_between, convert_document and copy_documents — those keep the dependency ' +
+            'graph wired up for you, so prefer them to editing edges by hand.\n\n' +
+            'To do the work: next_tasks, start_task, then add_comment as you go and finish_task ' +
+            'when it is done. Comments are the trail you leave for whoever picks the issue up ' +
+            'next, human or agent — say what you tried and what you found, not just that you ' +
+            'finished.\n\n' +
+            'If this board mirrors a remote tracker, remote_status reports the drift between the ' +
+            'two and remote_preview shows what a sync would do without doing it — both are safe. ' +
+            'remote_sync is the only tool that writes to a system outside this checkout; it is ' +
+            'registered only when the server was started with --allow-remote, and it acts as the ' +
+            "board's tracker account, not yours.",
+    });
+    registerReadTools(server, context);
+    registerWorkTools(server, context);
+    // Reading the registry is free; instantiating writes, so `guard` and
+    // `context.run` refuse it on a read-only server the way every other write is
+    // refused. Registering the read tools either way is what keeps "check the
+    // registry first" true for an agent that cannot change anything.
+    registerTemplateTools(server, context);
+    if (!context.readOnly)
+        registerPlanTools(server, context);
+    // The remote tools register themselves with the one gate: `remote_status` and
+    // `remote_preview` always, `remote_sync` only under `--allow-remote` (and
+    // never on a read-only server).
+    registerRemoteTools(server, context);
+    return server;
+}
+/** Serve over stdio, which is how an agent host launches this. */
+export async function startMcpServer(paths, options = {}) {
+    const server = createMcpServer(paths, options);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAqB5C,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,UAAsB,EAAE;IACzE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE;QACtC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI;QACnC,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;KAC1C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,EAC9D;QACE,YAAY,EACV,mFAAmF;YACnF,kDAAkD;YAClD,mFAAmF;YACnF,iFAAiF;YACjF,4CAA4C;YAC5C,gFAAgF;YAChF,qFAAqF;YACrF,mFAAmF;YACnF,mBAAmB;YACnB,wFAAwF;YACxF,yFAAyF;YACzF,qFAAqF;YACrF,uFAAuF;YACvF,8CAA8C;YAC9C,uFAAuF;YACvF,kFAAkF;YAClF,sEAAsE;YACtE,qFAAqF;YACrF,mFAAmF;YACnF,kFAAkF;YAClF,eAAe;YACf,sFAAsF;YACtF,sFAAsF;YACtF,oFAAoF;YACpF,sFAAsF;YACtF,qCAAqC;KACxC,CACF,CAAC;IAEF,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qEAAqE;IACrE,6EAA6E;IAC7E,0EAA0E;IAC1E,iEAAiE;IACjE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,8EAA8E;IAC9E,0EAA0E;IAC1E,gCAAgC;IAChC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB,EAAE,UAAsB,EAAE;IAC9E,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/mcp/reply.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What a tool hands back.
+ *
+ * Every result is text, and data results are compact JSON inside it. That is
+ * the shape every MCP client understands, and an agent reads JSON perfectly
+ * well — declaring an output schema per tool would double the size of this
+ * server for no gain the model can use.
+ */
+export interface ToolReply {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export declare function text(message: string): ToolReply;
+export declare function json(value: unknown): ToolReply;
+/**
+ * Report a refusal to the model rather than throwing.
+ *
+ * A `BoardError` is the engine explaining what is wrong and often how to fix
+ * it, which is exactly what an agent needs to try again. Losing the hints in a
+ * transport-level error would leave it guessing.
+ */
+export declare function failure(error: unknown): ToolReply;
+/** Wrap a tool body so every failure comes back as a readable message. */
+export declare function guard<A>(run: (args: A) => ToolReply | Promise<ToolReply>): (args: A) => Promise<ToolReply>;

package/dist/mcp/reply.js

@@ -0,0 +1,34 @@
+import { BoardError } from '../core/index.js';
+export function text(message) {
+    return { content: [{ type: 'text', text: message }] };
+}
+export function json(value) {
+    return text(JSON.stringify(value, null, 2));
+}
+/**
+ * Report a refusal to the model rather than throwing.
+ *
+ * A `BoardError` is the engine explaining what is wrong and often how to fix
+ * it, which is exactly what an agent needs to try again. Losing the hints in a
+ * transport-level error would leave it guessing.
+ */
+export function failure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const details = error instanceof BoardError ? error.details : [];
+    return {
+        content: [{ type: 'text', text: [message, ...details].join('\n') }],
+        isError: true,
+    };
+}
+/** Wrap a tool body so every failure comes back as a readable message. */
+export function guard(run) {
+    return async (args) => {
+        try {
+            return await run(args);
+        }
+        catch (error) {
+            return failure(error);
+        }
+    };
+}
+//# sourceMappingURL=reply.js.map

package/dist/mcp/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../../src/mcp/reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgB9C,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,KAAK,CAAI,GAAgD;IACvE,OAAO,KAAK,EAAE,IAAO,EAAsB,EAAE;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/plan/create.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+export declare function registerCreateTools(server: McpServer, context: BoardContext): void;

package/dist/mcp/tools/plan/create.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+import { BoardError, findNode, moveNode, updateNode } from '../../../core/index.js';
+import { guard, json } from '../../reply.js';
+/** Shared by create_document and update_document. */
+const attributes = z
+    .record(z.string(), z.unknown())
+    .optional()
+    .describe('Attribute values, by the names board_overview lists for the type');
+export function registerCreateTools(server, context) {
+    server.registerTool('create_document', {
+        title: 'Create a document',
+        description: 'Add an issue, period or resource. The type decides where it goes: an issue type ' +
+            'lands in the board, a period type in the timeline, a resource type in the roster. ' +
+            'A type that is not top-level needs a parent of the type one level above it.',
+        inputSchema: {
+            type: z.string().describe('A type name from board_overview'),
+            title: z.string(),
+            parent: z.string().optional().describe('Parent document id'),
+            body: z.string().optional().describe("Markdown body; replaces the type's template"),
+            status: z.string().optional().describe('Issues only'),
+            assignee: z.string().optional().describe('Issues only; a resource id or name'),
+            period: z.string().optional().describe('Issues only; a period id'),
+            dependsOn: z.array(z.string()).optional().describe('Issues only; ids that block this'),
+            relatedFiles: z
+                .array(z.string())
+                .optional()
+                .describe('Issues only; files this issue is about — the requirement it came from, the ' +
+                'source that has to change. Paths from the project root, optionally with a ' +
+                'line range: "docs/prd.md#L10-L42". Write these when you know them: they are ' +
+                'the first thing whoever picks the issue up will open'),
+            starts: z.string().optional().describe('Periods only, YYYY-MM-DD'),
+            ends: z.string().optional().describe('Periods only, YYYY-MM-DD'),
+            capacity: z.number().optional().describe('Resources only; full-time equivalents'),
+            attributes,
+        },
+    }, guard((args) => {
+        const board = context.board();
+        const kind = context.view(board).config.types[args.type]?.kind ?? 'issue';
+        const { created } = context.run({
+            ok: true,
+            created: ['new:1'],
+            changes: [
+                {
+                    kind: 'create',
+                    id: 'new:1',
+                    nodeKind: kind,
+                    patch: {
+                        type: args.type,
+                        title: args.title,
+                        parentId: args.parent ?? null,
+                        body: args.body,
+                        status: args.status,
+                        assignee: args.assignee,
+                        period: args.period,
+                        dependsOn: args.dependsOn,
+                        relatedFiles: args.relatedFiles,
+                        starts: args.starts,
+                        ends: args.ends,
+                        capacity: args.capacity,
+                        attributes: args.attributes,
+                    },
+                },
+            ],
+        });
+        return json({ created: created[0], type: args.type, title: args.title });
+    }));
+    server.registerTool('update_document', {
+        title: 'Update a document',
+        description: "Edit a document's own content and where it sits: title, body, attributes, and for " +
+            'issues the status, assignee and period. Renaming moves its folder. Use ' +
+            '`convert_document` to change what a document *is*.',
+        inputSchema: {
+            id: z.string(),
+            title: z.string().optional(),
+            body: z.string().optional(),
+            status: z.string().optional().describe('Issues only'),
+            assignee: z.string().nullable().optional().describe('Issues only; null to unassign'),
+            period: z.string().nullable().optional().describe('Issues only; null to unschedule'),
+            relatedFiles: z
+                .array(z.string())
+                .optional()
+                .describe('Issues only; replaces the whole list of files this issue is about. Pass the ' +
+                'existing entries plus the new ones — `get_document` returns them'),
+            starts: z.string().optional().describe('Periods only'),
+            ends: z.string().optional().describe('Periods only'),
+            active: z
+                .boolean()
+                .nullable()
+                .optional()
+                .describe('Periods only: run it whatever the dates say (true), park it (false), or ' +
+                'hand it back to its dates (null). Use `start_period` to move the dates.'),
+            capacity: z.number().optional().describe('Resources only'),
+            attributes,
+        },
+    }, guard((args) => {
+        context.assertWritable();
+        const board = context.board();
+        const node = findNode(board, args.id);
+        if (!node)
+            throw new BoardError(`No document with id "${args.id}"`);
+        // Where a document sits is `move`; what it holds is `update`. Doing both
+        // needs the second to run against the board the first left behind.
+        let rolledUp = [];
+        if (args.status !== undefined || args.assignee !== undefined || args.period !== undefined) {
+            const moved = moveNode(board, node, {
+                status: args.status,
+                assignee: args.assignee,
+                period: args.period,
+            });
+            // A status carries the containers above it; say which ones moved.
+            rolledUp = moved.rollups.map((rollup) => ({ id: rollup.issue.id, status: rollup.to }));
+        }
+        const fresh = context.board();
+        const target = findNode(fresh, args.id);
+        const result = updateNode(fresh, target, {
+            title: args.title,
+            body: args.body,
+            attributes: args.attributes,
+            relatedFiles: args.relatedFiles,
+            starts: args.starts,
+            ends: args.ends,
+            active: args.active,
+            capacity: args.capacity,
+        });
+        return json({ updated: result.node.id, title: result.node.title, rolledUp });
+    }));
+}
+//# sourceMappingURL=create.js.map

package/dist/mcp/tools/plan/create.js.map

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

package/dist/mcp/tools/plan/delete.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+export declare function registerDeleteTools(server: McpServer, context: BoardContext): void;

package/dist/mcp/tools/plan/delete.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { BoardError, findNode, nodesOf, subtreeOf } from '../../../core/index.js';
+import { removeNode } from '../../../core/index.js';
+import { guard, json } from '../../reply.js';
+export function registerDeleteTools(server, context) {
+    server.registerTool('delete_document', {
+        title: 'Delete a document',
+        description: 'Remove a document and everything nested under it. Anything that pointed at it is ' +
+            'rewritten, so the board is left valid. Deleting something with children requires ' +
+            '`recursive`, because it is rarely what a typo means.',
+        inputSchema: {
+            id: z.string(),
+            recursive: z.boolean().default(false),
+            dryRun: z.boolean().default(false),
+        },
+        annotations: { destructiveHint: true },
+    }, guard((args) => {
+        context.assertWritable();
+        const board = context.board();
+        const node = findNode(board, args.id);
+        if (!node)
+            throw new BoardError(`No document with id "${args.id}"`);
+        const doomed = subtreeOf(nodesOf(board, node.kind), node);
+        if (doomed.length > 1 && !args.recursive && !args.dryRun) {
+            throw new BoardError(`${node.id} has ${doomed.length - 1} descendant(s)`, [
+                'Pass recursive: true to delete them all, or dryRun: true to list them.',
+            ]);
+        }
+        if (args.dryRun)
+            return json({ wouldDelete: doomed.map((entry) => entry.id) });
+        const result = removeNode(board, node);
+        return json({ deleted: result.removed, rewritten: result.detached });
+    }));
+}
+//# sourceMappingURL=delete.js.map

package/dist/mcp/tools/plan/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../src/mcp/tools/plan/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAqB;IAC1E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,mFAAmF;YACnF,mFAAmF;YACnF,sDAAsD;QACxD,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YACrC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,wBAAwB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzD,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,GAAG,CAAC,gBAAgB,EAAE;gBACxE,wEAAwE;aACzE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/plan/graph.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+export declare function registerGraphTools(server: McpServer, context: BoardContext): void;

package/dist/mcp/tools/plan/graph.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { planDuplicate, planInsert } from '../../../shared/index.js';
+import { guard, json } from '../../reply.js';
+export function registerGraphTools(server, context) {
+    server.registerTool('insert_between', {
+        title: 'Insert an issue into a dependency',
+        description: 'Put an issue in the middle of an existing dependency: source -> target becomes ' +
+            'source -> middle -> target, replacing the original edge. Either move an existing ' +
+            'issue in with `issue`, or leave it out to create one at the upstream issue\'s level.',
+        inputSchema: {
+            source: z.string().describe('The upstream issue'),
+            target: z.string().describe('The downstream issue, which depends on source'),
+            issue: z.string().optional().describe('Move this existing issue in'),
+            type: z.string().optional().describe('Otherwise create one of this type'),
+            title: z.string().optional(),
+        },
+    }, guard((args) => {
+        const plan = planInsert(context.view(), context.ids(), {
+            source: args.source,
+            target: args.target,
+            issueId: args.issue,
+            type: args.type,
+            title: args.title,
+        });
+        const { created } = context.run(plan);
+        return json({
+            inserted: created[0] ?? args.issue,
+            between: [args.source, args.target],
+        });
+    }));
+    server.registerTool('copy_documents', {
+        title: 'Duplicate documents',
+        description: 'Copy documents and everything nested under them. Dependencies between the copied ' +
+            'documents are kept and repointed at the copies; those leaving the selection are ' +
+            'dropped, so the duplicate stands on its own.',
+        inputSchema: {
+            ids: z.array(z.string()).min(1),
+            under: z.string().nullable().optional().describe('Put the copies here instead'),
+        },
+    }, guard((args) => {
+        const plan = planDuplicate(context.view(), context.ids(), args.ids);
+        if (plan.ok && args.under !== undefined) {
+            const roots = new Set(plan.created.slice(0, args.ids.length));
+            for (const change of plan.changes) {
+                if (change.kind === 'create' && roots.has(change.id))
+                    change.patch.parentId = args.under;
+            }
+        }
+        const { created } = context.run(plan);
+        return json({ copied: args.ids, created });
+    }));
+}
+//# sourceMappingURL=graph.js.map

package/dist/mcp/tools/plan/graph.js.map

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

package/dist/mcp/tools/plan/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Planning tools that reshape the board.
+ *
+ * The ten tools registered here are the surface an agent (or CLI `lpm mcp`) uses
+ * to lay work out. Each tool's description is a prompt for a model that has
+ * never seen this board. The multi-step ones — split, insert, copy, convert —
+ * go through the same planners (`src/shared/plans/`) the web UI and CLI use, so
+ * an agent reshaping a graph gets the same rewiring a person gets by dragging
+ * nodes around.
+ *
+ * Split by tool family into focused modules so no single file exceeds ~250 lines.
+ * The only shared resource is the `attributes` zod schema, created once and
+ * passed down.
+ */
+export { registerPlanTools } from './registrar.js';

package/dist/mcp/tools/plan/index.js

@@ -0,0 +1,16 @@
+/**
+ * Planning tools that reshape the board.
+ *
+ * The ten tools registered here are the surface an agent (or CLI `lpm mcp`) uses
+ * to lay work out. Each tool's description is a prompt for a model that has
+ * never seen this board. The multi-step ones — split, insert, copy, convert —
+ * go through the same planners (`src/shared/plans/`) the web UI and CLI use, so
+ * an agent reshaping a graph gets the same rewiring a person gets by dragging
+ * nodes around.
+ *
+ * Split by tool family into focused modules so no single file exceeds ~250 lines.
+ * The only shared resource is the `attributes` zod schema, created once and
+ * passed down.
+ */
+export { registerPlanTools } from './registrar.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tools/plan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/tools/plan/link.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+export declare function registerLinkTools(server: McpServer, context: BoardContext): void;

package/dist/mcp/tools/plan/link.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { BoardError, findIssue, linkIssue, rollupsForEdges } from '../../../core/index.js';
+import { guard, json } from '../../reply.js';
+export function registerLinkTools(server, context) {
+    server.registerTool('link_issues', {
+        title: 'Add or remove a dependency',
+        description: 'Record that one issue blocks another, or take that back. Only the forward edge is ' +
+            'stored; a dependency that would close a cycle is refused. Write the dependency ' +
+            'between the two pieces of work that actually have it: the containers above them are ' +
+            'put in the same order automatically, up to the container they share, and `alsoOrders` ' +
+            'reports which ones. Adding that edge to the containers yourself would stop every ' +
+            'other piece of work inside them.',
+        inputSchema: {
+            blocked: z.string().describe('The issue that has to wait'),
+            blockedBy: z.array(z.string()).min(1).describe('The issues it waits for'),
+            remove: z.boolean().default(false),
+        },
+    }, guard((args) => {
+        context.assertWritable();
+        const board = context.board();
+        const issue = findIssue(board, args.blocked);
+        if (!issue)
+            throw new BoardError(`No issue with id "${args.blocked}"`);
+        const result = linkIssue(board, issue, {
+            dependsOn: args.blockedBy,
+            remove: args.remove,
+        });
+        // Read off the same handle the write went through, which is stale by
+        // then — that is what `rollupsForEdges` expects.
+        const rolled = rollupsForEdges(board, result.addedDependsOn.map((target) => ({ from: issue.id, to: target })));
+        return json({
+            issue: result.issue.id,
+            dependsOn: result.issue.depends_on,
+            added: result.addedDependsOn,
+            removed: result.removedDependsOn,
+            // The containers this dependency now stands behind each other. Nothing
+            // is written on them; the board reads it off the work inside them.
+            alsoOrders: rolled.map((entry) => ({
+                issue: entry.from,
+                waitsOn: entry.to,
+                because: { blocked: entry.source, blockedBy: entry.target },
+            })),
+        });
+    }));
+}
+//# sourceMappingURL=link.js.map

package/dist/mcp/tools/plan/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../../src/mcp/tools/plan/link.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAqB;IACxE,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,oFAAoF;YACpF,iFAAiF;YACjF,sFAAsF;YACtF,wFAAwF;YACxF,mFAAmF;YACnF,kCAAkC;QACpC,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC1D,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YACzE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC;KACF,EACD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,qEAAqE;QACrE,iDAAiD;QACjD,MAAM,MAAM,GAAG,eAAe,CAC5B,KAAK,EACL,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CACxE,CAAC;QACF,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;YACtB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;YAClC,KAAK,EAAE,MAAM,CAAC,cAAc;YAC5B,OAAO,EAAE,MAAM,CAAC,gBAAgB;YAChC,uEAAuE;YACvE,mEAAmE;YACnE,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACjC,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;aAC5D,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/plan/registrar.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+/**
+ * Structuring the board: the tools a planning agent uses to lay work out.
+ *
+ * The multi-step ones — split, insert, copy, convert — go through the same
+ * planners the web UI and `lpm` use, so an agent reshaping a graph gets exactly
+ * the rewiring a person would get by dragging nodes around.
+ */
+export declare function registerPlanTools(server: McpServer, context: BoardContext): void;

package/dist/mcp/tools/plan/registrar.js

@@ -0,0 +1,24 @@
+import { registerCreateTools } from './create.js';
+import { registerDeleteTools } from './delete.js';
+import { registerGraphTools } from './graph.js';
+import { registerLinkTools } from './link.js';
+import { registerReshapeTools } from './reshape.js';
+import { registerTimelineTools } from './timeline.js';
+import { registerUpstreamTools } from './upstream.js';
+/**
+ * Structuring the board: the tools a planning agent uses to lay work out.
+ *
+ * The multi-step ones — split, insert, copy, convert — go through the same
+ * planners the web UI and `lpm` use, so an agent reshaping a graph gets exactly
+ * the rewiring a person would get by dragging nodes around.
+ */
+export function registerPlanTools(server, context) {
+    registerCreateTools(server, context);
+    registerReshapeTools(server, context);
+    registerTimelineTools(server, context);
+    registerGraphTools(server, context);
+    registerDeleteTools(server, context);
+    registerLinkTools(server, context);
+    registerUpstreamTools(server, context);
+}
+//# sourceMappingURL=registrar.js.map

package/dist/mcp/tools/plan/registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrar.js","sourceRoot":"","sources":["../../../../src/mcp/tools/plan/registrar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAqB;IACxE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/mcp/tools/plan/reshape.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BoardContext } from '../../context.js';
+export declare function registerReshapeTools(server: McpServer, context: BoardContext): void;