Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions documentation/notes/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Groomed 2026-08-21 and updated 2026-08-31. This note now carries direction and a
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 2.
4. **Append-only inventory migration** — [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]: named locators and [[wa.completed.2026.2026-08-31_1714-mesh-support-progression-producer-correction]] are delivered; the preserved [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] WIP resumes against corrected fixtures.
4. **Append-only inventory migration** — [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]: named locators, progression correction, and first-Knop append are delivered; [[wa.task.2026.2026-08-31_1905-versioned-first-payload-mesh-inventory-append]] is the next audited child.

## Completed Arc — Founding Capability Releases (released 2026-08-23)

Expand All @@ -32,7 +32,7 @@ Groomed 2026-08-21 and updated 2026-08-31. This note now carries direction and a
- `[importance: medium] [how-soon: next]` Finish moving page HTML construction out of core weave planning: the `alice/index.html` special-case builders are gone and page models exist; the residual construction in `src/core/weave/resource_page_builders.ts` should ride the site pipeline's source/compiled model-boundary slice.
- `[importance: medium] [how-soon: next]` Keep templates and chrome policy adjacent to, but separate from, page-content composition: renderer code computes breadcrumbs, nav slices, and optional search inputs; templates render structured inputs rather than becoming a client/runtime framework.
- `[importance: medium] [how-soon: next]` Add Accord acceptance coverage for root lifecycle and customizable identifier pages on the carried ladder.
- `[importance: medium] [how-soon: next]` Replace remaining inventory rewrites with append-onlyish writes. Named locator identity, integrate append, and corrected mesh-support progression producers/fixtures are delivered; [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] resumes next.
- `[importance: medium] [how-soon: next]` Replace remaining inventory rewrites with append-onlyish writes. Named locators, integrate append, corrected mesh-support progression, and first-Knop append are delivered; [[wa.task.2026.2026-08-31_1905-versioned-first-payload-mesh-inventory-append]] migrates the remaining singular/delegated-batch versioned first-payload rewrite next.
- `[importance: medium] [how-soon: later]` Add an API surface for deriving candidate `ReferenceLink`s from extraction provenance as an explicit proposal/curation operation, once role defaults and working-vs-exact reference semantics settle.
- `[importance: medium] [how-soon: later]` Add a transformation/extraction layer for using imported RDF datasets as page-region content (overlaps the site pipeline's DigitalArtifact site-generation slice).
- `[importance: medium] [how-soon: later]` Add reusable fixture helpers for root-sourced extract and page-customization scenarios.
Expand Down
8 changes: 5 additions & 3 deletions documentation/notes/wd.maintenance.2026-08.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,12 +88,14 @@ created: 1785612549252
- 2026-08-31 — APPEND G1 CLOSED: Weave PR #50 merged as `b8678d0` after 890-test CI and a no-action CodeRabbit review; renamed the child to [[wa.completed.2026.2026-08-31_0106-add-reference-inventory-append]], popped it from [[wd.queues]], and admitted [[wa.task.2026.2026-08-31_0845-batched-extracted-mesh-inventory-append]] as the next plan child
- 2026-08-31 — BATCHED EXTRACTED APPEND CLOSED: Weave PR #51 merged as `14090ba` after 895-test CI and a no-action CodeRabbit review; renamed the child to [[wa.completed.2026.2026-08-31_0845-batched-extracted-mesh-inventory-append]], popped it from [[wd.queues]], and admitted [[wa.task.2026.2026-08-31_1026-versioned-sequential-extracted-mesh-inventory-append]] next
- 2026-08-31 — SEQUENTIAL EXTRACTED APPEND CLOSED: Weave PR #53 merged as `12233bc` after 899-test CI and CodeRabbit's rate-limit acceptance; renamed the child to [[wa.completed.2026.2026-08-31_1026-versioned-sequential-extracted-mesh-inventory-append]], popped it from [[wd.queues]], and admitted [[wa.task.2026.2026-08-31_1050-current-only-payload-like-mesh-inventory-append]] next
- 2026-08-31 — CURRENT-ONLY PAGE-CLAIM APPEND CLOSED: Weave PR #55 merged as `00a3fae` after 902-test CI and CodeRabbit's rate-limit acceptance; renamed the child to [[wa.completed.2026.2026-08-31_1050-current-only-payload-like-mesh-inventory-append]], boarded repository floating-locator blank-node identity in [[wa.dave-court]], and admitted [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] next
- 2026-08-31 — FIRST-KNOP APPEND PAUSED: acceptance replay showed the old renderer intentionally removes legacy MeshInventory-owned progression pointers, conflicting with exact-prefix append; preserved WIP, added a second [[wa.dave-court]] card, kept [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] queued behind the ruling, and admitted [[wa.task.2026.2026-08-31_1127-current-only-page-definition-inventory-append]] as the independent next slice
- 2026-08-31 — CURRENT-ONLY PAGE-CLAIM APPEND CLOSED: Weave PR #55 merged as `00a3fae` after 902-test CI and CodeRabbit's rate-limit acceptance; renamed the child to [[wa.completed.2026.2026-08-31_1050-current-only-payload-like-mesh-inventory-append]], boarded repository floating-locator blank-node identity in [[wa.dave-court]], and admitted [[wa.completed.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] next
- 2026-08-31 — FIRST-KNOP APPEND PAUSED: acceptance replay showed the old renderer intentionally removes legacy MeshInventory-owned progression pointers, conflicting with exact-prefix append; preserved WIP, added a second [[wa.dave-court]] card, kept [[wa.completed.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] queued behind the ruling, and admitted [[wa.task.2026.2026-08-31_1127-current-only-page-definition-inventory-append]] as the independent next slice
- 2026-08-31 — CURRENT-ONLY PAGEDEFINITION APPEND CLOSED: Weave PR #58 merged as `a8fb7fa` after 905-test CI and CodeRabbit's rate-limit acceptance; renamed the child to [[wa.completed.2026.2026-08-31_1127-current-only-page-definition-inventory-append]], popped it from [[wd.queues]], and admitted [[wa.task.2026.2026-08-31_1147-current-shape-extract-mesh-inventory-append]] next
- 2026-08-31 — CURRENT-SHAPE EXTRACT APPEND CLOSED: Weave PR #60 merged as `e473b83` after 909-test CI, npm-lib, CodeQL, and CodeRabbit's rate-limit acceptance; renamed the child to [[wa.completed.2026.2026-08-31_1147-current-shape-extract-mesh-inventory-append]], popped it from [[wd.queues]], kept integrate behind the repository-locator identity ruling, and admitted [[wa.task.2026.2026-08-31_1219-mesh-support-page-only-inventory-append]] next
- 2026-08-31 — MESH-SUPPORT PAGE-ONLY APPEND CLOSED: Weave PR #62 merged as `4c5aece` after 912-test CI, npm-lib, CodeQL, and a no-action CodeRabbit review; renamed the child to [[wa.completed.2026.2026-08-31_1219-mesh-support-page-only-inventory-append]], popped it from [[wd.queues]], marked the parent plan ruling-bound, and moved the executable Markdown pipeline ahead of the blocked first-Knop child
- 2026-08-31 — APPEND RULINGS SETTLED: floating repository locators use `<D/_knop/_sources#payload-source-repository-locator>`; legacy progression uses producer/fixture correction followed by fail-closed stale-shape handling. Swept both [[wa.dave-court]] cards and narrowed the queued first-Knop dependency from a ruling to its required correction child
- 2026-08-31 — NAMED LOCATOR CHILD CUT: admitted [[wa.task.2026.2026-08-31_1639-named-repository-floating-locators]] as queue item 1 at Dave's serial sequencing request; Markdown moved to item 2 and first-Knop remains behind ruled producer/fixture correction
- 2026-08-31 — NAMED LOCATOR CHILD CLOSED: SFLO PR #5 merged as `ae1cf25` and Weave PR #67 as `a2e1e22` after green cross-repo gates; renamed the child to [[wa.completed.2026.2026-08-31_1639-named-repository-floating-locators]], popped it from [[wd.queues]], and admitted [[wa.completed.2026.2026-08-31_1714-mesh-support-progression-producer-correction]] next
- 2026-08-31 — MESH-SUPPORT PROGRESSION CORRECTION CLOSED: Weave PR #69 merged as `8392751` and Framework PR #1 as `a748ac9`; regenerated and published all affected fixture tails, including lease-protected branch publication, after 918-test CI and exact Accord validation. Renamed `wa.task.2026.2026-08-31_1714-mesh-support-progression-producer-correction` → [[wa.completed.2026.2026-08-31_1714-mesh-support-progression-producer-correction]], popped it from [[wd.queues]], and promoted [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] to resume the preserved WIP.
- 2026-08-31 — MESH-SUPPORT PROGRESSION CORRECTION CLOSED: Weave PR #69 merged as `8392751` and Framework PR #1 as `a748ac9`; regenerated and published all affected fixture tails, including lease-protected branch publication, after 918-test CI and exact Accord validation. Renamed `wa.task.2026.2026-08-31_1714-mesh-support-progression-producer-correction` → [[wa.completed.2026.2026-08-31_1714-mesh-support-progression-producer-correction]], popped it from [[wd.queues]], and promoted [[wa.completed.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] to resume the preserved WIP.
- 2026-08-31 — VERSIONED FIRST-KNOP APPEND CLOSED: Weave PR #71 merged as `7382eeb` after 924-test CI, npm-lib, CodeQL, codecov/patch, and a no-finding CodeRabbit review. Regenerated/published Alice `a.05`–`a.30` and merged accepted tree `de53ab2` to fixture `main`; discarded sidecar/branch timestamp-only rehearsals. Renamed `wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append` → [[wa.completed.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]], popped it from [[wd.queues]], and returned the append plan to a fresh remaining-writer audit.
- 2026-08-31 — VERSIONED FIRST-PAYLOAD CHILD CUT: fresh audit found `renderFirstPayloadWovenMeshInventoryTurtle` still block-replaces mesh/payload/Knop/history subjects and its batched wrapper delegates to it. Cut and queued [[wa.task.2026.2026-08-31_1905-versioned-first-payload-mesh-inventory-append]] ahead of the Markdown pipeline; payload KnopInventory and candidate routing remain separate.
2 changes: 1 addition & 1 deletion documentation/notes/wd.queues.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ 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…]] — <at most one clause>`, ≤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-31_1111-versioned-first-knop-mesh-inventory-append]] — resume preserved WIP against corrected fixtures
1. [[wa.task.2026.2026-08-31_1905-versioned-first-payload-mesh-inventory-append]] — migrate singular and batched versioned first-payload MeshInventory append
2. [[wa.task.2026.2026-08-06_0854-markdown-site-pipeline]] — packaging proof PROVEN; unified pipeline so Markdown artifacts render as pages

## Jimbo — planning
4 changes: 2 additions & 2 deletions documentation/notes/wd.read-in.jimbo.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,10 +51,10 @@ This note is the seating source for the Weave/sflo planning seat (Jimbo). Load i

As of 2026-08-31:

- **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 growth, named locators, and [[wa.completed.2026.2026-08-31_1714-mesh-support-progression-producer-correction]] are delivered under [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]. [[wa.task.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] resumes against the corrected fixtures.
- **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 growth, named locators, progression correction, and [[wa.completed.2026.2026-08-31_1111-versioned-first-knop-mesh-inventory-append]] are delivered under [[wa.plan.2026.2026-05-17-append-onlyish-inventory]]. The fresh audit cut [[wa.task.2026.2026-08-31_1905-versioned-first-payload-mesh-inventory-append]] next.
- **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 the next strategic arc after the serial progression correction.** 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.
- **A markdown site pipeline is queue item 2 behind the serial versioned first-payload append child.** 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.
- **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.
Expand Down
Loading