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

package/src/main.ts

@@ -1,82 +0,0 @@
-// The spine of BOS: one class that binds the core mechanics together and
-// lazily loads the parts. Core classes hang on it as BOS.Bridge, BOS.Model,
-// BOS.Submodule…,
-// so every part extends them through this one import:
-//   import { BOS } from "../main.ts";  class DockerHost extends BOS.Bridge {}
-import { EventEmitter } from "node:events";
-
-import { BasicBridge } from "./core/basic-bridge.mjs";
-import { BasicControll } from "./core/basic-controll.mjs";
-import { BasicModel } from "./core/basic-model.mjs";
-import { BasicProcedure } from "./core/basic-procedure.mjs";
-import { BasicSubmodule } from "./core/basic-submodule.mjs";
-import { BasicView } from "./core/basic-view.mjs";
-
-type Options = { workshop?: string; dryRun?: boolean; [key: string]: unknown };
-// parts are loaded at runtime (bos.load()) and differ per part, so their registries stay open
-// biome-ignore lint/suspicious/noExplicitAny: dynamic registries of classes and functions
-type Registry = Record<string, any>;
-
-export class BOS extends EventEmitter {
-  static Bridge = BasicBridge;
-  static Controll = BasicControll;
-  static Model = BasicModel;
-  static Procedure = BasicProcedure;
-  static Submodule = BasicSubmodule;
-  static View = BasicView;
-
-  options: Options;
-  bridges: Registry = {};
-  models: Registry = {};
-  procedures: Registry = {};
-  controllers: Registry = {};
-  commands: Registry = {};
-  views: Registry = {};
-
-  constructor(options: Options = {}) {
-    super();
-    this.options = options;
-  }
-
-  // parts import this file, so they are loaded here on demand, never at import time
-  async load(): Promise<this> {
-    const [bridges, models, procedures, controllers, commands, views] = await Promise.all([
-      import("./bridge/_index.mjs"),
-      import("./models/_index.mjs"),
-      import("./procedures/_index.mjs"),
-      import("./controllers/_index.mjs"),
-      import("./commands/_index.mjs"),
-      import("./views/_index.mjs"),
-    ]);
-    this.bridges = bridges.default;
-    this.models = models.default;
-    this.procedures = procedures.default;
-    this.controllers = controllers.default;
-    this.views = views.default;
-    this.commands = await commands.loadCommands();
-    this.emit("loaded", this);
-    return this;
-  }
-
-  // the workshop as one easy handle: bos.workshop.status(), .open(), .close()…
-  get workshop() {
-    return new this.controllers.WorkshopControll(this.options);
-  }
-
-  // the agent skills of this repository: bos.skills.scaffold()
-  get skills() {
-    return new this.controllers.SkillsControll(this.options);
-  }
-
-  async command(name: string, operands: string[] = [], flags: Options = {}) {
-    const command = this.commands[name];
-    if (!command) throw new Error(`unknown command "${name}" (known: ${Object.keys(this.commands).join(", ")})`);
-    return command.inline({ bos: this, operands, flags: { ...this.options, ...flags } });
-  }
-
-  toString() {
-    return `[<Blacksmith_Organization_System::${this.constructor.name}>]`;
-  }
-}
-
-export default BOS;

package/src/mcp.mjs

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-// bos-mcp: BOS as an MCP server over stdio (Claude Code loads it from .claude-plugin/mcp.json).
-// stdout belongs to the protocol: nothing else may print there.
-import { BOS } from "./main.ts";
-import { startMcpServer } from "./views/mcp/_index.mjs";
-
-const bos = await new BOS({ workshop: process.env.BOS_WORKSHOP }).load();
-await startMcpServer(bos);

package/src/models/_index.mjs

