chore: migrate task tracking from nbd to beans

Replace all .nbd/ ticket stores with .beans/ directories across the
mono-repo (root, edu, nbd, quotesdb). Field mappings: status todo→todo,
in_progress→in-progress, done→completed, closed→scrapped,
archived→completed, backlog→draft; priority numeric→label; type
project→epic. All dependency relationships preserved via --blocked-by.

Add scripts/migrate-nbd-to-beans.sh for reproducible future migrations.

Update CLAUDE.md task-tracking sections (root, edu, nbd, quotesdb) to
reference beans commands instead of nbd commands.

Counts: root 2, edu 48, nbd 38, quotesdb 121 beans created; 0 failures.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.beans.yml

@@ -0,0 +1,6 @@
+beans:
+    path: .beans
+    prefix: vibed-
+    id_length: 4
+    default_status: todo
+    default_type: task

.beans/vibed-0fcp--add-justfiles-for-all-projects-with-lint-check-bui.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add justfiles for all projects with lint, check, build, build-release, and release recipes"
+# vibed-0fcp
-priority = 5
+title: Add justfiles for all projects with lint, check, build, build-release, and release recipes
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:29:17Z
+updated_at: 2026-03-10T23:29:17Z
+---
+
 ## Background
 
 The root `TODO.md` calls for each project in the mono-repo to have a `justfile` with standard recipe names so that any contributor can run the same commands regardless of project type. `just` is a command runner similar to Make but with cleaner syntax.

.beans/vibed-wqsu--add-contact-footer-to-all-service-front-ends.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add contact footer to all service front-ends"
+# vibed-wqsu
-priority = 3
+title: Add contact footer to all service front-ends
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:29:17Z
+updated_at: 2026-03-10T23:29:17Z
+---
+
 ## Background
 
 The root `TODO.md` calls for a footer on every service front-end with contact info:

.claude/settings.json

@@ -3,5 +3,13 @@
     "superpowers@claude-plugins-official": true,
     "plugin-dev@claude-plugins-official": true,
     "rust-analyzer-lsp@claude-plugins-official": true
+  },
+  "hooks": {
+    "SessionStart": [
+      { "hooks": [{ "type": "command", "command": "beans prime" }] }
+    ],
+    "PreCompact": [
+      { "hooks": [{ "type": "command", "command": "beans prime" }] }
+    ]
   }
 }

CLAUDE.md

@@ -327,59 +327,60 @@ Covers:
 
 <task-tracking>
 
-## Task Tracking with nbd
+**IMPORTANT**: before you do anything else, run the `beans prime` command and heed its output.
 
-`nbd` is a CLI tool for managing work tickets, designed for agent workflows.
+## Task Tracking with beans
+
+`beans` is a CLI tool for managing work tickets (called "beans"), designed for agent workflows.
 
 ### Initialisation
 
 ```sh
-nbd init
+beans init
 ```
 
-Run once in the project root. Creates `.nbd/tickets/`. Safe to run multiple times.
+Run once in the project root. Creates `.beans/`. Safe to run multiple times.
 
 ### Core commands
 
 ```sh
-# Create a new ticket (use --ftype md for a human-readable body)
+# Create a new bean
-nbd create --title "Add OAuth login" --type feature --priority 7 --ftype md --json
+beans create --json "Add OAuth login" --type feature --priority high --status todo
 
-# List all open tickets (sorted by priority)
+# List all beans
-nbd list --json
+beans list --json
 
-# Read a specific ticket
+# Show a specific bean
-nbd read <id> --json
+beans show --json <id>
 
-# Update a ticket
+# Update a bean
-nbd update <id> --status in_progress --json
+beans update --json <id> --status in-progress
-nbd update <id> --status done --json
+beans update --json <id> --status completed
 ```
 
 ### Finding what to work on
 
 ```sh
-# All tickets that are unblocked and ready to start
+# All beans that are unblocked and ready to start
-nbd ready --json
+beans list --json --ready
 
-# The single highest-priority unblocked ticket
+# Filter by type or status
-nbd next --json
+beans list --json --type bug --status todo
 ```
 
 ### Workflow
 
-1. **Before starting** — create a ticket: `nbd create --title "..." --ftype md --json`
+1. **Before starting** — create a bean: `beans create --json "..." --type task --status todo`
-2. **When starting** — mark it in progress: `nbd update <id> --status in_progress --json`
+2. **When starting** — mark it in progress: `beans update --json <id> --status in-progress`
-3. **When done** — mark it complete: `nbd update <id> --status done --json`
+3. **When done** — mark it complete: `beans update --json <id> --status completed`
 
 ### Guidelines
 
 - **Always pass `--json`** to every command for structured, unambiguous output.
-- **Always pass `--ftype md`** when creating tickets — markdown format keeps the body human-readable.
 - Use `jq` to parse and transform JSON output when needed.
-- Priority scale 0–10: use **7–9** for bugs, **5** for normal tasks, **3** for nice-to-haves.
+- `--priority` choices: `critical`, `high`, `normal`, `low`, `deferred`.
-- `--type` choices: `project`, `feature`, `task`, `bug`.
+- `--type` choices: `milestone`, `epic`, `feature`, `task`, `bug`.
-- Use `--deps id1,id2` to express blockers — tickets that must be done first.
+- Use `--blocked-by <id>` to express blockers — beans that must be done first.
-- Create tickets *before* starting non-trivial tasks, not after.
+- Create beans *before* starting non-trivial tasks, not after.
 
 </task-tracking>

edu/.beans.yml

@@ -0,0 +1,6 @@
+beans:
+    path: .beans
+    prefix: edu-
+    id_length: 4
+    default_status: todo
+    default_type: task

edu/.beans/edu-0w1v--markov-exercise-simulating-a-random-walk-rust.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov exercise: Simulating a Random Walk (Rust)"
+# edu-0w1v
-priority = 7
+title: 'Markov exercise: Simulating a Random Walk (Rust)'
-status = "archived"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 5 of edu/markov.md: Exercise 2 — Simulating a Random Walk\n\nLearning objectives:\n- Model a countably-finite state space (bounded integers) in Rust\n- Implement reflecting boundary conditions\n- Aggregate results from many trials into a histogram\n\nContent to produce:\n- Setup instructions (reuse or extend Exercise 1 project)\n- Step-by-step hints:\n  1. Define RandomWalk with min, max, prob_right fields\n  2. Implement step with boundary reflection (clamp or reverse)\n  3. Implement histogram by running simulate() many times\n  4. Print histogram as ASCII bar chart\n  5. Observe convergence toward uniform (symmetric walk) or skewed (asymmetric)\n- Full reference solution\n\nTarget: replace the stub in edu/markov.md §5

