blacksmith-organization-system 1.6.0 → 1.7.0

package/dist/tools/almanac.js

@@ -0,0 +1,56 @@
+// bos almanac <tool>: the rules of the environment and the situations met before
+import { tool } from "../core/tool.js";
+import { judgeText, recallText, rulesText } from "../views/almanac.js";
+const dirArg = {
+    name: "dir",
+    type: "string",
+    info: "a path inside the project whose docs/almanac/ comes first (default: current directory)",
+};
+export const almanacTools = [
+    tool({
+        model: "almanac",
+        name: "rules",
+        info: "every ruleset of the almanac (the project's docs/almanac/, then the core's), rule by rule",
+        args: [dirArg],
+        run: (bos, input) => bos.almanac(input.dir),
+        render: rulesText,
+    }),
+    tool({
+        model: "almanac",
+        name: "judge",
+        info: 'does a case break a rule: in words ("Cleo pushes to master") or JSON ({"action":"push"…})',
+        args: [
+            {
+                name: "case",
+                type: "string",
+                info: "the case, quoted",
+                positional: true,
+                required: true,
+            },
+            dirArg,
+        ],
+        run: (bos, input) => bos.judge(String(input.case), { dir: input.dir }),
+        render: judgeText,
+    }),
+    tool({
+        model: "almanac",
+        name: "recall",
+        info: "the chains of events met before that hold these events, and what usually comes next",
+        args: [
+            {
+                name: "events",
+                type: "string",
+                info: "events so far, comma-separated: commit,hook:bump-version",
+                positional: true,
+                required: true,
+            },
+            dirArg,
+        ],
+        run: (bos, input) => bos.recall(String(input.events)
+            .split(",")
+            .map((event) => event.trim())
+            .filter(Boolean), { dir: input.dir }),
+        render: recallText,
+    }),
+];
+//# sourceMappingURL=almanac.js.map

package/dist/tools/almanac.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"almanac.js","sourceRoot":"","sources":["../../src/tools/almanac.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,wFAAwF;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,2FAA2F;QACjG,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAyB,CAAC;QACjE,MAAM,EAAE,SAAS;KAClB,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,2FAA2F;QACjG,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,kBAAkB;gBACxB,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,MAAM;SACP;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,CAAC;QAC5F,MAAM,EAAE,SAAS;KAClB,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,qFAAqF;QAC3F,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,0DAA0D;gBAChE,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,MAAM;SACP;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAClB,GAAG,CAAC,MAAM,CACR,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;aACjB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC,EAClB,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,CACzC;QACH,MAAM,EAAE,UAAU;KACnB,CAAC;CACH,CAAC"}

package/dist/tools/project.js

@@ -1,6 +1,12 @@
 // bos project <tool>: the project around the current directory
 import { tool } from "../core/tool.js";
 import { creditText } from "../views/crediting.js";
