light-plan 0.0.0-stage → 0.1.0

package/assets/skills/lpm.md

@@ -0,0 +1,267 @@
+---
+name: lpm
+description: How to drive a light-plan board — the `lpm` CLI and the light-plan MCP server. Load this whenever a task involves a `.lpm` folder, the `lpm` command, a light-plan board, or the light-plan MCP tools (board_overview, next_tasks, create_document, …); when asked to read, populate, work or fix a board; or when a repository turns out to contain a `.lpm` directory and you need to know what it is. Start here, then load lpm-board-setup, lpm-planning, lpm-delivery or lpm-board-health for the specific job.
+roles:
+  - developer
+  - pm
+---
+
+# Working a light-plan board
+
+**light-plan** is a file-based issue tracker. A board is a `.lpm/` folder of
+nested directories, each holding one markdown document (YAML frontmatter + a
+body). It is versioned with git, has no server and no database, and is driven
+three ways that all produce the same board: the `lpm` CLI, an MCP server for
+agents, and a web app (`lpm ui`).
+
+This skill is the orientation and the map. Five companions cover the jobs:
+
+| Skill | Load it when |
+| --- | --- |
+| `lpm-board-setup` | creating a board, editing `.lpm/config.yml`, adding people, wiring up developers or agents |
+| `lpm-planning` | writing epics/features/stories, breaking work down, sequencing, assigning, scheduling |
+| `lpm-templates` | the reusable pieces of plan in `.lpm/registry/` — **check these before creating anything** |
+| `lpm-delivery` | picking work up, recording progress, closing issues |
+| `lpm-board-health` | `lpm check`, repairing a board, "why is nobody offered work", publishing |
+
+## The first rule: the board defines its own vocabulary
+
+There is no universal "epic", "story", "sprint" or "done". Every board declares
+its own types, its own hierarchy and its own statuses in `.lpm/config.yml`.
+
+**Find out before you act.**
+
+```bash
+lpm check          # validates, and fails loudly if you are not on a board
+cat .lpm/config.yml
+```
+
+Over MCP, one call answers everything:
+
+```
+board_overview
+```
+
+It returns the types and the hierarchy they nest in, the statuses (marking which
+are `active` and which `terminal`), the `priorityAttribute` and `effortAttribute`
+the engine ranks by, who you are, the scope you are being offered, and how much
+of each collection the board holds. **Every other tool speaks in those names.**
+Never guess one.
+
+## Three collections, one engine
+
+| Folder | Holds | Answers |
+| --- | --- | --- |
+| `.lpm/board/` | **issues** | what gets built |
+| `.lpm/timeline/` | **periods** — sprints, increments | when it gets built |
+| `.lpm/team/` | **resources** — people and pools | who builds it |
+
+They are structurally identical: nested folders, one markdown document each, one
+id namespace apiece (`LP-1`, `TL-1`, `RS-1`). Periods and resources are optional —
+a board that declares no period types simply has no `timeline/`.
+
+**A folder is named after its id and nothing else** — `board/LP-1/LP-2/_issue.md`.
+The titles are in `.lpm/INDEX.md`, a generated outline of the whole board with a
+link to every document, nested the way the folders are. Read it to get your
+bearings on an unfamiliar board; never edit it, since every command that adds,
+removes, moves or renames a document rewrites it.
+
+An issue at **any** level can be scheduled into any period and assigned to any
+resource. An epic can sit on an increment while its stories sit on sprints.
+
+## How work reaches a person
+
+This is the mechanic everything else serves. `lpm task next` / `next_tasks`
+offers an issue only when **all** of these hold:
+
+1. it is a **work unit** — an issue with no children, or one whose type the board
+   declares `atomic`, which is offered whole and hides what is nested in it.
+   Containers are never offered; the units under them carry the work;
+2. its status is neither terminal nor already active;
+3. it is assigned to that person, **or** parked in a generic pool they cover;
+4. everything it waits on is finished — **`depends_on`, its own and every
+   ancestor's**. A story sits inside a feature, and a feature that waits on
+   another feature waits on it with everything in it, so no story under the
+   second feature is offered until the first one's work is done.
+
+A dependency on a **container** is cleared by the work inside it, not by the
+container's own status — nobody moves a feature through the columns, so waiting
+for one to say `done` would idle the team for ever. Closing it outright still
+answers for everything under it.
+
+And the container's status follows: finishing the last open issue in a feature
+finishes the feature, and its epic with it, as far up as it goes. Reopening one,
+or adding a new issue inside a finished container, reopens them. Never close a
+parent by hand — `finish_task` reports what it carried in `rolledUp`, and
+`lpm check --fix` repairs a board where a hand edit or a merge left one behind.
+
+Ranking, in order: the running or overdue period first, then unscheduled work,
+then periods that have not started; within that the board's priority attribute,
+then the status closest to done, then the part of the plan already under way (a
+feature somebody is inside, then one closest to finished — so a queue finishes a
+feature rather than opening one in each), then how much each issue unblocks, then
+age.
+
+Four practical consequences: **assigning an epic assigns nothing**, **a
+dependency is a gate that idles somebody**, **one edge between two features
+sequences every story under them**, and **work in a pool nobody covers can
+never be picked up**.
+
+## The surface, side by side
+
+Everything is available both ways. Use MCP tools when you have them — they are
+one call and return structured JSON; fall back to the CLI in a shell.
+
+### Reading
+
+| Intent | MCP | CLI |
+| --- | --- | --- |
+| What kind of board is this | `board_overview` | `cat .lpm/config.yml` |
+| Survey documents | `list_documents { kind, type, status, assignee, period, parent, under, workUnitsOnly, search, limit }` | `lpm team`, `lpm task next` |
+| One document in full | `get_document { id }` | `lpm open <id> --path`, `lpm comment <id> --list` |
+| **The brief for an issue** | `get_instructions { id }` | `lpm instructions <id>` |
+| Validate | `check_board` | `lpm check` (exit 1 while errors remain) |
+| Who is loaded | `team_load { period }` | `lpm team [--period <id>] [--open]` |
+
+`get_document` is the one that answers "can I start this?" — it returns the body,
+attributes, `ancestors`, `children`, `blockedBy` / `blocks` and the whole
+comment log together.
+
+`get_instructions` is the one that answers "what do I need to know to do it?" It
+walks the hierarchy and returns **one piece of markdown**: the titles and bodies
+of every ancestor (the epic and feature this issue belongs to, whatever the board
+calls them), then the issue itself, its breakdown, **the files it names**, **where
+the work comes from and where it is going**, the research it rests on and its work
+log. `get_document` hands you a record; `get_instructions` hands you the reason it
+exists. **Read it before writing any code.**
+
+If the brief opens with a **flag**, somebody picked this up and stopped — read the
+work log before anything else.
+
+The layout comes from the board — `.lpm/templates/context/<type>.md`, falling back
+to `default.md` and then to a built-in layout — so a team decides what its
+developers are told. Do not pass `template` unless you were asked to use a
+specific one.
+
+Those layouts are **Eta templates, which means executable JavaScript**. Every one
+is checked before it is compiled, and one that reaches for the host (`process`,
+`require`, `this`, a computed property key) is refused. If `get_instructions`
+comes back refusing a template, **do not work around it** — no `--unsafe` exists
+for agents, and the right response is to report it: the board is carrying a
+layout that can run code, which a human needs to look at. `lpm instructions
+--audit` is the whole-board version of that check and exits 1 on a finding.
+
+### Planning
+
+| Intent | MCP | CLI |
+| --- | --- | --- |
+| Create | `create_document { type, title, parent, body, status, assignee, period, dependsOn, relatedFiles, starts, ends, capacity, attributes }` | `lpm new <type> -t "..." -p <parent> --set k=v --related <path>` |
+| Edit content / placement | `update_document { id, title, body, status, assignee, period, relatedFiles, starts, ends, capacity, attributes }` | `lpm set <id> …` (content) and `lpm move <id> …` (placement) |
+| Change what it is | `convert_document { id, type, under, buildParents, dryRun }` | `lpm convert <id> <type> [--under <id>] [--build-parents] [--dry-run]` |
+| Break up | `split_issue { id, titles, count, mode, chain, splitEffort, dryRun }` | `lpm split <id> --titles "A,B,C" [--replace] [--no-chain] [--split-effort] [--dry-run]` |
+| Insert into an edge | `insert_between { source, target, issue, type, title }` | `lpm insert --between LP-4..LP-7 -t "..."` |
+| Duplicate | `copy_documents { ids, under }` | `lpm copy <id> --under <id>` |
+| Delete | `delete_document { id, recursive, dryRun }` | `lpm rm <id> -r [--dry-run]` |
+| Dependency | `link_issues { blocked, blockedBy, remove }` | `lpm link <id> --depends-on <ids>` |
+| Non-blocking link | *(CLI only)* | `lpm link <id> --relates-to <ids>` |
+| Coverage | *(CLI only)* | `lpm link RS-1 --covers RS-4` |
+
+### Working
+
+| Intent | MCP | CLI |
+| --- | --- | --- |
+| What should I do | `next_tasks { assignee, includeUnassigned, limit }` | `lpm task next [--unassigned] [--limit n]` |
+| What do I hold | `current_tasks { assignee }` | `lpm task current` |
+| Claim | `start_task { id, assignee, force }` | `lpm task start [<id>] [--force]` |
+| **Get the brief for it** | `get_instructions { id }` | `lpm instructions [<id>]` |
+| Finish | `finish_task { id, comment }` | `lpm task done [<id>]` |
+| **Say the work stopped** | `flag_issue { id, reason, comment }` | `lpm flag [<id>] --reason blocked\|paused\|help --comment "..."` |
+| Say it can resume | `clear_flag { id, comment }` | `lpm flag clear <id> --comment "..."` |
+| What has stopped | `flagged_issues` | `lpm flag list` |
+| Comment | `add_comment { id, body, author }` | `lpm comment <id> -m "..."` / `-f file` / `-f -` |
+| Read the log | `list_comments { id }` | `lpm comment <id> --list` |
+| Delete a comment | `remove_comment { id, index }` | `lpm comment <id> --remove <n>` |
+| Identity | — | `lpm me [<id\|name>]`, `lpm profile` |
+| Look at it | — | `lpm ui` |
+| Publish it | — | `lpm export [--site docs] [--workflow]` |
+
+`lpm <command> --help` documents the rest. `lpm --help` lists every command.
+
+## Hard rules
+
+- **Never hand-edit files under `.lpm/`** to make a change you could make with a
+  tool. The tools validate the hierarchy, allocate ids, keep forward and derived
+  links consistent, and write frontmatter in the order the engine expects.
+  (Hand-editing is *supported* — see `lpm-board-health` — but it is a repair
+  path, not a workflow.)
+- **Never invent a type, status or attribute name.** Use what `board_overview`
+  returned.
+- **Ids are never reused.** Deleting `LP-7` does not free the number.
+- **Only forward edges are stored.** `depends_on` and a resource's
+  `covers` live in the file; "what does this block" and "who covers this pool"
+  are derived at load. Never try to write an inverse.
+- **`depends_on` is the only edge that gates the queue**; `relates_to` implies
+  nothing. A cycle is refused, and `lpm check` also catches one that appears
+  only after the edges are inherited.
+- **`dryRun` first** on `split_issue`, `convert_document` and `delete_document`
+  whenever children or dependencies are involved.
+- **A cycle is refused**, by the tools and by `lpm check`.
+- **Comments are not board state.** They live in a `_comments.md` beside the
+  document, are read on demand, and are written straight through — even in the
+  web app, which queues everything else.
+- **Never start an issue without reading its brief.** `get_instructions` /
+  `lpm instructions` is one call and it is the difference between building the
+  requirement and building your guess at it.
+- **A flag is not board state either**, and for the same reason as a comment: it
+  says work stopped *now*. It is written straight through, never queued, and the
+  web app writes it the moment you press the button.
+- **When work stops, flag it.** An issue that is going nowhere and does not say so
+  is a lie the board tells everyone who looks at it. Clearing a flag is the plan
+  owner's call, not the implementer's — `clear_flag` says "carry on".
+- **`related_files` is never resolved or checked.** An issue may name a file that
+  does not exist yet; that is often the point. Treat an entry as a lead, and add
+  the files you actually touched.
+
+## Two edits that look alike and are not
+
+`lpm set` / `update_document`'s content fields change **what a document holds**
+(title, body, attributes, dates, capacity). `lpm move` / `update_document`'s
+`status`, `assignee` and `period` change **where it sits**. `lpm convert` /
+`convert_document` changes **what it is**, and may relocate it to the depth its
+new type belongs at.
+
+Reach for the one that matches the intent; the engine enforces the difference.
+
+## The web app, in one paragraph
+
+`lpm ui` serves a local editor: a dependency canvas, a drawer (table, periods,
+Gantt, queue, team) and a side panel. **Editing there is queued, not immediate** —
+every action updates a working copy and appends to a pending list, and nothing
+touches `.lpm` until Push. A push is partial rather than atomic: what lands,
+lands, and failures stay pending. `lpm export` publishes a read-only static
+viewer, and it publishes the board **as committed** — queued changes never travel.
+
+## Identity and scoping
+
+Who you are decides what `lpm task next` offers. `lpm me <id|name>` stores it per
+checkout in `.lpm/local.json` (git-ignored). `LPM_USER` overrides it for one
+command. Over MCP it is `--user`, held per session and never written to disk, so a
+swarm of agents can share one checkout.
+
+A **profile** additionally narrows which part of the board you are offered — see
+`lpm-board-setup` and `docs/profiles.md`. Scope decides what is *offered*, never
+what is *reachable*: `get_document` reads any id. It is routing, not access
+control.
+
+## Orientation checklist
+
+Run this before doing anything on an unfamiliar board:
+
+1. `board_overview` (or read `.lpm/config.yml`) — types, hierarchy, statuses,
+   ranking attributes, whether periods and resources exist at all.
+2. `list_documents { workUnitsOnly: true, limit: 50 }` — the shape of what is there.
+3. `lpm check` / `check_board` — is it currently valid?
+4. `team_load` — who exists, and is anything uncovered or unowned?
+5. `lpm me` — do you have an identity, and does work route to it?
+
+Then, before doing any single issue: `get_instructions { id }`.

