Skip to content

Commit dcaebf5

Browse files
chaploudchaploud
committed
table, ascii chart formatting
1 parent a06e00c commit dcaebf5

34 files changed

Lines changed: 1388 additions & 1384 deletions

‎.dev/archive/cleanup-37.md‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,17 @@ Session-spanning tracking document. Read at session start if cleanup incomplete.
44

55
## Status
66

7-
| # | Task | Status | Notes |
8-
|---|-----------------------------------|---------|-------------------------------|
9-
| 1 | Benchmark code validity audit | DONE | Scripts + CW + multi-lang |
10-
| 2 | Benchmark execution verification | DONE | Fixed hyperfine redirection |
11-
| 3 | roadmap.md review/fix | DONE | 721→159 lines, all phases updated |
12-
| 4 | decisions.md review/prune | DONE | 86→25 entries (2126→349 lines) |
13-
| 5 | checklist.md review/prune | DONE | Removed F21, F24, F98 |
14-
| 6 | Merge optimization files | DONE | 1293+154→170 lines, refs updated |
15-
| 7 | plan/ directory consolidation | DONE | notes/+plan/ → flat .dev/ |
16-
| 8 | Top-level directory cleanup | DONE | scripts/examples/docs → .dev/, .gitkeep全削除 |
17-
| 10| Path reference integrity check | DONE | 21 refs fixed across 12 files |
7+
| # | Task | Status | Notes |
8+
|----|----------------------------------|--------|-----------------------------------------------|
9+
| 1 | Benchmark code validity audit | DONE | Scripts + CW + multi-lang |
10+
| 2 | Benchmark execution verification | DONE | Fixed hyperfine redirection |
11+
| 3 | roadmap.md review/fix | DONE | 721→159 lines, all phases updated |
12+
| 4 | decisions.md review/prune | DONE | 86→25 entries (2126→349 lines) |
13+
| 5 | checklist.md review/prune | DONE | Removed F21, F24, F98 |
14+
| 6 | Merge optimization files | DONE | 1293+154→170 lines, refs updated |
15+
| 7 | plan/ directory consolidation | DONE | notes/+plan/ → flat .dev/ |
16+
| 8 | Top-level directory cleanup | DONE | scripts/examples/docs → .dev/, .gitkeep全削除 |
17+
| 10 | Path reference integrity check | DONE | 21 refs fixed across 12 files |
1818

1919
## Directory Reorganization Plan
2020

@@ -40,13 +40,13 @@ README.md # (keep)
4040

4141
### Moves/Deletions
4242

43-
| Item | Action | Reason |
44-
|---------------|---------------------------|---------------------------------|
45-
| check_size.o | DELETE | Empty build artifact, *.o in gitignore |
46-
| scripts/ | Move to .dev/scripts/ | Tooling, not user-facing |
47-
| examples/ | Move to .dev/examples/ | Wasm examples, dev reference |
48-
| docs/ | Move to .dev/docs/ | Internal dev docs, not user docs|
49-
| private/ | KEEP (gitignored) | User workspace |
43+
| Item | Action | Reason |
44+
|--------------|------------------------|----------------------------------------|
45+
| check_size.o | DELETE | Empty build artifact, *.o in gitignore |
46+
| scripts/ | Move to .dev/scripts/ | Tooling, not user-facing |
47+
| examples/ | Move to .dev/examples/ | Wasm examples, dev reference |
48+
| docs/ | Move to .dev/docs/ | Internal dev docs, not user docs |
49+
| private/ | KEEP (gitignored) | User workspace |
5050

5151
### bench/ reorganization
5252

‎.dev/archive/file-size-audit.md‎

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,27 +6,27 @@ Total: 41,572 lines across 49 Zig files. Phase 27 target: split files > 2000L.
66

77
### Split candidates (> 2000L) — Phase 27
88

