@gobing-ai/spur 0.3.8 → 0.3.9

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,11 @@ include:
 exclude:
   - "**/node_modules/**"
   - "**/dist/**"
+  # 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.9",
     "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"

package/spur.js

@@ -38376,9 +38376,16 @@ function walk(dir, relPrefix, filter = /\.(ya?ml|json)$/i) {
   }
   return acc;
 }
-var BUNDLED_CONFIG_DIRS, cachedRoot;
+function listBundledProjectSeedFiles() {
+  const root = bundledConfigRoot();
+  if (root === null)
+    return [];
+  return walk(root, "", PROJECT_SEED_FILTER).filter((rel) => rel !== BUNDLED_CONFIG_EXAMPLE).sort();
+}
+var BUNDLED_CONFIG_DIRS, cachedRoot, PROJECT_SEED_FILTER, BUNDLED_CONFIG_EXAMPLE = "config.example.yaml";
 var init_bundled_config = __esm(() => {
   BUNDLED_CONFIG_DIRS = ["config", "spur-cli/config"];
+  PROJECT_SEED_FILTER = /\.(ya?ml|json|md|gitkeep)$/i;
 });
 
 // ../../packages/config/src/template-renderer.ts
@@ -71770,7 +71777,7 @@ import { join as join14, resolve as resolve5 } from "path";
 var CLI_CONFIG = {
   binaryName: "spur",
   binaryLabel: "spur",
-  binaryVersion: "0.3.8",
+  binaryVersion: "0.3.9",
   configDir: ".spur",
   configFile: ".spur/config.yaml",
   databaseFile: ".spur/spur.db"
@@ -71967,6 +71974,14 @@ ${contextEntry}
     if (!minimal) {
       const configRoot = bundledConfigRoot();
       if (configRoot !== null) {
+        for (const relPath of listBundledProjectSeedFiles()) {
+          const sourcePath = join14(configRoot, relPath);
+          if (!await context4.fs.exists(sourcePath))
+            continue;
+          const targetPath = join14(context4.cwd, CLI_CONFIG.configDir, relPath);
+          await context4.fs.ensureDir(join14(targetPath, ".."));
+          await writeIfNew(context4, targetPath, await context4.fs.readFile(sourcePath), force, result);
+        }
         for (const entry of SCAFFOLD_MANIFEST) {
           const sourcePath = join14(configRoot, entry.source);
           if (!await context4.fs.exists(sourcePath))
@@ -81146,6 +81161,8 @@ async function runTaskActionJob(ctx, env, payload, createAgentService = createTa
 async function resolveWebDistPath(configuredPath) {
   const candidates = configuredPath && configuredPath.trim() !== "" ? [isAbsolute3(configuredPath) ? configuredPath : join18(process.cwd(), configuredPath)] : [
     join18(process.cwd(), "dist/web"),
+    join18(import.meta.dir, "web"),
+    join18(dirname12(process.execPath), "web"),
     join18(dirname12(process.execPath), "../web"),
     join18(import.meta.dir, "../../../dist/web")
   ];
@@ -81172,12 +81189,16 @@ async function startServer(options, deps = defaultDeps) {
       if (bootConfig.scheduler.enabled) {
         scheduler3 = await deps.createScheduler();
       }
+      const webDistPath = await resolveWebDistPath(options.webDistPath);
+      if (!webDistPath) {
+        appRt.logger.warn("Board UI static assets not found \u2014 /board will return 404. " + "Reinstall a package that includes the web board, or set server.webDistPath to a built dist/web directory (index.html).");
+      }
       const ctx = deps.createServerContext(appRt, {
         cwd: process.cwd(),
         fs: fs3,
         dbUrl: options.dbUrl,
         folders: await resolvePlanningFolders(fs3),
-        webDistPath: await resolveWebDistPath(options.webDistPath),
+        webDistPath,
         jobQueueEnabled: bootConfig.jobqueue.enabled,
         scheduler: scheduler3,
         teamAutostart: bootConfig.teamAutostart,
@@ -81255,9 +81276,13 @@ async function startServer(options, deps = defaultDeps) {
       process.on("SIGINT", () => void shutdown("SIGINT"));
       process.on("SIGTERM", () => void shutdown("SIGTERM"));
       const url2 = `http://${options.host}:${options.port}`;
-      appRt.logger.info("Server started", { port: options.port, host: options.host });
+      appRt.logger.info("Server started", {
+        port: options.port,
+        host: options.host,
+        board: webDistPath ? `${url2}/board` : null
+      });
       if (options.openBrowser) {
-        await deps.openUrl(`${url2}/board`);
+        await deps.openUrl(webDistPath ? `${url2}/board` : `${url2}/api/health`);
       }
       if (options.keepAlive !== false) {
         await new Promise(() => {});

package/web/_astro/BoardApp.Bcfvp2GH.js

@@ -0,0 +1 @@
+import{a as t}from"./BoardApp.DjpO2XHn.js";import"./index.A0eX93qW.js";export{t as default};