light-plan 0.0.0-stage → 0.1.0

package/dist/cli/commands/agent/assets.js

@@ -0,0 +1,106 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import YAML from 'yaml';
+import { BoardError } from '../../../core/index.js';
+export const ROLES = ['developer', 'pm'];
+/**
+ * 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 const RESERVED = ['harnesses', 'hcm', 'README.md'];
+export function assetsDir() {
+    // <package>/dist/cli/commands/agent/assets.js -> <package>/assets
+    return fileURLToPath(new URL('../../../../assets', import.meta.url));
+}
+/**
+ * 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 function readFrontmatter(file) {
+    let text;
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(text);
+    if (!match)
+        return null;
+    let front;
+    try {
+        front = (YAML.parse(match[1]) ?? {});
+    }
+    catch (error) {
+        throw new BoardError(`${file} has frontmatter that is not valid YAML`, [
+            error.message,
+        ]);
+    }
+    const list = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : undefined;
+    return {
+        name: typeof front.name === 'string' ? front.name : undefined,
+        description: typeof front.description === 'string' ? front.description : undefined,
+        roles: list(front.roles)?.filter((role) => ROLES.includes(role)),
+        tools: list(front.tools),
+        body: match[2],
+    };
+}
+function walk(root, prefix = '') {
+    const found = [];
+    for (const entry of readdirSync(path.join(root, prefix), { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (RESERVED.includes(relative))
+            continue;
+        if (entry.isDirectory())
+            found.push(...walk(root, relative));
+        else
+            found.push(relative);
+    }
+    return found;
+}
+/** Every shippable file under `assets/`, with its frontmatter where it has any. */
+export function loadAssetFiles() {
+    const root = assetsDir();
+    let relatives;
+    try {
+        relatives = walk(root);
+    }
+    catch (error) {
+        throw new BoardError(`Cannot read the bundled assets in ${root}`, [
+            error.message,
+            'This package looks incomplete; reinstall light-plan.',
+        ]);
+    }
+    return relatives.map((relativePath) => {
+        const file = path.join(root, ...relativePath.split('/'));
+        const basename = path.basename(relativePath);
+        const ext = path.extname(basename);
+        const front = readFrontmatter(file);
+        if (front?.name && front.name !== basename.slice(0, basename.length - ext.length)) {
+            throw new BoardError(`${file} declares name "${front.name}"`, [
+                "An asset's name has to match its file name.",
+            ]);
+        }
+        return {
+            relativePath,
+            file,
+            kind: relativePath.split('/')[0],
+            name: basename.slice(0, basename.length - ext.length),
+            basename,
+            ext: ext.replace(/^\./, ''),
+            front,
+        };
+    });
+}
+/**
+ * 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 function inRoles(asset, roles) {
+    const declared = asset.front?.roles;
+    return !declared?.length || declared.some((role) => roles.includes(role));
+}
+//# sourceMappingURL=assets.js.map

package/dist/cli/commands/agent/assets.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Selecting source files the way `.gitignore` does.
+ *
+ * A rule's `from:` is one pattern or a list of them, matched against paths
+ * relative to `assets/` with forward slashes. Later patterns win, and a leading
+ * `!` excludes — so a list reads top to bottom like a `.gitignore`:
+ *
+ *   from:
+ *     - "skills/**\/*.md"     everything under skills/
+ *     - "!skills/_*.md"       except the ones starting with an underscore
+ *
+ * Supported: `*` (within a segment), `**` (across segments), `?` (one
+ * character), a trailing `/` or a bare directory name (everything beneath it),
+ * and `!` to negate. Deliberately no braces, no character classes and no
+ * `[[:alpha:]]` — this selects files in one small shipped directory, and a
+ * pattern language nobody can predict is worse than one that cannot express
+ * every case.
+ */
+/**
+ * A matcher over paths relative to `assets/`, using forward slashes.
+ * With no positive pattern nothing matches — an empty `from:` selects nothing
+ * rather than everything, because the destructive reading of a typo should be
+ * the harmless one.
+ */
+export declare function matcher(patterns: string[]): (relativePath: string) => boolean;

package/dist/cli/commands/agent/glob.js

