Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
245 commits
Select commit Hold shift + click to select a range
3113dcc
Add best-match tightening for local head bounds
TheDarkchip Dec 24, 2025
40dcd3b
Add layer best-match margin certs
TheDarkchip Dec 24, 2025
006bd4d
Prove cache header round-trip
TheDarkchip Dec 26, 2025
32689eb
Add specs for SOUND helpers
TheDarkchip Dec 26, 2025
9b9cab1
Move SOUND checks to pure helpers
TheDarkchip Dec 26, 2025
576d404
Refactor SOUND IO verification helpers
TheDarkchip Dec 26, 2025
8e55999
Move attn weight bounds to pure helper
TheDarkchip Dec 26, 2025
1c8070b
Extract pure IO helpers
TheDarkchip Dec 26, 2025
1568583
Add best-match margin tightening for certify
TheDarkchip Dec 26, 2025
1c511a1
Update soundness limitations for best-match margins
TheDarkchip Dec 26, 2025
9a28ced
Add portfolio bounds for expLB and softmax
TheDarkchip Dec 26, 2025
e6233df
Verify model weight-derived bounds
TheDarkchip Dec 26, 2025
2487ab3
Derive softmax prob bounds from score magnitude
TheDarkchip Dec 27, 2025
91531f4
Optimize induction best-match pass
TheDarkchip Dec 30, 2025
65c736b
Docs: note gitignored models dir
TheDarkchip Dec 30, 2025
e61f639
Sound: fix attention score scale bound
TheDarkchip Dec 30, 2025
0332d9c
Add causal pattern flags and logit-diff helper
TheDarkchip Dec 30, 2025
491a009
Tighten SOUND GeLU bounds and LN variance
TheDarkchip Dec 30, 2025
39dff3a
Optimize cache build and add benchmark
TheDarkchip Jan 1, 2026
d4a23bb
Optimize sound Rat parsing
TheDarkchip Jan 1, 2026
aebc8f4
Extend SOUND head patterns and bounds
TheDarkchip Jan 1, 2026
7f05888
Optimize tokenizer and text parsing
TheDarkchip Jan 1, 2026
aa4f11c
Optimize power iteration and binary parsing
TheDarkchip Jan 1, 2026
b26b0dd
Optimize parsing and attention weights
TheDarkchip Jan 1, 2026
76eb22f
Optimize ConcreteMatrix array operations
TheDarkchip Jan 1, 2026
ba16723
Optimize parsing loops and matrix construction
TheDarkchip Jan 1, 2026
4f8e8de
Refactor parsing helpers
TheDarkchip Jan 1, 2026
a6fc01d
Optimize binary parsing loops
TheDarkchip Jan 1, 2026
12fb130
Refactor IO parsing and staging
TheDarkchip Jan 1, 2026
81dfff9
Refine tokenization and log sanitization
TheDarkchip Jan 1, 2026
adadc47
Unify text line splitting in SOUND paths
TheDarkchip Jan 1, 2026
daa2994
Reuse SOUND text parsers in untrusted compute
TheDarkchip Jan 1, 2026
06a0469
Share SOUND text scanning utilities
TheDarkchip Jan 1, 2026
2c525bb
Streamline Discovery aggregation loops
TheDarkchip Jan 1, 2026
2198069
Optimize IO and SOUND parsing paths
TheDarkchip Jan 1, 2026
bf9352b
Refactor core proofs without aesop
TheDarkchip Jan 1, 2026
3af9bc0
Refine core probability and layer lemmas
TheDarkchip Jan 1, 2026
b747b13
Refine attribution and linearization helpers
TheDarkchip Jan 1, 2026
ce38edf
Simplify signed mixer bounds and verification helpers
TheDarkchip Jan 1, 2026
f3dc3a8
Streamline ablation discrepancy and verification deltas
TheDarkchip Jan 1, 2026
3c7e8dc
Use abbrev for induction head bounds
TheDarkchip Jan 1, 2026
07d729c
Use List.sum for reroute weights
TheDarkchip Jan 1, 2026
4d90ba0
Simplify head membership checks
TheDarkchip Jan 1, 2026
6281bcb
Drop unused import in SignedMixer
TheDarkchip Jan 1, 2026
c916d40
Simplify circuit construction helper
TheDarkchip Jan 1, 2026
53ed865
Refactor SOUND array builders
TheDarkchip Jan 1, 2026
bb31843
Add timing hooks for analysis and induction
TheDarkchip Jan 1, 2026
eb67a66
Add bench subcommand for repeatable runs
TheDarkchip Jan 1, 2026
a1b2d9e
Extend bench with repeats and breakdown
TheDarkchip Jan 1, 2026
8d39d7a
Streamline induction candidates and cache benchmarks
TheDarkchip Jan 1, 2026
3c24c32
Tune head task parallelism in cache build
TheDarkchip Jan 1, 2026
3dc9a7a
Refactor parsing loops and LayerNorm stats
TheDarkchip Jan 1, 2026
9ab5b10
Optimize IO buffering and sound cache parsing
TheDarkchip Jan 1, 2026
70d2cbe
Streamline verification scan and range folds
TheDarkchip Jan 1, 2026
de62228
Reduce list allocations in Linearization bounds
TheDarkchip Jan 1, 2026
46260ad
Preallocate sound and discovery arrays
TheDarkchip Jan 1, 2026
d82ecc1
Tidy cert validity checks and logging
TheDarkchip Jan 1, 2026
83b33ed
Optimize induction cert hot path
TheDarkchip Jan 1, 2026
4193e19
Update documentation and CLI docstrings
TheDarkchip Jan 1, 2026
2da87eb
Clarify untrusted sound compute docstring
TheDarkchip Jan 1, 2026
1cafbfc
Speed up pattern tasks and matmul pipeline
TheDarkchip Jan 1, 2026
b023dc2
Add margin debug logging to sound compute
TheDarkchip Jan 2, 2026
94b9d22
tabula rasa core: DAG local system scaffold
TheDarkchip Jan 2, 2026
dfedecc
refactor dag to wrap mathlib Digraph
TheDarkchip Jan 2, 2026
023e4a8
lean core reuse: pi.single pure, narrower imports
TheDarkchip Jan 2, 2026
9891ade
narrow build roots to new Nfp spine
TheDarkchip Jan 2, 2026
62eed2b
local system eval semantics and row-stochastic predicate
TheDarkchip Jan 2, 2026
ca6fa2b
Add Dag coercion to Digraph
TheDarkchip Jan 2, 2026
6fee534
Add circuit core definitions and equivalence checker
TheDarkchip Jan 2, 2026
ace7880
Make circuit equivalence checker computable
TheDarkchip Jan 2, 2026
e2f2549
Enable additional style linters
TheDarkchip Jan 2, 2026
f1cc4dc
Add input-only circuit assignments and evaluation
TheDarkchip Jan 2, 2026
d67e6df
Add typed circuit interfaces and well-formedness
TheDarkchip Jan 2, 2026
57fe3b3
Document tabula rasa rewrite status
TheDarkchip Jan 2, 2026
c6f9713
Add circuit combinators and gates
TheDarkchip Jan 2, 2026
95e7723
Use ASCII identifiers in circuit modules
TheDarkchip Jan 2, 2026
6658bb3
Add tensor aliases and linear gates
TheDarkchip Jan 2, 2026
91e7aa5
Add linear layer circuit combinators
TheDarkchip Jan 2, 2026
a00e4bf
Add batched linear layer combinators
TheDarkchip Jan 2, 2026
9fd30b1
Add reshape combinators for typed interfaces
TheDarkchip Jan 2, 2026
f2b76de
Add head split and merge combinators
TheDarkchip Jan 2, 2026
1ad0ada
Add attention projection wiring
TheDarkchip Jan 2, 2026
e4f5352
Add circuit composition and induction-head spec
TheDarkchip Jan 2, 2026
9625348
Extend attention core wiring
TheDarkchip Jan 2, 2026
9d2307a
Update tabula rasa status
TheDarkchip Jan 2, 2026
dd56c5b
Add induction spec and typed eval lemma
TheDarkchip Jan 2, 2026
969a8b3
Remove legacy tree
TheDarkchip Jan 2, 2026
27fabed
Add one-hot bounds certification
TheDarkchip Jan 2, 2026
cf4a926
Add approximate induction specs
TheDarkchip Jan 2, 2026
e007989
Add softmax margin certificate checker
TheDarkchip Jan 2, 2026
328bc38
Add induction cert parser and CLI
TheDarkchip Jan 2, 2026
a98c8e5
Update module map for IO
TheDarkchip Jan 2, 2026
c7baf68
Add value-range certificate support for induction bounds
TheDarkchip Jan 3, 2026
943e80b
Add induction certification pipeline and downstream bounds
TheDarkchip Jan 3, 2026
b7dad21
Add verified matrix norm bounds and rewrite README
TheDarkchip Jan 3, 2026
76320d4
Update soundness docs and remove changelog notes
TheDarkchip Jan 3, 2026
2b62251
Add nfpt parsing and end-to-end model certification
TheDarkchip Jan 3, 2026
1bbcbe2
Add residual-bound certificates and generator
TheDarkchip Jan 3, 2026
e7ee745
Add residual-interval bounds for downstream error
TheDarkchip Jan 3, 2026
1f504f4
Add model-based head input certification
TheDarkchip Jan 3, 2026
1f3489e
Add interval bounds for matrix products
TheDarkchip Jan 3, 2026
1cbaa33
Add head output interval CLI
TheDarkchip Jan 3, 2026
d00a8af
Plumb head biases and LN metadata
TheDarkchip Jan 3, 2026
1f390ea
Fix induction bounds proofs and docs
TheDarkchip Jan 3, 2026
67e5429
Extend induction certs and tighten LayerNorm bounds
TheDarkchip Jan 3, 2026
0f780af
Add transformer-stack bounds and model-derived residual intervals
TheDarkchip Jan 4, 2026
fed4e8b
Add interval layernorm bounds and tail-recursive sums
TheDarkchip Jan 4, 2026
739b342
Refactor IO/Sound modules and streamline dyadic-real lemmas
TheDarkchip Jan 7, 2026
aef5a5f
Add missing docstrings and reuse global dyadic-real lemmas
TheDarkchip Jan 7, 2026
3cb190b
Refine induction Q/K abs bounds caching
TheDarkchip Jan 8, 2026
4444078
Replace Dyadic usage with Rat
TheDarkchip Jan 8, 2026
52f9b32
Update AGENTS build instructions and module map
TheDarkchip Jan 8, 2026
072669d
Tighten head score bounds via interval dot products
TheDarkchip Jan 9, 2026
b8da417
Tighten LayerNorm inv-std bound with variance lower
TheDarkchip Jan 9, 2026
fbc3567
Add scaled sqrtLower bound for LayerNorm
TheDarkchip Jan 9, 2026
a8c33df
Add sign-split dot-product bounds
TheDarkchip Jan 9, 2026
2621aa8
Prioritize sign-split dims by bound score
TheDarkchip Jan 9, 2026
d385169
Tighten dot bounds with k-side sign splits
TheDarkchip Jan 9, 2026
3a71d8b
Increase k-side split budget
TheDarkchip Jan 9, 2026
d24130c
Refactor induction head soundness and invStd bounds
TheDarkchip Jan 10, 2026
322621e
Tighten dot-diff bounds for active queries
TheDarkchip Jan 10, 2026
879aed2
Update agent docs and module map
TheDarkchip Jan 10, 2026
b9bbe4e
Refine induction core bounds
TheDarkchip Jan 10, 2026
c0db78d
Add proof automation guidance to AGENTS
TheDarkchip Jan 10, 2026
82185f6
refactor proofs with controlled automation
TheDarkchip Jan 11, 2026
67efe48
tighten induction proof scaffolding
TheDarkchip Jan 11, 2026
0250f48
simplify CoreSound proof steps
TheDarkchip Jan 11, 2026
2eed498
Adjusted guidance on CLI command verification
TheDarkchip Jan 11, 2026
721ed12
refactor induction bounds proofs
TheDarkchip Jan 11, 2026
c5b774d
Tighten induction margins and add auto head CLI
TheDarkchip Jan 11, 2026
c56dfd4
Tune sign-split budgets for tighter QK bounds
TheDarkchip Jan 11, 2026
83da20b
Increase LayerNorm sqrt precision
TheDarkchip Jan 11, 2026
e525dde
Tighten value bounds per position
TheDarkchip Jan 11, 2026
f7dc710
Guidance adjustment for aesop
TheDarkchip Jan 11, 2026
654405b
bd sync: 2026-01-12 15:31:37
TheDarkchip Jan 12, 2026
4fe3efd
Refactor induction bounds and LayerNorm proofs
TheDarkchip Jan 12, 2026
32a8ed7
Refactor interval bounds foldl pair helper
TheDarkchip Jan 12, 2026
be20a13
Refactor sqrt rounding helpers
TheDarkchip Jan 12, 2026
a2d12c2
bd sync: 2026-01-12 16:16:25
TheDarkchip Jan 12, 2026
b50ccba
Deduplicate top2 split selector
TheDarkchip Jan 12, 2026
6bad98b
bd sync: 2026-01-12 16:22:24
TheDarkchip Jan 12, 2026
4e8b93b
Refactor HeadBounds reduction task helper
TheDarkchip Jan 12, 2026
8c9389a
bd sync branch
TheDarkchip Jan 12, 2026
a95635b
Tighten induction epsilon bounds
TheDarkchip Jan 12, 2026
41d1787
Improve induction cert bounds and fix float parsing
TheDarkchip Jan 12, 2026
dba1722
Parse layer_norm_eps exactly in head input builder
TheDarkchip Jan 12, 2026
e151de6
Streamline timing output and skip masked dot bounds
TheDarkchip Jan 12, 2026
4c03ba4
Add split-budget config for induction certs
TheDarkchip Jan 13, 2026
4361a71
Optimize induction head certification
TheDarkchip Jan 13, 2026
e1d8517
Streamline induction CLI
TheDarkchip Jan 13, 2026
1dcff50
Add induction head certification audit
TheDarkchip Jan 13, 2026
d199236
Clarify induction certification claims
TheDarkchip Jan 13, 2026
1219232
Document prevOfTokens correctness
TheDarkchip Jan 13, 2026
360f3c7
Relate active tokens to prev mapping
TheDarkchip Jan 13, 2026
e18fc72
Clarify model-derived induction inputs
TheDarkchip Jan 13, 2026
8f50953
Add head logit-diff bridge with residual bounds
TheDarkchip Jan 13, 2026
31fc251
Package GPT-2 residual bounds as certified intervals
TheDarkchip Jan 13, 2026
955f056
Compose head logit-diff with output intervals
TheDarkchip Jan 13, 2026
0563d22
Add GPT-2 end-to-end logit-diff bound
TheDarkchip Jan 13, 2026
ddba480
Add head interval option to end-to-end model cert
TheDarkchip Jan 13, 2026
bcbbafa
Avoid stack overflow in softmax-margin parsing
TheDarkchip Jan 13, 2026
cf9e238
Remove module map references
TheDarkchip Jan 13, 2026
865875d
Refactor module structure and remove bench tooling
TheDarkchip Jan 13, 2026
c46601c
Split bounds basics into submodules
TheDarkchip Jan 13, 2026
e21800c
Add Basic submodules for induction IO and bounds
TheDarkchip Jan 13, 2026
ae25636
Add Basic submodules for induction core and run IO
TheDarkchip Jan 13, 2026
41b1246
Pilot module-system conversion for core modules
TheDarkchip Jan 13, 2026
97179ce
Refactor modules across circuit, model, sound, and IO
TheDarkchip Jan 13, 2026
f350dbf
Make Nfp aggregate modules explicit modules
TheDarkchip Jan 13, 2026
e0a2120
Trim exposure in model and circuit modules
TheDarkchip Jan 13, 2026
bc087ba
Refine Sound exposure usage
TheDarkchip Jan 13, 2026
1b50547
Trim remaining Sound exposures
TheDarkchip Jan 13, 2026
b50d550
Remove final Sound exposure
TheDarkchip Jan 13, 2026
11fa6ab
refactor: align module structure and defs
TheDarkchip Jan 13, 2026
dde521e
docs: add mathlib module style guide
TheDarkchip Jan 13, 2026
f836f98
docs: refine mathlib module style guide
TheDarkchip Jan 13, 2026
d37dbe7
Align module headers for CLI and executables
TheDarkchip Jan 13, 2026
231d6b3
Update AGENTS guidance
TheDarkchip Jan 14, 2026
df9cc8f
Centralize softmax weight invariants
TheDarkchip Jan 14, 2026
b1381af
Tighten induction weight bounds and logit-diff LB
TheDarkchip Jan 14, 2026
f237b58
Cache logit-diff bounds and parallelize weightBoundAt
TheDarkchip Jan 14, 2026
38bb9aa
Move induction-head timing helpers into IO.Timing
TheDarkchip Jan 14, 2026
4312769
Optimize weighted logit-diff path
TheDarkchip Jan 14, 2026
2a1c43e
Speed weighted logit-diff gap
TheDarkchip Jan 14, 2026
a4fbf98
Optimize induction head logit-diff caching
TheDarkchip Jan 16, 2026
49fec42
Boost refine-on-demand budgets for logit-diff
TheDarkchip Jan 16, 2026
703cd76
Refactor logit-diff soundness and nonvacuous IO
TheDarkchip Jan 16, 2026
3a74bc6
Refine loAt-min keys in logit-diff bounds
TheDarkchip Jan 16, 2026
7239a06
Refine top-weight keys in logit-diff
TheDarkchip Jan 16, 2026
ab82c87
Add LocalSystem sparsity lemmas
TheDarkchip Jan 16, 2026
0bef407
Add induction diagnostics and literature-aligned discovery defaults
TheDarkchip Jan 16, 2026
3d304da
Fix bigram prev mapping to canonical induction definition
TheDarkchip Jan 16, 2026
e5cab0e
Add shifted induction prev/active definitions
TheDarkchip Jan 16, 2026
503fe5d
Add shifted GPT-2 induction input builder
TheDarkchip Jan 16, 2026
c4fa6de
Add shifted prev spec predicates for induction
TheDarkchip Jan 16, 2026
5406f58
Add copy/OV scoring to induction discovery
TheDarkchip Jan 16, 2026
def4cb9
Make CLI layer/head indices 1-based by default
TheDarkchip Jan 16, 2026
c2753ca
Fix shifted prev spec proof
TheDarkchip Jan 16, 2026
f995ce7
Add synthetic prefix-matching benchmark mode
TheDarkchip Jan 16, 2026
d883c8b
Add activation-based discovery scoring
TheDarkchip Jan 16, 2026
9ac3a53
Fix activation head split for transformers
TheDarkchip Jan 16, 2026
9cbd783
Add induction stripe attention scoring
TheDarkchip Jan 16, 2026
1441700
Add circuit scoring for induction discovery
TheDarkchip Jan 16, 2026
873c510
Add circuit+copy induction scoring
TheDarkchip Jan 16, 2026
33832d5
Add seq_len=50 induction diagnostic script
TheDarkchip Jan 16, 2026
62e8f72
Fix diagnostic token lemmas for induction prompts
TheDarkchip Jan 16, 2026
73222da
Add diagnostic spec bridge for induction prompts
TheDarkchip Jan 16, 2026
b031709
Add script to certify any induction head
TheDarkchip Jan 16, 2026
70d9bd6
Extend induction head certify wrapper with advanced flags
TheDarkchip Jan 16, 2026
cd87283
Add skip-logit-diff option for induction certs
TheDarkchip Jan 16, 2026
437c19b
Add induction circuit specs and shifted-prev circuit cert
TheDarkchip Jan 17, 2026
dd15497
Add explicit induction head cert checker
TheDarkchip Jan 17, 2026
1838854
Add CLI check for explicit induction certs
TheDarkchip Jan 17, 2026
efda300
Allow induction certify to use explicit certs
TheDarkchip Jan 17, 2026
e8e31f8
Deprecate non-split CLI paths
TheDarkchip Jan 17, 2026
47f3384
Remove non-split induction CLI/IO paths
TheDarkchip Jan 17, 2026
a79bd40
Remove induction cert generators from Sound
TheDarkchip Jan 17, 2026
fd265ad
Remove residual cert packaging in bounds
TheDarkchip Jan 17, 2026
b28b7c5
Move IO parsing helpers to untrusted Parse namespace
TheDarkchip Jan 17, 2026
aadcd7a
Move GPT-2 head input builders out of Sound
TheDarkchip Jan 17, 2026
3212c4d
Move bounds and linear helpers out of Sound
TheDarkchip Jan 17, 2026
24e0c9e
Align cert pipeline to Python generation and Lean checks
TheDarkchip Jan 17, 2026
16033ed
Limit induction certification to head-level parity
TheDarkchip Jan 17, 2026
b23ec0c
Trim model-level wording from parity docs
TheDarkchip Jan 17, 2026
872a584
Remove .nfpt format dependencies
TheDarkchip Jan 17, 2026
e19088f
Clean .gitignore of nfpt entries
TheDarkchip Jan 17, 2026
d34ad22
Streamline induction CLI and tighten cert generation
TheDarkchip Jan 17, 2026
ae60aec
Adopt 1-based indexing in certificates
TheDarkchip Jan 17, 2026
6449166
Use 1-based layer/head indexing in cert generator
TheDarkchip Jan 17, 2026
3c1d011
Document literature-aligned induction diagnostics
TheDarkchip Jan 17, 2026
79e94c0
Document non-vacuous induction certification
TheDarkchip Jan 17, 2026
15a3614
Add direction search for non-vacuous certs
TheDarkchip Jan 17, 2026
d69f3f0
Remove obsolete script and clarify untrusted search
TheDarkchip Jan 17, 2026
3c2b20a
Clarify untrusted direction search in limitations
TheDarkchip Jan 17, 2026
0643b40
Add direction search report output
TheDarkchip Jan 17, 2026
40e7f1e
Merge branch 'audit-induction-cert' into tabula-rasa
TheDarkchip Jan 17, 2026
27f74d5
Update README for literature alignment and reports
TheDarkchip Jan 17, 2026
260f406
Verify cert prev/active against optional tokens
TheDarkchip Jan 17, 2026
382e98f
Add user-facing demo guide
TheDarkchip Jan 17, 2026
3627f0f
Add certificate usefulness note
TheDarkchip Jan 17, 2026
656838d
Add literature references
TheDarkchip Jan 17, 2026
02384d7
Fix literature references
TheDarkchip Jan 17, 2026
ebf4e0f
Update reference links
TheDarkchip Jan 17, 2026
397fc91
Remove citation artifacts
TheDarkchip Jan 17, 2026
0c3a473
Trim CI and fix parse cert docstrings
TheDarkchip Jan 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions .beads/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# SQLite databases
*.db
*.db?*
*.db-journal
*.db-wal
*.db-shm

