@bongos/core 1.19.175 → 1.19.177

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.175",
-  "core_contract": "1.19.175",
-  "source_commit": "93e75e5bd9554037be1ec34ec0a428d9eec8db0c",
+  "core_version": "1.19.177",
+  "core_contract": "1.19.177",
+  "source_commit": "ec902233a41d6187d97c1b0761ca59b57ae3b180",
   "source_ref": "HEAD",
-  "built_at": "2026-08-16T20:19:55.300Z",
+  "built_at": "2026-08-16T20:47:16.225Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 305,
+    "docs_redacted": 306,
     "agent_docs_stubbed": 21,
     "functional_verbatim": 1273,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1599,
-  "tree_sha256": "e99154c282f827663b8bf2628c82b2ea12e0285235bc7d46844f88d25a8f2fd7",
+  "file_count": 1600,
+  "tree_sha256": "07b51c6ba546cfe6dc3f252283ffdbf5fa06230b8a86baeb82b82311d5e11dee",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -1339,6 +1339,11 @@
       "mode": "0000644",
       "sha256": "0bfe5ce46139bf9ee236868317cc80ee10eb8747d5606d0dd0fe9f2580ea5177"
     },
+    {
+      "path": "docs/adr/0172-per-craft-compensation-ideator-credit-lane.md",
+      "mode": "0000644",
+      "sha256": "d06219f51351c1dd73f7ba556c855e678a2e55e79dacd06419c212a6a24fcc64"
+    },
     {
       "path": "docs/adr/README.md",
       "mode": "0000644",
@@ -2827,7 +2832,7 @@
     {
       "path": "modules/economy/credits.js",
       "mode": "0000644",
-      "sha256": "fd80563444ebb62c5d8a5e7d766a557f85bb90bb2d67f368f41e589f6b0d0ec3"
+      "sha256": "38526b1d7a095fc48d062ddd645df074f381d2ef0e0aac6593ff306601659904"
     },
     {
       "path": "modules/economy/migrations/economy_001_fix_gds_shipper_description.sql",
@@ -4222,12 +4227,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "76f039bc2d79508787cf452ae0d84cafde39f3b43e492af622baf67f64b881a6"
+      "sha256": "bd31fbe4175062649acbd10eba6caca643e13941a4d8a366bd5ba2625e7ac92d"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "9628ea87ea7a532bfb4776e9587bb916e4b9249b91cf72da1d28d0b7d3589ad2"
+      "sha256": "f5fe7936f9d6739c7268697daab41d5520a0da60bc2b63099d8bd7145e977091"
     },
     {
       "path": "public-docs/index.html",
@@ -5637,7 +5642,7 @@
     {
       "path": "src/bongos/llm-pricing.js",
       "mode": "0000644",
-      "sha256": "c421166d7d5099f96b2b46cf9fb46b2c0b3594fb59d318c1a512751bd00a9969"
+      "sha256": "f7688e75a873f9c287f6559311877081830798cb1b5f1e548ceff3fcbed9e31d"
     },
     {
       "path": "src/bongos/metrics.js",
@@ -5832,7 +5837,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "1a5f88144d3ee5bcd4729388f02e9d5bc62541740df4ef256914c9aa8434d1e6"
+      "sha256": "5904881edeeaeedb873a2968c36a01b3c2faf6e79112bd56653f28692aa5267b"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -6362,7 +6367,7 @@
     {
       "path": "tests/cost_reconcile.mjs",
       "mode": "0000644",
-      "sha256": "a94de0a9ebd15b8aeb80fa2fc976d847334e733bd0c2a65a869bac5c4b6b4dd8"
+      "sha256": "8356250d8fc753afb2960d867f81586531053afd15f4e66da1a1b7b62b6b5db7"
     },
     {
       "path": "tests/cost_summary_shape.mjs",
@@ -6372,7 +6377,7 @@
     {
       "path": "tests/credit_grant.mjs",
       "mode": "0000644",
-      "sha256": "b483d3a13198f2acd5d721ff5164a6e315ea7294d4f1cfd7c4c2d9279f914f5e"
+      "sha256": "2b871880fc9e6d636c5fb93d2641abad964f4d3e0ed1e78939b12dc849a7631d"
     },
     {
       "path": "tests/criterion_authoring_gate.mjs",
@@ -7097,7 +7102,7 @@
     {
       "path": "tests/llm-pricing.mjs",
       "mode": "0000644",
-      "sha256": "dec4e9ab447bfac75c6298c6f47d0f0f85e643c7519e192ca704d9a93a834499"
+      "sha256": "de3fabaeafb3eb3ad500becf565f3b6d7118a763f1e80d085f94b6ba990d5c58"
     },
     {
       "path": "tests/local_preview.mjs",

package/docs/adr/0172-per-craft-compensation-ideator-credit-lane.md

@@ -0,0 +1,146 @@
+# 0172 — Per-craft compensation: the ideator credit lane, separate from cost-plus
+
+- **Status:** Accepted
+- **Date:** 2026-08-16
+- **Deciders:** Lars (owner / Archon), Claude (Opus 5)
+- **Track:** `internal` (Cloud Bongos — economy)
+- **Task:** BV1.R171 ([#1002995](https://cloudbongos.com/builders#/task/1002995)) — the foundation of the **Ideator compensation** goal ([#1000067](https://cloudbongos.com/builders#/goal/1000067)).
+- **Builds on:** [ADR 0054](<redacted>.md) (cost-plus session reward), [ADR 0146](<redacted><redacted>.md) (`rewardPolicy` + the `cost-plus-only` mode), [ADR 0023](<redacted>.md) (kind multipliers + the 25% idea-promotion slice), [ADR 0120](<redacted>.md) (pay-on-land).
+- **Relates to:** goal 1000062 (three grades of idea — R141/R142/R143 shipped), idea 1000738 (the Board Room).
+- **Gates:** IC2 ([#1002996](https://cloudbongos.com/builders#/task/1002996)) · IC3 ([#1002997](https://cloudbongos.com/builders#/task/1002997)) · IC4 ([#1002998](https://cloudbongos.com/builders#/task/1002998)) · IC5 ([#1002999](https://cloudbongos.com/builders#/task/1002999)) · IC6 ([#1003000](https://cloudbongos.com/builders#/task/1003000)).
+
+---
+
+## Context
+
+Cloud Bongos pays **one kind of worker one way**. The equity stream is the
+cost-plus session reward ([ADR 0054](<redacted>.md)):
+`round(true_cost_usd × (1 + margin))`, booked when a shipped session lands. On
+top of that, [ADR 0023](<redacted>.md) pays the
+capturer of a promoted idea a **25% slice** of the resulting task's estimate
+when it ships, and [ADR 0146](<redacted><redacted>.md)
+lets an instance switch to `cost-plus-only`, which **withholds every per-task
+estimate payout — the idea slice included** (it is a fraction of a payout that
+is now zero, so it "cascades to 0", `credits.js:235`). cloudbongos.com runs
+`cost-plus-only`.
+
+Two things are now true at once, and they conflict:
+
+1. The **ABI model** (goal 1000062, the owner's Holy Workshop Trinity brief)
+   makes the **ideator** a first-class craft whose *output is a Full Idea* — a
+   deliverable, scored on completeness (R142, shipped). The owner wants that
+   craft **paid in credits**, on three streams (below).
+2. On the live instance those credits **cannot be paid**, because they ride the
+   very per-task estimate path `cost-plus-only` exists to withhold.
+
+The owner resolved it with a principle, 2026-08-16:
+
+> *"this should [be] separate from cost plus, an idea-tor should get paid
+> differently than an artist and builder."*
+
+Compensation is **per-craft**. A builder earning cost-plus for shipping and an
+ideator earning credits for thinking are **not the same reward being tuned two
+ways** — they are two different lanes. The `cost-plus-only` switch governs the
+*builder estimate* lane; it must not reach across and silence the *ideator*
+lane, because that lane is a different craft's pay.
+
+## Decision
+
+### 1. Compensation is per-craft; the ideator credit lane is its own reward, exempt from the `cost-plus-only` gate
+
+The reward model gains a **named lane per craft**, not a single tunable payout:
+
+- **Builder (engineer)** — the cost-plus session reward ([ADR 0054](<redacted>.md)) plus, where `mode !== 'cost-plus-only'`, the per-task estimate ([ADR 0146](<redacted><redacted>.md)). Unchanged.
+- **Ideator** — the **idea credit lane** defined here (three streams, §3). Governed by its **own** policy flag, **never** by `perTaskCredit`.
+- **Artist** — a lane of its own, **deliberately left unspecified here** (the artist craft — grading, copy, voice — is scoped in later ABI work). This ADR reserves the *shape* (a named lane) so the artist lane slots in the same way; it does not define the artist's pay.
+
+The rule that makes this real and testable: **no ideator-lane credit is ever
+gated on `perTaskCredit`.** `cost-plus-only` withholds the builder estimate and
+nothing else.
+
+### 2. `rewardPolicy` grows an ideator dimension; the gate is separate from `perTaskCredit`
+
+`rewardPolicy(rawReward)` (`modules/economy/credits.js`) today returns
+`{ marginPct, usdPeg, mode, perTaskCredit }`, where
+`perTaskCredit = mode !== 'cost-plus-only'`. It gains an **independent** flag:
+
+```
+ideatorCredit: <resolved from reward config; default TRUE>
+```
+
+`ideatorCredit` is **not derived from `mode`.** An instance in `cost-plus-only`
+still has `ideatorCredit: true` unless it explicitly opts the ideator lane out.
+The ideator-credit writers (IC2/IC4/IC5) gate on `config.ideatorCredit`, never
+on `config.perTaskCredit` — the same shape as the existing per-task gate at
+`credits.js:238`, pointed at a different flag. An instance that wants *no*
+ideator pay sets it false; the default pays.
+
+### 3. The three ideator streams (the credit model)
+
+All three book to `credit_log` under **ideator-lane reasons** (namespace
+`idea.credit.*`), distinct from `task.shipped`, `task.confirmed`,
+`idea_promotion_bonus`, and the session cost-plus. Idempotency keys are named
+per stream so a re-grade / re-ship / re-vote never double-pays.
+
+- **Stream 2 — a passing Full Idea pays 5 credits, once** (IC2, buildable now).
+  When a Full Idea (R143) clears the completeness bar, book **5** to its author,
+  once, `reason='idea.credit.full_pass'`, idempotent on `(idea_id, reason)`. The
+  bar is a completeness threshold set in the reward config (default proposed:
+  **60/100** — the R142 score at which four of five base fields are
+  substantively answered). Buildable today: R142 + R143 shipped.
+
+- **Stream 1 — 5 credits per shipped task under the idea, scaled by idea grade**
+  (IC4). As each task descended from an idea (the IC3 lineage) first reaches
+  `shipped`, book `round(5 × gradeFactor)` to the idea's author, once per
+  `(idea_id, task_id)`, `reason='idea.credit.task_ship'`.
+  `gradeFactor = completeness%/100` for a Full Idea; for a **Quick Idea** (no
+  completeness score) a flat `QUICK_IDEA_FACTOR` (default proposed **0.6**).
+  **This REPLACES the ADR 0023 25% slice** (§4).
+
+- **Stream 3 — a board-room-passed idea pays up to 100 × completeness%** (IC5,
+  future). When a Full Idea passes the project's governance vote (the Board
+  Room, idea 1000738 — *not yet built*), book
+  `max(floor, round(completeness% × 100))` to its author, once per idea,
+  `reason='idea.credit.governance_pass'`. Owner floor ~**30**. Consumes the
+  Board Room's pass event; invents no parallel vote.
+
+### 4. The ADR 0023 idea-promotion slice is retired in favour of stream 1
+
+The 25% slice (`IDEA_BONUS_FRACTION = 0.25`, `reason='idea_promotion_bonus'`)
+and stream 1 are **two rules for the same thing** — "an idea earns when its work
+ships." Running both would pay an idea twice on every ship. Stream 1 (IC4) is
+the go-forward rule; when IC4 lands it **removes** the 0.25 slice write, so
+there is one idea-credit-on-ship path, not two. Until IC4 lands, the 0023 slice
+stays (harmlessly zero on `cost-plus-only` today). The switch-over is a single
+change inside IC4, guarded so no window pays both.
+
+### 5. Two structural facts the streams depend on (recorded, not built here)
+
+- **Stream 1 needs one idea → many tasks.** `idea_inbox.promoted_to_task_id` is
+  a single FK. IC3 adds the many-tasks lineage — **preferred shape: an
+  ideas-owned `idea_tasks` join keyed by task id**, so it needs no `ALTER` on
+  the protected `tasks` table and the work stays inside the `ideas` module wall.
+  Set at promotion and at develop (R146).
+- **Stream 3 needs the Board Room.** IC5 waits on idea 1000738.
+
+## Consequences
+
+- **cloudbongos.com can pay ideators on `cost-plus-only`.** The whole reason
+  this goal exists. Builders keep earning cost-plus and nothing else; ideators
+  earn the idea lane; the two no longer collide. IC6 proves both hold at once.
+- **`rewardPolicy` stays a pure function** — one added field, resolved from
+  reward config, unit-testable without the `branding()` cache (the ADR 0146
+  pattern). No new table: the thresholds/factors (pass bar, quick factor,
+  governance floor) are **policy constants in `credits.js`** for the same
+  reasons ADR 0023 kept the kind multipliers in code — they deserve a review +
+  ADR + commit trail, not a hot-path UPDATE. A future migration can promote them
+  to a table if per-instance tuning is wanted.
+- **Artist pay is deliberately unresolved.** This ADR commits to the *shape*
+  (per-craft lanes) so the artist lane lands the same way; it does not price the
+  artist craft. That is later ABI work, and pretending to settle it here would
+  be a decision made without the design.
+- **The numbers are proposed defaults, not owner-locked.** The pass bar (60),
+  quick factor (0.6), and governance floor (30) are this ADR's starting values;
+  each is a one-constant change and each downstream task (IC2/IC4/IC5) surfaces
+  its own for confirmation. The owner set the *structure* (5 / grade-scaled /
+  up-to-100-by-fullness); these fill the gaps the structure left open.

package/modules/economy/credits.js

@@ -159,13 +159,23 @@ const REWARD_MODE_COST_PLUS_ONLY = 'cost-plus-only';
 // policy. Exported so a test can assert the mapping without touching the memoized
 // branding() cache (mirrors computeSessionTokenReward's pure/impure split). The
 // derived `perTaskCredit` boolean is what the per-task credit writer gates on.
+//
+// PER-CRAFT COMPENSATION (ADR 0172): `ideatorCredit` is a SEPARATE lane from the
+// builder per-task estimate. It is NOT derived from `mode` — an instance in
+// `cost-plus-only` still pays ideators (ideatorCredit stays true) because that
+// switch governs the builder estimate, not a different craft's pay. The ideator
+// credit writers (IC2/IC4/IC5) gate on `ideatorCredit`, never on `perTaskCredit`.
+// An instance opts the ideator lane out with `reward.ideatorCredit: false`;
+// absent/any-non-false → the default TRUE (a pre-ADR-0172 config keeps paying).
 function rewardPolicy(rawReward) {
   const r = rawReward || {};
   const marginPct = Number.isFinite(Number(r.marginPct)) ? Number(r.marginPct) : REWARD_MARGIN_PCT;
   const usdPeg = Number.isFinite(Number(r.usdPeg)) && Number(r.usdPeg) > 0 ? Number(r.usdPeg) : 1;
   const mode = r.mode === REWARD_MODE_COST_PLUS_ONLY ? REWARD_MODE_COST_PLUS_ONLY : REWARD_MODE_DEFAULT;
   const perTaskCredit = mode !== REWARD_MODE_COST_PLUS_ONLY;
-  return { marginPct, usdPeg, mode, perTaskCredit };
+  // Default-on, opt-out-only: only an explicit `false` withholds the ideator lane.
+  const ideatorCredit = r.ideatorCredit !== false;
+  return { marginPct, usdPeg, mode, perTaskCredit, ideatorCredit };
 }
 
 // Per-instance reward policy, resolved over the code defaults. Best-effort: a

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.175",
+  "version": "1.19.177",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.175",
+      "version": "1.19.177",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.175",
+  "version": "1.19.177",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/src/bongos/llm-pricing.js

@@ -34,20 +34,42 @@
 // Family-based pricing assumes the CURRENT model in each family (what this
 // instance runs). A historical id like claude-opus-4-1 ($15/$75) would be
 // mis-priced low here — acceptable: the platform only runs 4.x-current models.
+//
+// VERIFIED 2026-08-16 against the live Anthropic pricing page (task 1002883):
+// added the `fable` family. familyFor() previously matched only opus/sonnet/
+// haiku, so claude-fable-5 — the owner's top-model default and this instance's
+// `assumed_builder_model` (modules/grading/grader-rubric.json) — fell through to
+// null and was priced at the opus fallback with unknown_model=true. Fable is
+// 2× opus, so every cost-plus reward computed from a Fable session was priced at
+// HALF its true cost (not conservative: cost-plus UNDER-pays the builder). The
+// grading side already carried the family token (grader.js MODEL_FAMILY_TOKENS);
+// this table is the surface that never caught up.
+//   - fable  = Claude Fable 5 / Mythos 5 ($10 in / $50 out) — identical rates,
+//              which is why one family token covers both.
+//   - opus   = Claude Opus 5 / 4.8 / 4.7  ($5 in / $25 out)  [re-verified]
+//   - sonnet = Claude Sonnet 4.6          ($3 in / $15 out)  [re-verified]
+//   - haiku  = Claude Haiku 4.5           ($1 in / $5 out)   [re-verified]
+// NOTE (deliberately NOT changed here — its own task, per the rule above):
+// Claude Sonnet 5 is now $2/$10, not the $3/$15 this `sonnet` row carries. The
+// grader's default worker model is claude-sonnet-5, so grade costs are currently
+// OVER-priced ~1.5×. That is a separate price-table decision; see task 1003001.
 const PRICES = {
   // family : { input, output, cache_write_5m, cache_write_1h, cache_read }  (USD / 1e6 tokens)
+  fable:  { input: 10, output: 50, cache_write_5m: 12.5, cache_write_1h: 20, cache_read: 1   },
   opus:   { input: 5,  output: 25, cache_write_5m: 6.25, cache_write_1h: 10, cache_read: 0.5 },
   sonnet: { input: 3,  output: 15, cache_write_5m: 3.75, cache_write_1h: 6,  cache_read: 0.3 },
   haiku:  { input: 1,  output: 5,  cache_write_5m: 1.25, cache_write_1h: 2,  cache_read: 0.1 },
 };
 
-// Resolve a model id (e.g. 'claude-opus-4-8', 'claude-sonnet-4-6',
-// 'claude-haiku-4-5') to a price family by substring — mirrors grader.js's
-// family-token convention (all live Claude ids contain one of these three).
-// Unknown → null (caller decides: we conservatively price at the opus rate AND
-// flag it, so an unpriced model is loud, never silently $0).
+// Resolve a model id (e.g. 'claude-fable-5', 'claude-opus-4-8',
+// 'claude-sonnet-4-6', 'claude-haiku-4-5') to a price family by substring —
+// mirrors grader.js's MODEL_FAMILY_TOKENS convention, including the fable/mythos
+// pair it checks first (all live Claude ids contain one of these tokens).
+// Unknown → null (caller decides: we price at the opus rate AND flag it, so an
+// unpriced model is loud, never silently $0 — see priceUsage on why opus).
 function familyFor(model) {
   const m = String(model || '').toLowerCase();
+  if (m.includes('fable') || m.includes('mythos')) return 'fable';
   if (m.includes('opus')) return 'opus';
   if (m.includes('sonnet')) return 'sonnet';
   if (m.includes('haiku')) return 'haiku';
@@ -70,7 +92,14 @@ function priceUsage(model, usage) {
   const u = usage || {};
   const fam = familyFor(model);
   const unknownModel = fam === null;
-  const priceFamily = fam || 'opus'; // conservative default for an unrecognized model
+  // Unrecognized → price at the opus rate. Since `fable` landed (task 1002883)
+  // opus is no longer the ceiling, so this is a MID-range fallback, not a
+  // conservative one: an unknown Fable-class model prices at half its true rate.
+  // That is why unknown_model=true rides along — the loudness is the safeguard,
+  // not the rate. (Deliberately left at opus: every model this platform actually
+  // runs is now matched, so raising the fallback would only over-price genuinely
+  // foreign ids like gpt-4o.)
+  const priceFamily = fam || 'opus';
   const p = PRICES[priceFamily];
 
   const input = Number(u.input_tokens) || 0;          // uncached input
@@ -179,7 +208,7 @@ function priceModelUsage(modelUsage) {
  * Like priceModelUsage, model_usage has NO 5m/1h cache-creation breakdown — the
  * `cache_creation` lump is priced at the 5m rate, exactly as session-cost.js
  * priceTranscript does in its `else` branch (no breakdown → 5m). Unknown model
- * ids are conservatively priced as opus AND collected, so an unpriced model is
+ * ids are priced as opus AND collected, so an unpriced model is
  * loud, never silently $0. Pure: no I/O, no Date.now().
  *
  * @param {Object<string, {input?:number,output?:number,cache_read?:number,cache_creation?:number}>} modelUsage
@@ -199,7 +228,7 @@ function componentsFromModelUsage(modelUsage) {
     const usage = u || {};
     const fam = familyFor(rawId);
     if (fam === null) unknown.push(canonicalizeModelId(rawId));
-    const p = PRICES[fam || 'opus']; // conservative default for an unrecognized model
+    const p = PRICES[fam || 'opus']; // mid-range fallback; unknown ids ride the `unknown` list
     fresh_input_usd += ((Number(usage.input) || 0) * p.input) / 1e6;
     output_usd += ((Number(usage.output) || 0) * p.output) / 1e6;
     cache_read_usd += ((Number(usage.cache_read) || 0) * p.cache_read) / 1e6;

package/src/module-api.js

@@ -777,8 +777,12 @@ const { validateOrRespond, LIMITS, parseId, asyncHandler, corsPublicGet, parsePa
 //         landed since 1.19.173 with no explicit bump. run 31969032984. (task 1002620)
 //   1.19.175 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
 //         landed since 1.19.174 with no explicit bump. run 31970199477. (task 1002620)
+//   1.19.176 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+//         landed since 1.19.175 with no explicit bump. run 31971125373. (task 1002620)
+//   1.19.177 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+//         landed since 1.19.176 with no explicit bump. run 31971532260. (task 1002620)
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.175'; // CI auto-patch carrier (ADR 0161); see changelog above
+const CORE_VERSION = '1.19.177'; // CI auto-patch carrier (ADR 0161); see changelog above
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('dev-box'); log.info('mounted');

package/tests/cost_reconcile.mjs

@@ -100,3 +100,33 @@ test('1366 missing per-tier fields default to 0 (partial model_usage)', () => {
   assert.equal(out.cache_write_usd, 0);
   assert.ok(near(out.total_usd, 5));
 });
+
+// ---------- fable / mythos family (task 1002883) ----------
+// The reconciler is the SECOND pricing path the missing fable family broke: a
+// cloud-box / overnight Fable session whose client cost hook never posted lands
+// here, and before the fix it re-priced at the opus fallback — half the true
+// cost, and flagged unknown on the platform's own default model.
+
+test('1002883 fable 1M/1M/10M/1M → $10 / $50 / $10 / $12.50, total $82.50, not flagged', () => {
+  const out = componentsFromModelUsage({
+    'claude-fable-5': { input: M, output: M, cache_read: 10 * M, cache_creation: M },
+  });
+  assert.ok(near(out.fresh_input_usd, 10), `fresh ${out.fresh_input_usd}`);
+  assert.ok(near(out.output_usd, 50), `output ${out.output_usd}`);
+  assert.ok(near(out.cache_read_usd, 10), `cache_read ${out.cache_read_usd}`); // 10M * 1/M
+  assert.ok(near(out.cache_write_usd, 12.5), `cache_write ${out.cache_write_usd}`);
+  assert.ok(near(out.total_usd, 82.5), `total ${out.total_usd}`);
+  const sum = out.fresh_input_usd + out.cache_read_usd + out.cache_write_usd + out.output_usd;
+  assert.ok(near(sum, out.total_usd), `tiers sum ${sum} must equal total ${out.total_usd}`);
+  assert.deepEqual(out.unknown_models, [], 'fable is the platform default — never "unknown"');
+});
+
+test('1002883 mythos prices as fable, and a fable session is 2× the same opus session', () => {
+  const usage = { input: M, output: M };
+  const fable = componentsFromModelUsage({ 'claude-fable-5': usage });
+  const mythos = componentsFromModelUsage({ 'claude-mythos-5': usage });
+  const opus = componentsFromModelUsage({ 'claude-opus-5': usage });
+  assert.ok(near(fable.total_usd, mythos.total_usd), 'mythos shares fable rates');
+  assert.deepEqual(mythos.unknown_models, []);
+  assert.ok(near(fable.total_usd, opus.total_usd * 2), `fable ${fable.total_usd} != 2× opus ${opus.total_usd}`);
+});

package/tests/credit_grant.mjs

@@ -516,6 +516,36 @@ await test('rewardPolicy: unknown/garbage mode → default (a typo never silentl
   assert.equal(rewardPolicy(undefined).perTaskCredit, true);
 });
 
+// ── ADR 0172: the ideator credit lane is SEPARATE from the builder estimate ──
+
+await test('rewardPolicy: ideatorCredit defaults ON, and a pre-0172 config keeps paying ideators', () => {
+  assert.equal(rewardPolicy({}).ideatorCredit, true, 'absent flag → the default TRUE');
+  assert.equal(rewardPolicy(null).ideatorCredit, true);
+  // a config written before this ADR (no ideatorCredit key) must not silently
+  // withhold the new lane
+  assert.equal(rewardPolicy({ mode: 'cost-plus-and-estimate', marginPct: 20 }).ideatorCredit, true);
+});
+
+await test('rewardPolicy: cost-plus-only WITHHOLDS the builder estimate but NOT the ideator lane', () => {
+  const p = rewardPolicy({ mode: 'cost-plus-only' });
+  assert.equal(p.perTaskCredit, false, 'the builder per-task estimate is off');
+  assert.equal(p.ideatorCredit, true, 'the ideator lane is a different craft\'s pay — unaffected');
+  // this is the whole point of ADR 0172: the two flags are independent
+  assert.notEqual(p.perTaskCredit, p.ideatorCredit);
+});
+
+await test('rewardPolicy: ideatorCredit is opt-out-only — only an explicit false withholds it', () => {
+  assert.equal(rewardPolicy({ ideatorCredit: false }).ideatorCredit, false, 'explicit opt-out');
+  // and it is orthogonal to mode: an instance can pay per-task estimate but NOT ideators
+  const p = rewardPolicy({ mode: 'cost-plus-and-estimate', ideatorCredit: false });
+  assert.equal(p.perTaskCredit, true);
+  assert.equal(p.ideatorCredit, false);
+  // any non-false value (a typo, a truthy) stays ON — never a silent zeroing
+  for (const v of [true, 1, 'yes', undefined, null]) {
+    assert.equal(rewardPolicy({ ideatorCredit: v }).ideatorCredit, true, `ideatorCredit=${JSON.stringify(v)} pays`);
+  }
+});
+
 await test('rewardPolicy: cost-plus-only still honors a custom margin + peg', () => {
   const p = rewardPolicy({ mode: 'cost-plus-only', marginPct: 35, usdPeg: 2 });
   assert.equal(p.perTaskCredit, false);

package/tests/llm-pricing.mjs

@@ -2,6 +2,9 @@
 // Prices VERIFIED 2026-06-20 against the live Anthropic models/pricing page
 // (GDS-V4 task 1343): opus (4.8/4.7) $5/$25, sonnet (4.6) $3/$15, haiku (4.5)
 // $1/$5; flat across the 1M window (no long-context premium).
+// Re-VERIFIED + extended 2026-08-16 (task 1002883): fable (Fable 5 / Mythos 5)
+// $10/$50 — the family familyFor() used to miss, so Fable sessions priced at the
+// opus fallback and cost-plus under-paid by half.
 // Run:  node tests/llm-pricing.mjs
 
 import { strict as assert } from 'node:assert';
@@ -18,6 +21,9 @@ const M = 1_000_000;
 const near = (a, b) => Math.abs(a - b) < 1e-6;
 
 test('familyFor matches by substring; unknown → null', () => {
+  assert.equal(familyFor('claude-fable-5'), 'fable');
+  assert.equal(familyFor('claude-mythos-5'), 'fable');   // same rates → same family
+  assert.equal(familyFor('claude-mythos-preview'), 'fable');
   assert.equal(familyFor('claude-opus-4-8'), 'opus');
   assert.equal(familyFor('claude-sonnet-4-6'), 'sonnet');
   assert.equal(familyFor('claude-haiku-4-5'), 'haiku');
@@ -26,6 +32,68 @@ test('familyFor matches by substring; unknown → null', () => {
   assert.equal(familyFor(undefined), null);
 });
 
+// ---------- fable / mythos family (task 1002883) ----------
+// The regression this locks: claude-fable-5 is the owner's top-model default and
+// the grader's assumed_builder_model, but familyFor() matched only opus/sonnet/
+// haiku — so it fell to the opus fallback (unknown_model=true) at HALF its rate,
+// and every cost-plus reward from a Fable session under-paid the builder.
+
+test('fable 5: 1M input + 1M output = $10 + $50 = $60, and is NOT flagged unknown', () => {
+  const r = priceUsage('claude-fable-5', { input_tokens: M, output_tokens: M });
+  assert.ok(near(r.usd, 60), `got ${r.usd}`);
+  assert.equal(r.unknown_model, false, 'fable must resolve, not ride the opus fallback');
+  assert.equal(r.family, 'fable');
+});
+
+test('mythos 5 prices identically to fable 5 (one family, shared rates)', () => {
+  const f = priceUsage('claude-fable-5', { input_tokens: M, output_tokens: M });
+  const m = priceUsage('claude-mythos-5', { input_tokens: M, output_tokens: M });
+  assert.ok(near(f.usd, m.usd), `fable ${f.usd} != mythos ${m.usd}`);
+  assert.equal(m.family, 'fable');
+});
+
+test('fable cache tiers: read $1, 5m write $12.50, 1h write $20 per 1M', () => {
+  assert.ok(near(priceUsage('claude-fable-5', { cache_read_input_tokens: M }).usd, 1));
+  assert.ok(near(priceUsage('claude-fable-5', {
+    cache_creation_input_tokens: M,
+    cache_creation: { ephemeral_5m_input_tokens: M, ephemeral_1h_input_tokens: 0 },
+  }).usd, 12.5));
+  assert.ok(near(priceUsage('claude-fable-5', {
+    cache_creation_input_tokens: M,
+    cache_creation: { ephemeral_5m_input_tokens: 0, ephemeral_1h_input_tokens: M },
+  }).usd, 20));
+});
+
+test('fable rides the published cache multipliers off its own base input (1.25× / 2× / 0.1×)', () => {
+  const { fable } = PRICES;
+  assert.ok(near(fable.cache_write_5m, fable.input * 1.25));
+  assert.ok(near(fable.cache_write_1h, fable.input * 2));
+  assert.ok(near(fable.cache_read, fable.input * 0.1));
+});
+
+test('fable is exactly 2× opus — the size of the pre-fix cost-plus shortfall', () => {
+  const usage = { input_tokens: M, output_tokens: M };
+  const fable = priceUsage('claude-fable-5', usage).usd;
+  const opus = priceUsage('claude-opus-5', usage).usd;
+  assert.ok(near(fable, opus * 2), `fable ${fable} != 2× opus ${opus}`);
+});
+
+test('priceModelUsage: a fable session costs $60 / 1M+1M and reports no unknown models', () => {
+  const r = priceModelUsage({ 'claude-fable-5': { input: M, output: M } });
+  assert.ok(near(r.true_cost_usd, 60), `got ${r.true_cost_usd}`);
+  assert.deepEqual(r.unknown_models, [], 'fable must not be reported as unpriced');
+});
+
+test('canonicalizeModelId collapses fable variants without changing the price', () => {
+  assert.equal(canonicalizeModelId('claude-fable-5[1m]'), 'claude-fable-5');
+  const r = priceModelUsage({
+    'claude-fable-5': { input: M },
+    'claude-fable-5[1m]': { input: M },
+  });
+  assert.equal(r.per_model.length, 2, 'raw keys kept as separate breakdown rows');
+  assert.ok(near(r.true_cost_usd, 20), `got ${r.true_cost_usd}`); // 10 + 10
+});
+
 test('opus 4.8: 1M input + 1M output = $5 + $25 = $30', () => {
   const r = priceUsage('claude-opus-4-8', { input_tokens: M, output_tokens: M });
   assert.ok(near(r.usd, 30), `got ${r.usd}`);