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

package/src/commands/close/help.md

@@ -1,5 +0,0 @@
-# close
-
-`bos close` copies the shell history to
-`.BOS/storylines/ttystories/ttystory-<host>-<unixusat>.txt` and records the
-closing. Run `history -a` first so the current shell is included.

package/src/commands/close/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/close",
-  "info": "keep shell history as a ttystory, record the closing",
-  "mode": "conform",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/describe/exec.mjs

@@ -1,11 +0,0 @@
-export default async ({ bos, operands: [file, source], flags }) => {
-  const context = await bos.workshop.describe({
-    ...(flags.hook ? { file, source } : {}),
-    ...(flags.skryba === "0" || flags.plain ? { skryba: false } : {}),
-  });
-  if (flags.hook) {
-    return undefined;
-  }
-  const note = context.skryba && !context.skryba.used ? `\n# Skryba: ${context.skryba.reason}` : "";
-  return (context.message ?? "nothing staged") + note;
-};

package/src/commands/describe/help.md

@@ -1,5 +0,0 @@
-# describe
-
-`bos describe` prints a conventional-commit draft of what is staged.
-`bos describe --hook <file> [source]` is what husky's `prepare-commit-msg`
-calls: it writes the draft into the commit message file of a plain `git commit`.

package/src/commands/describe/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/describe",
-  "info": "draft a conventional commit message from the staged changes",
-  "mode": "smeltry",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/help/exec.mjs

@@ -1,6 +0,0 @@
-export default ({ bos, operands: [name], flags }) => {
-  const view = new bos.views.HelpView();
-  const state = { commands: bos.commands, command: name, help: name && bos.commands[name]?.help() };
-  if (name && !bos.commands[name]) throw new Error(`unknown command "${name}"`);
-  return view.render(state, flags.json ? "json" : "text");
-};

package/src/commands/help/help.md

@@ -1,3 +0,0 @@
-# help
-
-`bos help` lists every command. `bos help <command>` shows its help.

package/src/commands/help/index.json