# Daemon runtime files
daemon.lock
daemon.log
daemon.pid
bd.sock
sync-state.json
last-touched

# Local version tracking (prevents upgrade notification spam after git ops)
.local_version

# Legacy database files
db.sqlite
bd.db

# Worktree redirect file (contains relative path to main repo's .beads/)
# Must not be committed as paths would be wrong in other clones
redirect

# Merge artifacts (temporary files from 3-way merge)
beads.base.jsonl
beads.base.meta.json
beads.left.jsonl
beads.left.meta.json
beads.right.jsonl
beads.right.meta.json

# Sync state (local-only, per-machine)
# These files are machine-specific and should not be shared across clones
.sync.lock
sync_base.jsonl

# NOTE: Do NOT add negation patterns (e.g., !issues.jsonl) here.
# They would override fork protection in .git/info/exclude, allowing
# contributors to accidentally commit upstream issue databases.
# The JSONL files (issues.jsonl, interactions.jsonl) and config files
# are tracked by git by default since no pattern above ignores them.
81 changes: 81 additions & 0 deletions .beads/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# Beads - AI-Native Issue Tracking

Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.

## What is Beads?

Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.

**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)

## Quick Start

### Essential Commands

```bash
# Create new issues
bd create "Add user authentication"

# View all issues
bd list

# View issue details
bd show <issue-id>

# Update issue status
bd update <issue-id> --status in_progress
bd update <issue-id> --status done

# Sync with git remote
bd sync
```

