light-plan 0.0.0-stage → 0.1.0

package/dist/core/storage/paths.d.ts

@@ -0,0 +1,125 @@
+import type { NodeKind } from '../model/types.js';
+export declare const LPM_DIR = ".lpm";
+export declare const CONFIG_FILE = "config.yml";
+export declare const STATE_FILE = "state.json";
+/** Per-checkout settings (current user). Never committed. */
+export declare const LOCAL_FILE = "local.json";
+/** Remote credentials, keyed by remote name. Never committed. */
+export declare const CREDENTIALS_FILE = "credentials.json";
+/**
+ * The one-writer-at-a-time lock. Exists only while somebody is mid-change, and
+ * never committed — which process is writing is not a property of the plan.
+ * @see src/core/storage/lock.ts
+ */
+export declare const LOCK_FILE = "lock";
+export declare const BOARD_DIR = "board";
+export declare const TIMELINE_DIR = "timeline";
+export declare const TEAM_DIR = "team";
+/** Where squads (named sub-teams of resources) live. */
+export declare const SQUADS_DIR = "squads";
+/**
+ * Where the template registry lives: reusable pieces of plan, written as
+ * documents so the same engine reads them.
+ *
+ * Deliberately not under `templates/`, which holds the prompts a board is
+ * written *with* (the context layouts). These are documents the board is
+ * written *from*, and `load.ts` walks them like any other collection.
+ */
+export declare const REGISTRY_DIR = "registry";
+/** Where a board keeps the templates it writes with, rather than reads from. */
+export declare const TEMPLATES_DIR = "templates";
+/** Where per-remote sync state lives: link stores, caches, audit logs. */
+export declare const REMOTES_DIR = "remotes";
+/** The generated table of contents: every id, title and document, nested. */
+export declare const INDEX_FILE = "INDEX.md";
+export declare const ISSUE_FILE = "_issue.md";
+export declare const PERIOD_FILE = "_period.md";
+export declare const RESOURCE_FILE = "_resource.md";
+export declare const SQUAD_FILE = "_squad.md";
+export declare const TEMPLATE_FILE = "_template.md";
+export declare function documentFileName(kind: NodeKind): string;
+export interface BoardPaths {
+    /** Directory that contains the `.lpm` folder. */
+    root: string;
+    lpmDir: string;
+    boardDir: string;
+    /** Where periods (sprints, increments, ...) live. */
+    timelineDir: string;
+    /** Where resources (people and generic pools) live. */
+    teamDir: string;
+    /** Where squads (named sub-teams of resources) live. */
+    squadsDir: string;
+    /** The template registry: reusable pieces of plan, as documents. */
+    registryDir: string;
+    /** Templates the board is written *with*: prompts, not documents. */
+    templatesDir: string;
+    /** Where per-remote sync state lives: link stores, caches, audit logs. */
+    remotesDir: string;
+    configPath: string;
+    statePath: string;
+    localPath: string;
+    /** Where remote credentials live (`.lpm/credentials.json`). Never committed. */
+    credentialsPath: string;
+    /** Where the board's write lock lives while somebody holds it. */
+    lockPath: string;
+    /** The generated index of every document, at the top of the board folder. */
+    indexPath: string;
+}
+/**
+ * Points every command at one board from any working directory: set it to a
+ * `.lpm` folder (or to the folder holding one) and nothing has to be run from
+ * inside the checkout. An explicit path — `lpm mcp --root`, `lpm agent
+ * --project` — is more specific and wins; `lpm init` ignores it, because
+ * creating a board somewhere is not the same as reading the one you work on.
+ */
+export declare const BOARD_ENV_VAR = "LPM_BOARD_PATH";
+/**
+ * A leading `~` means the home directory. Shells expand it themselves, but a
+ * path out of a config file or an env var written by a tool has not been
+ * through one.
+ */
+export declare function expandHome(ref: string): string;
+/** The layout around a `.lpm` folder, wherever it sits. */
+export declare function boardPathsAt(dir: string): BoardPaths;
+/** The layout for the board a project keeps in its own `.lpm` folder. */
+export declare function boardPathsFor(root: string): BoardPaths;
+export declare function collectionDir(paths: BoardPaths, kind: NodeKind): string;
+/**
+ * The board `LPM_BOARD_PATH` names, or null when it is not set. Either the
+ * `.lpm` folder or the folder containing one will do, since both are the
+ * obvious thing to write. A value that names no board **throws** rather than
+ * falling back to the search: a typo that quietly worked on whichever board the
+ * cwd happened to sit in is the failure nobody would notice.
+ */
+export declare function boardPathsFromEnv(): BoardPaths | null;
+/**
+ * The board to work on: `LPM_BOARD_PATH`, else the nearest `.lpm/config.yml`
+ * at or above the current folder. Passing `from` asks about that folder in
+ * particular — an explicit path is the more specific answer, so the
+ * environment does not override it.
+ */
+export declare function findBoardPaths(from?: string): BoardPaths | null;
+export declare function slugify(text: string): string;
+/**
+ * The folder a document lives in: its id, and nothing else.
+ *
+ * The title used to be slugged onto the end, which reads well in a file tree
+ * until nesting turns it into a path long enough to break tools (and, on
+ * Windows, the filesystem). An id is short and never changes, so a folder is
+ * never renamed because somebody edited a title, and a path stays quotable in a
+ * commit message. `INDEX.md` is where the titles went — see `board-index.ts`.
+ *
+ * Folders written by an older version keep their slug until `check --fix`
+ * renames them; `idFromDirName` reads both.
+ */
+export declare function nodeDirName(id: string): string;
+/** Pull `LP-12` out of a folder name — `LP-12`, or the older `LP-12-user-login`. */
+export declare function idFromDirName(name: string, prefix: string): string | null;
+/**
+ * Turn `LP-12-user-login` back into `User login`, for deriving a missing title.
+ * Folders named after the id alone carry no title to recover, so the name is
+ * all there is to give back — `check` reports the derived title either way.
+ */
+export declare function titleFromDirName(name: string, prefix: string): string;
+/** Path relative to the board root, using forward slashes for stable output. */
+export declare function displayPath(paths: BoardPaths, target: string): string;

