diff --git a/docs/stories/00-status.md b/docs/stories/00-status.md index 443939a..0aae6ab 100644 --- a/docs/stories/00-status.md +++ b/docs/stories/00-status.md @@ -26,6 +26,10 @@ rejection in [`discarded.md`](../plan/discarded.md) with its reason. Statuses: โœ… **done** ยท ๐Ÿ”„ **in progress** ยท โฌœ **pending** ยท โธ **hold** +Story files carry YAML frontmatter (`iteration`/`status`/`chain`) โ€” the +machine-readable truth behind this board; live Obsidian Dataview views: +[`board-views.md`](board-views.md) (Kanban = view only, never edits status). + --- ## โ–ถ NEXT PLAN diff --git a/docs/stories/board-views.md b/docs/stories/board-views.md new file mode 100644 index 0000000..604a7e1 --- /dev/null +++ b/docs/stories/board-views.md @@ -0,0 +1,66 @@ +# Live board views (Obsidian Dataview) + +Every story iteration file carries YAML frontmatter โ€” **the frontmatter +is the source of truth**: + +```yaml +--- +iteration: "8" # immutable id (string: "7b", "9b" exist) +status: in-progress # done | in-progress | refine | hold โ€” mirrors its folder +chain: 1 # concurrency-chain position, chain stories only (1โ€“6) +--- +``` + +The folder move IS the status change: moving a story between `done/`, +`in-progress/`, `refine/`, `hold/` must update its `status:` in the same +change โ€” the two never disagree. The prose board +([`00-status.md`](00-status.md)) stays the standup narrative; these +queries are the live views over the same facts. + +Adjust the `FROM` path to your vault root (queries below assume the +vault opens at the repo root). + +## Everything not done, chain order first + +```dataview +TABLE iteration, status, chain +FROM "docs/stories/language-runtime-database" +WHERE status != "done" +SORT chain ASC, iteration ASC +``` + +## Grouped by status (the kanban lanes, as data) + +```dataview +TABLE rows.file.link AS story, rows.iteration AS iteration +FROM "docs/stories/language-runtime-database" +WHERE status != "done" +GROUP BY status +``` + +## The concurrency chain, in execution order + +```dataview +TABLE iteration, status +FROM "docs/stories/language-runtime-database" +WHERE chain +SORT chain ASC +``` + +## Active right now + +```dataview +LIST +FROM "docs/stories/language-runtime-database" +WHERE status = "in-progress" +``` + +## Kanban caveat + +The Kanban plugin stores board state in its own markdown file โ€” a +second copy of status. To keep frontmatter the single source of truth: +**use Dataview for querying; treat any Kanban board as a VIEW, never +the place status is edited.** Status changes happen by moving the story +file between folders + updating its `status:` key (one commit); a +Kanban card drag that only rewrites the Kanban file is a lie the next +query won't see. diff --git a/docs/stories/language-runtime-database/done/01-principles-doc.md b/docs/stories/language-runtime-database/done/01-principles-doc.md index ddccfb8..6bc2cd4 100644 --- a/docs/stories/language-runtime-database/done/01-principles-doc.md +++ b/docs/stories/language-runtime-database/done/01-principles-doc.md @@ -1,3 +1,8 @@ +--- +iteration: "1" +status: done +--- + # Iteration 1 โ€” the principles doc > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/02-vm-core.md b/docs/stories/language-runtime-database/done/02-vm-core.md index 9855480..c396b0d 100644 --- a/docs/stories/language-runtime-database/done/02-vm-core.md +++ b/docs/stories/language-runtime-database/done/02-vm-core.md @@ -1,3 +1,8 @@ +--- +iteration: "2" +status: done +--- + # Iteration 2 โ€” VM core (`wovm`) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/03-compiler-front.md b/docs/stories/language-runtime-database/done/03-compiler-front.md index 4ebbefa..c7fdbfb 100644 --- a/docs/stories/language-runtime-database/done/03-compiler-front.md +++ b/docs/stories/language-runtime-database/done/03-compiler-front.md @@ -1,3 +1,8 @@ +--- +iteration: "3" +status: done +--- + # Iteration 3 โ€” compiler front (`woc`) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/04-single-binary-e2e.md b/docs/stories/language-runtime-database/done/04-single-binary-e2e.md index 9886c87..919de08 100644 --- a/docs/stories/language-runtime-database/done/04-single-binary-e2e.md +++ b/docs/stories/language-runtime-database/done/04-single-binary-e2e.md @@ -1,3 +1,8 @@ +--- +iteration: "4" +status: done +--- + # Iteration 4 โ€” single binary end-to-end > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/05-language-surface.md b/docs/stories/language-runtime-database/done/05-language-surface.md index 11db327..eb860ed 100644 --- a/docs/stories/language-runtime-database/done/05-language-surface.md +++ b/docs/stories/language-runtime-database/done/05-language-surface.md @@ -1,3 +1,8 @@ +--- +iteration: "5" +status: done +--- + # Iteration 5 โ€” language surface (Haxe-parity adoptions) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/06-program-mode-stdlib.md b/docs/stories/language-runtime-database/done/06-program-mode-stdlib.md index 14dc9da..ea2d2aa 100644 --- a/docs/stories/language-runtime-database/done/06-program-mode-stdlib.md +++ b/docs/stories/language-runtime-database/done/06-program-mode-stdlib.md @@ -1,3 +1,8 @@ +--- +iteration: "6" +status: done +--- + # Iteration 6 โ€” program mode + systems stdlib > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/07-logwatcher-proof.md b/docs/stories/language-runtime-database/done/07-logwatcher-proof.md index e998c80..80dcf47 100644 --- a/docs/stories/language-runtime-database/done/07-logwatcher-proof.md +++ b/docs/stories/language-runtime-database/done/07-logwatcher-proof.md @@ -1,3 +1,8 @@ +--- +iteration: "7" +status: done +--- + # Iteration 7 โ€” log-watcher proof workload > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/07b-inferred-gc-mark-sweep.md b/docs/stories/language-runtime-database/done/07b-inferred-gc-mark-sweep.md index 5ea8ec0..9061390 100644 --- a/docs/stories/language-runtime-database/done/07b-inferred-gc-mark-sweep.md +++ b/docs/stories/language-runtime-database/done/07b-inferred-gc-mark-sweep.md @@ -1,3 +1,8 @@ +--- +iteration: "7b" +status: done +--- + # Iteration 7b โ€” inferred GC + incremental mark-sweep > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/09-database-engine.md b/docs/stories/language-runtime-database/done/09-database-engine.md index 0cebd2c..6826a66 100644 --- a/docs/stories/language-runtime-database/done/09-database-engine.md +++ b/docs/stories/language-runtime-database/done/09-database-engine.md @@ -1,3 +1,8 @@ +--- +iteration: "9" +status: done +--- + # Iteration 9 โ€” database engine > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/09b-table-relations-query.md b/docs/stories/language-runtime-database/done/09b-table-relations-query.md index 1da4ac4..5c0bc03 100644 --- a/docs/stories/language-runtime-database/done/09b-table-relations-query.md +++ b/docs/stories/language-runtime-database/done/09b-table-relations-query.md @@ -1,3 +1,8 @@ +--- +iteration: "9b" +status: done +--- + # Iteration 9b โ€” `@table`, relations, and language-integrated query > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/15-deps-package-manager.md b/docs/stories/language-runtime-database/done/15-deps-package-manager.md index 9c6ecfc..1e9449a 100644 --- a/docs/stories/language-runtime-database/done/15-deps-package-manager.md +++ b/docs/stories/language-runtime-database/done/15-deps-package-manager.md @@ -1,3 +1,8 @@ +--- +iteration: "15" +status: done +--- + # Iteration 15 โ€” dependencies: `wo.toml [deps]`, git fetch, `wo.lock` > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/16-web-framework.md b/docs/stories/language-runtime-database/done/16-web-framework.md index 154419f..7629122 100644 --- a/docs/stories/language-runtime-database/done/16-web-framework.md +++ b/docs/stories/language-runtime-database/done/16-web-framework.md @@ -1,3 +1,8 @@ +--- +iteration: "16" +status: done +--- + # Iteration 16 โ€” the web framework: a `.wo` library, HTTP/1.1 behind a proxy > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/17-library-projects-internal.md b/docs/stories/language-runtime-database/done/17-library-projects-internal.md index db9b555..3485b22 100644 --- a/docs/stories/language-runtime-database/done/17-library-projects-internal.md +++ b/docs/stories/language-runtime-database/done/17-library-projects-internal.md @@ -1,3 +1,8 @@ +--- +iteration: "17" +status: done +--- + # Iteration 17 โ€” library projects and dependency privacy (`kind`, `internal/`) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/done/19-missing-scalar-types.md b/docs/stories/language-runtime-database/done/19-missing-scalar-types.md index c6ad5d1..b947d9a 100644 --- a/docs/stories/language-runtime-database/done/19-missing-scalar-types.md +++ b/docs/stories/language-runtime-database/done/19-missing-scalar-types.md @@ -1,3 +1,8 @@ +--- +iteration: "19" +status: done +--- + # Iteration 19 โ€” the missing scalar types: Float and Bytes > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/18-memory-db-features.md b/docs/stories/language-runtime-database/hold/18-memory-db-features.md index 36116ee..84872c4 100644 --- a/docs/stories/language-runtime-database/hold/18-memory-db-features.md +++ b/docs/stories/language-runtime-database/hold/18-memory-db-features.md @@ -1,3 +1,8 @@ +--- +iteration: "18" +status: hold +--- + # Iteration 18 โ€” framework v2: memory-rich features over the embedded database > **Scope label (2026-08-20): this iteration is FRAMEWORK V2.** Framework diff --git a/docs/stories/language-runtime-database/hold/20-cross-program-tables.md b/docs/stories/language-runtime-database/hold/20-cross-program-tables.md index cd76390..e7091df 100644 --- a/docs/stories/language-runtime-database/hold/20-cross-program-tables.md +++ b/docs/stories/language-runtime-database/hold/20-cross-program-tables.md @@ -1,3 +1,8 @@ +--- +iteration: "20" +status: hold +--- + # Iteration 20 โ€” cross-program tables: attach to a running program's database > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/21-keypair-attach-auth.md b/docs/stories/language-runtime-database/hold/21-keypair-attach-auth.md index 39c74eb..6fe5010 100644 --- a/docs/stories/language-runtime-database/hold/21-keypair-attach-auth.md +++ b/docs/stories/language-runtime-database/hold/21-keypair-attach-auth.md @@ -1,3 +1,8 @@ +--- +iteration: "21" +status: hold +--- + # Iteration 21 โ€” keypair authentication for cross-program attach > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/26-blue-green-deploy.md b/docs/stories/language-runtime-database/hold/26-blue-green-deploy.md index a28c751..47e9f76 100644 --- a/docs/stories/language-runtime-database/hold/26-blue-green-deploy.md +++ b/docs/stories/language-runtime-database/hold/26-blue-green-deploy.md @@ -1,3 +1,8 @@ +--- +iteration: "26" +status: hold +--- + # Iteration 26 โ€” blue-green in-runtime deployment > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/27-query-grammar-corpus.md b/docs/stories/language-runtime-database/hold/27-query-grammar-corpus.md index 5573de4..03716ad 100644 --- a/docs/stories/language-runtime-database/hold/27-query-grammar-corpus.md +++ b/docs/stories/language-runtime-database/hold/27-query-grammar-corpus.md @@ -1,3 +1,8 @@ +--- +iteration: "27" +status: hold +--- + # Iteration 27 โ€” query grammar, driven by real embedded-DB corpora > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/28-skillhost-host-workload.md b/docs/stories/language-runtime-database/hold/28-skillhost-host-workload.md index d1ed877..2214f2c 100644 --- a/docs/stories/language-runtime-database/hold/28-skillhost-host-workload.md +++ b/docs/stories/language-runtime-database/hold/28-skillhost-host-workload.md @@ -1,3 +1,8 @@ +--- +iteration: "28" +status: hold +--- + # Iteration 28 โ€” skillhost: a host-shaped workload, and the capability gaps it exposes > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/hold/29-compile-time-metaprogramming.md b/docs/stories/language-runtime-database/hold/29-compile-time-metaprogramming.md index 63cb956..a42107b 100644 --- a/docs/stories/language-runtime-database/hold/29-compile-time-metaprogramming.md +++ b/docs/stories/language-runtime-database/hold/29-compile-time-metaprogramming.md @@ -1,3 +1,8 @@ +--- +iteration: "29" +status: hold +--- + # Iteration 29 โ€” compile-time metaprogramming (derive from the class table) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/in-progress/08-shard-actor-runtime.md b/docs/stories/language-runtime-database/in-progress/08-shard-actor-runtime.md index a17d076..225c9f8 100644 --- a/docs/stories/language-runtime-database/in-progress/08-shard-actor-runtime.md +++ b/docs/stories/language-runtime-database/in-progress/08-shard-actor-runtime.md @@ -1,3 +1,9 @@ +--- +iteration: "8" +status: in-progress +chain: 1 +--- + # Iteration 8 โ€” shard-actor runtime (the 8+11 concurrency arc, part 1) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/in-progress/11-fibers.md b/docs/stories/language-runtime-database/in-progress/11-fibers.md index aae898d..f9dc0d6 100644 --- a/docs/stories/language-runtime-database/in-progress/11-fibers.md +++ b/docs/stories/language-runtime-database/in-progress/11-fibers.md @@ -1,3 +1,9 @@ +--- +iteration: "11" +status: in-progress +chain: 1 +--- + # Iteration 11 โ€” fibers (the 8+11 concurrency arc, part 2) > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/refine/22-durability-throughput-scale.md b/docs/stories/language-runtime-database/refine/22-durability-throughput-scale.md index c4e0b69..46268fd 100644 --- a/docs/stories/language-runtime-database/refine/22-durability-throughput-scale.md +++ b/docs/stories/language-runtime-database/refine/22-durability-throughput-scale.md @@ -1,3 +1,9 @@ +--- +iteration: "22" +status: refine +chain: 2 +--- + # Iteration 22 โ€” durability proof, throughput, and scale under load > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/refine/23-io-uring-commit.md b/docs/stories/language-runtime-database/refine/23-io-uring-commit.md index a67806a..ab36ca3 100644 --- a/docs/stories/language-runtime-database/refine/23-io-uring-commit.md +++ b/docs/stories/language-runtime-database/refine/23-io-uring-commit.md @@ -1,3 +1,9 @@ +--- +iteration: "23" +status: refine +chain: 5 +--- + # Iteration 23 โ€” io_uring group-commit write path > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/refine/24-chat-websocket-workload.md b/docs/stories/language-runtime-database/refine/24-chat-websocket-workload.md index 124df35..51a870f 100644 --- a/docs/stories/language-runtime-database/refine/24-chat-websocket-workload.md +++ b/docs/stories/language-runtime-database/refine/24-chat-websocket-workload.md @@ -1,3 +1,9 @@ +--- +iteration: "24" +status: refine +chain: 4 +--- + # Iteration 24 โ€” chat: the WebSocket pub/sub driving workload > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/refine/31-actor-lifecycle.md b/docs/stories/language-runtime-database/refine/31-actor-lifecycle.md index b07771b..2df4e1a 100644 --- a/docs/stories/language-runtime-database/refine/31-actor-lifecycle.md +++ b/docs/stories/language-runtime-database/refine/31-actor-lifecycle.md @@ -1,3 +1,9 @@ +--- +iteration: "31" +status: refine +chain: 3 +--- + # Iteration 31 โ€” actor lifecycle: request/response, backpressure, death, timers > Format: fiberloom `product/story-iteration-template`. Part of diff --git a/docs/stories/language-runtime-database/refine/32-wal-checkpoint.md b/docs/stories/language-runtime-database/refine/32-wal-checkpoint.md index 766c42e..cff827d 100644 --- a/docs/stories/language-runtime-database/refine/32-wal-checkpoint.md +++ b/docs/stories/language-runtime-database/refine/32-wal-checkpoint.md @@ -1,3 +1,9 @@ +--- +iteration: "32" +status: refine +chain: 6 +--- + # Iteration 32 โ€” WAL checkpoint: disk space reclamation and bounded replay > Format: fiberloom `product/story-iteration-template`. Part of