syntaxai/tdd.md · main · goals / v21-dialects-spec.md

v21-dialects-spec.md 19 lines · 1477 bytes raw · source

slug: v21-dialects-spec title: Draft three v2.1 dialects into §6 + profile-parser tolerance date: 2026-05-24 branch: sama-v2-1-dialects-drafted pr_number: 31 merge_sha: f244dbb status: lossy related_posts: [sama-v2-rust-project-ripgrep, sama-v2-go-project-dive]

Recovered opening (from prior-session conversation summary, paraphrased):

Goal: Promote the three v2.1 dialects (directory-layout, inline-tests, declarative-exemption) from "proposed in blog" to drafted §6 extensions in /sama/v2. The verifier still treats this repo bit-identically — opt-in profile flags only, no behavior change for non-adopters.

What is preserved from the original /goal: only the opening sentence above, recovered from the prior-session conversation summary at the start of this conversation. The full Done when clauses, Constraints (anti-fudge), and Load-bearing files sections did not survive summarization.

What landed: §6.A umbrella + §6.1/§6.2/§6.3 subsections in content/sama/v2.md, each with a 5-part structure (profile syntax / what it relaxes / property preserved / preservation mechanism / falsifiable cross-repo experiment). ProfileSpec gained optional layout, tests, atomicExemption fields with allowed-value validation in the TOML parser. 12 new parser tests landed; this repo's sama.profile.toml stayed unchanged so the §4 verifier's verdict was bit-identical. See PR #31 for the full diff.