blacksmith-organization-system 1.2.0 → 1.4.10

package/dist/tools/flow.js

@@ -1,8 +1,16 @@
 // bos flow <tool>: the craft loop of the project around the current directory
 import { tool } from "../core/tool.js";
 import { bumpText, explainText, outcomeText, stepText } from "../views/flow.js";
-const dirArg = { name: "dir", type: "string", info: "a path inside the project (default: current directory)" };
-const dryRunArg = { name: "dryRun", type: "boolean", info: "only say what would be done on GitHub" };
+const dirArg = {
+    name: "dir",
+    type: "string",
+    info: "a path inside the project (default: current directory)",
+};
+const dryRunArg = {
+    name: "dryRun",
+    type: "boolean",
+    info: "only say what would be done on GitHub",
+};
 const dir = (value) => value;
 export const flowTools = [
     tool({
@@ -21,7 +29,13 @@ export const flowTools = [
         name: "next",
         info: "the forward step of a branch in the loop (reads only, no GitHub)",
         args: [
-            { name: "branch", type: "string", info: "a station or a contributor's branch", positional: true, required: true },
+            {
+                name: "branch",
+                type: "string",
+                info: "a station or a contributor's branch",
+                positional: true,
+                required: true,
+            },
             dirArg,
         ],
         run: (bos, input) => bos.loop(dir(input.dir)).loop.step(String(input.branch)),
@@ -33,7 +47,13 @@ export const flowTools = [
         info: "open on GitHub the pull request of a branch's forward step, unless there is nothing to propose",
         readOnly: false,
         args: [
-            { name: "branch", type: "string", info: "the branch that moved", positional: true, required: true },
+            {
+                name: "branch",
+                type: "string",
+                info: "the branch that moved",
+                positional: true,
+                required: true,
+            },
             dirArg,
             dryRunArg,
         ],
@@ -46,14 +66,21 @@ export const flowTools = [
         info: "merge a loop pull request on GitHub when the loop lets it merge by itself",
         readOnly: false,
         args: [
-            { name: "pr", type: "string", info: "the pull request's number", positional: true, required: true },
+            {
+                name: "pr",
+                type: "string",
+                info: "the pull request's number",
+                positional: true,
+                required: true,
+            },
             dirArg,
             dryRunArg,
         ],
         run: (bos, input) => {
             const number = Number(input.pr);
-            if (!Number.isInteger(number) || number < 1)
+            if (!Number.isInteger(number) || number < 1) {
                 throw new Error(`not a pull request number: ${input.pr}`);
+            }
             return bos.automerge(number, { dir: dir(input.dir), dryRun: Boolean(input.dryRun) });
         },
         render: outcomeText,
@@ -61,7 +88,7 @@ export const flowTools = [
     tool({
         model: "flow",
         name: "bump",
-        info: "bump the project's version for work landing on a station (.github/bos.json versioning); only a released version moves",
+        info: "bump the project's version for work landing on a station (.github/bos.json versioning); only once the line it leaves is released",
         readOnly: false,
         args: [
             {
@@ -77,5 +104,52 @@ export const flowTools = [
         run: (bos, input) => bos.bump(String(input.station), { dir: dir(input.dir), dryRun: Boolean(input.dryRun) }),
         render: bumpText,
     }),
+    tool({
+        model: "flow",
+        name: "bump-commit",
+        info: "bump the version for one commit on a contributor's branch (versioning.commits; the pre-commit hook runs it)",
+        readOnly: false,
+        args: [
+            dirArg,
+            { name: "dryRun", type: "boolean", info: "only say what the version would become" },
+        ],
+        run: (bos, input) => bos.bumpCommit({ dir: dir(input.dir), dryRun: Boolean(input.dryRun) }),
+        render: bumpText,
+    }),
+    tool({
+        model: "flow",
+        name: "merge-version",
+        info: "git merge driver of package.json and its lock: the higher version on every side, then a three-way merge",
+        readOnly: false,
+        args: [
+            {
+                name: "base",
+                type: "string",
+                info: "the common ancestor's file (%O)",
+                positional: true,
+                required: true,
+            },
+            {
+                name: "ours",
+                type: "string",
+                info: "our file, the result goes here (%A)",
+                positional: true,
+                required: true,
+            },
+            { name: "theirs", type: "string", info: "their file (%B)", positional: true, required: true },
+            dirArg,
+        ],
+        run: async (bos, input) => {
+            const outcome = await bos.mergeVersion(String(input.base), String(input.ours), String(input.theirs), {
+                dir: dir(input.dir),
+            });
+            // a conflict must fail the driver, so git leaves the file conflicted
+            if (outcome.action === "conflict") {
+                throw new Error(`conflicts besides the version (${outcome.version})`);
+            }
+            return outcome;
+        },
+        render: (outcome) => `merged; version ${outcome.version ?? "none"}`,
+    }),
 ];
 //# sourceMappingURL=flow.js.map

package/dist/tools/flow.js.map

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

package/dist/tools/project.js

@@ -1,6 +1,6 @@
 // bos project <tool>: the project around the current directory
 import { tool } from "../core/tool.js";
-import { authorsText } from "../views/project.js";
+import { creditText } from "../views/crediting.js";
 export const projectTools = [
     tool({
         model: "project",
@@ -8,11 +8,15 @@ export const projectTools = [
         info: "name every entity of the commits (people, agents, bots) in .github/AUTHORS; new ones appended",
         readOnly: false,
         args: [
-            { name: "dir", type: "string", info: "a path inside the project (default: current directory)" },
+            {
+                name: "dir",
+                type: "string",
+                info: "a path inside the project (default: current directory)",
+            },
             { name: "dryRun", type: "boolean", info: "only say what would be written" },
         ],
         run: (bos, input) => bos.authors({ dir: input.dir, dryRun: Boolean(input.dryRun) }),
-        render: authorsText,
+        render: creditText,
     }),
 ];
 //# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+FAA+F;QACrG,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,wDAAwD,EAAE;YAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAE;SAC5E;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzG,MAAM,EAAE,WAAW;KACpB,CAAC;CACH,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+FAA+F;QACrG,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,wDAAwD;aAC/D;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAE;SAC5E;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAClB,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtF,MAAM,EAAE,UAAU;KACnB,CAAC;CACH,CAAC"}

package/dist/tools/scope.js

@@ -16,8 +16,9 @@ export const scopeTools = [
         args: [scopeArg],
         run: (bos, input) => {
             const scope = bos.workshop.forge.scope(String(input.scope));
-            if (!scope.exists())
+            if (!scope.exists()) {
                 throw new Error(`no scope at ${scope.path}`);
+            }
             return { scope: scope.name, version: scope.version() };
         },
         render: (result) => `${result.scope}  ${result.version ? `v${result.version}` : "no version yet"}`,
@@ -40,9 +41,12 @@ export const scopeTools = [
         ],
         run: async (bos, input) => {
             const event = String(input.event);
-            if (!isLoopEvent(event))
+            if (!isLoopEvent(event)) {
                 throw new Error(`"${event}" is not a loop event (${EVENTS.join(", ")})`);
-            const context = await bos.bumpScope(String(input.scope), event, { dryRun: Boolean(input.dryRun) });
+            }
+            const context = await bos.bumpScope(String(input.scope), event, {
+                dryRun: Boolean(input.dryRun),
+            });
             return { ...context.result, dryRun: context.dryRun };
         },
         render: (result) => `${result.scope}  ${result.from ? `v${result.from}` : "(none)"} → v${result.to}${result.dryRun ? "  (dry run)" : ""}`,

package/dist/tools/scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/tools/scope.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,yBAAyB;IAC/B,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,mEAAmE;QACzE,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE;KACnG,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,oDAAoD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7E,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,QAAQ;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,8CAA8C;gBACpD,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;SACvE;QACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClG,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnG,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE;KACxH,CAAC;CACH,CAAC"}
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/tools/scope.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,yBAAyB;IAC/B,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,mEAAmE;QACzE,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE;KACjF,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,oDAAoD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7E,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,QAAQ;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,8CAA8C;gBACpD,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;SACvE;QACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE;gBAC9D,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;aAC9B,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE;KACxH,CAAC;CACH,CAAC"}

package/dist/tools/version.js

@@ -7,14 +7,21 @@ export const versionTools = [
         name: "bump",
         info: "the next version after a loop event; semver X.Y.Z, or GRIH G.R.I.H with --grih",
         args: [
-            { name: "version", type: "string", info: "current version, e.g. 0.6.1", positional: true, required: true },
+            {
+                name: "version",
+                type: "string",
+                info: "current version, e.g. 0.6.1",
+                positional: true,
+                required: true,
+            },
             { name: "event", type: "string", info: EVENTS.join(", "), positional: true, required: true },
             { name: "grih", type: "boolean", info: "read and write GRIH instead of semver" },
         ],
         run: (_bos, input) => {
             const event = String(input.event);
-            if (!isLoopEvent(event))
+            if (!isLoopEvent(event)) {
                 throw new Error(`"${event}" is not a loop event (${EVENTS.join(", ")})`);
+            }
             return (input.grih ? bumpGrih : bumpSemver)(String(input.version), event);
         },
         render: (result) => result,

package/dist/tools/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,gFAAgF;QACtF,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,6BAA6B,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1G,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,uCAAuC,EAAE;SACjF;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;KAC3B,CAAC;CACH,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,gFAAgF;QACtF,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,6BAA6B;gBACnC,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,uCAAuC,EAAE;SACjF;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;KAC3B,CAAC;CACH,CAAC"}

package/dist/tools/workshop.js

@@ -35,7 +35,11 @@ export const workshopTools = [
         name: "watch",
         info: "listen to changes in the workshop until Ctrl+C; one line per change",
         args: [
-            { name: "record", type: "boolean", info: "also append every change to .BOS/storylines/logs/workshop.jsonl" },
+            {
+                name: "record",
+                type: "boolean",
+                info: "also append every change to .BOS/storylines/logs/workshop.jsonl",
+            },
             { name: "json", type: "boolean", info: "one JSON object per line" },
         ],
         run: async (bos, input, io) => {

package/dist/tools/workshop.js.map

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

package/dist/views/crediting.d.ts

@@ -0,0 +1,2 @@
+import type { CreditOutcome } from "../procedures/index.ts";
+export declare function creditText(outcome: CreditOutcome): string;

package/dist/views/crediting.js

@@ -0,0 +1,11 @@
+export function creditText(outcome) {
+    if (outcome.action === "none") {
+        return `${outcome.file}: everyone is named`;
+    }
+    const verb = outcome.action === "written" ? "" : "would be ";
+    const head = `${outcome.file}: ${outcome.added.length} ${verb}added, ${outcome.updated.length} ${verb}updated`;
+    const updated = outcome.updated.map((entry) => `  ~ ${entry}`);
+    const added = outcome.added.map((entry) => `  + ${entry}`);
+    return [head, ...updated, ...added].join("\n");
+}
+//# sourceMappingURL=crediting.js.map

package/dist/views/crediting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crediting.js","sourceRoot":"","sources":["../../src/views/crediting.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU,CAAC,OAAsB;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,GAAG,OAAO,CAAC,IAAI,qBAAqB,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7D,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,UAAU,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,SAAS,CAAC;IAC/G,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/views/devlog.js

@@ -1,6 +1,6 @@
 export function stateMarkdown(state) {
     const phase = (p) => `| ${p.number}: ${p.title} | ${p.done}/${p.total} | ${p.complete ? "complete" : p.done ? "in progress" : "not started"} |`;
-    const list = (items) => (items.length ? items.map((item) => `- ${item}`).join("\n") : "None.");
+    const list = (items) => items.length ? items.map((item) => `- ${item}`).join("\n") : "None.";
     return `# State of development
 
 Made by \`bos devlog state\` (\`task devlog:state\`); not kept in git, never edited by hand.

package/dist/views/devlog.js.map

@@ -1 +1 @@
-{"version":3,"file":"devlog.js","sourceRoot":"","sources":["../../src/views/devlog.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,KAAK,GAAG,CAAC,CAAQ,EAAE,EAAE,CACzB,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC;IAC7H,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACzG,OAAO;;;;;;gBAMO,KAAK,CAAC,OAAO;eACd,KAAK,CAAC,MAAM,IAAI,QAAQ;cACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,iBAAiB;qBACnD,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI;wBAC/C,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI;;;;;;EAM9E,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAIlC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;;;;EAIrB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;EACrB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC"}
+{"version":3,"file":"devlog.js","sourceRoot":"","sources":["../../src/views/devlog.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,KAAK,GAAG,CAAC,CAAQ,EAAE,EAAE,CACzB,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC;IAC7H,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,EAAE,CAC/B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,OAAO;;;;;;gBAMO,KAAK,CAAC,OAAO;eACd,KAAK,CAAC,MAAM,IAAI,QAAQ;cACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,iBAAiB;qBACnD,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI;wBAC/C,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI;;;;;;EAM9E,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAIlC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;;;;EAIrB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;EACrB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC"}

package/dist/views/event.d.ts

@@ -1,2 +1,2 @@
-import type { WorkshopEvent } from "../procedures/_index.ts";
+import type { WorkshopEvent } from "../procedures/index.ts";
 export declare function eventText(event: WorkshopEvent): string;

package/dist/views/event.js

@@ -1,6 +1,18 @@
+// the clock time of a UNIXUSAT (unix time in milliseconds): "14:03:27.512"
+// (an ISO date is "2026-11-05T14:03:27.512Z"; characters 11-23 are its time)
+function timerStop(unixusat) {
+    return new Date(unixusat).toISOString().slice(11, 23);
+}
+// the place of the event: "forge › scope › project", only the parts it has
+function whereHook(event) {
+    const parts = [event.area ?? "(root)", event.scope, event.project];
+    return parts.filter(Boolean).join(" › ");
+}
 export function eventText(event) {
-    const time = new Date(event.unixusat).toISOString().slice(11, 23);
-    const where = [event.area ?? "(root)", event.scope, event.project].filter(Boolean).join(" › ");
-    return `${time}  ${event.kind.padEnd(6)}  ${where}${event.inner ? `  ${event.inner}` : ""}`;
+    const when = timerStop(event.unixusat);
+    const kind = event.kind.padEnd(6);
+    const where = whereHook(event);
+    const what = event.inner ? `  ${event.inner}` : "";
+    return `${when}  ${kind}  ${where}${what}`;
 }
 //# sourceMappingURL=event.js.map

package/dist/views/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/views/event.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/F,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9F,CAAC"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/views/event.ts"],"names":[],"mappings":"AAaA,2EAA2E;AAC3E,6EAA6E;AAC7E,SAAS,SAAS,CAAC,QAAgB;IACjC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,2EAA2E;AAC3E,SAAS,SAAS,CAAC,KAAoB;IACrC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,GAAG,IAAI,KAAK,IAAI,KAAK,KAAK,GAAG,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/dist/views/flow.d.ts

@@ -1,12 +1,12 @@
-import type { LoopData, LoopStep, VersioningData } from "../models/_index.ts";
-import type { BumpOutcome, FlowOutcome } from "../procedures/_index.ts";
-export declare function stepText(step: LoopStep): string;
+import type { LoopData, LoopStep, VersioningData } from "../models/index.ts";
+import type { BumpOutcome, FlowOutcome } from "../procedures/index.ts";
 export type Explained = {
     source: string;
     steps: LoopStep[];
     data: LoopData;
     versioning: VersioningData;
 };
+export declare function stepText(step: LoopStep): string;
 export declare function explainText({ source, steps, data, versioning }: Explained): string;
 export declare function outcomeText(outcome: FlowOutcome): string;
 export declare function bumpText(outcome: BumpOutcome): string;

package/dist/views/flow.js

@@ -1,25 +1,46 @@
+// one step of the loop:  "revision       → master       a person merges  (or back to rejection)"
 export function stepText(step) {
+    const from = step.from.padEnd(14);
+    const to = step.to.padEnd(12);
     const merge = step.automerge ? "merges by itself" : "a person merges";
     const back = step.back.length ? `  (or back to ${step.back.join(", ")})` : "";
-    return `${step.from.padEnd(14)} → ${step.to.padEnd(12)} ${merge}${back}`;
+    return `${from} → ${to} ${merge}${back}`;
 }
-export function explainText({ source, steps, data, versioning }) {
-    const { contributors, autocreate, release } = data;
+// the contributors' branches flow into development like a step
+function contributorsText({ contributors }) {
+    return `${contributors.pattern.padEnd(14)} → ${contributors.into.padEnd(12)} a person merges`;
+}
+function pullRequestsText({ autocreate, release }) {
+    const by = autocreate ? "by the loop" : "by people (autocreate is off)";
+    return `pull requests of forward steps are opened ${by}; releases on ${release}`;
+}
+function bumpsText(versioning) {
     const bumps = Object.entries(versioning.bumps).map(([branch, bump]) => `${bump} on ${branch}`);
+    const released = `each once the line it leaves is released (${versioning.tagPrefix}<line>)`;
+    return `version bumps: ${bumps.join(", ") || "none"}, ${released}`;
+}
+function commitsText({ commits }) {
+    return `every commit on ${commits.branches.join(", ")}: ${commits.bump}`;
+}
+export function explainText({ source, steps, data, versioning }) {
+    const title = `craft loop (${source === "default" ? "the default loop" : source})`;
     return [
-        `craft loop (${source === "default" ? "the default loop" : source})`,
+        title,
         "",
         ...steps.map((step) => `  ${stepText(step)}`),
-        `  ${contributors.pattern.padEnd(14)} → ${contributors.into.padEnd(12)} a person merges`,
+        `  ${contributorsText(data)}`,
         "",
-        `pull requests of forward steps are opened ${autocreate ? "by the loop" : "by people (autocreate is off)"}; releases on ${release}`,
-        `version bumps: ${bumps.join(", ") || "none"}; only a released (${versioning.tagPrefix}<version>) version moves`,
+        pullRequestsText(data),
+        bumpsText(versioning),
+        commitsText(versioning),
     ].join("\n");
 }
+// what next-pr / automerge did, with the step it was about
 export function outcomeText(outcome) {
     const step = outcome.step ? `${outcome.step.from} → ${outcome.step.to}: ` : "";
     return `${step}${outcome.reason || outcome.action}`;
 }
+// what a bump did: its reason when it says more than its action
 export function bumpText(outcome) {
     return outcome.reason || outcome.action;
 }

package/dist/views/flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/views/flow.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;AAC3E,CAAC;AAID,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAa;IACxE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,MAAM,EAAE,CAAC,CAAC;IAC/F,OAAO;QACL,eAAe,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,GAAG;QACpE,EAAE;QACF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,KAAK,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,kBAAkB;QACxF,EAAE;QACF,6CAA6C,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,+BAA+B,iBAAiB,OAAO,EAAE;QACnI,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,sBAAsB,UAAU,CAAC,SAAS,0BAA0B;KACjH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/views/flow.ts"],"names":[],"mappings":"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"}

package/dist/views/help.js

@@ -1,22 +1,33 @@
+// how an argument is written: <operand>, --flag, --option=<value>; [in brackets] when optional
+function argShape(arg) {
+    let shape = `--${arg.name}=<value>`;
+    if (arg.positional) {
+        shape = `<${arg.name}>`;
+    }
+    else if (arg.type === "boolean") {
+        shape = `--${arg.name}`;
+    }
+    return arg.required ? shape : `[${shape}]`;
+}
 function usage(entry) {
+    return [`bos ${entry.model} ${entry.name}`, ...entry.args.map(argShape)].join(" ");
+}
+// a tool: its usage, what it does, then each argument
+function toolLines(entry) {
+    const writes = entry.readOnly ? "" : "  (writes)";
     const args = entry.args.map((arg) => {
-        const shape = arg.positional ? `<${arg.name}>` : arg.type === "boolean" ? `--${arg.name}` : `--${arg.name}=<value>`;
-        return arg.required ? shape : `[${shape}]`;
+        const name = arg.positional ? arg.name : `--${arg.name}`;
+        return `        ${name}: ${arg.info}`;
     });
-    return [`bos ${entry.model} ${entry.name}`, ...args].join(" ");
+    return [`  ${usage(entry)}`, `      ${entry.info}${writes}`, ...args];
 }
 export function helpText(tools, version) {
-    const lines = [
+    return [
         `bos ${version}: the Blacksmith Organization System core`,
         "",
         "usage: bos <model> <tool> [operands] [--flags]   common flags: --workshop=<path> --json",
         "",
-    ];
-    for (const entry of tools) {
-        lines.push(`  ${usage(entry)}`, `      ${entry.info}${entry.readOnly ? "" : "  (writes)"}`);
-        for (const arg of entry.args)
-            lines.push(`        ${arg.positional ? arg.name : `--${arg.name}`}: ${arg.info}`);
-    }
-    return lines.join("\n");
+        ...tools.flatMap(toolLines),
+    ].join("\n");
 }
 //# sourceMappingURL=help.js.map

package/dist/views/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/views/help.ts"],"names":[],"mappings":"AAGA,SAAS,KAAK,CAAC,KAAW;IACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,UAAU,CAAC;QACpH,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAe;IACrD,MAAM,KAAK,GAAG;QACZ,OAAO,OAAO,2CAA2C;QACzD,EAAE;QACF,yFAAyF;QACzF,EAAE;KACH,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5F,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/views/help.ts"],"names":[],"mappings":"AAOA,+FAA+F;AAC/F,SAAS,QAAQ,CAAC,GAAQ;IACxB,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,IAAI,UAAU,CAAC;IACpC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC;IAC1B,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,GAAG,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,KAAK,CAAC,KAAW;IACxB,OAAO,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrF,CAAC;AAED,sDAAsD;AACtD,SAAS,SAAS,CAAC,KAAW;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACzD,OAAO,WAAW,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAe;IACrD,OAAO;QACL,OAAO,OAAO,2CAA2C;QACzD,EAAE;QACF,yFAAyF;QACzF,EAAE;QACF,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/views/status.d.ts

@@ -1,4 +1,4 @@
-import type { WorkshopReport } from "../procedures/_index.ts";
+import type { WorkshopReport } from "../procedures/index.ts";
 export declare function statusText(report: WorkshopReport, { all }?: {
     all?: boolean | undefined;
 }): string;