blacksmith-organization-system 1.0.0-dev.3 → 1.2.0

package/dist/models/_index.d.ts

@@ -0,0 +1,20 @@
+export { Archive } from "./archive/class.ts";
+export { type AuthorEntry, type AuthorKind, completed, entryOf, formatEntry, type Identity, kindOf, names, parseEntry, parseIdentity, } from "./authors/entry.ts";
+export { type AuthorsLine, authorsFile, authorsText, readAuthors } from "./authors/file.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";

package/dist/models/_index.js

@@ -0,0 +1,22 @@
+// Every model of the workshop, one directory each (glossary as classes).
+export { Archive } from "./archive/class.js";
+export { completed, entryOf, formatEntry, kindOf, names, parseEntry, parseIdentity, } from "./authors/entry.js";
+export { authorsFile, authorsText, readAuthors } from "./authors/file.js";
+export { Craftbook, Scrapnotes } from "./craftbook/class.js";
+export { Devarmory } from "./devarmory/class.js";
+export { DEVLOG_FILES, Devlog } from "./devlog/class.js";
+export { Forge } from "./forge/class.js";
+export { Loop } from "./loop/class.js";
+export { DEFAULT_LOOP } from "./loop/data.js";
+export { loopOf, loopOfSettings } from "./loop/load.js";
+export { projectAround } from "./project/around.js";
+export { Project } from "./project/class.js";
+export { SCOPE_FILE, Scope } from "./scope/class.js";
+export { BUMPS, DEFAULT_VERSIONING } from "./settings/data.js";
+export { settingsFile, settingsOf, versioningOf } from "./settings/load.js";
+export { System } from "./system/class.js";
+export { Data, Nests, Setup } from "./system/parts.js";
+export { Logs, Manifests, Storylines, Ttystories } from "./system/storylines.js";
+export { ROOT_FILES, Workshop } from "./workshop/class.js";
+export { findAncestorWorkshop, locateWorkshop, placeOf, WORKSHOP_DIRNAME, workshopName, } from "./workshop/locate.js";
+//# sourceMappingURL=_index.js.map

package/dist/models/_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_index.js","sourceRoot":"","sources":["../../src/models/_index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAGL,SAAS,EACT,OAAO,EACP,WAAW,EAEX,MAAM,EACN,KAAK,EACL,UAAU,EACV,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAoB,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAc,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAiB,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAiB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAa,kBAAkB,EAA0C,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAiB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EAEpB,cAAc,EAEd,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/dist/models/archive/class.d.ts

@@ -0,0 +1,5 @@
+import { Element } from "../../core/element.ts";
+export declare class Archive extends Element {
+    static type: string;
+    static dirname: string;
+}

package/dist/models/archive/class.js

@@ -0,0 +1,7 @@
+// Work at rest: sarcophags, exhibits, mirrors (glossary: archive).
+import { Element } from "../../core/element.js";
+export class Archive extends Element {
+    static type = "archive";
+    static dirname = "archive";
+}
+//# sourceMappingURL=class.js.map

package/dist/models/archive/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../../src/models/archive/class.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,OAAO,OAAQ,SAAQ,OAAO;IAClC,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC"}

package/dist/models/authors/entry.d.ts

@@ -0,0 +1,20 @@
+export type AuthorEntry = {
+    nickname: string | null;
+    identity: string | null;
+    email: string | null;
+    url: string | null;
+    signs: string[];
+};
+export type AuthorKind = "full" | "verified" | "mentioned";
+export type Identity = {
+    name: string;
+    email: string;
+};
+export declare function parseEntry(line: string): AuthorEntry | null;
+export declare function formatEntry(entry: AuthorEntry): string;
+export declare function kindOf(entry: AuthorEntry): AuthorKind;
+export declare function names(entry: AuthorEntry, { name, email }: Identity): boolean;
+export declare function nicknameOf(name: string): string;
+export declare function entryOf({ name, email }: Identity): AuthorEntry;
+export declare function completed(entry: AuthorEntry, { name, email }: Identity): AuthorEntry | null;
+export declare function parseIdentity(text: string): Identity | null;

package/dist/models/authors/entry.js