@@ -0,0 +1,82 @@
+/**
+ * Selecting source files the way `.gitignore` does.
+ *
+ * A rule's `from:` is one pattern or a list of them, matched against paths
+ * relative to `assets/` with forward slashes. Later patterns win, and a leading
+ * `!` excludes — so a list reads top to bottom like a `.gitignore`:
+ *
+ *   from:
+ *     - "skills/**\/*.md"     everything under skills/
+ *     - "!skills/_*.md"       except the ones starting with an underscore
+ *
+ * Supported: `*` (within a segment), `**` (across segments), `?` (one
+ * character), a trailing `/` or a bare directory name (everything beneath it),
+ * and `!` to negate. Deliberately no braces, no character classes and no
+ * `[[:alpha:]]` — this selects files in one small shipped directory, and a
+ * pattern language nobody can predict is worse than one that cannot express
+ * every case.
+ */
+/** Turn one pattern (no `!`) into an anchored regular expression. */
+function toRegExp(pattern) {
+    let source = '';
+    for (let index = 0; index < pattern.length; index += 1) {
+        const char = pattern[index];
+        if (char === '*') {
+            const isDouble = pattern[index + 1] === '*';
+            if (isDouble) {
+                // `**/` may match nothing at all, so `a/**/b` also matches `a/b`.
+                if (pattern[index + 2] === '/') {
+                    source += '(?:.*/)?';
+                    index += 2;
+                }
+                else {
+                    source += '.*';
+                    index += 1;
+                }
+            }
+            else {
+                source += '[^/]*';
+            }
+            continue;
+        }
+        if (char === '?') {
+            source += '[^/]';
+            continue;
+        }
+        source += char.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    }
+    return new RegExp(`^${source}$`);
+}
+function compile(pattern) {
+    const negated = pattern.startsWith('!');
+    let body = (negated ? pattern.slice(1) : pattern).trim();
+    // A leading `/` only anchors, and everything here is anchored already.
+    if (body.startsWith('/'))
+        body = body.slice(1);
+    // `dir/` and a bare `dir` both mean everything beneath it.
+    if (body.endsWith('/'))
+        body += '**';
+    else if (!/[*?.]/.test(body))
+        body += '/**';
+    return { negated, test: toRegExp(body) };
+}
+/**
+ * A matcher over paths relative to `assets/`, using forward slashes.
+ * With no positive pattern nothing matches — an empty `from:` selects nothing
+ * rather than everything, because the destructive reading of a typo should be
+ * the harmless one.
+ */
+export function matcher(patterns) {
+    const rules = patterns.map(compile);
+    return (relativePath) => {
+        const target = relativePath.split('\\').join('/');
+        let matched = false;
+        for (const rule of rules) {
+            if (!rule.test.test(target))
+                continue;
+            matched = !rule.negated;
+        }
+        return matched;
+    };
+}
+//# sourceMappingURL=glob.js.map

