Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What is built, and what is not

Built (v0.1 core)

  • Verbs: create, show, list, ready, count, update (including an atomic --claim), close, dep add|remove|list, comments add|list, each with --json in br’s shape. See the verbs.
  • Storage: work items as facts in a quipu named graph, typed as schema:Action (schema.org first, Quechua for governance) and validated against the seeds profile on every write. See The storage model.
  • Pinning: --at <tx> on every read resolves the project as of that transaction. See Pinning.
  • Concurrency: writers are serialised by a file lock and every write is a revision-checked compare-and-set; no lost updates, and a lost claim is a clean exit 4.
  • Configuration: TOML, project then user then default, with a local store as the default. See Configuration.
  • Storage modes: a repo-local pendant committed with the code (mode 1), a quipu server over HTTP (mode 2), and sd sync between them with a three-way, field-level merge (mode 3); sd export / sd import in any mode; a git merge driver for pendants. See Storage modes.
  • A link to shuttle runs: --workflow-run records the run that creates or drives a seed. See Formulas.
  • WebAssembly: the core builds and its tests run on wasm32-unknown-unknown. See WebAssembly.

Not built yet

whatwhy it matterswhere
beads sync: two-way sync between a beads/br store and a seeds graphreading existing work, and handing work backa later phase
formulas (molecules)workflow templates that stamp and drive chains of seedsshuttle integration, sketched in Formulas; seeds will not grow its own engine
a cheaper remote writemode 2 writes cost as much as the server’s whole store (quipu’s /update)an expected-value precondition on quipu’s /set or /knot
pins across a pendant--at history in a clonequipu’s full reconstruction share
reading quipu’s existing WorkItem recordsexisting beads readable from day onecamayoc’s tracker projection keeps status on Observations; a read adapter is needed
ready / blocked / plate as camayoc stored queriesone definition shared by every callerthe ready SPARQL is in src/vocab.rs (ready_query), ready to move
sd capabilities --jsonintent 4 of the intent mapnot started
sd release <id> --if-assignee Xintent 1: a conditional releaseupdate --claim is the claim half
desire-path redirect (dp alias --cmd bd --replace sd)agents keep typing bdlives in desire-path
caboodle install and verifystack installationlives in caboodle
signed or delta pendantsverifiable ledger history between teamsquipu’s attestation and delta shares; seeds writes full, unsigned shares today

Every bd verb seeds does not know is a usage error (exit 2), which is what desire-path records as demand.