Files

T

rajamesandClaude Opus 5.5 a26f177ac6 docs(claude): trim .claude/CLAUDE.md; v3 and bare-metal notes load only where they apply

From /doctor's review: .claude/CLAUDE.md (40206 chars) was at the size
Claude Code warns about, and is read at the start of every session.
Now 30973.

Cut, as a session can read them from the tree itself: the Source Tree
listing, the boot-sequence diagram, "Key distinguishing features" and
License. The listing's two facts the code does not tell -- the stale
"M7: Not started" header in kernel_main.c, and virtio_blk.c not
meaning M9 is done -- are kept, as "Gotchas in the tree".

Moved, word for word, to files that load only when working there:
"Physics-Driven Adaptive Runtime" and "Critical Implementation
Details" to v3/CLAUDE.md; the superseded ACL-RWT DoE campaign
history to experiments/bare_metal/CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2

2026-11-06 15:55:37 +00:00

2.1 KiB

Raw Blame History

v3/CLAUDE.md -- loaded when working under v3/ (moved from .claude/CLAUDE.md, 2026-11-06)

Physics-Driven Adaptive Runtime

Uses thermodynamic metaphors as modeling language (see ONTOLOGY.md):

Loop #1 — Execution Heat (dictionary_heat_optimization.c) — frequency counter per word
Loop #2 — Rolling Window (rolling_window_of_truth.c) — circular buffer, execution history
Loop #3 — Linear Decay — quiescent words lose heat over time
Loop #4 — Pipelining (physics_pipelining_metrics.c) — word-to-word transition prediction
Loop #5 — Window Width Inference (inference_engine.c) — Levene's test, binary chop
Loop #6 — Decay Slope Inference (inference_engine.c) — exponential regression
Loop #7 — Adaptive Heartrate (HeartbeatState) — background tick coordinator

L8 Jacquard Mode Selector (ssm_jacquard.c) — a 128-state, 7-bit loop-gate selector. In this repo it now has a real per-VM heat channel into fleet-wide tuning (VM Fleet Attractor physics — see docs/working/architecture/VM-FLEET-ATTRACTOR-DESIGN-20260705.md), replacing hardcoded compudynamics constants with a dynamically-inferred rate.

Critical Implementation Details

DoE CSV Output Suppression

Intentionally suppressed as of 2025-12-08. See v3/src/main.c:390-396:

Metrics still collected via metrics_from_vm()
CSV row was redundant with internal VM metrics
To re-enable: add a --csv-export flag or write to a file

Heartbeat Instrumentation (Planned)

HeartbeatTickSnapshot and tick_buffer are declared in v3/include/vm.h, but heartbeat_export_csv() is not yet implemented.

Word Statistics Output

WORD-ENTROPY prints execution heat statistics to stdout. Kept enabled in DoE mode intentionally (diagnostic value outweighs noise cost).

StarKernel M7 Parity

parity.c logs every VM birth and execution with: VM ID, capsule hash, dictionary hash. This enables offline determinism verification — an independent system can load the same capsule and compare dict hashes. Zero-deviation means 0% algorithmic variance.

2.1 KiB Raw Blame History