package/dist/cli/commands/agent/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../../src/cli/commands/agent/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qEAAqE;AACrE,SAAS,QAAQ,CAAC,OAAe;IAC/B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACb,kEAAkE;gBAClE,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC/B,MAAM,IAAI,UAAU,CAAC;oBACrB,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,IAAI,CAAC;oBACf,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,OAAO,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,MAAM,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACnC,CAAC;AAOD,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,uEAAuE;IACvE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,2DAA2D;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,IAAI,IAAI,CAAC;SAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,IAAI,IAAI,KAAK,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,QAAkB;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,YAAoB,EAAW,EAAE;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS;YACtC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * `lpm agent` installs the assets this package ships into somebody else's
+ * project, rearranged for whichever harness they use.
+ *
+ * The assets are a neutral tree (`assets.ts`) and the layouts are data
+ * (`assets/harnesses/*.yml`, read by `mapping.ts`), so this file never mentions
+ * a harness by name. Adding one is a YAML file; adding an asset kind is a
+ * directory. See `docs/harness-layouts.md`.
+ */
+export declare const help = "Install the light-plan agents, skills and MCP config into a project.\n\nUsage\n  lpm agent --target <harness> [--type <role>] [options]\n\nOptions\n      --target <name>   Which harness to install for   (required)\n      --type <role>     developer | pm | all          (default: all; repeatable)\n      --project         Install into a project (default: the working directory)\n      --global          Install for this user, for every project\n      --dir <path>      The project to install into (implies --project)\n      --name <name>     Name for the MCP server entry (default: light-plan)\n      --user <id|name>  Make the agent act as this team member\n      --profile <path>  Point the agent at a profile (see `lpm profile`)\n      --read-only       Give the agent only the MCP tools that do not write\n      --no-mcp          Install the markdown only, leaving MCP config alone\n      --force           Replace files and entries that are already there\n      --dry-run         Say what would happen, write nothing\n      --list            Show the harnesses and assets this package ships\n\nRoles\n  developer  Picks work up, implements it, and leaves a reviewable trail\n  pm         Writes epics, features and stories, and sequences them\n\nWhere things land is declared per harness in assets/harnesses/*.yml: a list of\ncopy rules, each selecting source files with .gitignore-style patterns. Any file\nunder assets/ can go anywhere \u2014 markdown gets the frontmatter the host wants,\nanything else is copied byte for byte. Run --list to see the rules, and read\ndocs/harness-layouts.md for the schema.\n\nNothing is destroyed: existing directories are added to, an existing MCP config\nis merged into with its other keys untouched, and a markdown file the harness\nowns gets a delimited block that is replaced in place on the next run. A file\nthis command wrote before is only overwritten with --force.\n\nWithout --project or --global you are asked which you want.\n\nExamples\n  lpm agent --list\n  lpm agent --target claude\n  lpm agent --target copilot --type developer --dir ../our-service\n  lpm agent --target claude --type pm --user \"Planner Bot\" --name planner\n  lpm agent --target reasonix --global\n  lpm agent --target claude --dry-run";
+export declare function run(args: string[]): number;

package/dist/cli/commands/agent/index.js

