light-plan 0.0.0-stage → 0.1.0

package/dist/core/validation/fix.js

@@ -0,0 +1,273 @@
+import { existsSync, readFileSync, renameSync } from 'node:fs';
+import path from 'node:path';
+import { DEFAULT_CAPACITY, isUnassigned, loadBoard } from '../board/load.js';
+import { nodesOf } from '../board/query.js';
+import { boardFlagRollups } from '../board/flag-rollup.js';
+import { boardRollups } from '../board/rollup.js';
+import { hierarchyFor, prefixFor, statusIds } from '../config/lookup.js';
+import { initialValueFor, isEmpty } from '../model/attributes.js';
+import { fileTimestamp, nowIso } from '../storage/document.js';
+import { gitFileCreationDate, gitIdentity } from '../storage/git.js';
+import { writeBoardIndex } from '../operations/board-index.js';
+import { boardWrite, writeDocument } from '../operations/shared.js';
+import { writeFlagRollups, writeRollups } from '../operations/rollup.js';
+import { ensureLocalIgnored } from '../storage/local.js';
+import { displayPath, nodeDirName } from '../storage/paths.js';
+import { allocateIds, counterFor, numberOf, readState, writeState } from '../storage/state.js';
+import { KINDS, RETIRED_LINK_FIELD, allNodes, at, retiredLink, typesOf } from './shared.js';
+/**
+ * Drop duplicates, keeping order. `self` is the id a list may not name — a link
+ * list cannot point at its own document. Lists that are not links (a file
+ * reference is text, not an id) pass nothing and only lose repeats.
+ */
+function dedupe(ids, self) {
+    const out = [];
+    for (const id of ids) {
+        if (id !== self && !out.includes(id))
+            out.push(id);
+    }
+    return { ids: out, changed: out.length !== ids.length };
+}
+/** The index as it stands, or null when there is none to compare against. */
+function readIndex(file) {
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function fixCollection(board, kind, actions) {
+    const nodes = nodesOf(board, kind);
+    if (!nodes.length)
+        return;
+    const { config, paths } = board;
+    const types = typesOf(board, kind);
+    const levels = hierarchyFor(config, kind);
+    const validStatuses = statusIds(config);
+    const unassigned = nodes.filter((node) => isUnassigned(node.id));
+    const taken = new Set(allNodes(board).map((node) => node.id));
+    const freshIds = unassigned.length
+        ? allocateIds(paths, counterFor(kind), prefixFor(config, kind), unassigned.length, taken)
+        : [];
+    const assignedId = new Map(unassigned.map((node, index) => [node.dir, freshIds[index]]));
+    let identity = null;
+    const author = () => (identity ??= gitIdentity(paths.lpmDir));
+    const renames = [];
+    for (const original of nodes) {
+        const where = at(board, original);
+        const changes = [];
+        const derived = board.derived.get(original.dir) ?? [];
+        const node = {
+            ...original,
+            attributes: { ...original.attributes },
+        };
+        if (isUnassigned(node.id)) {
+            node.id = assignedId.get(original.dir);
+            changes.push(`id=${node.id}`);
+        }
+        else if (derived.includes('id')) {
+            changes.push(`id=${node.id}`);
+        }
+        if (!node.type) {
+            const candidates = levels[node.depth] ?? [];
+            if (candidates.length === 1) {
+                node.type = candidates[0];
+                changes.push(`type=${node.type}`);
+            }
+        }
+        else if (derived.includes('type')) {
+            changes.push(`type=${node.type}`);
+        }
+        if (derived.includes('title'))
+            changes.push(`title="${node.title}"`);
+        if (node.kind === 'issue') {
+            if (!validStatuses.includes(node.status)) {
+                node.status = config.default_status;
+                changes.push(`status=${node.status}`);
+            }
+            else if (derived.includes('status')) {
+                changes.push(`status=${node.status}`);
+            }
+            // `informed_by` gated the queue exactly as `depends_on` does, so merging
+            // the ids in keeps the ordering the plan already recorded; the key itself
+            // then goes, and with it the second name for one relationship.
+            const retired = retiredLink(node);
+            if (retired) {
+                if (retired.length)
+                    node.depends_on = [...node.depends_on, ...retired];
+                delete node.attributes[RETIRED_LINK_FIELD];
+                changes.push(retired.length ? `${RETIRED_LINK_FIELD} -> depends_on` : `${RETIRED_LINK_FIELD} dropped`);
+            }
+            const depends = dedupe(node.depends_on, node.id);
+            if (depends.changed) {
+                node.depends_on = depends.ids;
+                changes.push('depends_on deduped');
+            }
+            const relates = dedupe(node.relates_to, node.id);
+            if (relates.changed) {
+                node.relates_to = relates.ids;
+                changes.push('relates_to deduped');
+            }
+            const files = dedupe(node.related_files);
+            if (files.changed) {
+                node.related_files = files.ids;
+                changes.push('related_files deduped');
+            }
+        }
+        if (node.kind === 'resource') {
+            if (derived.includes('capacity')) {
+                node.capacity = DEFAULT_CAPACITY;
+                changes.push(`capacity=${node.capacity}`);
+            }
+            const covers = dedupe(node.covers, node.id);
+            if (covers.changed) {
+                node.covers = covers.ids;
+                changes.push('covers deduped');
+            }
+        }
+        if (node.kind === 'template') {
+            const depends = dedupe(node.depends_on, node.id);
+            if (depends.changed) {
+                node.depends_on = depends.ids;
+                changes.push('depends_on deduped');
+            }
+            const relates = dedupe(node.relates_to, node.id);
+            if (relates.changed) {
+                node.relates_to = relates.ids;
+                changes.push('relates_to deduped');
+            }
+            const files = dedupe(node.related_files);
+            if (files.changed) {
+                node.related_files = files.ids;
+                changes.push('related_files deduped');
+            }
+        }
+        if (node.kind === 'squad') {
+            const members = dedupe(node.members, node.id);
+            if (members.changed) {
+                node.members = members.ids;
+                changes.push('members deduped');
+            }
+        }
+        if (!node.created) {
+            node.created = gitFileCreationDate(original.file) ?? fileTimestamp(original.file);
+            changes.push('created');
+        }
+        if (!node.author) {
+            node.author = author();
+            changes.push('author');
+        }
+        const typeDef = types[node.type];
+        if (typeDef) {
+            const filled = [];
+            for (const [name, def] of Object.entries(typeDef.attributes)) {
+                if (!(name in node.attributes)) {
+                    node.attributes[name] = initialValueFor(def);
+                    filled.push(name);
+                }
+                else if (isEmpty(node.attributes[name]) && def.required && def.default !== undefined) {
+                    node.attributes[name] = def.default;
+                    filled.push(name);
+                }
+            }
+            if (filled.length)
+                changes.push(`attributes: ${filled.join(', ')}`);
+        }
+        if (changes.length) {
+            node.updated = nowIso();
+            writeDocument(board, node);
+            actions.push(`${where}: ${changes.join('; ')}`);
+        }
+        else if (!node.updated) {
+            node.updated = node.created ?? nowIso();
+            writeDocument(board, node);
+            actions.push(`${where}: updated`);
+        }
+        if (!isUnassigned(node.id)) {
+            const expected = nodeDirName(node.id);
+            if (path.basename(node.dir) !== expected) {
+                renames.push({ from: node.dir, to: path.join(path.dirname(node.dir), expected) });
+            }
+        }
+    }
+    // Deepest first, so renaming a parent carries already-renamed children along.
+    renames.sort((a, b) => b.from.split(path.sep).length - a.from.split(path.sep).length);
+    for (const { from, to } of renames) {
+        if (existsSync(to)) {
+            actions.push(`${displayPath(paths, from)}: skipped rename, ${path.basename(to)} exists`);
+            continue;
+        }
+        renameSync(from, to);
+        actions.push(`${displayPath(paths, from)}: renamed to ${path.basename(to)}`);
+    }
+}
+/**
+ * Repair everything `checkBoard` marks fixable: fill in missing metadata,
+ * allocate ids, tidy link lists, rename folders to match, and resync the id
+ * counters. Returns a log of what changed. Reload the board afterwards.
+ */
+export function applyFixes(board) {
+    // One lock for the whole repair, not one per document. It renames folders,
+    // resyncs the id counters and reloads twice; a writer let in between any two
+    // of those would be working from a board that is half repaired. Deliberately
+    // no `requireUnchanged` here either — this is the tool for a board that is
+    // already out of step, and stopping half way through to report that somebody
+    // touched a file would leave it worse than it started.
+    return boardWrite(board, 'repair the board', () => fixUnderLock(board));
+}
+function fixUnderLock(board) {
+    const actions = [];
+    for (const kind of KINDS)
+        fixCollection(board, kind, actions);
+    // `.lpm/.gitignore` keeps per-checkout state out of the shared repo. Boards
+    // created before `credentials.json` existed are missing the entry; the
+    // check reports it and this heals it, exactly as `writeLocal` / `init` do.
+    if (ensureLocalIgnored(board.paths)) {
+        actions.push(`${displayPath(board.paths, path.join(board.paths.lpmDir, '.gitignore'))}: added missing ignore entries`);
+    }
+    const state = readState(board.paths);
+    const next = { ...state };
+    for (const kind of KINDS) {
+        const prefix = prefixFor(board.config, kind);
+        if (!prefix)
+            continue;
+        const highest = nodesOf(board, kind).reduce((max, node) => {
+            const id = isUnassigned(node.id) ? '' : node.id;
+            return Math.max(max, numberOf(id, prefix));
+        }, 0);
+        const field = counterFor(kind);
+        if (next[field] < highest) {
+            next[field] = highest;
+            actions.push(`${displayPath(board.paths, board.paths.statePath)}: ${kind} counter synced to ${highest}`);
+        }
+    }
+    if (KINDS.some((kind) => next[counterFor(kind)] !== state[counterFor(kind)])) {
+        writeState(board.paths, next);
+    }
+    // From disk: the fixes above rewrite ids, titles, folder names and statuses,
+    // which is everything the index is made of and everything the roll-up reads.
+    // Reloading is the honest way to work from what actually landed, and `--fix`
+    // is not the hot path.
+    const before = readIndex(board.paths.indexPath);
+    const after = loadBoard(board.paths);
+    // A container's status is derived from the work inside it, so a board where
+    // the last story was closed by hand has features and epics still claiming to
+    // be open. Deepest first, so one pass carries a closed story all the way up.
+    for (const rollup of writeRollups(after, boardRollups(after))) {
+        actions.push(`${at(after, rollup.issue)}: status=${rollup.to} (rolled up from its contents)`);
+    }
+    // And the same for flags: a container stands in front of stopped work while
+    // anything inside it is flagged. Read from a board that already has the
+    // statuses above, because closing a container takes its flag off.
+    const flagged = loadBoard(board.paths);
+    for (const rollup of writeFlagRollups(flagged, boardFlagRollups(flagged))) {
+        actions.push(`${at(flagged, rollup.issue)}: ${rollup.to ? `flag=${rollup.to} (stopped work inside it)` : 'flag cleared (nothing inside it is stopped)'}`);
+    }
+    writeBoardIndex(after);
+    if (readIndex(board.paths.indexPath) !== before) {
+        actions.push(`${displayPath(board.paths, board.paths.indexPath)}: index rewritten`);
+    }
+    return actions;
+}
+//# sourceMappingURL=fix.js.map

package/dist/core/validation/fix.js.map

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

package/dist/core/validation/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Board validation. `check` is read-only and reports every problem it finds;
+ * `fix` repairs exactly the subset `check` marks `fixable`. Keeping them in one
+ * folder — and sharing `shared.ts` — is what stops the two drifting apart.
+ */
+export * from './check.js';
+export * from './fix.js';

package/dist/core/validation/index.js

@@ -0,0 +1,8 @@
+/**
+ * Board validation. `check` is read-only and reports every problem it finds;
+ * `fix` repairs exactly the subset `check` marks `fixable`. Keeping them in one
+ * folder — and sharing `shared.ts` — is what stops the two drifting apart.
+ */
+export * from './check.js';
+export * from './fix.js';
+//# sourceMappingURL=index.js.map

package/dist/core/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/core/validation/shared.d.ts

@@ -0,0 +1,47 @@
+import type { LoadedBoard } from '../board/load.js';
+import type { AnyNode, BaseNode, NodeKind, TypeDef } from '../model/types.js';
+/** Every collection, in a fixed order, so check and fix always agree. */
+export declare const KINDS: NodeKind[];
+/**
+ * A link type light-plan used to have, and the field it becomes.
+ *
+ * `informed_by` recorded the research an issue rested on and gated the queue
+ * exactly as `depends_on` does, which is the whole of what it turned out to
+ * mean: two edges with one behaviour, drawn twice on the canvas and asked for
+ * twice in every tool. It is gone, and what an issue rests on belongs in its
+ * body or its `related_files` — prose, where the reasoning already was.
+ *
+ * A board written before that still has the key. Nothing reads it any more, so
+ * a document carrying one has an ordering the queue no longer honours: `check`
+ * reports it as fixable and `--fix` merges the ids into `depends_on`, which is
+ * what the edge already did. Both sides read this constant so they cannot
+ * disagree about which key is being retired, and `checkCollection` skips it so
+ * the reader gets the message that says what to do rather than the generic one.
+ */
+export declare const RETIRED_LINK_FIELD = "informed_by";
+/**
+ * The ids a document still carries under the retired key, or `null` when the
+ * key is not there at all.
+ *
+ * An undeclared frontmatter key is loaded into `attributes` and written back
+ * untouched, which is what keeps a hand-edited board from losing anything — so
+ * this is where the leftovers are, and reading them is a list-shaped question
+ * `check` and `fix` must not answer two different ways. An empty list is not
+ * the same as an absent key: the key is still written into every document on a
+ * board that has one, and clearing it is most of what retiring the field means.
+ */
+export declare function retiredLink(node: BaseNode & {
+    attributes: Record<string, unknown>;
+}): string[] | null;
+/**
+ * All three collections, in a fixed order, so the engine's check and fix always
+ * agree.
+ *
+ * `src/shared/model.ts` carries the same function for the browser, flattening a
+ * `BoardSnapshot` instead of a `LoadedBoard`. They must agree on the order; the
+ * two data shapes are the reason they stay duplicated.
+ */
+export declare function allNodes(board: LoadedBoard): AnyNode[];
+export declare function typesOf(board: LoadedBoard, kind: NodeKind): Record<string, TypeDef>;
+/** Where to point the user: the document's path, relative to the board root. */
+export declare function at(board: LoadedBoard, node: BaseNode): string;

package/dist/core/validation/shared.js

@@ -0,0 +1,66 @@
+import { typesFor } from '../config/lookup.js';
+import { displayPath } from '../storage/paths.js';
+/** Every collection, in a fixed order, so check and fix always agree. */
+export const KINDS = ['issue', 'period', 'resource', 'squad', 'template'];
+/**
+ * A link type light-plan used to have, and the field it becomes.
+ *
+ * `informed_by` recorded the research an issue rested on and gated the queue
+ * exactly as `depends_on` does, which is the whole of what it turned out to
+ * mean: two edges with one behaviour, drawn twice on the canvas and asked for
+ * twice in every tool. It is gone, and what an issue rests on belongs in its
+ * body or its `related_files` — prose, where the reasoning already was.
+ *
+ * A board written before that still has the key. Nothing reads it any more, so
+ * a document carrying one has an ordering the queue no longer honours: `check`
+ * reports it as fixable and `--fix` merges the ids into `depends_on`, which is
+ * what the edge already did. Both sides read this constant so they cannot
+ * disagree about which key is being retired, and `checkCollection` skips it so
+ * the reader gets the message that says what to do rather than the generic one.
+ */
+export const RETIRED_LINK_FIELD = 'informed_by';
+/**
+ * The ids a document still carries under the retired key, or `null` when the
+ * key is not there at all.
+ *
+ * An undeclared frontmatter key is loaded into `attributes` and written back
+ * untouched, which is what keeps a hand-edited board from losing anything — so
+ * this is where the leftovers are, and reading them is a list-shaped question
+ * `check` and `fix` must not answer two different ways. An empty list is not
+ * the same as an absent key: the key is still written into every document on a
+ * board that has one, and clearing it is most of what retiring the field means.
+ */
+export function retiredLink(node) {
+    if (!(RETIRED_LINK_FIELD in node.attributes))
+        return null;
+    const value = node.attributes[RETIRED_LINK_FIELD];
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === 'string' && entry.length > 0);
+    }
+    return typeof value === 'string' && value ? [value] : [];
+}
+/**
+ * All three collections, in a fixed order, so the engine's check and fix always
+ * agree.
+ *
+ * `src/shared/model.ts` carries the same function for the browser, flattening a
+ * `BoardSnapshot` instead of a `LoadedBoard`. They must agree on the order; the
+ * two data shapes are the reason they stay duplicated.
+ */
+export function allNodes(board) {
+    return [
+        ...board.issues,
+        ...board.periods,
+        ...board.resources,
+        ...board.squads,
+        ...board.templates,
+    ];
+}
+export function typesOf(board, kind) {
+    return typesFor(board.config, kind);
+}
+/** Where to point the user: the document's path, relative to the board root. */
+export function at(board, node) {
+    return displayPath(board.paths, node.file);
+}
+//# sourceMappingURL=shared.js.map

