@mrpatronz/nexusflow 1.3.3 → 1.6.0

package/dist/core/knowledge.test.js

@@ -0,0 +1,157 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { insertUnderHeading, formatEntry, parseKnowledgeEntries, addWorkspaceKnowledge, addBaseKnowledge, promoteKnowledge, readWorkspaceKnowledge, } from './knowledge.js';
+import * as storage from './storage.js';
+import * as workspace from './workspace.js';
+import * as generators from '../generators/index.js';
+vi.mock('./storage.js');
+vi.mock('./workspace.js');
+vi.mock('../generators/index.js');
+// ─── Pure helpers ───────────────────────────────────────────────────────────
+describe('insertUnderHeading', () => {
+    it('inserts under an existing heading and strips the placeholder', () => {
+        const md = `## Known Gotchas\n\n<!-- keep me -->\n\n_(No gotchas recorded yet.)_\n`;
+        const out = insertUnderHeading(md, ['Known Gotchas'], '- **2026-07-04:** watch the cache');
+        expect(out).toContain('- **2026-07-04:** watch the cache');
+        expect(out).not.toContain('No gotchas recorded yet');
+        expect(out).toContain('<!-- keep me -->'); // comments are preserved
+    });
+    it('matches a heading via an alias', () => {
+        const md = `## Discovered Gotchas & Watch-outs\n\n- None recorded yet.\n`;
+        const out = insertUnderHeading(md, ['Discovered Gotchas & Watch-outs', 'Known Gotchas'], '- **2026-07-04:** x');
+        expect(out).toContain('- **2026-07-04:** x');
+        expect(out).not.toContain('None recorded yet');
+    });
+    it('appends a new section when the heading is missing', () => {
+        const md = `# Workspace Knowledge — feat\n`;
+        const out = insertUnderHeading(md, ['Architecture Decisions'], '### 2026-07-04 — Chose X\n**Decision:** because reasons');
+        expect(out).toContain('## Architecture Decisions');
+        expect(out).toContain('**Decision:** because reasons');
+    });
+    it('preserves CRLF line endings', () => {
+        const md = `## Known Gotchas\r\n\r\n_(No gotchas recorded yet.)_\r\n`;
+        const out = insertUnderHeading(md, ['Known Gotchas'], '- foo');
+        expect(out.includes('\r\n')).toBe(true);
+        // No bare LF (every \n must be preceded by \r).
+        expect(/[^\r]\n/.test(out)).toBe(false);
+    });
+    it('passes through a leading YAML frontmatter block', () => {
+        const md = `---\ntags: ["x"]\ntype: workspace-context\n---\n\n## Known Gotchas\n\n_(No gotchas recorded yet.)_\n`;
+        const out = insertUnderHeading(md, ['Known Gotchas'], '- foo');
+        expect(out.startsWith('---')).toBe(true);
+        expect(out).toContain('tags: ["x"]');
+        expect(out).toContain('- foo');
+    });
+    it('does not destroy an existing entry when adding another', () => {
+        const md = `## Known Gotchas\n\n- **2026-07-01:** first\n`;
+        const out = insertUnderHeading(md, ['Known Gotchas'], '- **2026-07-04:** second');
+        expect(out).toContain('- **2026-07-01:** first');
+        expect(out).toContain('- **2026-07-04:** second');
+    });
+});
+describe('formatEntry', () => {
+    const ts = '2026-07-04T10:00:00.000Z';
+    it('formats a decision with a title as a dated ### block', () => {
+        const out = formatEntry({ type: 'decision', message: 'use worktrees', title: 'Worktrees', timestamp: ts }, 'workspace');
+        expect(out).toBe('### 2026-07-04 — Worktrees\n**Decision:** use worktrees');
+    });
+    it('formats a gotcha as a dated bullet', () => {
+        const out = formatEntry({ type: 'gotcha', message: 'EBUSY on Windows', timestamp: ts }, 'workspace');
+        expect(out).toBe('- **2026-07-04:** EBUSY on Windows');
+    });
+    it('formats progress as a checked item', () => {
+        const out = formatEntry({ type: 'progress', message: 'shipped rollback', timestamp: ts }, 'workspace');
+        expect(out).toBe('- [x] 2026-07-04 — shipped rollback');
+    });
+});
+describe('parseKnowledgeEntries', () => {
+    it('parses bullet entries and decision blocks with their types', () => {
+        const md = [
+            '## Known Gotchas',
+            '',
+            '- **2026-07-04:** watch out',
+            '',
+            '## Architecture Decisions',
+            '',
+            '### 2026-07-04 — Chose X',
+            '**Decision:** because',
+            '',
+        ].join('\n');
+        const parsed = parseKnowledgeEntries(md);
+        expect(parsed).toContainEqual({
+            section: 'Known Gotchas',
+            type: 'gotcha',
+            text: '- **2026-07-04:** watch out',
+        });
+        const decision = parsed.find((p) => p.type === 'decision');
+        expect(decision?.text).toContain('### 2026-07-04 — Chose X');
+        expect(decision?.text).toContain('**Decision:** because');
+    });
+    it('ignores placeholder and comment lines', () => {
+        const md = `## Known Gotchas\n\n<!-- hint -->\n\n_(No gotchas recorded yet.)_\n`;
+        expect(parseKnowledgeEntries(md)).toHaveLength(0);
+    });
+});
+// ─── Adapter-routed I/O (in-memory storage mock) ────────────────────────────
+describe('knowledge I/O', () => {
+    const ws = new Map();
+    const base = new Map();
+    beforeEach(() => {
+        vi.clearAllMocks();
+        ws.clear();
+        base.clear();
+        vi.mocked(workspace.loadFeatureConfig).mockResolvedValue({ id: 'feat' });
+        vi.mocked(generators.buildBaseKnowledgeContent).mockImplementation((repo) => `# Base Codebase Knowledge — ${repo}\n\n## Discovered Gotchas & Watch-outs\n- None recorded yet.\n\n## Architecture Decisions\n- None recorded yet.\n`);
+        vi.mocked(storage.workspaceFileExists).mockImplementation(async (_w, fid, fn) => ws.has(`${fid}/${fn}`));
+        vi.mocked(storage.readWorkspaceFile).mockImplementation(async (_w, fid, fn) => ws.get(`${fid}/${fn}`));
+        vi.mocked(storage.writeWorkspaceFile).mockImplementation(async (_w, fid, fn, c) => {
+            ws.set(`${fid}/${fn}`, c);
+        });
+        vi.mocked(storage.resolveWorkspaceFileUrl).mockImplementation((_w, fid, fn) => `ws:/${fid}/${fn}`);
+        vi.mocked(storage.baseFileExists).mockImplementation(async (_w, repo, fn) => base.has(`${repo}/${fn}`));
+        vi.mocked(storage.readBaseFile).mockImplementation(async (_w, repo, fn) => base.get(`${repo}/${fn}`));
+        vi.mocked(storage.writeBaseFile).mockImplementation(async (_w, repo, fn, c) => {
+            base.set(`${repo}/${fn}`, c);
+        });
+        vi.mocked(storage.resolveBaseFileUrl).mockImplementation((_w, repo, fn) => `base:/${repo}/${fn}`);
+    });
+    it('creates the workspace knowledge file when missing and records the entry', async () => {
+        const result = await addWorkspaceKnowledge('/wsp', {
+            type: 'decision',
+            message: 'store knowledge via the adapter',
+            title: 'Adapter routing',
+        });
+        expect(result.createdFile).toBe(true);
+        const content = ws.get('feat/nexusflow-knowledge.md');
+        expect(content).toContain('## Architecture Decisions');
+        expect(content).toContain('**Decision:** store knowledge via the adapter');
+    });
+    it('rejects an empty message', async () => {
+        await expect(addWorkspaceKnowledge('/wsp', { type: 'gotcha', message: '   ' })).rejects.toThrow(/cannot be empty/i);
+    });
+    it('adds to a repo base file, bootstrapping it from the template', async () => {
+        const result = await addBaseKnowledge('/wsp', 'api', { type: 'gotcha', message: 'flaky test on CI' });
+        expect(result.createdFile).toBe(true);
+        const content = base.get('api/nexusflow-knowledge.md');
+        expect(content).toContain('## Discovered Gotchas & Watch-outs');
+        expect(content).toContain('flaky test on CI');
+    });
+    it('promotes a gotcha to base knowledge (copy leaves the workspace entry)', async () => {
+        ws.set('feat/nexusflow-knowledge.md', `# Workspace Knowledge — feat\n\n## Known Gotchas\n\n- **2026-07-04:** shared learning\n`);
+        const entries = parseKnowledgeEntries((await readWorkspaceKnowledge('/wsp')));
+        const result = await promoteKnowledge('/wsp', { repoName: 'api', entries, mode: 'copy' });
+        expect(result.promotedCount).toBe(1);
+        expect(base.get('api/nexusflow-knowledge.md')).toContain('- **2026-07-04:** shared learning');
+        // Copy mode keeps the original.
+        expect(ws.get('feat/nexusflow-knowledge.md')).toContain('- **2026-07-04:** shared learning');
+    });
+    it('move mode replaces the promoted workspace entry with a note', async () => {
+        ws.set('feat/nexusflow-knowledge.md', `# Workspace Knowledge — feat\n\n## Known Gotchas\n\n- **2026-07-04:** shared learning\n`);
+        const entries = parseKnowledgeEntries((await readWorkspaceKnowledge('/wsp')));
+        await promoteKnowledge('/wsp', { repoName: 'api', entries, mode: 'move' });
+        const wsContent = ws.get('feat/nexusflow-knowledge.md');
+        expect(wsContent).not.toContain('shared learning');
+        expect(wsContent).toContain('Promoted to api base knowledge');
+        expect(base.get('api/nexusflow-knowledge.md')).toContain('shared learning');
+    });
+});
+//# sourceMappingURL=knowledge.test.js.map