@@ -0,0 +1,284 @@
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { BoardError, findBoardPaths } from '../../../core/index.js';
+import { bold, cyan, dim, green, out, plural, yellow } from '../../ui.js';
+import { DEFAULT_SERVER_NAME, buildEntry, lpmOnPath } from '../mcp/config.js';
+import { ROLES, inRoles, loadAssetFiles } from './assets.js';
+import { installFile, installMcp, installPointer, pointerBlock } from './install.js';
+import { findHarness, harnessNames, loadHarnesses, mcpFor, placementsFor, pointerFor, resolve, } from './mapping.js';
+import { choose } from '../../prompt.js';
+/**
+ * `lpm agent` installs the assets this package ships into somebody else's
+ * project, rearranged for whichever harness they use.
+ *
+ * The assets are a neutral tree (`assets.ts`) and the layouts are data
+ * (`assets/harnesses/*.yml`, read by `mapping.ts`), so this file never mentions
+ * a harness by name. Adding one is a YAML file; adding an asset kind is a
+ * directory. See `docs/harness-layouts.md`.
+ */
+export const help = `Install the light-plan agents, skills and MCP config into a project.
+
+Usage
+  lpm agent --target <harness> [--type <role>] [options]
+
+Options
+      --target <name>   Which harness to install for   (required)
+      --type <role>     developer | pm | all          (default: all; repeatable)
+      --project         Install into a project (default: the working directory)
+      --global          Install for this user, for every project
+      --dir <path>      The project to install into (implies --project)
+      --name <name>     Name for the MCP server entry (default: ${DEFAULT_SERVER_NAME})
+      --user <id|name>  Make the agent act as this team member
+      --profile <path>  Point the agent at a profile (see \`lpm profile\`)
+      --read-only       Give the agent only the MCP tools that do not write
+      --no-mcp          Install the markdown only, leaving MCP config alone
+      --force           Replace files and entries that are already there
+      --dry-run         Say what would happen, write nothing
+      --list            Show the harnesses and assets this package ships
+
+Roles
+  developer  Picks work up, implements it, and leaves a reviewable trail
+  pm         Writes epics, features and stories, and sequences them
+
+Where things land is declared per harness in assets/harnesses/*.yml: a list of
+copy rules, each selecting source files with .gitignore-style patterns. Any file
+under assets/ can go anywhere — markdown gets the frontmatter the host wants,
+anything else is copied byte for byte. Run --list to see the rules, and read
+docs/harness-layouts.md for the schema.
+
+Nothing is destroyed: existing directories are added to, an existing MCP config
+is merged into with its other keys untouched, and a markdown file the harness
+owns gets a delimited block that is replaced in place on the next run. A file
+this command wrote before is only overwritten with --force.
+
+Without --project or --global you are asked which you want.
+
+Examples
+  lpm agent --list
+  lpm agent --target claude
+  lpm agent --target copilot --type developer --dir ../our-service
+  lpm agent --target claude --type pm --user "Planner Bot" --name planner
+  lpm agent --target reasonix --global
+  lpm agent --target claude --dry-run`;
+function rolesFrom(values) {
+    const raw = (values.type ?? [])
+        .flatMap((value) => value.split(','))
+        .map((value) => value.trim().toLowerCase())
+        .filter(Boolean);
+    if (!raw.length)
+        return [...ROLES];
+    const wanted = new Set();
+    for (const value of raw) {
+        if (value === 'all' || value === 'both') {
+            for (const role of ROLES)
+                wanted.add(role);
+        }
+        else if (ROLES.includes(value)) {
+            wanted.add(value);
+        }
+        else {
+            throw new BoardError(`Unknown --type "${value}"`, [
+                `Expected one of: ${ROLES.join(', ')}, all.`,
+            ]);
+        }
+    }
+    return [...wanted];
+}
+function harnessFrom(values) {
+    if (!values.target) {
+        throw new BoardError('Pass --target', [
+            `Expected one of: ${harnessNames().join(', ')}.`,
+            'Run `lpm agent --list` for what each one writes.',
+        ]);
+    }
+    const harness = findHarness(values.target);
+    if (!harness) {
+        throw new BoardError(`Unknown --target "${values.target}"`, [
+            `Expected one of: ${harnessNames().join(', ')}.`,
+        ]);
+    }
+    return harness;
+}
+function scopeFrom(values) {
+    if (values.project && values.global) {
+        throw new BoardError('Pass one of --project and --global');
+    }
+    if (values.global)
+        return 'user';
+    if (values.project || values.dir)
+        return 'project';
+    return choose('Install for this project, or for your user account?', [
+        {
+            value: 'project',
+            label: 'This project',
+            detail: 'Committed with the repository, so the whole team gets it.',
+        },
+        {
+            value: 'user',
+            label: 'My user account',
+            detail: 'Available in every project on this machine, and shared with nobody.',
+        },
+    ], '--project or --global');
+}
+/** `--list`: what this package ships, and where each harness puts it. */
+function runList() {
+    const assets = loadAssetFiles();
+    out(bold('Files'));
+    for (const asset of assets) {
+        const roles = asset.front?.roles?.length ? asset.front.roles.join(', ') : 'all roles';
+        out(`  ${asset.relativePath.padEnd(34)}${dim(roles)}`);
+    }
+    out();
+    out(bold('Harnesses'));
+    for (const harness of loadHarnesses()) {
+        out(`  ${harness.name}  ${dim(harness.label)}`);
+        for (const rule of harness.files) {
+            const scope = rule.scope ? dim(` [${rule.scope} only]`) : '';
+            const mode = rule.frontmatter ? '' : dim('  (verbatim)');
+            out(`    ${rule.from.join(', ')}`);
+            out(`      ${dim('->')} ${rule.to}${scope}${mode}`);
+        }
+        // A file nothing selects would ship and never arrive; say so here rather
+        // than leaving someone to notice it missing.
+        const placed = new Set(placementsFor(resolve(harness, 'project', process.cwd()), assets, [...ROLES]).placements.map((placement) => placement.asset.relativePath));
+        const missed = assets.filter((asset) => !placed.has(asset.relativePath));
+        if (missed.length) {
+            out(`    ${yellow(`no rule matches: ${missed.map((a) => a.relativePath).join(', ')}`)}`);
+        }
+        if (harness.docs)
+            out(`    ${dim(harness.docs)}`);
+    }
+    out();
+    out(dim('Layouts are declared in assets/harnesses/*.yml — see docs/harness-layouts.md'));
+    return 0;
+}
+function report(actions, root) {
+    const shown = (file) => {
+        const relative = path.relative(root, file);
+        return relative && !relative.startsWith('..') ? relative.split(path.sep).join('/') : file;
+    };
+    for (const action of actions) {
+        const mark = action.outcome === 'created'
+            ? green('+')
+            : action.outcome === 'updated'
+                ? cyan('~')
+                : action.outcome === 'unchanged'
+                    ? dim('=')
+                    : yellow('!');
+        out(`  ${mark} ${shown(action.file)}${action.reason ? dim(`  ${action.reason}`) : ''}`);
+    }
+}
+export function run(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            target: { type: 'string' },
+            type: { type: 'string', multiple: true },
+            project: { type: 'boolean' },
+            global: { type: 'boolean' },
+            dir: { type: 'string' },
+            name: { type: 'string' },
+            user: { type: 'string' },
+            profile: { type: 'string' },
+            'read-only': { type: 'boolean' },
+            'no-mcp': { type: 'boolean' },
+            force: { type: 'boolean' },
+            'dry-run': { type: 'boolean' },
+            list: { type: 'boolean' },
+        },
+    });
+    if (values.list)
+        return runList();
+    const harness = harnessFrom(values);
+    const roles = rolesFrom(values);
+    const scope = scopeFrom(values);
+    const project = path.resolve(values.dir ?? process.cwd());
+    const assets = loadAssetFiles().filter((asset) => inRoles(asset, roles));
+    if (!assets.length)
+        throw new BoardError(`Nothing to install for --type ${roles.join(', ')}`);
+    const resolved = resolve(harness, scope, project);
+    const options = {
+        force: values.force === true,
+        dryRun: values['dry-run'] === true,
+    };
+    out(`${bold(values['dry-run'] ? 'Would install' : 'Installing')} ${harness.label} assets ` +
+        `${dim(`(${roles.join(' + ')})`)}`);
+    out(`  ${dim(scope === 'project' ? `project  ${project}` : `user     ${resolved.root}`)}`);
+    out();
+    const { placements, empty } = placementsFor(resolved, assets, roles);
+    const actions = [];
+    const placed = [];
+    for (const placement of placements) {
+        actions.push(installFile(placement, options));
+        placed.push(placement.asset);
+    }
+    // A file no rule selects would ship and never arrive, and a rule that selects
+    // nothing is nearly always a typo. Both are reported, neither is fatal.
+    const unplaced = assets.filter((asset) => !placed.some((entry) => entry.relativePath === asset.relativePath));
+    // The MCP entry is what makes the board reachable at all; the markdown only
+    // explains it. A project with no board still gets one, pointed at itself.
+    let advice = null;
+    if (!values['no-mcp']) {
+        const board = scope === 'project' ? findBoardPaths(project) : null;
+        const entry = buildEntry({
+            onPath: lpmOnPath(),
+            root: board?.root ?? project,
+            user: values.user,
+            profile: values.profile,
+            readOnly: values['read-only'] === true,
+        });
+        // A user-wide entry must not pin one project's directory.
+        if (scope === 'user')
+            delete entry.cwd;
+        const mcp = mcpFor(resolved);
+        const action = installMcp(mcp.file, values.name ?? DEFAULT_SERVER_NAME, entry, mcp.key, options);
+        if (action)
+            actions.push(action);
+        else if (mcp.advice)
+            advice = mcp.advice;
+    }
+    const pointer = pointerFor(resolved);
+    if (pointer)
+        actions.push(installPointer(pointer, pointerBlock(placed), options));
+    report(actions, scope === 'project' ? project : resolved.root);
+    const wrote = actions.filter((action) => action.outcome === 'created' || action.outcome === 'updated');
+    const skipped = actions.filter((action) => action.outcome === 'skipped');
+    out();
+    out(values['dry-run']
+        ? dim(`${plural(wrote.length, 'file')} would change, ${skipped.length} skipped`)
+        : `${green('Done')} ${plural(wrote.length, 'file')} written, ${skipped.length} skipped`);
+    if (skipped.length && !values.force) {
+        out(dim('  Pass --force to replace what is already there.'));
+    }
+    if (unplaced.length) {
+        out();
+        out(`${yellow('  note')} no rule in ${harness.name}.yml matches ` +
+            `${unplaced.map((asset) => asset.relativePath).join(', ')}; not installed.`);
+        out(`  ${dim(`Add a rule to assets/harnesses/${harness.name}.yml.`)}`);
+    }
+    if (empty.length) {
+        out();
+        for (const rule of empty) {
+            out(`${yellow('  note')} "${rule.from.join(', ')}" matched no files.`);
+        }
+    }
+    if (advice) {
+        out();
+        out(`${yellow('  todo')} this target keeps user-level MCP servers somewhere we will not rewrite.`);
+        for (const line of advice.trimEnd().split('\n'))
+            out(`  ${dim(line)}`);
+    }
+    if (harness.note) {
+        out();
+        out(`${yellow('  note')} ${harness.note}`);
+    }
+    if (scope === 'project' && !findBoardPaths(project)) {
+        out();
+        out(`${yellow('  warn')} no .lpm board found in ${project}`);
+        out(`  ${dim('The agents have nothing to work on until you run')} ${cyan('lpm init')}`);
+    }
+    out();
+    out(dim('Restart your agent host to pick the new assets up.'));
+    return 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/agent/index.js.map

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

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

