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

package/src/procedures/describing/compose-message.mjs

@@ -1,25 +0,0 @@
-// A conventional-commit draft from the staged changes alone: deterministic, no guessing beyond paths.
-import { scopeOf, targetOf } from "./scopes.mjs";
-
-const ONLY = { docs: "docs", tests: "test", ci: "ci", build: "build" };
-const MARK = { added: "A", modified: "M", deleted: "D" };
-
-export function composeMessage(staged) {
-  if (!staged.length) return null;
-  const scopes = [...new Set(staged.map(([path]) => scopeOf(path)))];
-  const states = new Set(staged.map(([, state]) => state));
-  const addsCode = staged.some(([path, state]) => state === "added" && path.startsWith("src/"));
-  const type = scopes.length === 1 && ONLY[scopes[0]] ? ONLY[scopes[0]] : addsCode ? "feat" : "chore";
-  const scope = scopes.length <= 2 ? `(${scopes.join(",")})` : "";
-  const verb = states.size === 1 ? { added: "add", deleted: "remove", modified: "update" }[[...states][0]] : "update";
-  const targets = [...new Set(staged.map(([path]) => targetOf(path)))];
-  const named = targets.slice(0, 3).join(", ") + (targets.length > 3 ? ` +${targets.length - 3} more` : "");
-  const header = `${type}${scope}: ${verb} ${named}`.slice(0, 100);
-  const body = staged.slice(0, 40).map(([path, state]) => `${MARK[state]} ${path}`);
-  if (staged.length > 40) body.push(`… ${staged.length - 40} more files`);
-  return `${header}\n\n${body.join("\n")}\n`;
-}
-
-export const composeDraft = (context) => {
-  context.message = composeMessage(context.staged);
-};

package/src/procedures/describing/read-staged.mjs

@@ -1,7 +0,0 @@
-import GitClient from "../../bridge/git-client/_index.mjs";
-
-export const readStaged = async (context) => {
-  const git = new GitClient();
-  context.repo = (await git.root(context.options.cwd ?? process.cwd())) ?? process.cwd();
-  context.staged = await git.staged(context.repo);
-};

package/src/procedures/describing/scopes.mjs

@@ -1,38 +0,0 @@
-// Which part of the project a path belongs to: the scope of a conventional commit.
-const BUILD = new Set([
-  "package.json",
-  "package-lock.json",
-  "Taskfile.yml",
-  "vitest.config.mjs",
-  "commitlint.config.mjs",
-  "release.config.mjs",
-  "biome.json",
-  "Dockerfile",
-  "compose.yaml",
-  ".dockerignore",
-  "mkdocs.yml",
-  ".readthedocs.yaml",
-  ".gitignore",
-]);
-
-export function scopeOf(path) {
-  const [top, part] = path.split("/");
-  if (top === "src") return ["main.ts", "cli.mjs", "index.mjs"].includes(part) ? "core" : part;
-  if (top === "tests") return "tests";
-  if (top === "docs") return "docs";
-  if (top === ".github") return "ci";
-  if (top === "resources") return "resources";
-  if (["skills", "template", ".claude-plugin"].includes(top)) return "skills";
-  if (top === ".husky" || BUILD.has(path)) return "build";
-  return "repo";
-}
-
-// the thing a path is about: src/procedures/closing/x.mjs → closing; docs/glossary/mode.md → mode
-export function targetOf(path) {
-  const parts = path.split("/");
-  const base = parts.at(-1).replace(/\.[^.]+$/, "");
-  if (parts[0] === "src" && parts.length > 3) return parts[2];
-  return ["_index", "index", "class", "README", "exec", "help"].includes(base) && parts.length > 1
-    ? parts.at(-2)
-    : base;
-}

package/src/procedures/describing/staged-diff.mjs