9-
| Lines | File | Split strategy |
10-
|------:|------------------------------|---------------------------------------------------------|
11-
| 3,696 | builtin/collections.zig | Extract HAMT to collections_hamt.zig, fused reduce to reduce.zig |
12-
| 3,353 | bootstrap.zig | Extract hot_core_defs, callFnVal dispatch, clj evaluation |
13-
| 2,800 | analyzer/analyzer.zig | Extract special form handlers, destructuring |
14-
| 2,335 | eval_engine.zig | Tests are ~70% of file; extract to eval_engine_test.zig |
15-
| 2,290 | native/vm/vm.zig | Extract performCall dispatch, arithmetic helpers |
9+
| Lines | File | Split strategy |
10+
|------:|-------------------------|------------------------------------------------------------------|
11+
| 3,696 | builtin/collections.zig | Extract HAMT to collections_hamt.zig, fused reduce to reduce.zig |
12+
| 3,353 | bootstrap.zig | Extract hot_core_defs, callFnVal dispatch, clj evaluation |
13+
| 2,800 | analyzer/analyzer.zig | Extract special form handlers, destructuring |
14+
| 2,335 | eval_engine.zig | Tests are ~70% of file; extract to eval_engine_test.zig |
15+
| 2,290 | native/vm/vm.zig | Extract performCall dispatch, arithmetic helpers |
1616

1717
### Monitor (1000-2000L) — no action needed
1818

19-
| Lines | File | Notes |
20-
|------:|------------------------------|-----------------------------------|
19+
| Lines | File | Notes |
20+
|------:|--------------------------------|-----------------------------------|
2121
| 1,713 | native/evaluator/tree_walk.zig | Manageable, single-responsibility |
22-
| 1,601 | common/value.zig | Type definitions + formatValue |
23-
| 1,592 | common/gc.zig | MarkSweepGc + tracing |
24-
| 1,196 | repl/nrepl.zig | nREPL server |
25-
| 1,174 | bytecode/compiler.zig | Compiler + emit methods |
26-
| 1,167 | reader/reader.zig | Reader |
27-
| 1,132 | builtin/ns_ops.zig | Namespace operations |
28-
| 1,081 | builtin/sequences.zig | Fused reduce + seq ops |
29-
| 1,050 | common/collections.zig | PersistentList/Vector/HashMap |
22+
| 1,601 | common/value.zig | Type definitions + formatValue |
23+
| 1,592 | common/gc.zig | MarkSweepGc + tracing |
24+
| 1,196 | repl/nrepl.zig | nREPL server |
25+
| 1,174 | bytecode/compiler.zig | Compiler + emit methods |
26+
| 1,167 | reader/reader.zig | Reader |
27+
| 1,132 | builtin/ns_ops.zig | Namespace operations |
28+
| 1,081 | builtin/sequences.zig | Fused reduce + seq ops |
29+
| 1,050 | common/collections.zig | PersistentList/Vector/HashMap |
3030

3131
### Small (< 1000L) — 35 files, no action needed
3232

‎.dev/archive/foundation-reset.md‎

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,17 @@ appropriate notes. Currently ~269 vars have no note.
1515

1616
**Batches** (1 batch = 1 commit):
1717

