docs(core): left-of-line page — captures, side-by-side, static snapshot (#1104) - #1124
docs(core): left-of-line page — captures, side-by-side, static snapshot (#1104)#1124lex00 wants to merge 7 commits into
Conversation
…t, committed captures (#1084) A CRUD items API (DynamoDB + Lambda + HTTP API + implied IAM) expressed twice: chant declarables and a plain-JS CDK app. One capture procedure profiles both synths with node --cpu-prof — the CDK side profiles the app subprocess via cdk.json, since profiling the CLI measures the wrong process — and one analyzer applies the same two measurements to both: - project-code boolean: did any frame from the estate's own source files execute? chant: false, doubly pinned (no sampled project frame + the run fails unless every file reports [fold:fold]). cdk: true. - trusted-computing-base bytes: distinct third-party files observed executing; the synthesizer/definition-library split falls out of each estate's package.json rather than a curated list. parity.mjs keeps the pair honest: identical resource surface, exactly two documented expansion-style deltas (both enlarge the CDK template), anything else fails. Captures are committed with machine-local path prefixes sanitized; timing appears in no output (not a benchmark). exhibits/render.mjs regenerates static timeline SVGs via spicypath's headless renderers: package-attributed colors, search-dim on project files, a derived marker at the first project frame — present near t=0 on the CDK exhibit, absent by construction on the chant one. On-demand via just leftness-capture; not part of gating CI. Closes #1084
…apshots (#1104) A Core Concepts page carrying the measured comparison from test/leftness: the one-question table (project code executed: chant no, cdk yes), the two static timeline exhibits (CDK lit with a first-project-frame marker near t=0; chant busy with an empty highlight and no frame to mark), boundary caveats stated (app-subprocess profiling, sampled-vs-enforced negative), and capability/delivery adjacency — the loomster reality sits in the same paragraph as the structural claim. Timing appears nowhere. Exhibits served from docs/public/leftness; regeneration procedure lives with the harness. Page publication is gated on the bar recorded on #1107, hence draft.
Each exhibit now links to the deployed viewer with the scenario encoded in URL state — Timeline mode, search highlight, and the first-project- frame marker restore on open. Both links validated in a real browser.
…1104) 'your code starts here' instead of a class name; the search-box preset is dropped — a viewer shouldn't need to know what ItemsStack means.
|
Status check, not a decision. This is a deliberate draft and merging it is the publish click recorded as a maintainer decision on #1107, so it stays as-is. Two things have moved since 2026-07-27. The stack is gone. #1120 merged, so the harness is out of this diff and what remains is the page. The gating measurement is stale. The bar on the PR body is stated against loomster's resource-bearing real src, and loomster is pinned to chant ^0.21.0 while chant is now 0.52.1. Fold has changed materially in between — call-form composite calls (#1174, #1965) and method-call folding after lexicon expression helpers (#1966), which took the chant corpus 89/108 to 95/108, now 97/111. Whether the bar is met cannot be read off the 0.21.0-era number either way. Re-measuring loomster on current chant is the prerequisite for the publish decision. Recorded here so the next person does not re-derive it. |
For #1104. Draft on purpose: publication is gated on the publish bar recorded on #1107 (real infrastructure folds everything except should-never-fold patterns; loomster's resource-bearing real src folds none today). Merging this is the maintainer's publish click.
Stacked on #1120 (the harness) — the last commit here is the page; the rest is the harness and disappears from the diff when #1120 merges.
AC check (#1104)
test/leftness/).docs/public/leftness/*.svg) — readable with no viewer; Timeline mode so left means before; search-dim + first-project-frame marker (spicypath FG-064/FG-065).Docs build green (148 pages).
🤖 Generated with Claude Code