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
|
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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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,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,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
|
||||||
|
|||||||
@@ -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,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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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)
|
||||||
|
|||||||
@@ -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.
|
||||||
Reference in new issue
Block a user