18-
| Batch | Target | Est. | Method |
19-
|-------|-------------------------|------|----------------------------------|
20-
| A1 | Special Forms | 16 | analyzer.zig handlers |
21-
| A2 | Arithmetic & Comparison | 20 | arithmetic.zig + numeric.zig |
22-
| A3 | Collection Operations | 80 | sequences.zig + collections.zig |
23-
| A4 | String Operations | 15 | strings.zig + clj_string.zig |
24-
| A5 | Predicates | 30 | predicates.zig |
25-
| A6 | Macros (core.clj) | 17 | core.clj vs upstream core.clj |
26-
| A7 | HOF & Lazy Sequences | 40 | core.clj + sequences.zig |
27-
| A8 | State & Concurrency | 10 | atom.zig + volatile etc |
28-
| A9 | Remaining | 50 | various builtins |
18+
| Batch | Target | Est. | Method |
19+
|-------|-------------------------|------|---------------------------------|
20+
| A1 | Special Forms | 16 | analyzer.zig handlers |
21+
| A2 | Arithmetic & Comparison | 20 | arithmetic.zig + numeric.zig |
22+
| A3 | Collection Operations | 80 | sequences.zig + collections.zig |
23+
| A4 | String Operations | 15 | strings.zig + clj_string.zig |
24+
| A5 | Predicates | 30 | predicates.zig |
25+
| A6 | Macros (core.clj) | 17 | core.clj vs upstream core.clj |
26+
| A7 | HOF & Lazy Sequences | 40 | core.clj + sequences.zig |
27+
| A8 | State & Concurrency | 10 | atom.zig + volatile etc |
28+
| A9 | Remaining | 50 | various builtins |
2929

3030
**Per-var procedure**:
3131
1. Check upstream Clojure source
@@ -61,11 +61,11 @@ Location: test.clj:5:1
6161
to threadlocal — same pattern as Beta. This eliminates error info loss
6262
when errors propagate across scope boundaries.
6363