package/dist/core/knowledge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.test.js","sourceRoot":"","sources":["../../src/core/knowledge.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACxB,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAC1B,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAElC,+EAA+E;AAE/E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,EAAE,GAAG,wEAAwE,CAAC;QACpF,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,mCAAmC,CAAC,CAAC;QAE3F,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,yBAAyB;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,GAAG,8DAA8D,CAAC;QAC1E,MAAM,GAAG,GAAG,kBAAkB,CAC5B,EAAE,EACF,CAAC,iCAAiC,EAAE,eAAe,CAAC,EACpD,qBAAqB,CACtB,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,GAAG,gCAAgC,CAAC;QAC5C,MAAM,GAAG,GAAG,kBAAkB,CAC5B,EAAE,EACF,CAAC,wBAAwB,CAAC,EAC1B,yDAAyD,CAC1D,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAG,0DAA0D,CAAC;QACtE,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,gDAAgD;QAChD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAG,sGAAsG,CAAC;QAClH,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,EAAE,GAAG,+CAA+C,CAAC;QAC3D,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAClF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,EAAE,GAAG,0BAA0B,CAAC;IAEtC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QACxH,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QACrG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QACvG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,GAAG;YACT,kBAAkB;YAClB,EAAE;YACF,6BAA6B;YAC7B,EAAE;YACF,2BAA2B;YAC3B,EAAE;YACF,0BAA0B;YAC1B,uBAAuB;YACvB,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC;YAC5B,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,6BAA6B;SACpC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAC7D,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,EAAE,GAAG,qEAAqE,CAAC;QACjF,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,EAAE,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAS,CAAC,CAAC;QAChF,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,kBAAkB,CAChE,CAAC,IAAY,EAAE,EAAE,CACf,+BAA+B,IAAI,mHAAmH,CACzJ,CAAC;QAEF,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACzG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAE,CAAC,CAAC;QACxG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;YAChF,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;QAEnG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACxG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAE,CAAC,CAAC;QACvG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;YAC5E,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE;YACjD,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,iCAAiC;YAC1C,KAAK,EAAE,iBAAiB;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAE,CAAC;QACvD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,+CAA+C,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,CACV,qBAAqB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAClE,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACtG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAE,CAAC;QACxD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,EAAE,CAAC,GAAG,CACJ,6BAA6B,EAC7B,yFAAyF,CAC1F,CAAC;QACF,MAAM,OAAO,GAAG,qBAAqB,CAAC,CAAC,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAE,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE1F,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC9F,gCAAgC;QAChC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,EAAE,CAAC,GAAG,CACJ,6BAA6B,EAC7B,yFAAyF,CAC1F,CAAC;QACF,MAAM,OAAO,GAAG,qBAAqB,CAAC,CAAC,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAE,CAAC,CAAC;QAE/E,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3E,MAAM,SAAS,GAAG,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAE,CAAC;QACzD,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/refresh.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refresh.test.d.ts.map