@@ -0,0 +1,73 @@
+const TOKEN = /"([^"]*)"|<([^>]*)>|\(([^)]*)\)|\[([^\]]*)\]|(\S+)/g;
+// null for a blank line or a # comment
+export function parseEntry(line) {
+    const text = line.trim();
+    if (!text || text.startsWith("#"))
+        return null;
+    const entry = { nickname: null, identity: null, email: null, url: null, signs: [] };
+    for (const [, identity, email, url, sign, bare] of text.matchAll(TOKEN)) {
+        if (identity !== undefined)
+            entry.identity ??= identity;
+        else if (email !== undefined)
+            entry.email ??= email;
+        else if (url !== undefined)
+            entry.url ??= url;
+        else if (sign !== undefined)
+            entry.signs.push(sign);
+        else if (bare !== undefined)
+            entry.nickname ??= bare;
+    }
+    return entry;
+}
+export function formatEntry(entry) {
+    return [
+        entry.nickname,
+        entry.identity === null ? null : `"${entry.identity}"`,
+        entry.email === null ? null : `<${entry.email}>`,
+        entry.url === null ? null : `(${entry.url})`,
+        ...entry.signs.map((sign) => `[${sign}]`),
+    ]
+        .filter((field) => field !== null)
+        .join("\t");
+}
+export function kindOf(entry) {
+    if (!entry.nickname || !entry.email)
+        return "mentioned";
+    return entry.identity && entry.url ? "full" : "verified";
+}
+const same = (a, b) => a !== null && a.toLowerCase() === b.toLowerCase();
+// does the entry name this identity (glossary: the matching is assumed)
+export function names(entry, { name, email }) {
+    if (email && same(entry.email, email))
+        return true;
+    if (!name)
+        return false;
+    if (same(entry.nickname, name) || same(entry.identity, name))
+        return true;
+    return Boolean(entry.identity?.toLowerCase().startsWith(`${name.toLowerCase()} `));
+}
+export function nicknameOf(name) {
+    return name.trim().replace(/\s+/g, "-");
+}
+// a new entry for an identity no entry names: verified, or mentioned when half is missing
+export function entryOf({ name, email }) {
+    return { nickname: name ? nicknameOf(name) : null, identity: null, email: email || null, url: null, signs: [] };
+}
+// what an identity adds to a mentioned entry; null when nothing
+export function completed(entry, { name, email }) {
+    if (kindOf(entry) !== "mentioned")
+        return null;
+    const nickname = entry.nickname ?? (name ? nicknameOf(name) : null);
+    const mail = entry.email ?? (email || null);
+    if (nickname === entry.nickname && mail === entry.email)
+        return null;
+    return { ...entry, nickname, email: mail };
+}
+// "Name <email>", as git trailers write it
+export function parseIdentity(text) {
+    const match = text.trim().match(/^(.*?)\s*<([^>]*)>$/);
+    if (match)
+        return { name: (match[1] ?? "").trim(), email: (match[2] ?? "").trim() };
+    return text.trim() ? { name: text.trim(), email: "" } : null;
+}
+//# sourceMappingURL=entry.js.map

package/dist/models/authors/entry.js.map

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

package/dist/models/authors/file.d.ts

@@ -0,0 +1,9 @@
+import type { Host } from "../../core/host.ts";
+import { type AuthorEntry } from "./entry.ts";
+export type AuthorsLine = {
+    text: string;
+    entry: AuthorEntry | null;
+};
+export declare function authorsFile(projectPath: string): string;
+export declare function readAuthors(host: Host, file: string): AuthorsLine[];
+export declare function authorsText(lines: AuthorsLine[]): string;

package/dist/models/authors/file.js

@@ -0,0 +1,19 @@
+import { join } from "../../core/paths.js";
+import { parseEntry } from "./entry.js";
+export function authorsFile(projectPath) {
+    return join(projectPath, ".github", "AUTHORS");
+}
+// a missing file has no lines
+export function readAuthors(host, file) {
+    const text = host.readText(file);
+    if (text === null)
+        return [];
+    const lines = text.split("\n");
+    if (lines.at(-1) === "")
+        lines.pop();
+    return lines.map((line) => ({ text: line, entry: parseEntry(line) }));
+}
+export function authorsText(lines) {
+    return lines.length ? `${lines.map((line) => line.text).join("\n")}\n` : "";
+}
+//# sourceMappingURL=file.js.map