@@ -1,25 +0,0 @@
-// What Skryba reads: the stat of the staged changes, and a trimmed diff
-// (lock files skipped, each file and the whole capped) so it fits a small model.
-import SubprocessRunner from "../../bridge/subprocess-runner/_index.mjs";
-
-const SKIP = /(^|\/)(package-lock\.json|uv\.lock|yarn\.lock|pnpm-lock\.yaml)$/;
-
-export function stagedDiff(repo, { perFile = 1500, total = 8000 } = {}) {
-  const git = new SubprocessRunner();
-  const stat = git.try("git", ["diff", "--cached", "--stat"], { cwd: repo }) ?? "";
-  const diff = git.try("git", ["diff", "--cached", "-U2", "--no-color"], { cwd: repo }) ?? "";
-  let budget = total;
-  const parts = diff
-    .split(/^(?=diff --git )/m)
-    .filter((part) => {
-      const path = part.match(/^diff --git a\/(\S+)/)?.[1] ?? "";
-      return path && !SKIP.test(path);
-    })
-    .map((part) => {
-      const cut = part.slice(0, Math.max(0, Math.min(perFile, budget)));
-      budget -= cut.length;
-      return cut.length < part.length ? `${cut}\n… (trimmed)\n` : cut;
-    })
-    .filter(Boolean);
-  return { stat, diff: parts.join("") };
-}

package/src/procedures/describing/write-message.mjs

@@ -1,15 +0,0 @@
-import { readFileSync, writeFileSync } from "node:fs";
-
-// prepare-commit-msg: fill the editor only for a plain `git commit`, never over a
-// message given with -m, a merge, a squash or an amend
-const KEEP = new Set(["message", "merge", "squash", "commit"]);
-
-export const writeMessage = (context) => {
-  const { file, source } = context.options;
-  if (!file || !context.message || KEEP.has(source)) return;
-  const current = readFileSync(file, "utf8");
-  if (current.split("\n").some((line) => line.trim() && !line.startsWith("#"))) return;
-  const hint = "# drafted by BOS from the staged changes: edit the type, scope and subject freely\n";
-  if (!context.dryRun) writeFileSync(file, context.message + hint + current);
-  context.written = file;
-};

package/src/procedures/gathering/DESCRIPTION.md

@@ -1,13 +0,0 @@
-# Gathering Protocol
-
-Part of PROVISION. Shows the House of Anubis as it is, along three axes:
-
-- **children**: the adopted, named residents of `resources/house/children/`,
-  with their state (active, resting, frozen) and presence
-- **orders**: groups with a duty, such as RavensArmy (`resources/house/orders/`),
-  with local units (ravens) and remote ones
-- **bloodlines**: every served model grouped by releaser, found by following
-  its `parent_model` back to the root (`resources/house/bloodlines.json`)
-
-Only the list of models is read from ollama; no model is started or prompted,
-so resting residents are never disturbed.

package/src/procedures/gathering/_index.mjs

@@ -1,13 +0,0 @@
-import { BOS } from "../../main.ts";
-import { listServed } from "./list-served.mjs";
-import { mergeResidents } from "./merge-residents.mjs";
-import { readRegistry } from "./read-registry.mjs";
-
-export const gathering = new BOS.Procedure("gathering", [], {
-  description: "the House of Anubis: registry merged with what ollama serves",
-})
-  .step("read the House registry", readRegistry)
-  .step("list served models", listServed)
-  .step("merge residents", mergeResidents);
-
-export default gathering;

package/src/procedures/gathering/list-served.mjs

@@ -1,9 +0,0 @@
-import OllamaLink from "../../bridge/ollama-link/_index.mjs";
-
-// what ollama serves right now (names, architectures, parents); listing starts no model.
-// null when ollama is unreachable
-export const listServed = async (context) => {
-  const ollama = context.options.ollama ?? new OllamaLink();
-  const catalog = await ollama.catalog();
-  context.catalog = catalog.length ? catalog : null;
-};

package/src/procedures/gathering/merge-residents.mjs

