@yeison.restrepo.r/code-conductor 1.23.1 → 1.23.3

package/bin/code-conductor.mjs

@@ -87,7 +87,7 @@ export function run(argv, env = process.env, { cwd = process.cwd(), log } = {})
   // and the environment codes (EROFS/EACCES/EPERM), which are exit 1 regardless.
   let writing = false;
   try {
-    assertAssets(assetRoot, ['global', 'skills', 'project-template']); // pre-flight
+    assertAssets(assetRoot, ['global', 'skills', 'scripts', 'project-template']); // pre-flight
     writing = true;                                                    // copy phase begins
     const claudeDir = deployGlobal(assetRoot, home);
     chmodHooks(claudeDir);

package/global/commands/cc-checkpoint.md

@@ -32,16 +32,16 @@ Run **only after** the `project.md` append succeeded (authoritative). Any failur
 
 1. Ensure `.conductor/` exists (`mkdir -p .conductor`, best-effort); if that fails, skip the tail.
 2. Derive `c` — the **full-40** `git rev-parse HEAD` (lowercased, `/^[0-9a-f]{7,40}$/`, `"0000000"` fallback on non-zero/timeout/git-absent/format-mismatch; shell `timeout` only if the binary exists).
-3. Resolve the id: `id="$(node scripts/session-id.mjs 2>>.conductor/last-write.log)"`.
-4. Derive `ph` by carry-forward: with a bounded ~5 s outer timeout (only if `timeout` exists; `conductor-db`'s internal 2 s `busy_timeout` bounds real contention otherwise), run `node <probe-flags> scripts/conductor-db.mjs get-session "$id"`; if it prints a row whose `phase` is a non-empty enum member, reuse it. On no row, empty phase, DB unavailable, or timeout, default to `"impl"`.
+3. Resolve the id: `id="$(node .claude/scripts/session-id.mjs 2>>.conductor/last-write.log)"`.
+4. Derive `ph` by carry-forward: with a bounded ~5 s outer timeout (only if `timeout` exists; `conductor-db`'s internal 2 s `busy_timeout` bounds real contention otherwise), run `node <probe-flags> .claude/scripts/conductor-db.mjs get-session "$id"`; if it prints a row whose `phase` is a non-empty enum member, reuse it. On no row, empty phase, DB unavailable, or timeout, default to `"impl"`.
 5. Set `pr` to the **verbatim `## Checkpoint …` section body** just appended to `project.md` (the same in-context string) — so `project.md` and the snapshot's `pr` are byte-identical. `pr` is always non-empty here, so the blob is always **v2**.
 6. Project `d` / `x` from that section (best-effort): match headings `/^#{2,4}[ \t]+(.+?)[ \t]*$/`; normalize the heading text by removing all `*`, `_`, `` ` `` then `.trim()` + lowercase; a heading containing `decision` or `convention` opens a `d` block, one containing `debt`, `workaround`, or `limitation` opens an `x` block. **The `d` set is tested first and wins** (a heading matching both opens one `d` block). The parent `## Checkpoint …` heading matches no keyword, so it opens no block and closes any open one. Within a block, bullet lines `/^[ \t]*[-*][ \t]+(\S.*?)[ \t]*$/` contribute their trimmed capture (line-based; continuation lines ignored — the full text survives in `pr`). If unstructured, `d`/`x` may be empty (valid).
 7. Defaults: `n=[]`, `f=[]`, `s`= the active spec stem or `"none"`.
-8. Build the v2 blob: pipe `{ph, c, s, n, f, d, x, pr}` on **stdin** to `node scripts/snap-build.mjs`; capture its stdout. If it exits non-zero, skip the DB write (fail-open).
+8. Build the v2 blob: pipe `{ph, c, s, n, f, d, x, pr}` on **stdin** to `node .claude/scripts/snap-build.mjs`; capture its stdout. If it exits non-zero, skip the DB write (fail-open).
 9. Write the rows (both argv double-quoted; blob on stdin; all output to the log):
 
-   `node <probe-flags> scripts/conductor-db.mjs session "$id" "$ph" "$s" "$c" >> .conductor/last-write.log 2>&1`
-   `printf '%s' "$snap_json" | node <probe-flags> scripts/conductor-db.mjs snapshot "$c" >> .conductor/last-write.log 2>&1`
+   `node <probe-flags> .claude/scripts/conductor-db.mjs session "$id" "$ph" "$s" "$c" >> .conductor/last-write.log 2>&1`
+   `printf '%s' "$snap_json" | node <probe-flags> .claude/scripts/conductor-db.mjs snapshot "$c" >> .conductor/last-write.log 2>&1`
 
 All DB-tail redirects use **append mode (`>>`)** so concurrent runs never truncate a preceding trace. **Cross-platform note:** the forms above are Unix-canonical; on Windows/PowerShell realize the same semantics — set `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)` before piping, capture `$id = node …`, pipe `$snap_json | node … snapshot "$c"`, append the log via `… 2>&1 | Out-File -Append -Encoding utf8 .conductor/last-write.log` (not `*>>`), and `New-Item -ItemType Directory -Force .conductor`.
 

package/global/commands/cc-compact.md

@@ -15,7 +15,7 @@ Collect from the current conversation context:
 
 For all four array fields: filter out empty/whitespace-only strings, deduplicate by exact case-sensitive string equality (first occurrence wins), then truncate each surviving element to its per-element cap (Unicode-safe: `Array.from(str).slice(0, cap).join('')`), then if the array still exceeds its cap, drop from the **head** (oldest first) until it fits. Empty arrays are valid and must still be serialized (never omitted).
 
-Serialize by piping a flat JSON object `{ph, c, s, n, f, d, x}` (no `pr`) on **stdin** to `node scripts/snap-build.mjs`; its stdout is the canonical single-line **v1** SNAP JSON. `snap-build` performs all array normalization (filter/dedup/per-element cap/head-drop) and the 4096-char size trim internally — do not pre-serialize. If `snap-build` exits non-zero (malformed field object), report the error and stop; do not write the handoff file, do not run the DB tail, do not print the compact prompt.
+Serialize by piping a flat JSON object `{ph, c, s, n, f, d, x}` (no `pr`) on **stdin** to `node .claude/scripts/snap-build.mjs`; its stdout is the canonical single-line **v1** SNAP JSON. `snap-build` performs all array normalization (filter/dedup/per-element cap/head-drop) and the 4096-char size trim internally — do not pre-serialize. If `snap-build` exits non-zero (malformed field object), report the error and stop; do not write the handoff file, do not run the DB tail, do not print the compact prompt.
 
 Write the single JSON line, followed by exactly one trailing newline, to `.claude/memory/session-snapshot.json`.
 
@@ -36,14 +36,14 @@ Once the snapshot is written successfully, output exactly:
 After the handoff file is written and the compact prompt is ready — and **only** if the authoritative write succeeded — run this synchronous, fail-open tail. Any failure here is non-fatal: never revert the handoff file, never suppress the compact prompt.
 
 1. Ensure `.conductor/` exists (`mkdir -p .conductor`, best-effort). If that fails, skip the tail entirely.
-2. Resolve the session id: `id="$(node scripts/session-id.mjs 2>>.conductor/last-write.log)"`.
+2. Resolve the session id: `id="$(node .claude/scripts/session-id.mjs 2>>.conductor/last-write.log)"`.
 3. Upsert the session row (Node-flag probe applies — same as the cc-implement Step 6 hook: no-flag-first, else `--experimental-sqlite --no-warnings`, else skip):
 
-   `node <probe-flags> scripts/conductor-db.mjs session "$id" "$ph" "$s" "$c" >> .conductor/last-write.log 2>&1`
+   `node <probe-flags> .claude/scripts/conductor-db.mjs session "$id" "$ph" "$s" "$c" >> .conductor/last-write.log 2>&1`
 4. Insert the snapshot row, piping the v1 blob on **stdin** (never argv):
 
-   `printf '%s' "$snap_json" | node <probe-flags> scripts/conductor-db.mjs snapshot "$c" >> .conductor/last-write.log 2>&1`
+   `printf '%s' "$snap_json" | node <probe-flags> .claude/scripts/conductor-db.mjs snapshot "$c" >> .conductor/last-write.log 2>&1`
 
 All argv scalars are double-quoted. **Every** DB-tail redirect uses **append mode (`>>`)** — never `>` — so a rapid or parallel second run never truncates a preceding trace; the log is gitignored, best-effort, and per-run growth is one line at most (rotation is out of scope). The lone `CONDUCTOR_DB:` degradation line (Node < 22.5 / `node:sqlite` absent) lands only in `.conductor/last-write.log`, never the UI. Finally print `> Snapshot written. Run /compact now to clear history.` regardless of the tail's outcome.
 
-**Cross-platform note:** the incantations above are the **Unix (bash) canonical form**; the `.md` file is an agent instruction, not a literal script — realize the same semantics on the host shell. On Windows/PowerShell: **first set `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`** (no-BOM UTF-8, so the piped snapshot string reaches Node's UTF-8 `TextDecoder` byte-clean); capture the id via `$id = node scripts/session-id.mjs`; pipe the blob with `$snap_json | node … snapshot "$c"`; append the log with `… 2>&1 | Out-File -Append -Encoding utf8 .conductor/last-write.log` (explicit UTF-8 append — never the bare `*>>`, whose default encoding is UTF-16LE on PS 5.1 and would corrupt the trace); ensure the dir with `New-Item -ItemType Directory -Force .conductor`. The stdin-only-for-payloads, double-quoted-argv, append-log, and fail-open rules are identical on both platforms.
+**Cross-platform note:** the incantations above are the **Unix (bash) canonical form**; the `.md` file is an agent instruction, not a literal script — realize the same semantics on the host shell. On Windows/PowerShell: **first set `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`** (no-BOM UTF-8, so the piped snapshot string reaches Node's UTF-8 `TextDecoder` byte-clean); capture the id via `$id = node .claude/scripts/session-id.mjs`; pipe the blob with `$snap_json | node … snapshot "$c"`; append the log with `… 2>&1 | Out-File -Append -Encoding utf8 .conductor/last-write.log` (explicit UTF-8 append — never the bare `*>>`, whose default encoding is UTF-16LE on PS 5.1 and would corrupt the trace); ensure the dir with `New-Item -ItemType Directory -Force .conductor`. The stdin-only-for-payloads, double-quoted-argv, append-log, and fail-open rules are identical on both platforms.

package/lib/installer/deploy.mjs

@@ -1,4 +1,4 @@
-import { cpSync, mkdirSync, chmodSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { cpSync, mkdirSync, chmodSync, existsSync, readdirSync, statSync, rmSync } from 'node:fs';
 import { join, relative, sep } from 'node:path';
 
 // Verified at plan time: `find global skills project-template -type l` returns
@@ -47,6 +47,20 @@ export function deployGlobal(assetRoot, home) {
   return target;
 }
 
+// 1.23.2 deployed scripts/ as a sibling of .claude at <cwd>/scripts instead of
+// nesting it under .claude, colliding with any scripts/ the host project already
+// owned. Only remove the stale dir when its contents are EXACTLY the bundled
+// script file set (no extras) - anything else is presumed to be the host's own
+// scripts/ and is left untouched.
+function sweepStaleRootScripts(assetRoot, cwd) {
+  const staleDir = join(cwd, 'scripts');
+  if (!existsSync(staleDir) || !statSync(staleDir).isDirectory()) return;
+  const bundled = readdirSync(join(assetRoot, 'scripts')).sort();
+  const present = readdirSync(staleDir).sort();
+  const matches = bundled.length === present.length && bundled.every((f, i) => f === present[i]);
+  if (matches) rmSync(staleDir, { recursive: true, force: true });
+}
+
 export function deployProject(assetRoot, cwd) {
   const target = join(cwd, '.claude');
   const templateRoot = join(assetRoot, 'project-template');
@@ -67,6 +81,12 @@ export function deployProject(assetRoot, cwd) {
     if (name === '.claude') continue;
     cpSync(join(templateRoot, name), join(cwd, name), CP_OPTS);
   }
+  // scripts/ is a sibling of project-template/ under assetRoot (source layout),
+  // but is deployed as a CHILD of .claude/ (target) - it must stay inside the
+  // project's self-contained .claude footprint, not spill into the host's own
+  // project root where it could collide with a scripts/ dir the host already owns.
+  sweepStaleRootScripts(assetRoot, cwd);
+  cpSync(join(assetRoot, 'scripts'), join(target, 'scripts'), CP_OPTS);
   return target;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeison.restrepo.r/code-conductor",
-  "version": "1.23.1",
+  "version": "1.23.3",
   "description": "A spec-first, token-efficient Claude Code configuration and installer CLI.",
   "repository": {
     "type": "git",
@@ -15,6 +15,7 @@
     "lib/",
     "global/",
     "skills/",
+    "scripts/",
     "project-template/"
   ],
   "engines": {

package/project-template/.claude/commands/cc-implement.md

@@ -4,12 +4,12 @@ description: "(Conductor) Execute implementation tasks from an approved plan"
 
 ## Phase entry - Resume Read
 
-Before doing anything else, restore any stored context for the current commit by running `scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
+Before doing anything else, restore any stored context for the current commit by running `.claude/scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
 
 - **Unix / Git Bash:**
   ```sh
   if command -v node >/dev/null 2>&1; then
-    resume_out="$(node scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
+    resume_out="$(node .claude/scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
   else resume_rc=3; resume_out=""; fi
   ```
 - **PowerShell:**
@@ -20,7 +20,7 @@ Before doing anything else, restore any stored context for the current commit by
       $__nap = $PSNativeCommandUseErrorActionPreference; $PSNativeCommandUseErrorActionPreference = $false
     }
     try {
-      $resume_out = node scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
+      $resume_out = node .claude/scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
     } catch { $resume_rc = 3; $resume_out = "" }
     finally {
       $ErrorActionPreference = $__eap
@@ -133,7 +133,7 @@ Runs after both success (`[X]`) and failure (`[!]`) paths. Record the task's fin
    Each probe is a disposable child; a non-zero exit — including a fatal `bad option: --experimental-sqlite` from a Node that does not recognize the flag — is caught and simply advances to the next branch. The fatal startup error is therefore always contained inside a probe whose failure is expected; it never propagates and never aborts the hook.
 3. Launch the chosen form, from the repo root, with the active plan file path, the task ID, and the just-written state character (`X` or `!`):
 
-   `node <chosen-flags> scripts/conductor-db.mjs record "<plan_file>" "<task_id>" "<state>"`
+   `node <chosen-flags> .claude/scripts/conductor-db.mjs record "<plan_file>" "<task_id>" "<state>"`
 
    All three arguments **must** be wrapped in double quotes exactly as shown. A repository path can contain spaces (e.g. `/Users/me/My Projects/repo/docs/plan.md`); unquoted, the shell word-splits it into several argv entries and the recorder sees `!== 3` positionals, silently rejecting a legitimate write. `--no-warnings` (in both probe and launch) suppresses Node's `ExperimentalWarning: SQLite is an experimental feature` line so it never pollutes hook stderr; it does not affect the recorder's own `CONDUCTOR_DB:` diagnostics (those are direct `process.stderr` writes, not process warnings).
 

package/project-template/.claude/commands/cc-plan.md

@@ -4,12 +4,12 @@ description: "(Conductor) Map implementation steps from an approved spec"
 
 ## Phase entry - Resume Read
 
-Before doing anything else, restore any stored context for the current commit by running `scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
+Before doing anything else, restore any stored context for the current commit by running `.claude/scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
 
 - **Unix / Git Bash:**
   ```sh
   if command -v node >/dev/null 2>&1; then
-    resume_out="$(node scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
+    resume_out="$(node .claude/scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
   else resume_rc=3; resume_out=""; fi
   ```
 - **PowerShell:**
@@ -20,7 +20,7 @@ Before doing anything else, restore any stored context for the current commit by
       $__nap = $PSNativeCommandUseErrorActionPreference; $PSNativeCommandUseErrorActionPreference = $false
     }
     try {
-      $resume_out = node scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
+      $resume_out = node .claude/scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
     } catch { $resume_rc = 3; $resume_out = "" }
     finally {
       $ErrorActionPreference = $__eap

package/project-template/.claude/commands/cc-spec.md

@@ -4,12 +4,12 @@ description: "(Conductor) Define the problem and generate an approved spec"
 
 ## Phase entry - Resume Read
 
-Before doing anything else, restore any stored context for the current commit by running `scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
+Before doing anything else, restore any stored context for the current commit by running `.claude/scripts/resume-read.mjs`. It resolves the current git hash, prefers a valid DB snapshot (`conductor-db get-snapshot`), falls back to the `.claude/memory/session-snapshot.json` handoff file, and prints a `RESUME_HIT` block on a hit / nothing on a miss. Capture its stdout **and** its exit code with the canonical per-platform form (each first probes for `node` and treats its absence as a clean miss, never an error):
 
 - **Unix / Git Bash:**
   ```sh
   if command -v node >/dev/null 2>&1; then
-    resume_out="$(node scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
+    resume_out="$(node .claude/scripts/resume-read.mjs 2>>.conductor/last-write.log)"; resume_rc=$?
   else resume_rc=3; resume_out=""; fi
   ```
 - **PowerShell:**
@@ -20,7 +20,7 @@ Before doing anything else, restore any stored context for the current commit by
       $__nap = $PSNativeCommandUseErrorActionPreference; $PSNativeCommandUseErrorActionPreference = $false
     }
     try {
-      $resume_out = node scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
+      $resume_out = node .claude/scripts/resume-read.mjs 2>> .conductor/last-write.log; $resume_rc = $LASTEXITCODE
     } catch { $resume_rc = 3; $resume_out = "" }
     finally {
       $ErrorActionPreference = $__eap