package/dist/models/authors/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/models/authors/file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1D,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,IAAY;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/models/craftbook/class.d.ts

@@ -0,0 +1,10 @@
+import { Element } from "../../core/element.ts";
+export declare class Scrapnotes extends Element {
+    static type: string;
+    static dirname: string;
+}
+export declare class Craftbook extends Element {
+    static type: string;
+    static dirname: string;
+    static children: (typeof Scrapnotes)[];
+}

package/dist/models/craftbook/class.js

@@ -0,0 +1,13 @@
+// Knowledge: scrapnotes, craftsets, collections, recipes (glossary: craftbook).
+import { Element } from "../../core/element.js";
+// every note or draft not yet promoted to a document (glossary: scrapnote)
+export class Scrapnotes extends Element {
+    static type = "scrapnotes";
+    static dirname = "scrapnotes";
+}
+export class Craftbook extends Element {
+    static type = "craftbook";
+    static dirname = "craftbook";
+    static children = [Scrapnotes];
+}
+//# sourceMappingURL=class.js.map

package/dist/models/craftbook/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../../src/models/craftbook/class.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,OAAO,UAAW,SAAQ,OAAO;IACrC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC;;AAGhC,MAAM,OAAO,SAAU,SAAQ,OAAO;IACpC,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,QAAQ,GAAG,CAAC,UAAU,CAAC,CAAC"}

package/dist/models/devarmory/class.d.ts

@@ -0,0 +1,11 @@
+import { Element } from "../../core/element.ts";
+export declare class Devarmory extends Element {
+    static type: string;
+    static dirname: string;
+    static descriptors: {
+        "manifest.json": () => {
+            tools: {};
+            files: {};
+        };
+    };
+}

package/dist/models/devarmory/class.js

@@ -0,0 +1,8 @@
+// Tools, listed with checksums so missing or damaged ones can be found (glossary: devarmory).
+import { Element } from "../../core/element.js";
+export class Devarmory extends Element {
+    static type = "devarmory";
+    static dirname = "devarmory";
+    static descriptors = { "manifest.json": () => ({ tools: {}, files: {} }) }; // format still [TODO]
+}
+//# sourceMappingURL=class.js.map

package/dist/models/devarmory/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../../src/models/devarmory/class.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,OAAO,SAAU,SAAQ,OAAO;IACpC,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,WAAW,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,sBAAsB"}

package/dist/models/devlog/class.d.ts

@@ -0,0 +1,19 @@
+import { Element } from "../../core/element.ts";
+export type Phase = {
+    number: number;
+    title: string;
+    done: number;
+    total: number;
+    complete: boolean;
+};
+export declare const DEVLOG_FILES: string[];
+export declare class Devlog extends Element {
+    static type: string;
+    static dirname: string;
+    text(name: string): string;
+    phases(): Phase[];
+    questions(): string[];
+    proposals(): string[];
+    waiting(name: "ORDERS.md" | "INQUIRIES.md"): boolean;
+    missingFiles(): string[];
+}

package/dist/models/devlog/class.js

