Hojun-Cho
d119b058a0
Adds rule 14 documenting the test target split. test-unit (~3.8s) is the inner-loop fast path; full make test (~8:30) is the bootstrap-correctness gate. Never push without test green. The skip set (950, 990-997) lives in test/run; new wwstage-driver tests added in that range automatically participate. Phase split background cited: ww_ww writes intermediates adjacent to traversed sources (task #15), so concurrent wwstage-driver tests would race.
3.5 KiB
3.5 KiB
- This is a project for ww programming language
- ww is a programming language aiming for Hare + CSP, no GC
- cmd/ is the C bootstrap toolchain (wcc frontend lib, w6c/w6a/w6l per-arch, ww driver); selfhost/ is the ww reimplementation
- All C code must strictly align with plan 9 coding style
- lib/ is the standard library; follow Hare APIs (signatures, layout, error idioms) — consult ref/hare/ before designing new modules. Package declaration form is Go-style explicit
package foo;and imports useimport foo;(executables declarepackage main;) per language design (rob-pike + plan-9 sensibility); lib/ API surface still mirrors Hare. - ref/hare and ref/plan9front are read-only references — consult before inventing data shapes or syntax
- No workarounds. If a bug forces a workaround, STOP and report with a precise repro. Document any retained divergence at the site with a pointer to the filed task. Never silent.
- Comments are WHY-only. Never narrate WHAT the code does — names carry the WHAT. Comment only non-obvious WHY: a constraint, a divergence from a reference, a citation to a filed task.
- Hare-fidelity over convenience. No ad-hoc extensions, renames, or convenience wrappers in lib/. Cite ref/hare// for every signature ported. Carve-out: the Hare
_unsafesuffix convention is dropped wholesale (ww is C/Plan-9-lineage, an unmanaged systems language — no GC, no "safe" baseline to be unsafe relative to). bytes→str is a pure reinterpret (strings.frombytes, renamed from Hare'sfromutf8_unsafe); validation is opt-in viautf8.validate(b)?at the IO source, never wrapped per-construction. Rationale: ref/hare/strings/utf8.ha:10,22 — the suffix flags Hare's managed-bytes-safety axis, which ww doesn't have. The honest name (frombytes) reservesfromutf8for a future true validating helper. - Symmetric stages. cstage and wwstage MUST emit byte-identical asm for the same input. When inference power differs, align the richer side DOWN to the leaner side, not the other way.
- Split commits when they bundle unrelated concerns. Bisect-cleanliness is the default. Multi-fix commits need a body paragraph explaining why they couldn't split.
- Simple data, simple algorithms. Sea-of-stars style. Mirror Hare's structural choices over clever alternatives.
- No hardcoded size literals in size-computation contexts. Always route through the type table (tinfo.size / Type.size / ty_*->size / size(T) / primtypesize / tyslicesize). Per Drew's framing of Hare's discipline.
make sizelintenforces and runs as a dep ofmake test. Exemptions documented inline with// sizelint-ok: <reason>(ww) or/* sizelint-ok: <reason> */(C). Optional local enforcement:ln -s ../../tools/sizelint .git/hooks/pre-commit. - Test targets. Inner-loop dev runs
make test-unit(~3.8s, skips wwstage-driver tests: 950, 990–997). Pre-commit / pre-push runs fullmake test(~8:30, all 132 incl. byte-id gates). Thetesttarget is the bootstrap-correctness gate — never push without it green. test-unit is a fast confidence check on unit-level code (stages, stdlib, smoke); a green test-unit doesn't prove bootstrap, only that the unit set is intact. Don't add new wwstage-driver tests outside the 950/990–997 range (the test/run skip set is keyed by NNN prefix). Phase split background: ww_ww writes intermediates next to every traversed source (filed bug), so concurrent wwstage-driver tests would race onselfhost/cmd/<tool>/main.{s,combined.ww,o}fixtures.