@@ -1,31 +0,0 @@
-import { groupOf, sameModel } from "../../models/house/groups.mjs";
-
-// children and orders with presence, bloodline of each served model, and bloodlines grouped by releaser
-export const mergeResidents = (context) => {
-  const catalog = context.catalog ?? [];
-  const served = catalog.map((entry) => entry.name);
-  const present = (model) => (context.catalog ? served.some((name) => sameModel(name, model)) : null);
-  const withPresence = (group) => {
-    const claimed = served
-      .filter((model) => groupOf([group], model) && !group.members.some((m) => m.model && sameModel(m.model, model)))
-      .map((model) => ({ model, kind: "local" }));
-    const members = [...group.members, ...claimed].map((member) => ({
-      ...member,
-      state: member.state ?? group.state,
-      present: member.kind === "remote" ? null : present(member.model),
-      bloodline: member.model && context.catalog ? context.house.bloodlineOf(catalog, member.model) : null,
-    }));
-    return { ...group, members };
-  };
-  context.children = context.children.map(withPresence);
-  context.orders = context.orders.map(withPresence);
-  const lines = {};
-  for (const model of served) {
-    const { releaser } = context.house.bloodlineOf(catalog, model);
-    lines[releaser] ??= [];
-    lines[releaser].push(model);
-  }
-  context.bloodlines = Object.entries(lines)
-    .map(([releaser, models]) => ({ releaser, models }))
-    .sort((a, b) => b.models.length - a.models.length);
-};

package/src/procedures/gathering/read-registry.mjs

@@ -1,7 +0,0 @@
-import House from "../../models/house/class.mjs";
-
-export const readRegistry = (context) => {
-  context.house = new House(context.options.housePath);
-  context.children = context.house.children();
-  context.orders = context.house.orders();
-};

package/src/procedures/hooking/DESCRIPTION.md

@@ -1,6 +0,0 @@
-# Hooking Protocol
-
-Git hooks of any repository inside the workshop report to storylines: the
-commit, branch or merge, and where the repository sits
-(`forge / <scope> / <project>`). `bos hooks install` links a repository's
-`post-commit`, `post-checkout` and `post-merge` to `bos hook <name>`.

package/src/procedures/hooking/_index.mjs

@@ -1,12 +0,0 @@
-import { BOS } from "../../main.ts";
-import loading from "../loading/_index.mjs";
-import locating from "../locating/_index.mjs";
-import { installHooks } from "./install-hooks.mjs";
-import { recordHook } from "./record-hook.mjs";
-
-export const hooking = loading.chain(new BOS.Procedure("hooking").step("record hook", recordHook), "hooking");
-export const installingHooks = locating.chain(
-  new BOS.Procedure("installing-hooks").step("link hooks", installHooks),
-  "installing-hooks",
-);
-export default hooking;

package/src/procedures/hooking/hooks.mjs

@@ -1,10 +0,0 @@
-// what each git hook adds to its storyline entry
-import GitClient from "../../bridge/git-client/_index.mjs";
-
-const git = new GitClient();
-
-export const HOOKS = {
-  "post-commit": async (repo) => ({ commit: (await git.log(repo, 1))[0] ?? null }),
-  "post-checkout": async (repo) => ({ branch: await git.branch(repo) }),
-  "post-merge": async (repo) => ({ head: (await git.log(repo, 1))[0]?.oid ?? null }),
-};

package/src/procedures/hooking/install-hooks.mjs

