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:
1 parent
9e069ced59
commit
2cb9301a4f
12 files changed
+71
-26
No files matched your search
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
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.
|
||||
Reference in new issue
Block a user