@@ -1,43 +0,0 @@
-// Models: assets of the working environment that stand on their own, one directory each.
-// Submodules: organs that exist only inside their owner (models/<owner>/hang.<name>.mjs).
-import Archive from "./archive/class.mjs";
-import Craftbook from "./craftbook/class.mjs";
-import Scrapnotes from "./craftbook/hang.scrapnotes.mjs";
-import Craftset from "./craftset/class.mjs";
-import Devarmory from "./devarmory/class.mjs";
-import Exhibit from "./exhibit/class.mjs";
-import Forge from "./forge/class.mjs";
-import House from "./house/class.mjs";
-import Project from "./project/class.mjs";
-import Sarcophag from "./sarcophag/class.mjs";
-import Scope from "./scope/class.mjs";
-import Sheme from "./sheme/class.mjs";
-import Throwbox from "./throwbox/class.mjs";
-import Workshop from "./workshop/class.mjs";
-import Data from "./workshop/hang.data.mjs";
-import Nests from "./workshop/hang.nests.mjs";
-import Setup from "./workshop/hang.setup.mjs";
-import Storylines from "./workshop/hang.storylines.mjs";
-import System from "./workshop/hang.system.mjs";
-
-export { HOST_ROLES } from "./workshop/host-roles.mjs";
-export * from "./workshop/locate.mjs";
-export { MODES, modeByDigit } from "./workshop/modes.mjs";
-
-export const submodules = { System, Setup, Data, Nests, Storylines, Scrapnotes };
-
-export default {
-  Workshop,
-  Devarmory,
-  Forge,
-  Craftbook,
-  Archive,
-  Scope,
-  Project,
-  Sheme,
-  Throwbox,
-  Sarcophag,
-  Exhibit,
-  Craftset,
-  House,
-};

package/src/models/archive/class.mjs

@@ -1,9 +0,0 @@
-// work at rest: sarcophags, exhibits, mirrors (glossary: archive)
-import { BOS } from "../../main.ts";
-
-export class Archive extends BOS.Model {
-  static type = "archive";
-  static dirname = "archive";
-}
-
-export default Archive;

package/src/models/craftbook/class.mjs

@@ -1,11 +0,0 @@
-// Knowledge: scrapnotes, craftsets, collections, recipes (glossary: craftbook).
-import { BOS } from "../../main.ts";
-import Scrapnotes from "./hang.scrapnotes.mjs";
-
-export class Craftbook extends BOS.Model {
-  static type = "craftbook";
-  static dirname = "craftbook";
-  static submodules = { scrapnotes: Scrapnotes };
-}
-
-export default Craftbook;

package/src/models/craftbook/hang.scrapnotes.mjs

@@ -1,10 +0,0 @@
-// craftbook/scrapnotes: every note not yet promoted to a document (glossary: scrapnote).
-import { BOS } from "../../main.ts";
-
-export class Scrapnotes extends BOS.Submodule {
-  static type = "scrapnotes";
-  static ownerType = "craftbook";
-  static dirname = "scrapnotes";
-}
-
-export default Scrapnotes;

package/src/models/craftset/class.mjs

@@ -1,14 +0,0 @@
-// Reusable kit of notes, notebooks, scripts and session setup (glossary: craftset).
-import { BOS } from "../../main.ts";
-
-export class Craftset extends BOS.Model {
-  static type = "craftset";
-  static descriptors = {
-    ".omnis.toml": () => "# [TODO] contents of .omnis.toml are not defined yet\n",
-    "metadata.json": (element) => ({ name: element.name, created: Date.now() }),
-    "manifest.json": () => ({ files: {} }),
-    "Taskfile.yaml": () => "version: '3'\n\ntasks: {}\n",
-  };
-}
-
-export default Craftset;

package/src/models/devarmory/class.mjs

@@ -1,10 +0,0 @@
-// Tools, listed with checksums so missing or damaged ones can be found (glossary: devarmory).
-import { BOS } from "../../main.ts";
-
-export class Devarmory extends BOS.Model {
-  static type = "devarmory";
-  static dirname = "devarmory";
-  static descriptors = { "manifest.json": () => ({ tools: {}, files: {} }) }; // format still open
-}
-
-export default Devarmory;