### Working with Issues

Issues in Beads are:
- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
- **AI-friendly**: CLI-first design works perfectly with AI coding agents
- **Branch-aware**: Issues can follow your branch workflow
- **Always in sync**: Auto-syncs with your commits

## Why Beads?

**AI-Native Design**
- Built specifically for AI-assisted development workflows
- CLI-first interface works seamlessly with AI coding agents
- No context switching to web UIs

🚀 **Developer Focused**
- Issues live in your repo, right next to your code
- Works offline, syncs when you push
- Fast, lightweight, and stays out of your way

🔧 **Git Integration**
- Automatic sync with git commits
- Branch-aware issue tracking
- Intelligent JSONL merge resolution

## Get Started with Beads

Try Beads in your own projects:

```bash
# Install Beads
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# Initialize in your repo
bd init

# Create your first issue
bd create "Try out Beads"
```

## Learn More

- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
- **Quick Start Guide**: Run `bd quickstart`
- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)

---

*Beads: Issue tracking that moves at the speed of thought*
62 changes: 62 additions & 0 deletions .beads/config.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Beads Configuration File
# This file configures default behavior for all bd commands in this repository
# All settings can also be set via environment variables (BD_* prefix)
# or overridden with command-line flags

# Issue prefix for this repository (used by bd init)
# If not set, bd init will auto-detect from directory name
# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
# issue-prefix: ""