@@ -1,34 +0,0 @@
-import { chmodSync, existsSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-import GitClient from "../../bridge/git-client/_index.mjs";
-import { createIfMissing } from "../../core/basic-element.mjs";
-import { CLI } from "../../core/self.mjs";
-import { HOOKS } from "./hooks.mjs";
-
-// link a repository's hooks to `bos hook <name>`; someone's own hook is left alone
-export const installHooks = async (context) => {
-  const git = new GitClient();
-  const root = await git.root(context.env.cwd);
-  if (!root) throw new Error("not inside a git repository");
-  context.skipped = [];
-  // hooks managed elsewhere (e.g. husky sets core.hooksPath): those hooks should call `bos hook <name>` themselves
-  const managed = await git.hooksPath(root);
-  if (managed) {
-    context.managedBy = managed;
-    context.skipped.push(`all: core.hooksPath is ${managed}`);
-    return;
-  }
-  for (const hook of Object.keys(HOOKS)) {
-    const target = join(root, ".git", "hooks", hook);
-    if (existsSync(target)) context.skipped.push(target);
-    createIfMissing(
-      target,
-      () => {
-        writeFileSync(target, `#!/bin/sh\nexec node "${CLI}" hook ${hook} "$@"\n`);
-        chmodSync(target, 0o755);
-      },
-      context,
-    );
-  }
-};

package/src/procedures/hooking/record-hook.mjs

@@ -1,13 +0,0 @@
-import GitClient from "../../bridge/git-client/_index.mjs";
-import { HOOKS } from "./hooks.mjs";
-
-export const recordHook = async (context) => {
-  const hook = context.options.hook;
-  if (!(hook in HOOKS)) throw new Error(`unhandled hook "${hook}" (known: ${Object.keys(HOOKS).join(", ")})`);
-  const repo = (await new GitClient().root(context.env.cwd)) ?? context.env.cwd;
-  const storylines = context.workshop.storylines.ensure(context);
-  context.event = storylines.record(
-    { event: "git-hook", hook, repo, place: context.workshop.placeOf(repo), ...(await HOOKS[hook](repo)) },
-    context,
-  );
-};

package/src/procedures/inspecting/DESCRIPTION.md

@@ -1,3 +0,0 @@
-# Inspecting Protocol
-
-Read-only: the state of every area (exists, missing, or not yet: appears with use). Creates nothing.

package/src/procedures/inspecting/_index.mjs

@@ -1,9 +0,0 @@
-import { BOS } from "../../main.ts";
-import loading from "../loading/_index.mjs";
-
-const own = new BOS.Procedure("inspecting").step("inspect tree", (context) => {
-  context.tree = context.workshop.inspect();
-});
-
-export const inspecting = loading.chain(own, "inspecting");
-export default inspecting;

package/src/procedures/loading/DESCRIPTION.md

@@ -1,4 +0,0 @@
-# Loading Protocol
-
-After locating: loads `resources/workshop.default.json` overridden by
-`.BOS/workshop.json`, and rejects an unknown host role or mode.

package/src/procedures/loading/_index.mjs

@@ -1,15 +0,0 @@
-import { BOS } from "../../main.ts";
-import locating from "../locating/_index.mjs";
-import { loadConfig } from "./load-config.mjs";
-import { validateMode } from "./validate-mode.mjs";
-import { validateRole } from "./validate-role.mjs";
-
-const own = new BOS.Procedure("loading", [], {
-  description: "load workshop.json over the defaults and validate role and mode",
-})
-  .step("load workshop config", loadConfig)
-  .step("validate host role", validateRole)
-  .step("validate mode", validateMode);
-
-export const loading = locating.chain(own, "loading");
-export default loading;

package/src/procedures/loading/load-config.mjs

@@ -1,16 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-
-import { RESOURCES } from "../../core/self.mjs";
-import Workshop from "../../models/workshop/class.mjs";
-
-// resources defaults, overridden by .BOS/workshop.json; a null there means "not set", so the default applies
-export const loadConfig = (context) => {
-  const defaults = JSON.parse(readFileSync(join(RESOURCES, "workshop.default.json"), "utf8"));
-  context.workshop = new Workshop(context.workshopRoot);
-  const own = Object.fromEntries(
-    Object.entries(context.workshop.system.readJSON("workshop.json", {})).filter(([, value]) => value !== null),
-  );
-  context.config = { ...defaults, ...own };
-  context.defaulted = Object.keys(defaults).filter((key) => !(key in own) && defaults[key] !== null);
-};

package/src/procedures/loading/validate-mode.mjs

@@ -1,8 +0,0 @@
-import { MODES } from "../../models/workshop/modes.mjs";
-
-export const validateMode = (context) => {
-  const { mode } = context.config;
-  if (mode && !(mode in MODES)) {
-    throw new Error(`unknown mode "${mode}" in workshop.json (known: ${Object.keys(MODES).join(", ")})`);
-  }
-};

package/src/procedures/loading/validate-role.mjs

@@ -1,8 +0,0 @@
-import { HOST_ROLES } from "../../models/workshop/host-roles.mjs";
-
-export const validateRole = (context) => {
-  const { role } = context.config;
-  if (role && !(role in HOST_ROLES)) {
-    throw new Error(`unknown host role "${role}" in workshop.json (known: ${Object.keys(HOST_ROLES).join(", ")})`);
-  }
-};

package/src/procedures/locating/DESCRIPTION.md

@@ -1,6 +0,0 @@
-# Locating Protocol
-
-Reads who, where and when (host, user, home, cwd, unixusat), then finds the
-active workshop. The first rule that answers wins: `--workshop`,
-`$BOS_WORKSHOP`, the nearest parent `__WORKSHOP`, the workshop BOS is installed
-in, `~/__WORKSHOP`. Finally it finds where BOS itself sits. Every other protocol starts here.

package/src/procedures/locating/_index.mjs

@@ -1,13 +0,0 @@
-import { BOS } from "../../main.ts";
-import { locateSelf } from "./locate-self.mjs";
-import { locateWorkshop } from "./locate-workshop.mjs";
-import { readEnvironment } from "./read-environment.mjs";
-
-export const locating = new BOS.Procedure("locating", [], {
-  description: "read the machine, find the active workshop and BOS itself",
-})
-  .step("read environment", readEnvironment)
-  .step("locate workshop", locateWorkshop)
-  .step("locate self", locateSelf);
-
-export default locating;

package/src/procedures/locating/locate-self.mjs

@@ -1,7 +0,0 @@
-import { CLI, REPO_ROOT, VERSION } from "../../core/self.mjs";
-import { placeOf } from "../../models/workshop/locate.mjs";
-
-// BOS is a project like any other: where does it sit in the workshop?
-export const locateSelf = (context) => {
-  context.self = { root: REPO_ROOT, cli: CLI, version: VERSION, place: placeOf(REPO_ROOT, context.workshopRoot) };
-};

package/src/procedures/locating/locate-workshop.mjs

@@ -1,16 +0,0 @@
-import { REPO_ROOT } from "../../core/self.mjs";
-import { listWorkshops, resolveWorkshop } from "../../models/workshop/locate.mjs";
-
-export const locateWorkshop = (context) => {
-  const { root, source } = resolveWorkshop({
-    explicit: context.options?.workshop,
-    variable: process.env.BOS_WORKSHOP,
-    cwd: context.env.cwd,
-    self: REPO_ROOT,
-    home: context.env.home,
-  });
-  context.workshopRoot = root;
-  context.workshopSource = source;
-  context.workshops = listWorkshops(context.env.home);
-  if (!context.workshops.includes(root)) context.workshops.unshift(root);
-};

package/src/procedures/locating/read-environment.mjs

@@ -1,12 +0,0 @@
-import { homedir, hostname, userInfo } from "node:os";
-
-export const readEnvironment = (context) => {
-  context.env = {
-    host: hostname(),
-    user: userInfo().username,
-    home: homedir(),
-    cwd: process.cwd(),
-    platform: process.platform,
-    unixusat: Date.now(), // unix timestamp in milliseconds
-  };
-};

package/src/procedures/mode-switching/DESCRIPTION.md

@@ -1,7 +0,0 @@
-# Mode Switching Protocol
-
-Part of COMMANDORATE. Sets the mode of work of this workshop in
-`.BOS/workshop.json` (`"mode"`) and records the switch in storylines
-(`{"event":"mode","from":…,"to":…}`). Accepts a name or its digit:
-1 almanac, 2 conform, 3 smeltry, 4 commandorate, 5 provision.
-The workshop is bootstrapped first, so `.BOS/` exists to hold the choice.

package/src/procedures/mode-switching/_index.mjs

@@ -1,10 +0,0 @@
-import { BOS } from "../../main.ts";
-import bootstrapping from "../bootstrapping/_index.mjs";
-import { recordMode } from "./record-mode.mjs";
-import { switchMode } from "./switch-mode.mjs";
-
-const own = new BOS.Procedure("mode-switching").step("switch mode", switchMode).step("record mode", recordMode);
-
-// the workshop must be whole before it can change its mode
-export const modeSwitching = bootstrapping.chain(own, "mode-switching");
-export default modeSwitching;

package/src/procedures/mode-switching/record-mode.mjs

@@ -1,8 +0,0 @@
-export const recordMode = (context) => {
-  if (context.previousMode === context.config.mode) return;
-  const storylines = context.workshop.storylines.ensure(context);
-  context.event = storylines.record(
-    { event: "mode", from: context.previousMode, to: context.config.mode, user: context.env.user },
-    context,
-  );
-};

package/src/procedures/mode-switching/switch-mode.mjs

@@ -1,16 +0,0 @@
-import { MODES, modeByDigit } from "../../models/workshop/modes.mjs";
-
-// accepts a name (smeltry) or its digit (3)
-export const switchMode = (context) => {
-  const asked = String(context.options.mode ?? "").toLowerCase();
-  const mode = asked in MODES ? asked : modeByDigit(asked);
-  if (!mode)
-    throw new Error(
-      `unknown mode "${asked}" (known: ${Object.entries(MODES)
-        .map(([name, m]) => `${m.digit} ${name}`)
-        .join(", ")})`,
-    );
-  context.previousMode = context.config.mode ?? null;
-  context.config = context.workshop.system.update({ mode }, context);
-  context.config.mode = mode;
-};

package/src/procedures/opening/DESCRIPTION.md

@@ -1,6 +0,0 @@
-# Opening Protocol
-
-related to all models - requires stuff to be closed first, it is being done after bootup
-
-Steps: locating → loading → bootstrapping → record the opening in
-`.BOS/storylines/logs/workshop.jsonl`.

package/src/procedures/opening/_index.mjs

@@ -1,8 +0,0 @@
-import { BOS } from "../../main.ts";
-import bootstrapping from "../bootstrapping/_index.mjs";
-import { recordOpening } from "./record-opening.mjs";
-
-const own = new BOS.Procedure("opening").step("record opening", recordOpening);
-
-export const opening = bootstrapping.chain(own, "opening");
-export default opening;

package/src/procedures/opening/record-opening.mjs

@@ -1,4 +0,0 @@
-export const recordOpening = (context) => {
-  const storylines = context.workshop.storylines.ensure(context);
-  context.event = storylines.record({ event: "open", user: context.env.user, from: context.workshopSource }, context);
-};

package/src/procedures/promoting/DESCRIPTION.md

@@ -1,8 +0,0 @@
-# Promoting Protocol
-
-Moves the current branch one station along the flow
-(`docs/infographics/branch-movement-procedures.md`):
-master → developement → revision → testing → releasing → master.
-With `--reject`, sends work back to developement. It is a dry run unless
-applied. Merges are made locally with isomorphic-git (a merge commit, like
-`--no-ff`). releasing → master opens a GitHub pull request instead.

package/src/procedures/promoting/_index.mjs

@@ -1,14 +0,0 @@
-import { BOS } from "../../main.ts";
-import { apply } from "./apply.mjs";
-import { plan } from "./plan.mjs";
-import { readPosition } from "./read-position.mjs";
-
-export const promoting = new BOS.Procedure("promoting", [], {
-  description: "move work one station along the branch flow",
-})
-  .step("read position", readPosition)
-  .step("plan", plan)
-  .step("apply", apply);
-
-export * from "./branch-flow.mjs";
-export default promoting;

package/src/procedures/promoting/apply.mjs

@@ -1,28 +0,0 @@
-import fs from "node:fs";
-
-import git from "isomorphic-git";
-
-import GitClient from "../../bridge/git-client/_index.mjs";
-import GithubApi from "../../bridge/github-api/_index.mjs";
-
-// owner/repo from a github remote url (https or ssh)
-async function githubRepo(dir) {
-  const url = (await git.getConfig({ fs, dir, path: "remote.origin.url" })) ?? "";
-  const match = url.match(/github\.com[:/]([^/]+)\/(.+?)(\.git)?$/);
-  if (!match) throw new Error(`origin is not a GitHub repository: ${url || "no origin"}`);
-  return { owner: match[1], repo: match[2] };
-}
-
-export const apply = async (context) => {
-  if (context.dryRun) return;
-  const { from, to, repo } = context;
-  if (context.pullRequest) {
-    context.result = await new GithubApi().pullRequest({ ...(await githubRepo(repo)), head: from, base: to });
-    return;
-  }
-  const client = new GitClient();
-  const changes = await client.changes(repo);
-  if (changes.length) throw new Error(`${changes.length} uncommitted changes in ${repo}: commit them before promoting`);
-  if (!(await client.hasBranch(repo, to))) await client.createBranch(repo, to, from);
-  context.result = await client.merge(repo, from, to);
-};

package/src/procedures/promoting/branch-flow.mjs

@@ -1,23 +0,0 @@
-// docs/infographics/branch-movement-procedures.md as data:
-// master → developement → revision → testing → releasing → master (pull request);
-// a rejection at revision, testing or releasing goes back to developement.
-export const CANON = "master";
-
-export const BRANCHES = {
-  master: "spine of canon: stable state shared with production",
-  developement: "further changing: here we code",
-  revision: "control of code: approval by a maintainer",
-  testing: "quality assurance: tests, nightly builds",
-  releasing: "stamping, publishing and announcing",
-};
-
-export const PROMOTION = {
-  master: "developement",
-  developement: "revision",
-  revision: "testing",
-  testing: "releasing",
-  releasing: CANON,
-};
-export const REJECTION = { revision: "developement", testing: "developement", releasing: "developement" };
-
-export const needsPullRequest = (from, to) => from === "releasing" && to === CANON;

package/src/procedures/promoting/plan.mjs

@@ -1,14 +0,0 @@
-import GitClient from "../../bridge/git-client/_index.mjs";
-import { needsPullRequest } from "./branch-flow.mjs";
-
-export const plan = async (context) => {
-  const { from, to, repo } = context;
-  context.pullRequest = needsPullRequest(from, to);
-  context.plan = context.pullRequest
-    ? [`pull request ${from} → ${to} on GitHub`]
-    : [
-        ...((await new GitClient().hasBranch(repo, to)) ? [] : [`create branch ${to} from ${from}`]),
-        `merge ${from} into ${to} (merge commit "${from} → ${to}")`,
-        `leave ${to} checked out`,
-      ];
-};

package/src/procedures/promoting/read-position.mjs

@@ -1,15 +0,0 @@
-import GitClient from "../../bridge/git-client/_index.mjs";
-import { PROMOTION, REJECTION } from "./branch-flow.mjs";
-
-export const readPosition = async (context) => {
-  const git = new GitClient();
-  context.repo = (await git.root(context.options.cwd ?? process.cwd())) ?? process.cwd();
-  context.from = context.options.from ?? (await git.branch(context.repo));
-  const table = context.options.reject ? REJECTION : PROMOTION;
-  context.to = table[context.from];
-  if (!context.to) {
-    throw new Error(
-      `"${context.from}" has no ${context.options.reject ? "rejection" : "promotion"} target (flow: ${Object.keys(table).join(", ")})`,
-    );
-  }
-};

package/src/procedures/sinking/DESCRIPTION.md

@@ -1,8 +0,0 @@
-# Sinking Protocol
-
-Moment when it is important to suddenly abandon current workstation that can be compromised, collect all results of work progress on projects, secure them on dedicated to this purpose huge hard drive and reinstall operating system of currently used machine. this is procedure of ASAP matter to ensure safety and security against threat of being compromised. If it is possible to migrate workspace setups for new environment customizing without danger of contamination it is worth to list all available toolsets and programs by for example extraction of terminal history stories
-
-Implemented so far (read-only): an inventory of every forge project, with its
-branch and uncommitted changes, plus the ttystories that reveal which tools
-were used. Securing results onto the rescue drive and reinstalling the system:
-[`TODO`]

package/src/procedures/sinking/_index.mjs

@@ -1,12 +0,0 @@
-import { BOS } from "../../main.ts";
-import loading from "../loading/_index.mjs";
-import { inventoryForge } from "./inventory-forge.mjs";
-import { inventoryTools } from "./inventory-tools.mjs";
-
-// first, read-only part of sinking: know what has to be rescued
-const own = new BOS.Procedure("sinking")
-  .step("inventory forge", inventoryForge)
-  .step("inventory tools", inventoryTools);
-
-export const sinking = loading.chain(own, "sinking");
-export default sinking;