package/dist/cli/agent-view.d.ts

@@ -0,0 +1,27 @@
+import type { RunEvent } from '../runner/index.js';
+export interface AgentView {
+    /** Feed the view one event from the run. */
+    feed(event: RunEvent): void;
+    /** Take the pane down and give the terminal back. Safe to call twice. */
+    stop(): void;
+}
+export interface AgentViewOptions {
+    /** Draw plain lines even on a terminal. */
+    plain?: boolean;
+    /** Lines of agent output to show at once. */
+    height?: number;
+    /** Where the pane is drawn. Defaults to stderr; a test passes its own. */
+    stream?: NodeJS.WriteStream;
+}
+/** `12s`, `3m 12s`, `1h 04m` — short enough to sit in a corner. */
+export declare function elapsed(ms: number): string;
+/**
+ * Make a fragment of somebody else's output safe to put in a frame.
+ *
+ * Tool output is whatever a command wrote: carriage returns that would jump the
+ * cursor, escape sequences that would repaint half the screen, tabs that make a
+ * line wider than it measures. All of it is flattened to plain text, because
+ * the pane's arithmetic only holds if a line is as wide as it looks.
+ */
+export declare function sanitize(text: string): string;
+export declare function createAgentView(options?: AgentViewOptions): AgentView;

