create-claude-workspace 1.1.152 → 2.1.0

package/dist/scheduler/tasks/queue.spec.js

@@ -0,0 +1,223 @@
+import { describe, it, expect } from 'vitest';
+import { buildGraph, getParallelBatches, isPhaseComplete, getNextPhase, isProjectComplete, getBlockedTasks } from './queue.mjs';
+import { parseTodoMd } from './parser.mjs';
+// ─── Fixtures ───
+const MULTI_PHASE_TODO = `# TODO.md
+
+## Phase 0: Foundation
+
+- [x] **Init workspace** — scaffolding
+  - Type: fullstack
+  - Complexity: S
+  - Depends on: nothing
+
+- [ ] **Configure ESLint** — code quality
+  - Type: fullstack
+  - Complexity: S
+  - Depends on: nothing
+
+## Phase 1: Auth
+
+- [ ] **Auth types** — interfaces
+  - Type: backend
+  - Complexity: S
+  - Depends on: Phase 0
+
+- [ ] **Login API** — endpoint
+  - Type: backend
+  - Complexity: M
+  - Depends on: Auth types
+
+- [ ] **Login form** — UI
+  - Type: frontend
+  - Complexity: S
+  - Depends on: Auth types
+
+## Phase 2: Dashboard
+
+- [ ] **Dashboard layout** — grid
+  - Type: frontend
+  - Complexity: L
+  - Depends on: Phase 1
+`;
+const CYCLIC_TODO = `## Phase 0: Cycle
+
+- [ ] **Task A** — first
+  - Type: backend
+  - Complexity: S
+  - Depends on: Task C
+
+- [ ] **Task B** — second
+  - Type: backend
+  - Complexity: S
+  - Depends on: Task A
+
+- [ ] **Task C** — third
+  - Type: backend
+  - Complexity: S
+  - Depends on: Task B
+`;
+const KIT_UPGRADE_TODO = `## Phase 1: Feature
+
+- [ ] **Upgrade sharp** — major version
+  - Type: backend
+  - Complexity: S
+  - Kit-Upgrade: v2.0
+
+- [ ] **Feature A** — new feature
+  - Type: backend
+  - Complexity: M
+  - Depends on: nothing
+`;
+// ─── buildGraph ───
+describe('buildGraph', () => {
+    it('builds graph from parsed tasks', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        const graph = buildGraph(tasks);
+        expect(graph.tasks.size).toBe(6);
+    });
+    it('returns runnable tasks (deps satisfied)', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        const graph = buildGraph(tasks);
+        const runnable = graph.runnable();
+        // "Init workspace" is done, "Configure ESLint" has no deps → runnable
+        expect(runnable.map(t => t.title)).toContain('Configure ESLint');
+        // "Auth types" depends on Phase 0 (Init workspace is done, ESLint is not) → blocked
+        expect(runnable.map(t => t.title)).not.toContain('Auth types');
+    });
+    it('detects no cycle in valid graph', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        const graph = buildGraph(tasks);
+        expect(graph.findCycle()).toBeNull();
+    });
+});
+describe('cycle detection', () => {
+    it('detects cycle in dependency graph', () => {
+        const tasks = parseTodoMd(CYCLIC_TODO);
+        const graph = buildGraph(tasks);
+        const cycle = graph.findCycle();
+        expect(cycle).not.toBeNull();
+        expect(cycle.length).toBeGreaterThan(1);
+    });
+});
+describe('kit-upgrade priority', () => {
+    it('sorts kit-upgrade tasks before regular tasks', () => {
+        const tasks = parseTodoMd(KIT_UPGRADE_TODO);
+        const graph = buildGraph(tasks);
+        const runnable = graph.runnable();
+        expect(runnable.length).toBe(2);
+        expect(runnable[0].kitUpgrade).toBe(true);
+    });
+});
+describe('complexity sorting', () => {
+    it('sorts S before M before L within same phase', () => {
+        const todo = `## Phase 0: X
+- [ ] **Large task** — big
+  - Type: backend
+  - Complexity: L
+  - Depends on: nothing
+- [ ] **Small task** — tiny
+  - Type: backend
+  - Complexity: S
+  - Depends on: nothing
+- [ ] **Medium task** — mid
+  - Type: backend
+  - Complexity: M
+  - Depends on: nothing
+`;
+        const tasks = parseTodoMd(todo);
+        const graph = buildGraph(tasks);
+        const runnable = graph.runnable();
+        expect(runnable[0].complexity).toBe('S');
+        expect(runnable[1].complexity).toBe('M');
+        expect(runnable[2].complexity).toBe('L');
+    });
+});
+// ─── getParallelBatches ───
+describe('getParallelBatches', () => {
+    it('returns empty for empty input', () => {
+        expect(getParallelBatches([])).toEqual([]);
+    });
+    it('returns single batch for single task', () => {
+        const tasks = parseTodoMd(`## Phase 0: X\n- [ ] **Solo** — one\n  - Type: backend\n  - Complexity: S\n`);
+        const graph = buildGraph(tasks);
+        const batches = getParallelBatches(graph.runnable());
+        expect(batches).toHaveLength(1);
+        expect(batches[0]).toHaveLength(1);
+    });
+    it('batches independent tasks from same phase', () => {
+        const todo = `## Phase 0: Setup
+- [ ] **Task A** — first
+  - Type: backend
+  - Complexity: S
+  - Depends on: nothing
+- [ ] **Task B** — second
+  - Type: frontend
+  - Complexity: S
+  - Depends on: nothing
+`;
+        const tasks = parseTodoMd(todo);
+        const graph = buildGraph(tasks);
+        const batches = getParallelBatches(graph.runnable());
+        expect(batches).toHaveLength(1);
+        expect(batches[0]).toHaveLength(2);
+    });
+});
+// ─── Phase helpers ───
+describe('isPhaseComplete', () => {
+    it('returns true when all tasks in phase are done/skipped', () => {
+        const tasks = [
+            { id: 'p0-1', title: 'A', phase: 0, type: 'backend', complexity: 'S', status: 'done', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 1, changelog: 'added' },
+            { id: 'p0-2', title: 'B', phase: 0, type: 'backend', complexity: 'S', status: 'skipped', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 2, changelog: 'none' },
+        ];
+        expect(isPhaseComplete(tasks, 0)).toBe(true);
+    });
+    it('returns false when a task is still todo', () => {
+        const tasks = [
+            { id: 'p0-1', title: 'A', phase: 0, type: 'backend', complexity: 'S', status: 'done', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 1, changelog: 'added' },
+            { id: 'p0-2', title: 'B', phase: 0, type: 'backend', complexity: 'S', status: 'todo', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 2, changelog: 'added' },
+        ];
+        expect(isPhaseComplete(tasks, 0)).toBe(false);
+    });
+    it('returns false for nonexistent phase', () => {
+        expect(isPhaseComplete([], 99)).toBe(false);
+    });
+});
+describe('getNextPhase', () => {
+    it('returns lowest phase with todo tasks', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        expect(getNextPhase(tasks)).toBe(0); // ESLint is still todo
+    });
+    it('returns null when all tasks are done', () => {
+        const tasks = [
+            { id: 'p0-1', title: 'A', phase: 0, type: 'backend', complexity: 'S', status: 'done', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 1, changelog: 'added' },
+        ];
+        expect(getNextPhase(tasks)).toBeNull();
+    });
+});
+describe('isProjectComplete', () => {
+    it('returns true when all tasks are done/skipped', () => {
+        const tasks = [
+            { id: 'p0-1', title: 'A', phase: 0, type: 'backend', complexity: 'S', status: 'done', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 1, changelog: 'added' },
+            { id: 'p1-1', title: 'B', phase: 1, type: 'backend', complexity: 'S', status: 'skipped', dependsOn: [], issueMarker: null, kitUpgrade: false, lineNumber: 2, changelog: 'none' },
+        ];
+        expect(isProjectComplete(tasks)).toBe(true);
+    });
+    it('returns false when tasks remain', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        expect(isProjectComplete(tasks)).toBe(false);
+    });
+    it('returns false for empty task list', () => {
+        expect(isProjectComplete([])).toBe(false);
+    });
+});
+describe('getBlockedTasks', () => {
+    it('identifies blocked tasks', () => {
+        const tasks = parseTodoMd(MULTI_PHASE_TODO);
+        const graph = buildGraph(tasks);
+        const blocked = getBlockedTasks(graph);
+        // Auth types, Login API, Login form, Dashboard are blocked
+        expect(blocked.length).toBeGreaterThan(0);
+        expect(blocked.some(t => t.title === 'Auth types')).toBe(true);
+    });
+});

