light-plan 0.0.0-stage → 0.1.0

package/dist/cli/commands/template.js

@@ -0,0 +1,338 @@
+import { readFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { BoardError, TEMPLATE_FOLDER_TYPE, createTemplate, findNode, isTemplateRoot, parseAttributeInput, requireTemplate, templatePath, templateSubtree, typeDefOf, validateAttributeValue, } from '../../core/index.js';
+import { counterFactory, planInstantiate } from '../../shared/index.js';
+import { requireBoard } from '../context.js';
+import { boardView, printCreated, runPlan } from '../plan.js';
+import { bold, cyan, dim, green, out, pad, plural, yellow } from '../ui.js';
+export const help = `The template registry: reusable pieces of plan, and putting them on the board.
+
+Usage
+  lpm template list [--all]
+  lpm template show <TPL-id>
+  lpm template new <type|folder> -t "Title" [options]
+  lpm template apply <TPL-id> [options]
+
+Subcommands
+  list        What the registry offers, with what each one is for
+  show        One template: its parameters, and everything it would create
+  new         Add a template or a folder to the registry
+  apply       Copy a template onto the board, filling in its parameters
+
+Options for \`new\`
+  -t, --title <text>        Title. May contain {{parameters}}
+  -d, --description <text>  What this template is for; shown in the listing
+      --parent <TPL-id>     Nest it under this folder or template
+      --param <spec>        Declare a parameter: name:type[:required][=default],
+                            and values(a|b) for an enum
+      --set key=value       An attribute value (repeatable)
+
+Options for \`apply\`
+      --under <id>        Issue to create it under; omit for the top level
+      --params <file>     A JSON object of parameter values
+      --set key=value     One parameter value, overriding the file (repeatable)
+      --period <id>       Schedule everything it creates into this period
+      --assignee <who>    Assign everything it creates
+      --dry-run           Say what would happen, change nothing
+
+A template is written in the board's own issue types and nests the same way, so
+a template of a feature holds templates of stories. A \`folder\` stands in for a
+level nobody templatized: to keep a feature template on its own, put it under a
+folder where the epic would be.
+
+Parameters are declared on the template somebody instantiates — its root — and
+are filled in throughout it: titles, bodies, related files and attribute values
+all take {{name}}.
+
+Examples
+  lpm template list
+  lpm template new folder -t "Delivery"              # TPL-1, at the top level
+  lpm template new folder -t "Epic slot" --parent TPL-1   # TPL-2, an epic's place
+  lpm template new feature -t "{{name}} API" --parent TPL-2 \\
+      -d "REST endpoint with tests and docs" --param name:string:required
+  lpm template new user_story -t "Build {{name}}" --parent TPL-3
+  lpm template apply TPL-3 --params ./payments.json --under LP-4
+  lpm template apply TPL-3 --set name=Payments --dry-run`;
+export function run(args) {
+    const [subcommand, ...rest] = args;
+    switch (subcommand) {
+        case undefined:
+        case 'list':
+            return list(rest);
+        case 'show':
+            return show(rest);
+        case 'new':
+            return create(rest);
+        case 'apply':
+            return apply(rest);
+        default:
+            throw new BoardError(`Unknown subcommand "${subcommand}"`, [
+                'Use list, show, new or apply.',
+            ]);
+    }
+}
+// -- list ------------------------------------------------------------------
+function list(args) {
+    const { values } = parseArgs({ args, options: { all: { type: 'boolean' } } });
+    const board = requireBoard();
+    if (!board.templates.length) {
+        out(dim('The registry is empty.'));
+        out(dim('Add one with `lpm template new <type> -t "..." -d "what it is for"`.'));
+        return 0;
+    }
+    const shown = values.all
+        ? board.templates
+        : board.templates.filter((template) => isTemplateRoot(board, template));
+    if (!shown.length) {
+        out(dim('The registry holds only folders. Add a template inside one.'));
+        return 0;
+    }
+    for (const template of shown) {
+        const where = templatePath(board, template);
+        const label = typeLabel(board, template);
+        const pieces = templateSubtree(board, template).length - 1;
+        out(`${bold(pad(template.id, 8))} ${cyan(pad(label, 12))} ${template.title}` +
+            (pieces > 0 ? dim(`  (+${plural(pieces, 'document')})`) : ''));
+        if (where.length)
+            out(`  ${dim(where.join(' / '))}`);
+        if (template.description)
+            out(`  ${template.description}`);
+        const params = Object.keys(template.params);
+        if (params.length)
+            out(`  ${dim(`parameters: ${params.join(', ')}`)}`);
+    }
+    return 0;
+}
+function typeLabel(board, template) {
+    if (template.type === TEMPLATE_FOLDER_TYPE)
+        return 'folder';
+    return board.config.issue_types[template.type]?.label ?? template.type;
+}
+// -- show ------------------------------------------------------------------
+function show(args) {
+    const { positionals } = parseArgs({ args, allowPositionals: true, options: {} });
+    const id = positionals[0];
+    if (!id)
+        throw new BoardError('Missing id', ['Usage: lpm template show <TPL-id>']);
+    const board = requireBoard();
+    const template = requireTemplate(board, id);
+    out(`${bold(template.id)}  ${template.title}  ${dim(typeLabel(board, template))}`);
+    if (template.description)
+        out(template.description);
+    const path = templatePath(board, template);
+    if (path.length)
+        out(dim(`in ${path.join(' / ')}`));
+    out();
+    const params = Object.entries(template.params);
+    if (params.length) {
+        out(bold('Parameters'));
+        for (const [name, def] of params) {
+            const notes = [
+                def.type,
+                def.required ? 'required' : null,
+                def.default !== undefined ? `default ${JSON.stringify(def.default)}` : null,
+                def.values ? `one of ${def.values.join(', ')}` : null,
+            ].filter(Boolean);
+            out(`  ${pad(name, 16)}${dim(notes.join(', '))}`);
+            if (def.description)
+                out(`  ${' '.repeat(16)}${def.description}`);
+        }
+        out();
+    }
+    else if (isTemplateRoot(board, template)) {
+        out(dim('This template takes no parameters.'));
+        out();
+    }
+    const subtree = templateSubtree(board, template);
+    out(bold(subtree.length === 1 ? 'Creates' : 'Creates, in this shape'));
+    for (const node of subtree) {
+        const indent = '  '.repeat(node.depth - template.depth + 1);
+        out(`${indent}${cyan(typeLabel(board, node))}  ${node.title}`);
+        if (node.depends_on.length)
+            out(`${indent}  ${dim(`after ${node.depends_on.join(', ')}`)}`);
+    }
+    if (!isTemplateRoot(board, template)) {
+        out();
+        out(dim(template.type === TEMPLATE_FOLDER_TYPE
+            ? 'This is a folder; instantiate one of the templates inside it.'
+            : 'This is part of a larger template; instantiate the root instead.'));
+    }
+    return 0;
+}
+// -- new -------------------------------------------------------------------
+/** `name:type`, `name:type:required`, `name:type=default`, all four combined. */
+function parseParamSpec(spec) {
+    const [declaration, ...defaultParts] = spec.split('=');
+    const rawDefault = defaultParts.length ? defaultParts.join('=') : undefined;
+    const [name, type, ...flags] = declaration.split(':');
+    if (!name || !type) {
+        throw new BoardError(`Invalid --param "${spec}"`, [
+            'Expected name:type, optionally :required and =default.',
+            'Types: string, text, int, float, bool, date, enum, array.',
+        ]);
+    }
+    const def = { type: type };
+    for (const flag of flags) {
+        if (flag === 'required')
+            def.required = true;
+        else if (flag.startsWith('values(') && flag.endsWith(')')) {
+            def.values = flag.slice('values('.length, -1).split('|');
+        }
+        else
+            throw new BoardError(`Unknown flag ":${flag}" in --param "${spec}"`);
+    }
+    if (rawDefault !== undefined) {
+        const parsed = parseAttributeInput(def, rawDefault);
+        if (parsed.error)
+            throw new BoardError(`--param ${name}: ${parsed.error}`);
+        def.default = parsed.value;
+    }
+    return { name, def };
+}
+function create(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            title: { type: 'string', short: 't' },
+            description: { type: 'string', short: 'd' },
+            parent: { type: 'string' },
+            param: { type: 'string', multiple: true },
+            set: { type: 'string', multiple: true },
+        },
+    });
+    const type = positionals[0];
+    if (!type) {
+        throw new BoardError('Missing type', [
+            'Usage: lpm template new <type|folder> -t "Title"',
+        ]);
+    }
+    if (!values.title)
+        throw new BoardError('Missing --title');
+    const board = requireBoard();
+    const typeDef = typeDefOf(board.config, 'template', type);
+    const params = {};
+    for (const spec of values.param ?? []) {
+        const { name, def } = parseParamSpec(spec);
+        params[name] = def;
+    }
+    const attributes = {};
+    for (const entry of values.set ?? []) {
+        const split = entry.indexOf('=');
+        if (split < 1)
+            throw new BoardError(`Invalid --set "${entry}"`, ['Expected key=value.']);
+        const key = entry.slice(0, split).trim();
+        const def = typeDef.attributes[key];
+        if (!def) {
+            throw new BoardError(`"${key}" is not an attribute of "${type}"`, [
+                `Declared attributes: ${Object.keys(typeDef.attributes).join(', ') || '(none)'}`,
+            ]);
+        }
+        // An attribute holding a placeholder is filled in at instantiation, so it
+        // is stored as written rather than parsed against the attribute's type.
+        const raw = entry.slice(split + 1);
+        if (/\{\{\s*[A-Za-z]/.test(raw)) {
+            attributes[key] = raw;
+            continue;
+        }
+        const parsed = parseAttributeInput(def, raw);
+        if (parsed.error)
+            throw new BoardError(`--set ${key}: ${parsed.error}`);
+        attributes[key] = parsed.value;
+    }
+    const template = createTemplate(board, {
+        type,
+        title: values.title,
+        description: values.description,
+        parentId: values.parent,
+        params,
+        attributes,
+    });
+    out(`${green('Created')} ${bold(template.id)}  ${template.title}`);
+    out(dim(`  ${template.file.replace(board.paths.root, '').replace(/^[\\/]/, '')}`));
+    return 0;
+}
+// -- apply -----------------------------------------------------------------
+function readParamsFile(file) {
+    let text;
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        throw new BoardError(`Cannot read ${file}`, [error.message]);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new BoardError(`${file} is not valid JSON`, [error.message]);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new BoardError(`${file} must hold a JSON object of parameter values`);
+    }
+    return parsed;
+}
+function apply(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            under: { type: 'string' },
+            params: { type: 'string' },
+            set: { type: 'string', multiple: true },
+            period: { type: 'string' },
+            assignee: { type: 'string' },
+            'dry-run': { type: 'boolean' },
+        },
+    });
+    const id = positionals[0];
+    if (!id)
+        throw new BoardError('Missing id', ['Usage: lpm template apply <TPL-id>']);
+    const board = requireBoard();
+    const template = requireTemplate(board, id);
+    const given = values.params ? readParamsFile(values.params) : {};
+    for (const entry of values.set ?? []) {
+        const split = entry.indexOf('=');
+        if (split < 1)
+            throw new BoardError(`Invalid --set "${entry}"`, ['Expected key=value.']);
+        const name = entry.slice(0, split).trim();
+        const def = template.params[name];
+        // An answer the template never asked for is refused by the planner, with a
+        // message listing what it does ask for; parsing it here would say less.
+        if (!def) {
+            given[name] = entry.slice(split + 1);
+            continue;
+        }
+        const parsed = parseAttributeInput(def, entry.slice(split + 1));
+        if (parsed.error)
+            throw new BoardError(`--set ${name}: ${parsed.error}`);
+        given[name] = parsed.value;
+    }
+    if (values.under && !findNode(board, values.under)) {
+        throw new BoardError(`No document with id "${values.under}"`);
+    }
+    const plan = planInstantiate(boardView(board), counterFactory(), template.id, {
+        parentId: values.under ?? null,
+        params: given,
+        period: values.period,
+        assignee: values.assignee,
+        validate: validateAttributeValue,
+    });
+    if (!plan.ok)
+        throw new BoardError(plan.error, plan.details);
+    if (values['dry-run']) {
+        out(`${yellow('Would create')} ${plural(plan.created.length, 'document')} from ${bold(template.id)}`);
+        for (const change of plan.changes) {
+            if (change.kind === 'create')
+                out(`  + ${change.patch.type}  ${change.patch.title}`);
+        }
+        return 0;
+    }
+    const { created } = runPlan(board, plan, 'Instantiate');
+    out(`${green('Applied')} ${bold(template.id)}  ${template.title}`);
+    printCreated(created, requireBoard(), 'new');
+    out(dim(`  ${plural(created.length, 'document')} created`));
+    return 0;
+}
+//# sourceMappingURL=template.js.map