package/dist/core/validation/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/core/validation/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,yEAAyE;AACzE,MAAM,CAAC,MAAM,KAAK,GAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,IAAwD;IAExD,IAAI,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAkB;IACzC,OAAO;QACL,GAAG,KAAK,CAAC,MAAM;QACf,GAAG,KAAK,CAAC,OAAO;QAChB,GAAG,KAAK,CAAC,SAAS;QAClB,GAAG,KAAK,CAAC,MAAM;QACf,GAAG,KAAK,CAAC,SAAS;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAkB,EAAE,IAAc;IACxD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,EAAE,CAAC,KAAkB,EAAE,IAAc;IACnD,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/mcp/context.d.ts

@@ -0,0 +1,70 @@
+import type { BoardPaths, LoadedBoard, ResolvedScope, Resource } from '../core/index.js';
+import type { BoardView, Plan } from '../shared/index.js';
+/**
+ * The board, as one agent session sees it.
+ *
+ * Two things here are deliberately different from the CLI. The board is
+ * reloaded for every call, because several agents may be working the same
+ * checkout at once and a handle held across calls would be reading the past.
+ * And the identity is held in memory rather than written to `.lpm/local.json`:
+ * that file says who is at *this keyboard*, and a swarm of agents sharing a
+ * checkout must not fight over it.
+ *
+ * A profile is the same bargain in file form: `--profile` names one for this
+ * session only, so a dozen agents can each be pointed at a different slice of
+ * one board without any of them writing anything down.
+ */
+export interface ContextOptions {
+    /** Who this session acts as: a resource id or name. Wins over the profile. */
+    user?: string | null;
+    /** A profile file for this session. Falls back to the checkout's. */
+    profile?: string | null;
+    /** Refuse every tool that writes. */
+    readOnly?: boolean;
+    /** Register the remote-sync tool, which writes to a tracker outside the checkout. */
+    allowRemote?: boolean;
+}
+export declare class BoardContext {
+    readonly paths: BoardPaths;
+    readonly readOnly: boolean;
+    /** Whether the remote-sync tool is registered: it writes to somebody else's tracker. */
+    readonly allowRemote: boolean;
+    /** Who this session acts as: an explicit `--user`, else the profile's. */
+    private readonly userRef;
+    /**
+     * The profile this session was started with. Read once at startup, like the
+     * identity beside it: a long-lived session must not change what it offers
+     * because a file moved under it.
+     */
+    private readonly profile;
+    /** Why the profile could not be read. Reported by `board_overview`. */
+    readonly profileErrors: string[];
+    constructor(paths: BoardPaths, options?: ContextOptions);
+    /** What this session should be offered, resolved against the board. */
+    scope(board?: LoadedBoard): ResolvedScope;
+    /**
+     * The board as it stands now — on a board shared through git, as it stands on
+     * the remote, pulled first. Throttled, because one tool call may load the
+     * board several times and one fetch answers all of them. Best effort: an
+     * agent offline still reads the board it has, and a write it then makes is
+     * refused by the engine if somebody else got there first.
+     */
+    board(): LoadedBoard;
+    /** The board as the shared planners want it. */
+    view(board?: LoadedBoard): BoardView;
+    /** The roster entry this session acts as, if it was given one. */
+    user(board?: LoadedBoard): Resource | null;
+    requireUser(board: LoadedBoard): Resource;
+    /** How a comment is signed when the caller does not say. */
+    authorName(board: LoadedBoard): string | undefined;
+    assertWritable(): void;
+    /**
+     * Run a planned edit. Returns the ids the board allocated, in the order the
+     * plan created them, so a tool can report real ids rather than `new:1`.
+     */
+    run(plan: Plan): {
+        created: string[];
+    };
+    /** A fresh temporary-id source for one plan. */
+    ids(): () => string;
+}