package/dist/scheduler/types.mjs

@@ -0,0 +1,20 @@
+// ─── Multi-agent scheduler types ───
+export const SCHEDULER_DEFAULTS = {
+    projectDir: process.cwd(),
+    concurrency: 1,
+    maxIterations: 50,
+    maxTurns: 50,
+    skipPermissions: false,
+    resume: false,
+    resumeSession: null,
+    logFile: '.claude/scheduler/scheduler.log',
+    noPull: false,
+    noLock: false,
+    dryRun: false,
+    notifyCommand: null,
+    idlePollInterval: 5 * 60_000,
+    maxIdleTime: 0,
+    interactive: false,
+    delay: 5_000,
+    cooldown: 60_000,
+};

package/dist/scheduler/util/memory.mjs

@@ -0,0 +1,126 @@
+// ─── Pure string transformations for MEMORY.md ───
+// All functions are pure: string in → string out. No file I/O.
+/**
+ * Read a top-level section value from MEMORY.md.
+ * Sections are h2 headings (`## Section Name`), value is everything until the next heading.
+ */
+export function readField(content, field) {
+    const sections = splitSections(content);
+    const section = sections.find(s => s.heading === field);
+    if (!section)
+        return null;
+    const trimmed = section.body.trim();
+    return trimmed || null;
+}
+/**
+ * Write a top-level section value. Creates the section if it doesn't exist.
+ */
+export function writeField(content, field, value) {
+    const sections = splitSections(content);
+    const idx = sections.findIndex(s => s.heading === field);
+    if (idx >= 0) {
+        sections[idx] = { heading: field, body: value + '\n' };
+        return assembleSections(content, sections);
+    }
+    // Append new section
+    const trimmed = content.trimEnd();
+    return `${trimmed}\n\n## ${field}\n${value}\n`;
+}
+function splitSections(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentHeading = null;
+    let bodyLines = [];
+    for (const line of lines) {
+        const match = line.match(/^## (.+)$/);
+        if (match) {
+            if (currentHeading !== null) {
+                sections.push({ heading: currentHeading, body: bodyLines.join('\n') });
+            }
+            currentHeading = match[1].trim();
+            bodyLines = [];
+        }
+        else if (currentHeading !== null) {
+            bodyLines.push(line);
+        }
+    }
+    if (currentHeading !== null) {
+        sections.push({ heading: currentHeading, body: bodyLines.join('\n') });
+    }
+    return sections;
+}
+function assembleSections(original, sections) {
+    // Preserve everything before the first ## heading
+    let preamble = '';
+    if (original.startsWith('## ')) {
+        preamble = '';
+    }
+    else {
+        const idx = original.indexOf('\n## ');
+        preamble = idx >= 0 ? original.slice(0, idx + 1) : '';
+    }
+    const body = sections
+        .map(s => `## ${s.heading}\n${s.body}`)
+        .join('\n');
+    return preamble + body;
+}
+/**
+ * Append a completed task to the "Done" section.
+ */
+export function addDoneItem(content, taskTitle, date) {
+    const done = readField(content, 'Done');
+    if (!done || done === '(nothing yet)') {
+        return writeField(content, 'Done', `- ${taskTitle} (${date})`);
+    }
+    return writeField(content, 'Done', `${done}\n- ${taskTitle} (${date})`);
+}
+/**
+ * Set the "Next" section to a specific task.
+ */
+export function setNextItem(content, taskTitle) {
+    return writeField(content, 'Next', `- ${taskTitle}`);
+}
+/**
+ * Read Session Config as key-value pairs.
+ */
+export function readSessionConfig(content) {
+    const section = readField(content, 'Session Config');
+    if (!section)
+        return {};
+    const config = {};
+    for (const line of section.split('\n')) {
+        const match = line.match(/^-\s*(\w[\w_\s]*\w|\w+):\s*(.+)$/);
+        if (match) {
+            config[match[1].trim()] = match[2].trim();
+        }
+    }
+    return config;
+}
+/**
+ * Check if the project is marked as complete.
+ */
+export function isProjectComplete(content) {
+    return /^Current Phase:.*PROJECT COMPLETE/mi.test(content)
+        || /^Project_Status:\s*complete/mi.test(content)
+        || /## Current Phase\s*\n.*PROJECT COMPLETE/mi.test(content);
+}
+/**
+ * Read iteration count from MEMORY.md.
+ */
+export function readIterationCount(content) {
+    const value = readField(content, 'Iterations This Session');
+    if (!value)
+        return 0;
+    const n = parseInt(value, 10);
+    return isNaN(n) ? 0 : n;
+}
+/**
+ * Increment iteration count.
+ */
+export function incrementIterations(content) {
+    const current = readIterationCount(content);
+    return writeField(content, 'Iterations This Session', String(current + 1));
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/dist/scheduler/util/memory.spec.js

@@ -0,0 +1,165 @@
+import { describe, it, expect } from 'vitest';
+import { readField, writeField, addDoneItem, setNextItem, readSessionConfig, isProjectComplete, readIterationCount, incrementIterations, } from './memory.mjs';
+const SAMPLE_MEMORY = `# MEMORY.md
+
+## Current Phase
+Phase 1: User Authentication
+
+## Current Task
+Create auth domain types
+
+## Current Step
+3 — IMPLEMENT
+
+## Current Worktree
+.worktrees/feat/5-auth-types
+
+## Iterations This Session
+7
+
+## Complexity This Session
+12
+
+## Session Config
+- FRONTEND_APP: my-app
+- BACKEND_APP: api-server
+- Workflow: solo
+
+## Done
+- Set up Nx workspace (2026-03-15)
+- Configure ESLint (2026-03-15)
+
+## Next
+- Create auth domain types
+
+## Decisions
+(none yet)
+
+## Blockers
+(none)
+
+## Notes
+- Project initialized on 2026-03-14
+`;
+// ─── readField ───
+describe('readField', () => {
+    it('reads a simple field', () => {
+        expect(readField(SAMPLE_MEMORY, 'Current Task')).toBe('Create auth domain types');
+    });
+    it('reads a multi-line field', () => {
+        const done = readField(SAMPLE_MEMORY, 'Done');
+        expect(done).toContain('Set up Nx workspace');
+        expect(done).toContain('Configure ESLint');
+    });
+    it('reads a field with structured content', () => {
+        const config = readField(SAMPLE_MEMORY, 'Session Config');
+        expect(config).toContain('FRONTEND_APP: my-app');
+    });
+    it('returns null for non-existent field', () => {
+        expect(readField(SAMPLE_MEMORY, 'Non Existent')).toBeNull();
+    });
+    it('returns null for a field with empty value', () => {
+        const empty = `## Empty Field\n\n## Next Field\nvalue`;
+        expect(readField(empty, 'Empty Field')).toBeNull();
+    });
+    it('reads the last field (no trailing heading)', () => {
+        const notes = readField(SAMPLE_MEMORY, 'Notes');
+        expect(notes).toContain('Project initialized on 2026-03-14');
+    });
+});
+// ─── writeField ───
+describe('writeField', () => {
+    it('updates an existing field', () => {
+        const updated = writeField(SAMPLE_MEMORY, 'Current Task', 'Implement login flow');
+        expect(readField(updated, 'Current Task')).toBe('Implement login flow');
+    });
+    it('preserves other fields when updating', () => {
+        const updated = writeField(SAMPLE_MEMORY, 'Current Task', 'New task');
+        expect(readField(updated, 'Current Phase')).toBe('Phase 1: User Authentication');
+        expect(readField(updated, 'Current Step')).toBe('3 — IMPLEMENT');
+    });
+    it('creates a new field when it does not exist', () => {
+        const updated = writeField(SAMPLE_MEMORY, 'Kit_Version', '1.2.3');
+        expect(readField(updated, 'Kit_Version')).toBe('1.2.3');
+    });
+    it('replaces multi-line content', () => {
+        const updated = writeField(SAMPLE_MEMORY, 'Done', '- Only this item');
+        expect(readField(updated, 'Done')).toBe('- Only this item');
+    });
+});
+// ─── addDoneItem ───
+describe('addDoneItem', () => {
+    it('appends to existing done list', () => {
+        const updated = addDoneItem(SAMPLE_MEMORY, 'Auth types done', '2026-03-20');
+        const done = readField(updated, 'Done');
+        expect(done).toContain('Set up Nx workspace');
+        expect(done).toContain('Auth types done (2026-03-20)');
+    });
+    it('replaces placeholder when Done is empty', () => {
+        const empty = `## Done\n(nothing yet)\n\n## Next\nfoo`;
+        const updated = addDoneItem(empty, 'First task', '2026-03-20');
+        expect(readField(updated, 'Done')).toBe('- First task (2026-03-20)');
+    });
+});
+// ─── setNextItem ───
+describe('setNextItem', () => {
+    it('sets the next item', () => {
+        const updated = setNextItem(SAMPLE_MEMORY, 'Implement login');
+        expect(readField(updated, 'Next')).toBe('- Implement login');
+    });
+});
+// ─── readSessionConfig ───
+describe('readSessionConfig', () => {
+    it('parses session config into key-value pairs', () => {
+        const config = readSessionConfig(SAMPLE_MEMORY);
+        expect(config).toEqual({
+            FRONTEND_APP: 'my-app',
+            BACKEND_APP: 'api-server',
+            Workflow: 'solo',
+        });
+    });
+    it('returns empty object when no config section', () => {
+        expect(readSessionConfig('# Just a heading')).toEqual({});
+    });
+});
+// ─── isProjectComplete ───
+describe('isProjectComplete', () => {
+    it('detects "PROJECT COMPLETE" in Current Phase heading style', () => {
+        const complete = writeField(SAMPLE_MEMORY, 'Current Phase', 'Phase 3: Done — PROJECT COMPLETE');
+        expect(isProjectComplete(complete)).toBe(true);
+    });
+    it('detects Project_Status: complete', () => {
+        const complete = `Project_Status: complete\n`;
+        expect(isProjectComplete(complete)).toBe(true);
+    });
+    it('returns false for in-progress project', () => {
+        expect(isProjectComplete(SAMPLE_MEMORY)).toBe(false);
+    });
+    it('returns false for empty content', () => {
+        expect(isProjectComplete('')).toBe(false);
+    });
+});
+// ─── readIterationCount / incrementIterations ───
+describe('readIterationCount', () => {
+    it('reads iteration count', () => {
+        expect(readIterationCount(SAMPLE_MEMORY)).toBe(7);
+    });
+    it('returns 0 when no iterations field', () => {
+        expect(readIterationCount('# Nothing here')).toBe(0);
+    });
+    it('returns 0 for non-numeric value', () => {
+        const bad = `## Iterations This Session\nnot a number\n`;
+        expect(readIterationCount(bad)).toBe(0);
+    });
+});
+describe('incrementIterations', () => {
+    it('increments from current value', () => {
+        const updated = incrementIterations(SAMPLE_MEMORY);
+        expect(readIterationCount(updated)).toBe(8);
+    });
+    it('increments from 0 when field missing', () => {
+        const noIter = `# MEMORY.md\n## Current Phase\nPhase 0\n`;
+        const updated = incrementIterations(noIter);
+        expect(readIterationCount(updated)).toBe(1);
+    });
+});

package/dist/template/.claude/{profiles/angular.md → agents/angular-engineer.md}

@@ -1,8 +1,13 @@
-# Angular Frontend Profile
+---
+name: angular-engineer
+description: Angular frontend specialist — components, signals, RxJS, SSR, testing
+model: opus
+steps: plan, implement, rework
+---
+
+You are an Angular frontend engineer. You plan, implement, and fix Angular applications.
+Read the codebase before making changes. Follow the conventions below strictly.
 
-> This profile is copied to `.claude/profiles/frontend.md` in the target project by the project-initializer.
-> It is read by: `ui-engineer`, `senior-code-reviewer`, `test-engineer`.
-> It is NOT read by: `orchestrator`, `backend-ts-architect`, `devops-integrator`, `deployment-engineer`, `product-owner`, `technical-planner`.
 
 ## Framework
 

package/dist/template/.claude/{profiles/react.md → agents/react-engineer.md}

@@ -1,8 +1,13 @@
-# React Frontend Profile
+---
+name: react-engineer
+description: React frontend specialist — components, hooks, SSR, Next.js, testing
+model: opus
+steps: plan, implement, rework
+---
+
+You are a React frontend engineer. You plan, implement, and fix React applications.
+Read the codebase before making changes. Follow the conventions below strictly.
 
-> This profile is copied to `.claude/profiles/frontend.md` in the target project by the project-initializer.
-> It is read by: `ui-engineer`, `senior-code-reviewer`, `test-engineer`.
-> It is NOT read by: `orchestrator`, `backend-ts-architect`, `devops-integrator`, `deployment-engineer`, `product-owner`, `technical-planner`.
 
 ## Framework
 

package/dist/template/.claude/{profiles/svelte.md → agents/svelte-engineer.md}

@@ -1,8 +1,13 @@
-# Svelte Frontend Profile
+---
+name: svelte-engineer
+description: Svelte frontend specialist — runes, SvelteKit, SSR, testing
+model: opus
+steps: plan, implement, rework
+---
+
+You are a Svelte frontend engineer. You plan, implement, and fix Svelte/SvelteKit applications.
+Read the codebase before making changes. Follow the conventions below strictly.
 
-> This profile is copied to `.claude/profiles/frontend.md` in the target project by the project-initializer.
-> It is read by: `ui-engineer`, `senior-code-reviewer`, `test-engineer`.
-> It is NOT read by: `orchestrator`, `backend-ts-architect`, `devops-integrator`, `deployment-engineer`, `product-owner`, `technical-planner`.
 
 ## Framework
 

package/dist/template/.claude/{profiles/vue.md → agents/vue-engineer.md}

@@ -1,8 +1,13 @@
-# Vue Frontend Profile
+---
+name: vue-engineer
+description: Vue frontend specialist — Composition API, Pinia, Nuxt, SSR, testing
+model: opus
+steps: plan, implement, rework
+---
+
+You are a Vue frontend engineer. You plan, implement, and fix Vue applications.
+Read the codebase before making changes. Follow the conventions below strictly.
 
-> This profile is copied to `.claude/profiles/frontend.md` in the target project by the project-initializer.
-> It is read by: `ui-engineer`, `senior-code-reviewer`, `test-engineer`.
-> It is NOT read by: `orchestrator`, `backend-ts-architect`, `devops-integrator`, `deployment-engineer`, `product-owner`, `technical-planner`.
 
 ## Framework
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-workspace",
-  "version": "1.1.152",
+  "version": "2.1.0",
   "author": "",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   },
   "files": [
     "dist/index.js",
-    "dist/scripts",
+    "dist/scheduler",
     "dist/template"
   ],
   "keywords": [
@@ -35,8 +35,7 @@
   "scripts": {
     "build": "tsc && node scripts/copy-templates.mjs",
     "test": "vitest run",
-    "test:integration": "vitest run src/scripts/integration.spec.ts",
-    "test:all": "vitest run --config vitest.integration.config.ts",
+    "test:integration": "vitest run src/scheduler/integration.spec.ts",
     "prepublishOnly": "npm run build"
   },
   "type": "module",