# Use no-db mode: load from JSONL, no SQLite, write back after each command
# When true, bd will use .beads/issues.jsonl as the source of truth
# instead of SQLite database
# no-db: false

# Disable daemon for RPC communication (forces direct database access)
# no-daemon: false

# Disable auto-flush of database to JSONL after mutations
# no-auto-flush: false

# Disable auto-import from JSONL when it's newer than database
# no-auto-import: false

# Enable JSON output by default
# json: false

# Default actor for audit trails (overridden by BD_ACTOR or --actor)
# actor: ""

# Path to database (overridden by BEADS_DB or --db)
# db: ""

# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
# auto-start-daemon: true

# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
# flush-debounce: "5s"

# Git branch for beads commits (bd sync will commit to this branch)
# IMPORTANT: Set this for team projects so all clones use the same sync branch.
# This setting persists across clones (unlike database config which is gitignored).
# Can also use BEADS_SYNC_BRANCH env var for local override.
# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
sync-branch: "beads-sync"

# Multi-repo configuration (experimental - bd-307)
# Allows hydrating from multiple repositories and routing writes to the correct JSONL
# repos:
# primary: "." # Primary repo (where this database lives)
# additional: # Additional repos to hydrate from (read-only)
# - ~/beads-planning # Personal planning repo
# - ~/work-planning # Work planning repo

