docs-frontmatter-cleanup: the 11 invalid last_updated frontmatter scalars quoted — double-quote convention applied uniformly (one escaped quote in phase-0.md), annotation prose verbatim; PyYAML sweep over docs/**/*.md + tasks/*.md reports 0 failures, taskgraph validate green (79 tasks); task status -> completed with Notes (recorded sweep command, date-scalar caveat) + Summary

This commit is contained in:
glm-5.3-flash committed 2026-10-10 23:49:08 +00:00
1 parent 9e069ced59
commit 2cb9301a4f
12 files changed
+71 -26

No files matched your search

+2 -2
View File
@@ -1,8 +1,8 @@
--- ---
status: draft 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 engine — engine-mem.md added, ADR table row, index updated for the
implementation phase) implementation phase)"
--- ---
# alkstore — Architecture # alkstore — Architecture
+2 -2
View File
@@ -1,8 +1,8 @@
--- ---
status: draft 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 the Store concept prose admits the engine-native constructor
exception) exception)"
--- ---
# Core contract # Core contract
+2 -2
View File
@@ -1,7 +1,7 @@
--- ---
status: draft status: draft
last_updated: 2026-10-10 (ADR-024 — the mem engine joins the matrix: last_updated: "2026-10-10 (ADR-024 — the mem engine joins the matrix:
host row, connection budget, durability posture, wasm32 toolchain note) host row, connection budget, durability posture, wasm32 toolchain note)"
--- ---
# Deployment # Deployment
+2 -2
View File
@@ -1,13 +1,13 @@
--- ---
status: stable 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 conformance read clean — three edge-domain fixes landed inline (the
stream cursor read's `i64::MAX` overflow, `trim_to`'s horizon stream cursor read's `i64::MAX` overflow, `trim_to`'s horizon
endpoint, the scheduler register-time interval overflow now rejecting endpoint, the scheduler register-time interval overflow now rejecting
with `InvalidSpec` like the SQLite register) plus scaffold-residue with `InvalidSpec` like the SQLite register) plus scaffold-residue
cleanup; the third column's 25-row set green under the current-thread cleanup; the third column's 25-row set green under the current-thread
flavor; the wasm32 gate + feature subset verified; the rider's arms flavor; the wasm32 gate + feature subset verified; the rider's arms
verified) verified)"
--- ---
# Mem engine # Mem engine
+1 -1
View File
@@ -1,6 +1,6 @@
--- ---
status: stable 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 # Postgres engine
+1 -1
View File
@@ -1,6 +1,6 @@
--- ---
status: stable 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 # SQLite engine
+2 -2
View File
@@ -1,7 +1,7 @@
--- ---
status: draft status: draft
last_updated: 2026-10-10 (ADR-024 — the mem engine joins the crate last_updated: "2026-10-10 (ADR-024 — the mem engine joins the crate
family as `alkstore-mem`; family/ADR tables updated) family as `alkstore-mem`; family/ADR tables updated)"
--- ---
# alkstore — Overview # alkstore — Overview
+1 -1
View File
@@ -1,6 +1,6 @@
--- ---
status: draft 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 # Queues, scheduler, outbox — semantics depth
+2 -2
View File
@@ -1,10 +1,10 @@
--- ---
status: draft 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 task set: seven independent entry tasks incl. the frontmatter cleanup
and the renumber sweep, then matrix → README → publish prep → gate. and the renumber sweep, then matrix → README → publish prep → gate.
Waves 1–7 implemented + reviewed; Findings 2–3, the fired flake-watch 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 # alkstore — Implementation plan
+2 -2
View File
@@ -1,11 +1,11 @@
--- ---
status: draft 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 operator-authority record: wasm32 sandboxing + downstream
ffi/napi/python-adapter economics; the record the ADR-024 scope ffi/napi/python-adapter economics; the record the ADR-024 scope
decision cites per the row-first gate. Earlier: 2026-10-05 streams decision cites per the row-first gate. Earlier: 2026-10-05 streams
correction and alkcall row; rate-limits + result-storage remain the correction and alkcall row; rate-limits + result-storage remain the
keep-with-flag rows.) keep-with-flag rows.)"
--- ---
# alkstore — consumer-driven scope inventory # alkstore — consumer-driven scope inventory
+2 -2
View File
@@ -1,11 +1,11 @@
--- ---
status: draft 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 docs/architecture/ opened with ADR-001..007 carrying the resolved
decisions and the OQ tracker mirroring OQ-ST-01..08 1:1. Phase 0 decisions and the OQ tracker mirroring OQ-ST-01..08 1:1. Phase 0
research itself is closed; remaining work is in docs/architecture/ research itself is closed; remaining work is in docs/architecture/
open-questions.md. One erratum fixed in OQ-ST-04's tx-friction line — 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) # alkstore — Phase 0 (Exploration)
+52 -7
View File
@@ -1,7 +1,7 @@
--- ---
id: docs-frontmatter-cleanup id: docs-frontmatter-cleanup
name: Docs frontmatter cleanup — the 11 invalid YAML frontmatters name: Docs frontmatter cleanup — the 11 invalid YAML frontmatters
status: pending status: completed
depends_on: [] depends_on: []
scope: single scope: single
risk: trivial risk: trivial
@@ -47,12 +47,12 @@ check demands).
## Acceptance Criteria ## 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), scripted parse sweep over `docs/**/*.md` reports zero failures),
with the `last_updated` annotation prose preserved verbatim with the `last_updated` annotation prose preserved verbatim
- [ ] One quoting convention applied uniformly across the fixed files - [x] One quoting convention applied uniformly across the fixed files
- [ ] `taskgraph validate` still green; no `tasks/*.md` content changed - [x] `taskgraph validate` still green; no `tasks/*.md` content changed
- [ ] The parse sweep command recorded in Notes so future sessions can - [x] The parse sweep command recorded in Notes so future sessions can
re-run it re-run it
## References ## References
@@ -65,8 +65,53 @@ check demands).
## Notes ## 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 ## Summary
> To be filled on completion 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.