fix(docs): restore validation baseline (#883)

Refs #882

Author: hansjm10

docs/coverage/index.md

@@ -11,21 +11,21 @@ Use the manual **Coverage Report** GitHub Actions workflow to regenerate this pa
 | Metric | Covered | Total | % |
 | --- | --- | --- | --- |
 | Statements | 44821 | 49278 | 90.96% |
-| Branches | 9461 | 11036 | 85.73% |
+| Branches | 9462 | 11037 | 85.73% |
 | Functions | 2344 | 2502 | 93.69% |
 | Lines | 44821 | 49278 | 90.96% |
 
 ## Coverage by Package
 | Package | Statements | Branches | Functions | Lines |
 | --- | --- | --- | --- | --- |
-| @idle-engine/content-compiler | 1696 / 1913 (88.66%) | 291 / 371 (78.44%) | 102 / 106 (96.23%) | 1696 / 1913 (88.66%) |
+| @idle-engine/content-compiler | 1696 / 1913 (88.66%) | 289 / 369 (78.32%) | 102 / 106 (96.23%) | 1696 / 1913 (88.66%) |
 | @idle-engine/content-sample | 17 / 21 (80.95%) | 2 / 3 (66.67%) | 0 / 0 (0.00%) | 17 / 21 (80.95%) |
-| @idle-engine/content-schema | 8846 / 9915 (89.22%) | 1276 / 1494 (85.41%) | 313 / 343 (91.25%) | 8846 / 9915 (89.22%) |
+| @idle-engine/content-schema | 8846 / 9915 (89.22%) | 1277 / 1495 (85.42%) | 313 / 343 (91.25%) | 8846 / 9915 (89.22%) |
 | @idle-engine/content-validation-cli | 2045 / 2200 (92.95%) | 480 / 545 (88.07%) | 94 / 103 (91.26%) | 2045 / 2200 (92.95%) |
 | @idle-engine/controls | 228 / 230 (99.13%) | 67 / 69 (97.10%) | 14 / 14 (100.00%) | 228 / 230 (99.13%) |
-| @idle-engine/core | 24786 / 27368 (90.57%) | 5473 / 6488 (84.36%) | 1440 / 1539 (93.57%) | 24786 / 27368 (90.57%) |
+| @idle-engine/core | 24786 / 27368 (90.57%) | 5474 / 6489 (84.36%) | 1440 / 1539 (93.57%) | 24786 / 27368 (90.57%) |
 | @idle-engine/renderer-contract | 516 / 523 (98.66%) | 134 / 138 (97.10%) | 27 / 27 (100.00%) | 516 / 523 (98.66%) |
 | @idle-engine/renderer-debug | 870 / 876 (99.32%) | 255 / 266 (95.86%) | 49 / 49 (100.00%) | 870 / 876 (99.32%) |
-| @idle-engine/renderer-webgpu | 1943 / 1965 (98.88%) | 524 / 534 (98.13%) | 97 / 98 (98.98%) | 1943 / 1965 (98.88%) |
+| @idle-engine/renderer-webgpu | 1943 / 1965 (98.88%) | 525 / 535 (98.13%) | 97 / 98 (98.98%) | 1943 / 1965 (98.88%) |
 | @idle-engine/shell-desktop | 3858 / 4251 (90.76%) | 957 / 1126 (84.99%) | 208 / 223 (93.27%) | 3858 / 4251 (90.76%) |
 | idle-engine-monorepo | 16 / 16 (100.00%) | 2 / 2 (100.00%) | 0 / 0 (0.00%) | 16 / 16 (100.00%) |

docs/issue-157-design.md

@@ -79,7 +79,7 @@ This design adds a fast, release-gating schema compatibility check for `@idle-en
       - Build a `FeatureGateMap` where every module in `FEATURE_GATES` is treated as “in use”.
       - Assert `resolveFeatureViolations(RUNTIME_VERSION, allEnabledMap)` returns `[]`.
       - This directly enforces that `FEATURE_GATES[].introducedIn` never points to a future runtime release.
-    2. **Schema validates a compat pack under current runtime**
+    1. **Schema validates a compat pack under current runtime**
       - Construct a minimal pack object that includes at least one entry in each gated module array:
         - `automations`, `entities`, `transforms`, `runtimeEvents`, `prestigeLayers`
       - Ensure all cross references are self-contained (resources referenced by generators/transforms exist; prestige layers include the required `${layerId}-prestige-count` resource).

docs/issue-775-design.md

@@ -20,7 +20,7 @@ This design document proposes documenting the exact mathematical formulas used t
 ## 2. Context & Problem Statement
 - **Background**: The engine uses a flexible system for defining costs via `costCurve` (which supports various mathematical functions) and `costMultiplier`.
 - **Problem**: The exact formulas are not documented. Content creators resort to trial-and-error or reverse-engineering to understand how costs scale with level, leading to unexpected values and inefficient balancing workflows. The issue reporter specifically noted confusion around the `exponential` curve and how `offset` applies.
-- **Forces**: 
+- **Forces**:
     - Accuracy: The documentation must strictly reflect the runtime implementation.
     - Clarity: Formulas should be expressed in standard mathematical notation where possible, alongside JSON examples.
 
@@ -36,9 +36,9 @@ This design document proposes documenting the exact mathematical formulas used t
 
 ## 4. Stakeholders, Agents & Impacted Surfaces
 - **Primary Stakeholders**: Content Creators / Game Designers.
-- **Agent Roles**: 
+- **Agent Roles**:
     - **Documentation Agent**: Responsible for updating the markdown files.
-- **Affected Packages/Services**: 
+- **Affected Packages/Services**:
     - `docs/` (documentation only).
 - **Compatibility Considerations**: None (doc change only).
 
@@ -62,15 +62,15 @@ Where `evaluateNumericFormula` behaves as follows:
 We will add a new section "Cost Calculation Formulas" to `docs/content-dsl-usage-guidelines.md` (or `docs/content-quick-reference.md` as requested, but "Usage Guidelines" seems more appropriate for deep dives).
 
 The section will detail:
-1.  **Generator Cost Formula**: `FinalCost = BaseCostFromCurve * CostMultiplier * GlobalMultipliers`
-2.  **Upgrade Cost Formula**: `FinalCost = BaseCostFromCurve * CostMultiplier * RepeatableAdjustment` (no global multipliers; RepeatableAdjustment comes from `repeatable.costCurve` for repeatable upgrades, defaults to 1 otherwise)
-3.  **Curve Formulas**:
-    *   **Exponential**: `Cost(level) = base * growth^level + offset`
-        *   *Note: Explicitly clarify that `offset` is added to the result, not the level.*
-    *   **Linear**: `Cost(level) = base + slope * level`
-    *   **Constant**: `Cost(level) = value`
-    *   **Polynomial**: `Cost(level) = sum(coefficient_i * level^i)`
-4.  **Examples**: JSON snippets + calculated values for levels 0, 1, 10.
+1. **Generator Cost Formula**: `FinalCost = BaseCostFromCurve * CostMultiplier * GlobalMultipliers`
+2. **Upgrade Cost Formula**: `FinalCost = BaseCostFromCurve * CostMultiplier * RepeatableAdjustment` (no global multipliers; RepeatableAdjustment comes from `repeatable.costCurve` for repeatable upgrades, defaults to 1 otherwise)
+3. **Curve Formulas**:
+    - **Exponential**: `Cost(level) = base * growth^level + offset`
+        - *Note: Explicitly clarify that `offset` is added to the result, not the level.*
+    - **Linear**: `Cost(level) = base + slope * level`
+    - **Constant**: `Cost(level) = value`
+    - **Polynomial**: `Cost(level) = sum(coefficient_i * level^i)`
+4. **Examples**: JSON snippets + calculated values for levels 0, 1, 10.
 
 ### 6.2 Detailed Design
 No code changes.

docs/issue-809-design.md

@@ -204,4 +204,3 @@ The test suite (`packages/renderer-webgpu/src/webgpu-renderer.test.ts`) currentl
 | Date       | Author | Change Summary |
 |------------|--------|----------------|
 | 2026-01-21 | Codex (AI) | Initial draft for Issue 809 |
-

docs/issue-810-design.md

@@ -201,4 +201,3 @@ Add a renderer bundling step to `@idle-engine/shell-desktop`’s build:
 | Date       | Author          | Change Summary |
 |------------|-----------------|----------------|
 | 2026-01-24 | Ralph (AI agent) | Initial draft for issue-810 |
-

docs/issue-811-design.md

@@ -223,4 +223,3 @@ This keeps cleanup local and explicit without adding a general-purpose resource
 | Date       | Author | Change Summary |
 |------------|--------|----------------|
 | 2026-01-21 | Codex (AI) | Initial draft |
-

docs/issue-814-design.md

@@ -221,4 +221,3 @@ sidebar_position: 99
 | Date       | Author | Change Summary |
 |------------|--------|----------------|
 | 2026-01-24 | Codex (AI) | Initial draft for Issue 814 |
-

docs/issue-821-design.md

@@ -235,4 +235,3 @@ Example filtered definition (subset of generators):
 | Date       | Author | Change Summary |
 |------------|--------|----------------|
 | 2026-01-25 | Ralph (AI agent) | Initial draft for Issue 821 |
-

docs/issue-846-design.md

@@ -94,7 +94,7 @@ sidebar_position: 99
 ### 7.1 Issue Map
 | Issue Title | Scope Summary | Proposed Assignee/Agent | Dependencies | Acceptance Criteria |
 |-------------|---------------|-------------------------|--------------|---------------------|
-| `feat(renderer-webgpu): centralize texture usage for external copies` | Add a helper that applies required usage flags for `copyExternalImageToTexture` destinations; update atlas texture creation and usage enum fallbacks accordingly. | Renderer Implementation Agent | Doc approval | Atlas texture is created with `COPY_DST | RENDER_ATTACHMENT | TEXTURE_BINDING`; no scattered one-off bitmask tweaks; Node fallback constants include `RENDER_ATTACHMENT`. |
+| `feat(renderer-webgpu): centralize texture usage for external copies` | Add a helper that applies required usage flags for `copyExternalImageToTexture` destinations; update atlas texture creation and usage enum fallbacks accordingly. | Renderer Implementation Agent | Doc approval | Atlas texture is created with `COPY_DST`, `RENDER_ATTACHMENT`, and `TEXTURE_BINDING`; no scattered one-off bitmask tweaks; Node fallback constants include `RENDER_ATTACHMENT`. |
 | `test(renderer-webgpu): assert atlas texture usage flags` | Add regression tests verifying `createTexture` is called with the expected usage mask when `loadAssets()` uploads an atlas via `copyExternalImageToTexture`. | Test Agent | Implementation | New tests fail if `RENDER_ATTACHMENT` is omitted; tests run deterministically in Node with the existing WebGPU stubs. |
 | `docs(renderer-webgpu): document copyExternalImageToTexture backend variance` | Add a short rationale and reference links (GPUWeb issue, MDN/spec notes) explaining why `RENDER_ATTACHMENT` is included for external-copy destination textures. | Docs Agent | Implementation | Documentation exists either as code comments near the helper or as a package doc entry; references are linked. |
 
@@ -176,4 +176,3 @@ sidebar_position: 99
 | Date       | Author | Change Summary |
 |------------|--------|----------------|
 | 2026-01-26 | Codex (AI) | Initial draft |
-

docs/issue-850-design.md

@@ -121,7 +121,7 @@ This feature changes the **input event workflow** so that pointer/UI interaction
 | sim.running.input.enqueued | None (postMessage has no acknowledgment). | sim.running.input.idle | No-op. |
 | sim.running.input.dropped | None (event already dropped). | sim.running.input.idle | No-op. |
 | sim.running.input.rejected | None (event already rejected). | sim.running.input.idle | No-op. |
-| sim.running.input.* | `webContents.send(frame|simStatus)` throws (renderer not ready/crashed). | sim.running.input.* | Log error; continue sim tick loop; renderer recovery is via reload. |
+| sim.running.input.* | `webContents.send` throws for `frame` or `simStatus` (renderer not ready/crashed). | sim.running.input.* | Log error; continue sim tick loop; renderer recovery is via reload. |
 | sim.running.input.* | Worker becomes unresponsive (no `frame`/`ready`/`error` messages arrive). | sim.running.input.* | No automatic transition; renderer appears stalled; operator recovery is explicit restart (reload). |
 | sim.running.input.* | Worker exits with code `0`. | sim.stopped | Log stop; send `simStatus` (stopped); terminate worker; ignore further input until restart. |
 | sim.running.input.* | Worker exits non-zero OR emits `error`/`messageerror` OR sends `kind:'error'`. | sim.crashed | Log crash; send `simStatus` (crashed); terminate worker; ignore further input until restart. |
@@ -401,14 +401,14 @@ The `INPUT_EVENT` command is only allowed in the player priority lane so that UI
 3. **Parallel work**: Yes; after the IPC surface exists, renderer capture (T3) and main mapping (T4) can proceed in parallel; sim-runtime wiring (T5) can proceed after core types land (T1).
 
 ### Ordering Gates
-7. **Must be done first**: Define shared types + `INPUT_EVENT` command type in `@idle-engine/core` (T1).
-8. **Must be done last**: Integration checks + coverage/docs regeneration (T6).
-9. **Circular dependencies**: None in this breakdown; shared input-event types live in `@idle-engine/core` to avoid core↔shell cycles.
+1. **Must be done first**: Define shared types + `INPUT_EVENT` command type in `@idle-engine/core` (T1).
+2. **Must be done last**: Integration checks + coverage/docs regeneration (T6).
+3. **Circular dependencies**: None in this breakdown; shared input-event types live in `@idle-engine/core` to avoid core↔shell cycles.
 
 ### Infrastructure Gates
-10. **Build/config changes**: None expected beyond updating TypeScript sources and checked-in `dist/` outputs via existing `pnpm build` scripts.
-11. **New dependencies**: None.
-12. **Env vars/secrets**: None required; optional dev-only `IDLE_ENGINE_ENABLE_UNSAFE_WEBGPU=1` remains unchanged.
+1. **Build/config changes**: None expected beyond updating TypeScript sources and checked-in `dist/` outputs via existing `pnpm build` scripts.
+2. **New dependencies**: None.
+3. **Env vars/secrets**: None required; optional dev-only `IDLE_ENGINE_ENABLE_UNSAFE_WEBGPU=1` remains unchanged.
 
 ### Task Dependency Graph
 ```