fiddlerwoaroof/improvise
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: update design principles and repo map after test audit

Browse Source 
- Add virtual category boundary rule: use regular_category_names() for
  user-facing logic, never expose _Index/_Dim
- Document formula tokenizer keyword-aware identifier breaking
- Update repo-map test counts (356 → 510) and add regular_category_names

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Edward Langley
2026-04-08 23:44:25 -07:00
parent 96d783a1c5
commit 09df7bf181
2 changed files with 24 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
context/repo-map.md
View File

@ -95,7 +95,8 @@ pub struct Model {
// evaluate_aggregated(&self, key, none_cats) -> Option<CellValue> [sums over hidden dims]
// add_formula(&mut self, formula: Formula) [replaces same target+category]
// remove_formula(&mut self, target, category)
// category_names(&self) -> impl Iterator<Item = &str>
// category_names(&self) -> Vec<&str> [includes virtual]
// regular_category_names(&self) -> Vec<&str> [excludes _Index, _Dim]
const MAX_CATEGORIES: usize = 12; // virtual categories don't count
```
@ -353,7 +354,7 @@ Lines / tests / path — grouped by layer.
### Formula layer
```
461 / 8t formula/parser.rs Recursive descent parser → Formula AST
461 / 29t formula/parser.rs Recursive descent parser → Formula AST
77 / 0t formula/ast.rs Expr, BinOp, AggFunc, Formula, Filter (data only)
5 / 0t formula/mod.rs
```
@ -368,7 +369,7 @@ Lines / tests / path — grouped by layer.
### Command layer
```
3373 / 21t command/cmd.rs Cmd trait, CmdContext, CmdRegistry, 40+ commands
3373 / 74t command/cmd.rs Cmd trait, CmdContext, CmdRegistry, 40+ commands
1068 / 22t command/keymap.rs KeyPattern, Binding, Keymap, ModeKey, 14 mode keymaps
236 / 19t command/parse.rs Script/command-line parser (prefix syntax)
12 / 0t command/mod.rs
@ -376,7 +377,7 @@ Lines / tests / path — grouped by layer.
### UI layer
```
942 / 0t ui/effect.rs Effect trait, 50+ effect types (all state mutations)
942 / 41t ui/effect.rs Effect trait, 50+ effect types (all state mutations)
914 / 30t ui/app.rs App state, AppMode (15 variants), handle_key, autosave
1036 / 13t ui/grid.rs GridWidget (ratatui), col widths, rendering
617 / 0t ui/help.rs 5-page help overlay, HELP_PAGE_COUNT=5
@ -393,7 +394,7 @@ Lines / tests / path — grouped by layer.
### Import layer
```
773 / 15t import/wizard.rs ImportPipeline + ImportWizard
773 / 38t import/wizard.rs ImportPipeline + ImportWizard
292 / 9t import/analyzer.rs Field kind detection (Category/Measure/Time/Skip)
244 / 8t import/csv_parser.rs CSV parsing, multi-file merge
3 / 0t import/mod.rs
@ -404,7 +405,7 @@ Lines / tests / path — grouped by layer.
400 / 0t draw.rs TUI event loop (run_tui), frame composition
391 / 0t main.rs CLI entry (clap): open, import, cmd, script
228 / 29t format.rs Number display formatting (view-only rounding)
806 / 22t persistence/mod.rs .improv save/load (markdown format + gzip + legacy JSON)
806 / 38t persistence/mod.rs .improv save/load (markdown format + gzip + legacy JSON)
```
### Context docs
@ -415,7 +416,7 @@ context/plan.md Show HN launch plan
context/repo-map.md This file
```
**Total: ~15,875 lines, 356 tests.**
**Total: ~16,500 lines, 510 tests.**
---