@plexus-ms/lib 0.1.0 → 0.3.0

package/dist/requirements.js

@@ -0,0 +1,188 @@
+// The requirements check (§ 1.8 PLX), the compendium's `requirements.sh`
+// moved: a verb, not a system.
+//
+//   scanPage        one page: its defects, and for a standard module its
+//                   requirement lines, `§ <section> <text>`, in page order
+//   checkCompendium the map and every module page, plus the cross-page rules:
+//                   unique codes, known dependencies, dependencies that respect
+//                   the seams (§ 1.3 PLX)
+//
+// The map carries no requirements and no BCP 14 keyword. A module at standard
+// maturity carries its requirements as blockquoted bullets ("> - ") under
+// numbered section headings; a keyword anywhere else, a blockquote that is not
+// such a bullet, or any keyword or blockquote in a module below standard
+// maturity is a defect. The trailing "## Maintaining" section is prose
+// throughout. Extraction is structural: no classification, no heuristics.
+// `ship` compares a module's extracted lines across trains to stamp `changed`,
+// so the extractor and the linter are one function and cannot disagree.
+//
+//   plx requirements <compendium>              # lint; exit 1 on any defect
+//   plx requirements --extract contracts/app.md
+import { join } from 'node:path';
+import { CATALOG_DIRS } from "./catalog.js";
+const KEYWORD = /MUST|SHOULD|MAY/;
+/** A BCP 14 keyword in a line, the informal plurals (MUSTs, SHOULDs, MAYs) not counting. */
+const hasKeyword = (line) => KEYWORD.test(line.replace(/MUSTs|SHOULDs|MAYs/g, ''));
+/** A bracketed, comma-separated list as the frontmatter writes it: `[A, B]`. */
+const list = (value) => value
+    .replace(/^\s*\[/, '')
+    .replace(/\].*$/, '')
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+export function scanPage(text, name, mode) {
+    const scan = { defects: [], requirements: [], depends: [], consumes: [] };
+    const lines = text.split('\n');
+    const defect = (n, msg) => scan.defects.push(`✗ ${name}: line ${n + 1}: ${msg}`);
+    let i = 0;
+    if (lines[0] === '---') {
+        for (i = 1; i < lines.length && lines[i] !== '---'; i++) {
+            const line = lines[i] ?? '';
+            const [key = '', ...rest] = line.split(/\s+/);
+            const value = rest.join(' ');
+            if (key === 'maturity:')
+                scan.maturity = rest[0];
+            else if (key === 'code:')
+                scan.code = rest[0];
+            else if (key === 'binds:')
+                scan.binds = rest[0];
+            else if (key === 'depends:')
+                scan.depends = list(value);
+            else if (key === 'consumes:')
+                scan.consumes = list(value);
+            else if (key === 'kind:')
+                defect(i, 'kind is the folder, contracts/ or approaches/, not a field');
+        }
+        i++;
+    }
+    let inCode = false;
+    let maintaining = false;
+    let started = false;
+    let section = '';
+    for (; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (line.startsWith('```')) {
+            inCode = !inCode;
+            continue;
+        }
+        if (inCode)
+            continue;
+        if (line === '## Maintaining') {
+            maintaining = true;
+            section = '';
+            continue;
+        }
+        const heading = /^#+ § (\S+)/.exec(line);
+        if (heading) {
+            if (maintaining)
+                defect(i, 'numbered section after Maintaining');
+            section = heading[1] ?? '';
+            started = true;
+            continue;
+        }
+        if (line.startsWith('> - ')) {
+            if (mode === 'map')
+                defect(i, `requirement in the map: ${line}`);
+            else if (scan.maturity !== 'standard')
+                defect(i, `requirement in a module at ${scan.maturity} maturity: ${line}`);
+            else if (maintaining)
+                defect(i, `requirement under Maintaining: ${line}`);
+            else if (!started)
+                defect(i, 'requirement before the first § heading');
+            else
+                scan.requirements.push(`§ ${section} ${line.slice(4)}`);
+            continue;
+        }
+        if (line.startsWith('>')) {
+            defect(i, 'blockquote line is not a "> - " requirement bullet');
+            continue;
+        }
+        if (hasKeyword(line))
+            defect(i, `BCP 14 keyword outside a requirement: ${line}`);
+    }
+    if (mode === 'module') {
+        const { maturity = '', binds = '', code = '' } = scan;
+        // Reported at the page's last line, like awk's NR at END.
+        const n = text.endsWith('\n') ? lines.length - 1 : lines.length;
+        if (!/^(note|candidate|standard)$/.test(maturity))
+            defect(n - 1, `maturity must be note, candidate or standard, not "${maturity}"`);
+        if (!/^(repo|app|host|organisation)$/.test(binds))
+            defect(n - 1, `binds must be repo, app, host or organisation, not "${binds}"`);
+        if (maturity === 'note' && code !== '')
+            defect(n - 1, 'a note carries no code');
+        if (maturity !== 'note' && !/^PLX-[A-Z][A-Za-z]+$/.test(code))
+            defect(n - 1, `code must be PLX- plus one capitalised word, not "${code}"`);
+    }
+    return scan;
+}
+/** The requirement lines of a page, defects ignored: what `changed` compares across trains. */
+export const extractRequirements = (text) => scanPage(text, '', 'module').requirements;
+export const MAP_PAGE = 'essentials/standard.md';
+/** Every module page of a compendium checkout: `<dir>/<file>`, sorted, index pages left out. */
+export async function modulePages(ctx, compendium) {
+    const pages = [];
+    for (const dir of Object.keys(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())
+            pages.push(`${dir}/${e.name}`);
+    }
+    return pages;
+}
+export async function checkCompendium(ctx, compendium) {
+    const defects = [];
+    defects.push(...scanPage(await ctx.readFile(join(compendium, MAP_PAGE)), MAP_PAGE, 'map').defects);
+    const pages = await modulePages(ctx, compendium);
+    const scans = new Map();
+    for (const page of pages) {
+        const scan = scanPage(await ctx.readFile(join(compendium, page)), page, 'module');
+        defects.push(...scan.defects);
+        scans.set(page, scan);
+    }
+    // Module codes are unique across pages.
+    const byCode = new Map();
+    for (const [page, s] of scans)
+        if (s.code)
+            byCode.set(s.code, [...(byCode.get(s.code) ?? []), page]);
+    for (const [code, where] of byCode)
+        if (where.length > 1)
+            defects.push(`✗ duplicate module code: ${code}`);
+    // Every declared dependency names a module that exists.
+    for (const s of scans.values())
+        for (const dep of s.depends)
+            if (!byCode.has(dep))
+                defects.push(`✗ unknown module in depends: ${dep}`);
+    // Dependencies respect the seams (§ 1.3 PLX): a contract depends only on
+    // contracts, a dependency never crosses from the dev side (repo, app) to the
+    // ops side (host, organisation) or back, and what crosses a seam is listed
+    // under consumes and is a contract.
+    const kindOf = (page) => (page.startsWith('contracts/') ? 'contract' : 'approach');
+    const side = (binds) => (binds === 'repo' || binds === 'app' ? 'dev' : 'ops');
+    const kinds = new Map([...byCode].map(([code, [page = '']]) => [code, kindOf(page)]));
+    const binds = new Map([...byCode].map(([code, [page = '']]) => [code, scans.get(page)?.binds ?? '']));
+    for (const [page, s] of scans) {
+        const m = s.code ?? page.replace(/.*\//, '');
+        const kind = kindOf(page);
+        for (const c of s.consumes) {
+            if (kind === 'contract')
+                defects.push(`✗ ${m} is a contract and consumes ${c}; a contract has no other side to consume`);
+            else if (kinds.has(c) && kinds.get(c) !== 'contract')
+                defects.push(`✗ ${m} consumes ${c}, which is an approach; only a contract is consumed across a seam`);
+            else if (!kinds.has(c))
+                defects.push(`✗ ${m} consumes unknown module ${c}`);
+        }
+        for (const d of s.depends) {
+            if (!kinds.has(d))
+                continue;
+            if (kind === 'contract' && kinds.get(d) !== 'contract')
+                defects.push(`✗ ${m} is a contract and depends on the approach ${d}`);
+            if (side(s.binds ?? '') !== side(binds.get(d) ?? '') && kinds.get(d) !== 'contract')
+                defects.push(`✗ ${m} (${s.binds}) depends on ${d} (${binds.get(d)}) across the dev/ops seam; only a contract may be depended on across a seam`);
+        }
+    }
+    return {
+        defects,
+        contracts: pages.filter((p) => p.startsWith('contracts/')).length,
+        approaches: pages.filter((p) => p.startsWith('approaches/')).length,
+    };
+}
+//# sourceMappingURL=requirements.js.map

package/dist/requirements.js.map

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

package/dist/ship.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from './context.ts';
+import { type Summary } from './propagate.ts';
+export interface ShipOptions {
+    /** The workspace: the upstream umbrella and the consumers sit under it. */
+    workspace: string;
+    /** The train version; default: minor+1 over the latest, or the current one when only propagating. */
+    train?: string;
+    /** Skip the release; only propagate to the consumers. */
+    propagateOnly?: boolean;
+    /** The date stamped on the map, `YYYY-MM-DD`; default: today. */
+    today?: string;
+}
+export interface ShipResult extends Summary {
+    /** The version released, or already current when only propagating. */
+    released: boolean;
+}
+export declare function ship(ctx: Context, options: ShipOptions): Promise<ShipResult>;
+//# sourceMappingURL=ship.d.ts.map

package/dist/ship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../src/ship.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIzD,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CASlF"}

package/dist/ship.js

@@ -0,0 +1,131 @@
+// ship: the release train (§ 1.5 PLX). Every train repo ships under ONE
+// version, tagged identically whether or not it changed:
+//
+//   preflight (every train repo on main, clean, not behind origin, the latest
+//   tags in agreement) → write the train bookkeeping (bookkeeping.ts: galaxy
+//   version, the preset's collection pin, workflow-ref examples, the map's
+//   version and timestamp, `changed` on every standard module whose extracted
+//   requirements moved) and commit it → tag every train repo → push →
+//   propagate to every consumer (propagate.ts).
+//
+// Substance commits stay human; ship writes only the mechanical bookkeeping.
+// A failure between the first tag and the last push leaves a half-tagged
+// train; the recovery is a re-run naming the same version, which skips the
+// repos already tagged and pushes the rest.
+//
+//   plx ship ~/dev                    # next train = minor+1 over the latest
+//   plx ship ~/dev --train 1.0.0      # explicit train version
+//   plx -n ship ~/dev                 # preview: list the bookkeeping, tags and
+//                                     # the propagation in scratch clones
+//   plx -y ship ~/dev                 # unattended: no prompt, copier takes defaults
+import { join } from 'node:path';
+import { bumpCollectionPin, bumpGalaxyVersion, bumpWorkflowRefs, stampChanged, stampStandard, today as todayOf, WORKFLOW_REF, } from "./bookkeeping.js";
+import { frontmatterField } from "./frontmatter.js";
+import { run, write } from "./plan.js";
+import { propagate } from "./propagate.js";
+import { extractRequirements, MAP_PAGE, modulePages } from "./requirements.js";
+import { preflightRelease, readTrain, resolveVersion, UPSTREAM } from "./train.js";
+export async function ship(ctx, options) {
+    const upstream = join(options.workspace, UPSTREAM);
+    const propagateOnly = options.propagateOnly ?? false;
+    const train = await readTrain(ctx, upstream);
+    if (!propagateOnly)
+        await preflightRelease(ctx, train);
+    const next = resolveVersion(train, options.train, propagateOnly);
+    if (!propagateOnly)
+        await release(ctx, train, next, options.today ?? todayOf());
+    const summary = await propagate(ctx, options.workspace, next);
+    return { ...summary, released: !propagateOnly };
+}
+async function release(ctx, train, next, today) {
+    ctx.say(`→ train ${train.last ?? 'none'} → ${next}`);
+    for (const repo of train.repos) {
+        if (repo.pending.length === 0)
+            ctx.say(`  ${repo.name}: no changes since ${repo.latest} — tag only`);
+        else {
+            ctx.say(`  ${repo.name} (since ${repo.latest ?? 'the beginning'}):`);
+            for (const line of repo.pending)
+                ctx.say(`    ${line}`);
+        }
+    }
+    if (!(await ctx.confirm(`tag all ${train.repos.length} repos as ${next} and push?`)))
+        throw new Error('aborted');
+    try {
+        const plan = await planBookkeeping(ctx, train, next, today);
+        await ctx.apply(plan);
+        for (const repo of train.repos) {
+            const tagged = await ctx
+                .read('git', ['rev-parse', '-q', '--verify', `refs/tags/${next}`], { cwd: repo.path })
+                .then(() => true)
+                .catch(() => false);
+            if (tagged)
+                ctx.say(`• ${repo.name}: already tagged ${next}`);
+            else
+                await ctx.apply([run('git', ['tag', '-a', next, '-m', `train ${next}`], { cwd: repo.path })]);
+            await ctx.apply([run('git', ['push', 'origin', 'main', next], { cwd: repo.path })]);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${message}\n✗ ship stopped during the release; re-run with --train ${next} to finish it (tagged repos are skipped)`);
+    }
+}
+/** The bookkeeping writes, then one commit per train repo that has any. */
+async function planBookkeeping(ctx, train, next, today) {
+    const plan = [];
+    const touched = new Set();
+    const repo = (name) => {
+        const r = train.repos.find((r) => r.name === name);
+        if (!r)
+            throw new Error(`${name} is not a train repo`);
+        return r;
+    };
+    /** Plan a write when the transform changes the file, saying what it does; a missing file is left alone. */
+    const edit = async (r, rel, what, transform) => {
+        const path = join(r.path, rel);
+        const text = await ctx.readFile(path).catch(() => undefined);
+        if (text === undefined)
+            return;
+        const edited = transform(text);
+        if (edited === text)
+            return;
+        ctx.say(`  ${r.name}: ${rel}: ${what}`);
+        plan.push(write(path, edited));
+        touched.add(r);
+    };
+    await edit(repo('platform'), 'ansible/galaxy.yml', `version → ${next}`, (t) => bumpGalaxyVersion(t, next));
+    // Only the plexus.platform collection's pin: a second collection in the same file stays untouched.
+    await edit(repo('preset-repo-platform'), 'template/requirements.yml', `plexus.platform pin → ${next}`, (t) => bumpCollectionPin(t, next));
+    for (const r of train.repos) {
+        const files = await ctx
+            .read('git', ['grep', '-l', WORKFLOW_REF, '--', '*.yml', '*.yaml', '*.jinja'], { cwd: r.path })
+            .catch(() => '');
+        for (const f of files.split('\n').filter(Boolean))
+            await edit(r, f, `ci-cd refs → @${next}`, (t) => bumpWorkflowRefs(t, next));
+    }
+    // The map carries the train version and the date it was cut (§ 1.5 PLX); a
+    // standard module is stamped `changed` when its extracted requirement lines
+    // differ from the previous train's, read with the same extractor the
+    // compendium's check runs, so the two never disagree.
+    const comp = repo('compendium');
+    await edit(comp, MAP_PAGE, `version → ${next}, timestamp → ${today}`, (t) => stampStandard(t, next, today));
+    for (const page of await modulePages(ctx, comp.path)) {
+        const text = await ctx.readFile(join(comp.path, page));
+        if (frontmatterField(text, 'maturity') !== 'standard')
+            continue;
+        const previous = comp.tag
+            ? await ctx.read('git', ['show', `${comp.tag}:${page}`], { cwd: comp.path }).catch(() => '')
+            : '';
+        if (extractRequirements(text).join('\n') === extractRequirements(previous).join('\n'))
+            continue;
+        await edit(comp, page, `requirements changed since ${comp.latest ?? 'the beginning'} → changed: ${next}`, (t) => stampChanged(t, next));
+    }
+    for (const r of train.repos) {
+        if (!touched.has(r))
+            continue;
+        plan.push(run('git', ['add', '-A'], { cwd: r.path }));
+        plan.push(run('git', ['commit', '--quiet', '-m', `chore: train ${next} bookkeeping`], { cwd: r.path }));
+    }
+    return plan;
+}
+//# sourceMappingURL=ship.js.map

package/dist/ship.js.map

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

package/dist/train.d.ts

@@ -0,0 +1,45 @@
+import type { Context } from './context.ts';
+/** The repos stamped with the train tag, in release order. */
+export declare const TRAIN_REPOS: readonly ["platform", "ci-cd", "preset-repo-web", "preset-app-nextjs", "preset-repo-platform", "compendium"];
+/** The umbrella directory holding the train repos, relative to the workspace. */
+export declare const UPSTREAM = "plexus-ms";
+/** A train version is plain semver, no `v` prefix (§ 1.5 PLX). */
+export declare const isTrainVersion: (v: string) => boolean;
+export declare function nextMinor(version: string): string;
+/**
+ * The newest tag of a repo across both eras (`v0.21` and `0.22.0`), compared
+ * numerically on the v-stripped form: a plain version sort would rank every
+ * v-tag above every plain tag.
+ */
+export declare function latestTag(tags: string[]): string | undefined;
+export interface TrainRepo {
+    name: string;
+    path: string;
+    /** The latest tag as git has it; undefined for a repo never tagged. */
+    tag?: string;
+    /** The same, v-stripped: the train version it names. */
+    latest?: string;
+    /** `git log --oneline` since the latest tag. */
+    pending: string[];
+}
+export interface Train {
+    repos: TrainRepo[];
+    /** The highest tag across all repos, v-stripped. */
+    last?: string;
+    /** True when the repos' latest tags disagree: a run that stopped mid-tag. */
+    skew: boolean;
+}
+/** Fetch every train repo and read its tags and pending commits. */
+export declare function readTrain(ctx: Context, upstream: string): Promise<Train>;
+/** Every train repo on main, clean, and not behind origin; throws naming the first offender. */
+export declare function preflightRelease(ctx: Context, train: Train): Promise<void>;
+/**
+ * The version a run releases or propagates. `propagateOnly` takes the current
+ * train; a release takes the explicit version or the next minor, refusing to
+ * derive one while the repos' tags disagree.
+ */
+export declare function resolveVersion(train: Train, explicit: string | undefined, propagateOnly: boolean): string;
+/** A mistake in the arguments, as opposed to a failed run: exit code 2 in the CLI. */
+export declare class UsageError extends Error {
+}
+//# sourceMappingURL=train.d.ts.map

package/dist/train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"train.d.ts","sourceRoot":"","sources":["../src/train.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,8DAA8D;AAC9D,eAAO,MAAM,WAAW,8GAOd,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,kEAAkE;AAClE,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,OAAoC,CAAC;AAEhF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAK5D;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC;CACf;AAED,oEAAoE;AACpE,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAwB9E;AAED,gGAAgG;AAChG,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,CAgBzG;AAED,sFAAsF;AACtF,qBAAa,UAAW,SAAQ,KAAK;CAAG"}

package/dist/train.js

@@ -0,0 +1,102 @@
+// The train (§ 1.5 PLX): one version, tagged identically on every train repo
+// whether or not it changed. This file reads the train's state from the
+// upstream umbrella (the `plexus-ms` directory of a workspace) and decides the
+// next version; `ship` acts on it.
+import { join } from 'node:path';
+import { compareTrains } from "./doctor.js";
+/** The repos stamped with the train tag, in release order. */
+export const TRAIN_REPOS = [
+    'platform',
+    'ci-cd',
+    'preset-repo-web',
+    'preset-app-nextjs',
+    'preset-repo-platform',
+    'compendium',
+];
+/** The umbrella directory holding the train repos, relative to the workspace. */
+export const UPSTREAM = 'plexus-ms';
+/** A train version is plain semver, no `v` prefix (§ 1.5 PLX). */
+export const isTrainVersion = (v) => /^\d+\.\d+\.\d+$/.test(v);
+export function nextMinor(version) {
+    const [major = '0', minor = '0'] = version.split('.');
+    return `${major}.${Number(minor) + 1}.0`;
+}
+/**
+ * The newest tag of a repo across both eras (`v0.21` and `0.22.0`), compared
+ * numerically on the v-stripped form: a plain version sort would rank every
+ * v-tag above every plain tag.
+ */
+export function latestTag(tags) {
+    return tags
+        .filter((t) => /^v?\d/.test(t))
+        .sort((a, b) => compareTrains(a.replace(/^v/, ''), b.replace(/^v/, '')))
+        .at(-1);
+}
+/** Fetch every train repo and read its tags and pending commits. */
+export async function readTrain(ctx, upstream) {
+    const repos = [];
+    const all = new Set();
+    for (const name of TRAIN_REPOS) {
+        const path = join(upstream, name);
+        try {
+            await ctx.read('git', ['rev-parse', '--git-dir'], { cwd: path });
+        }
+        catch {
+            throw new Error(`${path} is not a git repo`);
+        }
+        try {
+            await ctx.read('git', ['fetch', 'origin', '--tags', '--quiet'], { cwd: path });
+        }
+        catch {
+            throw new Error(`${name}: fetch from origin failed`);
+        }
+        const tags = (await ctx.read('git', ['tag', '--list', 'v*', '[0-9]*'], { cwd: path })).split('\n').filter(Boolean);
+        for (const t of tags)
+            all.add(t.replace(/^v/, ''));
+        const tag = latestTag(tags);
+        const range = tag ? `${tag}..HEAD` : 'HEAD';
+        const pending = (await ctx.read('git', ['log', '--oneline', range], { cwd: path })).split('\n').filter(Boolean);
+        repos.push({ name, path, tag, latest: tag?.replace(/^v/, ''), pending });
+    }
+    const latest = repos.map((r) => r.latest);
+    return { repos, last: latestTag([...all]), skew: latest.some((l) => l !== latest[0]) };
+}
+/** Every train repo on main, clean, and not behind origin; throws naming the first offender. */
+export async function preflightRelease(ctx, train) {
+    for (const { name, path } of train.repos) {
+        const branch = (await ctx.read('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: path })).trim();
+        if (branch !== 'main')
+            throw new Error(`${name} is on '${branch}', trains cut from main`);
+        if ((await ctx.read('git', ['status', '--porcelain'], { cwd: path })).trim() !== '')
+            throw new Error(`${name} has uncommitted changes — commit first`);
+        const behind = (await ctx.read('git', ['rev-list', '--count', 'main..origin/main'], { cwd: path })).trim();
+        if (behind !== '0')
+            throw new Error(`${name} is ${behind} commit(s) behind origin/main — pull first, or the tag lands on a stale commit`);
+    }
+}
+/**
+ * The version a run releases or propagates. `propagateOnly` takes the current
+ * train; a release takes the explicit version or the next minor, refusing to
+ * derive one while the repos' tags disagree.
+ */
+export function resolveVersion(train, explicit, propagateOnly) {
+    if (explicit !== undefined && !isTrainVersion(explicit))
+        throw new UsageError(`'${explicit}' is not plain semver (X.Y.Z, no v)`);
+    if (propagateOnly) {
+        const v = explicit ?? train.last;
+        if (!v)
+            throw new Error('no train version found to propagate');
+        return v;
+    }
+    if (explicit)
+        return explicit;
+    if (train.skew) {
+        const report = train.repos.map((r) => `  ${r.name}: ${r.latest ?? 'none'}`).join('\n');
+        throw new Error(`the train repos' latest tags disagree:\n${report}\npass the version explicitly (--train ${train.last}) to finish the half-tagged train, or a higher one to start a new one`);
+    }
+    return train.last ? nextMinor(train.last) : '0.1.0';
+}
+/** A mistake in the arguments, as opposed to a failed run: exit code 2 in the CLI. */
+export class UsageError extends Error {
+}
+//# sourceMappingURL=train.js.map

package/dist/train.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"train.js","sourceRoot":"","sources":["../src/train.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,+EAA+E;AAC/E,mCAAmC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU;IACV,OAAO;IACP,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;IACtB,YAAY;CACJ,CAAC;AAEX,iFAAiF;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;SACvE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACZ,CAAC;AAqBD,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,QAAgB;IAC5D,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnH,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5C,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChH,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAY,EAAE,KAAY;IAC/D,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpG,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,WAAW,MAAM,yBAAyB,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YACjF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3G,IAAI,MAAM,KAAK,GAAG;YAChB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,OAAO,MAAM,gFAAgF,CACrG,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,QAA4B,EAAE,aAAsB;IAC/F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;QACrD,MAAM,IAAI,UAAU,CAAC,IAAI,QAAQ,qCAAqC,CAAC,CAAC;IAC1E,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;QACjC,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,0CAA0C,KAAK,CAAC,IAAI,uEAAuE,CAC7K,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACtD,CAAC;AAED,sFAAsF;AACtF,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plexus-ms/lib",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "The Plexus verbs as a library: the plan-then-apply core behind plx, and the one parser of Plexus's own file shapes",
   "license": "GPL-3.0-or-later",
   "type": "module",
@@ -26,17 +26,16 @@
   "engines": {
     "node": ">=24"
   },
-  "scripts": {
-    "build": "tsc",
-    "check": "tsc --noEmit",
-    "test": "node --test",
-    "prepack": "tsc"
-  },
   "dependencies": {
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
-    "typescript": "catalog:"
+    "@types/node": "^26.6.5",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "test": "node --test"
   }
-}
+}