package/dist/cli/commands/template.js.map

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

package/dist/cli/commands/ui.d.ts

@@ -0,0 +1,2 @@
+export declare const help = "Open the board in a web browser.\n\nUsage\n  lpm ui [options]\n\nOptions\n      --port <n>        Port to listen on (default 4571; 0 picks a free one)\n      --host <address>  Address to bind (default 127.0.0.1)\n      --no-open         Do not launch a browser\n      --api-only        Serve the API without the web app\n      --experimental    Also offer features that are not finished yet: mirroring\n                        the board onto Jira, GitHub or Linear (the Sync tab's\n                        tracker panel, its dialogs and the per-issue remote\n                        controls). Without it the Sync tab offers git sharing only.\n\nThe server is local-only and edits this checkout's .lpm folder. Stop it with\nCtrl-C; nothing is written to the board until you press Push in the app.";
+export declare function run(args: string[]): number;

package/dist/cli/commands/ui.js

@@ -0,0 +1,98 @@
+import { spawn } from 'node:child_process';
+import { parseArgs } from 'node:util';
+import { BoardError, findBoardPaths } from '../../core/index.js';
+import { DEFAULT_HOST, DEFAULT_PORT, startBoardServer } from '../../server/index.js';
+import { noBoardFound } from '../context.js';
+import { bold, dim, out, reportError } from '../ui.js';
+export const help = `Open the board in a web browser.
+
+Usage
+  lpm ui [options]
+
+Options
+      --port <n>        Port to listen on (default ${DEFAULT_PORT}; 0 picks a free one)
+      --host <address>  Address to bind (default ${DEFAULT_HOST})
+      --no-open         Do not launch a browser
+      --api-only        Serve the API without the web app
+      --experimental    Also offer features that are not finished yet: mirroring
+                        the board onto Jira, GitHub or Linear (the Sync tab's
+                        tracker panel, its dialogs and the per-issue remote
+                        controls). Without it the Sync tab offers git sharing only.
+
+The server is local-only and edits this checkout's .lpm folder. Stop it with
+Ctrl-C; nothing is written to the board until you press Push in the app.`;
+/** A bind address as somebody would type it into a browser. */
+function displayHost(host) {
+    return host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host;
+}
+/** Ask the desktop to open a URL, ignoring the failure when there is no desktop. */
+function openBrowser(url) {
+    const [command, args] = process.platform === 'win32'
+        ? ['cmd', ['/c', 'start', '', url]]
+        : process.platform === 'darwin'
+            ? ['open', [url]]
+            : ['xdg-open', [url]];
+    const child = spawn(command, args, { stdio: 'ignore', detached: true });
+    child.on('error', () => {
+        /* No browser here — the URL is printed anyway. */
+    });
+    child.unref();
+}
+export function run(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            port: { type: 'string' },
+            host: { type: 'string' },
+            'no-open': { type: 'boolean' },
+            'api-only': { type: 'boolean' },
+            experimental: { type: 'boolean' },
+        },
+    });
+    const paths = findBoardPaths();
+    if (!paths)
+        throw noBoardFound();
+    const port = values.port === undefined ? DEFAULT_PORT : Number(values.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new BoardError(`Invalid port "${values.port}"`);
+    }
+    const apiOnly = values['api-only'] === true;
+    const host = values.host ?? DEFAULT_HOST;
+    const experimental = values.experimental === true;
+    void startBoardServer(paths, {
+        port,
+        host,
+        serveApp: !apiOnly,
+        experimental,
+    })
+        .then(({ url }) => {
+        out(`${bold('light-plan')} ${dim(paths.root)}`);
+        out(`  ${url}`);
+        if (experimental)
+            out(dim('  experimental features on: tracker remotes (Jira, GitHub, Linear)'));
+        out(dim('  Ctrl-C to stop'));
+        if (!values['no-open'] && !apiOnly)
+            openBrowser(url);
+    })
+        .catch((error) => {
+        // **Reported, never thrown.** `run` has already returned by the time the
+        // socket answers, so a throw here lands in a promise nobody is holding:
+        // Node printed the `BoardError` as an unhandled rejection, stack and all,
+        // which reads as a crash for what is an ordinary answer ("something else
+        // is on that port"). Everything async in the CLI reports through
+        // `reportError` and sets the exit code itself.
+        const taken = error.code === 'EADDRINUSE';
+        reportError(new BoardError(taken ? `Port ${port} is already in use` : `Could not start the server: ${error.message}`, taken
+            ? [
+                'Pass --port <n> to use a different port.',
+                // Nearly always another `lpm ui` on the same checkout, and the
+                // useful thing then is the address rather than a second server.
+                `If that is another \`lpm ui\`, it is already serving http://${displayHost(host)}:${port}`,
+            ]
+            : ['Pass --port <n> to use a different port.']));
+        process.exitCode = 1;
+    });
+    // The process stays alive on the listening socket until Ctrl-C.
+    return 0;
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/commands/ui.js.map

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