package/dist/core/refresh.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.test.d.ts","sourceRoot":"","sources":["../../src/core/refresh.test.ts"],"names":[],"mappings":""}

package/dist/core/refresh.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import { refreshWorkspace } from './refresh.js';
+import * as workspace from './workspace.js';
+import * as analyzers from '../analyzers/index.js';
+import * as generators from '../generators/index.js';
+import * as handoff from '../commands/handoff.js';
+vi.mock('node:fs/promises');
+vi.mock('./workspace.js');
+vi.mock('../analyzers/index.js');
+vi.mock('../generators/index.js');
+vi.mock('../commands/handoff.js');
+const feature = {
+    id: 'feat',
+    branchName: 'feat',
+    description: 'd',
+    repos: ['/ws/a', '/ws/b'],
+    assistants: ['claude'],
+    workspacePath: '/ws',
+    createdAt: '2026-07-04T00:00:00Z',
+};
+describe('refreshWorkspace', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(workspace.loadFeatureConfig).mockResolvedValue(feature);
+        vi.mocked(workspace.resolveRepoInfos).mockResolvedValue([
+            { name: 'a', path: '/ws/a', defaultBranch: 'main' },
+            { name: 'b', path: '/ws/b', defaultBranch: 'main' },
+        ]);
+        vi.mocked(analyzers.analyzeAllReposCached).mockResolvedValue({ analysis: new Map(), analyzed: ['a'], reused: ['b'] });
+        vi.mocked(generators.generateContextFiles).mockResolvedValue(undefined);
+        vi.mocked(handoff.handoffCommand).mockResolvedValue(undefined);
+        // No handoff bundle by default.
+        vi.mocked(fs.access).mockRejectedValue(new Error('ENOENT'));
+    });
+    it('throws when the workspace manifest is missing', async () => {
+        vi.mocked(workspace.loadFeatureConfig).mockResolvedValue(null);
+        await expect(refreshWorkspace('/ws')).rejects.toThrow(/Failed to load workspace configuration/);
+    });
+    it('passes analyzed/reused through to the report', async () => {
+        const report = await refreshWorkspace('/ws');
+        expect(report.analyzedRepos).toEqual(['a']);
+        expect(report.reusedRepos).toEqual(['b']);
+    });
+    it('limits map regeneration to changed repos by default', async () => {
+        await refreshWorkspace('/ws');
+        // 6th arg (changedRepos) is the analyzed list when not forcing.
+        expect(generators.generateContextFiles).toHaveBeenCalledWith(expect.any(Object), feature.assistants, '/ws', undefined, undefined, ['a']);
+    });
+    it('passes undefined changed-repos filter when force is set', async () => {
+        await refreshWorkspace('/ws', { force: true });
+        expect(generators.generateContextFiles).toHaveBeenCalledWith(expect.any(Object), feature.assistants, '/ws', undefined, undefined, undefined);
+    });
+    it('refreshes the handoff bundle when it exists and not baseOnly', async () => {
+        vi.mocked(fs.access).mockResolvedValue(undefined); // handoff file exists
+        const report = await refreshWorkspace('/ws');
+        expect(handoff.handoffCommand).toHaveBeenCalledWith('/ws');
+        expect(report.refreshedHandoff).toBe(true);
+    });
+    it('does not touch the handoff bundle when baseOnly', async () => {
+        vi.mocked(fs.access).mockResolvedValue(undefined);
+        const report = await refreshWorkspace('/ws', { baseOnly: true });
+        expect(handoff.handoffCommand).not.toHaveBeenCalled();
+        expect(report.refreshedHandoff).toBe(false);
+    });
+});
+//# sourceMappingURL=refresh.test.js.map