package/dist/core/storage/paths.js

@@ -0,0 +1,202 @@
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { BoardError } from '../errors.js';
+export const LPM_DIR = '.lpm';
+export const CONFIG_FILE = 'config.yml';
+export const STATE_FILE = 'state.json';
+/** Per-checkout settings (current user). Never committed. */
+export const LOCAL_FILE = 'local.json';
+/** Remote credentials, keyed by remote name. Never committed. */
+export const CREDENTIALS_FILE = 'credentials.json';
+/**
+ * The one-writer-at-a-time lock. Exists only while somebody is mid-change, and
+ * never committed — which process is writing is not a property of the plan.
+ * @see src/core/storage/lock.ts
+ */
+export const LOCK_FILE = 'lock';
+export const BOARD_DIR = 'board';
+export const TIMELINE_DIR = 'timeline';
+export const TEAM_DIR = 'team';
+/** Where squads (named sub-teams of resources) live. */
+export const SQUADS_DIR = 'squads';
+/**
+ * Where the template registry lives: reusable pieces of plan, written as
+ * documents so the same engine reads them.
+ *
+ * Deliberately not under `templates/`, which holds the prompts a board is
+ * written *with* (the context layouts). These are documents the board is
+ * written *from*, and `load.ts` walks them like any other collection.
+ */
+export const REGISTRY_DIR = 'registry';
+/** Where a board keeps the templates it writes with, rather than reads from. */
+export const TEMPLATES_DIR = 'templates';
+/** Where per-remote sync state lives: link stores, caches, audit logs. */
+export const REMOTES_DIR = 'remotes';
+/** The generated table of contents: every id, title and document, nested. */
+export const INDEX_FILE = 'INDEX.md';
+export const ISSUE_FILE = '_issue.md';
+export const PERIOD_FILE = '_period.md';
+export const RESOURCE_FILE = '_resource.md';
+export const SQUAD_FILE = '_squad.md';
+export const TEMPLATE_FILE = '_template.md';
+export function documentFileName(kind) {
+    if (kind === 'issue')
+        return ISSUE_FILE;
+    if (kind === 'period')
+        return PERIOD_FILE;
+    if (kind === 'resource')
+        return RESOURCE_FILE;
+    return kind === 'template' ? TEMPLATE_FILE : SQUAD_FILE;
+}
+/**
+ * Points every command at one board from any working directory: set it to a
+ * `.lpm` folder (or to the folder holding one) and nothing has to be run from
+ * inside the checkout. An explicit path — `lpm mcp --root`, `lpm agent
+ * --project` — is more specific and wins; `lpm init` ignores it, because
+ * creating a board somewhere is not the same as reading the one you work on.
+ */
+export const BOARD_ENV_VAR = 'LPM_BOARD_PATH';
+/**
+ * A leading `~` means the home directory. Shells expand it themselves, but a
+ * path out of a config file or an env var written by a tool has not been
+ * through one.
+ */
+export function expandHome(ref) {
+    if (ref === '~' || ref.startsWith('~/') || ref.startsWith('~\\')) {
+        return path.join(homedir(), ref.slice(1));
+    }
+    return ref;
+}
+/** The layout around a `.lpm` folder, wherever it sits. */
+export function boardPathsAt(dir) {
+    const lpmDir = path.resolve(dir);
+    return {
+        // The folder the board describes. Everything that reports a path relative
+        // to it — `displayPath`, the board's name — needs the two to agree, so it
+        // is derived from the board folder rather than carried alongside it.
+        root: path.dirname(lpmDir),
+        lpmDir,
+        boardDir: path.join(lpmDir, BOARD_DIR),
+        timelineDir: path.join(lpmDir, TIMELINE_DIR),
+        teamDir: path.join(lpmDir, TEAM_DIR),
+        squadsDir: path.join(lpmDir, SQUADS_DIR),
+        registryDir: path.join(lpmDir, REGISTRY_DIR),
+        templatesDir: path.join(lpmDir, TEMPLATES_DIR),
+        remotesDir: path.join(lpmDir, REMOTES_DIR),
+        configPath: path.join(lpmDir, CONFIG_FILE),
+        statePath: path.join(lpmDir, STATE_FILE),
+        localPath: path.join(lpmDir, LOCAL_FILE),
+        credentialsPath: path.join(lpmDir, CREDENTIALS_FILE),
+        lockPath: path.join(lpmDir, LOCK_FILE),
+        indexPath: path.join(lpmDir, INDEX_FILE),
+    };
+}
+/** The layout for the board a project keeps in its own `.lpm` folder. */
+export function boardPathsFor(root) {
+    return boardPathsAt(path.join(root, LPM_DIR));
+}
+export function collectionDir(paths, kind) {
+    if (kind === 'issue')
+        return paths.boardDir;
+    if (kind === 'period')
+        return paths.timelineDir;
+    if (kind === 'resource')
+        return paths.teamDir;
+    return kind === 'template' ? paths.registryDir : paths.squadsDir;
+}
+/**
+ * The board `LPM_BOARD_PATH` names, or null when it is not set. Either the
+ * `.lpm` folder or the folder containing one will do, since both are the
+ * obvious thing to write. A value that names no board **throws** rather than
+ * falling back to the search: a typo that quietly worked on whichever board the
+ * cwd happened to sit in is the failure nobody would notice.
+ */
+export function boardPathsFromEnv() {
+    const ref = process.env[BOARD_ENV_VAR]?.trim();
+    if (!ref)
+        return null;
+    const target = path.resolve(expandHome(ref));
+    for (const dir of [target, path.join(target, LPM_DIR)]) {
+        if (existsSync(path.join(dir, CONFIG_FILE)))
+            return boardPathsAt(dir);
+    }
+    throw new BoardError(`${BOARD_ENV_VAR} does not point at a board: ${ref}`, [
+        `No ${CONFIG_FILE} in ${target} or ${path.join(target, LPM_DIR)}.`,
+        `Point it at a ${LPM_DIR} folder, or unset it to search from the current folder.`,
+    ]);
+}
+/**
+ * The board to work on: `LPM_BOARD_PATH`, else the nearest `.lpm/config.yml`
+ * at or above the current folder. Passing `from` asks about that folder in
+ * particular — an explicit path is the more specific answer, so the
+ * environment does not override it.
+ */
+export function findBoardPaths(from) {
+    if (from === undefined) {
+        const fromEnv = boardPathsFromEnv();
+        if (fromEnv)
+            return fromEnv;
+    }
+    let dir = path.resolve(from ?? process.cwd());
+    for (;;) {
+        if (existsSync(path.join(dir, LPM_DIR, CONFIG_FILE)))
+            return boardPathsFor(dir);
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export function slugify(text) {
+    const slug = text
+        .normalize('NFKD')
+        .replace(/\p{Diacritic}/gu, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60)
+        .replace(/-+$/g, '');
+    return slug || 'untitled';
+}
+/**
+ * The folder a document lives in: its id, and nothing else.
+ *
+ * The title used to be slugged onto the end, which reads well in a file tree
+ * until nesting turns it into a path long enough to break tools (and, on
+ * Windows, the filesystem). An id is short and never changes, so a folder is
+ * never renamed because somebody edited a title, and a path stays quotable in a
+ * commit message. `INDEX.md` is where the titles went — see `board-index.ts`.
+ *
+ * Folders written by an older version keep their slug until `check --fix`
+ * renames them; `idFromDirName` reads both.
+ */
+export function nodeDirName(id) {
+    return id;
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Pull `LP-12` out of a folder name — `LP-12`, or the older `LP-12-user-login`. */
+export function idFromDirName(name, prefix) {
+    const match = new RegExp(`^(${escapeRegExp(prefix)}-\\d+)(?:-|$)`).exec(name);
+    return match ? match[1] : null;
+}
+/**
+ * Turn `LP-12-user-login` back into `User login`, for deriving a missing title.
+ * Folders named after the id alone carry no title to recover, so the name is
+ * all there is to give back — `check` reports the derived title either way.
+ */
+export function titleFromDirName(name, prefix) {
+    const id = idFromDirName(name, prefix);
+    const rest = id ? name.slice(id.length).replace(/^-/, '') : name;
+    const words = rest.replace(/[-_]+/g, ' ').trim();
+    if (!words)
+        return name;
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/** Path relative to the board root, using forward slashes for stable output. */
+export function displayPath(paths, target) {
+    return path.relative(paths.root, target).split(path.sep).join('/');
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/storage/paths.js.map

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

package/dist/core/storage/state.d.ts

@@ -0,0 +1,32 @@
+import type { NodeKind } from '../model/types.js';
+import type { BoardPaths } from './paths.js';
+export interface BoardState {
+    /** Highest issue number handed out so far. */
+    counter: number;
+    /** Highest period number handed out so far. */
+    period_counter: number;
+    /** Highest resource number handed out so far. */
+    resource_counter: number;
+    /** Highest squad number handed out so far. */
+    squad_counter: number;
+    /** Highest registry template number handed out so far. */
+    template_counter: number;
+}
+export type CounterField = keyof BoardState;
+export declare function counterFor(kind: NodeKind): CounterField;
+export declare function readState(paths: BoardPaths): BoardState;
+export declare function writeState(paths: BoardPaths, state: BoardState): void;
+/**
+ * Hand out `count` fresh ids from one of the counters, skipping any already in
+ * use so a stale counter can never produce a duplicate.
+ *
+ * Read-modify-write, so it is only safe because every caller runs under the
+ * board lock: two processes creating documents at the same moment would
+ * otherwise both read counter 5 and both write 6, and the board would grow two
+ * `LP-6` folders. The skip-what-exists rule below repairs a *stale* counter; it
+ * cannot see an id another process is allocating this instant.
+ * @see src/core/storage/lock.ts
+ */
+export declare function allocateIds(paths: BoardPaths, field: CounterField, prefix: string, count: number, taken: ReadonlySet<string>): string[];
+/** Extract the numeric part of `LP-12`, or 0 when it does not match the prefix. */
+export declare function numberOf(id: string, prefix: string): number;

package/dist/core/storage/state.js

@@ -0,0 +1,71 @@
+import { readFileSync } from 'node:fs';
+import { writeFileAtomic } from './atomic.js';
+export function counterFor(kind) {
+    if (kind === 'issue')
+        return 'counter';
+    if (kind === 'period')
+        return 'period_counter';
+    if (kind === 'resource')
+        return 'resource_counter';
+    return kind === 'template' ? 'template_counter' : 'squad_counter';
+}
+function readCounter(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : 0;
+}
+export function readState(paths) {
+    try {
+        const parsed = JSON.parse(readFileSync(paths.statePath, 'utf8'));
+        return {
+            counter: readCounter(parsed.counter),
+            period_counter: readCounter(parsed.period_counter),
+            resource_counter: readCounter(parsed.resource_counter),
+            squad_counter: readCounter(parsed.squad_counter),
+            template_counter: readCounter(parsed.template_counter),
+        };
+    }
+    catch {
+        // Missing or corrupt state is recoverable: `check --fix` rebuilds it.
+        return {
+            counter: 0,
+            period_counter: 0,
+            resource_counter: 0,
+            squad_counter: 0,
+            template_counter: 0,
+        };
+    }
+}
+export function writeState(paths, state) {
+    writeFileAtomic(paths.statePath, `${JSON.stringify(state, null, 2)}\n`);
+}
+/**
+ * Hand out `count` fresh ids from one of the counters, skipping any already in
+ * use so a stale counter can never produce a duplicate.
+ *
+ * Read-modify-write, so it is only safe because every caller runs under the
+ * board lock: two processes creating documents at the same moment would
+ * otherwise both read counter 5 and both write 6, and the board would grow two
+ * `LP-6` folders. The skip-what-exists rule below repairs a *stale* counter; it
+ * cannot see an id another process is allocating this instant.
+ * @see src/core/storage/lock.ts
+ */
+export function allocateIds(paths, field, prefix, count, taken) {
+    const state = readState(paths);
+    let counter = state[field];
+    const ids = [];
+    while (ids.length < count) {
+        counter += 1;
+        const id = `${prefix}-${counter}`;
+        if (!taken.has(id))
+            ids.push(id);
+    }
+    writeState(paths, { ...state, [field]: counter });
+    return ids;
+}
+/** Extract the numeric part of `LP-12`, or 0 when it does not match the prefix. */
+export function numberOf(id, prefix) {
+    if (!prefix || !id.startsWith(`${prefix}-`))
+        return 0;
+    const value = Number.parseInt(id.slice(prefix.length + 1), 10);
+    return Number.isInteger(value) && value > 0 ? value : 0;
+}
+//# sourceMappingURL=state.js.map

package/dist/core/storage/state.js.map

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

package/dist/core/storage/templates.d.ts

@@ -0,0 +1,29 @@
+import type { BoardPaths } from './paths.js';
+/**
+ * Context templates: `.lpm/templates/context/<name>.md`.
+ *
+ * These are the layouts `lpm instructions` renders a working brief with. They
+ * are markdown with a little `{{ }}` in it, they live in the board so the team
+ * shares them, and they are the one thing under `.lpm` that is not a document:
+ * `load.ts` never opens this folder, `check` does not know it exists, and no
+ * template can make a board invalid. A missing one is not an error — there is
+ * always a built-in layout behind it.
+ *
+ * A template is named after the issue type it serves (`user_story.md`), with
+ * `default.md` for every type that has none of its own. Nothing here knows
+ * that; it is filing, not policy.
+ */
+export declare const CONTEXT_DIR = "context";
+export declare const DEFAULT_TEMPLATE = "default";
+export declare function contextTemplatesDir(paths: BoardPaths): string;
+export declare function contextTemplatePath(paths: BoardPaths, name: string): string;
+/** The template names a board holds, sorted. Missing folder means none. */
+export declare function listContextTemplates(paths: BoardPaths): string[];
+/** One template's text, or null when the board does not have it. */
+export declare function readContextTemplate(paths: BoardPaths, name: string): string | null;
+/**
+ * Write a template, never over one that is already there.
+ * Returns false when a file of that name exists and `force` was not asked for —
+ * somebody's edited layout is worth more than the starter it came from.
+ */
+export declare function writeContextTemplate(paths: BoardPaths, name: string, text: string, force?: boolean): boolean;

package/dist/core/storage/templates.js

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Context templates: `.lpm/templates/context/<name>.md`.
+ *
+ * These are the layouts `lpm instructions` renders a working brief with. They
+ * are markdown with a little `{{ }}` in it, they live in the board so the team
+ * shares them, and they are the one thing under `.lpm` that is not a document:
+ * `load.ts` never opens this folder, `check` does not know it exists, and no
+ * template can make a board invalid. A missing one is not an error — there is
+ * always a built-in layout behind it.
+ *
+ * A template is named after the issue type it serves (`user_story.md`), with
+ * `default.md` for every type that has none of its own. Nothing here knows
+ * that; it is filing, not policy.
+ */
+export const CONTEXT_DIR = 'context';
+export const DEFAULT_TEMPLATE = 'default';
+export function contextTemplatesDir(paths) {
+    return path.join(paths.templatesDir, CONTEXT_DIR);
+}
+export function contextTemplatePath(paths, name) {
+    return path.join(contextTemplatesDir(paths), `${name}.md`);
+}
+/** The template names a board holds, sorted. Missing folder means none. */
+export function listContextTemplates(paths) {
+    const dir = contextTemplatesDir(paths);
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
+            .map((entry) => entry.name.slice(0, -'.md'.length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** One template's text, or null when the board does not have it. */
+export function readContextTemplate(paths, name) {
+    try {
+        return readFileSync(contextTemplatePath(paths, name), 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a template, never over one that is already there.
+ * Returns false when a file of that name exists and `force` was not asked for —
+ * somebody's edited layout is worth more than the starter it came from.
+ */
+export function writeContextTemplate(paths, name, text, force = false) {
+    const file = contextTemplatePath(paths, name);
+    if (!force && existsSync(file))
+        return false;
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, text, 'utf8');
+    return true;
+}
+//# sourceMappingURL=templates.js.map

package/dist/core/storage/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/core/storage/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAiB,EAAE,IAAY;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC7C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAC/D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;aAClD,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,KAAiB,EAAE,IAAY;IACjE,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAiB,EACjB,IAAY,EACZ,IAAY,EACZ,KAAK,GAAG,KAAK;IAEb,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/storage/views.d.ts

@@ -0,0 +1,18 @@
+import type { BoardPaths } from './paths.js';
+/**
+ * Saved views: JSON artifacts in `.lpm/views/`, committed alongside the board.
+ *
+ * Storage deliberately treats a view's contents as opaque. A view describes how
+ * some tool chose to look at the board — which documents it shows and where it
+ * put them — and none of that is board truth, so nothing in `board/` or
+ * `validation/` may read it. The tool that writes a view owns its schema.
+ */
+export declare const VIEWS_DIR = "views";
+export declare function viewsDir(paths: BoardPaths): string;
+/** Turn a display name into the id that names its file. */
+export declare function viewIdFor(name: string): string;
+export declare function listViewIds(paths: BoardPaths): string[];
+export declare function viewExists(paths: BoardPaths, id: string): boolean;
+export declare function readView(paths: BoardPaths, id: string): unknown;
+export declare function writeView(paths: BoardPaths, id: string, data: unknown): void;
+export declare function deleteView(paths: BoardPaths, id: string): void;

package/dist/core/storage/views.js

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { BoardError } from '../errors.js';
+import { writeFileAtomic } from './atomic.js';
+import { slugify } from './paths.js';
+/**
+ * Saved views: JSON artifacts in `.lpm/views/`, committed alongside the board.
+ *
+ * Storage deliberately treats a view's contents as opaque. A view describes how
+ * some tool chose to look at the board — which documents it shows and where it
+ * put them — and none of that is board truth, so nothing in `board/` or
+ * `validation/` may read it. The tool that writes a view owns its schema.
+ */
+export const VIEWS_DIR = 'views';
+export function viewsDir(paths) {
+    return path.join(paths.lpmDir, VIEWS_DIR);
+}
+/** Turn a display name into the id that names its file. */
+export function viewIdFor(name) {
+    return slugify(name);
+}
+function viewPath(paths, id) {
+    if (id !== slugify(id))
+        throw new BoardError(`Invalid view id "${id}"`);
+    return path.join(viewsDir(paths), `${id}.json`);
+}
+export function listViewIds(paths) {
+    const dir = viewsDir(paths);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((name) => name.endsWith('.json'))
+        .map((name) => name.slice(0, -'.json'.length))
+        .sort();
+}
+export function viewExists(paths, id) {
+    return existsSync(viewPath(paths, id));
+}
+export function readView(paths, id) {
+    const file = viewPath(paths, id);
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        throw new BoardError(`No view "${id}"`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new BoardError(`View "${id}" is not valid JSON`, [error.message]);
+    }
+}
+export function writeView(paths, id, data) {
+    mkdirSync(viewsDir(paths), { recursive: true });
+    writeFileAtomic(viewPath(paths, id), `${JSON.stringify(data, null, 2)}\n`);
+}
+export function deleteView(paths, id) {
+    rmSync(viewPath(paths, id), { force: true });
+}
+//# sourceMappingURL=views.js.map

package/dist/core/storage/views.js.map

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

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

@@ -0,0 +1,4 @@
+import type { LoadedBoard } from '../board/load.js';
+import type { Problem } from '../model/types.js';
+/** Validate a loaded board. Never writes; see `applyFixes` for the repairs. */
+export declare function checkBoard(board: LoadedBoard): Problem[];