Repository navigation
glossary
github-actions[bot] edited this page Nov 6, 2026
·
5 revisions
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 indocs/changelog/phase-1.md(PL).
An ordered workspace is described at three levels. Each page below belongs to one of them.
| 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 |
| 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 |
| 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 |
| 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) |
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>
- 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
| Now | Before |
|---|---|
.BOS/ |
.__BOS/, .SETUP, .DATA, .NESTRELM, .STORYLINES as separate top-level dirs |
| scope | superproject |
| craftbook | scrapbook, notes/, CRAFTBOOKS |
| sheme | scheme |
~/__WORKSHOP |
~/.__WORKSHOP |
Blacksmith Organization System 1.14.1 · repository · documentation · generated from docs/ by scripts/gh-wiki.py, do not edit here
Home · 1.14.1
- Architecture
- Devlog
- Changelog
- For agents
-
Glossary
- BOS glossary
- Network
- Workshop
- Loop
- Elements