@gobing-ai/spur 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.5",
+    "version": "0.3.6",
     "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",

package/spur-cli/config/rules/typescript/no-unmocked-module-eval-side-effects.yaml

@@ -55,6 +55,13 @@ rules:
     evaluator:
       type: rg
       config:
-        # Match imports from modules with known module-eval side effects.
-        # Add new patterns here as alternations (|) when new cases are discovered.
-        pattern: "from ['\"].*task-kanban/useTasks['\"]"
+        # Match imports from modules with KNOWN, ACTIVE module-eval side effects.
+        # IMPORTANT: this rule is INERT unless a pattern is present. When a new
+        # side-effect module is discovered (CI-only ordering failure traced to
+        # an import-time call), add its import pattern here as a string. Remove
+        # the pattern once the source module is fixed (side effects made lazy).
+        #
+        # RESOLVED modules (patterns removed after fix — kept as history):
+        #   - task-kanban/useTasks — fixed 2026-07-08, commit 3937d31
+        #     (resolveApiUrl/api.task.list converted to lazy dynamic imports)
+        pattern: "__no_active_side_effect_modules__"

package/spur-cli/config/templates/AGENTS.md

@@ -0,0 +1,40 @@
+# AGENTS.md
+
+Guidance for AI coding agents working in this repository.
+
+## Project
+
+<!-- Replace the line below with your project name and a one-line description. -->
+**{project-name}** — (one-line description).
+
+## Commands
+
+<!-- Fill in the build/test/lint commands for this project. Examples: -->
+```bash
+# build
+# test
+# lint
+```
+
+## Conventions & boundaries
+
+- Conventional Commits required (`feat:`, `fix:`, `docs:`, `chore:`, ...). Breaking changes in a `BREAKING CHANGE:` footer.
+- Never commit secrets, `.env*`, or credentials.
+- Surgical changes only: touch what the task needs; no drive-by refactors, no speculative abstractions,
+  no comments that restate what the code already says.
+
+---
+
+## Indexed context
+
+Project context lives in `.spur/context/` (gitignored) and is surfaced by the `sp:indexed-context` skill.
+Check it before re-reading files you may already have indexed:
+
+1. `.spur/context/anatomy.md` — one-line description + token estimate per file. Read before opening a file.
+2. `.spur/context/learnings.md` — project conventions, decisions, preferences. Read before generating code.
+3. `.spur/context/pitfalls.md` — dated "do-not-repeat" entries. Read before generating code.
+4. `.spur/context/buglog.md` — historical bug log. Read before fixing a bug.
+5. `.spur/context/memory.md` — session log. Append one line per significant action.
+6. `.spur/context/token-ledger.jsonl` — auto-tracked by hooks; never hand-edit.
+
+If `.spur/context/` is absent, proceed normally. Never block work on its absence.

package/spur-cli/config/templates/docs/00_ADR.md

@@ -12,6 +12,9 @@ updated_at: 1970-01-01T00:00:00.000Z
 
 > Authoritative on **decisions**. Lower number wins — this doc overrides all others on decisions.
 > Each entry is append-only; supersession is by a new dated entry, never by editing an old one.
+> Only real cross-cutting decisions belong here — not implementation notes, not feature status, not
+> how-to guidance. Entries that grow past decision + reason are carrying mechanism that belongs in
+> `03`/`04`; link it instead of inlining it.
 
 ## ADR-001 — (example) Adopt this doc structure
 
@@ -24,4 +27,6 @@ updated_at: 1970-01-01T00:00:00.000Z
 <!--
 Add new ADRs here. Copy the entry shape above (Date, Status, Context, Decision, Reason).
 A decision that reverses a prior ADR adds a new entry that says "supersedes ADR-NNN".
+An Amendment records the decision delta + one-line reason — not the mechanism. Implementation
+paths, detailed semantics, and multi-paragraph rationale belong in 03/04, not in the amendment.
 -->

package/spur-cli/config/templates/docs/99_PROJECT_CONSTITUTION.md

@@ -53,7 +53,7 @@ When a change touches one of these, the listed doc MUST be updated in the **same
 
 | ID | Trigger | Doc(s) |
 |----|---------|--------|
-| T1 | New cross-cutting decision | `00` first, then `03` mechanism |
+| T1 | New cross-cutting decision (entry = decision + one-line reason; amendment = decision delta only — mechanism goes in `03`/`04`, not the amendment) | `00` first, then `03` mechanism |
 | T3 | Command/flag/config/schema/DTO added/changed | `04` + `AGENTS.md` |
 | T4 | Feature ships or changes state | `05` row |
 | T6 | Scope added / cut / deferred | `01` |

package/spur.js