package/dist/core/refresh.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.test.js","sourceRoot":"","sources":["../../src/core/refresh.test.ts"],"names":[],"mappings":"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"}

package/dist/core/status.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module core/status
+ * Headless cross-repo status report for a workspace. Backs the MCP
+ * `workspace_status` tool and the `finish` preflight, and can back a GUI
+ * status route. Throws only if the workspace manifest cannot be read.
+ */
+import { type RepoStatusFile } from '../utils/multi-git.js';
+/** Full status for a single repo in a workspace. */
+export interface RepoStatusReport {
+    name: string;
+    path: string;
+    /** Current branch, or `null` when the repo is in a detached-HEAD state. */
+    branch: string | null;
+    /** The feature branch the workspace expects every repo to be on. */
+    expectedBranch: string;
+    onExpectedBranch: boolean;
+    dirty: boolean;
+    changedFiles: RepoStatusFile[];
+    /** Commits ahead of origin, or `null` when the branch was never pushed. */
+    ahead: number | null;
+    /** Commits behind origin, or `null` when the branch was never pushed. */
+    behind: number | null;
+    remoteUrl: string | null;
+    defaultBranch: string;
+}
+/** Aggregate workspace status. */
+export interface WorkspaceStatusReport {
+    workspacePath: string;
+    branchName: string;
+    repos: RepoStatusReport[];
+    /** True when no repo has working-tree changes. */
+    allClean: boolean;
+    /** True when every repo is pushed (ahead === 0). A never-pushed branch counts as NOT pushed. */
+    allPushed: boolean;
+}
+/**
+ * Gathers branch, dirtiness, ahead/behind, and remote info for every repo in
+ * the workspace.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @returns The aggregate {@link WorkspaceStatusReport}.
+ * @throws If `nexusflow.json` cannot be read or parsed.
+ */
+export declare function getWorkspaceStatusReport(workspacePath: string): Promise<WorkspaceStatusReport>;
+//# sourceMappingURL=status.d.ts.map

