spexcode 0.2.3 → 0.2.4

package/README.md

@@ -14,9 +14,9 @@
 Spec-driven development with AI agents in the loop. SpexCode keeps a versioned tree of specs inside
 your git repo, links every spec to the code it governs, and runs a session manager that dispatches
 coding agents into isolated worktrees. You review and merge; the tool keeps intent and
-implementation from drifting apart. (All screenshots below are this very repo on its own board.)
+implementation from drifting apart.
 
-[![This repo's spec tree, grown from its own git history](docs/spec-tree-hero.gif)](https://spexcode.net/assets/spec-tree-growth.mp4)
+[![Watch: this repo's spec tree grow from its git history](docs/spec-tree-poster.jpg)](https://spexcode.net/assets/spec-tree-growth.mp4)
 
 <sub>▶ This repo's own spec tree, replayed from its git history — 160 spec nodes growing over three weeks. Click for the [full video](https://spexcode.net/assets/spec-tree-growth.mp4).</sub>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spexcode",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "description": "SpexCode — a spec-driven, self-developing dev tool. The `spex` CLI + spec server reads the .spec tree and its git history, and serves the dashboard.",
   "license": "MIT",

package/spec-cli/src/sessions.ts

@@ -4,6 +4,7 @@ import { randomUUID } from 'node:crypto'
 import { readFileSync, writeFileSync, appendFileSync, existsSync, renameSync, mkdirSync, rmSync, readdirSync, realpathSync, statSync } from 'node:fs'
 import { join, dirname, relative, isAbsolute } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { linkUntrackedSpecSources } from './worktree-sources.js'
 import { git, gitA, gitTry, repoRoot, mergeBaseDiff, mergeConflicts, type ReviewDiffFile } from './git.js'
 import { loadSpecs } from './specs.js'
 import { defaultHarness, defaultLauncher, harnessById, resolveLauncher, rvSock, rendezvousListening, type Harness, type DispatchResult, type PaneProbe, type ProcTable } from './harness.js'
@@ -1061,6 +1062,9 @@ export async function newSession(node: string | null, prompt: string, parent: st
   const branch = `node/${slug}`
   const path = join(mainRoot(), '.worktrees', slug)
   await gitA(['-C', mainRoot(), 'worktree', 'add', '-b', branch, path, mainBranch()])
+  // a private-overlay repo keeps the spec sources out of git, so the checkout alone leaves this worktree
+  // spec-blind and hook-dead — link them from main ([[private-overlay]]; no-op on a default-mode repo).
+  linkUntrackedSpecSources(mainRoot(), path)
   // prepared but NOT launched: enters the queue as `queued`. drainQueue() below launches it at once when a
   // slot is free, else it waits — durable as a global record (+ its worktree), so it survives a backend
   // restart and is still findable. governed:true — this is a DASHBOARD/CLI-launched session, so it feeds the

package/spec-cli/src/worktree-sources.ts

@@ -0,0 +1,19 @@
+import { existsSync, symlinkSync } from 'node:fs'
+import { join } from 'node:path'
+
+// @@@ worktree-sources ([[private-overlay]]) - a fresh session worktree checks out only TRACKED content, and
+// private mode keeps `.spec` + `spexcode.json` untracked (spexcode.local.json is untracked in BOTH modes) —
+// so git alone hands a dispatched agent a worktree with NO spec tree: every hook handler script is absent
+// (the dispatcher silently runs nothing), spex sees zero nodes, and the gate re-renders per event over empty
+// config roots. Link those sources from the main checkout instead. On a default-mode repo the checkout
+// already carries them, so each link guard no-ops — one mechanism, never a mode branch. A failure degrades
+// that worker (no hooks, no specs), so it is reported, not swallowed.
+export function linkUntrackedSpecSources(main: string, wt: string): void {
+  for (const f of ['.spec', 'spexcode.json', 'spexcode.local.json']) {
+    try {
+      if (existsSync(join(main, f)) && !existsSync(join(wt, f))) symlinkSync(join(main, f), join(wt, f))
+    } catch (e) {
+      console.error(`spexcode: could not link ${f} from ${main} into worktree ${wt} — that worker runs without it (${e})`)
+    }
+  }
+}