create-claude-workspace 1.1.28 → 1.1.30

package/README.md

@@ -40,15 +40,18 @@ npx create-claude-workspace [directory]    # scaffold into a specific directory
 npx create-claude-workspace --update       # overwrite agents with latest version
 npx create-claude-workspace --run          # scaffold + start autonomous loop
 npx create-claude-workspace --docker       # scaffold + run in Docker
+npx create-claude-workspace validate       # check prerequisites (Claude CLI, auth, git)
 ```
 
 ### Docker Options
 
 ```bash
-npx create-claude-workspace docker --max-iterations 20   # limit iterations
-npx create-claude-workspace docker --shell                # interactive shell
-npx create-claude-workspace docker --rebuild              # force rebuild image
-npx create-claude-workspace docker --login                # run 'claude auth login' on host first
+npx create-claude-workspace docker --max-iterations 20     # limit iterations
+npx create-claude-workspace docker --max-turns 80          # more turns per invocation
+npx create-claude-workspace docker --shell                 # interactive shell
+npx create-claude-workspace docker --rebuild               # force rebuild image
+npx create-claude-workspace docker --login                 # run 'claude auth login' on host first
+npx create-claude-workspace docker --resume-session <id>   # resume a previous session
 ANTHROPIC_API_KEY=sk-... npx create-claude-workspace docker  # API key
 ```
 
@@ -105,29 +108,59 @@ The autonomous loop runs Claude Code in separate invocations with clean context
 # Unattended (--skip-permissions is added automatically)
 npx create-claude-workspace run
 
+# Resume after Ctrl+C (continues from checkpoint + resumes last Claude session)
+npx create-claude-workspace run --resume
+
 # Custom options
 npx create-claude-workspace run --max-iterations 20 --delay 10000
 
 # All options:
-#   --max-iterations <n>     Safety limit (default: 50)
-#   --max-turns <n>          Max turns per Claude invocation (default: 50)
-#   --delay <ms>             Pause between tasks (default: 5000)
-#   --cooldown <ms>          Wait after rate limit (default: 60000)
-#   --max-rate-retries <n>   Max consecutive rate limit retries (default: 5)
-#   --project-dir <path>     Target project (default: cwd)
-#   --help                   Show help
+#   --max-iterations <n>         Safety limit (default: 50)
+#   --max-turns <n>              Max turns per Claude invocation (default: 50)
+#   --delay <ms>                 Pause between tasks (default: 5000)
+#   --cooldown <ms>              Wait after error (default: 60000)
+#   --process-timeout <ms>       Max time per invocation (default: 1800000 = 30min)
+#   --activity-timeout <ms>      Max silence before kill (default: 300000 = 5min)
+#   --resume                     Resume from checkpoint state
+#   --resume-session <id>        Resume specific Claude session
+#   --notify-command <cmd>       Shell command on critical events
+#   --log-file <path>            Log file (default: .claude/autonomous.log)
+#   --project-dir <path>         Target project (default: cwd)
+#   --no-lock                    Disable lock file
+#   --no-pull                    Skip auto git pull
+#   --dry-run                    Validate prerequisites only
+#   --help                       Show help
 ```
 
 **How it works:**
 - Each iteration = fresh `claude -p` call = clean context (no context overflow)
-- MEMORY.md session counters reset before each invocation
-- Rate limits detected automatically — waits and retries (max 5 consecutive)
-- Graceful shutdown: Ctrl+C stops after current iteration completes
+- Checkpoint state (`.claude/autonomous-state.json`) tracks progress between invocations
+- Rate limits handled with exponential backoff (up to 30 min between retries)
+- `--resume` continues from last checkpoint and auto-resumes the interrupted Claude session
+- Graceful shutdown: Ctrl+C stops after current iteration completes (Ctrl+C again to force)
 - Stops when all TODO.md tasks complete or max iterations reached
-- Safe to kill (Ctrl+C) — MEMORY.md always has the latest state
+- Pre-flight checks: Claude CLI, auth, git identity, filesystem, git state
 
 **vs ralph-loop:** Ralph-loop runs within one conversation (context fills up). This script runs separate conversations (unlimited iterations).
 
+## Fully Unattended Setup (PLAN.md)
+
+For server/CI environments where no human interaction is possible, create a `PLAN.md` file in the project root before starting the autonomous loop. The project-initializer reads it and skips the discovery conversation.
+
+```bash
+# 1. Copy the template
+cp .claude/templates/PLAN.md PLAN.md
+
+# 2. Fill in your project details, credentials, and preferences
+
+# 3. Start — no interaction needed
+npx create-claude-workspace run
+# or in Docker:
+npx create-claude-workspace docker
+```
+
+The template covers: project info, product vision, tech stack, credentials (API keys, git tokens, npm auth), workflow mode, and runtime constraints.
+
 ## Required Plugins
 
 Install before starting:

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

@@ -518,6 +518,7 @@ Examples:
 - All files in ENGLISH
 - TODO.md + MEMORY.md are your tracking system — keep them PRECISE and CURRENT
 - If deviating from plan, LOG the reason in MEMORY.md
+- **NEVER add `eslint-disable` comments** (inline, next-line, or block). Fix the actual code instead. If a lint rule cannot be satisfied, restructure the code — do not suppress the warning.
 - Priority: working code > perfect code. Production quality, not hacks.
 - **Token safety**: NEVER echo, log, cat, or write secrets (NPM_TOKEN, API keys, etc.) to terminal output, MEMORY.md, CLAUDE.md, or any tracked file. Tokens are read from `~/.npmrc` or environment variables automatically by tools — never handle them directly.
 - For independent tasks within the same phase, consider running architect agents in parallel (STEP 2) — but ONLY for tasks that don't share API contracts

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

@@ -226,6 +226,7 @@ export function runClaude(opts, log, runOpts = {}) {
         let killed = false;
         let killReason = null;
         let resolved = false;
+        let authErrorCount = 0;
         function detectErrorSignals(event) {
             if (event.type !== 'error')
                 return;
@@ -346,7 +347,17 @@ export function runClaude(opts, log, runOpts = {}) {
             if (stderr.length > MAX_STDERR) {
                 stderr = stderr.slice(-MAX_STDERR);
             }
-            detectTextSignals(text.toLowerCase());
+            const lower = text.toLowerCase();
+            detectTextSignals(lower);
+            // Kill on auth error burst (e.g. expired token causing infinite retry loop)
+            if (AUTH_ERROR_RE.test(lower)) {
+                authErrorCount++;
+                if (authErrorCount >= 5 && !killed) {
+                    log.warn(`Auth error burst detected (${authErrorCount} errors) — killing process.`);
+                    killChild('activity_timeout');
+                    return;
+                }
+            }
             process.stderr.write(text);
         });
         // ─── Close ───

package/package.json

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