package/dist/cli/agent-view.js

@@ -0,0 +1,247 @@
+import { attachScrollKeys, createLivePane, createScrollBuffer, visibleWidth } from './live.js';
+import { bold, cyan, dim, err, green, red, yellow } from './ui.js';
+/**
+ * What `lpm queue agent` looks like while it runs.
+ *
+ * The run reports itself as a stream of `RunEvent`s; this is the only thing
+ * that decides how any of it is drawn. Two shapes, chosen by where the output
+ * goes and never by a flag alone:
+ *
+ * - **On a terminal**, a pane at the bottom of the screen: which task, which
+ *   stage, which tool, and the tail of what the agent is saying and running.
+ *   It is a window, not a transcript — a few lines that are rewritten in place
+ *   and can be scrolled back through, so an hour-long run does not bury the
+ *   report it ends with.
+ * - **Anywhere else** (a pipe, a log, `--plain`), one line per thing that
+ *   happened and nothing else. The agent's own chatter is dropped rather than
+ *   flooding a log with a model thinking out loud.
+ *
+ * Nothing here writes to stdout: the run's report is stdout, and this is the
+ * commentary beside it, so `lpm queue agent > run.txt` still gets a clean file.
+ */
+/** How many lines of the agent's stream the pane shows at once. */
+const WINDOW = 10;
+/** Redraw at most this often. Deltas arrive far faster than anyone can read. */
+const FRAME_MS = 120;
+/** What each stage of a task is called on screen, in the order they happen. */
+const PHASES = {
+    picking: 'reading the board',
+    claiming: 'claiming the task',
+    briefing: 'building the brief',
+    running: 'agent working',
+    recording: 'recording the outcome',
+    committing: 'committing',
+};
+/** `12s`, `3m 12s`, `1h 04m` — short enough to sit in a corner. */
+export function elapsed(ms) {
+    const total = Math.max(0, Math.round(ms / 1000));
+    const seconds = total % 60;
+    const minutes = Math.floor(total / 60) % 60;
+    const hours = Math.floor(total / 3600);
+    if (hours)
+        return `${hours}h ${String(minutes).padStart(2, '0')}m`;
+    if (minutes)
+        return `${minutes}m ${String(seconds).padStart(2, '0')}s`;
+    return `${seconds}s`;
+}
+/**
+ * Make a fragment of somebody else's output safe to put in a frame.
+ *
+ * Tool output is whatever a command wrote: carriage returns that would jump the
+ * cursor, escape sequences that would repaint half the screen, tabs that make a
+ * line wider than it measures. All of it is flattened to plain text, because
+ * the pane's arithmetic only holds if a line is as wide as it looks.
+ */
+export function sanitize(text) {
+    return text
+        .replace(/\r\n?/g, '\n')
+        .replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, '')
+        .replace(/\t/g, '  ')
+        .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, '');
+}
+export function createAgentView(options = {}) {
+    const height = options.height ?? WINDOW;
+    const stream = options.stream ?? process.stderr;
+    const pane = createLivePane({ stream });
+    const live = pane.live && !options.plain;
+    const buffer = createScrollBuffer();
+    let task = null;
+    let phase = 'picking';
+    let tool = null;
+    let tools = 0;
+    let errors = 0;
+    let dirty = true;
+    let timer;
+    let detachKeys;
+    let stopped = false;
+    // One partial line at a time, tagged with what is writing it: a switch from
+    // the agent's prose to a command's output ends the line in progress, so two
+    // sources cannot end up spliced into one.
+    let pending = '';
+    let pendingFrom = '';
+    const flush = () => {
+        if (!pending)
+            return;
+        buffer.push(pending);
+        pending = '';
+    };
+    const append = (from, text, style) => {
+        if (from !== pendingFrom) {
+            flush();
+            pendingFrom = from;
+        }
+        const parts = sanitize(text).split('\n');
+        for (let i = 0; i < parts.length; i += 1) {
+            pending += style(parts[i]);
+            if (i < parts.length - 1)
+                flush();
+        }
+        dirty = true;
+    };
+    const line = (text) => {
+        flush();
+        buffer.push(text);
+        dirty = true;
+    };
+    const columns = () => Math.max(40, (stream.columns ?? 80) - 1);
+    /** Left text, right text, one line, whatever width the terminal is now. */
+    const pad = (left, right) => {
+        const gap = columns() - visibleWidth(left) - visibleWidth(right) - 2;
+        return gap > 1 ? `${left}${' '.repeat(gap)}${right}` : left;
+    };
+    const frame = () => {
+        const rows = [];
+        if (task) {
+            const left = `  ${bold(task.id)}  ${task.title}`;
+            const right = `task ${task.index} · ${elapsed(Date.now() - task.startedAt)}`;
+            rows.push(pad(left, right));
+            const counts = [`${tools} ${tools === 1 ? 'tool' : 'tools'}`];
+            if (errors)
+                counts.push(`${errors} failed`);
+            const doing = tool ? `${PHASES[phase]} · ${cyan(tool)}` : PHASES[phase];
+            rows.push(pad(`  ${dim(doing)}`, dim(counts.join(' · '))));
+        }
+        else {
+            rows.push(`  ${dim(PHASES[phase])}`);
+        }
+        rows.push(dim(`  ${'─'.repeat(Math.max(10, columns() - 4))}`));
+        const window = buffer.window(height);
+        for (const text of window)
+            rows.push(`  ${text}`);
+        for (let i = window.length; i < height; i += 1)
+            rows.push('');
+        const hint = detachKeys ? '↑↓ PgUp/PgDn scroll · Ctrl+C stop' : '';
+        rows.push(pad(`  ${dim(hint)}`, buffer.behind ? dim(`${buffer.behind} lines back`) : ''));
+        return rows;
+    };
+    const draw = () => {
+        if (!live || stopped)
+            return;
+        pane.set(frame());
+        dirty = false;
+    };
+    if (live) {
+        detachKeys = attachScrollKeys((delta) => {
+            buffer.scroll(delta);
+            dirty = true;
+        }, () => {
+            stop();
+            err(dim('  interrupted — the task stays in progress and the next run resumes it'));
+            process.exit(130);
+        });
+        // The clock in the corner has to move even when nothing is happening: a
+        // frozen frame and a stalled run look identical, and only one of them is a
+        // reason to reach for Ctrl-C.
+        timer = setInterval(() => {
+            if (dirty || task)
+                draw();
+        }, FRAME_MS);
+        timer.unref();
+    }
+    function stop() {
+        if (stopped)
+            return;
+        stopped = true;
+        if (timer)
+            clearInterval(timer);
+        detachKeys?.();
+        pane.stop();
+    }
+    return {
+        stop,
+        feed(event) {
+            switch (event.type) {
+                case 'task-start':
+                    task = { index: event.index, id: event.id, title: event.title, startedAt: Date.now() };
+                    tool = null;
+                    tools = 0;
+                    errors = 0;
+                    // The header already names the task; this is the marker somebody
+                    // scrolling back needs to see where one task ended and the next began.
+                    if (live)
+                        line(`${dim('──')} ${bold(event.id)}  ${event.title}`);
+                    else
+                        err(`${dim('picked')} ${bold(event.id)}  ${event.title}`);
+                    break;
+                case 'phase':
+                    phase = event.phase;
+                    if (event.phase !== 'running')
+                        tool = null;
+                    dirty = true;
+                    break;
+                case 'agent-text':
+                    if (live)
+                        append('text', event.text, (text) => text);
+                    break;
+                case 'agent-thinking':
+                    if (live)
+                        append('thinking', event.text, dim);
+                    break;
+                case 'tool-start':
+                    tools += 1;
+                    tool = event.summary ? `${event.name} ${event.summary}` : event.name;
+                    if (live)
+                        line(`${cyan(`❯ ${event.name}`)} ${dim(event.summary)}`);
+                    else
+                        err(`  ${dim(`${event.name} ${event.summary}`.trim())}`);
+                    break;
+                case 'tool-output':
+                    if (live)
+                        append('output', event.text, dim);
+                    break;
+                case 'tool-end':
+                    if (event.isError)
+                        errors += 1;
+                    if (live && event.isError)
+                        line(red(`  ${event.name} failed`));
+                    tool = null;
+                    dirty = true;
+                    break;
+                case 'task-end': {
+                    const mark = event.completed
+                        ? green('done')
+                        : yellow(`flagged${event.flagReason ? ` (${event.flagReason})` : ''}`);
+                    if (live)
+                        line(`${bold(event.id)} ${mark}`);
+                    else
+                        err(`  ${bold(event.id)} ${mark}  ${dim(firstLine(event.summary))}`);
+                    task = null;
+                    tool = null;
+                    break;
+                }
+                case 'note':
+                    if (live)
+                        line(dim(event.text));
+                    else
+                        err(event.text);
+                    break;
+            }
+            if (dirty)
+                draw();
+        },
+    };
+}
+function firstLine(text) {
+    return text.split('\n')[0] ?? '';
+}
+//# sourceMappingURL=agent-view.js.map