package/dist/core/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/core/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,gGAAgG;IAChG,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAkChC"}

package/dist/core/status.js

@@ -0,0 +1,45 @@
+/**
+ * @module core/status
+ * Headless cross-repo status report for a workspace. Backs the MCP
+ * `workspace_status` tool and the `finish` preflight, and can back a GUI
+ * status route. Throws only if the workspace manifest cannot be read.
+ */
+import { getWorkspaceRepos, getRepoBranch, getRepoStatus, getAheadBehind, getRemoteUrl, } from '../utils/multi-git.js';
+/**
+ * Gathers branch, dirtiness, ahead/behind, and remote info for every repo in
+ * the workspace.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @returns The aggregate {@link WorkspaceStatusReport}.
+ * @throws If `nexusflow.json` cannot be read or parsed.
+ */
+export async function getWorkspaceStatusReport(workspacePath) {
+    const repos = await getWorkspaceRepos(workspacePath);
+    const reports = await Promise.all(repos.map(async (repo) => {
+        const [branch, status, remoteUrl, aheadBehind] = await Promise.all([
+            getRepoBranch(repo.path),
+            getRepoStatus(repo.path),
+            getRemoteUrl(repo.path),
+            getAheadBehind(repo.path, repo.branchName),
+        ]);
+        return {
+            name: repo.name,
+            path: repo.path,
+            branch,
+            expectedBranch: repo.branchName,
+            onExpectedBranch: branch === repo.branchName,
+            dirty: status.hasChanges,
+            changedFiles: status.files,
+            ahead: aheadBehind.ahead,
+            behind: aheadBehind.behind,
+            remoteUrl,
+            defaultBranch: repo.defaultBranch,
+        };
+    }));
+    const branchName = repos[0]?.branchName ?? '';
+    const allClean = reports.every((r) => !r.dirty);
+    // `ahead === null` means the branch was never pushed, which is not "pushed".
+    const allPushed = reports.every((r) => r.ahead === 0);
+    return { workspacePath, branchName, repos: reports, allClean, allPushed };
+}
+//# sourceMappingURL=status.js.map

