@plexus-ms/lib 0.0.0-stage → 0.2.0

package/dist/catalog.d.ts

@@ -0,0 +1,23 @@
+import type { Context } from './context.ts';
+export interface Module {
+    code: string;
+    kind: 'contract' | 'approach';
+    maturity: string;
+    binds: string;
+    /** The train in which the module's requirements last changed; standard modules only. */
+    changed?: string;
+    /** Codes on the same side of every seam that a declaration of this module has to accompany. */
+    depends: string[];
+    /** Contracts on the other side of a seam; never the declaring unit's to satisfy. */
+    consumes: string[];
+}
+export type Catalog = Map<string, Module>;
+export declare const CATALOG_DIRS: {
+    readonly contracts: "contract";
+    readonly approaches: "approach";
+};
+/** The module a page declares, or undefined for a note. */
+export declare function parseModule(text: string, kind: Module['kind']): Module | undefined;
+/** Every module of a compendium checkout, by code. */
+export declare function readCatalog(ctx: Context, compendium: string): Promise<Catalog>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,YAAY;;;CAA6D,CAAC;AAEvF,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAYlF;AAMD,sDAAsD;AACtD,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpF"}

package/dist/catalog.js

@@ -0,0 +1,38 @@
+// The module catalogue: what the compendium's `contracts/` and `approaches/`
+// pages declare in their frontmatter (§ 1.3 PLX). Only pages with a `code`
+// are modules a marker can declare; notes have none and are skipped.
+import { join } from 'node:path';
+import { splitFrontmatter } from "./marker.js";
+export const CATALOG_DIRS = { contracts: 'contract', approaches: 'approach' };
+/** The module a page declares, or undefined for a note. */
+export function parseModule(text, kind) {
+    const { data } = splitFrontmatter(text);
+    if (typeof data.code !== 'string')
+        return undefined;
+    return {
+        code: data.code,
+        kind,
+        maturity: String(data.maturity ?? ''),
+        binds: String(data.binds ?? ''),
+        changed: data.changed === undefined ? undefined : String(data.changed),
+        depends: codes(data.depends),
+        consumes: codes(data.consumes),
+    };
+}
+function codes(value) {
+    return Array.isArray(value) ? value.map(String) : [];
+}
+/** Every module of a compendium checkout, by code. */
+export async function readCatalog(ctx, compendium) {
+    const catalog = new Map();
+    for (const [dir, kind] of Object.entries(CATALOG_DIRS)) {
+        const entries = await ctx.readDir(join(compendium, dir));
+        for (const e of entries.filter((e) => !e.directory && e.name.endsWith('.md') && e.name !== 'index.md').sort()) {
+            const module = parseModule(await ctx.readFile(join(compendium, dir, e.name)), kind);
+            if (module)
+                catalog.set(module.code, module);
+        }
+    }
+    return catalog;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiB/C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAW,CAAC;AAEvF,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAoB;IAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACtE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY,EAAE,UAAkB;IAChE,MAAM,OAAO,GAAY,IAAI,GAAG,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9G,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACpF,IAAI,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,41 @@
+import { type DirEntry, type ExecOptions, type Io } from './io.ts';
+import { type Plan } from './plan.ts';
+export interface Options {
+    dryRun?: boolean;
+    /** 0: every effect; 1: reads and inputs too; 2: subprocess output too. */
+    verbose?: number;
+    quiet?: boolean;
+    yes?: boolean;
+    json?: boolean;
+}
+export declare class Context {
+    readonly dryRun: boolean;
+    readonly verbose: number;
+    readonly quiet: boolean;
+    readonly yes: boolean;
+    readonly json: boolean;
+    readonly io: Io;
+    constructor(options: Options, io?: Io);
+    /** One line, if the verbosity allows the level (0 normal, 1 verbose, 2 debug). */
+    say(line: string, level?: number): void;
+    /** A final outcome line, `✓ ...` or `✗ ...`; shown even under --quiet. */
+    done(line: string, ok?: boolean): void;
+    /**
+     * The command's product. `data` is what --json prints; `human` renders it
+     * otherwise (default: strings as they are, arrays one item per line).
+     */
+    result<T>(data: T, human?: (data: T) => string): void;
+    /** Run a command for its output. Changes nothing; narrated only when verbose. */
+    read(command: string, args?: string[], options?: Omit<ExecOptions, 'inherit'>): Promise<string>;
+    readFile(path: string): Promise<string>;
+    readDir(path: string): Promise<DirEntry[]>;
+    /**
+     * Ask before applying. `--yes` and `--dry-run` answer yes; off a terminal
+     * without `--yes` the answer is an error, never a hang.
+     */
+    confirm(question: string): Promise<boolean>;
+    /** Narrate and perform each step in order; the first failure stops the run. */
+    apply(plan: Plan): Promise<void>;
+    private perform;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,EAAE,EAAU,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAkB,KAAK,IAAI,EAAa,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;gBAEJ,OAAO,EAAE,OAAO,EAAE,EAAE,GAAE,EAAa;IAW/C,kFAAkF;IAClF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAIlC,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAO,GAAG,IAAI;IAMnC;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAoB,GAAG,IAAI;IAOlE,iFAAiF;IACjF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAO1C;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD,+EAA+E;IACzE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,OAAO,CAAC,OAAO;CAWhB"}

package/dist/context.js

@@ -0,0 +1,115 @@
+// The Context is what a verb runs in: the options, the injected Io, and the
+// three things a verb does with them.
+//
+//   read   look at the world; always performed, so a dry run sees real state
+//   apply  perform a Plan (plan.ts); every step is narrated with its exact
+//          shell line, and performed unless --dry-run
+//   result print the command's product: human-readable, or JSON under --json
+//
+// Plan, then confirm, then apply: validation and every read happen while
+// planning, so a failure there costs nothing, and by the time an effect runs
+// the verb knows the whole of what it is about to do. Narration goes to
+// stderr, results to stdout, so `plx <verb> | ...` composes like the script
+// it replaces. Conventions: compendium/miscellaneous/cli-design.md.
+import { realIo } from "./io.js";
+import { body, describe } from "./plan.js";
+export class Context {
+    dryRun;
+    verbose;
+    quiet;
+    yes;
+    json;
+    io;
+    constructor(options, io = realIo()) {
+        this.io = io;
+        this.dryRun = options.dryRun ?? false;
+        this.quiet = options.quiet ?? false;
+        this.verbose = this.quiet ? -1 : (options.verbose ?? 0);
+        this.yes = options.yes ?? false;
+        this.json = options.json ?? false;
+    }
+    // --- narration (stderr) ---------------------------------------------------
+    /** One line, if the verbosity allows the level (0 normal, 1 verbose, 2 debug). */
+    say(line, level = 0) {
+        if (this.verbose >= level)
+            this.io.stderr.write(`${line}\n`);
+    }
+    /** A final outcome line, `✓ ...` or `✗ ...`; shown even under --quiet. */
+    done(line, ok = true) {
+        this.io.stderr.write(`${ok ? '✓' : '✗'} ${line}\n`);
+    }
+    // --- results (stdout) -----------------------------------------------------
+    /**
+     * The command's product. `data` is what --json prints; `human` renders it
+     * otherwise (default: strings as they are, arrays one item per line).
+     */
+    result(data, human = renderHuman) {
+        const text = this.json ? JSON.stringify(data, null, 2) : human(data);
+        this.io.stdout.write(text.endsWith('\n') ? text : `${text}\n`);
+    }
+    // --- reads: always performed ---------------------------------------------
+    /** Run a command for its output. Changes nothing; narrated only when verbose. */
+    read(command, args = [], options = {}) {
+        this.say(`? ${describe({ kind: 'run', command, args, ...options })}`, 1);
+        return this.io.exec(command, args, options);
+    }
+    readFile(path) {
+        this.say(`? read ${path}`, 1);
+        return this.io.readFile(path);
+    }
+    readDir(path) {
+        this.say(`? list ${path}`, 2);
+        return this.io.readDir(path);
+    }
+    // --- effects: narrated always, performed unless --dry-run -----------------
+    /**
+     * Ask before applying. `--yes` and `--dry-run` answer yes; off a terminal
+     * without `--yes` the answer is an error, never a hang.
+     */
+    async confirm(question) {
+        if (this.yes || this.dryRun) {
+            this.say(`? ${question} yes (${this.yes ? '--yes' : '--dry-run'})`, 1);
+            return true;
+        }
+        if (!this.io.prompt)
+            throw new Error(`cannot ask "${question}" without a terminal; pass --yes`);
+        return this.io.prompt(question);
+    }
+    /** Narrate and perform each step in order; the first failure stops the run. */
+    async apply(plan) {
+        for (const step of plan) {
+            this.say(`${this.dryRun ? '[dry-run] ' : ''}${describe(step)}`);
+            const input = body(step);
+            if (input !== undefined)
+                this.say(indent(input), step.kind === 'write' ? 2 : 1);
+            if (!this.dryRun)
+                await this.perform(step);
+        }
+    }
+    perform(step) {
+        const inherit = this.verbose >= 2;
+        switch (step.kind) {
+            case 'run':
+                return this.io.exec(step.command, step.args, { cwd: step.cwd, input: step.input, inherit });
+            case 'ssh':
+                return this.io.exec('ssh', [step.host, 'bash', '-s'], { input: step.script, inherit });
+            case 'write':
+                return this.io.writeFile(step.path, step.content);
+        }
+    }
+}
+function renderHuman(data) {
+    if (typeof data === 'string')
+        return data;
+    if (Array.isArray(data))
+        return data.map(String).join('\n');
+    return JSON.stringify(data, null, 2);
+}
+function indent(text) {
+    return text
+        .trimEnd()
+        .split('\n')
+        .map((l) => `    ${l}`)
+        .join('\n');
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/copier.d.ts

@@ -0,0 +1,12 @@
+export declare const ANSWERS_FILE = ".copier-answers.yml";
+export declare const TEMPLATE_FILES: string[];
+export interface Answers {
+    /** The template's ref the project was last updated to, if recorded. */
+    commit?: string;
+    /** Where the template comes from, e.g. `gh:plexus-ms/preset-repo-web`. */
+    src?: string;
+    /** Every other answer, by question name. */
+    answers: Record<string, unknown>;
+}
+export declare function parseAnswers(text: string): Answers;
+//# sourceMappingURL=copier.d.ts.map

package/dist/copier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copier.d.ts","sourceRoot":"","sources":["../src/copier.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAClD,eAAO,MAAM,cAAc,UAAgC,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlD"}

package/dist/copier.js

@@ -0,0 +1,19 @@
+// Copier's bookkeeping in a generated project (§ 3 PLX-Updates): the answers
+// file records the template (`_src_path`) and the version it was last synced
+// to (`_commit`), plus the answers given. A template is a directory carrying a
+// `copier.yml`.
+import { parse } from 'yaml';
+export const ANSWERS_FILE = '.copier-answers.yml';
+export const TEMPLATE_FILES = ['copier.yml', 'copier.yaml'];
+export function parseAnswers(text) {
+    const data = parse(text);
+    if (data === null || typeof data !== 'object' || Array.isArray(data))
+        throw new Error('answers file is not a mapping');
+    const { _commit, _src_path, ...answers } = data;
+    return {
+        commit: _commit === undefined ? undefined : String(_commit),
+        src: _src_path === undefined ? undefined : String(_src_path),
+        answers,
+    };
+}
+//# sourceMappingURL=copier.js.map

package/dist/copier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copier.js","sourceRoot":"","sources":["../src/copier.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,gBAAgB;AAChB,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAW5D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAY,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,IAA+B,CAAC;IAC3E,OAAO;QACL,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3D,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;QAC5D,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,19 @@
+import type { Catalog } from './catalog.ts';
+import type { Directory } from './model.ts';
+export interface Diagnosis {
+    /** The marker's directory, relative to the scanned root. */
+    path: string;
+    plexus?: string;
+    modules: string[];
+    findings: string[];
+}
+export interface Report {
+    declarations: Diagnosis[];
+    /** Declarations with at least one finding. */
+    stale: number;
+}
+/** A scanned tree against a catalogue: pure, so a test compares reports. */
+export declare function diagnose(root: Directory, catalog: Catalog): Report;
+/** Numeric comparison of two train versions; suffixes ignored. */
+export declare function compareTrains(a: string, b: string): number;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIlE;AA4DD,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1D"}

package/dist/doctor.js

@@ -0,0 +1,79 @@
+// doctor: the staleness check (§ 13.4 PLX), a verb, not a system.
+//
+// Every PLEXUS.md marker under a directory is read, and for each module it
+// declares the module's `changed` train is compared with the marker's
+// `plexus`; every `depends` entry of a declared module has to be declared
+// where § 1.4 says it is satisfied: by the unit itself, by an enclosing
+// declaration (an app's repo, a repo's tenant) or by a contained one (a
+// repo's apps, a tenant's repos). What a module `consumes` is the other side
+// of a seam and never this unit's to declare. Findings are reported, never
+// fixed. A tenant is a directory whose repos sit side by side; the repo whose
+// marker declares PLX-Tenancy is the tenant's declaration.
+//
+//   plx doctor                              # every marker, one line each
+//   plx doctor ~/dev --compendium ~/dev/plexus-ms/compendium
+import { relative } from 'node:path';
+/** A scanned tree against a catalogue: pure, so a test compares reports. */
+export function diagnose(root, catalog) {
+    const units = collect(root, []);
+    const declarations = units.map((u) => diagnoseUnit(u, units, catalog, root.path));
+    return { declarations, stale: declarations.filter((d) => d.findings.length > 0).length };
+}
+function collect(dir, ancestors, parent) {
+    const here = dir.declaration || dir.problems?.some((p) => p.startsWith('PLEXUS.md')) ? [{ dir, ancestors, parent }] : [];
+    const below = dir.declaration ? [...ancestors, dir] : ancestors;
+    return [...here, ...dir.children.flatMap((c) => collect(c, below, dir))];
+}
+function diagnoseUnit(unit, units, catalog, root) {
+    const { dir } = unit;
+    const path = relative(root, dir.path) || '.';
+    const problem = dir.problems?.find((p) => p.startsWith('PLEXUS.md'));
+    if (!dir.declaration)
+        return { path, modules: [], findings: [problem?.replace(/^PLEXUS\.md: /, '') ?? 'unreadable marker'] };
+    const { plexus, modules } = dir.declaration;
+    const context = new Set(contextOf(unit, units).flatMap((d) => d.declaration?.modules ?? []));
+    const findings = [];
+    for (const code of modules) {
+        const module = catalog.get(code);
+        if (!module) {
+            findings.push(`declares ${code}, which no module carries`);
+            continue;
+        }
+        if (module.changed && compareTrains(module.changed, plexus) > 0)
+            findings.push(`${code} changed in ${module.changed}, declared at ${plexus}`);
+        for (const dep of module.depends)
+            if (!modules.includes(dep) && !context.has(dep))
+                findings.push(`${code} depends on ${dep}, declared neither here nor by an enclosing or contained declaration`);
+    }
+    return { path, plexus, modules, findings };
+}
+/** The declarations that may satisfy a unit's dependencies: enclosing and contained ones (§ 1.4 PLX). */
+function contextOf(unit, units) {
+    const { dir, ancestors } = unit;
+    const context = [...ancestors, ...descendants(dir)];
+    // The tenant: the repo's siblings. A unit inside a repo belongs to that repo; a repo is its own.
+    const repo = ancestors[0] ?? dir;
+    const repoParent = units.find((u) => u.dir === repo)?.parent;
+    const siblings = repoParent?.children.filter((c) => c !== repo && c.declaration) ?? [];
+    const isTenancy = (d) => d.declaration?.modules.includes('PLX-Tenancy') ?? false;
+    context.push(...siblings.filter(isTenancy));
+    if (isTenancy(dir))
+        context.push(...siblings);
+    return context;
+}
+function descendants(dir) {
+    return dir.children.flatMap((c) => [...(c.declaration ? [c] : []), ...descendants(c)]);
+}
+/** Numeric comparison of two train versions; suffixes ignored. */
+export function compareTrains(a, b) {
+    const nums = (v) => v
+        .split('.')
+        .slice(0, 3)
+        .map((p) => Number.parseInt(p, 10) || 0);
+    const [x, y] = [nums(a), nums(b)];
+    for (let i = 0; i < 3; i++)
+        if ((x[i] ?? 0) !== (y[i] ?? 0))
+            return (x[i] ?? 0) > (y[i] ?? 0) ? 1 : -1;
+    return 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { CATALOG_DIRS, type Catalog, type Module, parseModule, readCatalog } from './catalog.ts';
+export { Context, type Options } from './context.ts';
+export { ANSWERS_FILE, type Answers, parseAnswers, TEMPLATE_FILES } from './copier.ts';
+export { compareTrains, type Diagnosis, diagnose, type Report } from './doctor.ts';
+export { type DirEntry, ExecError, type ExecOptions, type Io, realIo, render } from './io.ts';
+export { type Declaration, MARKER_FILE, parseMarker, splitFrontmatter } from './marker.ts';
+export { type Directory, type GitFacet, isNotable, type Kind, kindOf, shortRemote, type TemplateFacet, } from './model.ts';
+export { overview, PRUNED, type ScanOptions } from './overview.ts';
+export { body, describe, type Plan, run, type Step, ssh, write } from './plan.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,KAAK,QAAQ,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EACL,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,SAAS,EACT,KAAK,IAAI,EACT,MAAM,EACN,WAAW,EACX,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// @plexus-ms/lib: the core layer of plx, usable without the CLI.
+//
+// A verb here is either a reader returning data, or a pure planner returning
+// a Plan (plan.ts) from what was read. The Context (context.ts) reads through
+// an injected Io (io.ts) and applies plans, narrating every step; the CLI
+// package is an adapter that maps argv onto this. The parsers of Plexus's own
+// file shapes (marker.ts, copier.ts) live here, once, for every verb.
+// Conventions: compendium/miscellaneous/cli-design.md.
+export { CATALOG_DIRS, parseModule, readCatalog } from "./catalog.js";
+export { Context } from "./context.js";
+export { ANSWERS_FILE, parseAnswers, TEMPLATE_FILES } from "./copier.js";
+export { compareTrains, diagnose } from "./doctor.js";
+export { ExecError, realIo, render } from "./io.js";
+export { MARKER_FILE, parseMarker, splitFrontmatter } from "./marker.js";
+export { isNotable, kindOf, shortRemote, } from "./model.js";
+export { overview, PRUNED } from "./overview.js";
+export { body, describe, run, ssh, write } from "./plan.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,sEAAsE;AACtE,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAA6B,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAgB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,aAAa,EAAkB,QAAQ,EAAe,MAAM,aAAa,CAAC;AACnF,OAAO,EAAiB,SAAS,EAA6B,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAoB,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAGL,SAAS,EAET,MAAM,EACN,WAAW,GAEZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAa,GAAG,EAAa,GAAG,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,40 @@
+import type { Writable } from 'node:stream';
+export interface ExecOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Fed to the process's stdin, then closed. */
+    input?: string;
+    /** Pass the process's output through to the terminal instead of capturing it. */
+    inherit?: boolean;
+}
+export interface Io {
+    stdout: Writable;
+    stderr: Writable;
+    /**
+     * Ask a yes/no question of a human, or undefined when there is none: off a
+     * terminal, or in a program that brings no prompt (the CLI supplies one).
+     */
+    prompt?: (question: string) => Promise<boolean>;
+    /** Run a process to completion; resolves with its stdout, rejects with ExecError on nonzero exit. */
+    exec(command: string, args: string[], options?: ExecOptions): Promise<string>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    /** The entries of a directory, in no particular order. */
+    readDir(path: string): Promise<DirEntry[]>;
+}
+export interface DirEntry {
+    name: string;
+    directory: boolean;
+}
+export declare class ExecError extends Error {
+    readonly command: string;
+    readonly code: number | null;
+    readonly stderr: string;
+    constructor(command: string, code: number | null, stderr: string);
+}
+/** True when a human is on both ends of the terminal. */
+export declare const isInteractive: () => boolean;
+export declare function realIo(prompt?: Io['prompt']): Io;
+/** The command line as a shell would need it typed: args quoted when they must be. */
+export declare function render(command: string, args: string[]): string;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,EAAE;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,qGAAqG;IACrG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,0DAA0D;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;CAMjE;AAED,yDAAyD;AACzD,eAAO,MAAM,aAAa,QAAO,OAAwE,CAAC;AAE1G,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAiChD;AAED,sFAAsF;AACtF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D"}

package/dist/io.js

@@ -0,0 +1,62 @@
+// Everything a verb does to the world goes through an Io, injected into the
+// Context (context.ts). The real one wraps node; a test hands in a fake and
+// asserts what was asked of it, with no subprocess and no filesystem.
+import { spawn } from 'node:child_process';
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+export class ExecError extends Error {
+    command;
+    code;
+    stderr;
+    constructor(command, code, stderr) {
+        super(`${command} exited with ${code ?? 'signal'}${stderr ? `\n${stderr.trimEnd()}` : ''}`);
+        this.command = command;
+        this.code = code;
+        this.stderr = stderr;
+    }
+}
+/** True when a human is on both ends of the terminal. */
+export const isInteractive = () => process.stdin.isTTY === true && process.stderr.isTTY === true;
+export function realIo(prompt) {
+    return {
+        stdout: process.stdout,
+        stderr: process.stderr,
+        prompt: prompt && isInteractive() ? prompt : undefined,
+        exec: (command, args, options = {}) => new Promise((resolve, reject) => {
+            const child = spawn(command, args, {
+                cwd: options.cwd,
+                env: options.env,
+                stdio: [options.input === undefined ? 'ignore' : 'pipe', options.inherit ? 'inherit' : 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (chunk) => {
+                stdout += chunk;
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += chunk;
+                if (options.inherit)
+                    process.stderr.write(chunk);
+            });
+            child.on('error', reject);
+            child.on('close', (code) => {
+                if (code === 0)
+                    resolve(stdout);
+                else
+                    reject(new ExecError(render(command, args), code, stderr));
+            });
+            if (options.input !== undefined)
+                child.stdin?.end(options.input);
+        }),
+        readFile: (path) => readFile(path, 'utf8'),
+        writeFile: (path, content) => writeFile(path, content),
+        readDir: async (path) => (await readdir(path, { withFileTypes: true })).map((e) => ({ name: e.name, directory: e.isDirectory() })),
+    };
+}
+/** The command line as a shell would need it typed: args quoted when they must be. */
+export function render(command, args) {
+    return [command, ...args].map(quote).join(' ');
+}
+function quote(arg) {
+    return /^[\w./:@%+=,-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", "'\\''")}'`;
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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

package/dist/marker.d.ts

@@ -0,0 +1,16 @@
+export interface Declaration {
+    /** The Plexus version the unit was last brought up to, e.g. `0.62.0`. */
+    plexus: string;
+    /** The module codes it follows, e.g. `PLX-Repo`. */
+    modules: string[];
+    /** The prose after the frontmatter: what the unit is, and its owned deviations. */
+    body: string;
+}
+export declare const MARKER_FILE = "PLEXUS.md";
+export declare function parseMarker(text: string): Declaration;
+/** The YAML between the leading `---` lines, as a plain object, and the rest. */
+export declare function splitFrontmatter(text: string): {
+    data: Record<string, unknown>;
+    body: string;
+};
+//# sourceMappingURL=marker.d.ts.map

package/dist/marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../src/marker.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,WAAW,cAAc,CAAC;AAEvC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQrD;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM9F"}

package/dist/marker.js

@@ -0,0 +1,26 @@
+// The declaration marker, PLEXUS.md (§ 1.4 PLX): YAML frontmatter with the
+// Plexus version and the declared modules, then free-form prose. This is the
+// one reader of that shape; every verb that needs a marker parses it here.
+import { parse } from 'yaml';
+export const MARKER_FILE = 'PLEXUS.md';
+export function parseMarker(text) {
+    const { data, body } = splitFrontmatter(text);
+    const plexus = data.plexus;
+    const modules = data.modules;
+    if (typeof plexus !== 'string' && typeof plexus !== 'number')
+        throw new Error('marker: `plexus` must be a version');
+    if (!Array.isArray(modules) || !modules.every((m) => typeof m === 'string'))
+        throw new Error('marker: `modules` must be a list of module codes');
+    return { plexus: String(plexus), modules, body };
+}
+/** The YAML between the leading `---` lines, as a plain object, and the rest. */
+export function splitFrontmatter(text) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/.exec(text);
+    if (!match)
+        throw new Error('no frontmatter: expected a `---` block at the top');
+    const data = parse(match[1] ?? '');
+    if (data === null || typeof data !== 'object' || Array.isArray(data))
+        throw new Error('frontmatter is not a mapping');
+    return { data: data, body: match[2] ?? '' };
+}
+//# sourceMappingURL=marker.js.map

package/dist/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../src/marker.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAW7B,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AAEvC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACpH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,kDAAkD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACjF,MAAM,IAAI,GAAY,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACtH,OAAO,EAAE,IAAI,EAAE,IAA+B,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACzE,CAAC"}