package/dist/cli/agent-view.js.map

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

package/dist/cli/commands/agent/assets.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The files this package ships — a neutral tree that no harness uses directly:
+ *
+ *   assets/
+ *     agents/<name>.md        markdown with portable frontmatter
+ *     skills/<name>.md
+ *     <anything>/...          any file at all: scripts, JSON, templates
+ *     harnesses/<name>.yml    where all of the above lands, per harness
+ *
+ * **Nothing here knows what an "agent" or a "skill" is.** This walks the tree
+ * and reads frontmatter where a file has some; the harness mappings select what
+ * to copy with `.gitignore`-style patterns and say where it goes. Adding a new
+ * kind of asset is a file, not a code change.
+ *
+ * `assets/` is resolved relative to this file's depth, the same way
+ * `operations/init.ts` finds its templates, so it works from `src/` and `dist/`.
+ * Moving this file breaks `lpm agent`.
+ */
+export type Role = 'developer' | 'pm';
+export declare const ROLES: Role[];
+/**
+ * Reserved names under `assets/`: the mappings themselves (per harness, and
+ * per hcm bundle) and the note explaining the tree. Everything else is payload, so `from: "**"` copies what
+ * a person means by it.
+ */
+export declare const RESERVED: string[];
+export interface AssetFile {
+    /** Path relative to `assets/`, forward slashes: `agents/lpm-developer.md`. */
+    relativePath: string;
+    /** Absolute path on disk. */
+    file: string;
+    /** First path segment, kept because it reads well in reports: `agents`. */
+    kind: string;
+    /** Basename without its extension: `lpm-developer`. */
+    name: string;
+    /** Basename with its extension. */
+    basename: string;
+    /** Extension without the dot, or '' when there is none. */
+    ext: string;
+    /** Parsed frontmatter, when the file has any. */
+    front: Frontmatter | null;
+}
+export interface Frontmatter {
+    name?: string;
+    description?: string;
+    roles?: Role[];
+    tools?: string[];
+    /** The body after the frontmatter block. */
+    body: string;
+}
+export declare function assetsDir(): string;
+/**
+ * Read frontmatter if the file starts with a `---` block. Returns null for
+ * anything else, which is how a script or a JSON file passes through untouched.
+ */
+export declare function readFrontmatter(file: string): Frontmatter | null;
+/** Every shippable file under `assets/`, with its frontmatter where it has any. */
+export declare function loadAssetFiles(): AssetFile[];
+/**
+ * Does this file belong to one of the roles asked for? A file that declares no
+ * roles belongs to all of them — a shared script or template is not somebody's
+ * private business.
+ */
+export declare function inRoles(asset: AssetFile, roles: Role[]): boolean;