Clear ten of the #78 grandfathering entries: the doc splits, the development.md move, and every small comment block #82

New issue

Closed

opened 2026-08-14 02:56:56 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-08-14 02:56:56 +00:00

Member

First tranche of #78, scoped to the entries that are unambiguous debt. The remaining entries split into "still real work" and "not debt at all" - recorded on #78 rather than here.

Documentation layout

Caps measured against the live config: 80 lines and 4000 chars per Markdown file.

docs/galaxy-rust.md was 89 lines / 16059 chars. Split into an index plus sim-constants.md, scenarios.md, gas-forces.md, stellar-model.md, black-hole.md. Prose moves verbatim; the index keeps layout, hot path, and buffers, and links the rest.
docs/processes-events.md was 64 lines / 8461 chars, with the causal-loop section alone at 5052. Split into the registry/queue/RNG/determinism core plus causal-loop.md and lifecycle-chains.md.
development.md moved to docs/development.md - it failed the root-Markdown-filename rule, not a size cap - and every reference updated (AGENTS.md, docs/FEATURES.md, docs/ward-config.md, both config files).

docs/FEATURES.md sat at 3998 chars and the new link pushed it to 4011, so its intro lost four words.

Code comments

Seventeen over-long blocks across seven files, compressed to the two-line cap with the detail relocated rather than deleted. docs/tick-worker.md gains a "Flat layouts" section carrying the star, render-packing, and event field orders that were living in doc comments - which also corrects that doc, whose snapshot description listed four star render fields against the real seven.

Cleared: src/js/lib/application.tsx, src/js/lib/galaxy.ts, src/js/lib/tick-worker.ts, src/rust/events.rs, src/rust/stars.rs, src/rust/process.rs, playwright.config.ts.

Method note

#78's warning held. The four YAML entries in pyproject.toml look like duplicates of the same paths in .agentic-os.toml, but removing them turns the suite red - 13 violations in categories.yaml, 4 in action.yml, 3 in .pre-commit-config.yaml, 1 in trufflehog.yml. The two config files do not merge the way the duplication suggests. Left in place.

Done when

Ten entries gone from pyproject.toml (three documentation-layout, seven code-comments), plus development.md from .agentic-os.toml.
ward exec precommit green, 91 Rust tests green, ward exec check-js green.

First tranche of #78, scoped to the entries that are unambiguous debt. The remaining entries split into "still real work" and "not debt at all" - recorded on #78 rather than here. ## Documentation layout Caps measured against the live config: **80 lines and 4000 chars** per Markdown file. * `docs/galaxy-rust.md` was 89 lines / 16059 chars. Split into an index plus `sim-constants.md`, `scenarios.md`, `gas-forces.md`, `stellar-model.md`, `black-hole.md`. Prose moves verbatim; the index keeps layout, hot path, and buffers, and links the rest. * `docs/processes-events.md` was 64 lines / 8461 chars, with the causal-loop section alone at 5052. Split into the registry/queue/RNG/determinism core plus `causal-loop.md` and `lifecycle-chains.md`. * `development.md` moved to `docs/development.md` - it failed the root-Markdown-filename rule, not a size cap - and every reference updated (`AGENTS.md`, `docs/FEATURES.md`, `docs/ward-config.md`, both config files). `docs/FEATURES.md` sat at 3998 chars and the new link pushed it to 4011, so its intro lost four words. ## Code comments Seventeen over-long blocks across seven files, compressed to the two-line cap with the detail relocated rather than deleted. `docs/tick-worker.md` gains a "Flat layouts" section carrying the star, render-packing, and event field orders that were living in doc comments - which also corrects that doc, whose snapshot description listed four star render fields against the real seven. Cleared: `src/js/lib/application.tsx`, `src/js/lib/galaxy.ts`, `src/js/lib/tick-worker.ts`, `src/rust/events.rs`, `src/rust/stars.rs`, `src/rust/process.rs`, `playwright.config.ts`. ## Method note #78's warning held. The four YAML entries in `pyproject.toml` look like duplicates of the same paths in `.agentic-os.toml`, but removing them turns the suite red - 13 violations in `categories.yaml`, 4 in `action.yml`, 3 in `.pre-commit-config.yaml`, 1 in `trufflehog.yml`. The two config files do not merge the way the duplication suggests. Left in place. ## Done when - [x] Ten entries gone from `pyproject.toml` (three documentation-layout, seven code-comments), plus `development.md` from `.agentic-os.toml`. - [x] `ward exec precommit` green, 91 Rust tests green, `ward exec check-js` green.

coilyco-ops referenced this issue from a commit

2026-08-14 02:57:24 +00:00

docs: split the oversized docs and clear ten grandfathered excludes

coilyco-ops closed this issue

2026-08-14 02:57:24 +00:00

coilyco-ops referenced this issue

2026-08-14 02:57:59 +00:00

The #46 grandfathering is still in place: all 25 excludes are load-bearing #78

coilyco-ops referenced this issue

2026-08-14 03:05:40 +00:00

The #46 grandfathering is still in place: all 25 excludes are load-bearing #78