@gobing-ai/spur 0.3.29 → 0.3.30

package/config/templates/AGENTS.md

@@ -104,14 +104,9 @@ feature status → `05`. Working-layer, audit, and satellite rules live in the p
 
 ## Design system
 
-**Conditional contract:** If repository-root `DESIGN.md` exists, read it before planning or
-implementing any change to UI, styling, interaction, accessibility, or responsive behavior. Treat
-it as the project source of truth for visual and interaction design — tokens, components, patterns,
-and UX constraints — and keep affected work consistent with it. If it is absent, continue with the
-project's established UI conventions.
-
-Root `DESIGN.md` owns UI/UX guidance; `docs/04_DESIGN.md` still owns command, config, schema, and DTO
-surface shapes under the doc map above.
+**Conditional contract:** If repository-root `DESIGN.md` exists, leverage it dynamically as the industry-standard SSOT for UI design documentation — visual language, color tokens, typography, component specs, layout, micro-animations, accessibility, and responsive patterns. Read it before planning or implementing any UI changes, and keep affected work consistent with it. If `DESIGN.md` is absent, ignore it and continue with the project's established UI conventions.
+
+**Boundary distinction:** Root `DESIGN.md` owns UI/UX design guidance; `docs/04_DESIGN.md` owns non-UI surface design by default (command signatures, flags, config schemas, DTOs, and system boundaries). When working with design teams, choose `DESIGN.md` for UI/UX visual design and `docs/04_DESIGN.md` for non-UI API/schema surfaces.
 
 ---
 

package/config/templates/docs/04_DESIGN.md

@@ -18,12 +18,15 @@ sync: [T3, T9]
 > `docs/design/<slug>.md` satellite; this index carries the surface map + pointers.
 > Edit order: satellite first, then index row — same change (T9).
 
-## UI/UX boundary
+## UI/UX boundary & DESIGN.md
 
-Repository-root `DESIGN.md` owns all UI/UX design, including visual language, design tokens,
-components, layout, interaction, accessibility, and responsive behavior. Read and update it for UI
-work; keep this document focused on non-UI surface design. If `DESIGN.md` is absent, follow the
-project's established UI conventions rather than adding UI guidance here.
+Repository-root `DESIGN.md` owns all UI/UX design documentation (industry standard visual language, color tokens, typography, component specs, accessibility, and responsive patterns). Read and update it for UI work; keep `docs/04_DESIGN.md` focused on non-UI surface design by default. If `DESIGN.md` is absent, ignore it and follow the project's established UI conventions.
+
+By contrast, `docs/04_DESIGN.md` is our SSOT of non-UI surface design by default — covering CLI command signatures, flags, config schemas, DTOs, tables, and system boundaries.
+
+When collaborating with the design team:
+- **UI/UX & Visual Design:** Refer to and update repository-root `DESIGN.md`.
+- **Non-UI Surface & API/Schema DTOs:** Refer to and update `docs/04_DESIGN.md` (and `docs/design/<slug>.md` satellites).
 
 ## 1. CLI commands
 

package/config/templates/docs/99_PROJECT_CONSTITUTION.md

@@ -80,7 +80,8 @@ Each project's `AGENTS.md` embeds an instantiated copy of this table (§4.4). A
 | `docs/01_PRD.md` | **WHAT** — product vision, users, scope (in / out / deferred) | **Authoritative on scope** | Read before adding a command/feature; edit when scope changes |
 | `docs/02_ROADMAP.md` | **WHEN** — phases, current vs deferred, sequencing | Derived | Read to place work in a phase; edit when phase status changes |
 | `docs/03_ARCHITECTURE.md` | **HOW** — module boundaries, data flow, runtime model, invariants, rationale-in-depth | Derived (ADR wins) | Read before cross-module/seam/schema work; edit when boundaries or mechanisms change |
