diff --git a/documentation/notes/roadmap.md b/documentation/notes/roadmap.md index b1fc644..7a59aee 100644 --- a/documentation/notes/roadmap.md +++ b/documentation/notes/roadmap.md @@ -8,13 +8,13 @@ created: 1773889263552 ## Grooming Note -Groomed 2026-08-21 and updated 2026-08-31. This note now carries direction and arc-level backlog; the operational queue lives in [[wd.todo]] and [[wd.queues]]. Priority Queue items that verifiably landed were removed (git history keeps the old list): the weave orchestration refactor items (the seams now live in `src/runtime/weave/` — `request_normalization.ts`, `prepared_execution.ts`, `version_execution.ts`, `page_generation.ts`, `page_model_assembly.ts`, `artifact_loaders.ts`), the first general `import` planner/runtime/CLI surface (`weave import`), exact/`Working`/`LatestState` page-source resolution with first-pass fallback, the current-only `ResourcePageDefinition` slice, retirement of the `alice/index.html` special-case builders in favor of page models, Knop-local/inherited config resolution, and the delivered Stagecraft work in [[wa.completed.2026.2026-07-03_1332-stagecraft-weave-planner-generalization]]. Standing policy lines — `_knop/_page/page.ttl` staying mesh-local with extra-mesh content crossing an explicit import boundary, and `_knop/_assets` staying a local ahistorical support area — are settled decisions recorded on [[wa.cancelled.2026.2026-04-08_1545-resource-page-definition-and-sources]], not open work. Renderer-refresh direction is owned by [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]]. +Groomed 2026-08-21 and updated 2026-09-11. This note now carries direction and arc-level backlog; the operational queue lives in [[wd.todo]] and [[wd.queues]]. Priority Queue items that verifiably landed were removed (git history keeps the old list): the weave orchestration refactor items (the seams now live in `src/runtime/weave/` — `request_normalization.ts`, `prepared_execution.ts`, `version_execution.ts`, `page_generation.ts`, `page_model_assembly.ts`, `artifact_loaders.ts`), the first general `import` planner/runtime/CLI surface (`weave import`), exact/`Working`/`LatestState` page-source resolution with first-pass fallback, the current-only `ResourcePageDefinition` slice, retirement of the `alice/index.html` special-case builders in favor of page models, Knop-local/inherited config resolution, and the delivered Stagecraft work in [[wa.completed.2026.2026-07-03_1332-stagecraft-weave-planner-generalization]]. Standing policy lines — `_knop/_page/page.ttl` staying mesh-local with extra-mesh content crossing an explicit import boundary, and `_knop/_assets` staying a local ahistorical support area — are settled decisions recorded on [[wa.cancelled.2026.2026-04-08_1545-resource-page-definition-and-sources]], not open work. Renderer-refresh direction is owned by [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]]. -## Next Arc — Candidates (2026-08-21, pending ruling) +## Active And Candidate Arcs -1. **Remote resolution** — [[wa.task.2026.2026-05-20_2152-workingAccessUrl]]: let a mesh resolve current bytes for artifacts held elsewhere (e.g. a source ontology in another repository) over policy-gated HTTP(S), with digest-expectation fail-closed exactness. First concrete second-consumer signal 2026-08-21: another of Dave's projects may need a mesh targeting a remotely held ontology. No fetch path exists in `src/` yet; the `sfcfg` remote-policy shape still lives only in the SFLO decision log. -2. **Fingerprint verification** — [[wa.task.2026.2026-05-04-fingerprint-verification]]: the expected/observed digest separation (`c0daa57`) and canonical wire-form validation (in flight) make the operator-facing verify command a thin slice; best treated as the first bite of the remote/digest arc rather than its own arc. -3. **Markdown site pipeline** — [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]]: ten slices, slice 1 unblocked, packaging proven; the largest new-capability arc, currently queue 1. +1. **Markdown site pipeline — ACTIVE** — [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]]: packaging and the presentation substrate are proven; [[wa.task.2026.2026-09-11_1153-markdown-contract-safety-fixtures]] is queue item 1. +2. **Remote resolution** — [[wa.task.2026.2026-05-20_2152-workingAccessUrl]]: let a mesh resolve current bytes for artifacts held elsewhere (e.g. a source ontology in another repository) over policy-gated HTTP(S), with digest-expectation fail-closed exactness. First concrete second-consumer signal 2026-08-21: another of Dave's projects may need a mesh targeting a remotely held ontology. No fetch path exists in `src/` yet; the `sfcfg` remote-policy shape still lives only in the SFLO decision log. +3. **Fingerprint verification** — [[wa.task.2026.2026-05-04-fingerprint-verification]]: the expected/observed digest separation (`c0daa57`) and canonical wire-form validation make the operator-facing verify command a thin slice; best treated as the first bite of the remote/digest arc rather than its own arc. 4. **Append-only inventory migration** — [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]: named locators, progression correction, first-Knop, versioned first-payload, and [[wa.completed.2026.2026-08-31_2101-initial-versioned-mesh-support-inventory-append]] are delivered; legacy/raw MeshInventory disposition and Knop-local progression ownership remain. ## Completed Arc — Founding Capability Releases (released 2026-08-23) diff --git a/documentation/notes/wd.decision-log.md b/documentation/notes/wd.decision-log.md index f9fef52..5d331a0 100644 --- a/documentation/notes/wd.decision-log.md +++ b/documentation/notes/wd.decision-log.md @@ -34,10 +34,10 @@ Entries below the marker keep the older long form. They are historical and are n - 2026-08-22 — Multi-task delivery arcs use coordination plans with executable child tasks; plans never occupy READY and close under their own completed-plan/cancelled-plan lifecycle. → [[wd.plans-and-tasks]] - 2026-08-06 — Renaming a note no longer breaks anything that cited it: renames supersede rather than move, so old URLs keep resolving and every prior citation stays valid, including exact-state ones. → [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]] - 2026-08-06 — `weave supersede` records a rename; `weave rename` also moves the file. Weave cannot infer a rename, so it has to be told. → [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]] -- 2026-08-06 — Notes get readable URLs derived from their filename, with a durable `id` recorded so a rename can still be traced back. → [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]] +- 2026-08-06 — Notes get readable URLs derived from their filename, with a durable `id` recorded so a rename can still be traced back. → [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]] - 2026-08-06 — Published states can be corrected or removed, because PII exposure has to be fixable. Integrity checking therefore promises current byte-consistency, never immutability. → [[wa.task.2026.2026-05-04-fingerprint-verification]], [[wa.plan.2026.2026-05-17-append-onlyish-inventory]] - 2026-08-06 — Fingerprint verification and embedded RDF both wait for a real consumer instead of shipping on principle; each gap is real, neither is asked for. → [[wa.task.2026.2026-05-04-fingerprint-verification]], [[wa.task.2026.2026-06-12-rdfa-and-jsonld-support]] -- 2026-08-06 — The Markdown pipeline starts narrow: three wikilink forms, disabled links for missing targets, and conversation transcripts private unless opted in. → [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]] +- 2026-08-06 — The Markdown pipeline starts narrow: three wikilink forms, disabled links for missing targets, and conversation transcripts private unless opted in. → [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]] - 2026-08-06 — A superseded resource and its replacement each say so in their own file, so a reader of either one can follow the link without scanning the mesh. → [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]] - 2026-08-06 — A renamed resource records the exact state it continues from, so lineage stays precise even if the old resource is later corrected. → [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]] - 2026-08-06 — Renaming onto an occupied path is refused outright: that would be a merge, and merges are not a thing Weave does by accident. → [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]] diff --git a/documentation/notes/wd.maintenance.2026-09.md b/documentation/notes/wd.maintenance.2026-09.md new file mode 100644 index 0000000..9c4b904 --- /dev/null +++ b/documentation/notes/wd.maintenance.2026-09.md @@ -0,0 +1,9 @@ +--- +id: 4b60ee92-3e12-4cfb-9a7e-bc4de761410e +title: Maintenance 2026-09 +desc: 'Monthly maintenance log — mechanical groom stamps plus hand-logged maintenance acts (renames, queue hand-edits, closure sweeps)' +created: 1789152780000 +--- + +- 2026-09-11 — closed `wa.task.2026.2026-09-08_1846-repository-source-url-presentation` as [[wa.completed.2026.2026-09-08_1846-repository-source-url-presentation]] after PR #77 merged to Weave `main` at `226d819` +- 2026-09-11 — converted `wa.task.2026.2026-08-06_0854-markdown-site-pipeline` into [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]] under [[wd.plans-and-tasks]], cut [[wa.task.2026.2026-09-11_1153-markdown-contract-safety-fixtures]] as its first executable child, and repointed [[wd.queues]] diff --git a/documentation/notes/wd.queues.md b/documentation/notes/wd.queues.md index 0f08df8..3f70016 100644 --- a/documentation/notes/wd.queues.md +++ b/documentation/notes/wd.queues.md @@ -9,6 +9,6 @@ created: 1785606045924 This note is the READY slice, in order: a task enters when it is fireable and leaves at delivery; the backlog stays in [[wd.todo]], and open decisions for Dave live in [[wa.dave-court]] (archive vault, ungated). The sections below are SURFACES, not seats: the heading names who disposes of the item, not who is sitting somewhere waiting for it. One line per item: `N. [[wa.task…]] — `, ≤140 chars, no SHAs, status words, or percentages — if a line's truth can change without editing this file, it does not belong here. Writes go through `deno task queue` (add/pop/check/wake/groomed); reordering is a hand edit followed by `deno task queue check`. ## Kim — implementation -1. [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]] — packaging proof PROVEN; unified pipeline so Markdown artifacts render as pages +1. [[wa.task.2026.2026-09-11_1153-markdown-contract-safety-fixtures]] — close unsafe Markdown links and freeze the renderer/Dendron baseline ## Jimbo — planning diff --git a/documentation/notes/wd.read-in.jimbo.md b/documentation/notes/wd.read-in.jimbo.md index ff1c64b..b3a95f6 100644 --- a/documentation/notes/wd.read-in.jimbo.md +++ b/documentation/notes/wd.read-in.jimbo.md @@ -49,12 +49,12 @@ This note is the seating source for the Weave/sflo planning seat (Jimbo). Load i *The tier that rots — the only tier loaded in full text. If the stamp below is more than a few days old, verify against [[wd.todo]] and the latest release notes before trusting anything in this section.* -As of 2026-08-31: +As of 2026-09-11: - **Append-only inventory migration is active and ruled** — add-reference, extracted/current-only MeshInventory, current-only PageDefinition, current-shape extract/integrate, mesh-support page-only and initial-history growth, named locators, progression correction, first-Knop, and versioned first-payload are delivered under [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]. Legacy/raw MeshInventory disposition and Knop-local progression ownership remain. - **Stagecraft IRI initialization and founding releases are complete** — [[wa.completed-plan.2026.2026-08-22_1550-stagecraft-iri-initialization]] delivered the measured singular capability, and [[wa.completed-plan.2026.2026-08-23_0950-founding-capability-releases]] published SFLO v0.5.0 plus Weave/`weave-lib` v0.9.0. Select the next arc from the live queue/backlog rather than reopening the ruled-off batch branch without new evidence. - **v0.8.0 RELEASED 2026-08-21** — extracted-term batch weave, condition-specific planner diagnostics, inventory history-index correctness, exact digest/provenance corrections, and bounded page-generation memory are shipped. [[release-receipt.v0.8.0]] carries package, Stagecraft, npm, and GitHub receipts. -- **A markdown site pipeline is queue item 1 after the serial initial mesh-support append child closed.** A blind codex evaluation chose `unified`/`remark`/`rehype` over `markdown-it`, reversing a 2025-11-29 decision — both were right for their own scope, and the scope grew to a static site generator. Slice 2 packaging is proven: real Dendron markdown renders under Deno and real Node, byte-identical between them, at 242 MB for 1,467 documents. Slice 1 is unblocked by four rulings. Evidence branch `lane/spike-unified-packaging` is not for merge — it carries a temporary npm export. +- **The Markdown site pipeline is the active coordination arc.** [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]] replaces the old ten-slice umbrella task; [[wa.task.2026.2026-09-11_1153-markdown-contract-safety-fixtures]] is queue item 1. A blind codex evaluation chose `unified`/`remark`/`rehype` over `markdown-it`, reversing a 2025-11-29 decision under the expanded static-site-generator scope. Packaging is proven: real Dendron Markdown renders under Deno and Node with byte-identical output at 242 MB for 1,467 documents. The first child closes the legacy renderer's active-link hole and freezes the contract/baseline before dependency or model changes. Evidence branch `lane/spike-unified-packaging` is not for merge because it carries a temporary npm export. - **Renames are supersessions** ([[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]], ten decisions, three behavioural issues left). `weave supersede` is the primitive, `weave rename` wraps it, paired `dcterms:isReplacedBy`/`replaces`, one hop, exact-state provenance. - **Versioned states are retractable, not immutable** — PII exposure must be fixable, so integrity checking promises current byte-consistency only. Fingerprint verification DEFERRED, embedded RDF PARKED. - **Court/ledger convention changed 2026-08-06** — see § Conventions. Cards name an owning note and stay short; [[wd.decision-log]] is now a product-voiced ledger. diff --git a/documentation/notes/wd.todo.md b/documentation/notes/wd.todo.md index 3be4b9b..6c52efa 100644 --- a/documentation/notes/wd.todo.md +++ b/documentation/notes/wd.todo.md @@ -20,7 +20,7 @@ Groomed on 2026-05-27 from all `wa.task.*` notes in the Weave archive. Updated a - [ ] Execute [[wa.plan.2026.2026-05-17-append-onlyish-inventory]] through independently reviewable child tasks. Add-reference, extracted/current-only MeshInventory, current-only PageDefinition, current-shape extract, mesh-support page-only growth, named locators, progression correction, first-Knop, versioned first-payload, and [[wa.completed.2026.2026-08-31_2101-initial-versioned-mesh-support-inventory-append]] are delivered. Audit the residual legacy/raw MeshInventory and KnopInventory/progression writers next. - [x] Closed [[wa.completed-plan.2026.2026-08-22_1550-stagecraft-iri-initialization]] and [[wa.completed-plan.2026.2026-08-23_0950-founding-capability-releases]]: SFLO v0.5.0 source/Pages and Weave/`weave-lib` v0.9.0 are published; packed and installed Node founding parity passed; no batch task is owed. See [[release-receipt.v0.9.0]]. - [x] `v0.7.0` RELEASED 2026-08-07 (npm `@semantic-flow/weave@0.7.0` and `weave-lib@0.7.0`; PRs #31/#33/#34/#35 plus ESM-only packaging #39; first release able to generate the published SFLO mesh). Details in [[release-notes.v0.7.0]]. -- [ ] Build sites from mesh-held Markdown via the public API: [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]], now queue item 1 after the serial initial mesh-support append child closed. `unified`/`remark`/`rehype` was chosen by blind evaluation; packaging is proven in Deno and Node with byte-identical rendering for 1,467 documents at 242 MB, and four contract rulings leave slice 1 unblocked. +- [ ] Build sites from mesh-held Markdown via the public API through [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]]. `unified`/`remark`/`rehype` was chosen by blind evaluation; packaging is proven in Deno and Node with byte-identical rendering for 1,467 documents at 242 MB. [[wa.task.2026.2026-09-11_1153-markdown-contract-safety-fixtures]] is the first executable child and queue item 1. - [ ] Make renames non-destructive: [[wa.task.2026.2026-08-06_0949-knop-supersession-and-rename]]. A rename supersedes rather than moves, so every prior citation keeps resolving. `weave supersede` is the primitive and `weave rename` wraps it. Ten decisions ruled, three behavioural issues open; not yet queued. - [ ] In flight on `main` (uncommitted as of 2026-08-21): canonical content-digest wire-form validation (`src/core/rdf/content_digest_test.ts`) extending `c0daa57`'s expected/observed digest separation across extract/import/integrate and inventory. This is the digest substrate both the fingerprint-verify surface and `workingAccessUrl` digest expectations depend on. @@ -28,7 +28,7 @@ Groomed on 2026-05-27 from all `wa.task.*` notes in the Weave archive. Updated a 1. **Remote resolution** — [[wa.task.2026.2026-05-20_2152-workingAccessUrl]]: first concrete second-consumer signal (2026-08-21) — another of Dave's projects may need a mesh targeting an ontology held remotely. No fetch path exists in `src/` today; needs the `sfcfg` remote-policy runtime surface plus a bounded fetch helper. The in-flight digest work is its fail-closed substrate. 2. **Fingerprint verification** — [[wa.task.2026.2026-05-04-fingerprint-verification]]: still a stub note, but the digest substrate makes the verify surface a thin slice. Natural first bite of the remote/digest arc rather than an arc of its own. -3. **Markdown site pipeline** — [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]]: ten slices, slice 1 unblocked, packaging proven. Largest new-capability arc; currently queue 2. +3. **Markdown site pipeline** — [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]]: active coordination arc with packaging proven; its contract/safety/fixture child is queue item 1. 4. **Append-only inventory migration** — [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]: shared planner, independent writers, named locators, integrate append, progression correction, first-Knop, versioned first-payload, and initial versioned mesh-support append have shipped; audit the residual legacy/raw MeshInventory and KnopInventory/progression writers next. ### P0: Current Config And Resolution Follow-Ups @@ -57,7 +57,7 @@ Groomed on 2026-05-27 from all `wa.task.*` notes in the Weave archive. Updated a - [ ] Continue test/performance work from [[wa.task.2026.2026-05-26_2237-testing-optimization]] and [[wa.task.2026.2026-05-17-weave-performance-optimization]]: add `WEAVE_TEST_TIMING=1`, record baselines, cache fixture reads by resolved commit, add tiny-mesh builders for tests that do not need the real fixture ladders, and add validation progress output behind a quiet/default/verbose policy. - [ ] Implement the first RDF parse/render boundary slice from [[wa.task.2026.2026-05-28-0030-rdf-and-turtle-cleanup]]: add shared Weave Turtle context/fact helpers, let `inventory_append_planner` accept requested facts/quads instead of parser-dependent Turtle snippets, and keep compact SFLO/config rendering separate from byte-preserved carried blocks. - [ ] Split the largest files under [[wa.task.2026.2026-05-23_0040-further-refactoring]] in behavior-preserving slices: `src/runtime/weave/pages.ts`, `scripts/fixture-ladder.ts`, `src/core/weave/weave_test.ts`, `tests/integration/weave_test.ts`, and `tests/scripts/fixture_ladder_test.ts` are still large enough to slow future work. -- [ ] Renderer strategy is effectively decided by [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]] (unified/remark/rehype chosen by blind evaluation): close [[wa.task.2026.2026-05-25-markdown-it]] as superseded once pipeline slice 4 lands, and reconcile [[wa.task.2026.2026-04-13_1715-page-renderer-refresh-and-html-regeneration]] against the pipeline's slice-9 renderer-epoch cleanup. +- [ ] Renderer strategy is effectively decided by [[wa.plan.2026.2026-08-06_0854-markdown-site-pipeline]] (unified/remark/rehype chosen by blind evaluation): close [[wa.task.2026.2026-05-25-markdown-it]] as superseded once the unified compiler lands, and reconcile [[wa.task.2026.2026-04-13_1715-page-renderer-refresh-and-html-regeneration]] against the plan's renderer-epoch cleanup. - [ ] Define autolinking behavior from [[wa.task.2026.2026-05-24_2353-autolinking]]: term links in Turtle/prose, Dendron wikilinks in Markdown-derived pages, and any publication-base rewrite rules should be scoped together. Dendron wikilink resolution now rides the site pipeline's slice 5; keep the rest scoped with it. - [ ] Add a carried fixture or focused test for forcing a new payload release state when source bytes are unchanged, so named-release sequencing can publish a new HistoricalState without relying on content changes. - [ ] Decide whether Weave should migrate acceptance fixtures from git-branch-backed before/after states to explicit folder-backed snapshots. Upside: simpler local/CI reads and easier task-specific fixture authoring. Downside: duplicated fixture trees, weaker branch provenance, and updates to manifests, notes, and helpers that currently address fixture refs by branch name.