# Integration settings (access with 'bd config get/set')
# These are stored in the database, not in this file:
# - jira.url
# - jira.project
# - linear.url
# - linear.api-key
# - github.org
# - github.repo
Empty file added .beads/interactions.jsonl
Empty file.
3 changes: 3 additions & 0 deletions .beads/issues.jsonl
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{"id":"nfp-g0j","title":"Refactor HeadBounds reduction helpers","description":"Deduplicate chunked reduction task helpers in Nfp/Sound/Induction/HeadBounds.lean to reduce proof churn while preserving behavior.","status":"closed","priority":2,"issue_type":"task","owner":"robin.gieseke@me.com","created_at":"2026-01-12T16:21:11.583135+01:00","created_by":"TheDarkchip","updated_at":"2026-01-12T16:22:20.621327+01:00","closed_at":"2026-01-12T16:22:20.621327+01:00","close_reason":"Completed"}
{"id":"nfp-g78","title":"Refactor CoreSound lemmas for stability","description":"Refactor Nfp/Sound/Induction/CoreSound.lean to reduce proof churn and improve maintainability; keep proofs explicit and stable.","status":"closed","priority":2,"issue_type":"task","owner":"robin.gieseke@me.com","created_at":"2026-01-12T16:12:25.347409+01:00","created_by":"TheDarkchip","updated_at":"2026-01-12T16:16:04.322186+01:00","closed_at":"2026-01-12T16:16:04.322186+01:00","close_reason":"Completed","labels":["in_progress"]}
{"id":"nfp-snh","title":"Refactor MatrixNorm interval bounds proofs","description":"Refactor Nfp/Sound/Bounds/MatrixNorm/Interval.lean to reduce proof churn and simplify interval bound lemmas.","status":"closed","priority":2,"issue_type":"task","owner":"robin.gieseke@me.com","created_at":"2026-01-12T15:54:50.752468+01:00","created_by":"TheDarkchip","updated_at":"2026-01-12T16:01:12.070535+01:00","closed_at":"2026-01-12T16:01:12.070535+01:00","close_reason":"Closed","comments":[{"id":1,"issue_id":"nfp-snh","author":"TheDarkchip","text":"Refactored foldl_pair helper for pair foldl projections in MatrixNorm interval bounds; adjusted proofs to use Prod.fst/Prod.snd. Fixed CoreSound cdot lint warnings encountered during build.","created_at":"2026-01-12T15:01:08Z"}]}
4 changes: 4 additions & 0 deletions .beads/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"database": "beads.db",
"jsonl_export": "issues.jsonl"
}
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@