package/dist/core/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/core/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,GAEb,MAAM,uBAAuB,CAAC;AAgC/B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,aAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAErD,MAAM,OAAO,GAAuB,MAAM,OAAO,CAAC,GAAG,CACnD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAA6B,EAAE;QAClD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC;SAC3C,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;YACN,cAAc,EAAE,IAAI,CAAC,UAAU;YAC/B,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC,UAAU;YAC5C,KAAK,EAAE,MAAM,CAAC,UAAU;YACxB,YAAY,EAAE,MAAM,CAAC,KAAK;YAC1B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,SAAS;YACT,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChD,6EAA6E;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAEtD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC5E,CAAC"}

package/dist/core/sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync.test.d.ts.map

package/dist/core/sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.test.d.ts","sourceRoot":"","sources":["../../src/core/sync.test.ts"],"names":[],"mappings":""}

package/dist/core/sync.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { syncWorkspace } from './sync.js';
+import * as workspace from './workspace.js';
+import * as workspaceState from './workspace-state.js';
+import * as multiGit from '../utils/multi-git.js';
+import * as analyzers from '../analyzers/index.js';
+import * as generators from '../generators/index.js';
+vi.mock('./workspace.js');
+vi.mock('./workspace-state.js');
+vi.mock('../utils/multi-git.js');
+vi.mock('../analyzers/index.js');
+vi.mock('../generators/index.js');
+const feature = {
+    id: 'feat',
+    branchName: 'feat',
+    description: 'd',
+    repos: ['/ws/a', '/ws/b'],
+    assistants: ['claude'],
+    workspacePath: '/ws',
+    createdAt: '2026-07-04T00:00:00Z',
+};
+function wsRepo(name) {
+    return { name, path: `/ws/${name}`, branchName: 'feat', defaultBranch: 'main' };
+}
+function rebase(status) {
+    return { success: status !== 'conflict' && status !== 'error', status, message: status };
+}
+describe('syncWorkspace', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(workspace.loadFeatureConfig).mockResolvedValue(feature);
+        vi.mocked(workspace.resolveRepoInfos).mockResolvedValue([
+            { name: 'a', path: '/ws/a', defaultBranch: 'main' },
+            { name: 'b', path: '/ws/b', defaultBranch: 'main' },
+        ]);
+        vi.mocked(workspaceState.recordRepoSync).mockResolvedValue(undefined);
+        vi.mocked(multiGit.getWorkspaceRepos).mockResolvedValue([wsRepo('a'), wsRepo('b')]);
+        vi.mocked(analyzers.analyzeAllReposCached).mockResolvedValue({ analysis: new Map(), analyzed: ['a'], reused: ['b'] });
+        vi.mocked(generators.generateContextFiles).mockResolvedValue(undefined);
+    });
+    it('throws when the workspace manifest is missing', async () => {
+        vi.mocked(workspace.loadFeatureConfig).mockResolvedValue(null);
+        await expect(syncWorkspace('/ws')).rejects.toThrow(/Failed to load workspace configuration/);
+    });
+    it('classifies per-repo outcomes into counts', async () => {
+        vi.mocked(multiGit.rebaseRepo)
+            .mockResolvedValueOnce(rebase('conflict'))
+            .mockResolvedValueOnce(rebase('error'));
+        const report = await syncWorkspace('/ws');
+        expect(report.conflictCount).toBe(1);
+        expect(report.errorCount).toBe(1);
+        expect(report.syncedCount).toBe(0);
+        expect(report.repos.map((r) => r.status)).toEqual(['conflict', 'error']);
+    });
+    it('records each repo sync outcome to workspace state', async () => {
+        vi.mocked(multiGit.rebaseRepo).mockResolvedValue(rebase('up-to-date'));
+        await syncWorkspace('/ws');
+        expect(workspaceState.recordRepoSync).toHaveBeenCalledTimes(2);
+        expect(workspaceState.recordRepoSync).toHaveBeenCalledWith('/ws', 'a', expect.objectContaining({ status: 'up-to-date' }));
+    });
+    it('does not regenerate context when every repo is up to date', async () => {
+        vi.mocked(multiGit.rebaseRepo).mockResolvedValue(rebase('up-to-date'));
+        const report = await syncWorkspace('/ws');
+        expect(report.contextRefreshed).toBe(false);
+        expect(analyzers.analyzeAllReposCached).not.toHaveBeenCalled();
+        expect(generators.generateContextFiles).not.toHaveBeenCalled();
+    });
+    it('regenerates context when a repo was rebased', async () => {
+        vi.mocked(multiGit.rebaseRepo)
+            .mockResolvedValueOnce(rebase('rebased'))
+            .mockResolvedValueOnce(rebase('up-to-date'));
+        const report = await syncWorkspace('/ws');
+        expect(report.contextRefreshed).toBe(true);
+        expect(analyzers.analyzeAllReposCached).toHaveBeenCalled();
+        expect(generators.generateContextFiles).toHaveBeenCalled();
+    });
+    it('tolerates a generator failure without failing the sync', async () => {
+        vi.mocked(multiGit.rebaseRepo).mockResolvedValue(rebase('rebased'));
+        vi.mocked(generators.generateContextFiles).mockRejectedValue(new Error('gen boom'));
+        const report = await syncWorkspace('/ws');
+        // The rebases already happened; a regen failure just leaves contextRefreshed false.
+        expect(report.contextRefreshed).toBe(false);
+        expect(report.syncedCount).toBe(2);
+    });
+});
+//# sourceMappingURL=sync.test.js.map