edu/.beans/edu-16fy--6-recognizing-atoms-integers-booleans-strings-symb.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§6 Recognizing Atoms: Integers, Booleans, Strings, Symbols"
+# edu-16fy
-priority = 5
+title: '§6 Recognizing Atoms: Integers, Booleans, Strings, Symbols'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
 
 ## §6 Recognizing Atoms: Integers, Booleans, Strings, Symbols — Stub to fill
 

edu/.beans/edu-18qe--markov-lesson-what-is-a-markov-chain.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: What Is a Markov Chain?"
+# edu-18qe
-priority = 7
+title: 'Markov lesson: What Is a Markov Chain?'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
+
 Write Section 1 of edu/markov.md: 'What Is a Markov Chain?'\n\nLearning objectives:\n- Define the Markov property (memorylessness)\n- Give 3–4 concrete real-world examples (weather, board games, web surfing, genetics)\n- Explain why the Markov property is a useful modelling assumption\n- Introduce the notation P(Xₙ₊₁ = s | X₀, …, Xₙ) = P(Xₙ₊₁ = s | Xₙ)\n\nContent to produce:\n- 3–5 paragraphs of prose\n- At least one illustrative example worked through informally\n- No code in this section\n\nTarget: replace the stub in edu/markov.md §1

edu/.beans/edu-1oh8--12-exercise-5-retrieval-augmented-generation.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§12 Exercise 5: Retrieval-Augmented Generation"
+# edu-1oh8
-priority = 5
+title: '§12 Exercise 5: Retrieval-Augmented Generation'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## §12 Exercise 5 — Retrieval-Augmented Generation — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 12. Exercise 5 — Retrieval-Augmented Generation`

edu/.beans/edu-34co--markov-lesson-applications-and-further-reading.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: Applications and Further Reading"
+# edu-34co
-priority = 7
+title: 'Markov lesson: Applications and Further Reading'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 10 of edu/markov.md: 'Applications and Further Reading'\n\nLearning objectives:\n- Survey real-world applications: PageRank, MCMC, HMMs, RL, bioinformatics\n- Give a 2–3 sentence description of each application and how Markov chains appear\n- Point to concrete next steps for learners who want to go deeper\n\nContent to produce:\n- Application survey (5–7 topics, each 2–3 sentences)\n- Annotated reading list:\n  * 'Introduction to Probability' (Blitzstein & Hwang) — free PDF\n  * 'Markov Chains' (Norris) — rigorous treatment\n  * Sutton & Barto 'Reinforcement Learning' — RL connection\n  * The Metropolis-Hastings algorithm article on Wikipedia\n- Rust ecosystem pointers (crates for probabilistic modelling)\n\nTarget: replace the stub in edu/markov.md §10

edu/.beans/edu-3sww--11-checking-special-forms.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§11 Checking Special Forms"
+# edu-3sww
-priority = 5
+title: §11 Checking Special Forms
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
 
 ## §11 Checking Special Forms — Stub to fill
 

edu/.beans/edu-4gok--markov-exercise-n-gram-generalization-rust.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov exercise: N-gram Generalization (Rust)"
+# edu-4gok
-priority = 7
+title: 'Markov exercise: N-gram Generalization (Rust)'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 Write Section 8 of edu/markov.md: Exercise 4 — N-gram Generalization\n\nLearning objectives:\n- Generalize from bigrams to arbitrary-order n-gram chains\n- Use Vec<String> as a HashMap key (or a joined string)\n- Empirically compare output quality for n = 1, 2, 3, 4\n\nContent to produce:\n- Setup instructions (extend Exercise 3 project)\n- Step-by-step hints:\n  1. Modify train to use a sliding window of n words as the key\n  2. Modify generate to maintain a deque/window of the last n words\n  3. Run on the same corpus with n = 1, 2, 3, 4 and print 50 words each\n  4. Discuss observations: when does it start memorising the corpus?\n- Full reference solution\n- Stretch goal: implement character-level n-grams instead of word-level\n\nTarget: replace the stub in edu/markov.md §8

edu/.beans/edu-4kkb--12-the-c-runtime-preamble.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§12 The C Runtime Preamble"
+# edu-4kkb
-priority = 5
+title: §12 The C Runtime Preamble
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §12 The C Runtime Preamble — Stub to fill
 

edu/.beans/edu-4u7w--edu-write-chapter-on-shader-programming.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "edu: write chapter on shader programming"
+# edu-4u7w
-priority = 3
+title: 'edu: write chapter on shader programming'
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## Background
 
 From `edu/TODO.md`: Hands-on: Shader programming.

edu/.beans/edu-63ze--13-generating-c-atoms-and-expressions.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§13 Generating C: Atoms and Expressions"
+# edu-63ze
-priority = 5
+title: '§13 Generating C: Atoms and Expressions'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §13 Generating C: Atoms and Expressions — Stub to fill
 

edu/.beans/edu-6r70--markov-exercise-bigram-text-generator-rust.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov exercise: Bigram Text Generator (Rust)"
+# edu-6r70
-priority = 7
+title: 'Markov exercise: Bigram Text Generator (Rust)'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 7 of edu/markov.md: Exercise 3 — Bigram Text Generator\n\nLearning objectives:\n- Build a HashMap-based transition table from a text corpus\n- Implement weighted random sampling over successor words\n- Generate and print novel word sequences from a seed\n\nContent to produce:\n- Setup instructions (new Cargo project or extend previous, add rand crate)\n- Step-by-step hints:\n  1. Tokenize corpus into words (split_whitespace)\n  2. Build BigramModel::train by iterating consecutive word pairs\n  3. Implement weighted sampling in generate (accumulate weights, compare to rng draw)\n  4. Handle end-of-chain gracefully (seed word not in model)\n  5. Try with a public-domain text (e.g., Project Gutenberg excerpt)\n- Full reference solution\n\nTarget: replace the stub in edu/markov.md §7

edu/.beans/edu-7cp2--markov-exercise-weather-model-rust.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov exercise: Weather Model (Rust)"
+# edu-7cp2
-priority = 7
+title: 'Markov exercise: Weather Model (Rust)'
-status = "archived"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 Write Section 4 of edu/markov.md: Exercise 1 — Weather Model\n\nLearning objectives:\n- Translate a transition matrix into a Rust struct\n- Use a weighted random draw to implement a single Markov step\n- Run a simulation and print or collect the resulting sequence\n\nContent to produce:\n- Setup instructions (new Cargo project, add rand crate)\n- Step-by-step hints:\n  1. Define the Weather enum and index conversion\n  2. Implement WeatherChain::step using rand::Rng::gen::<f64>()\n  3. Implement WeatherChain::simulate as a loop collecting states\n  4. Run with transition matrix [[0.8, 0.2], [0.4, 0.6]] from Sunny\n  5. Count sunny vs rainy days and compare to stationary distribution\n- Full reference solution (collapsed or at end)\n\nTarget: replace the stub in edu/markov.md §4