# Use bd merge for beads JSONL files
.beads/issues.jsonl merge=beads
30 changes: 0 additions & 30 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,33 +33,3 @@ jobs:
echo "Quiet build failed; retrying verbose..."
lake build nfp -v --no-ansi --wfail
}

- name: SOUND cache regression test (tiny fixture)
run: |
set -euo pipefail
lake exe nfp sound_cache_check --scalePow10 9 --maxTokens 0 tests/fixtures/tiny_sound_model.nfpt

- name: Python setup
uses: actions/setup-python@v5
with:
python-version: "3.11"

- name: Cache HF model files
uses: actions/cache@v4
with:
path: |
~/.cache/huggingface
~/.cache/torch
key: ${{ runner.os }}-hf-tiny-gpt2-v1

- name: Install PyTorch + Transformers (CPU)
run: |
set -euo pipefail
python -m pip install --upgrade pip
python -m pip install --index-url https://download.pytorch.org/whl/cpu torch
python -m pip install transformers numpy

- name: Sanity check (Lean vs PyTorch forward step)
run: |
set -euo pipefail
python scripts/ci_sanity_forward_step.py --model sshleifer/tiny-gpt2 --seqLen 8 --layer 0 --pos 0 --take 16
4 changes: 0 additions & 4 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,13 +1,9 @@
/.lake
models
*.nfpt
!tests/fixtures/*.nfpt
.DS_Store
logs/
sound_cache/
lean-reference-manual/
inductionhead_papers/
nfp.zip
reports/
tests/fixtures/tiny_sound_binary.nfpt
nfp_agent_book/
Loading