package/dist/core/sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.test.js","sourceRoot":"","sources":["../../src/core/sync.test.ts"],"names":[],"mappings":"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"}

package/dist/core/workspace.create.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.create.test.d.ts.map

package/dist/core/workspace.create.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.create.test.d.ts","sourceRoot":"","sources":["../../src/core/workspace.create.test.ts"],"names":[],"mappings":""}

package/dist/core/workspace.create.test.js

@@ -0,0 +1,95 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { execa } from 'execa';
+import { createWorkspace } from './workspace.js';
+import * as worktree from './worktree.js';
+vi.mock('execa');
+vi.mock('./worktree.js');
+/** Unique temp workspace path per test (no Date.now/random needed). */
+let counter = 0;
+let workspacePath = '';
+function feature(repos) {
+    return {
+        id: 'feat-branch',
+        branchName: 'feat-branch',
+        description: 'test',
+        repos: repos.map((r) => path.join(workspacePath, r.name)),
+        originalRepos: repos.map((r) => r.path),
+        assistants: ['claude'],
+        workspacePath,
+        createdAt: '2026-07-04T00:00:00.000Z',
+    };
+}
+function repoInfos(...names) {
+    return names.map((name) => ({ name, path: path.join('/src', name), defaultBranch: 'main' }));
+}
+/** Args of every recorded `git` execa call. */
+function gitCalls() {
+    return vi.mocked(execa).mock.calls.map((c) => c[1]);
+}
+describe('createWorkspace rollback', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        counter += 1;
+        workspacePath = path.join(os.tmpdir(), `nexusflow-create-test-${process.pid}-${counter}`);
+        // Non-worktree git calls (init, branch -D, prune) just succeed.
+        vi.mocked(execa).mockResolvedValue({ stdout: '' });
+        vi.mocked(worktree.removeWorktree).mockResolvedValue(undefined);
+    });
+    afterEach(async () => {
+        await fs.rm(workspacePath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }).catch(() => { });
+    });
+    it('creates worktrees for all repos and saves the manifest on success', async () => {
+        vi.mocked(worktree.createWorktree).mockResolvedValue({ createdBranch: true });
+        const repos = repoInfos('api', 'web');
+        await createWorkspace(feature(repos), repos);
+        expect(worktree.createWorktree).toHaveBeenCalledTimes(2);
+        expect(worktree.removeWorktree).not.toHaveBeenCalled();
+        const manifest = await fs.readFile(path.join(workspacePath, 'nexusflow.json'), 'utf-8');
+        expect(JSON.parse(manifest).branchName).toBe('feat-branch');
+    });
+    it('rolls back created worktrees and branches when a later worktree fails', async () => {
+        vi.mocked(worktree.createWorktree)
+            .mockResolvedValueOnce({ createdBranch: true }) // api ok
+            .mockRejectedValueOnce(new Error('fatal: worktree add failed')); // web fails
+        const repos = repoInfos('api', 'web');
+        await expect(createWorkspace(feature(repos), repos)).rejects.toThrow(/worktree add failed/);
+        // Only the successfully-created worktree (api) is removed.
+        expect(worktree.removeWorktree).toHaveBeenCalledTimes(1);
+        expect(worktree.removeWorktree).toHaveBeenCalledWith(path.join('/src', 'api'), path.join(workspacePath, 'api'), true);
+        // Its run-created branch is deleted.
+        expect(gitCalls()).toContainEqual(['branch', '-D', 'feat-branch']);
+        // The workspace directory is gone.
+        await expect(fs.access(workspacePath)).rejects.toBeTruthy();
+    });
+    it('does not delete a branch that already existed (was only checked out)', async () => {
+        vi.mocked(worktree.createWorktree)
+            .mockResolvedValueOnce({ createdBranch: false }) // api reused an existing branch
+            .mockRejectedValueOnce(new Error('boom'));
+        const repos = repoInfos('api', 'web');
+        await expect(createWorkspace(feature(repos), repos)).rejects.toThrow(/boom/);
+        expect(worktree.removeWorktree).toHaveBeenCalledTimes(1);
+        expect(gitCalls().some((c) => c[0] === 'branch' && c[1] === '-D')).toBe(false);
+    });
+    it('fails fast when the workspace directory already exists and is non-empty', async () => {
+        await fs.mkdir(workspacePath, { recursive: true });
+        await fs.writeFile(path.join(workspacePath, 'existing.txt'), 'x', 'utf-8');
+        const repos = repoInfos('api');
+        await expect(createWorkspace(feature(repos), repos)).rejects.toThrow(/already exists and is not empty/);
+        expect(worktree.createWorktree).not.toHaveBeenCalled();
+    });
+    it('completes rollback even when removeWorktree fails (prunes and removes the dir)', async () => {
+        vi.mocked(worktree.createWorktree)
+            .mockResolvedValueOnce({ createdBranch: true })
+            .mockRejectedValueOnce(new Error('kaboom'));
+        vi.mocked(worktree.removeWorktree).mockRejectedValue(new Error('worktree locked'));
+        const repos = repoInfos('api', 'web');
+        await expect(createWorkspace(feature(repos), repos)).rejects.toThrow(/kaboom/);
+        // Falls back to `git worktree prune` when removal fails.
+        expect(gitCalls()).toContainEqual(['worktree', 'prune']);
+        await expect(fs.access(workspacePath)).rejects.toBeTruthy();
+    });
+});
+//# sourceMappingURL=workspace.create.test.js.map