package/src/models/exhibit/class.mjs

@@ -1,8 +0,0 @@
-// view built from sarcophags (glossary: exhibit)
-import { BOS } from "../../main.ts";
-
-export class Exhibit extends BOS.Model {
-  static type = "exhibit";
-}
-
-export default Exhibit;

package/src/models/forge/class.mjs

@@ -1,19 +0,0 @@
-// Active work, the desk: scopes of projects (glossary: forge).
-import { readdirSync } from "node:fs";
-
-import { BOS } from "../../main.ts";
-import Scope from "../scope/class.mjs";
-
-export class Forge extends BOS.Model {
-  static type = "forge";
-  static dirname = "forge";
-
-  scopes() {
-    if (!this.exists()) return [];
-    return readdirSync(this.path, { withFileTypes: true })
-      .filter((entry) => entry.isDirectory() && !entry.name.startsWith("."))
-      .map((entry) => new Scope(this.file(entry.name), this));
-  }
-}
-
-export default Forge;

package/src/models/house/bloodlines.mjs

@@ -1,27 +0,0 @@
-// Bloodline: follow a model's parent_model back to its root; the root names the releaser.
-import { existsSync, readFileSync } from "node:fs";
-
-import { sameModel } from "./groups.mjs";
-
-export function readReleasers(path) {
-  return existsSync(path) ? JSON.parse(readFileSync(path, "utf8")).releasers : [];
-}
-
-// catalog: [{ name, family, parent }] as ollama lists it; a parent that is a file path ends the chain
-export function rootOf(catalog, model) {
-  const seen = new Set();
-  let current = catalog.find((entry) => sameModel(entry.name, model));
-  while (current?.parent && !current.parent.startsWith("/") && !seen.has(current.name)) {
-    seen.add(current.name);
-    const parent = catalog.find((entry) => sameModel(entry.name, current.parent));
-    if (!parent) return { name: current.parent, family: current.family };
-    current = parent;
-  }
-  return current ? { name: current.name, family: current.family } : { name: model, family: null };
-}
-
-export function bloodlineOf(catalog, releasers, model) {
-  const root = rootOf(catalog, model);
-  const rule = releasers.find(({ match }) => root.name.toLowerCase().replace(/^.*\//, "").startsWith(match));
-  return { root: root.name, releaser: rule?.releaser ?? (root.family ? `${root.family} (architecture)` : "unknown") };
-}

package/src/models/house/class.mjs

@@ -1,53 +0,0 @@
-// The House of Anubis (resources/house/): bloodlines derived from what ollama serves,
-// children adopted by name, orders with duties. Every call to a resident asks here first.
-
-import { listRavens } from "../../bridge/ollama-link/ravens.mjs";
-import { RESOURCES } from "../../core/self.mjs";
-import { BOS } from "../../main.ts";
-import { bloodlineOf, readReleasers } from "./bloodlines.mjs";
-import { groupOf, readGroups, sameModel } from "./groups.mjs";
-
-export const STATES = ["active", "resting", "frozen"];
-
-export class House extends BOS.Model {
-  static type = "house";
-
-  constructor(path = `${RESOURCES}/house`, parent = null) {
-    super(path, parent);
-  }
-
-  children() {
-    return readGroups(this.file("children"));
-  }
-  orders() {
-    return readGroups(this.file("orders"), listRavens());
-  }
-  releasers() {
-    return readReleasers(this.file("bloodlines.json"));
-  }
-
-  bloodlineOf(catalog, model) {
-    return bloodlineOf(catalog, this.releasers(), model);
-  }
-
-  // a member's own state wins over its group's; a resident nobody adopted is active
-  stateOf(model) {
-    for (const group of [...this.children(), ...this.orders()]) {
-      if (groupOf([group], model)) {
-        const member = group.members.find((m) => m.model && sameModel(m.model, model));
-        return {
-          state: member?.state ?? group.state,
-          group: group.name,
-          reason: member?.reason ?? group.reason ?? null,
-        };
-      }
-    }
-    return { state: "active", group: null, reason: null };
-  }
-
-  mayCall(model) {
-    return this.stateOf(model).state === "active";
-  }
-}
-
-export default House;

package/src/models/house/groups.mjs

@@ -1,38 +0,0 @@
-// Children (adopted by name) and orders (duties): one JSON file per group,
-// with explicit members and/or name patterns that claim served models.
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { basename, join } from "node:path";
-
-// "tulu3:latest" and "tulu3" are the same resident
-export const sameModel = (a, b) =>
-  a?.replace(/:latest$/i, "").toLowerCase() === b?.replace(/:latest$/i, "").toLowerCase();
-
-export function readGroups(dir, ravens = []) {
-  if (!existsSync(dir)) return [];
-  return readdirSync(dir)
-    .filter((file) => file.endsWith(".json"))
-    .sort()
-    .map((file) => {
-      const group = {
-        name: basename(file, ".json"),
-        state: "active",
-        patterns: [],
-        members: [],
-        ...JSON.parse(readFileSync(join(dir, file), "utf8")),
-      };
-      const fromRavens = group.fromRavens
-        ? ravens.map((raven) => ({ name: raven.name, model: raven.model, duty: raven.duty }))
-        : [];
-      group.members = [...fromRavens, ...group.members].map((member) => ({
-        kind: member.model ? "local" : "remote",
-        ...member,
-      }));
-      return group;
-    });
-}
-
-const claims = (group, model) =>
-  group.members.some((member) => member.model && sameModel(member.model, model)) ||
-  group.patterns.some((pattern) => model.toLowerCase().includes(pattern.toLowerCase()));
-
-export const groupOf = (groups, model) => groups.find((group) => claims(group, model ?? ""));

package/src/models/project/anatomy.mjs

@@ -1,11 +0,0 @@
-// What every project carries (glossary: project → Anatomy).
-export const ANATOMY = {
-  "README.md": "what it is and how to use it",
-  LICENSE: "terms of use",
-  "AGENTS.md": "instructions for AI agents (CLAUDE.md imports it)",
-  "Taskfile.yml": "procedures: build, test, run",
-  src: "source code",
-  docs: "documentation",
-  tests: "tests",
-  ".github": "community files and CI workflows",
-};

package/src/models/project/class.mjs

@@ -1,20 +0,0 @@
-// One concrete project repository (glossary: project).
-import { existsSync } from "node:fs";
-
-import { BOS } from "../../main.ts";
-import { ANATOMY } from "./anatomy.mjs";
-
-export class Project extends BOS.Model {
-  static type = "project";
-  static anatomy = ANATOMY;
-
-  anatomyCheck() {
-    const parts = Object.keys(ANATOMY);
-    return {
-      present: parts.filter((part) => existsSync(this.file(part))),
-      missing: parts.filter((part) => !existsSync(this.file(part))),
-    };
-  }
-}
-
-export default Project;

package/src/models/sarcophag/class.mjs

@@ -1,8 +0,0 @@
-// encrypted container holding one bare repository (glossary: sarcophag)
-import { BOS } from "../../main.ts";
-
-export class Sarcophag extends BOS.Model {
-  static type = "sarcophag";
-}
-
-export default Sarcophag;

package/src/models/scope/class.mjs

@@ -1,19 +0,0 @@
-// A private repository holding a family of projects, shemes and one throwbox (glossary: scope).
-import { existsSync, readdirSync } from "node:fs";
-
-import { BOS } from "../../main.ts";
-import Project from "../project/class.mjs";
-
-export class Scope extends BOS.Model {
-  static type = "scope";
-
-  // every directory inside that is a git repository counts as a project
-  projects() {
-    if (!this.exists()) return [];
-    return readdirSync(this.path, { withFileTypes: true })
-      .filter((entry) => entry.isDirectory() && existsSync(this.file(entry.name, ".git")))
-      .map((entry) => new Project(this.file(entry.name), this));
-  }
-}
-
-export default Scope;

package/src/models/sheme/class.mjs

@@ -1,8 +0,0 @@
-// source material that isn't code: graphics, CAD, photos, templates (glossary: sheme)
-import { BOS } from "../../main.ts";
-
-export class Sheme extends BOS.Model {
-  static type = "sheme";
-}
-
-export default Sheme;

package/src/models/throwbox/class.mjs

@@ -1,9 +0,0 @@
-// Collector of loose files of one scope; swept on close (glossary: throwbox).
-import { BOS } from "../../main.ts";
-
-export class Throwbox extends BOS.Model {
-  static type = "throwbox";
-  static dirname = "throwbox";
-}
-
-export default Throwbox;

package/src/models/workshop/class.mjs

@@ -1,30 +0,0 @@
-// The workshop: root of crafting on a host or partition (glossary: workshop).
-// Areas are models (they hold assets); .BOS internals are submodules hanging on it.
-import { BOS } from "../../main.ts";
-import Archive from "../archive/class.mjs";
-import Craftbook from "../craftbook/class.mjs";
-import Devarmory from "../devarmory/class.mjs";
-import Forge from "../forge/class.mjs";
-import Data from "./hang.data.mjs";
-import Nests from "./hang.nests.mjs";
-import Setup from "./hang.setup.mjs";
-import Storylines from "./hang.storylines.mjs";
-import System from "./hang.system.mjs";
-import { placeOf, WORKSHOP_DIRNAME } from "./locate.mjs";
-
-export class Workshop extends BOS.Model {
-  static type = "workshop";
-  static dirname = WORKSHOP_DIRNAME;
-  static submodules = { system: System, setup: Setup, data: Data, nests: Nests, storylines: Storylines };
-  static children = [Devarmory, Forge, Craftbook, Archive];
-
-  get forge() {
-    return new Forge(this.file(Forge.dirname), this);
-  }
-
-  placeOf(path) {
-    return placeOf(path, this.path);
-  }
-}
-
-export default Workshop;

package/src/models/workshop/hang.data.mjs

@@ -1,10 +0,0 @@
-// .BOS/data: data BOS works from, e.g. <pack>.gitlist (glossary: data)
-import { BOS } from "../../main.ts";
-
-export class Data extends BOS.Submodule {
-  static type = "data";
-  static ownerType = "workshop";
-  static dirname = ".BOS/data";
-}
-
-export default Data;

package/src/models/workshop/hang.nests.mjs

@@ -1,14 +0,0 @@
-// .BOS/nests: volumes and disks of containers and VMs, always indexed and guarded (glossary: nestrelm).
-import { BOS } from "../../main.ts";
-
-export class Nests extends BOS.Submodule {
-  static type = "nestrelm";
-  static ownerType = "workshop";
-  static dirname = ".BOS/nests";
-  static descriptors = {
-    ".index.json": () => ({ nests: {} }),
-    ".manifest.json": () => ({ files: {} }),
-  };
-}
-
-export default Nests;

package/src/models/workshop/hang.setup.mjs

@@ -1,10 +0,0 @@
-// .BOS/setup: access and connectivity: keys, VPN, routing, aliases, tokens, setternet (glossary: setup)
-import { BOS } from "../../main.ts";
-
-export class Setup extends BOS.Submodule {
-  static type = "setup";
-  static ownerType = "workshop";
-  static dirname = ".BOS/setup";
-}
-
-export default Setup;

package/src/models/workshop/hang.storylines.logs.mjs

@@ -1,10 +0,0 @@
-// .BOS/storylines/logs (glossary: storylines)
-import { BOS } from "../../main.ts";
-
-export class Logs extends BOS.Submodule {
-  static type = "logs";
-  static ownerType = "storylines";
-  static dirname = "logs";
-}
-
-export default Logs;

package/src/models/workshop/hang.storylines.manifests.mjs

@@ -1,10 +0,0 @@
-// .BOS/storylines/manifests (glossary: storylines)
-import { BOS } from "../../main.ts";
-
-export class Manifests extends BOS.Submodule {
-  static type = "manifests";
-  static ownerType = "storylines";
-  static dirname = "manifests";
-}
-
-export default Manifests;

package/src/models/workshop/hang.storylines.mjs

@@ -1,39 +0,0 @@
-// .BOS/storylines: records of what happened (glossary: storylines).
-// Not needed to launch; appears with the first recorded event.
-import { appendFileSync } from "node:fs";
-
-import { BOS } from "../../main.ts";
-import Logs from "./hang.storylines.logs.mjs";
-import Manifests from "./hang.storylines.manifests.mjs";
-import Ttystories from "./hang.storylines.ttystories.mjs";
-
-export class Storylines extends BOS.Submodule {
-  static type = "storylines";
-  static ownerType = "workshop";
-  static dirname = ".BOS/storylines";
-  static mandatory = false;
-  static submodules = { ttystories: Ttystories, logs: Logs, manifests: Manifests };
-  static descriptors = {
-    "metadata.json": (_element, context) => ({
-      origin: {
-        host: context.env?.host ?? null,
-        user: context.env?.user ?? null,
-        unixusat: context.env?.unixusat ?? Date.now(),
-        createdBy: "blacksmith-organization-system",
-      },
-    }),
-  };
-
-  // one JSON line per event: opening, closing, git hooks…
-  record(event, context = {}) {
-    const entry = { unixusat: Date.now(), host: context.env?.host ?? null, ...event };
-    if (!context.dryRun) appendFileSync(this.logs.file("workshop.jsonl"), `${JSON.stringify(entry)}\n`);
-    return entry;
-  }
-
-  ttystoryName({ env }) {
-    return `ttystory-${env.host}-${env.unixusat}.txt`;
-  }
-}
-
-export default Storylines;

package/src/models/workshop/hang.storylines.ttystories.mjs

@@ -1,10 +0,0 @@
-// .BOS/storylines/ttystories (glossary: storylines)
-import { BOS } from "../../main.ts";
-
-export class Ttystories extends BOS.Submodule {
-  static type = "ttystories";
-  static ownerType = "storylines";
-  static dirname = "ttystories";
-}
-
-export default Ttystories;

package/src/models/workshop/hang.system.mjs

@@ -1,25 +0,0 @@
-// .BOS: the folder where BOS keeps itself inside a workshop (glossary: system).
-// Its contents hang on the workshop directly: workshop.setup, workshop.storylines…
-import { writeFileSync } from "node:fs";
-
-import { BOS } from "../../main.ts";
-import { workshopTaskfile } from "./taskfile.mjs";
-
-export class System extends BOS.Submodule {
-  static type = "system";
-  static ownerType = "workshop";
-  static dirname = ".BOS";
-  static descriptors = {
-    "workshop.json": (_element, context) => context.config ?? {},
-    "Taskfile.yaml": workshopTaskfile,
-  };
-
-  // change some fields of workshop.json, keep every other one
-  update(fields, context = {}) {
-    const next = { ...this.readJSON("workshop.json", {}), ...fields };
-    if (!context.dryRun) writeFileSync(this.file("workshop.json"), `${JSON.stringify(next, null, 2)}\n`);
-    return next;
-  }
-}
-
-export default System;

package/src/models/workshop/host-roles.mjs

@@ -1,9 +0,0 @@
-// What a workshop makes its host in the setternet (glossary: host-role).
-export const HOST_ROLES = {
-  "masters-outpost": "remote management of every BOS host in the setternet (Posterunek Mistrza)",
-  "forging-point": "development, compilation and similar work (Punkt Kuźniczy)",
-  "trial-hall": "virtual machines and testing (Sala Prób)",
-  "market-stall": "publication only: automatic posts and announcements (Kram Targowy)",
-  "canon-monolith": "the one master archive of all projects (Monolit Kanonu)",
-  "side-catacomb": "archive dedicated to one function (Katakumb Poboczny)",
-};