Skip to content

glossary

github-actions[bot] edited this page Nov 6, 2026 · 5 revisions

BOS glossary

DRAFT. One page per element of the Blacksmith Organization System environment. Gaps are marked [TODO]. Interpretations not yet confirmed by the author are marked (assumed). Sources: author's annotations, docs/README.md, docs/devlog.md, the scrapnote archived in docs/changelog/phase-1.md (PL).

The skeleton: three layers

An ordered workspace is described at three levels. Each page below belongs to one of them.

1. Network: hosts

Element One line
setternet The network of BOS hosts that belong to one owner
host role What a host does in the setternet, defined by its workshop (forging point, canon monolith, …)
canon The authoritative, complete record of all work

2. Workshop: one per host or partition

Element Path Holds work in state
workshop ~/__WORKSHOP, /media/**/__WORKSHOP root
system __WORKSHOP/.BOS/ BOS itself (internal)
devarmory __WORKSHOP/devarmory/ tools: what work is done with
forge __WORKSHOP/forge/ active: what is being worked on
craftbook __WORKSHOP/craftbook/ knowledge: notes, recipes, procedures
archive __WORKSHOP/archive/ at rest: kept safe, full history

Internal parts of .BOS/:

Element Path One line
setup .BOS/setup/ Access and connectivity: keys, VPN, routing, aliases, tokens, setternet
data .BOS/data/ Data BOS works from (e.g. *.gitlist)
nestrelm .BOS/nests/ Volumes and disks of containers and virtual machines
storylines .BOS/storylines/ Shell history (ttystories), logs, origin metadata, manifests
views [TODO] Every way BOS presents itself: CLI, web, mobile, extension, desktop, OpenAPI, MCP

3. Elements: what lives inside the areas

Element Area One line
artefact any Common name for every element BOS manages
scope forge Private repository holding a family of related projects (formerly superproject)
project forge One concrete project repository
sheme forge Source material that isn't code: graphics, CAD, photos, templates, references
throwbox forge Collector of loose files for one scope
sarcophag archive Encrypted container holding one bare repository
exhibit archive [TODO] view built from sarcophags / archived references
scrapnote craftbook Any note not yet promoted to a document
craftset craftbook Reusable kit of notes, notebooks, scripts and session setup
collection craftbook? [TODO]
postroad ? [TODO]
element anatomy any The descriptor files that most elements carry

4. Loop: how work moves and is versioned

Element One line
craft loop The branches every change travels and the events that version it
GRIH The version scale of a scope: Generation, Reconstruction, Integration, Hooking
authors Every entity that makes a project (people, agents, bots), one line each in .github/AUTHORS
mirror A copy of a project's repository on another host, kept identical to the source by the loop
omnis .omnis.toml: a halo of weak hashes of an element's files, together pinning each down (draft)
almanac The rules of the environment (judged by code) and the chains of events met before (draft)

Tree

setternet
└── host  (role: master's outpost | forging point | trial hall | market stall | canon monolith | side catacomb)
    └── __WORKSHOP
        ├── .BOS/            workshop.json  Taskfile.yaml  .omnis.toml  package.json  Dockerfile  compose.yaml
        │   ├── setup/       (setternet/)
        │   ├── data/
        │   ├── nests/       .index.json  .manifest.json
        │   └── storylines/  ttystories/  logs/  manifests/  metadata.json
        ├── devarmory/       tools listed in a manifest
        ├── forge/
        │   └── <scope>/     private repository
        │       ├── <project>/
        │       ├── <sheme>/
        │       └── throwbox
        ├── craftbook/
        │   ├── scrapnotes/
        │   └── <craftset>/  .omnis.toml  metadata.json  manifest.json  Taskfile.yaml
        └── archive/
            ├── <sarcophag>
            ├── <exhibit>
            └── <pack>/<mirror repo>

Lifecycles across the tree

  • work: forge (open) → archive (closed, sarcophag) → canon monolith (authoritative record)
  • loose files: throwbox → swept on close → anonymous sarcophag → sorted, reused or deleted
  • notes: scrapnote → promoted to document, guide or publication (some stay scrapnotes: changelogs, release notes)
  • tools: listed in the devarmory manifest → downloaded → checksum-verified → linked into PATH or desktop

Older names

Now Before
.BOS/ .__BOS/, .SETUP, .DATA, .NESTRELM, .STORYLINES as separate top-level dirs
scope superproject
craftbook scrapbook, notes/, CRAFTBOOKS
sheme scheme
~/__WORKSHOP ~/.__WORKSHOP

Clone this wiki locally