-| `docs/04_DESIGN.md` | **SURFACE** — concrete shapes: every CLI command, flag, config key, env var, table, DTO; **index over `docs/design/<slug>.md`** (§4.5) | Derived | Read/edit when changing a command, flag, env var, or schema — same commit |
+| `docs/04_DESIGN.md` | **SURFACE** — concrete shapes: every CLI command, flag, config key, env var, table, DTO; **index over `docs/design/<slug>.md`** (§4.5) | Derived | Read/edit when changing a non-UI command, flag, env var, or schema — same commit |
+| `DESIGN.md` (repo root) | **UI/UX SURFACE** — visual design, color tokens, typography, component specs, layout, micro-animations, accessibility | **Authoritative for UI/UX when present** | Read/edit when planning or implementing UI/UX visual changes (dynamically supported; ignored when absent) |
 | `docs/05_FEATURES.md` | **STATUS** — feature decomposition + state (✅ done / 🔶 partial / ⏳ planned / 💤 deferred); **index over `docs/features/<id>_<slug>.md`** (§4.5) | Derived | Read to find a feature's state; edit when a feature's status changes |
 | `docs/99_PROJECT_CONSTITUTION.md` | **PROCESS** — how the files above are maintained | **Authoritative on process** | Read before editing any doc above; edit per §6.8 |
 | `AGENTS.md` (repo root) | **ENTRY** — how agents work in this repo: stack, commands, gates, conventions + the instantiated doc map | Derived (from 99 + 00/01/04) | Read first every session; regenerate factual blocks from code (§6.7) |
@@ -89,7 +90,8 @@ Each project's `AGENTS.md` embeds an instantiated copy of this table (§4.4). A
 
 - Decision + one-line reason → `00`. Rationale/mechanism in depth → `03`.
 - Scope (in/out/deferred) → `01`. Mechanism / data flow / invariants → `03`.
-- Command/flag/config/schema/DTO shapes → `04`. Phase timing → `02`. Feature status → `05`.
+- UI/UX visual design, design tokens, component specs & accessibility → `DESIGN.md` (when present; otherwise follow established project UI conventions).
+- Non-UI command/flag/config/schema/DTO shapes → `04`. Phase timing → `02`. Feature status → `05`.
 - If you are writing *how it's built* or *why* inside `00`/`01`/`02`, it belongs in `03`/`04`.
 
 ### 4.2 Working layers (outside the authority chain)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.29",
+    "version": "0.3.30",
     "description": "Spur CLI — local-first harness for mainstream coding agents: constraint checking, workflow orchestration, agent health, and history analytics. Bun-native; exposes the `spur` command.",
     "keywords": [
         "spur",
@@ -50,14 +50,14 @@
     },
     "devDependencies": {
         "@commander-js/extra-typings": "^14.0.0",
-        "@gobing-ai/ts-db": "^0.4.15",
-        "@gobing-ai/ts-ai-runner": "^0.4.15",
-        "@gobing-ai/ts-dual-workflow-engine": "^0.4.15",
-        "@gobing-ai/ts-infra": "^0.4.15",
-        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.15",
-        "@gobing-ai/ts-rule-engine": "^0.4.15",
-        "@gobing-ai/ts-runtime": "^0.4.15",
-        "@gobing-ai/ts-utils": "^0.4.15",
+        "@gobing-ai/ts-db": "^0.4.16",
+        "@gobing-ai/ts-ai-runner": "^0.4.16",
+        "@gobing-ai/ts-dual-workflow-engine": "^0.4.16",
+        "@gobing-ai/ts-infra": "^0.4.16",
+        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.16",
+        "@gobing-ai/ts-rule-engine": "^0.4.16",
+        "@gobing-ai/ts-runtime": "^0.4.16",
+        "@gobing-ai/ts-utils": "^0.4.16",
         "@types/bun": "1.3.14",
         "@types/figlet": "^1.7.0",
         "@types/node-notifier": "8.0.5",