@@ -70181,7 +70181,7 @@ import { join as join13, resolve as resolve5 } from "path";
 var CLI_CONFIG = {
   binaryName: "spur",
   binaryLabel: "spur",
-  binaryVersion: "0.3.5",
+  binaryVersion: "0.3.6",
   configDir: ".spur",
   configFile: ".spur/config.yaml",
   databaseFile: ".spur/spur.db"
@@ -70227,7 +70227,8 @@ var SCAFFOLD_MANIFEST = [
   { source: "templates/docs/02_ROADMAP.md", target: "templates/docs/02_ROADMAP.md" },
   { source: "templates/docs/03_ARCHITECTURE.md", target: "templates/docs/03_ARCHITECTURE.md" },
   { source: "templates/docs/04_DESIGN.md", target: "templates/docs/04_DESIGN.md" },
-  { source: "templates/docs/05_FEATURES.md", target: "templates/docs/05_FEATURES.md" }
+  { source: "templates/docs/05_FEATURES.md", target: "templates/docs/05_FEATURES.md" },
+  { source: "templates/AGENTS.md", target: "AGENTS.md", root: true, preserve: true }
 ];
 
 // src/commands/init.ts
@@ -70235,6 +70236,24 @@ var GLOBAL_CONFIG_DIR2 = join13(".config", "spur");
 var GLOBAL_RULES_DIR2 = join13(GLOBAL_CONFIG_DIR2, "rules");
 var GLOBAL_CONFIG_EXAMPLE = "config.example.yaml";
 var GLOBAL_CONFIG_FILE2 = "config.yaml";
+var INDEXED_CONTEXT_MARKER = "## Indexed context";
+var INDEXED_CONTEXT_BLOCK = `
+---
+
+## Indexed context
+
+Project context lives in \`.spur/context/\` (gitignored) and is surfaced by the \`sp:indexed-context\` skill.
+Check it before re-reading files you may already have indexed:
+
+1. \`.spur/context/anatomy.md\` \u2014 one-line description + token estimate per file. Read before opening a file.
+2. \`.spur/context/learnings.md\` \u2014 project conventions, decisions, preferences. Read before generating code.
+3. \`.spur/context/pitfalls.md\` \u2014 dated "do-not-repeat" entries. Read before generating code.
+4. \`.spur/context/buglog.md\` \u2014 historical bug log. Read before fixing a bug.
+5. \`.spur/context/memory.md\` \u2014 session log. Append one line per significant action.
+6. \`.spur/context/token-ledger.jsonl\` \u2014 auto-tracked by hooks; never hand-edit.
+
+If \`.spur/context/\` is absent, proceed normally. Never block work on its absence.
+`;
 function globalRulesRoot(context3) {
   const override = context3.env.SPUR_GLOBAL_RULES_DIR;
   return override !== undefined && override.length > 0 ? resolve5(context3.cwd, override) : join13(homedir5(), GLOBAL_RULES_DIR2);
@@ -70336,6 +70355,22 @@ function registerInitCommand(program2, context3) {
     const agentsDir = join13(context3.cwd, CLI_CONFIG.configDir, "agents");
     await context3.fs.ensureDir(agentsDir);
     await writeIfNew(context3, join13(agentsDir, ".gitkeep"), "", force, result);
+    const gitignorePath = join13(context3.cwd, ".gitignore");
+    const contextEntry = ".spur/context/";
+    if (await context3.fs.exists(gitignorePath)) {
+      const existing = await context3.fs.readFile(gitignorePath);
+      if (!existing.includes(contextEntry)) {
+        await context3.fs.writeFile(gitignorePath, `${existing.trimEnd()}
+
+# Spur indexed-context (machine-generated)
+${contextEntry}
+`);
+      }
+    } else {
+      await context3.fs.writeFile(gitignorePath, `# Spur indexed-context (machine-generated)
+${contextEntry}
+`);
+    }
     if (!minimal) {
       const configRoot = bundledConfigRoot();
       if (configRoot !== null) {
@@ -70351,6 +70386,14 @@ function registerInitCommand(program2, context3) {
         }
       }
     }
+    const agentsMdPath = join13(context3.cwd, "AGENTS.md");
+    if (await context3.fs.exists(agentsMdPath)) {
+      const existing = await context3.fs.readFile(agentsMdPath);
+      if (!existing.includes(INDEXED_CONTEXT_MARKER)) {
+        await context3.fs.writeFile(agentsMdPath, `${existing.trimEnd()}${INDEXED_CONTEXT_BLOCK}`);
+        result.created.push(agentsMdPath);
+      }
+    }
     const db2 = await context3.getDb();
     await new ArtifactDao(db2).record({ path: configPath, kind: "config" });
     const rulesSeeded = await seedGlobalRules(context3);