edu/.beans/edu-91j2--vector-db.md

@@ -1,10 +1,26 @@
-+++
+---
-title = "vector-db"
+# edu-91j2
-priority = 5
+title: vector-db
-status = "done"
+status: completed
-ticket_type = "project"
+type: epic
-dependencies = ["21d9be", "584e0c", "99e1d9", "d9f850", "6ec5ff", "37cdd5", "081a55", "5674ce", "4c961f", "1ef9f4", "e8be9a", "5ed295"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:04Z
+blocked_by:
+    - edu-mlut
+    - edu-hvic
+    - edu-twtl
+    - edu-hvmi
+    - edu-uz3e
+    - edu-ic66
+    - edu-pdeo
+    - edu-paqf
+    - edu-c98s
+    - edu-ga52
+    - edu-dgfl
+    - edu-1oh8
+---
+
 ## Project: Vector Database Self-Guided Course
 
 This is the top-level project ticket for `edu/src/vector-db.md` — a self-guided mdbook course on vector databases in the **Vibed Learning** site (`edu/`).

edu/.beans/edu-9kuk--markov-lesson-text-generation-with-markov-chains.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: Text Generation with Markov Chains"
+# edu-9kuk
-priority = 7
+title: 'Markov lesson: Text Generation with Markov Chains'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 6 of edu/markov.md: 'Text Generation with Markov Chains'\n\nLearning objectives:\n- Explain how words (or characters) become states in a text Markov chain\n- Define bigrams and how they form a transition table from a corpus\n- Discuss why generated text sounds locally plausible but globally incoherent\n- Introduce the concept of order-n chains and the tradeoff between coherence and novelty\n\nContent to produce:\n- 3–5 paragraphs of prose\n- A short worked bigram example from a 2-sentence sample text (show the table)\n- No code in this section\n\nTarget: replace the stub in edu/markov.md §6

edu/.beans/edu-a1al--markov-lesson-transition-probabilities-and-matrice.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: Transition Probabilities and Matrices"
+# edu-a1al
-priority = 7
+title: 'Markov lesson: Transition Probabilities and Matrices'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 Write Section 3 of edu/markov.md: 'Transition Probabilities and Matrices'\n\nLearning objectives:\n- Formally define the transition matrix P where P[i][j] = P(next=j | current=i)\n- Explain the stochastic matrix constraint: all rows sum to 1, all entries ≥ 0\n- Show how to compute the distribution after k steps: π₀ Pᵏ\n- Work through a 2×2 weather-model example by hand\n\nContent to produce:\n- 3–5 paragraphs of prose\n- A worked numeric example (2-state weather chain)\n- LaTeX-style or plain-text matrix notation\n- No code in this section\n\nTarget: replace the stub in edu/markov.md §3

edu/.beans/edu-al3r--edu-write-chapter-on-co-op-worker-owned-business-s.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "edu: write chapter on co-op worker-owned business structure"
+# edu-al3r
-priority = 3
+title: 'edu: write chapter on co-op worker-owned business structure'
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## Background
 
 From `edu/TODO.md`: write a chapter about how to structure a co-op profit-sharing worker-owned business.

edu/.beans/edu-azf5--2-minilisp-language-specification.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§2 MiniLisp Language Specification"
+# edu-azf5
-priority = 5
+title: §2 MiniLisp Language Specification
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §2 MiniLisp Language Specification — Stub to fill
 

edu/.beans/edu-b73b--course-writing-a-lisp-to-c-compiler-in-rust.md

@@ -1,10 +1,31 @@
-+++
+---
-title = "Course: Writing a Lisp-to-C Compiler in Rust"
+# edu-b73b
-priority = 5
+title: 'Course: Writing a Lisp-to-C Compiler in Rust'
-status = "done"
+status: completed
-ticket_type = "project"
+type: epic
-dependencies = ["e8da8b", "a93829", "3aeb62", "5835e9", "3dc36b", "685f5e", "a1a827", "b6c9ad", "a4c9f8", "d0b9f8", "6d40a7", "3e1250", "1eb794", "cbc6e3", "de82f1", "58b37a", "8fa47a", "1d16da"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:03Z
+blocked_by:
+    - edu-ylb8
+    - edu-azf5
+    - edu-n9ap
+    - edu-jzvr
+    - edu-g1r5
+    - edu-16fy
+    - edu-n7zb
+    - edu-mmbr
+    - edu-tzzh
+    - edu-h3yx
+    - edu-3sww
+    - edu-4kkb
+    - edu-63ze
+    - edu-pyue
+    - edu-unus
+    - edu-nc61
+    - edu-v0ud
+    - edu-y4e6
+---
 
 ## Course: Writing a Lisp-to-C Compiler in Rust
 

edu/.beans/edu-c98s--9-generating-embeddings-in-rust.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§9 Generating Embeddings in Rust"
+# edu-c98s
-priority = 5
+title: §9 Generating Embeddings in Rust
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## §9 Generating Embeddings in Rust — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 9. Generating Embeddings in Rust`

edu/.beans/edu-coqp--edu-write-machine-learning-chapter-self-play-game.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "edu: write Machine Learning chapter (self-play game AI, Alpha Go Zero style)"
+# edu-coqp
-priority = 3
+title: 'edu: write Machine Learning chapter (self-play game AI, Alpha Go Zero style)'
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## Background
 
 From `edu/TODO.md`: Hands-on: Machine Learning; training a computer to play a game by playing against itself (a-la Alpha Go Zero).

edu/.beans/edu-dgfl--11-exercise-4-recommendation-engine.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§11 Exercise 4: Recommendation Engine"
+# edu-dgfl
-priority = 5
+title: '§11 Exercise 4: Recommendation Engine'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
+
 ## §11 Exercise 4 — Recommendation Engine — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 11. Exercise 4 — Recommendation Engine`

edu/.beans/edu-g1r5--5-setting-up-the-project.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§5 Setting Up the Project"
+# edu-g1r5
-priority = 5
+title: §5 Setting Up the Project
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §5 Setting Up the Project — Stub to fill
 

edu/.beans/edu-ga52--10-exercise-3-semantic-document-search.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§10 Exercise 3: Semantic Document Search"
+# edu-ga52
-priority = 5
+title: '§10 Exercise 3: Semantic Document Search'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## §10 Exercise 3 — Semantic Document Search — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 10. Exercise 3 — Semantic Document Search`

edu/.beans/edu-h3yx--10-symbol-tables-and-scope.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§10 Symbol Tables and Scope"
+# edu-h3yx
-priority = 5
+title: §10 Symbol Tables and Scope
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §10 Symbol Tables and Scope — Stub to fill
 

edu/.beans/edu-hvic--2-embeddings.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§2 Embeddings"
+# edu-hvic
-priority = 5
+title: §2 Embeddings
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## §2 Embeddings — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 2. Embeddings`

edu/.beans/edu-hvmi--4-what-is-a-vector-database.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§4 What Is a Vector Database?"
+# edu-hvmi
-priority = 5
+title: §4 What Is a Vector Database?
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
+
 ## §4 What Is a Vector Database? — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 4. What Is a Vector Database?`

edu/.beans/edu-ic66--6-setting-up-turso-sqlite-vec.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§6 Setting Up Turso + sqlite-vec"
+# edu-ic66
-priority = 5
+title: §6 Setting Up Turso + sqlite-vec
-status = "closed"
+status: scrapped
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## §6 Setting Up Turso + sqlite-vec — ALREADY COMPLETE
 
 This section is fully written in `edu/src/vector-db.md` under `### 6. Setting Up`. No further content work is needed. Mark this ticket done.

edu/.beans/edu-jzvr--4-introduction-to-nom-parser-combinators.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§4 Introduction to nom: Parser Combinators"
+# edu-jzvr
-priority = 5
+title: '§4 Introduction to nom: Parser Combinators'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §4 Introduction to nom: Parser Combinators — Stub to fill
 

edu/.beans/edu-mlut--1-what-is-a-vector.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§1 What Is a Vector?"
+# edu-mlut
-priority = 5
+title: §1 What Is a Vector?
-status = "closed"
+status: scrapped
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## §1 What Is a Vector? — ALREADY COMPLETE
 
 This section is fully written in `edu/src/vector-db.md` under `### 1. What Is a Vector?`. No further content work is needed. Mark this ticket done.

edu/.beans/edu-mmbr--8-parsing-atoms-with-nom.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§8 Parsing Atoms with nom"
+# edu-mmbr
-priority = 5
+title: §8 Parsing Atoms with nom
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §8 Parsing Atoms with nom — Stub to fill
 

edu/.beans/edu-n7zb--7-the-abstract-syntax-tree.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§7 The Abstract Syntax Tree"
+# edu-n7zb
-priority = 5
+title: §7 The Abstract Syntax Tree
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §7 The Abstract Syntax Tree — Stub to fill
 

edu/.beans/edu-n9ap--3-compiler-architecture-the-pipeline.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§3 Compiler Architecture: The Pipeline"
+# edu-n9ap
-priority = 5
+title: '§3 Compiler Architecture: The Pipeline'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §3 Compiler Architecture: The Pipeline — Stub to fill
 

edu/.beans/edu-nc61--16-the-compilation-pipeline.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§16 The Compilation Pipeline"
+# edu-nc61
-priority = 5
+title: §16 The Compilation Pipeline
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
 
 ## §16 The Compilation Pipeline — Stub to fill
 

edu/.beans/edu-paqf--8-exercise-2-k-nearest-neighbor-search.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§8 Exercise 2: K-Nearest Neighbor Search"
+# edu-paqf
-priority = 5
+title: '§8 Exercise 2: K-Nearest Neighbor Search'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## §8 Exercise 2 — K-Nearest Neighbor Search — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 8. Exercise 2 — K-Nearest Neighbor Search`

edu/.beans/edu-pdeo--7-exercise-1-storing-and-retrieving-vectors.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§7 Exercise 1: Storing and Retrieving Vectors"
+# edu-pdeo
-priority = 5
+title: '§7 Exercise 1: Storing and Retrieving Vectors'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:29:59Z
+updated_at: 2026-03-10T23:29:59Z
+---
+
 ## §7 Exercise 1 — Storing and Retrieving Vectors — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 7. Exercise 1 — Storing and Retrieving Vectors`

edu/.beans/edu-pyue--14-generating-c-definitions-and-functions.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§14 Generating C: Definitions and Functions"
+# edu-pyue
-priority = 5
+title: '§14 Generating C: Definitions and Functions'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §14 Generating C: Definitions and Functions — Stub to fill
 

edu/.beans/edu-svom--markov.md

@@ -1,8 +1,22 @@
-+++
+---
-title = "markov"
+# edu-svom
-priority = 7
+title: markov
-status = "done"
+status: completed
-ticket_type = "project"
+type: epic
-dependencies = ["fbf323", "738be2", "44ebe7", "257a2a", "64826a", "92a829", "74be50", "1f995a", "68ee16", "5994a6"]
+priority: high
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:04Z
+blocked_by:
+    - edu-18qe
+    - edu-zjy1
+    - edu-a1al
+    - edu-7cp2
+    - edu-0w1v
+    - edu-9kuk
+    - edu-6r70
+    - edu-4gok
+    - edu-urpp
+    - edu-34co
+---
+
 Self-guided Markov chain course in edu/markov.md.\n\nThe course outline lives in edu/markov.md. Each of the 10 section tickets must be completed to flesh out all stubs before this project is done.\n\nSections:\n1. fbf323 — What Is a Markov Chain?\n2. 738be2 — States and Transitions\n3. 44ebe7 — Transition Probabilities and Matrices\n4. 257a2a — Exercise 1: Weather Model (Rust)\n5. 64826a — Exercise 2: Random Walk (Rust)\n6. 92a829 — Text Generation with Markov Chains\n7. 74be50 — Exercise 3: Bigram Text Generator (Rust)\n8. 1f995a — Exercise 4: N-gram Generalization (Rust)\n9. 68ee16 — Stationary Distributions\n10. 5994a6 — Applications and Further Reading

edu/.beans/edu-twtl--3-vector-similarity.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§3 Vector Similarity"
+# edu-twtl
-priority = 5
+title: §3 Vector Similarity
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## §3 Vector Similarity — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 3. Vector Similarity`

edu/.beans/edu-tx54--deploy-edu-mdbook-to-cloudflare-pages-at-vibebooks.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Deploy edu mdbook to Cloudflare Pages at vibebooks.elijah.run"
+# edu-tx54
-priority = 5
+title: Deploy edu mdbook to Cloudflare Pages at vibebooks.elijah.run
-status = "done"
+status: completed
-ticket_type = "project"
+type: epic
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## Background
 
 From `edu/TODO.md`:

edu/.beans/edu-tzzh--9-parsing-s-expressions-and-special-forms.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§9 Parsing S-Expressions and Special Forms"
+# edu-tzzh
-priority = 5
+title: §9 Parsing S-Expressions and Special Forms
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §9 Parsing S-Expressions and Special Forms — Stub to fill
 

edu/.beans/edu-u2w7--edu-write-chapter-on-creating-and-training-a-simpl.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "edu: write chapter on creating and training a simple LLM"
+# edu-u2w7
-priority = 3
+title: 'edu: write chapter on creating and training a simple LLM'
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
+
 ## Background
 
 From `edu/TODO.md`: Hands-on: Creating and training a simple LLM.

edu/.beans/edu-unus--15-generating-c-control-flow-and-sequencing.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§15 Generating C: Control Flow and Sequencing"
+# edu-unus
-priority = 5
+title: '§15 Generating C: Control Flow and Sequencing'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §15 Generating C: Control Flow and Sequencing — Stub to fill
 

edu/.beans/edu-urpp--markov-lesson-stationary-distributions.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: Stationary Distributions"
+# edu-urpp
-priority = 7
+title: 'Markov lesson: Stationary Distributions'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 9 of edu/markov.md: 'Stationary Distributions'\n\nLearning objectives:\n- Define stationary distribution π: πP = π, Σπᵢ = 1\n- Explain existence and uniqueness conditions: irreducibility and aperiodicity\n- Show how to compute π analytically for a 2-state chain\n- Introduce power iteration as a numerical method\n- Connect to the long-run frequency interpretation from the simulation in Exercise 1\n\nContent to produce:\n- 4–6 paragraphs of prose\n- Worked 2×2 example: solve πP = π by hand\n- Power iteration pseudocode or brief Rust sketch\n\nTarget: replace the stub in edu/markov.md §9

edu/.beans/edu-uz3e--5-under-the-hood-ann-algorithms.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "§5 Under the Hood: ANN Algorithms"
+# edu-uz3e
-priority = 5
+title: '§5 Under the Hood: ANN Algorithms'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 ## §5 Under the Hood: ANN Algorithms — Stub to fill
 
 File: `edu/src/vector-db.md`, section `### 5. Under the Hood: ANN Algorithms`

edu/.beans/edu-v0ud--17-testing-the-compiler.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§17 Testing the Compiler"
+# edu-v0ud
-priority = 5
+title: §17 Testing the Compiler
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
 
 ## §17 Testing the Compiler — Stub to fill
 

edu/.beans/edu-y4e6--18-whats-next-extensions-and-further-reading.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§18 What's Next: Extensions and Further Reading"
+# edu-y4e6
-priority = 5
+title: '§18 What''s Next: Extensions and Further Reading'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:00Z
+updated_at: 2026-03-10T23:30:00Z
+---
 
 ## §18 What's Next: Extensions and Further Reading — Stub to fill
 

edu/.beans/edu-ylb8--1-introduction-what-were-building.md

@@ -1,10 +1,12 @@
-+++
+---
-title = "§1 Introduction: What We're Building"
+# edu-ylb8
-priority = 5
+title: '§1 Introduction: What We''re Building'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:02Z
+updated_at: 2026-03-10T23:30:02Z
+---
 
 ## §1 Introduction: What We're Building — Stub to fill
 

edu/.beans/edu-zjy1--markov-lesson-states-and-transitions.md

@@ -1,8 +1,11 @@
-+++
+---
-title = "Markov lesson: States and Transitions"
+# edu-zjy1
-priority = 7
+title: 'Markov lesson: States and Transitions'
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:01Z
+updated_at: 2026-03-10T23:30:01Z
+---
+
 Write Section 2 of edu/markov.md: 'States and Transitions'\n\nLearning objectives:\n- Define state space (finite vs countably infinite)\n- Define a transition as a directed edge between states with an associated probability\n- Introduce state-transition diagrams and how to draw them\n- Distinguish absorbing states, transient states, and recurrent states at an intuitive level\n\nContent to produce:\n- 3–5 paragraphs of prose\n- A hand-drawn-style ASCII or described state-transition diagram for the weather example\n- No code in this section\n\nTarget: replace the stub in edu/markov.md §2

edu/.nbd/.gitignore

@@ -1 +0,0 @@
-cache.db

edu/CLAUDE.md

@@ -25,7 +25,7 @@ mdbook build
 # Serve locally with live reload (default: http://localhost:3000)
 mdbook serve
 
-# Enter the Nix dev shell (provides mdbook + nbd)
+# Enter the Nix dev shell (provides mdbook + beans)
 nix develop
 # or automatically via direnv: cd into the directory
 ```
@@ -52,6 +52,6 @@ Scope for commit messages: `edu` (e.g., `docs(edu): write §3 transition matrice
 
 Ticket IDs appear in commit messages in `[<id>]` format.
 
-Stub sections in content are marked with 🚧 and reference an nbd ticket — fill in content and close the ticket when complete.
+Stub sections in content are marked with 🚧 and reference a beans ticket — fill in content and close the ticket when complete.
 
 </conventions>

flake.nix

@@ -55,6 +55,9 @@
             # NBD task management
             nbd.packages.${system}.nbd
 
+            # Task management
+            pkgs.beans
+
             # MCP servers
             pkgs.nodejs
 

nbd/.beans.yml

@@ -0,0 +1,6 @@
+beans:
+    path: .beans
+    prefix: nbd-
+    id_length: 4
+    default_status: todo
+    default_type: task

nbd/.beans/nbd-08jg--add-nbd-next-subcommand.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "Add nbd next subcommand"
+# nbd-08jg
-priority = 7
+title: Add nbd next subcommand
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["887344"]
+priority: high
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-p9na
+---
+
 ## Summary
 
 Add `nbd next` subcommand that selects the single highest-priority ticket that is

nbd/.beans/nbd-17dp--ascii-graph-rendering-in-displayrs.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "ASCII graph rendering in display.rs"
+# nbd-17dp
-priority = 5
+title: ASCII graph rendering in display.rs
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["9c9ebe"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-csdh
+---
+
 Add `format_graph` and `print_graph` to `src/display.rs` to render a ticket dependency DAG as an ASCII tree.
 
 ## Motivation

nbd/.beans/nbd-2i1e--nbd-claude-md-command.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd claude-md command"
+# nbd-2i1e
-priority = 6
+title: nbd claude-md command
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 Add `nbd claude-md` subcommand that prints a ready-to-paste CLAUDE.md snippet for adopting `nbd` in any project. The snippet content is maintained as a source file and baked into the binary at compile time via `include_str!`.
 
 ## Motivation

nbd/.beans/nbd-4w8z--exclude-done-tickets-from-nbd-list-by-default.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "Exclude done tickets from nbd list by default"
+# nbd-4w8z
-priority = 7
+title: Exclude done tickets from nbd list by default
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["887344"]
+priority: high
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-p9na
+---
+
 ## Summary
 
 Change `nbd list` to hide `done` tickets by default. Users must explicitly opt in

nbd/.beans/nbd-56ho--tests-for-nbd-graph-command.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "Tests for nbd graph command"
+# nbd-56ho
-priority = 5
+title: Tests for nbd graph command
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = ["9ad11f"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-d9dh
+---
+
 Add comprehensive unit and integration tests for the `nbd graph` command introduced across tickets `9c9ebe`, `e14172`, and `9ad11f`.
 
 ## Unit tests (src/tests.rs)

nbd/.beans/nbd-6j0q--print-tickets-in-markdown-format-instead-of-key-va.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Print tickets in markdown format instead of key-value table"
+# nbd-6j0q
-priority = 5
+title: Print tickets in markdown format instead of key-value table
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Goal
 
 When a ticket is printed to stdout (e.g. by `nbd read`, `nbd create`, `nbd archive`, `nbd next`, `nbd update` without `--json`), it should be rendered as markdown with TOML frontmatter — the same format used by `--ftype md` files on disk — rather than the current key-value table.

nbd/.beans/nbd-7cab--add-backlog-status-to-tickets.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add backlog status to tickets"
+# nbd-7cab
-priority = 5
+title: Add backlog status to tickets
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Goal
 
 Add a `backlog` status variant so tickets can be created without immediately surfacing in the active work queue. Tickets in `backlog` are created but intentionally deferred; they should not appear in `nbd list`, `nbd ready`, or `nbd next` by default.

nbd/.beans/nbd-8yn8--add-status-convenience-sub-commands-open-start-com.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add status convenience sub-commands (open, start, complete, close)"
+# nbd-8yn8
-priority = 5
+title: Add status convenience sub-commands (open, start, complete, close)
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Problem
 
 `nbd update <id> --status <x>` is verbose for the most common lifecycle transitions. `nbd archive` already exists as a top-level convenience — the same pattern should apply to all transitions.

nbd/.beans/nbd-95l6--nbd-init-command.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd init command"
+# nbd-95l6
-priority = 7
+title: nbd init command
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 Add an explicit `nbd init` subcommand that creates `.nbd/tickets/` in the current working directory, analogous to `git init`.
 
 ## Motivation

nbd/.beans/nbd-9mxu--add-list-status-sub-commands-list-todo-list-backlo.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add list status sub-commands (list todo, list backlog, etc.)"
+# nbd-9mxu
-priority = 4
+title: Add list status sub-commands (list todo, list backlog, etc.)
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 Filtering by status requires the verbose `--filter status=X`. Common patterns like listing only backlog or only completed tickets should have ergonomic shortcuts.

nbd/.beans/nbd-9vrn--add-nbdconfigtoml-for-per-project-defaults.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add .nbd/config.toml for per-project defaults"
+# nbd-9vrn
-priority = 5
+title: Add .nbd/config.toml for per-project defaults
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 All defaults (output format, file type, default status) are hard-coded in the CLI. Users in a project that always uses `--json` or always creates `md`-format tickets must pass these flags repeatedly. A per-project config file would let them set these once.

nbd/.beans/nbd-csdh--add-graph-computation-module-srcgraphrs.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add graph computation module (src/graph.rs)"
+# nbd-csdh
-priority = 5
+title: Add graph computation module (src/graph.rs)
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 Implement `src/graph.rs` — a module that builds a directed dependency graph from a flat list of tickets and provides the data structures needed by the ASCII renderer and JSON output.
 
 ## Motivation

nbd/.beans/nbd-d9dh--add-nbd-graph-cli-subcommand.md

@@ -1,10 +1,16 @@
-+++
+---
-title = "Add 'nbd graph' CLI subcommand"
+# nbd-d9dh
-priority = 5
+title: Add 'nbd graph' CLI subcommand
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["9c9ebe", "e14172"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-csdh
+    - nbd-17dp
+---
+
 Wire up the `graph` subcommand in `src/main.rs` to expose the ASCII dependency graph and JSON output.
 
 ## Motivation

nbd/.beans/nbd-fgwx--nbd-update-diff-output.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd update diff output"
+# nbd-fgwx
-priority = 5
+title: nbd update diff output
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 Show a git-diff-style +/- summary of what changed when `nbd update` is run without `--json`.
 
 ## Motivation

nbd/.beans/nbd-flbj--update-claude-md-snippet-to-show-json-on-all-comma.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Update claude-md snippet to show --json on all commands"
+# nbd-flbj
-priority = 4
+title: Update claude-md snippet to show --json on all commands
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Goal
 
 The `nbd claude-md` command emits `src/claude_md_snippet.md` verbatim. The current snippet shows core commands without `--json`, contradicting the guideline at the bottom that says to always pass it.

nbd/.beans/nbd-i0fc--nbd-ready-command.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd ready command"
+# nbd-i0fc
-priority = 7
+title: nbd ready command
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 Add `nbd ready` subcommand that lists tickets which are actionable right now: not yet done and with all dependencies completed.
 
 ## Motivation

nbd/.beans/nbd-jc1v--split-archiveclosed-archivedone-closedcancelled.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Split archive/closed: archive=done, closed=cancelled"
+# nbd-jc1v
-priority = 6
+title: 'Split archive/closed: archive=done, closed=cancelled'
-status = "done"
+status: completed
-ticket_type = "bug"
+type: bug
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Problem
 
 Currently `nbd archive` sets a ticket's status to `closed`. This conflates two distinct intents:

nbd/.beans/nbd-kq6o--scope-nbd-next-and-nbd-ready-by-dependency-subtree.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Scope nbd next and nbd ready by dependency subtree"
+# nbd-kq6o
-priority = 5
+title: Scope nbd next and nbd ready by dependency subtree
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Summary
 
 Add an optional positional `<id>` argument to `nbd next` and `nbd ready` that scopes

nbd/.beans/nbd-l38k--fix-graph-orientation-show-goals-at-root-prerequis.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Fix graph orientation: show goals at root, prerequisites as leaves"
+# nbd-l38k
-priority = 7
+title: 'Fix graph orientation: show goals at root, prerequisites as leaves'
-status = "done"
+status: completed
-ticket_type = "bug"
+type: bug
-dependencies = []
+priority: high
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 The dependency graph is inverted. Currently:

nbd/.beans/nbd-lins--fix-nbd-graph-id-show-ancestry-path-through-ticket.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "Fix nbd graph <id>: show ancestry path through ticket, not just subtree"
+# nbd-lins
-priority = 6
+title: 'Fix nbd graph <id>: show ancestry path through ticket, not just subtree'
-status = "todo"
+status: todo
-ticket_type = "bug"
+type: bug
-dependencies = ["668150"]
+priority: normal
-+++
+created_at: 2026-03-10T23:30:29Z
+updated_at: 2026-03-10T23:30:31Z
+blocked_by:
+    - nbd-l38k
+---
+
 ## Problem
 
 Currently `nbd graph <id>` renders the subtree **below** the given ticket via dependent edges (tickets blocked by it). After the graph orientation fix (see ticket 668150), `nbd graph <id>` will render the dependency subtree **below** the given ticket.

nbd/.beans/nbd-m9q2--nbd-init-add-cachedb-to-nbdgitignore.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd init: add cache.db to .nbd/.gitignore"
+# nbd-m9q2
-priority = 5
+title: 'nbd init: add cache.db to .nbd/.gitignore'
-status = "todo"
+status: todo
-ticket_type = "task"
+type: task
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 `.nbd/cache.db` is a Turso/libsql SQLite cache file created automatically by `list_tickets_cached`. It should never be committed to git. Currently `nbd init` does not create a `.gitignore` to exclude it.

nbd/.beans/nbd-mkkm--add-xml-output-format-that-wraps-each-ticket-secti.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add --xml output format that wraps each ticket section in XML tags"
+# nbd-mkkm
-priority = 4
+title: Add --xml output format that wraps each ticket section in XML tags
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Background
 
 From `nbd/TODO.md`:

nbd/.beans/nbd-n2xz--investigate-user-configurable-type-and-status-stri.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Investigate: user-configurable type and status strings with lifecycle phases"
+# nbd-n2xz
-priority = 3
+title: 'Investigate: user-configurable type and status strings with lifecycle phases'
-status = "backlog"
+status: draft
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:29Z
+updated_at: 2026-03-10T23:30:29Z
+---
+
 ## Problem
 
 `type` and `status` are currently hard-coded Rust enums. Users cannot add custom values (e.g., `status = "review"` or `type = "spike"`) without modifying the codebase. But certain status values (`done`, `archived`, `closed`) have special semantics (excluded from `list`/`ready`/`next`; counted as resolved for deps). Making these extensible requires a design that lets users declare which values are "pre-work", "in-work", and "post-work".

nbd/.beans/nbd-no88--add-version-flag-with-xyzgitsha-format.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add --version flag with X.Y.Z+GitSha format"
+# nbd-no88
-priority = 5
+title: Add --version flag with X.Y.Z+GitSha format
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Goal
 
 Add a `--version` / `-V` flag to `nbd` that prints the version in the format:

nbd/.beans/nbd-o3k8--remove-id-field-from-ticket-json-body.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Remove id field from ticket JSON body"
+# nbd-o3k8
-priority = 9
+title: Remove id field from ticket JSON body
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: critical
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 The ticket ID is already encoded in the filename (`a3f9c2.json`). Storing it redundantly inside the JSON body creates a potential consistency hazard (the two could disagree) and wastes space. The filename should be the sole source of truth for the ID.
 
 ## Motivation

nbd/.beans/nbd-oziy--turso-cache-for-list-performance.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Turso cache for list performance"
+# nbd-oziy
-priority = 3
+title: Turso cache for list performance
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 Add a Turso (libsql) cache in `.nbd/cache.db` to accelerate `nbd list` and `nbd ready` for large ticket stores.
 
 ## Motivation

nbd/.beans/nbd-p9na--wire-filter-flag-into-list-ready-and-migrate-comma.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "Wire --filter flag into list, ready, and migrate commands"
+# nbd-p9na
-priority = 8
+title: Wire --filter flag into list, ready, and migrate commands
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["c2a024"]
+priority: critical
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:32Z
+blocked_by:
+    - nbd-zz62
+---
+
 ## Summary
 
 Add `--filter KEY=VALUE` (repeatable) to the `list`, `ready`, and `migrate` CLI commands.

nbd/.beans/nbd-pq2x--nbd-archive-command-and-closed-status.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "nbd archive command and Closed status"
+# nbd-pq2x
-priority = 6
+title: nbd archive command and Closed status
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:29Z
+updated_at: 2026-03-10T23:30:29Z
+---
+
 Add `Status::Closed` (serialised as `"closed"`) and a convenience `nbd archive <id>` command that sets it.
 
 ## Motivation

nbd/.beans/nbd-q2d1--nbd-migrate-command.md

@@ -1,10 +1,15 @@
-+++
+---
-title = "nbd migrate command"
+# nbd-q2d1
-priority = 9
+title: nbd migrate command
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = ["d1634a"]
+priority: critical
-+++
+created_at: 2026-03-10T23:30:29Z
+updated_at: 2026-03-10T23:30:31Z
+blocked_by:
+    - nbd-o3k8
+---
+
 Add `nbd migrate` to bring all ticket files on disk into conformance with the current schema. This is the standard mechanism for handling any schema change — field removals, field additions, renames, or type changes.
 
 ## Motivation

nbd/.beans/nbd-ql0c--add-next-type-filtered-sub-commands-next-bug-next.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add next <type> filtered sub-commands (next bug, next feature, next task)"
+# nbd-ql0c
-priority = 4
+title: Add next <type> filtered sub-commands (next bug, next feature, next task)
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 `nbd next --filter type=bug` is verbose. When an engineer wants the highest-priority ready bug, they should be able to say `nbd next bug`.

nbd/.beans/nbd-rulc--partial-id-matching.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Partial ID matching"
+# nbd-rulc
-priority = 8
+title: Partial ID matching
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: critical
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 Allow `nbd read`, `nbd update`, and dependency resolution to accept a prefix of a ticket ID (e.g. `nbd read a3f` resolves to `a3f9c2`).
 
 ## Motivation

nbd/.beans/nbd-s16w--multiple-file-format-support-md-toml-jsonb.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Multiple file format support (md, toml, jsonb)"
+# nbd-s16w
-priority = 5
+title: Multiple file format support (md, toml, jsonb)
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 Add `--ftype` flag to `create` and `update` to write tickets in markdown, TOML, or binary JSON (CBOR) in addition to the existing JSON format. Format is detected from file extension on read.
 
 ## Motivation

nbd/.beans/nbd-urlz--investigate-filtering-tickets-by-project-stream-of.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Investigate: filtering tickets by project / stream of work"
+# nbd-urlz
-priority = 3
+title: 'Investigate: filtering tickets by project / stream of work'
-status = "backlog"
+status: draft
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 When multiple streams of work coexist (e.g., refactoring vs. new feature), there is no way to select tickets for one stream only. `nbd next` and `nbd list` operate across all tickets.

nbd/.beans/nbd-wbf7--nix-flake-for-nbd.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Nix flake for nbd"
+# nbd-wbf7
-priority = 4
+title: Nix flake for nbd
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 Add `nbd/flake.nix` so that `nbd` can be consumed as a Nix package and used as a CLI tool in other projects in the mono-repo.
 
 ## Motivation

nbd/.beans/nbd-wi74--version-file-compile-into-binary-via-include-str-a.md

@@ -1,10 +1,13 @@
-+++
+---
-title = 'VERSION file: compile into binary via include_str\! and add nbd version subcommand'
+# nbd-wi74
-priority = 5
+title: '''VERSION file: compile into binary via include_str\! and add nbd version subcommand'''
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Problem
 
 The current version string is assembled in `main.rs` from `CARGO_PKG_VERSION` (Cargo.toml) and `GIT_SHORT_SHA` (build.rs). There is no `nbd version` subcommand — only `--version`. And the `/work` skill does not bump any version on completion.

nbd/.beans/nbd-y4nv--change-graph-cycle-marker-from-cycle-to.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Change graph cycle marker from [cycle] to *"
+# nbd-y4nv
-priority = 3
+title: Change graph cycle marker from [cycle] to *
-status = "done"
+status: completed
-ticket_type = "task"
+type: task
-dependencies = []
+priority: low
-+++
+created_at: 2026-03-10T23:30:30Z
+updated_at: 2026-03-10T23:30:30Z
+---
+
 ## Goal
 
 When `nbd graph` renders a node that has already been visited (a node appearing in multiple branches of the tree), it currently labels the repeat occurrence as `[cycle]`. This label is misleading — the node isn't truly in a cycle, it's simply appearing twice in the tree because it's depended on from multiple places. Change the marker to `*` to indicate "this ticket appears elsewhere in the tree".

nbd/.beans/nbd-yh0v--add-triage-status-new-default-for-tickets-lacking.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Add triage status: new default for tickets lacking implementation detail"
+# nbd-yh0v
-priority = 6
+title: 'Add triage status: new default for tickets lacking implementation detail'
-status = "todo"
+status: todo
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: normal
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Problem
 
 New tickets are created with `status=todo`, implying they are ready to work on. But many tickets need further research or implementation details before work can begin. The TODO describes a `triage` status for exactly this case — tickets that need an LLM or human to fill in details before they become `todo`.

nbd/.beans/nbd-zz62--implement-ticketfilter-module-with-glob-matching.md

@@ -1,10 +1,13 @@
-+++
+---
-title = "Implement TicketFilter module with glob matching"
+# nbd-zz62
-priority = 8
+title: Implement TicketFilter module with glob matching
-status = "done"
+status: completed
-ticket_type = "feature"
+type: feature
-dependencies = []
+priority: critical
-+++
+created_at: 2026-03-10T23:30:31Z
+updated_at: 2026-03-10T23:30:31Z
+---
+
 ## Summary
 
 Add a `src/filter.rs` module implementing `TicketFilter`, which parses and applies

nbd/.nbd/.gitignore

@@ -1 +0,0 @@
-cache.db

nbd/.nbd/tickets/b05b5a.json

@@ -1,8 +0,0 @@
-{
-  "title": "Test archive",
-  "body": "",
-  "priority": 5,
-  "status": "archived",
-  "dependencies": [],
-  "ticket_type": "task"
-}

nbd/.nbd/tickets/e6b9df.json

@@ -1,8 +0,0 @@
-{
-  "title": "Test ticket",
-  "body": "Some body text",
-  "priority": 7,
-  "status": "done",
-  "dependencies": [],
-  "ticket_type": "bug"
-}

nbd/CLAUDE.md

@@ -114,77 +114,61 @@ nbd graph [<id>] [--filter KEY=VALUE ...] [--json]
 
 <task-tracking>
 
-## Task Tracking with nbd
+## Task Tracking with beans
 
-Use `nbd` to track tasks for work on this project. Since the binary is not
+Use `beans` to track tasks for work on this project.
-installed, always invoke via `cargo run` from the `nbd/` directory:
 
 ```sh
-cargo run -- <subcommand> [flags]
+beans init    # run once; creates .beans/
-```
-
-The `.nbd/` directory at the project root is the ticket store. If it does not
-exist yet, initialise it first:
-
-```sh
-cargo run -- init
 ```
 
 ### Workflow
 
-Always pass `--json` to every command.
+Always pass `--json` to every command. Use `jq` to parse output when needed.
-Use `jq` to parse and transform the JSON output if necessary.
 
-**Before starting work:** Create a ticket for the task. Use `--ftype md` so the body is stored as human-readable markdown.
+**Before starting work:** Create a bean.
 
 ```sh
-cargo run -- create --title "Add partial ID matching" --type feature --priority 7 --ftype md --json
+beans create --json "Add partial ID matching" --type feature --priority high --status todo
 ```
 
 **When starting a task:** Update its status.
 
 ```sh
-cargo run -- update <id> --status in_progress --json
+beans update --json <id> --status in-progress
 ```
 
 **When done:** Mark it complete.
 
 ```sh
-cargo run -- update <id> --status done --json
+beans update --json <id> --status completed
-```
-
-**To get the single best ticket to work on next:**
-
-```sh
-cargo run -- next --json
 ```
 
-**To see all tickets that are unblocked and ready to start:**
+**To see all beans ready to start:**
 
 ```sh
-cargo run -- ready --json
+beans list --json --ready
 ```
 
-**To see all tickets:**
+**To see all beans:**
 
 ```sh
-cargo run -- list --json
+beans list --json
 ```
 
-**To read a specific ticket:**
+**To view a specific bean:**
 
 ```sh
-cargo run -- read <id> --json
+beans show --json <id>
 ```
 
 ### Guidelines
 
 - **Always use `--json`.** It gives structured, unambiguous output on every command.
-- **Always use `--ftype md`** when creating tickets. Markdown format keeps the body human-readable in the file browser.
+- Create beans *before* starting non-trivial tasks, not after.
-- Create tickets *before* starting non-trivial tasks, not after.
+- Use `--blocked-by <id>` to express blockers — beans that must be done first.
-- Use `--deps id1,id2` to express blockers — tickets that must be done first.
+- `--priority` choices: `critical`, `high`, `normal`, `low`, `deferred`.
-- `--priority` follows 0–10: use 7–9 for bugs, 5 for normal tasks, 3 for nice-to-haves.
+- `--type` choices: `milestone`, `epic`, `feature`, `task`, `bug`.
-- `--type` choices: `project`, `feature`, `task`, `bug`.
 
 </task-tracking>