package/dist/core/workspace.create.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.create.test.js","sourceRoot":"","sources":["../../src/core/workspace.create.test.ts"],"names":[],"mappings":"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"}

package/dist/core/workspace.d.ts

@@ -19,11 +19,17 @@ export declare function getWorkspacePath(workspacesDir: string, branchName: stri
  * 2. Creates a git worktree for every repo in the feature.
  * 3. Saves the feature manifest (`nexusflow.json`).
  *
- * @param feature - The feature definition.
- * @param repos   - Resolved repo metadata for every repo in the feature.
+ * If any worktree fails, the partially-created workspace is rolled back
+ * automatically (worktrees removed, run-created branches deleted, directory
+ * removed) and the original error is rethrown, so a failed `create` never
+ * leaves debris behind.
+ *
+ * @param feature    - The feature definition.
+ * @param repos      - Resolved repo metadata for every repo in the feature.
+ * @param onProgress - Optional per-repo progress callback (repo name, index, total).
  * @returns The absolute path to the newly created workspace.
  */
-export declare function createWorkspace(feature: Feature, repos: RepoInfo[]): Promise<string>;
+export declare function createWorkspace(feature: Feature, repos: RepoInfo[], onProgress?: (repoName: string, index: number, total: number) => void): Promise<string>;
 /**
  * Lists all existing workspaces by reading `nexusflow.json` manifests from
  * each subdirectory of {@link workspacesDir}.

package/dist/core/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/core/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAWvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAiGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAyBzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBjF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA6Df"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/core/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAWvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAmDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACpE,OAAO,CAAC,MAAM,CAAC,CA4HjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAyBzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBjF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAoEf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA6Df"}