package/dist/mcp/context.js

@@ -0,0 +1,110 @@
+import { BoardError, currentProfile, findResource, fullScope, loadBoard, loadProfileFile, pullBoard, resolveProfilePath, resolveScope, } from '../core/index.js';
+import { counterFactory } from '../shared/index.js';
+import { applyChanges, toSnapshot } from '../sync/index.js';
+export class BoardContext {
+    paths;
+    readOnly;
+    /** Whether the remote-sync tool is registered: it writes to somebody else's tracker. */
+    allowRemote;
+    /** Who this session acts as: an explicit `--user`, else the profile's. */
+    userRef;
+    /**
+     * The profile this session was started with. Read once at startup, like the
+     * identity beside it: a long-lived session must not change what it offers
+     * because a file moved under it.
+     */
+    profile;
+    /** Why the profile could not be read. Reported by `board_overview`. */
+    profileErrors;
+    constructor(paths, options = {}) {
+        this.paths = paths;
+        this.readOnly = options.readOnly === true;
+        this.allowRemote = options.allowRemote === true;
+        // With no --profile the checkout's own applies, so an agent launched in a
+        // developer's working copy is offered what that developer is.
+        const loaded = options.profile
+            ? loadProfileFile(resolveProfilePath(paths, options.profile))
+            : currentProfile(paths);
+        this.profile = loaded?.profile ?? null;
+        this.profileErrors = loaded?.errors ?? [];
+        this.userRef = options.user ?? this.profile?.user ?? null;
+    }
+    /** What this session should be offered, resolved against the board. */
+    scope(board = this.board()) {
+        const scope = this.profile?.scope;
+        return scope ? resolveScope(board, scope) : fullScope();
+    }
+    /**
+     * The board as it stands now — on a board shared through git, as it stands on
+     * the remote, pulled first. Throttled, because one tool call may load the
+     * board several times and one fetch answers all of them. Best effort: an
+     * agent offline still reads the board it has, and a write it then makes is
+     * refused by the engine if somebody else got there first.
+     */
+    board() {
+        try {
+            pullBoard(this.paths, { maxAgeMs: 3_000 });
+        }
+        catch {
+            // The write that runs into it reports it.
+        }
+        return loadBoard(this.paths);
+    }
+    /** The board as the shared planners want it. */
+    view(board = this.board()) {
+        const snapshot = toSnapshot(board);
+        const nodes = Object.fromEntries([
+            ...snapshot.issues,
+            ...snapshot.periods,
+            ...snapshot.resources,
+            ...snapshot.templates,
+        ].map((node) => [node.id, node]));
+        return { config: snapshot.config, nodes };
+    }
+    /** The roster entry this session acts as, if it was given one. */
+    user(board = this.board()) {
+        return this.userRef ? findResource(board, this.userRef) : null;
+    }
+    requireUser(board) {
+        const resource = this.user(board);
+        if (!resource) {
+            throw new BoardError(this.userRef
+                ? `This session's user "${this.userRef}" is not on the roster`
+                : 'This session has no user', ['Start the server with --user <id or name>, or pass an explicit assignee.']);
+        }
+        return resource;
+    }
+    /** How a comment is signed when the caller does not say. */
+    authorName(board) {
+        const resource = this.user(board);
+        return resource ? `${resource.title} (${resource.id})` : undefined;
+    }
+    assertWritable() {
+        if (this.readOnly) {
+            throw new BoardError('This server is read-only', [
+                'It was started with --read-only; restart it without that flag to make changes.',
+            ]);
+        }
+    }
+    /**
+     * Run a planned edit. Returns the ids the board allocated, in the order the
+     * plan created them, so a tool can report real ids rather than `new:1`.
+     */
+    run(plan) {
+        this.assertWritable();
+        if (!plan.ok)
+            throw new BoardError(plan.error, plan.details);
+        if (!plan.changes.length)
+            return { created: [] };
+        const result = applyChanges(this.paths, plan.changes);
+        if (result.failures.length) {
+            throw new BoardError(result.failures.map((failure) => failure.error).join('; '), result.failures.flatMap((failure) => failure.details ?? []));
+        }
+        return { created: plan.created.map((temp) => result.idMap[temp] ?? temp) };
+    }
+    /** A fresh temporary-id source for one plan. */
+    ids() {
+        return counterFactory();
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/mcp/context.js.map

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