@gobing-ai/spur 0.3.8 → 0.3.10

package/README.md

@@ -45,10 +45,25 @@ If `~/.local/bin` isn't already on your `PATH`, add it (e.g. `export PATH="$HOME
 in your shell profile). Supported targets: `darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`.
 Windows: use the Bun path under WSL.
 
+### Package layout (what ships)
+
+The published tarball is a self-contained Bun bundle plus static assets:
+
+| Path | Purpose |
+|------|---------|
+| `spur.js` | CLI entry (`bin.spur`) |
+| `config/` | Default rules, workflows, tasks, templates, plugins (ADR-015 SSOT) |
+| `web/` | Spur Board SPA served by `spur serve` |
+| `schemas/` | JSON Schema for editor/CI validation |
+
+`spur init` copies the full `config/` tree into the project `.spur/` directory (and seeds
+`~/.config/spur/` globally on first run). `spur serve` resolves board assets from package `web/`.
+
 ### First run
 
 ```bash
-spur init     # seeds ~/.config/spur/ (config.yaml, rules/, workflows/) — idempotent, never clobbers
+spur init     # scaffold .spur/ from bundled config/ + seed ~/.config/spur/ — idempotent, never clobbers
+spur serve    # local board at http://localhost:3000/board (uses package web/)
 ```
 
 The standalone installer runs `spur init` for you; the Bun install does it on your first `spur init`.
@@ -57,7 +72,8 @@ The standalone installer runs `spur init` for you; the Bun install does it on yo
 
 ```bash
 spur init                                  # scaffold .spur/ + seed global rules
-spur rule run --preset recommended         # evaluate constraint rules
+spur serve --port 5678                     # start API + Spur Board
+spur rule run --preset recommended-pre-check   # evaluate constraint rules
 spur workflow run <workflow.yaml>          # run an FSM workflow
 spur agent run "<prompt>" --agent auto     # execute a prompt via a coding agent
 spur agent doctor                          # check agent readiness

package/{spur-cli/config → config}/rules/boundary/sp-runtime-path.yaml

@@ -17,6 +17,15 @@ include:
 exclude:
   - "**/node_modules/**"
   - "**/dist/**"
+  # `.pi-lens/cache/` holds autogenerated project snapshots (absolute paths that
+  # legitimately contain `config/...` substrings). Not source — exclude to avoid
+  # triaging snapshot noise every pre-check.
+  - "**/.pi-lens/**"
+  # Package build artifacts: `build:bundle` copies repo-root config/ → apps/cli/config/
+  # (and legacy spur-cli/config/). Those trees are the ADR-015 SSOT payload itself and
+  # legitimately contain `config/...` documentation / self-references — not runtime paths.
+  - "apps/cli/config/**"
+  - "apps/cli/spur-cli/**"
 rules:
   - id: sp-runtime-path
     description: >

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.8",
+    "version": "0.3.10",
     "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",
@@ -28,8 +28,9 @@
     },
     "files": [
         "spur.js",
-        "spur-cli",
+        "config",
         "schemas",
+        "web",
         "README.md"
     ],
     "engines": {
@@ -42,7 +43,7 @@
         "dev": "bun run src/index.ts",
         "build": "bun run ../../scripts/spur-dev.ts build-cli",
         "build:binaries": "bun run ../../scripts/spur-dev.ts build-binaries",
-        "build:bundle": "bun build src/index.ts --target=bun --outfile spur.js && bun run ../../scripts/spur-dev.ts bundle-config spur-cli/config",
+        "build:bundle": "bun run ../../scripts/spur-dev.ts bundle-web && bun build src/index.ts --target=bun --outfile spur.js && bun run ../../scripts/spur-dev.ts bundle-config config",
         "test": "bun test tests --coverage --coverage-dir=../../.coverage --pass-with-no-tests",
         "typecheck": "tsc --noEmit",
         "prepublishOnly": "bun run build:bundle"