From 2cb9301a4fd04dd4f32e23444b178ba1c333d1f6 Mon Sep 17 00:00:00 2001 From: "glm-5.3-flash" Date: Sat, 10 Oct 2026 23:49:08 +0000 Subject: [PATCH] =?UTF-8?q?docs-frontmatter-cleanup:=20the=2011=20invalid?= =?UTF-8?q?=20last=5Fupdated=20frontmatter=20scalars=20quoted=20=E2=80=94?= =?UTF-8?q?=20double-quote=20convention=20applied=20uniformly=20(one=20esc?= =?UTF-8?q?aped=20quote=20in=20phase-0.md),=20annotation=20prose=20verbati?= =?UTF-8?q?m;=20PyYAML=20sweep=20over=20docs/**/*.md=20+=20tasks/*.md=20re?= =?UTF-8?q?ports=200=20failures,=20taskgraph=20validate=20green=20(79=20ta?= =?UTF-8?q?sks);=20task=20status=20->=20completed=20with=20Notes=20(record?= =?UTF-8?q?ed=20sweep=20command,=20date-scalar=20caveat)=20+=20Summary?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/README.md | 4 +- docs/architecture/core-contract.md | 4 +- docs/architecture/deployment.md | 4 +- docs/architecture/engine-mem.md | 4 +- docs/architecture/engine-postgres.md | 2 +- docs/architecture/engine-sqlite.md | 2 +- docs/architecture/overview.md | 4 +- docs/architecture/queues.md | 2 +- docs/plans/implementation.md | 4 +- docs/research/consumer-inventory.md | 4 +- docs/research/phase-0.md | 4 +- tasks/docs-frontmatter-cleanup.md | 59 ++++++++++++++++++++++++---- 12 files changed, 71 insertions(+), 26 deletions(-) diff --git a/docs/architecture/README.md b/docs/architecture/README.md index 7278e0f..e45db88 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -1,8 +1,8 @@ --- status: draft -last_updated: 2026-10-10 (ADR-024: the mem engine adopted as a third +last_updated: "2026-10-10 (ADR-024: the mem engine adopted as a third engine — engine-mem.md added, ADR table row, index updated for the -implementation phase) +implementation phase)" --- # alkstore — Architecture diff --git a/docs/architecture/core-contract.md b/docs/architecture/core-contract.md index 0b2165e..8fa3931 100644 --- a/docs/architecture/core-contract.md +++ b/docs/architecture/core-contract.md @@ -1,8 +1,8 @@ --- status: draft -last_updated: 2026-10-10 (ADR-024 — the mem engine joins the family; +last_updated: "2026-10-10 (ADR-024 — the mem engine joins the family; the Store concept prose admits the engine-native constructor -exception) +exception)" --- # Core contract diff --git a/docs/architecture/deployment.md b/docs/architecture/deployment.md index bc7a931..adc4d7b 100644 --- a/docs/architecture/deployment.md +++ b/docs/architecture/deployment.md @@ -1,7 +1,7 @@ --- status: draft -last_updated: 2026-10-10 (ADR-024 — the mem engine joins the matrix: -host row, connection budget, durability posture, wasm32 toolchain note) +last_updated: "2026-10-10 (ADR-024 — the mem engine joins the matrix: +host row, connection budget, durability posture, wasm32 toolchain note)" --- # Deployment diff --git a/docs/architecture/engine-mem.md b/docs/architecture/engine-mem.md index 89860be..b5852b0 100644 --- a/docs/architecture/engine-mem.md +++ b/docs/architecture/engine-mem.md @@ -1,13 +1,13 @@ --- status: stable -last_updated: 2026-10-10 (the wave-6 review gate passed: the +last_updated: "2026-10-10 (the wave-6 review gate passed: the conformance read clean — three edge-domain fixes landed inline (the stream cursor read's `i64::MAX` overflow, `trim_to`'s horizon endpoint, the scheduler register-time interval overflow now rejecting with `InvalidSpec` like the SQLite register) plus scaffold-residue cleanup; the third column's 25-row set green under the current-thread flavor; the wasm32 gate + feature subset verified; the rider's arms -verified) +verified)" --- # Mem engine diff --git a/docs/architecture/engine-postgres.md b/docs/architecture/engine-postgres.md index 1a05abb..7c2d815 100644 --- a/docs/architecture/engine-postgres.md +++ b/docs/architecture/engine-postgres.md @@ -1,6 +1,6 @@ --- status: stable -last_updated: 2026-10-10 (review-wave-5 gate: the verification backlog fully discharged in the version-stamped contract suite, green against this engine; spec flipped draft → stable) +last_updated: "2026-10-10 (review-wave-5 gate: the verification backlog fully discharged in the version-stamped contract suite, green against this engine; spec flipped draft → stable)" --- # Postgres engine diff --git a/docs/architecture/engine-sqlite.md b/docs/architecture/engine-sqlite.md index bdfa4e1..121e5ee 100644 --- a/docs/architecture/engine-sqlite.md +++ b/docs/architecture/engine-sqlite.md @@ -1,6 +1,6 @@ --- status: stable -last_updated: 2026-10-10 (review-wave-5 gate: the verification backlog fully discharged in the version-stamped contract suite, green against this engine; spec flipped draft → stable) +last_updated: "2026-10-10 (review-wave-5 gate: the verification backlog fully discharged in the version-stamped contract suite, green against this engine; spec flipped draft → stable)" --- # SQLite engine diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md index e96e02a..da6769e 100644 --- a/docs/architecture/overview.md +++ b/docs/architecture/overview.md @@ -1,7 +1,7 @@ --- status: draft -last_updated: 2026-10-10 (ADR-024 — the mem engine joins the crate -family as `alkstore-mem`; family/ADR tables updated) +last_updated: "2026-10-10 (ADR-024 — the mem engine joins the crate +family as `alkstore-mem`; family/ADR tables updated)" --- # alkstore — Overview diff --git a/docs/architecture/queues.md b/docs/architecture/queues.md index 5b13900..2f018cc 100644 --- a/docs/architecture/queues.md +++ b/docs/architecture/queues.md @@ -1,6 +1,6 @@ --- status: draft -last_updated: 2026-10-07 (ADR-021 + third-round follow-through: handle-form sweep_expired, ack_batch predicate, opts types) +last_updated: "2026-10-07 (ADR-021 + third-round follow-through: handle-form sweep_expired, ack_batch predicate, opts types)" --- # Queues, scheduler, outbox — semantics depth diff --git a/docs/plans/implementation.md b/docs/plans/implementation.md index 1e7ba56..c3f2bfa 100644 --- a/docs/plans/implementation.md +++ b/docs/plans/implementation.md @@ -1,10 +1,10 @@ --- status: draft -last_updated: 2026-10-10 (wave 8 decomposed — the release-readiness +last_updated: "2026-10-10 (wave 8 decomposed — the release-readiness task set: seven independent entry tasks incl. the frontmatter cleanup and the renumber sweep, then matrix → README → publish prep → gate. Waves 1–7 implemented + reviewed; Findings 2–3, the fired flake-watch -trigger, and the class-1 window's last dispositions ride wave 8.) +trigger, and the class-1 window's last dispositions ride wave 8.)" --- # alkstore — Implementation plan diff --git a/docs/research/consumer-inventory.md b/docs/research/consumer-inventory.md index c5cc9a0..398adee 100644 --- a/docs/research/consumer-inventory.md +++ b/docs/research/consumer-inventory.md @@ -1,11 +1,11 @@ --- status: draft -last_updated: 2026-10-10 (mem-engine engine-tier row added — +last_updated: "2026-10-10 (mem-engine engine-tier row added — operator-authority record: wasm32 sandboxing + downstream ffi/napi/python-adapter economics; the record the ADR-024 scope decision cites per the row-first gate. Earlier: 2026-10-05 streams correction and alkcall row; rate-limits + result-storage remain the -keep-with-flag rows.) +keep-with-flag rows.)" --- # alkstore — consumer-driven scope inventory diff --git a/docs/research/phase-0.md b/docs/research/phase-0.md index 276858c..862de96 100644 --- a/docs/research/phase-0.md +++ b/docs/research/phase-0.md @@ -1,11 +1,11 @@ --- status: draft -last_updated: 2026-10-04 (Phase 0 complete and the register promoted: +last_updated: "2026-10-04 (Phase 0 complete and the register promoted: docs/architecture/ opened with ADR-001..007 carrying the resolved decisions and the OQ tracker mirroring OQ-ST-01..08 1:1. Phase 0 research itself is closed; remaining work is in docs/architecture/ open-questions.md. One erratum fixed in OQ-ST-04's tx-friction line — -thread-affinity is SQLite-side, previously garbled as "pg-side".) +thread-affinity is SQLite-side, previously garbled as \"pg-side\".)" --- # alkstore — Phase 0 (Exploration) diff --git a/tasks/docs-frontmatter-cleanup.md b/tasks/docs-frontmatter-cleanup.md index 6d9bb91..b31d2b0 100644 --- a/tasks/docs-frontmatter-cleanup.md +++ b/tasks/docs-frontmatter-cleanup.md @@ -1,7 +1,7 @@ --- id: docs-frontmatter-cleanup name: Docs frontmatter cleanup — the 11 invalid YAML frontmatters -status: pending +status: completed depends_on: [] scope: single risk: trivial @@ -47,12 +47,12 @@ check demands). ## Acceptance Criteria -- [ ] All 11 listed files' frontmatter parses as valid YAML (a +- [x] All 11 listed files' frontmatter parses as valid YAML (a scripted parse sweep over `docs/**/*.md` reports zero failures), with the `last_updated` annotation prose preserved verbatim -- [ ] One quoting convention applied uniformly across the fixed files -- [ ] `taskgraph validate` still green; no `tasks/*.md` content changed -- [ ] The parse sweep command recorded in Notes so future sessions can +- [x] One quoting convention applied uniformly across the fixed files +- [x] `taskgraph validate` still green; no `tasks/*.md` content changed +- [x] The parse sweep command recorded in Notes so future sessions can re-run it ## References @@ -65,8 +65,53 @@ check demands). ## Notes -> To be filled by implementation agent +- Quoting convention chosen: double quotes (`"`-quoted scalars). + Correction to the description's observation: `"`-escapes were not + "none observed" — phase-0.md's annotation contains `"pg-side"` in + double quotes. Double quotes still won on balance: one `\"` escape in + phase-0.md vs. `''` escaping at every apostrophe (`trim_to`'s, + `read`'s, `OQ-ST-04`'s across engine-mem.md and phase-0.md) under the + single-quote convention. Applied uniformly across all 11 files. +- Mechanic confirmed first with a PyYAML probe: a multi-line + double-quoted scalar folds line breaks to single spaces whether the + continuation lines sit at column 0 or indented — so the existing + column-0 wrapping was kept verbatim and no line rewrapping was needed. +- One caveat, not a defect: `tasks/*.md` frontmatters like + `last_updated: 2026-10-10` parse as YAML *date* scalars, not strings + — parse-valid, and per the task description tasks are untouched + beyond the parse check. +- Recorded sweep command (re-runnable; reports zero failures): + + ```python + # python3 - <<'EOF' + import yaml, glob, re + fail = 0 + for f in sorted(glob.glob('docs/**/*.md', recursive=True)) + \ + sorted(glob.glob('tasks/*.md')): + m = re.match(r'^---\n(.*?)\n---\n', open(f).read(), re.S) + if not m: + continue + try: + fm = yaml.safe_load(m.group(1)) + assert isinstance(fm, dict) + except yaml.YAMLError as e: + fail += 1 + print('FAIL:', f, '|', str(e).splitlines()[0]) + print('sweep failures:', fail) + # EOF + ``` + + (`---`/`---` lines are extracted before `safe_load`, as frontmatter + parsers like gray-matter do — feeding the raw file to `safe_load` + reports a spurious "single document" error because `---` is a + document-start marker.) ## Summary -> To be filled on completion \ No newline at end of file +Landed: the 11 listed docs' `last_updated` frontmatter values quoted as +double-quoted YAML scalars (annotation prose verbatim; only the three +quote/escape characters added — one `\"` in phase-0.md). Verified with +the recorded PyYAML sweep (0 failures across `docs/**/*.md` + +`tasks/*.md` frontmatter blocks), `status` fields untouched, and +`taskgraph validate` green (79 tasks). No crate code or `tasks/*.md` +content changed. \ No newline at end of file