+import { sealText } from "../views/sealing.js";
+const dirArg = {
+    name: "dir",
+    type: "string",
+    info: "a path inside the project (default: current directory)",
+};
 export const projectTools = [
     tool({
         model: "project",
@@ -18,5 +24,27 @@ export const projectTools = [
         run: (bos, input) => bos.authors({ dir: input.dir, dryRun: Boolean(input.dryRun) }),
         render: creditText,
     }),
+    tool({
+        model: "project",
+        name: "omnis",
+        info: "the project's halo (.bos/.omnis.toml) now against the sealed one: what was added, changed, removed",
+        readOnly: true,
+        args: [dirArg],
+        run: (bos, input) => bos.omnis({ dir: input.dir }),
+        render: sealText,
+    }),
+    tool({
+        model: "project",
+        name: "seal",
+        info: "write the project's halo into .bos/.omnis.toml (only when something changed)",
+        readOnly: false,
+        args: [dirArg, { name: "dryRun", type: "boolean", info: "only say what would be written" }],
+        run: (bos, input) => bos.omnis({
+            dir: input.dir,
+            seal: true,
+            dryRun: Boolean(input.dryRun),
+        }),
+        render: sealText,
+    }),
 ];
 //# 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,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"}
+{"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;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,wDAAwD;CAC/D,CAAC;AAEF,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;IACF,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,oGAAoG;QAC1G,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,CAAC;QACxE,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,8EAA8E;QACpF,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;QAC3F,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAClB,GAAG,CAAC,KAAK,CAAC;YACR,GAAG,EAAE,KAAK,CAAC,GAAyB;YACpC,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;SAC9B,CAAC;QACJ,MAAM,EAAE,QAAQ;KACjB,CAAC;CACH,CAAC"}

package/dist/views/almanac.d.ts

@@ -0,0 +1,5 @@
+import type { Almanac } from "../models/index.ts";
+import type { JudgeContext, RecallContext } from "../procedures/index.ts";
+export declare function judgeText({ judgement }: JudgeContext): string;
+export declare function rulesText(almanac: Almanac): string;
+export declare function recallText({ events, prediction, chains }: RecallContext): string;

package/dist/views/almanac.js

@@ -0,0 +1,59 @@
+const VERDICT = {
+    allowed: "ALLOWED",
+    ask: "ASK FIRST",
+    violation: "VIOLATION",
+    unknown: "UNKNOWN",
+};
+const fields = (subject) => Object.entries(subject)
+    .map(([field, value]) => `${field}=${Array.isArray(value) ? value.join(",") : value}`)
+    .join("  ");
+const ruleLine = (rule) => `${rule.ruleset}/${rule.id}: ${rule.statement}${rule.source ? `  (${rule.source})` : ""}`;
+export function judgeText({ judgement }) {
+    if (!judgement) {
+        return "no judgement";
+    }
+    const lines = [`${VERDICT[judgement.verdict]}  ${fields(judgement.case)}`];
+    if (judgement.rule) {
+        lines.push(`  ${ruleLine(judgement.rule)}`);
+    }
+    else {
+        lines.push("  no rule applies: ask the owner");
+    }
+    lines.push(...judgement.also.map((rule) => `  also (${rule.verdict}) ${ruleLine(rule)}`));
+    return lines.join("\n");
+}
+export function rulesText(almanac) {
+    const lines = [`almanac: ${almanac.places.join(", ")}`];
+    for (const { ruleset, rules, roles } of almanac.rulesets) {
+        lines.push("", `${ruleset}`);
+        for (const [role, names] of Object.entries(roles ?? {})) {
+            lines.push(`  role ${role}: ${names.join(", ")}`);
+        }
+        for (const rule of rules) {
+            lines.push(`  ${rule.verdict.padEnd(9)} ${rule.id}: ${rule.statement}`);
+        }
+    }
+    lines.push("", `${almanac.chains.length} chains of events (bos almanac recall <event,event…>)`);
+    return lines.join("\n");
+}
+export function recallText({ events, prediction, chains }) {
+    const lines = [`after ${events.join(" → ")}`];
+    if (prediction?.next.length) {
+        lines.push(`  next (after ${prediction.after}):`);
+        lines.push(...prediction.next.map(({ event, p }) => `    ${(p * 100).toFixed(0).padStart(3)}%  ${event}`));
+    }
+    else {
+        lines.push("  nothing known comes next");
+    }
+    for (const chain of chains) {
+        lines.push("", `  ${chain.id}: ${chain.events.join(" → ")}`);
+        if (chain.solution) {
+            lines.push(`    solved: ${chain.solution}`);
+        }
+        if (chain.seen?.length) {
+            lines.push(`    seen: ${chain.seen.join("; ")}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=almanac.js.map

package/dist/views/almanac.js.map

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

package/dist/views/sealing.d.ts

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

package/dist/views/sealing.js

@@ -0,0 +1,26 @@
+const when = (unixusat) => new Date(unixusat).toISOString();
+export function sealText(outcome) {
+    const lines = [`${outcome.file}: ${outcome.files} files in the halo`];
+    if (outcome.sealedAt === null) {
+        lines.push("  never sealed (bos project seal writes it)");
+    }
+    else if (outcome.drift) {
+        const { added, changed, removed } = outcome.drift;
+        lines.push(`  sealed at UNIXUSAT=${outcome.sealedAt} (${when(outcome.sealedAt)})`);
+        if (!added.length && !changed.length && !removed) {
+            lines.push("  nothing changed since");
+        }
+        lines.push(...changed.map((path) => `  ~ ${path}`), ...added.map((path) => `  + ${path}`));
+        if (removed) {
+            lines.push(`  - ${removed} gone (only their hashes were kept)`);
+        }
+    }
+    if (outcome.action === "written") {
+        lines.push("  sealed now");
+    }
+    else if (outcome.action === "would-write") {
+        lines.push("  would be sealed now");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=sealing.js.map

package/dist/views/sealing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealing.js","sourceRoot":"","sources":["../../src/views/sealing.ts"],"names":[],"mappings":"AAGA,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;AAEpE,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,oBAAoB,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3F,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,qCAAqC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blacksmith-organization-system",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Blacksmith Organization System (BOS) core: the workshop as code - build its base, listen to its changes, inspect it as one coherent environment",
   "keywords": [
     "bos",
@@ -44,6 +44,7 @@
     "node": ">=22.18"
   },
   "scripts": {
+    "start": "task",
     "bos": "node src/cli.ts",
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
@@ -75,11 +76,13 @@
     "astro": "^7.4.6",
     "bulma": "^1.0.4",
     "chromadb": "^3.5.0",
+    "commander": "^15.0.0",
     "commitizen": "^4.3.2",
     "composerize": "^1.7.6",
     "cosmiconfig": "^10.0.1",
     "decomposerize": "^1.4.4",
     "dockerode": "^5.0.1",
+    "esbuild": "^0.28.2",
     "husky": "^9.1.7",
     "inquirer": "^12.11.1",
     "isomorphic-git": "^1.44.11",

package/resources/almanac/patterning/bos-core.json

@@ -0,0 +1,90 @@
+{
+  "about": "Situations met while forging the core (phase 2), each a chain of events up to its cataclysm, with the solution that got past it.",
+  "chains": [
+    {
+      "id": "lint-fails-on-bumped-package-json",
+      "events": ["commit", "hook:bump-version", "push:revision", "checks:lint-failed"],
+      "cataclysm": "checks:lint-failed",
+      "solution": "The bump wrote package.json with its arrays expanded and biome wanted them on one line: biome formats every package.json expanded (an override), and a test pins it.",
+      "seen": ["phase 2: the release of v1.4.x"]
+    },
+    {
+      "id": "draft-snippets-fail-lint",
+      "events": ["commit", "hook:bump-version", "file:unformatted-draft", "checks:lint-failed"],
+      "cataclysm": "checks:lint-failed",
+      "solution": "A draft of the owner is kept as written: its directory is left out of biome (examples/00-draft-snippets).",
+      "seen": ["2026-11-06: the draft snippets"]
+    },
+    {
+      "id": "open-pull-request-keeps-old-title",
+      "events": [
+        "push:revision",
+        "workflow:bump-minor",
+        "pull-request:open-already",
+        "pull-request:stale-title"
+      ],
+      "cataclysm": "pull-request:stale-title",
+      "solution": "The open pull request follows its branch: scripts/workflows/pull-request.sh edits its title and description to the version it releases now.",
+      "seen": ["PR #9 (v1.4.9, released v1.4.10)"]
+    },
+    {
+      "id": "secret-scanner-flags-test-fixture",
+      "events": [
+        "commit:fixture-with-credentials-url",
+        "push:revision",
+        "pull-request:open",
+        "gitguardian:flagged"
+      ],
+      "cataclysm": "gitguardian:flagged",
+      "solution": "Tests build user:token@host URLs from parts, so no literal sits in the source.",
+      "seen": ["phase 2: mirrors.sh tests"]
+    },
+    {
+      "id": "mirror-token-refused",
+      "events": ["push:development", "mirrors:sync", "mirrors:403"],
+      "cataclysm": "mirrors:403",
+      "solution": "The owner renews the token in the publish-env environment; the mirrors step continues on error, so the run and the work go on.",
+      "seen": ["phase 2: gitlab, bitbucket (run 42139753049 all 200 after)"]
+    },
+    {
+      "id": "push-rejected-after-bot-bump",
+      "events": ["push:revision", "workflow:bump-commit", "push:development", "push:rejected"],
+      "cataclysm": "push:rejected",
+      "solution": "The workflow pushed its bump to development: fetch, merge origin/development (the version merge driver takes the higher), push again. Pull development before every batch.",
+      "seen": ["phase 2, several batches", "2026-11-06: PR #11 merged meanwhile"]
+    },
+    {
+      "id": "bot-pull-request-waits-for-approval",
+      "events": ["push:revision", "workflow:opens-pull-request", "checks:action-required"],
+      "cataclysm": "checks:action-required",
+      "solution": "Checks of a pull request opened by github-actions[bot] wait: the owner presses Approve and run, or the next push to revision runs them.",
+      "seen": ["PR #11 (run 42140002829)"]
+    },
+    {
+      "id": "commit-header-too-long",
+      "events": ["commit", "hook:bump-version", "commitlint:header-too-long"],
+      "cataclysm": "commitlint:header-too-long",
+      "solution": "Shorten the header to 100 characters. The bump and the staged files stay staged: check git show --stat of the next commit, so nothing of the failed one rides along.",
+      "seen": ["2026-11-06: taking in the almanac and Q16 (folded into the next commit, redone)"]
+    },
+    {
+      "id": "npm-installs-the-legacy-release",
+      "events": ["npm:install", "npm:latest-is-legacy", "installed:0.4.2"],
+      "cataclysm": "installed:0.4.2",
+      "solution": "npm's latest is still the legacy 0.4.2 (decision Q7): install blacksmith-organization-system@next, or ask for ^1.0.0.",
+      "seen": ["2026-11-06: examples/00-draft-snippets/scrapnotes.md"]
+    },
+    {
+      "id": "workshop-option-on-a-partition-root",
+      "events": [
+        "library:new-bos",
+        "option:workshop-not-named-__WORKSHOP",
+        "bootstrap",
+        "workshop:second-beside-__WORKSHOP"
+      ],
+      "cataclysm": "workshop:second-beside-__WORKSHOP",
+      "solution": "A --workshop (or { workshop }) not named __WORKSHOP is the directory that holds one, like $WORKSHOP_ROOT.",
+      "seen": ["2026-11-06 05:11: the draft snippets on setternet-A62"]
+    }
+  ]
+}

package/resources/almanac/rulesets/bos-environment.json

@@ -0,0 +1,141 @@
+{
+  "ruleset": "bos-environment",
+  "about": "The rules of every BOS workshop and project, for people and agents alike (the contributors committee). The first rule that applies decides.",
+  "rules": [
+    {
+      "id": "never-skip-hooks",
+      "statement": "Checks are never skipped: no --no-verify, no HUSKY=0. Chain a commit after the checks with &&.",
+      "when": { "action": ["commit", "push", "merge"], "flags": ["--no-verify", "-n", "HUSKY=0"] },
+      "verdict": "violation",
+      "source": "AGENTS.md, rule 3"
+    },
+    {
+      "id": "never-commit-on-master",
+      "statement": "master is the spine of canon: nobody commits on it; it moves only through a pull request from releasing (or revision, in phase 2).",
+      "when": { "action": "commit", "target": ["master", "main"] },
+      "verdict": "violation",
+      "source": "AGENTS.md, the craft loop"
+    },
+    {
+      "id": "mirrors-never-publish",
+      "statement": "A mirror only checks: it never publishes, releases or deploys (Read the Docs, npm, images).",
+      "when": { "action": ["publish", "release", "deploy"], "place": ["mirror*"] },
+      "verdict": "violation",
+      "source": "the owner, phase 2: mirrors"
+    },
+    {
+      "id": "workshop-areas-stay",
+      "statement": "The top-level areas of a workshop (.BOS, devarmory, forge, craftbook, archive) are never deleted, moved or restructured.",
+      "when": {
+        "action": ["delete", "remove", "move", "restructure", "rm"],
+        "target": [".BOS", "devarmory", "forge", "craftbook", "archive"]
+      },
+      "verdict": "violation",
+      "source": "__WORKSHOP/AGENTS.md, rule 4"
+    },
+    {
+      "id": "never-reveal-secrets",
+      "statement": "Secrets are never printed or shown: no cat .env, no tokens or keys in output, logs or commits.",
+      "when": {
+        "action": ["print", "cat", "show", "echo", "reveal", "commit", "log"],
+        "target": [".env", "*token*", "secret*", "*.pem", "id_rsa*", "id_ed25519*", "password*"]
+      },
+      "verdict": "violation",
+      "source": "the owner, phase 2: security"
+    },
+    {
+      "id": "never-revert-the-owner",
+      "statement": "Anything in the working tree an agent did not make is the owner's: it is intended, never reverted or overwritten.",
+      "when": {
+        "action": ["revert", "overwrite", "discard", "reset"],
+        "target": ["owner*", "Sarverott*"]
+      },
+      "verdict": "violation",
+      "source": "AGENTS.md, rule 2"
+    },
+    {
+      "id": "other-repositories-get-notes",
+      "statement": "Work for another repository is written down in forge/NOTES-for-repositories.md; the other repository is never edited.",
+      "when": {
+        "role": "agent",
+        "action": ["edit", "commit", "change", "write"],
+        "target": ["other*", "another*"]
+      },
+      "verdict": "violation",
+      "source": "AGENTS.md, where things go"
+    },
+    {
+      "id": "tests-in-temporary-workshops",
+      "statement": "Tests build their own temporary workshops; never the home ~/__WORKSHOP.",
+      "when": { "action": "test", "place": ["~/__WORKSHOP*", "/home/*/__WORKSHOP*"] },
+      "verdict": "violation",
+      "source": "AGENTS.md, rule 8"
+    },
+    {
+      "id": "home-workshop-only-when-asked",
+      "statement": "BOS is tried and demonstrated on the development workshop (.env WORKSHOP_ROOT); the home ~/__WORKSHOP only when the owner asks.",
+      "when": {
+        "action": ["run", "bootstrap", "try", "demonstrate", "write"],
+        "place": ["~/__WORKSHOP*", "/home/*/__WORKSHOP*"]
+      },
+      "verdict": "ask",
+      "source": "AGENTS.md, the development workshop"
+    },
+    {
+      "id": "agents-open-no-pull-request",
+      "statement": "An agent opens no pull request: it pushes development to revision, and the workflow opens revision → master.",
+      "when": {
+        "role": "agent",
+        "action": ["open", "create"],
+        "target": ["PR", "pull-request", "pull"]
+      },
+      "verdict": "violation",
+      "source": "AGENTS.md, the routine"
+    },
+    {
+      "id": "agents-push-their-branches",
+      "statement": "An agent pushes development, its own dev/<name> and revision without asking.",
+      "when": { "role": "agent", "action": "push", "target": ["development", "revision", "dev/*"] },
+      "verdict": "allowed",
+      "source": "AGENTS.md, rule 10"
+    },
+    {
+      "id": "protected-branches-ask",
+      "statement": "master, testing and releasing are pushed only with the owner's OK, and the reason.",
+      "when": { "action": "push", "target": ["master", "main", "testing", "releasing"] },
+      "verdict": "ask",
+      "source": "AGENTS.md, rule 10"
+    },
+    {
+      "id": "tags-releases-publishing-ask",
+      "statement": "Tags, releases and publishing (npm, the wiki's repository, images) are asked for first.",
+      "when": { "action": ["tag", "release", "publish"] },
+      "verdict": "ask",
+      "source": "AGENTS.md, rule 10"
+    },
+    {
+      "id": "remotes-and-settings-ask",
+      "statement": "Remotes and repository settings are changed only with the owner's OK.",
+      "when": {
+        "action": ["change", "add", "remove", "set", "rename"],
+        "target": ["remote*", "settings", "secrets", "webhook*"]
+      },
+      "verdict": "ask",
+      "source": "AGENTS.md, rule 10"
+    },
+    {
+      "id": "email-stays-private",
+      "statement": "The owner's e-mail address identifies the owner only; it is not sent to services unless the owner asks.",
+      "when": { "action": ["send", "post", "submit"], "target": ["email", "e-mail", "mail*"] },
+      "verdict": "ask",
+      "source": "the owner, phase 2: security"
+    },
+    {
+      "id": "questions-are-not-settled-in-code",
+      "statement": "An open question (BRAINSTORM.md Q<n>) is never settled in code: the owner answers it in ORDERS.md.",
+      "when": { "action": ["settle", "decide", "answer"], "target": ["question*", "BRAINSTORM*"] },
+      "verdict": "violation",
+      "source": "AGENTS.md, read first"
+    }
+  ]
+}