blacksmith-organization-system 0.4.2 → 1.1.0

package/dist/core/paths.js

@@ -0,0 +1,42 @@
+// POSIX paths without node:path, so the core runs wherever a Host can be written.
+// Every path the core keeps is absolute and uses "/".
+export function join(...parts) {
+    return normalize(parts.filter(Boolean).join("/"));
+}
+export function normalize(path) {
+    const absolute = path.startsWith("/");
+    const out = [];
+    for (const part of path.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..") {
+            if (out.length && out[out.length - 1] !== "..")
+                out.pop();
+            else if (!absolute)
+                out.push("..");
+            continue;
+        }
+        out.push(part);
+    }
+    const body = out.join("/");
+    return absolute ? `/${body}` : body || ".";
+}
+export function basename(path) {
+    return normalize(path).split("/").pop() ?? "";
+}
+export function dirname(path) {
+    const parts = normalize(path).split("/");
+    parts.pop();
+    const parent = parts.join("/");
+    return parent || "/";
+}
+// "a/b" when target = root/a/b; "" when equal; null when target is outside root
+export function inside(root, target) {
+    const base = normalize(root);
+    const path = normalize(target);
+    if (path === base)
+        return "";
+    const prefix = base === "/" ? "/" : `${base}/`;
+    return path.startsWith(prefix) ? path.slice(prefix.length) : null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,sDAAsD;AAEtD,MAAM,UAAU,IAAI,CAAC,GAAG,KAAe;IACrC,OAAO,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QACpC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;iBACrD,IAAI,CAAC,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,KAAK,CAAC,GAAG,EAAE,CAAC;IACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,IAAI,GAAG,CAAC;AACvB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,MAAc;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;IAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/dist/core/procedure.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "./context.ts";
+export type Step<C extends Context> = {
+    name: string;
+    run: (context: C) => void | Promise<void>;
+};
+export declare class Procedure<C extends Context = Context> {
+    readonly name: string;
+    readonly steps: Step<C>[];
+    constructor(name: string, steps: Step<C>[]);
+    run(context: C): Promise<C>;
+}

package/dist/core/procedure.js

@@ -0,0 +1,24 @@
+export class Procedure {
+    name;
+    steps;
+    constructor(name, steps) {
+        this.name = name;
+        this.steps = steps;
+    }
+    async run(context) {
+        for (const step of this.steps) {
+            const started = context.host.now();
+            try {
+                await step.run(context);
+                context.trace.push({ procedure: this.name, step: step.name, ok: true, ms: context.host.now() - started });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                context.trace.push({ procedure: this.name, step: step.name, ok: false, error: message });
+                throw new Error(`${this.name} › ${step.name}: ${message}`, { cause: error });
+            }
+        }
+        return context;
+    }
+}
+//# sourceMappingURL=procedure.js.map

package/dist/core/procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.js","sourceRoot":"","sources":["../../src/core/procedure.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,SAAS;IACX,IAAI,CAAS;IACb,KAAK,CAAY;IAE1B,YAAY,IAAY,EAAE,KAAgB;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAU;QAClB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;YAC5G,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/tool.d.ts

@@ -0,0 +1,33 @@
+import type { BOS } from "../main.ts";
+export type Arg = {
+    name: string;
+    type: "string" | "boolean";
+    info: string;
+    positional?: boolean;
+    required?: boolean;
+};
+export type Input = Record<string, string | boolean | undefined>;
+export type IO = {
+    print: (line: string) => void;
+    signal: AbortSignal;
+};
+export type Tool = {
+    model: string;
+    name: string;
+    info: string;
+    readOnly: boolean;
+    args: Arg[];
+    run: (bos: BOS, input: Input, io: IO) => unknown | Promise<unknown>;
+    render?: (result: never, input: Input) => string;
+};
+export declare function tool<R>(definition: Omit<Tool, "run" | "render" | "args" | "readOnly"> & {
+    args?: Arg[];
+    readOnly?: boolean;
+    run: (bos: BOS, input: Input, io: IO) => R | Promise<R>;
+    render?: (result: Awaited<R>, input: Input) => string;
+}): Tool;
+export declare function parseArgs(argv: string[]): {
+    operands: string[];
+    flags: Record<string, string | boolean>;
+};
+export declare function inputFor(entry: Tool, operands: string[], flags: Record<string, string | boolean>): Input;

package/dist/core/tool.js

@@ -0,0 +1,44 @@
+export function tool(definition) {
+    return { args: [], readOnly: true, ...definition };
+}
+// "--dry-run --workshop=/x a b" → flags { dryRun: true, workshop: "/x" }, operands [a, b]
+export function parseArgs(argv) {
+    const flags = {};
+    const operands = [];
+    for (const arg of argv) {
+        if (!arg.startsWith("--")) {
+            operands.push(arg);
+            continue;
+        }
+        const [key = "", value] = arg.slice(2).split(/=(.*)/s);
+        flags[key.replace(/-(\w)/g, (_, c) => c.toUpperCase())] = value ?? true;
+    }
+    return { operands, flags };
+}
+// operands and flags → the tool's input, checked against its args
+export function inputFor(entry, operands, flags) {
+    const input = {};
+    const positional = entry.args.filter((arg) => arg.positional);
+    positional.forEach((arg, index) => {
+        if (operands[index] !== undefined)
+            input[arg.name] = operands[index];
+    });
+    if (operands.length > positional.length)
+        throw new Error(`too many operands for ${entry.model} ${entry.name}: ${operands.slice(positional.length).join(" ")}`);
+    for (const arg of entry.args) {
+        const value = flags[arg.name];
+        if (value === undefined)
+            continue;
+        if (arg.type === "boolean")
+            input[arg.name] = value === true || value === "true";
+        else if (value === true)
+            throw new Error(`--${arg.name} needs a value: --${arg.name}=<${arg.name}>`);
+        else
+            input[arg.name] = value;
+    }
+    const missing = entry.args.filter((arg) => arg.required && input[arg.name] === undefined).map((arg) => arg.name);
+    if (missing.length)
+        throw new Error(`${entry.model} ${entry.name} needs: ${missing.join(", ")}`);
+    return input;
+}
+//# sourceMappingURL=tool.js.map

package/dist/core/tool.js.map

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

package/dist/core/version.d.ts

@@ -0,0 +1,6 @@
+export declare const EVENTS: readonly ["step", "phase", "milestone", "flip"];
+export type LoopEvent = (typeof EVENTS)[number];
+export declare function isLoopEvent(value: string): value is LoopEvent;
+export declare function bumpSemver(version: string, event: LoopEvent): string;
+export declare function bumpGrih(version: string, event: LoopEvent): string;
+export declare const GRIH_START = "0.0.0.0";

package/dist/core/version.js

@@ -0,0 +1,37 @@
+// The two version schemes of BOS (docs/devlog/ROADMAP.md):
+//   a project:  semver vX.Y.Z
+//   a scope:    GRIH   vG.R.I.H
+// and the four events of the craft loop that bump them.
+//
+// | event     | semver | GRIH |
+// | step      | Z      | H    |
+// | phase     | Y      | I    |
+// | milestone | X      | R    |
+// | flip      | X      | G    |   the script flips: pre-alpha → alpha, a key concept changes
+export const EVENTS = ["step", "phase", "milestone", "flip"];
+export function isLoopEvent(value) {
+    return EVENTS.includes(value);
+}
+function parse(version, count, scheme) {
+    const parts = version.replace(/^v/, "").split(".");
+    const numbers = parts.map(Number);
+    if (parts.length !== count || numbers.some((n) => !Number.isInteger(n) || n < 0))
+        throw new Error(`"${version}" is not a ${scheme} version (${count} whole numbers joined by dots)`);
+    return numbers;
+}
+// raise the digit at index, zero every digit after it
+function raise(numbers, index) {
+    return numbers.map((n, i) => (i < index ? n : i === index ? n + 1 : 0)).join(".");
+}
+const SEMVER_DIGIT = { flip: 0, milestone: 0, phase: 1, step: 2 };
+const GRIH_DIGIT = { flip: 0, milestone: 1, phase: 2, step: 3 };
+// "0.6.1" + phase → "0.7.0"; pre-release or build suffixes are not part of the core's scheme
+export function bumpSemver(version, event) {
+    return raise(parse(version, 3, "semver"), SEMVER_DIGIT[event]);
+}
+// "0.1.2.3" + milestone → "0.2.0.0"
+export function bumpGrih(version, event) {
+    return raise(parse(version, 4, "GRIH"), GRIH_DIGIT[event]);
+}
+export const GRIH_START = "0.0.0.0";
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,8BAA8B;AAC9B,gCAAgC;AAChC,wDAAwD;AACxD,EAAE;AACF,gCAAgC;AAChC,gCAAgC;AAChC,gCAAgC;AAChC,gCAAgC;AAChC,6FAA6F;AAE7F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC;AAGtE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAQ,MAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,KAAK,CAAC,OAAe,EAAE,KAAa,EAAE,MAAc;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,cAAc,MAAM,aAAa,KAAK,gCAAgC,CAAC,CAAC;IACrG,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sDAAsD;AACtD,SAAS,KAAK,CAAC,OAAiB,EAAE,KAAa;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,YAAY,GAA8B,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC7F,MAAM,UAAU,GAA8B,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE3F,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAgB;IAC1D,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAgB;IACxD,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC"}

package/dist/hosts/node.d.ts

@@ -0,0 +1,21 @@
+import type { Change, Entry, Host, RunResult } from "../core/host.ts";
+export { WATCH_LIMIT } from "./watch-tree.ts";
+export declare class NodeHost implements Host {
+    exists(path: string): boolean;
+    isDirectory(path: string): boolean;
+    list(path: string): Entry[];
+    readText(path: string): string | null;
+    writeText(path: string, text: string): void;
+    appendText(path: string, text: string): void;
+    mkdir(path: string): void;
+    watch(root: string, onChange: (change: Change) => void, onError: (error: Error) => void, skip?: (relative: string) => boolean): () => void;
+    run(command: string, args: string[], options?: {
+        cwd?: string;
+    }): RunResult;
+    env(name: string): string | undefined;
+    home(): string;
+    cwd(): string;
+    hostname(): string;
+    user(): string;
+    now(): number;
+}

package/dist/hosts/node.js

@@ -0,0 +1,76 @@
+// Host for Node.js: the real file system, clock and environment.
+import { spawnSync } from "node:child_process";
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { homedir, hostname, userInfo } from "node:os";
+import { resolve } from "node:path";
+import { watchTree } from "./watch-tree.js";
+export { WATCH_LIMIT } from "./watch-tree.js";
+export class NodeHost {
+    exists(path) {
+        return existsSync(path);
+    }
+    isDirectory(path) {
+        try {
+            return statSync(path).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    list(path) {
+        try {
+            return readdirSync(path, { withFileTypes: true }).map((entry) => ({
+                name: entry.name,
+                directory: entry.isDirectory(),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    readText(path) {
+        try {
+            return readFileSync(path, "utf8");
+        }
+        catch {
+            return null;
+        }
+    }
+    writeText(path, text) {
+        writeFileSync(path, text);
+    }
+    appendText(path, text) {
+        appendFileSync(path, text);
+    }
+    mkdir(path) {
+        mkdirSync(path, { recursive: true });
+    }
+    watch(root, onChange, onError, skip = () => false) {
+        return watchTree(root, { onChange, onError, skip });
+    }
+    run(command, args, options = {}) {
+        const result = spawnSync(command, args, { cwd: options.cwd, encoding: "utf8", maxBuffer: 64 * 1024 * 1024 });
+        if (result.error)
+            return { status: 127, stdout: "", stderr: `${command}: ${result.error.message}` };
+        return { status: result.status ?? 1, stdout: result.stdout, stderr: result.stderr };
+    }
+    env(name) {
+        return process.env[name];
+    }
+    home() {
+        return homedir();
+    }
+    cwd() {
+        return resolve(process.cwd());
+    }
+    hostname() {
+        return hostname();
+    }
+    user() {
+        return userInfo().username;
+    }
+    now() {
+        return Date.now();
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/hosts/node.js.map

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

package/dist/hosts/watch-tree.d.ts

@@ -0,0 +1,8 @@
+import type { Change } from "../core/host.ts";
+export declare const WATCH_LIMIT = "no file watches left on this system (fs.inotify.max_user_watches); close other watchers (editors) or raise the limit";
+export type TreeHandlers = {
+    onChange: (change: Change) => void;
+    onError: (error: Error) => void;
+    skip: (relative: string) => boolean;
+};
+export declare function watchTree(root: string, { onChange, onError, skip }: TreeHandlers): () => void;

package/dist/hosts/watch-tree.js

@@ -0,0 +1,86 @@
+// A recursive watch built from one watcher per directory. Node's own recursive watch
+// on Linux watches every file and, when inotify runs out, stops reporting without an
+// error. Here a skipped directory (.git, node_modules…) costs no watch at all, a new
+// directory is watched as soon as it appears, and running out of watches is an error.
+import { readdirSync, statSync, watch } from "node:fs";
+// Linux gives every user a fixed number of inotify watches; editors watching big trees can take them all
+export const WATCH_LIMIT = "no file watches left on this system (fs.inotify.max_user_watches); close other watchers (editors) or raise the limit";
+function asError(error) {
+    const code = error?.code;
+    if (code === "ENOSPC")
+        return new Error(WATCH_LIMIT);
+    return error instanceof Error ? error : new Error(String(error));
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function watchTree(root, { onChange, onError, skip }) {
+    const watchers = new Map();
+    let failed = false;
+    const fail = (error) => {
+        if (failed)
+            return;
+        failed = true;
+        stop();
+        onError(asError(error));
+    };
+    // relative: "" for the root, else "a/b"
+    const add = (relative) => {
+        if (failed || watchers.has(relative) || (relative && skip(relative)))
+            return;
+        const path = relative ? `${root}/${relative}` : root;
+        let watcher;
+        try {
+            watcher = watch(path, (kind, filename) => {
+                if (!filename)
+                    return;
+                const changed = relative ? `${relative}/${filename}` : String(filename);
+                if (kind === "rename" && isDirectory(`${root}/${changed}`))
+                    add(changed);
+                if (kind === "rename" && !watchers.has(changed))
+                    drop(changed);
+                onChange({ path: changed, kind: kind === "rename" ? "rename" : "change" });
+            });
+        }
+        catch (error) {
+            // the directory vanished between listing and watching: nothing to watch
+            if (error.code === "ENOENT")
+                return;
+            return fail(error);
+        }
+        watcher.on("error", fail);
+        watchers.set(relative, watcher);
+        let entries = [];
+        try {
+            entries = readdirSync(path, { withFileTypes: true })
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => entry.name);
+        }
+        catch { }
+        for (const name of entries)
+            add(relative ? `${relative}/${name}` : name);
+    };
+    // a removed directory: close its watcher and those below it
+    const drop = (relative) => {
+        if (isDirectory(`${root}/${relative}`))
+            return;
+        for (const [key, watcher] of watchers)
+            if (key === relative || key.startsWith(`${relative}/`)) {
+                watcher.close();
+                watchers.delete(key);
+            }
+    };
+    const stop = () => {
+        for (const watcher of watchers.values())
+            watcher.close();
+        watchers.clear();
+    };
+    add("");
+    return stop;
+}
+//# sourceMappingURL=watch-tree.js.map

package/dist/hosts/watch-tree.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { Git } from "./bridges/git.ts";
+export { type Comparison, GitHub, type PullRequest } from "./bridges/github.ts";
+export { type Context, createContext, createIfMissing, type TraceEntry } from "./core/context.ts";
+export { Element, type ElementClass, type ElementNode } from "./core/element.ts";
+export type { Change, Entry, Host, RunResult } from "./core/host.ts";
+export * as paths from "./core/paths.ts";
+export { Procedure, type Step } from "./core/procedure.ts";
+export { type Arg, type Input, type IO, inputFor, parseArgs, type Tool, tool } from "./core/tool.ts";
+export { bumpGrih, bumpSemver, EVENTS, GRIH_START, isLoopEvent, type LoopEvent } from "./core/version.ts";
+export { NodeHost, WATCH_LIMIT } from "./hosts/node.ts";
+export { BOS, type BOSOptions, type WatchOptions } from "./main.ts";
+export * from "./models/_index.ts";
+export * from "./procedures/_index.ts";
+export { findTool, TOOLS } from "./tools/_index.ts";

package/dist/index.js

@@ -0,0 +1,18 @@
+// Library entry.
+//   import { BOS, NodeHost } from "blacksmith-organization-system";
+//   const bos = new BOS(new NodeHost());
+//   await bos.bootstrap();  const report = await bos.inspect();
+export { Git } from "./bridges/git.js";
+export { GitHub } from "./bridges/github.js";
+export { createContext, createIfMissing } from "./core/context.js";
+export { Element } from "./core/element.js";
+export * as paths from "./core/paths.js";
+export { Procedure } from "./core/procedure.js";
+export { inputFor, parseArgs, tool } from "./core/tool.js";
+export { bumpGrih, bumpSemver, EVENTS, GRIH_START, isLoopEvent } from "./core/version.js";
+export { NodeHost, WATCH_LIMIT } from "./hosts/node.js";
+export { BOS } from "./main.js";
+export * from "./models/_index.js";
+export * from "./procedures/_index.js";
+export { findTool, TOOLS } from "./tools/_index.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,iBAAiB;AACjB,oEAAoE;AACpE,yCAAyC;AACzC,gEAAgE;AAEhE,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAmB,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAgB,aAAa,EAAE,eAAe,EAAmB,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,OAAO,EAAuC,MAAM,mBAAmB,CAAC;AAEjF,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAa,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAiC,QAAQ,EAAE,SAAS,EAAa,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAsC,MAAM,WAAW,CAAC;AACpE,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,51 @@
+import type { Host } from "./core/host.ts";
+import type { LoopEvent } from "./core/version.ts";
+import { type Loop, type Project, type Settings, type VersioningData, Workshop } from "./models/_index.ts";
+import { type BootstrapContext, type BumpOutcome, type FlowOutcome, type VersionContext, type WorkshopEvent, type WorkshopReport } from "./procedures/_index.ts";
+export type BOSOptions = {
+    workshop?: string;
+};
+export type WatchOptions = {
+    signal: AbortSignal;
+    onEvent: (event: WorkshopEvent) => void;
+    record?: boolean;
+    quietMs?: number;
+};
+export declare class BOS {
+    #private;
+    readonly host: Host;
+    readonly options: BOSOptions;
+    constructor(host: Host, options?: BOSOptions);
+    get workshop(): Workshop;
+    bootstrap({ dryRun }?: {
+        dryRun?: boolean | undefined;
+    }): Promise<BootstrapContext>;
+    inspect(): Promise<WorkshopReport>;
+    watch({ signal, onEvent, record, quietMs }: WatchOptions): Promise<void>;
+    bumpScope(name: string, event: LoopEvent, { dryRun }?: {
+        dryRun?: boolean | undefined;
+    }): Promise<VersionContext>;
+    settings(dir?: string): {
+        project: Project;
+        settings: Settings;
+        loop: Loop;
+        versioning: VersioningData;
+    };
+    loop(dir?: string): {
+        project: Project;
+        loop: Loop;
+    };
+    bump(station: string, { dir, dryRun }?: {
+        dir?: string;
+        dryRun?: boolean;
+    }): Promise<BumpOutcome>;
+    propose(branch: string, { dir, dryRun }?: {
+        dir?: string;
+        dryRun?: boolean;
+    }): Promise<FlowOutcome>;
+    automerge(number: number, { dir, dryRun }?: {
+        dir?: string;
+        dryRun?: boolean;
+    }): Promise<FlowOutcome>;
+    toString(): string;
+}

package/dist/main.js

@@ -0,0 +1,85 @@
+// The spine of BOS: one object that holds the host, finds the workshop and runs
+// the procedures on it. Every face of BOS (CLI, library, later MCP and HTTP) goes
+// through these methods.
+//   const bos = new BOS(new NodeHost());  const report = await bos.inspect();
+import { Git } from "./bridges/git.js";
+import { GitHub } from "./bridges/github.js";
+import { createContext } from "./core/context.js";
+import { loopOfSettings, projectAround, settingsOf, versioningOf, Workshop, } from "./models/_index.js";
+import { automerging, bootstrapping, bumping, emptyReport, inspecting, proposing, unbumped, undecided, versioning, watching, } from "./procedures/_index.js";
+export class BOS {
+    host;
+    options;
+    #workshop = null;
+    constructor(host, options = {}) {
+        this.host = host;
+        this.options = options;
+    }
+    // the active workshop: --workshop, $BOS_WORKSHOP, $WORKSHOP_ROOT/__WORKSHOP, an ancestor __WORKSHOP,
+    // or ~/__WORKSHOP ($WORKSHOP_RENAME changes the name)
+    get workshop() {
+        this.#workshop ??= Workshop.locate(this.host, this.options.workshop);
+        return this.#workshop;
+    }
+    // build the base of the environment: create what is missing, never overwrite
+    async bootstrap({ dryRun = false } = {}) {
+        return bootstrapping.run({ ...createContext(this.host, { dryRun }), workshop: this.workshop });
+    }
+    // the whole workshop as one coherent environment, with findings; reads only
+    async inspect() {
+        const context = { ...createContext(this.host), workshop: this.workshop, report: emptyReport(this.workshop) };
+        return (await inspecting.run(context)).report;
+    }
+    // listen to every change in the workshop until options.signal aborts
+    async watch({ signal, onEvent, record = false, quietMs = 250 }) {
+        await watching.run({ ...createContext(this.host), workshop: this.workshop, signal, onEvent, record, quietMs });
+    }
+    // raise a scope's GRIH version for one loop event
+    async bumpScope(name, event, { dryRun = false } = {}) {
+        const scope = this.workshop.forge.scope(name);
+        return versioning.run({ ...createContext(this.host, { dryRun }), workshop: this.workshop, scope, event });
+    }
+    // the settings of the project around dir (default: the current directory): .github/bos.json
+    settings(dir) {
+        const project = projectAround(this.host, dir);
+        const settings = settingsOf(this.host, project.path);
+        return { project, settings, loop: loopOfSettings(settings), versioning: versioningOf(settings) };
+    }
+    // the craft loop of the project around dir
+    loop(dir) {
+        const { project, loop } = this.settings(dir);
+        return { project, loop };
+    }
+    // bump the project's version for work landing on a station (only a released version moves)
+    async bump(station, { dir, dryRun = false } = {}) {
+        const { project, versioning } = this.settings(dir);
+        const git = new Git(this.host, project.path);
+        const context = {
+            ...createContext(this.host, { dryRun }),
+            projectPath: project.path,
+            station,
+            versioning,
+            git,
+            outcome: unbumped(),
+        };
+        return (await bumping.run(context)).outcome;
+    }
+    // open the pull request of a branch's forward step on GitHub
+    async propose(branch, { dir, dryRun = false } = {}) {
+        const { project, loop } = this.loop(dir);
+        const github = new GitHub(this.host, project.path);
+        const context = { ...createContext(this.host, { dryRun }), loop, github, branch, outcome: undecided() };
+        return (await proposing.run(context)).outcome;
+    }
+    // merge a loop pull request when the loop allows it
+    async automerge(number, { dir, dryRun = false } = {}) {
+        const { project, loop } = this.loop(dir);
+        const github = new GitHub(this.host, project.path);
+        const context = { ...createContext(this.host, { dryRun }), loop, github, number, outcome: undecided() };
+        return (await automerging.run(context)).outcome;
+    }
+    toString() {
+        return `[<Blacksmith_Organization_System::${this.workshop.path}>]`;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/models/_index.d.ts

@@ -0,0 +1,18 @@
+export { Archive } from "./archive/class.ts";
+export { Craftbook, Scrapnotes } from "./craftbook/class.ts";
+export { Devarmory } from "./devarmory/class.ts";
+export { DEVLOG_FILES, Devlog, type Phase } from "./devlog/class.ts";
+export { Forge } from "./forge/class.ts";
+export { Loop, type LoopStep } from "./loop/class.ts";
+export { DEFAULT_LOOP, type LoopData } from "./loop/data.ts";
+export { loopOf, loopOfSettings } from "./loop/load.ts";
+export { projectAround } from "./project/around.ts";
+export { Project, type ProjectReport } from "./project/class.ts";
+export { SCOPE_FILE, Scope } from "./scope/class.ts";
+export { BUMPS, type Bump, DEFAULT_VERSIONING, type SettingsData, type VersioningData } from "./settings/data.ts";
+export { type Settings, settingsFile, settingsOf, versioningOf } from "./settings/load.ts";
+export { System } from "./system/class.ts";
+export { Data, Nests, Setup } from "./system/parts.ts";
+export { Logs, Manifests, Storylines, Ttystories } from "./system/storylines.ts";
+export { ROOT_FILES, Workshop } from "./workshop/class.ts";
+export { findAncestorWorkshop, type Located, locateWorkshop, type Place, placeOf, WORKSHOP_DIRNAME, workshopName, } from "./workshop/locate.ts";