@bongos/core 1.19.897 → 1.19.899
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bongos-core.json +22 -12
- package/docs/adr/0312-provenance-is-a-second-ideas-owned-edge-table.md +78 -0
- package/docs/adr/0313-a-removal-is-proposed-by-the-ship-and-confirmed-by-a-person.md +69 -0
- package/docs/adr/README.md +2 -0
- package/docs/module-api-changelog.md +4 -0
- package/package-lock.json +2 -2
- package/package.json +1 -1
- package/src/module-api.js +1 -1
package/.bongos-core.json
CHANGED
|
@@ -2,22 +2,22 @@
|
|
|
2
2
|
"artifact": "bongos-core",
|
|
3
3
|
"manifest_schema": 1,
|
|
4
4
|
"generator": "scripts/gds/package-core.js",
|
|
5
|
-
"core_version": "1.19.
|
|
6
|
-
"core_contract": "1.19.
|
|
7
|
-
"source_commit": "
|
|
5
|
+
"core_version": "1.19.899",
|
|
6
|
+
"core_contract": "1.19.899",
|
|
7
|
+
"source_commit": "18e19a9f8472cc87ac263b0266d11f1d87e352d4",
|
|
8
8
|
"source_ref": "HEAD",
|
|
9
|
-
"built_at": "2026-09-
|
|
9
|
+
"built_at": "2026-09-20T04:05:43.927Z",
|
|
10
10
|
"redaction": {
|
|
11
11
|
"model": "docs-redacted+functional-verbatim",
|
|
12
|
-
"docs_redacted":
|
|
12
|
+
"docs_redacted": 502,
|
|
13
13
|
"agent_docs_stubbed": 26,
|
|
14
14
|
"functional_verbatim": 2277,
|
|
15
15
|
"rules": 3,
|
|
16
16
|
"gate_literals": 3,
|
|
17
17
|
"gate": "passed"
|
|
18
18
|
},
|
|
19
|
-
"file_count":
|
|
20
|
-
"tree_sha256": "
|
|
19
|
+
"file_count": 2805,
|
|
20
|
+
"tree_sha256": "02493e71ddfd64f20d5be962a0a967ab57c24e1cac948681b566a8a7d87dcc75",
|
|
21
21
|
"files": [
|
|
22
22
|
{
|
|
23
23
|
"path": ".claude/skills/ask-for-help/SKILL.md",
|
|
@@ -2049,10 +2049,20 @@
|
|
|
2049
2049
|
"mode": "0000644",
|
|
2050
2050
|
"sha256": "6046995188cef5e8652787eca38ccc6a69393f0985891764d6573f3379bbe6ab"
|
|
2051
2051
|
},
|
|
2052
|
+
{
|
|
2053
|
+
"path": "docs/adr/0312-provenance-is-a-second-ideas-owned-edge-table.md",
|
|
2054
|
+
"mode": "0000644",
|
|
2055
|
+
"sha256": "be07bd84a0167bbadfd3569286a5a69da403336739a88fccb5a5b6231e225af6"
|
|
2056
|
+
},
|
|
2057
|
+
{
|
|
2058
|
+
"path": "docs/adr/0313-a-removal-is-proposed-by-the-ship-and-confirmed-by-a-person.md",
|
|
2059
|
+
"mode": "0000644",
|
|
2060
|
+
"sha256": "9b301cd17f96c3f0b49010f046b994e112a5e1f971797964b836bc578578dd70"
|
|
2061
|
+
},
|
|
2052
2062
|
{
|
|
2053
2063
|
"path": "docs/adr/README.md",
|
|
2054
2064
|
"mode": "0000644",
|
|
2055
|
-
"sha256": "
|
|
2065
|
+
"sha256": "85bb537649c78b08e36e2de94dfde8449760ca163577a7fac63603da4074dd37"
|
|
2056
2066
|
},
|
|
2057
2067
|
{
|
|
2058
2068
|
"path": "docs/api-reference.md",
|
|
@@ -2622,7 +2632,7 @@
|
|
|
2622
2632
|
{
|
|
2623
2633
|
"path": "docs/module-api-changelog.md",
|
|
2624
2634
|
"mode": "0000644",
|
|
2625
|
-
"sha256": "
|
|
2635
|
+
"sha256": "7c5f4afd7ed31a886824fdce76aea1f7a5e4ff5e0d05ac40358a18fbceb6ac58"
|
|
2626
2636
|
},
|
|
2627
2637
|
{
|
|
2628
2638
|
"path": "docs/modules-contract.md",
|
|
@@ -7732,12 +7742,12 @@
|
|
|
7732
7742
|
{
|
|
7733
7743
|
"path": "package-lock.json",
|
|
7734
7744
|
"mode": "0000644",
|
|
7735
|
-
"sha256": "
|
|
7745
|
+
"sha256": "640f2bc9b3f15ca82640c73a681425eb06518b9fceb1d649486c55ad3cf73469"
|
|
7736
7746
|
},
|
|
7737
7747
|
{
|
|
7738
7748
|
"path": "package.json",
|
|
7739
7749
|
"mode": "0000644",
|
|
7740
|
-
"sha256": "
|
|
7750
|
+
"sha256": "d04cbdbb7e6b3f4788c1b161337a4aa7935811a50100c6779e80b177f7ce7505"
|
|
7741
7751
|
},
|
|
7742
7752
|
{
|
|
7743
7753
|
"path": "public-docs/index.html",
|
|
@@ -9747,7 +9757,7 @@
|
|
|
9747
9757
|
{
|
|
9748
9758
|
"path": "src/module-api.js",
|
|
9749
9759
|
"mode": "0000644",
|
|
9750
|
-
"sha256": "
|
|
9760
|
+
"sha256": "452208ca788059958d16240ae3c879df1ce3ecb1db4a7084c19aeba9a453aa84"
|
|
9751
9761
|
},
|
|
9752
9762
|
{
|
|
9753
9763
|
"path": "src/module-loader/catalog.js",
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# ADR 0312 — Provenance is a second ideas-owned edge table, written by the seams that already know
|
|
2
|
+
|
|
3
|
+
**Status:** accepted · **Date:** 2026-09-19 · **Task:** [task 1004080](https://cloudbongos.com/builders#/task/1004080) (goal 1000095 — BONGOS-V2)
|
|
4
|
+
|
|
5
|
+
**Related:** [ADR 0311](0311-an-idea-is-a-permanent-origin-tag.md) (the origin tag this records the descent of) · [ADR 0236](0236-many-ideas-one-task-the-lineage-key-is-the-pair.md) (made co-source ideas real, which is why the edge cannot live on the lineage row) · [ADR 0083](0083-modular-architecture-strangler-build-plan.md) §Decision 5 (a module migration may only touch its own namespace) · [ADR 0054](0054-session-token-reward-cost-plus.md) (the credit the payout rides on) · [ADR 0015](0015-task-dependencies-and-auto-promotion.md)
|
|
6
|
+
|
|
7
|
+
## Context
|
|
8
|
+
|
|
9
|
+
A descent — `idea → task → rewrite → split → removal` — is four levels deep and crosses a version boundary. The obvious place to put it is the task hierarchy, and that place is closed.
|
|
10
|
+
|
|
11
|
+
`modules/lifecycle/hierarchy.js` `attachParent` enforces four invariants, verified by reading the code rather than the comment:
|
|
12
|
+
|
|
13
|
+
| Invariant | Error code |
|
|
14
|
+
|---|---|
|
|
15
|
+
| `target !== parent` | `SELF_PARENT` |
|
|
16
|
+
| `target.version_id === parent.version_id` | `VERSION_MISMATCH` |
|
|
17
|
+
| `parent.parent_task_id IS NULL` (depth cap, side 1) | `PARENT_HAS_PARENT` |
|
|
18
|
+
| target has no children (depth cap, side 2) | `TARGET_HAS_CHILDREN` |
|
|
19
|
+
|
|
20
|
+
All four are deliberate; ship rollup and claim safety lean on them, and spec decision 8 puts widening them out of scope. So provenance needs its own relation.
|
|
21
|
+
|
|
22
|
+
**The spike was told to confirm `ideas_task_lineage` rather than assume it. Confirmed for one half, and refuted for the other.**
|
|
23
|
+
|
|
24
|
+
## Decision
|
|
25
|
+
|
|
26
|
+
**Two tables, not one.** `ideas_task_lineage` stays exactly as it is and anchors depth 0. A new ideas-owned table records task→task edges.
|
|
27
|
+
|
|
28
|
+
### Why the edge cannot go on `ideas_task_lineage`
|
|
29
|
+
|
|
30
|
+
The table is bipartite (ideas × tasks) with `PRIMARY KEY (task_id, idea_id)` since `ideas_006`. It carries none of the hierarchy's invariants — no depth cap, no version predicate, no self-reference hazard — so as the **idea→task anchor** it is right, and that half of the assumption holds.
|
|
31
|
+
|
|
32
|
+
But a derivation is a property of the **task pair**, not of the (task, idea) pair. Adding `derived_from_task_id` to the lineage row would write the same derivation once per co-source idea, and `ideas_006` made co-source ideas both legal and expected (merging duplicate reports into one task is the triage move the inbox is built to encourage). Two rows for one task could then disagree about where that task came from, with nothing to arbitrate. That is not a hypothetical: `ideas_006` exists precisely because an under-keyed row silently lost attribution on prod, and it took months to notice.
|
|
33
|
+
|
|
34
|
+
A merge also gives a task **several** parents, so the relation is a DAG, not a tree — a single nullable column could not express it regardless.
|
|
35
|
+
|
|
36
|
+
### The edge table
|
|
37
|
+
|
|
38
|
+
`ideas_task_descent`, in the `ideas_` namespace (ADR 0083 §5 — `tasks` belongs to the protected `lifecycle` module and may not be altered from here; a FK to it is a read, the `ideas_002` precedent).
|
|
39
|
+
|
|
40
|
+
- `task_id` → the derived task, `parent_task_id` → what it came from, both FK to `tasks`.
|
|
41
|
+
- `relation` — a CHECK'd vocabulary: `rewrite`, `split`, `merge`, `fold`, `cascade`. Extended the `ideas_003` way (drop and re-add the same-named constraint, which `isConstraintWidening` exempts), with that migration's safety net proving the widening took.
|
|
42
|
+
- `PRIMARY KEY (task_id, parent_task_id)` — a task may have several parents; one pair is recorded once.
|
|
43
|
+
- Indexed both directions: descent walks down from a parent, payout walks up from a ship.
|
|
44
|
+
|
|
45
|
+
**No depth cap and no version predicate** — that is the entire point, and it is what the hierarchy could not give.
|
|
46
|
+
|
|
47
|
+
**Cycles must be refused at write time.** The payout walks this graph, so a cycle is a non-terminating walk, not a cosmetic error. A self-edge is refused by CHECK; a longer cycle is refused by the writer, which walks to the root before inserting. The walk is also depth-bounded when read, so a cycle that somehow lands cannot hang a page.
|
|
48
|
+
|
|
49
|
+
### Who writes the edge
|
|
50
|
+
|
|
51
|
+
The task set the real question: parentage today is a manual act, so an edge that depends on someone remembering will have holes. It does not have to. **Three seams already know a task was derived, and none of them is currently telling anyone:**
|
|
52
|
+
|
|
53
|
+
| Seam | What it already records | What it becomes |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| `modules/lifecycle/cascade.js` | `source_ref: cascade-<key>-<id>` — the originating task id, **encoded in a string** | `relation='cascade'`, written at creation |
|
|
56
|
+
| `tasks.merged_into_task_id` | supersede/fold provenance, CHECK'd to `abandoned` rows (`core_232`) | `relation='fold'` — the mockup's "satellite" |
|
|
57
|
+
| `tasks.parent_task_id` | the one-level split | `relation='split'` |
|
|
58
|
+
|
|
59
|
+
The cascade case is the telling one. The derivation is *already there* and already correct — it is simply stored as text inside `source_ref`, where nothing can join on it. Promoting it to an edge is not new bookkeeping, it is writing down a fact the system already computes.
|
|
60
|
+
|
|
61
|
+
That leaves `rewrite` and cross-version `merge` as genuinely manual, which is honest: those are editorial acts with no automatic signal behind them. They get an explicit write, and their absence degrades the picture rather than corrupting it.
|
|
62
|
+
|
|
63
|
+
## Consequences
|
|
64
|
+
|
|
65
|
+
**What this fixes.** `sourceIdeaForTask` (`inbox.js:870`) and `awardIdeaTaskShipCredit` (`credits.js:540`) both read `ideas_task_lineage` with `ORDER BY created_at, idea_id LIMIT 1` — a **direct, one-hop point read**. A derived task has no lineage row of its own, so today it resolves to `no_source_idea` and the origin idea is not paid at all. The descent walk is what closes that, and spec decision 6's depth decay is what keeps it from paying unboundedly.
|
|
66
|
+
|
|
67
|
+
**Two relations over the same pair of tasks now exist** — `parent_task_id` (work decomposition, capped, same-version) and this one (provenance, unbounded, cross-version). They are not redundant and must not be merged: the first answers "what is this work part of", the second "where did this work come from". The split edge is written to both, which is the only overlap.
|
|
68
|
+
|
|
69
|
+
**The display is wider than the count.** Per spec decision 7 the descent *shows* more than size *counts* — a separate thought citing an origin appears in the picture and pays nothing. The edge table carries both; the payout walk filters. Conflating them would let early filers farm the project.
|
|
70
|
+
|
|
71
|
+
**A backfill is possible and partial.** Every existing cascade task can be recovered by parsing `source_ref`, and every `merged_into_task_id` is already an edge. Historical rewrites are unrecoverable, which is consistent with spec decision 17: pre-existing ideas get lineage backfilled but not payouts, and the number must be marked as historical rather than quietly presented as a sum of payouts made.
|
|
72
|
+
|
|
73
|
+
## Alternatives rejected
|
|
74
|
+
|
|
75
|
+
- **Widen the task hierarchy.** Out of scope by spec decision 8, and the invariants are load-bearing for ship rollup and claim safety.
|
|
76
|
+
- **`derived_from_task_id` on `ideas_task_lineage`.** Duplicates the derivation per co-source idea and cannot express a merge. The reason it looks attractive — "extend, don't add" — is real, and the extension is of the lineage *ledger*, which is now two tables.
|
|
77
|
+
- **A column on `tasks`.** Forbidden from a module migration (ADR 0083 §5); `tasks` is the protected `lifecycle` module.
|
|
78
|
+
- **Derive the descent at read time from `source_ref` strings.** It covers only the cascade case, cannot express rewrite or merge, and makes a string format load-bearing for money.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# ADR 0313 — A removal is derived from the server's own merge diff and confirmed by a person
|
|
2
|
+
|
|
3
|
+
**Status:** accepted · **Date:** 2026-09-19 · **Task:** [task 1004081](https://cloudbongos.com/builders#/task/1004081) (goal 1000095 — BONGOS-V2)
|
|
4
|
+
|
|
5
|
+
**Related:** [ADR 0311](0311-an-idea-is-a-permanent-origin-tag.md) (deferred exactly this) · [ADR 0312](0312-provenance-is-a-second-ideas-owned-edge-table.md) (the descent this dims) · [ADR 0242](0242-a-cascade-is-a-declaration-table-on-the-event-that-already-exists.md) (the runner a rule is appended to) · [ADR 0055](0055-server-mediated-branch-publish.md) (why the server holds the authoritative diff) · [ADR 0049](0049-split-parallel-safety-contract.md) (`touches[]` is advisory)
|
|
6
|
+
|
|
7
|
+
## Context
|
|
8
|
+
|
|
9
|
+
Brightness is the live share of a descent (spec decision 20), so something has to be able to say that shipped work was later removed. **Nothing records that today.** `shipped` is terminal — `modules/lifecycle/rot.js` says so in as many words — there is no reverted status, and `tasks.merged_into_task_id` is CHECK-constrained to `abandoned` rows (`core_232`), so it can only ever describe work cut *before* it landed.
|
|
10
|
+
|
|
11
|
+
The owner settled the shape and not the detail (spec decision 13): **the system proposes, a person confirms.** A derived-only signal dims the sky for refactors, renames and file moves; a declared-only one rots because nobody remembers. This ADR settles the detail.
|
|
12
|
+
|
|
13
|
+
## What the spike found
|
|
14
|
+
|
|
15
|
+
**1. `cascade.js` no longer ships with an empty rule set.** The task description says it does; that was true when the task was written and is not true now. `CASCADES` carries a production rule (`artist-review-on-ship`), and ADR 0242 fixed the extension contract: *append an entry, never touch the runner.* This strengthens the decision rather than weakening it — there is a working precedent to copy, including the anti-recursion guard (`source !== CASCADE_SOURCE`) that a removal rule needs for the same reason.
|
|
16
|
+
|
|
17
|
+
**2. `netNegativeBonusAmount` cannot be the trigger.** The task names it as the nearest existing signal, and it is — in spirit. Structurally it is unusable:
|
|
18
|
+
|
|
19
|
+
- **It has no target.** `removed > added` over a whole ship says *that* deletion happened, never *what* was deleted or whose work it was. Brightness needs the target; the boolean carries none.
|
|
20
|
+
- **It is client-supplied.** It reads `signals.diff_stats`, which arrives in the grade request body. `grader-score.js` documents the exact forgery it already defends against — a `diff_stats` claiming a net-negative that the submitted diff does not support.
|
|
21
|
+
- **Brightness affects money.** Size is a payout sum and brightness sits beside it. Deriving either from a forgeable, target-less counter would be wrong even if it were convenient.
|
|
22
|
+
|
|
23
|
+
**3. There is no durable record of what any ship touched.** `committed_files` exists at grade time for the protected-path check and `diff_stats` for the bonus, both client-supplied, and **neither is persisted** — no table stores them. `touches[]` is advisory by ADR 0049. So a removal cannot be reconstructed from history at all; it can only be derived at the moment a ship lands.
|
|
24
|
+
|
|
25
|
+
## Decision
|
|
26
|
+
|
|
27
|
+
### The signal's source is the server's own merge diff
|
|
28
|
+
|
|
29
|
+
Landing is server-mediated (ADR 0055): the server holds the repository and performs the merge, so it can compute the real diff rather than be told about one. The removal signal is derived **there**, from the merge the server just made, and never from a client-supplied signal. This is the only reason the derivation can be trusted with something that moves credits.
|
|
30
|
+
|
|
31
|
+
### Attribution runs through `claims.published_head_sha`, not commit text
|
|
32
|
+
|
|
33
|
+
To say *whose* work was deleted, the deleted hunks are blamed back to the commit that introduced them, and that commit is resolved to a task through **`claims.published_head_sha`** (`migrations/171`) — the server-pushed tip, already persisted per claim.
|
|
34
|
+
|
|
35
|
+
The obvious alternative, parsing `(task NNNN)` out of commit messages, was rejected: of the last 15 commits on `main`, **7** carry a task id. Merge commits and release carriers do not, and a convention that holds most of the time is not a basis for a payout. The sha mapping is written by the server at publish time and cannot be forgotten by an author.
|
|
36
|
+
|
|
37
|
+
`published_head_sha` is nullable, so attribution can come back empty — a ship that predates `migrations/171`, or one that rode in on another branch. **An unattributable deletion files no proposal.** Silence is the correct output: a wrong removal proposal costs a person's attention and dims a real star.
|
|
38
|
+
|
|
39
|
+
### What counts as removed
|
|
40
|
+
|
|
41
|
+
Only **work that shipped and was later deleted**. Three exclusions, each of which the Sky artboard already draws:
|
|
42
|
+
|
|
43
|
+
- A **rename or move is not a removal.** Git's own rename detection resolves it; the work still stands.
|
|
44
|
+
- A **rewrite in place is not a removal.** Lines changing is how code lives.
|
|
45
|
+
- A **cold body is not a remnant.** An idea declined at triage never ignited — nothing was built, so nothing was lost. Removal applies only below a task that actually shipped.
|
|
46
|
+
|
|
47
|
+
### The proposal, the confirmation, and the clock
|
|
48
|
+
|
|
49
|
+
- **Propose:** a new entry appended to `CASCADES` on the ship trigger. It files a *question*, never a verdict, and carries the anti-recursion guard the existing rule uses.
|
|
50
|
+
- **Confirm:** Metic+, `task.promote`, on the existing awaiting-nod surface (spec decision 15). No new permission and no new page.
|
|
51
|
+
- **Rot:** an unanswered proposal enters the existing rot feed on the normal clock (spec decision 14), so the queue cannot silently grow.
|
|
52
|
+
|
|
53
|
+
Only a **confirmed** proposal dims a star. A pending one changes nothing the ideator sees.
|
|
54
|
+
|
|
55
|
+
## Consequences
|
|
56
|
+
|
|
57
|
+
**Brightness can only fall forward from here.** The derivation runs at merge time and nothing durable records the past, so removals before this ships are not recoverable. That is consistent with spec decision 17 — pre-existing ideas get lineage backfilled but not payouts — and it means a historical marker is required on those sizes, or the number quietly lies about what it means.
|
|
58
|
+
|
|
59
|
+
**The server gains a git-reading step on the merge path.** It is the one place with both the repository and the authority, but it is also the path a stranded ship already fails on. The rule must be non-blocking: a derivation that errors files nothing and never fails the merge. Landing work is more important than dimming a star on time.
|
|
60
|
+
|
|
61
|
+
**Two signals now exist over the same diff, and they must not be confused.** `netNegativeBonusAmount` rewards a builder for simplifying, and this one records that an origin's descendant work is gone. The same net-negative ship can legitimately trigger the bonus and no removal at all.
|
|
62
|
+
|
|
63
|
+
## Alternatives rejected
|
|
64
|
+
|
|
65
|
+
- **Derived-only, no confirmation.** The owner's decision, and correct: refactors, renames and moves would dim the sky continuously.
|
|
66
|
+
- **Declared-only** (a human marks work removed). Rots because nobody remembers — the same reason the descent edges are not left to memory in ADR 0312.
|
|
67
|
+
- **`netNegativeBonusAmount` as the trigger.** Target-less, client-supplied, already known-forgeable.
|
|
68
|
+
- **Commit-message parsing for attribution.** Holds for under half of `main`'s recent commits.
|
|
69
|
+
- **A `removed` task status.** `shipped` is terminal by design and much of the ledger leans on that. A removal is a fact about work's *fate*, recorded beside it, not a new terminal state that ship rollup would have to learn.
|
package/docs/adr/README.md
CHANGED
|
@@ -403,3 +403,5 @@ This keeps the decision history honest and traceable.
|
|
|
403
403
|
| 0309 | [**Module enablement is a database row, above the committed pack and below env** ([task 1002857](https://cloudbongos.com/builders#/task/1002857), goal 1000091). The hall Modules-tab toggle ([ADR 0107](0107-module-upstreaming-contribution-to-core-catalog.md) §9) wrote `config/modules.json` and reloaded the cache, so it looked like it worked — but that file is the committed instance pack and the pull-deploy runs `git reset --hard origin/main`, so the toggle reverted on the next deploy, **silently**. Enablement moves to `module_enablement_overrides` (migration `core_248`), read as one precedence layer: neutral pack → instance pack → **DB override** → env → default. **Above the pack** because the pack is what a deploy restores, so an override below it would be erased by the event it exists to survive; **below env** because `<PREFIX>_MODULE_<KEY>` is the incident knob and must not need a reachable database. **Auto-committing to `main` stays rejected** ([ADR 0016](<redacted>.md)): durability belongs in the DB, not in an HTTP handler that writes to the default branch. Two open design points settled: the **scope key** is the resolved instance pack path (the only axis two instances sharing one database differ on, so one sibling's toggle cannot flip the other's module), and the DB is read into a **snapshot** refreshed at boot and on write rather than inline, because `loadModules()` is synchronous and making it async would ripple into every consumer of a module flag. An unreachable database is a **no-op** — no row means "no opinion", not "off". Does not decide: whether a toggle should also restart the process so remounting is immediate.](0309-durable-module-enablement-db-override.md) | modules / ops |
|
|
404
404
|
| 0310 | [**A speciality OFFERS skills; the adopter turns them on, one at a time, having been shown what each does** ([task 1003978](https://cloudbongos.com/builders#/task/1003978), goal 1000095). Completes [ADR 0296](0296-a-role-speciality-is-data-over-three-existing-surfaces.md), which defined a speciality as knowledge + skills + an interaction contract and shipped two of the three: `grep -i skill` across the module's schema, domain and routes returns only the header sentences describing a thing that is not there — prose asserting behaviour the code does not have, and the feature's own definition at that. Task 1003978 withheld an implementation until the authority question was answered, and the answer is the strong one: **naming a skill GRANTS NOTHING**. Skills are materialised by `claude-materialize.js` and permission is rank-gated server-side with no caching ([ADR 0016](<redacted>.md)); a speciality offers a menu, and a menu is not an entitlement. **Two layers, because one layer is the blanket the owner ruled against**: the catalog holds what a speciality OFFERS, the already-per-builder `specialities_adoptions` row holds what THIS builder turned on — so two economist ideators share a speciality's knowledge and contract and need not share one enabled skill. **The default is nothing enabled, and that is a position about LEARNING rather than a safe default**: the owner's ruling is that adoption must *walk through what comes with each* because *people need to learn the system*. A settings page of unchecked boxes satisfies the letter and defeats the intent, so the bar is a user test — a person who has finished adopting can say what each skill does. Sharing needs no new mechanism: `owner_kind` / `visibility` / `offered` / `sellable` already ship the private→project→public ladder, and skills ride it. Builds nothing; the three-task order (schema, walkthrough, injection) is filed, and the four documentation sites that claimed a shipped ingredient now say decided-not-built.](0310-a-speciality-offers-skills-and-the-adopter-chooses-them.md) | specialities / methodology |
|
|
405
405
|
| 0311 | [**An idea is a permanent origin tag, and the payout follows its descent** ([task 1004076](https://cloudbongos.com/builders#/task/1004076), goal 1000095 — BONGOS-V2). An idea today is a CONTAINER for work: it leaves `idea_inbox` when it names a goal and lives on as a task, so the better-aimed the thought the faster it vanishes from whoever had it. Reported as a small confusion — a thought filed from the hall routed into a goal, the confirmation line cleared on the next keystroke, and five minutes later the owner could not find it. The idea becomes an **immutable origin tag** instead, the only thing that can answer where a piece of work came from, and **the ideator payout follows its whole descent** rather than stopping at the earliest lineage link (`awardIdeaTaskShipCredit`), decaying by depth — full at the direct task, halving each hop — so an infinite descent is worth at most twice the direct task. That is what gives the tag teeth: if it does not survive a fork, someone does not get paid. **Size and brightness are two channels, not one number**: size is the sum of those payouts and never falls, brightness is how much of that work is still alive, so a thought whose work the project tore out renders LARGE AND DEAD rather than looking like one that never mattered. **Karma was rejected as the basis** — `karma_log` carries no task key and no idea key, deliberately ([`migrations/040_builder_karma.sql`](../../migrations/040_builder_karma.sql)), so "the karma a thought caused" is not computable; credits already are idea-attributed. **The task hierarchy is NOT widened** to carry the descent — it is capped at one level and refuses cross-version parents because ship rollup and claim safety lean on it, and provenance is a different relation from work decomposition. **Nothing records that shipped work was later removed** (`shipped` is terminal, `merged_into_task_id` is CHECK-constrained to abandoned rows), so the first `cascade.js` rule PROPOSES a removal and a person confirms it — derived-only would dim for refactors and renames, declared-only would rot. A ratified **Full Idea becomes a goal or a criterion**, carrying a recommendation the board rules on, because scope is the thing you learn last; the five questions are replaced and VERSIONED so prior filings keep their own. Dropped three tasks this invalidated and amended a fourth whose title asserted the exact exclusivity it reverses. Does not decide: the decay rate beyond its default, what precisely counts as removed, how the edges are physically recorded, or how any of it is drawn.](0311-an-idea-is-a-permanent-origin-tag.md) | ideas / economy |
|
|
406
|
+
| 0312 | [**Provenance is a SECOND ideas-owned edge table, written by the seams that already know** ([task 1004080](https://cloudbongos.com/builders#/task/1004080), goal 1000095 — BONGOS-V2). The spike [ADR 0311](0311-an-idea-is-a-permanent-origin-tag.md) deferred: how the descent edges are physically recorded. A descent (`idea → task → rewrite → split → removal`) is four levels deep and crosses a version boundary, and the task hierarchy refuses both — `attachParent` enforces `SELF_PARENT`, `VERSION_MISMATCH`, `PARENT_HAS_PARENT` and `TARGET_HAS_CHILDREN`, all load-bearing for ship rollup and claim safety. The spike was told to CONFIRM `ideas_task_lineage` rather than assume it, and confirmed one half while refuting the other: the table is right as the **idea→task anchor** (bipartite, no depth cap, no version predicate) but CANNOT carry the task→task edge, because a derivation is a property of the task PAIR and [ADR 0236](0236-many-ideas-one-task-the-lineage-key-is-the-pair.md) made co-source ideas both legal and common — a `derived_from_task_id` column would write the same derivation once per co-source idea and let two rows disagree about where a task came from, the same under-keying that silently lost attribution on prod once already. A merge also gives a task SEVERAL parents, so the relation is a **DAG, not a tree**. Decision: a new `ideas_task_descent` (`task_id`, `parent_task_id`, CHECK'd `relation`, PK on the pair, indexed both ways), with NO depth cap and NO version predicate, and **cycles refused at write time** because the payout walks this graph and a cycle is a non-terminating walk rather than a cosmetic error. On who writes it — the question the task actually set, since an edge depending on memory will have holes — **three seams already know and none is telling anyone**: `cascade.js` encodes the originating task id inside `source_ref` as a STRING nothing can join on, `tasks.merged_into_task_id` already records the fold, and `parent_task_id` already records the split. Only `rewrite` and cross-version `merge` stay manual, which is honest — they are editorial acts with no automatic signal, and their absence degrades the picture rather than corrupting it. What it fixes: `sourceIdeaForTask` and `awardIdeaTaskShipCredit` are both one-hop `LIMIT 1` point reads, so a DERIVED task resolves to `no_source_idea` and the origin is not paid at all. Does not decide: the decay rate beyond its default, what counts as removed ([ADR 0313](0313-a-removal-is-proposed-by-the-ship-and-confirmed-by-a-person.md)), or how any of it is drawn.](0312-provenance-is-a-second-ideas-owned-edge-table.md) | ideas / lifecycle |
|
|
407
|
+
| 0313 | [**A removal is derived from the SERVER's own merge diff and confirmed by a person** ([task 1004081](https://cloudbongos.com/builders#/task/1004081), goal 1000095 — BONGOS-V2). The other half [ADR 0311](0311-an-idea-is-a-permanent-origin-tag.md) deferred: what counts as removed, so that brightness can fall at all. Nothing records it today — `shipped` is terminal (`rot.js` says so outright) and `merged_into_task_id` is CHECK'd to `abandoned` rows, describing only work cut BEFORE it landed. Owner decision 13 set the shape (system proposes, person confirms); this settles the detail, and corrects two premises the task was written on. **`cascade.js` is no longer empty** — it carries a production rule and [ADR 0242](0242-a-cascade-is-a-declaration-table-on-the-event-that-already-exists.md) fixed the contract (append an entry, never touch the runner), so there is a precedent to copy including its anti-recursion guard. **`netNegativeBonusAmount` cannot be the trigger** despite being the named nearest signal: it is an aggregate with NO TARGET (it says deletion happened, never what or whose), it is CLIENT-SUPPLIED via `signals.diff_stats`, and `grader-score.js` already documents the forgery it defends against — and brightness sits beside a payout, so a forgeable target-less counter cannot carry it. **Nothing durable records what any ship touched**: `committed_files` and `diff_stats` are client-supplied at grade time and never persisted, `touches[]` is advisory ([ADR 0049](0049-split-parallel-safety-contract.md)), so a removal cannot be reconstructed from history — only derived as a ship lands. Decision: derive it from the SERVER's own merge diff ([ADR 0055](0055-server-mediated-branch-publish.md) — the server holds the repo and does the merge, so it computes the diff rather than being told one), and attribute the deleted hunks through **`claims.published_head_sha`** (`migrations/171`), NOT by parsing `(task NNNN)` out of commit text — only 7 of `main`'s last 15 commits carry a task id, and a convention that holds most of the time cannot underwrite a payout. An UNATTRIBUTABLE deletion files nothing: a wrong proposal costs attention and dims a real star. A rename, a move and a rewrite-in-place are NOT removals, and a cold body is not a remnant — removal applies only below a task that actually shipped. The proposal is an appended `CASCADES` entry filing a QUESTION; confirmation is Metic+/`task.promote` on the existing awaiting-nod surface; an unanswered one rots on the normal clock. Only a CONFIRMED proposal dims a star. The derivation must be NON-BLOCKING — landing work matters more than dimming a star on time. Brightness can only fall forward from here, so historical sizes need a marker or the number lies.](0313-a-removal-is-proposed-by-the-ship-and-confirmed-by-a-person.md) | ideas / lifecycle |
|
|
@@ -2268,5 +2268,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
|
|
|
2268
2268
|
landed since 1.19.895 with no explicit bump. run 35478072367. (task 1002620)
|
|
2269
2269
|
1.19.897 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
|
|
2270
2270
|
landed since 1.19.896 with no explicit bump. run 35485346707. (task 1002620)
|
|
2271
|
+
1.19.898 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
|
|
2272
|
+
landed since 1.19.897 with no explicit bump. run 35487863230. (task 1002620)
|
|
2273
|
+
1.19.899 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
|
|
2274
|
+
landed since 1.19.898 with no explicit bump. run 35488237998. (task 1002620)
|
|
2271
2275
|
---------------------------------------------------------------------------
|
|
2272
2276
|
```
|
package/package-lock.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bongos/core",
|
|
3
|
-
"version": "1.19.
|
|
3
|
+
"version": "1.19.899",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "@bongos/core",
|
|
9
|
-
"version": "1.19.
|
|
9
|
+
"version": "1.19.899",
|
|
10
10
|
"license": "AGPL-3.0-or-later",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"express": "^4.21.2",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bongos/core",
|
|
3
|
-
"version": "1.19.
|
|
3
|
+
"version": "1.19.899",
|
|
4
4
|
"description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
|
|
5
5
|
"license": "AGPL-3.0-or-later",
|
|
6
6
|
"main": "src/platform-server.js",
|
package/src/module-api.js
CHANGED
|
@@ -71,7 +71,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
|
|
|
71
71
|
// there. scripts/gds/bump-version.js still rewrites the literal below; it appends
|
|
72
72
|
// the entry to that file. Look for a version's history there, not here.
|
|
73
73
|
// ---------------------------------------------------------------------------
|
|
74
|
-
const CORE_VERSION = '1.19.
|
|
74
|
+
const CORE_VERSION = '1.19.899'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
|
|
75
75
|
|
|
76
76
|
// A namespaced logger so a module's log lines are attributable + consistent.
|
|
77
77
|
// Usage: const log = api.logger('dev-box'); log.info('mounted');
|