@@ -1,6 +0,0 @@
-{
-  "path": "/help",
-  "info": "list commands, or show the help of one",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/hook/exec.mjs

@@ -1,3 +0,0 @@
-export default async ({ bos, operands: [name] }) => {
-  await bos.workshop.hook(name);
-};

package/src/commands/hook/help.md

@@ -1,4 +0,0 @@
-# hook
-
-`bos hook <name>` is called by git hooks. It records the event, and the
-repository's place in the workshop, in storylines.

package/src/commands/hook/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/hook",
-  "info": "(called by git) record a hook in storylines",
-  "mode": "smeltry",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/hooks/exec.mjs

@@ -1,5 +0,0 @@
-export default async ({ bos, operands: [action] }) => {
-  if (action !== "install") throw new Error("usage: bos hooks install");
-  const context = await bos.workshop.installHooks();
-  return { installed: context.changes, skipped: context.skipped };
-};

package/src/commands/hooks/help.md

@@ -1,4 +0,0 @@
-# hooks
-
-`bos hooks install`, inside a git repository, links its `post-commit`,
-`post-checkout` and `post-merge` hooks to BOS. Existing hooks are left alone.

package/src/commands/hooks/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/hooks",
-  "info": "link this repository's git hooks to BOS",
-  "mode": "smeltry",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/house/exec.mjs

@@ -1,8 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.HouseView().render(
-    {
-      ...(await bos.workshop.gather()),
-      options: { all: Boolean(flags.all) },
-    },
-    flags.json ? "json" : "text",
-  );

package/src/commands/house/help.md

@@ -1,8 +0,0 @@
-# house
-
-`bos house [--all]` shows the House of Anubis: each family of
-`resources/house/families/` with its state (active, resting, frozen), its
-residents, their duties, and whether ollama serves them now. `--all` also
-lists the served models no family claims yet.
-
-Only model names are read from ollama; no resident is started or prompted.

package/src/commands/house/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/house",
-  "info": "the House of Anubis: families, residents, states, duties",
-  "mode": "provision",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/locate/exec.mjs

@@ -1,2 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.StatusView().render(await bos.workshop.locate(), flags.json ? "json" : "text");

package/src/commands/locate/help.md

@@ -1,6 +0,0 @@
-# locate
-
-`bos locate` prints the active workshop and the rule that found it:
-`--workshop`, then `$BOS_WORKSHOP`, the nearest parent `__WORKSHOP`, the
-workshop BOS is installed in, and `~/__WORKSHOP`. Also shows where BOS itself
-sits, e.g. `forge / blacksmith-organization-system / bos-skillset`.

package/src/commands/locate/index.json

@@ -1,6 +0,0 @@
-{
-  "path": "/locate",
-  "info": "active workshop, how it was found, where BOS sits",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/mode/exec.mjs

@@ -1,17 +0,0 @@
-import { modeByDigit } from "../../models/workshop/modes.mjs";
-
-export default async ({ bos, operands: [asked], flags }) => {
-  const view = new bos.views.ModeView();
-  const format = flags.json ? "json" : "text";
-
-  if (asked === undefined) {
-    const { config } = await bos.workshop.status();
-    const digit = await bos.views.chooseDigit(`${view.menu(config.mode)}choose 0-5: `, 5);
-    if (digit === 0) {
-      return undefined;
-    }
-    asked = modeByDigit(digit);
-  }
-
-  return view.render(await bos.workshop.mode(asked), format);
-};

package/src/commands/mode/help.md

@@ -1,14 +0,0 @@
-# mode
-
-`bos mode <name|digit>` switches the mode of work of this workshop.
-`bos mode` shows the menu and waits for one digit (no Enter needed); `0` leaves it.
-
-| digit | mode | covers |
-| ----- | ---- | ------ |
-| 1 | ALMANAC | emergency protocols: sinking |
-| 2 | CONFORM | establishing the workshop, migrations, cleaning, verifying, syncing between fortified workshops |
-| 3 | SMELTRY | code, development, active editing, publishing changes |
-| 4 | COMMANDORATE | rulesets, privileges, roles, switching modes |
-| 5 | PROVISION | presenting what a source of truth delivers, e.g. a repository on GitHub |
-
-The mode is kept in `.BOS/workshop.json`, and every switch is recorded in storylines.

package/src/commands/mode/index.json

@@ -1,8 +0,0 @@
-{
-  "path": "/mode",
-  "info": "show or switch the mode of work (1-5), or choose it by one digit",
-  "mode": "commandorate",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs",
-  "repl": "./repl.mjs"
-}

package/src/commands/mode/repl.mjs

@@ -1,18 +0,0 @@
-import { modeByDigit } from "../../models/workshop/modes.mjs";
-
-// inside `bos repl` the prompt owns the input, so the digit is confirmed with Enter
-export default async ({ bos, operands: [asked], io }) => {
-  const view = new bos.views.ModeView();
-
-  if (asked === undefined) {
-    const { config } = await bos.workshop.status();
-    console.log(view.menu(config.mode));
-    const digit = Number((await io.question("choose 0-5: ")).trim()[0]);
-    if (!digit || digit > 5) {
-      return undefined;
-    }
-    asked = modeByDigit(digit);
-  }
-
-  return view.text(await bos.workshop.mode(asked));
-};

package/src/commands/open/exec.mjs

@@ -1,5 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.StatusView().render(
-    await bos.workshop.open({ dryRun: Boolean(flags.dryRun) }),
-    flags.json ? "json" : "text",
-  );

package/src/commands/open/help.md

@@ -1,4 +0,0 @@
-# open
-
-`bos open [--dry-run]` runs bootstrap, then records the opening in
-`.BOS/storylines/logs/workshop.jsonl`.

package/src/commands/open/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/open",
-  "info": "bootstrap, then record the opening",
-  "mode": "conform",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/promote/exec.mjs

@@ -1,5 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.PromotionView().render(
-    await bos.workshop.promote({ reject: Boolean(flags.reject), apply: Boolean(flags.apply) }),
-    flags.json ? "json" : "text",
-  );

package/src/commands/promote/help.md

@@ -1,6 +0,0 @@
-# promote
-
-`bos promote [--reject] [--apply]` moves the current branch one station:
-`master → developement → revision → testing → releasing → master`.
-`--reject` sends work back to `developement`. Without `--apply` it only shows
-the plan. `releasing → master` opens a GitHub pull request (needs `$GITHUB_TOKEN`).

package/src/commands/promote/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/promote",
-  "info": "move the current branch one station along the flow",
-  "mode": "smeltry",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/repl/exec.mjs

@@ -1,3 +0,0 @@
-export default async ({ bos }) => {
-  await bos.views.startRepl(bos);
-};

package/src/commands/repl/help.md

@@ -1,4 +0,0 @@
-# repl
-
-`bos repl` gives an interactive prompt: type any command without `bos`, and
-`exit` to leave.

package/src/commands/repl/index.json

@@ -1,6 +0,0 @@
-{
-  "path": "/repl",
-  "info": "interactive BOS: every command at a prompt",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/seal/exec.mjs

@@ -1,8 +0,0 @@
-import { resolve } from "node:path";
-
-import { BOS } from "../../main.ts";
-
-export default ({ operands: [dir = "."], flags }) => {
-  const manifest = new BOS.Model(resolve(dir)).seal({ dryRun: Boolean(flags.dryRun) });
-  return flags.json ? manifest : `sealed ${Object.keys(manifest.files).length} files`;
-};

package/src/commands/seal/help.md

@@ -1,4 +0,0 @@
-# seal
-
-`bos seal <dir>` records a sha256 of every file in `<dir>` into its manifest
-(`manifest.json` or `.manifest.json`).

package/src/commands/seal/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/seal",
-  "info": "write checksums of a directory into its manifest",
-  "mode": "conform",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/sink/exec.mjs

@@ -1,2 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.InventoryView().render(await bos.workshop.sink(), flags.json ? "json" : "text");

package/src/commands/sink/help.md

@@ -1,6 +0,0 @@
-# sink
-
-`bos sink` is the first, read-only part of the sinking protocol. It lists
-every forge project with its branch and uncommitted changes, and the
-ttystories that show which tools were used. See
-`src/procedures/sinking/DESCRIPTION.md`.

package/src/commands/sink/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/sink",
-  "info": "inventory of what must be rescued from this workstation",
-  "mode": "almanac",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/skills/exec.mjs

@@ -1,5 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.SkillsView().render(
-    await bos.skills.scaffold({ dryRun: Boolean(flags.dryRun) }),
-    flags.json ? "json" : "text",
-  );

package/src/commands/skills/help.md

@@ -1,5 +0,0 @@
-# skills
-
-`bos skills [--dry-run]` drafts `skills/bos-<type>/SKILL.md` for every model
-that has no skill yet, using its glossary page and model class, and registers
-it in `.claude-plugin/marketplace.json`. Existing skills are never overwritten.

package/src/commands/skills/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/skills",
-  "info": "draft an agent skill for every model that has none",
-  "mode": "smeltry",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/commands/status/exec.mjs

@@ -1,2 +0,0 @@
-export default async ({ bos, flags }) =>
-  new bos.views.StatusView().render(await bos.workshop.status(), flags.json ? "json" : "text");

package/src/commands/status/help.md

@@ -1,6 +0,0 @@
-# status
-
-`bos status` draws the workshop tree: **ok**, **missing** (mandatory but
-absent) or **not yet** (appears with use). Read-only.
-
-In `bos repl`, `status` also offers to create what is missing.

package/src/commands/status/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/status",
-  "info": "workshop tree and what is missing (read-only)",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs",
-  "repl": "./repl.mjs"
-}

package/src/commands/status/repl.mjs

@@ -1,14 +0,0 @@
-// status, then offer to create what is missing
-import { paint } from "../../views/terminal/paint.mjs";
-
-const missing = (node) => [...(!node.exists && node.mandatory ? [node.path] : []), ...node.children.flatMap(missing)];
-
-export default async ({ bos, io }) => {
-  const context = await bos.workshop.status();
-  console.log(new bos.views.StatusView().text(context));
-  const absent = missing(context.tree);
-  if (!absent.length) return paint.green("\nnothing missing");
-  const answer = await io.question(`\n${absent.length} missing: create them now? [y/N] `);
-  if (!/^y(es)?$/i.test(answer.trim())) return paint.dim("left as it is");
-  return new bos.views.StatusView().text(await bos.workshop.bootstrap());
-};

package/src/commands/verify/exec.mjs

@@ -1,9 +0,0 @@
-import { resolve } from "node:path";
-
-import { BOS } from "../../main.ts";
-
-export default ({ operands: [dir = "."] }) => {
-  const result = new BOS.Model(resolve(dir)).verify();
-  if (!result.ok) process.exitCode = 1;
-  return result;
-};

package/src/commands/verify/help.md

@@ -1,4 +0,0 @@
-# verify
-
-`bos verify <dir>` compares `<dir>` with its manifest and lists missing,
-changed and unlisted files. Exits with 1 when something is missing or changed.

package/src/commands/verify/index.json

@@ -1,7 +0,0 @@
-{
-  "path": "/verify",
-  "info": "compare a directory with its manifest",
-  "mode": "conform",
-  "help": ["./help.md", "MD"],
-  "inline": "./exec.mjs"
-}

package/src/controllers/_index.mjs

@@ -1,5 +0,0 @@
-// Every controller: simplified management built from procedures.
-import SkillsControll from "./skills-controll.mjs";
-import WorkshopControll from "./workshop-controll.mjs";
-
-export default { WorkshopControll, SkillsControll };

package/src/controllers/skills-controll.mjs

@@ -1,13 +0,0 @@
-// Agent skills of this repository, one per model.
-import { BOS } from "../main.ts";
-import procedures from "../procedures/_index.mjs";
-
-export class SkillsControll extends BOS.Controll {
-  static flows = procedures;
-
-  scaffold(options) {
-    return this.run("skilling", options);
-  }
-}
-
-export default SkillsControll;

package/src/controllers/workshop-controll.mjs

@@ -1,48 +0,0 @@
-// The workshop as a handful of plain methods; each one runs a procedure.
-//   const workshop = new WorkshopControll({ workshop: "/tmp/x/__WORKSHOP" });
-//   await workshop.open();
-import { BOS } from "../main.ts";
-import procedures from "../procedures/_index.mjs";
-
-export class WorkshopControll extends BOS.Controll {
-  static flows = procedures;
-
-  locate() {
-    return this.run("locating");
-  }
-  status() {
-    return this.run("inspecting");
-  }
-  bootstrap(options) {
-    return this.run("bootstrapping", options);
-  }
-  open(options) {
-    return this.run("opening", options);
-  }
-  close(options) {
-    return this.run("closing", options);
-  }
-  sink() {
-    return this.run("sinking");
-  }
-  hook(hook) {
-    return this.run("hooking", { hook });
-  }
-  installHooks() {
-    return this.run("installingHooks");
-  }
-  gather(options) {
-    return this.run("gathering", options);
-  }
-  describe(options) {
-    return this.run("describing", options);
-  }
-  mode(mode) {
-    return this.run("modeSwitching", { mode });
-  }
-  promote({ reject = false, apply = false } = {}) {
-    return this.run("promoting", { reject, dryRun: !apply });
-  }
-}
-
-export default WorkshopControll;

package/src/core/basic-bridge.mjs

@@ -1,29 +0,0 @@
-// A bridge shapes one outside system (docker host, github, git, a subprocess…)
-// into a few plain methods. The SDK client is created lazily, on first use.
-
-export class BasicBridge {
-  static id = "bridge";
-
-  constructor(options = {}) {
-    this.options = options;
-  }
-
-  get client() {
-    this._client ??= this.connect();
-    return this._client;
-  }
-
-  // create the SDK client (dockerode, octokit, …); null when the bridge needs none
-  connect() {
-    return null;
-  }
-
-  // can this bridge be used on this machine right now?
-  async available() {
-    return true;
-  }
-
-  toString() {
-    return `[<BOS.Bridge::${this.constructor.id}>]`;
-  }
-}

package/src/core/basic-controll.mjs

@@ -1,26 +0,0 @@
-// A controll owns a set of logicflows and runs them with a prepared context.
-import { EventEmitter } from "node:events";
-
-export class BasicControll extends EventEmitter {
-  static flows = {};
-
-  constructor(options = {}) {
-    super();
-    this.options = options;
-  }
-
-  get flowNames() {
-    return Object.keys(this.constructor.flows);
-  }
-
-  async run(flowName, options = {}) {
-    const flow = this.constructor.flows[flowName];
-    if (!flow) throw new Error(`unknown logicflow "${flowName}" (known: ${this.flowNames.join(", ")})`);
-    const merged = { ...this.options, ...options };
-    const context = { options: merged, dryRun: Boolean(merged.dryRun), changes: [], trace: [] };
-    this.emit("start", flowName, context);
-    await flow.run(context);
-    this.emit("done", flowName, context);
-    return context;
-  }
-}