create-claude-workspace 1.1.39 → 1.1.41

package/dist/template/.claude/agents/orchestrator.md

@@ -126,7 +126,39 @@ If no remote, skip this step.
 - `git log --oneline -10`
 - Scan current file structure
 
-### 8. Retroactive git integration sync
+### 8. Detect PLAN.md changes
+If `PLAN.md` exists in the project root, check whether it changed since the last session. This runs AFTER git sync (step 6) to avoid commit conflicts with remote changes.
+
+1. Read PLAN.md content
+2. Read MEMORY.md `PLAN_MD_Hash` value (if present)
+3. Compute a hash of PLAN.md content: take first 8 chars of hex SHA-256 (`node -e "const c=require('crypto');process.stdout.write(c.createHash('sha256').update(require('fs').readFileSync('PLAN.md','utf-8')).digest('hex').slice(0,8))"`)
+4. If hash matches → skip (no changes). If `PLAN_MD_Hash` is absent (first run) → treat as "changed" to seed the state.
+5. If changed — read PLAN.md and diff against current project state. Delegate updates based on WHICH sections changed:
+
+| Changed section | Action |
+|---|---|
+| **Product Vision** (Target users, Core problem, MVP features, Non-goals) | Delegate to `product-owner`: "PLAN.md Product Vision was updated. Read the new PLAN.md and current PRODUCT.md. Update PRODUCT.md to reflect the new vision. Output what changed." |
+| **Technical Decisions** (Framework, Backend, Database, Deployment, CI/CD, Testing) | Delegate to `technical-planner`: "PLAN.md Technical Decisions were updated. Read new PLAN.md, current CLAUDE.md, and TODO.md. Update TODO.md tasks if the tech stack changed (e.g., framework switch may invalidate existing tasks). Update CLAUDE.md Tech Stack section to match." If only Deployment/CI/CD changed, also delegate to `deployment-engineer`: "PLAN.md deployment config changed. Update CI/CD pipeline config to match new settings." |
+| **Workflow** (Mode, Branch strategy, Auto-push, Auto-merge, Review required) | Update CLAUDE.md `Workflow:` field directly. If mode changed from solo→team or team→solo, log in MEMORY.md Notes. |
+| **Constraints** (Max lines per file, Coverage threshold, Forbidden patterns) | Update CLAUDE.md constraints section directly (Code Quality & Linting, coverage thresholds). |
+| **Project Info** (Name, Description, Framework, Package manager, Monorepo) | Delegate to `technical-planner`: "PLAN.md Project Info changed. Update CLAUDE.md header and Tech Stack to match." |
+| **Access & Credentials** | Validate new credentials (run auth checks). Log status in MEMORY.md Session Config. Do NOT store credential values. |
+| **Initial State / Runtime** | Read values but do NOT delegate — these are consumed by `autonomous.mjs`, not agents. |
+
+6. After all delegations complete, update MEMORY.md: set `PLAN_MD_Hash: [new-hash]`
+7. If any files were modified (CLAUDE.md, PRODUCT.md, TODO.md), commit: `git add CLAUDE.md PRODUCT.md TODO.md MEMORY.md && git commit -m "chore: propagate PLAN.md changes to project files"`
+8. Push if remote exists: `git push origin HEAD`
+9. Skip this entire step if PLAN.md does not exist.
+
+**How to detect which sections changed** (without storing the old file):
+- Compare PLAN.md values against current project files:
+  - `Product Vision` → compare MVP features list against PRODUCT.md features
+  - `Technical Decisions` → compare framework/backend/database against CLAUDE.md Tech Stack
+  - `Workflow` → compare mode against CLAUDE.md `Workflow:` field
+  - `Constraints` → compare coverage threshold against CLAUDE.md code quality section
+- If a PLAN.md value differs from the corresponding project file value, that section "changed"
+
+### 9. Retroactive git integration sync
 - **Trigger condition**: remote exists (`git remote -v | grep origin`) AND TODO.md exists with tasks BUT no `<!-- #N -->` markers found in TODO.md AND CLI is available (`gh --version` or `glab --version`) AND auth is valid (`gh auth status` or `glab auth status`)
 - This means work was done locally without git integration (token was missing or platform wasn't set up), and now it's available
 - Delegate to `devops-integrator` agent:
@@ -142,13 +174,13 @@ If no remote, skip this step.
 - Log in MEMORY.md Notes: "Retroactive git sync completed — [N] issues created, [M] marked as done"
 - Skip if any trigger condition is not met (no remote, no TODO.md, markers already present, CLI missing, auth invalid)
 
-### 9. Ingest external issues (if git integration active)
+### 10. Ingest external issues (if git integration active)
 - **Only run at phase transitions** — not every invocation
 - Delegate to `devops-integrator` agent: "Run external issue intake — check for new issues on GitHub/GitLab that are not yet in TODO.md. Ingest bugs and feature requests."
 - If new bugs are found with `critical` or `priority::high` label, they become the next task
 - Skip if no git integration or platform is unreachable
 
-### 10. One task per invocation
+### 11. One task per invocation
 - Complete exactly ONE task per invocation, then end the session cleanly.
 - The external loop (`autonomous.mjs` or ralph-loop) handles iteration control — you do NOT need to manage capacity, iteration counters, or session bounds.
 - After committing the task (STEP 11) and post-merge (STEP 12), EXIT. Do NOT update MEMORY.md after merge — it was already committed in STEP 11 and arrived on main via merge. Do NOT ask whether to continue, do NOT wait for confirmation, do NOT start another task. Do NOT create any commits after merge.

package/dist/template/.claude/scripts/autonomous.mjs

@@ -333,7 +333,9 @@ async function main() {
         const task = getCurrentTask(memory);
         log.info(`Iteration ${i}/${opts.maxIterations} | Phase: ${phase} | Task: ${task}`);
         // Run Claude
+        log.debug(`Spawning claude process...`);
         const output = await runClaude(opts, log, { resumeSessionId, resumePrompt });
+        log.debug(`Claude process exited (code=${output.code}, category=${output.errorCategory}, duration=${formatDuration(output.durationMs)})`);
         resumeSessionId = null;
         resumePrompt = null;
         if (stopping)
@@ -441,8 +443,10 @@ async function main() {
             log.info(`Iteration ${i} done (no structured result, exit ${output.code}).`);
             checkpoint.lastTaskSeen = task;
             writeCheckpoint(opts.projectDir, checkpoint, log);
-            if (i < opts.maxIterations)
+            if (i < opts.maxIterations) {
+                log.info(`Next iteration in ${formatDuration(opts.delay)}...`);
                 await sleep(opts.delay, stoppingRef);
+            }
             continue;
         }
         log.info(`Status: ${result.status} | Action: ${result.action}`);
@@ -496,6 +500,7 @@ async function main() {
         }
         writeCheckpoint(opts.projectDir, checkpoint, log);
         if (i < opts.maxIterations && !stopping && result.status !== 'needs_input') {
+            log.info(`Next iteration in ${formatDuration(opts.delay)}...`);
             await sleep(opts.delay, stoppingRef);
         }
     }

package/dist/template/.claude/scripts/lib/claude-runner.mjs

@@ -19,6 +19,9 @@ const TC = {
     dim: '\x1b[2m', reset: '\x1b[0m',
     cyan: '\x1b[36m', yellow: '\x1b[33m', green: '\x1b[32m', red: '\x1b[31m',
 };
+function ts() {
+    return `[${new Date().toLocaleTimeString('en-GB', { hour12: false })}] `;
+}
 const MAX_BUFFER = 1024 * 1024; // 1MB stdout buffer cap
 const MAX_STDERR = 64 * 1024; // 64KB stderr cap
 // ─── Stream event formatting ───
@@ -30,11 +33,11 @@ export function resetStreamState() {
 const SILENT_EVENTS = new Set(['system', 'ping', 'result']);
 function formatRateLimit(event) {
     const resets = event.rate_limit_info?.resets_at ?? event.resets_at ?? '';
-    return `${TC.yellow}⏳ Rate limited${resets ? ` (resets: ${resets})` : ''}${TC.reset}\n`;
+    return `${ts()}${TC.yellow}⏳ Rate limited${resets ? ` (resets: ${resets})` : ''}${TC.reset}\n`;
 }
 function formatError(event) {
     const msg = event.error?.message ?? (typeof event.message === 'string' ? event.message : '') ?? JSON.stringify(event);
-    return `${TC.red}✗ Error: ${msg}${TC.reset}\n`;
+    return `${ts()}${TC.red}✗ Error: ${msg}${TC.reset}\n`;
 }
 function getContentBlocks(event) {
     const msg = event.message;
@@ -46,7 +49,7 @@ function formatToolUse(block) {
     const input = block.input ?? {};
     const detail = input.command ?? input.file_path ?? input.pattern ?? input.query ?? '';
     const short = detail.slice(0, 120);
-    return `${TC.cyan}▶ ${block.name ?? 'tool'}${TC.reset}${short ? ` ${TC.dim}${short}${TC.reset}` : ''}`;
+    return `${ts()}${TC.cyan}▶ ${block.name ?? 'tool'}${TC.reset}${short ? ` ${TC.dim}${short}${TC.reset}` : ''}`;
 }
 function formatTextBlock(block) {
     if (!block.text)
@@ -58,14 +61,15 @@ function formatTextBlock(block) {
     if (!text)
         return null;
     _lastAssistantText = block.text;
-    return text;
+    // Timestamp on first line only (multi-line text shouldn't get per-line stamps)
+    return `${ts()}${text}`;
 }
 function formatThinking(block) {
     if (!block.thinking)
         return null;
     const preview = block.thinking.slice(0, 200).replace(/\n/g, ' ');
     const ellipsis = preview.length < block.thinking.length ? '...' : '';
-    return `${TC.dim}💭 ${preview}${ellipsis}${TC.reset}`;
+    return `${ts()}${TC.dim}💭 ${preview}${ellipsis}${TC.reset}`;
 }
 const BLOCK_FORMATTERS = {
     tool_use: formatToolUse,
@@ -96,7 +100,7 @@ function formatUser(event) {
         const icon = block.is_error ? `${TC.red}✗` : `${TC.green}✓`;
         const text = typeof block.content === 'string' ? block.content : '';
         const preview = text.slice(0, 150).replace(/\n/g, ' ');
-        return `${icon} ${TC.dim}${preview}${TC.reset}\n`;
+        return `${ts()}${icon} ${TC.dim}${preview}${TC.reset}\n`;
     }
     return null;
 }
@@ -214,6 +218,10 @@ export function runClaude(opts, log, runOpts = {}) {
         const pid = child.pid;
         currentChild = { kill: () => { if (pid)
                 killProcessTree(pid, isWin); } };
+        // Prevent uncaught exception from stdin write errors (EPIPE on Windows)
+        if (child.stdin) {
+            child.stdin.on('error', (err) => { log.debug(`stdin error (expected if child exited): ${err.message}`); });
+        }
         // ─── State ───
         let stderr = '';
         let sessionId = null;
@@ -363,6 +371,18 @@ export function runClaude(opts, log, runOpts = {}) {
         // ─── Close ───
         child.on('close', (code, signal) => {
             cleanup();
+            // Windows: kill orphan child processes that may hold Claude locks.
+            // Only kill if the process tree is still alive (avoid PID reuse killing unrelated processes).
+            if (isWin && pid && !killed) {
+                try {
+                    const taskInfo = execSync(`tasklist /FI "PID eq ${pid}" /NH`, { encoding: 'utf-8', stdio: 'pipe', timeout: 3000 });
+                    // tasklist always exits 0; parse stdout — if PID is dead it prints "INFO: No tasks..."
+                    if (taskInfo.includes(String(pid))) {
+                        execSync(`taskkill /PID ${pid} /T /F`, { stdio: 'ignore', timeout: 5000 });
+                    }
+                }
+                catch { /* already dead — expected */ }
+            }
             // Flush remaining buffer
             if (buffer.trim()) {
                 const event = parseStreamEvent(buffer.replace(/\r/g, ''));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-workspace",
-  "version": "1.1.39",
+  "version": "1.1.41",
   "description": "Scaffold a project with Claude Code agents for autonomous AI-driven development",
   "type": "module",
   "bin": {