@@ -0,0 +1,59 @@
+import type { ServerEntry, ServerKey } from '../mcp/config.js';
+import type { AssetFile } from './assets.js';
+import type { Placement } from './mapping.js';
+/**
+ * Writing the assets into somebody else's project.
+ *
+ * Nothing here knows a harness's name: it is handed a `Placement` — a path and
+ * a frontmatter object, both already resolved from a mapping — and writes it.
+ * If this file ever needs a `switch` on the target, the mapping schema is the
+ * thing to extend instead.
+ *
+ * The rule it exists to keep: **an install never destroys work that was already
+ * there.** A directory that exists is added to, a JSON config is merged into
+ * with its other keys untouched, and a markdown file the harness owns gets a
+ * delimited block appended — replaced in place on the next run, so
+ * re-installing is idempotent rather than cumulative. Only a file we wrote
+ * before is overwritten, and only with `--force`.
+ */
+/** What one install did, so the command can report it and `--dry-run` can print it. */
+export type Outcome = 'created' | 'updated' | 'skipped' | 'unchanged';
+export interface Action {
+    file: string;
+    outcome: Outcome;
+    /** Why it was skipped, when it was. */
+    reason?: string;
+}
+export interface InstallOptions {
+    force: boolean;
+    dryRun: boolean;
+}
+/**
+ * One file, where its harness mapping put it: markdown with the frontmatter the
+ * host wants, or the source copied byte for byte when the rule asked for no
+ * frontmatter.
+ */
+export declare function installFile(placement: Placement, options: InstallOptions): Action;
+/**
+ * Merge the MCP server entry into whatever config the harness already has.
+ * `readConfig` follows the key the file is already using; `preferred` only
+ * decides what a *new* file gets, which is where the harnesses disagree.
+ *
+ * Returns null when the mapping names no file — the command prints that
+ * harness's `advice` instead of guessing at somebody's config format.
+ */
+export declare function installMcp(file: string | null, name: string, entry: ServerEntry, preferred: ServerKey, options: InstallOptions): Action | null;
+/**
+ * Append a delimited block to a file the harness already owns — Copilot's
+ * `copilot-instructions.md` is somebody's document, and the one thing we may
+ * not do is rewrite it. A block that is already there is replaced where it
+ * stands, so running this twice leaves one block, not two.
+ */
+export declare function installPointer(file: string, block: string, options: InstallOptions): Action;
+/**
+ * The pointer block's text: short, and about this board rather than about us.
+ *
+ * Grouped by the directory each file came from, so it describes whatever the
+ * tree happens to hold rather than a fixed idea of "agents and skills".
+ */
+export declare function pointerBlock(assets: AssetFile[]): string;