64-
| Task | Description | Files | Sites | Est. commits |
65-
|------|---------------------------------------|-------------------|-------|-------------|
66-
| BE1 | Threadlocal infrastructure + display | error.zig, main.zig, bootstrap.zig, analyzer.zig, reader.zig, env.zig, nrepl.zig, eval.zig | ~30 | 2-3 |
67-
| BE2 | Builtin error messages | 17 builtin/*.zig | ~314 | 4-5 |
68-
| BE3 | Runtime source location propagation | vm.zig, tree_walk.zig | ~27 | 2-3 |
64+
| Task | Description | Files | Sites | Est. commits |
65+
|------|--------------------------------------|--------------------------------------------------------------------------------------------|-------|--------------|
66+
| BE1 | Threadlocal infrastructure + display | error.zig, main.zig, bootstrap.zig, analyzer.zig, reader.zig, env.zig, nrepl.zig, eval.zig | ~30 | 2-3 |
67+
| BE2 | Builtin error messages | 17 builtin/*.zig | ~314 | 4-5 |
68+
| BE3 | Runtime source location propagation | vm.zig, tree_walk.zig | ~27 | 2-3 |
6969

7070
**BE1: Threadlocal infrastructure + display** (2-3 commits)
7171
- `error.zig`: Add threadlocal `last_error`, `source_text`, convenience
@@ -121,10 +121,10 @@ CLJW-SKIP → implement → unblock → commit.
121121

122122
## Reference Files
123123

124-
| File | Purpose |
125-
|-----------------------------------------|--------------------------------|
126-
| `.dev/memo.md` | Session handover |
127-
| `.dev/status/audit-progress.yaml` | Audit progress tracker |
128-
| `.claude/rules/test-porting.md` | Test porting rules (auto-load) |
129-
| `.claude/references/interop-patterns.md`| Java→CW pattern mapping |
130-
| `.dev/checklist.md` | Deferred items (F##) |
124+
| File | Purpose |
125+
|------------------------------------------|--------------------------------|
126+
| `.dev/memo.md` | Session handover |
127+
| `.dev/status/audit-progress.yaml` | Audit progress tracker |
128+
| `.claude/rules/test-porting.md` | Test porting rules (auto-load) |
129+
| `.claude/references/interop-patterns.md` | Java→CW pattern mapping |
130+
| `.dev/checklist.md` | Deferred items (F##) |

‎.dev/archive/mutable-state-audit.md‎

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -5,41 +5,41 @@ Catalog of all module-level `var` and `threadlocal var` declarations.
55

66
## Non-threadlocal vars (20)
77

8-
| # | File | Line | Variable | Purpose |
9-
|---|---------------------------|------|-------------------------|----------------------------------|
10-
| 1 | main.zig | 441 | file_read_buf | Error report file read buffer |
11-
| 2 | value.zig | 31 | print_length_var | *print-length* Var cache |
12-
| 3 | value.zig | 32 | print_level_var | *print-level* Var cache |
13-
| 4 | var.zig | 136 | current_frame | Binding frame stack (GC root) |
14-
| 5 | keyword_intern.zig | 12 | table | Keyword intern table |
15-
| 6 | keyword_intern.zig | 13 | intern_allocator | Keyword intern allocator |
16-
| 7 | collections.zig | 20 | _vec_gen_counter | Vector COW generation counter |
17-
| 8 | bootstrap.zig | 680 | last_thrown_exception | Last thrown exception (catch) |
18-
| 9 | bootstrap.zig | 707 | macro_eval_env | Macro evaluation environment |
19-
|10 | builtin/ns_ops.zig | 21 | load_paths | Namespace load paths |
20-
|11 | builtin/ns_ops.zig | 25 | loaded_libs | Loaded libs tracking set |
21-
|12 | builtin/ns_ops.zig | 26 | loaded_libs_allocator | Loaded libs allocator |
22-
|13 | builtin/predicates.zig | 17 | current_env | Current Env ptr for predicates |
23-
|14 | builtin/io.zig | 22 | capture_buf | Output capture buffer |
24-
|15 | builtin/io.zig | 23 | capture_alloc | Output capture allocator |
25-
|16 | builtin/io.zig | 157 | capture_stack | Nested capture stack |
26-
|17 | builtin/io.zig | 158 | capture_depth | Capture nesting depth |
27-
|18 | builtin/misc.zig | 18 | gensym_counter | gensym unique counter |
28-
|19 | builtin/numeric.zig | 85 | prng | Random number generator state |
29-
|20 | native/vm/vm.zig | 83 | active_vm | Active VM for callback bridge |
8+
| # | File | Line | Variable | Purpose |
9+
|----|------------------------|------|-----------------------|--------------------------------|
10+
| 1 | main.zig | 441 | file_read_buf | Error report file read buffer |
11+
| 2 | value.zig | 31 | print_length_var | *print-length* Var cache |
12+
| 3 | value.zig | 32 | print_level_var | *print-level* Var cache |
13+
| 4 | var.zig | 136 | current_frame | Binding frame stack (GC root) |
14+
| 5 | keyword_intern.zig | 12 | table | Keyword intern table |
15+
| 6 | keyword_intern.zig | 13 | intern_allocator | Keyword intern allocator |
16+
| 7 | collections.zig | 20 | _vec_gen_counter | Vector COW generation counter |
17+
| 8 | bootstrap.zig | 680 | last_thrown_exception | Last thrown exception (catch) |
18+
| 9 | bootstrap.zig | 707 | macro_eval_env | Macro evaluation environment |
19+
| 10 | builtin/ns_ops.zig | 21 | load_paths | Namespace load paths |
20+
| 11 | builtin/ns_ops.zig | 25 | loaded_libs | Loaded libs tracking set |
21+
| 12 | builtin/ns_ops.zig | 26 | loaded_libs_allocator | Loaded libs allocator |
22+
| 13 | builtin/predicates.zig | 17 | current_env | Current Env ptr for predicates |
23+
| 14 | builtin/io.zig | 22 | capture_buf | Output capture buffer |
24+
| 15 | builtin/io.zig | 23 | capture_alloc | Output capture allocator |
25+
| 16 | builtin/io.zig | 157 | capture_stack | Nested capture stack |
26+
| 17 | builtin/io.zig | 158 | capture_depth | Capture nesting depth |
27+
| 18 | builtin/misc.zig | 18 | gensym_counter | gensym unique counter |
28+
| 19 | builtin/numeric.zig | 85 | prng | Random number generator state |
29+
| 20 | native/vm/vm.zig | 83 | active_vm | Active VM for callback bridge |
3030

3131
## Threadlocal vars (8)
3232

33-
| # | File | Line | Variable | Purpose |
34-
|---|---------------------------|------|-------------------------|----------------------------------|
35-
| 1 | value.zig | 33 | print_depth | Recursive print depth tracker |
36-
| 2 | value.zig | 34 | print_allocator | Print-time allocator |
37-
| 3 | value.zig | 35 | print_readably | *print-readably* flag |
38-
| 4 | error.zig | 72 | last_error | Last error info |
39-
| 5 | error.zig | 73 | msg_buf | Error message buffer |
40-
| 6 | error.zig | 74 | source_text_cache | Source text for error reporting |
41-
| 7 | error.zig | 75 | source_file_cache | Source file for error reporting |
42-
| 8 | error.zig | 139 | arg_sources | Argument source location cache |
33+
| # | File | Line | Variable | Purpose |
34+
|---|-----------|------|-------------------|---------------------------------|
35+
| 1 | value.zig | 33 | print_depth | Recursive print depth tracker |
36+
| 2 | value.zig | 34 | print_allocator | Print-time allocator |
37+
| 3 | value.zig | 35 | print_readably | *print-readably* flag |
38+
| 4 | error.zig | 72 | last_error | Last error info |
39+
| 5 | error.zig | 73 | msg_buf | Error message buffer |
40+
| 6 | error.zig | 74 | source_text_cache | Source text for error reporting |
41+
| 7 | error.zig | 75 | source_file_cache | Source file for error reporting |
42+
| 8 | error.zig | 139 | arg_sources | Argument source location cache |
4343

4444
## Categories
4545

‎.dev/archive/phase-cx-plan.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,18 +11,18 @@ These items are already understood and implementable with current infrastructure
1111

1212
Read these files before starting implementation:
1313

14-
| Reference | Purpose |
15-
|----------------------------------------|---------------------------------------------|
16-
| `.dev/checklist.md` | F## item definitions and triggers |
17-
| `.dev/status/vars.yaml` | Var status tracking (update after each fix) |
18-
| `.claude/rules/test-porting.md` | Test change rules (CLJW markers etc.) |
19-
| `.claude/references/interop-patterns.md` | Java interop translation patterns |
20-
| `.claude/references/impl-tiers.md` | Implementation tier guide |
21-
| `src/common/analyzer/analyzer.zig` | Analyzer (F68, F70-74, F81, F87, F89) |
22-
| `src/common/value.zig` | Value types (F91 delay variant) |
23-
| `src/common/builtin/predicates.zig` | Predicate builtins (F86, F91) |
24-
| `src/common/builtin/multimethods.zig` | Multimethod builtins (F82, F83) |
25-
| `src/clj/clojure/core.clj` | Core macros/fns (F82, F91, F94) |
14+
| Reference | Purpose |
15+
|------------------------------------------|---------------------------------------------|
16+
| `.dev/checklist.md` | F## item definitions and triggers |
17+
| `.dev/status/vars.yaml` | Var status tracking (update after each fix) |
18+
| `.claude/rules/test-porting.md` | Test change rules (CLJW markers etc.) |
19+
| `.claude/references/interop-patterns.md` | Java interop translation patterns |
20+
| `.claude/references/impl-tiers.md` | Implementation tier guide |
21+
| `src/common/analyzer/analyzer.zig` | Analyzer (F68, F70-74, F81, F87, F89) |
22+
| `src/common/value.zig` | Value types (F91 delay variant) |
23+
| `src/common/builtin/predicates.zig` | Predicate builtins (F86, F91) |
24+
| `src/common/builtin/multimethods.zig` | Multimethod builtins (F82, F83) |
25+
| `src/clj/clojure/core.clj` | Core macros/fns (F82, F91, F94) |
2626

2727
Beta reference for delay type:
2828
- `ClojureWasmBeta/src/lib/core/concurrency.zig` (Delay struct, force, realized?)

0 commit comments

Comments
 (0)