package/dist/cli/commands/upstream.d.ts

@@ -0,0 +1,2 @@
+export declare const help = "Everything that has to happen before an issue can be closed.\n\nUsage\n  lpm upstream <id>              List the whole chain of work behind an issue\n  lpm upstream <id> --schedule   Put the unclaimed part of it in the same sprint\n\nOptions\n      --schedule          Schedule and assign the upstream work (see below)\n      --period <id>       Schedule into this period instead of the issue's own\n      --assignee <id>     Give it to this resource instead of the issue's own\n      --unscheduled       Assign only; do not write a period\n      --unassigned        Schedule only; do not write an assignee\n      --dry-run           Say what would happen, change nothing\n\n`lpm task next` tells you what is blocking an issue *today* and stops at the\nfirst thing. This is the whole chain behind that answer: what those blockers\nwait on, what those wait on, and the open work inside each blocking container.\nA container is finished when its contents are, so a feature standing in the way\nis really its unfinished stories standing in the way -- and they are what\nsomebody can actually be handed.\n\nFor a container, the report ends with what the work inside it puts it after:\nthe dependency between two stories puts the two features they sit in in the\nsame order, up to the container they share. Nothing is written on either\ncontainer -- both stand for the work inside them -- so that part of the report\nis read off the graph and is never scheduled by --schedule.\n\n--schedule pushes that work into the queue: every unclaimed upstream work unit\nis put in the same period as <id> and given to the same person or pool. Two\nrules, and both are deliberately narrow:\n\n  * Work somebody already holds is left alone, its period included. It is their\n    work, and moving it between sprints would be a worse surprise than a short\n    list. It is still reported, so you can see it.\n  * Only work units are scheduled. A period written on an epic offers nobody\n    anything, because the queue hands out units -- so containers are listed and\n    left as they are.\n\nExamples\n  lpm upstream LP-42\n  lpm upstream LP-42 --schedule\n  lpm upstream LP-42 --schedule --dry-run\n  lpm upstream LP-42 --schedule --assignee ana --period sprint-7";
+export declare function run(args: string[]): number;