@@ -0,0 +1,61 @@
+// docs/devlog of a project: the plan and the talk between the owner and the agents
+// (docs/devlog/README.md). Read as data, so the loop can tell where a project stands:
+// which phase is complete (a Y / I bump), which questions are open, what waits.
+import { Element } from "../../core/element.js";
+export const DEVLOG_FILES = [
+    "README.md",
+    "VISION.md",
+    "ROADMAP.md",
+    "TODO.md",
+    "BRAINSTORM.md",
+    "PROPOSALS.md",
+    "ORDERS.md",
+    "INQUIRIES.md",
+];
+export class Devlog extends Element {
+    static type = "devlog";
+    static dirname = "docs/devlog";
+    text(name) {
+        return this.host.readText(this.file(name)) ?? "";
+    }
+    // "## Phase <n>: <title>" headings of TODO.md and their "- [x]" / "- [ ]" items
+    phases() {
+        const phases = [];
+        for (const line of this.text("TODO.md").split("\n")) {
+            const heading = line.match(/^## Phase (\d+): (.+?)\s*$/);
+            if (heading) {
+                phases.push({ number: Number(heading[1]), title: heading[2] ?? "", done: 0, total: 0, complete: false });
+                continue;
+            }
+            const item = line.match(/^\s*- \[( |x|X)\]/);
+            const current = phases[phases.length - 1];
+            if (item && current) {
+                current.total++;
+                if (item[1] !== " ")
+                    current.done++;
+            }
+        }
+        for (const phase of phases)
+            phase.complete = phase.total > 0 && phase.done === phase.total;
+        return phases;
+    }
+    // "## Q<n>. <title>" of BRAINSTORM.md
+    questions() {
+        return [...this.text("BRAINSTORM.md").matchAll(/^## (Q\d+)\.\s*(.*)$/gm)].map((m) => `${m[1]}: ${m[2]}`);
+    }
+    // "### PP<n> beg" of PROPOSALS.md, with its title line
+    proposals() {
+        return [
+            ...this.text("PROPOSALS.md").matchAll(/^### (PP\d+) beg\s*$(?:[\s\S]*?label\/topic\/name\/title:\s*(.*)$)?/gm),
+        ].map((m) => `${m[1]}${m[2] ? `: ${m[2]}` : ""}`);
+    }
+    // ORDERS.md and INQUIRIES.md keep a header; what the owner wrote below the first "---" waits
+    waiting(name) {
+        const [, ...below] = this.text(name).split(/^---\s*$/m);
+        return below.join("").trim().length > 0;
+    }
+    missingFiles() {
+        return DEVLOG_FILES.filter((name) => !this.host.exists(this.file(name)));
+    }
+}
+//# sourceMappingURL=class.js.map

package/dist/models/devlog/class.js.map

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

package/dist/models/forge/class.d.ts

@@ -0,0 +1,9 @@
+import { Element } from "../../core/element.ts";
+import { Scope } from "../scope/class.ts";
+export declare class Forge extends Element {
+    static type: string;
+    static dirname: string;
+    scopes(): Scope[];
+    scope(name: string): Scope;
+    looseFiles(): string[];
+}

package/dist/models/forge/class.js

@@ -0,0 +1,24 @@
+// Active work, the desk: scopes of projects (glossary: forge).
+import { Element } from "../../core/element.js";
+import { Scope } from "../scope/class.js";
+export class Forge extends Element {
+    static type = "forge";
+    static dirname = "forge";
+    scopes() {
+        return this.host
+            .list(this.path)
+            .filter((entry) => entry.directory && !entry.name.startsWith("."))
+            .map((entry) => new Scope(this.host, this.file(entry.name), this));
+    }
+    scope(name) {
+        return new Scope(this.host, this.file(name), this);
+    }
+    // loose files lying in the forge itself, outside any scope
+    looseFiles() {
+        return this.host
+            .list(this.path)
+            .filter((entry) => !entry.directory)
+            .map((entry) => entry.name);
+    }
+}
+//# sourceMappingURL=class.js.map

package/dist/models/forge/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../../src/models/forge/class.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,OAAO,KAAM,SAAQ,OAAO;IAChC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;IACtB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEzB,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI;aACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;aACf,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,2DAA2D;IAC3D,UAAU;QACR,OAAO,IAAI,CAAC,IAAI;aACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;aACf,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;aACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC"}

package/dist/models/loop/class.d.ts

@@ -0,0 +1,16 @@
+import { type LoopData } from "./data.ts";
+export type LoopStep = {
+    from: string;
+    to: string;
+    automerge: boolean;
+    back: string[];
+};
+export declare class Loop {
+    readonly data: LoopData;
+    readonly source: string;
+    constructor(data?: LoopData, source?: string);
+    static problems(data: LoopData): string[];
+    isContributor(branch: string): boolean;
+    step(branch: string): LoopStep | null;
+    steps(): LoopStep[];
+}

package/dist/models/loop/class.js

@@ -0,0 +1,56 @@
+// The craft loop of one project: which branch goes where, and what merges by itself.
+import { DEFAULT_LOOP } from "./data.js";
+export class Loop {
+    data;
+    // where the data came from: "default" or the path of a .github/bos.json
+    source;
+    constructor(data = DEFAULT_LOOP, source = "default") {
+        this.data = data;
+        this.source = source;
+        const problems = Loop.problems(data);
+        if (problems.length)
+            throw new Error(`loop (${source}): ${problems.join("; ")}`);
+    }
+    static problems(data) {
+        const out = [];
+        const known = new Set(data.stations);
+        const check = (name, where) => {
+            if (!known.has(name))
+                out.push(`${where}: "${name}" is not a station`);
+        };
+        for (const [from, targets] of Object.entries(data.directions)) {
+            check(from, "directions");
+            if (!targets.length)
+                out.push(`directions: "${from}" goes nowhere`);
+            for (const to of targets)
+                check(to, `directions of ${from}`);
+        }
+        for (const station of data.stations)
+            if (!data.directions[station])
+                out.push(`"${station}" has no directions`);
+        for (const name of Object.keys(data.automerge))
+            check(name, "automerge");
+        check(data.contributors.into, "contributors.into");
+        check(data.release, "release");
+        if (known.has(data.contributors.pattern) || !data.contributors.pattern.endsWith("*"))
+            out.push(`contributors.pattern "${data.contributors.pattern}" must end with * and not be a station`);
+        return out;
+    }
+    isContributor(branch) {
+        return branch.startsWith(this.data.contributors.pattern.slice(0, -1)) && !this.data.stations.includes(branch);
+    }
+    // the forward step of a branch, or null when the branch is not part of the loop
+    step(branch) {
+        if (this.isContributor(branch))
+            return { from: branch, to: this.data.contributors.into, automerge: false, back: [] };
+        const [to, ...back] = this.data.directions[branch] ?? [];
+        if (!to)
+            return null;
+        return { from: branch, to, automerge: this.data.automerge[branch] ?? false, back };
+    }
+    // every forward step, in the order of the stations
+    steps() {
+        return this.data.stations.map((station) => this.step(station)).filter((step) => step !== null);
+    }
+}
+//# sourceMappingURL=class.js.map

package/dist/models/loop/class.js.map

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

package/dist/models/loop/data.d.ts

@@ -0,0 +1,12 @@
+export type LoopData = {
+    stations: string[];
+    directions: Record<string, string[]>;
+    contributors: {
+        pattern: string;
+        into: string;
+    };
+    autocreate: boolean;
+    automerge: Record<string, boolean>;
+    release: string;
+};
+export declare const DEFAULT_LOOP: LoopData;

package/dist/models/loop/data.js

@@ -0,0 +1,20 @@
+// The craft loop as data (glossary: craft-loop). A project may replace any field in the
+// "loop" section of its .github/bos.json; every field is checked by Loop before use.
+// from gitrecon's .github/bos.config.json, except that releasing → master waits for the
+// owner (the Canon Keeper of the legacy concept) (decision Q10, changelog phase 2)
+export const DEFAULT_LOOP = {
+    stations: ["master", "development", "revision", "testing", "releasing", "rejection"],
+    directions: {
+        master: ["development"],
+        development: ["revision", "rejection"],
+        revision: ["testing", "rejection"],
+        testing: ["releasing", "rejection"],
+        releasing: ["master", "rejection"],
+        rejection: ["development"],
+    },
+    contributors: { pattern: "dev/*", into: "development" },
+    autocreate: true,
+    automerge: { master: false, development: true, revision: true, testing: true, releasing: false, rejection: false },
+    release: "master",
+};
+//# sourceMappingURL=data.js.map

package/dist/models/loop/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../../src/models/loop/data.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,qFAAqF;AAkBrF,wFAAwF;AACxF,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;IACpF,UAAU,EAAE;QACV,MAAM,EAAE,CAAC,aAAa,CAAC;QACvB,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;QACtC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;QAClC,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QACnC,SAAS,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;QAClC,SAAS,EAAE,CAAC,aAAa,CAAC;KAC3B;IACD,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE;IACvD,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IAClH,OAAO,EAAE,QAAQ;CAClB,CAAC"}

package/dist/models/loop/load.d.ts

@@ -0,0 +1,5 @@
+import type { Host } from "../../core/host.ts";
+import { type Settings } from "../settings/load.ts";
+import { Loop } from "./class.ts";
+export declare function loopOfSettings(settings: Settings): Loop;
+export declare function loopOf(host: Host, projectPath: string): Loop;

package/dist/models/loop/load.js

@@ -0,0 +1,14 @@
+import { settingsOf } from "../settings/load.js";
+import { Loop } from "./class.js";
+import { DEFAULT_LOOP } from "./data.js";
+export function loopOfSettings(settings) {
+    const own = settings.data.loop;
+    if (!own)
+        return new Loop();
+    // fields left out keep the default
+    return new Loop({ ...DEFAULT_LOOP, ...own }, settings.source);
+}
+export function loopOf(host, projectPath) {
+    return loopOfSettings(settingsOf(host, projectPath));
+}
+//# sourceMappingURL=load.js.map

package/dist/models/loop/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/models/loop/load.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IAC5B,mCAAmC;IACnC,OAAO,IAAI,IAAI,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAU,EAAE,WAAmB;IACpD,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/models/project/anatomy.d.ts

@@ -0,0 +1,2 @@
+export declare const ANATOMY: Record<string, string>;
+export declare const ALIASES: Record<string, string[]>;

package/dist/models/project/anatomy.js

@@ -0,0 +1,15 @@
+// What every project carries (glossary: project; workshop AGENTS.md → Conventions).
+export const ANATOMY = {
+    "README.md": "what it is and how to use it",
+    LICENSE: "terms of use",
+    "AGENTS.md": "instructions for AI agents (CLAUDE.md imports it)",
+    "CLAUDE.md": "imports AGENTS.md for Claude Code",
+    "Taskfile.yml": "procedures: build, test, run",
+    src: "source code",
+    docs: "documentation",
+    tests: "tests",
+    ".github": "community files and CI workflows",
+};
+// Taskfile may also be spelled Taskfile.yaml
+export const ALIASES = { "Taskfile.yml": ["Taskfile.yaml"] };
+//# sourceMappingURL=anatomy.js.map

package/dist/models/project/anatomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anatomy.js","sourceRoot":"","sources":["../../../src/models/project/anatomy.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,WAAW,EAAE,8BAA8B;IAC3C,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,mDAAmD;IAChE,WAAW,EAAE,mCAAmC;IAChD,cAAc,EAAE,8BAA8B;IAC9C,GAAG,EAAE,aAAa;IAClB,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,kCAAkC;CAC9C,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,OAAO,GAA6B,EAAE,cAAc,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC"}

package/dist/models/project/around.d.ts

@@ -0,0 +1,3 @@
+import type { Host } from "../../core/host.ts";
+import { Project } from "./class.ts";
+export declare function projectAround(host: Host, dir?: string): Project;

package/dist/models/project/around.js

@@ -0,0 +1,13 @@
+import { dirname, join, normalize } from "../../core/paths.js";
+import { Project } from "./class.js";
+import { isRepository } from "./git.js";
+export function projectAround(host, dir) {
+    const start = normalize(dir ? (dir.startsWith("/") ? dir : join(host.cwd(), dir)) : host.cwd());
+    for (let at = start;; at = dirname(at)) {
+        if (isRepository(host, at))
+            return new Project(host, at);
+        if (at === "/")
+            throw new Error(`${start} is not inside a git repository`);
+    }
+}
+//# sourceMappingURL=around.js.map

package/dist/models/project/around.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"around.js","sourceRoot":"","sources":["../../../src/models/project/around.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,GAAY;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChG,KAAK,IAAI,EAAE,GAAG,KAAK,GAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YAAE,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iCAAiC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/models/project/class.d.ts

@@ -0,0 +1,21 @@
+import { Element } from "../../core/element.ts";
+import { type GitState } from "./git.ts";
+import { type DeclaredVersion } from "./version.ts";
+export type ProjectReport = {
+    name: string;
+    path: string;
+    git: GitState;
+    version: DeclaredVersion;
+    anatomy: {
+        present: string[];
+        missing: string[];
+    };
+};
+export declare class Project extends Element {
+    static type: string;
+    anatomy(): {
+        present: string[];
+        missing: string[];
+    };
+    report(): ProjectReport;
+}