@mrpatronz/nexusflow 1.3.2 → 1.5.0

package/dist/core/knowledge.js

@@ -0,0 +1,299 @@
+/**
+ * @module core/knowledge
+ * Single engine for capturing workspace/base knowledge, shared by the CLI
+ * `knowledge` command, the dashboard server, and the MCP `add_knowledge` /
+ * `promote_knowledge` tools.
+ *
+ * All file I/O routes through the active storage adapter (`core/storage.ts`)
+ * so the local, central-vault, and Obsidian backends keep working — the
+ * previous direct-`fs` knowledge routes silently wrote to a file the
+ * generators never read under the Obsidian adapter.
+ *
+ * The markdown helpers (`insertUnderHeading`, `formatEntry`,
+ * `parseKnowledgeEntries`) are pure and section-aware: they insert under the
+ * correct heading, tolerate leading YAML frontmatter (Obsidian) and CRLF, and
+ * never destroy existing content.
+ */
+import * as path from 'node:path';
+import { loadFeatureConfig } from './workspace.js';
+import { readWorkspaceFile, writeWorkspaceFile, workspaceFileExists, resolveWorkspaceFileUrl, readBaseFile, writeBaseFile, baseFileExists, resolveBaseFileUrl, } from './storage.js';
+import { buildBaseKnowledgeContent } from '../generators/index.js';
+/** The knowledge filename used for both the workspace and base layers. */
+const KNOWLEDGE_FILE = 'nexusflow-knowledge.md';
+/**
+ * Heading aliases per entry type for the workspace and base knowledge files.
+ * The first alias is the canonical heading used when the section is missing.
+ * `base: null` means the type is not promotable to base knowledge.
+ */
+const SECTION_ALIASES = {
+    decision: {
+        workspace: ['Architecture Decisions'],
+        base: ['Architecture Decisions'],
+    },
+    gotcha: {
+        workspace: ['Known Gotchas', 'Discovered Gotchas & Watch-outs', 'Discovered Gotchas'],
+        base: ['Discovered Gotchas & Watch-outs', 'Known Gotchas', 'Discovered Gotchas'],
+    },
+    progress: {
+        workspace: ['Implementation Progress'],
+        base: null,
+    },
+    assumption: {
+        workspace: ['Project Assumptions (verify with user)', 'Project Assumptions'],
+        base: ['Coding Conventions & Invariants'],
+    },
+    question: {
+        workspace: ['Clarifying Questions for the User', 'Clarifying Questions'],
+        base: null,
+    },
+};
+// ─── Pure markdown helpers ──────────────────────────────────────────────────
+/** True for template placeholder lines that should be replaced by real content. */
+function isPlaceholder(line) {
+    const t = line.trim();
+    if (!t)
+        return false;
+    if (/^_\(.*\)_$/.test(t))
+        return true; // e.g. _(No gotchas recorded yet.)_
+    if (/^-\s*None recorded yet\.?$/i.test(t))
+        return true;
+    return false;
+}
+function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+function truncateHeading(text, max = 60) {
+    const oneLine = text.replace(/\s+/g, ' ').trim();
+    return oneLine.length <= max ? oneLine : `${oneLine.slice(0, max).trimEnd()}…`;
+}
+/**
+ * Formats a {@link KnowledgeEntry} as the markdown snippet to insert.
+ *
+ * @param entry  - The entry to format.
+ * @param _target - Reserved for target-specific formatting (currently identical).
+ */
+export function formatEntry(entry, _target) {
+    const date = (entry.timestamp ?? new Date().toISOString()).slice(0, 10);
+    const msg = entry.message.trim();
+    switch (entry.type) {
+        case 'decision': {
+            const heading = entry.title?.trim() ? entry.title.trim() : truncateHeading(msg);
+            return `### ${date} — ${heading}\n**Decision:** ${msg}`;
+        }
+        case 'progress':
+            return `- [x] ${date} — ${msg}`;
+        case 'gotcha':
+        case 'assumption':
+        case 'question':
+        default:
+            return `- **${date}:** ${msg}`;
+    }
+}
+/**
+ * Inserts `entryMarkdown` under the first `## ` heading matching any of
+ * `headingAliases` (case-insensitive), stripping placeholder lines. When no
+ * matching heading exists, a new section is appended at end-of-file using the
+ * first alias. Existing content is never removed. CRLF line endings and a
+ * leading YAML frontmatter block are preserved.
+ *
+ * @returns The updated markdown.
+ */
+export function insertUnderHeading(markdown, headingAliases, entryMarkdown) {
+    const eol = markdown.includes('\r\n') ? '\r\n' : '\n';
+    const lines = markdown.split(/\r?\n/);
+    const aliasSet = new Set(headingAliases.map((a) => a.trim().toLowerCase()));
+    // Find the target section heading.
+    let headingIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^##\s+(.*)$/);
+        if (m && aliasSet.has(m[1].trim().toLowerCase())) {
+            headingIdx = i;
+            break;
+        }
+    }
+    const entryLines = entryMarkdown.split(/\r?\n/);
+    if (headingIdx === -1) {
+        // Append a fresh section at end-of-file.
+        const trimmed = lines.join(eol).replace(/\s+$/, '');
+        const prefix = trimmed.length > 0 ? `${trimmed}${eol}${eol}` : '';
+        return `${prefix}## ${headingAliases[0]}${eol}${eol}${entryLines.join(eol)}${eol}`;
+    }
+    // Determine the section body range: until the next h1/h2 or EOF.
+    let sectionEnd = lines.length;
+    for (let i = headingIdx + 1; i < lines.length; i++) {
+        if (/^#{1,2}\s/.test(lines[i])) {
+            sectionEnd = i;
+            break;
+        }
+    }
+    const before = lines.slice(0, headingIdx + 1);
+    const after = lines.slice(sectionEnd);
+    // Keep comments and real content; drop placeholders and trailing blanks.
+    const body = lines.slice(headingIdx + 1, sectionEnd).filter((l) => !isPlaceholder(l));
+    while (body.length > 0 && body[body.length - 1].trim() === '') {
+        body.pop();
+    }
+    // One blank line between the heading (or existing content) and the new entry.
+    const newSection = [...before, ...body, '', ...entryLines, ''];
+    // Preserve a single blank line before the next section, if any.
+    const tail = after.length > 0 ? [...after] : [];
+    return [...newSection, ...tail].join(eol);
+}
+/** Reverse lookup: which entry type owns a given `## ` heading, if any. */
+function sectionType(heading) {
+    const h = heading.trim().toLowerCase();
+    for (const [type, aliases] of Object.entries(SECTION_ALIASES)) {
+        const all = [...aliases.workspace, ...(aliases.base ?? [])];
+        if (all.some((a) => a.toLowerCase() === h)) {
+            return type;
+        }
+    }
+    return null;
+}
+/**
+ * Parses a knowledge markdown document into individual entries: bullet lines
+ * and `### ` decision blocks, each tagged with its section and inferred type.
+ * Placeholder and comment lines are ignored.
+ */
+export function parseKnowledgeEntries(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const entries = [];
+    let currentSection = '';
+    let currentType = null;
+    let decisionBuffer = null;
+    const flushDecision = () => {
+        if (decisionBuffer) {
+            const text = decisionBuffer.join('\n').trim();
+            if (text)
+                entries.push({ section: currentSection, type: currentType, text });
+            decisionBuffer = null;
+        }
+    };
+    for (const line of lines) {
+        const h2 = line.match(/^##\s+(.*)$/);
+        if (h2) {
+            flushDecision();
+            currentSection = h2[1].trim();
+            currentType = sectionType(currentSection);
+            continue;
+        }
+        if (/^#\s+/.test(line)) {
+            flushDecision();
+            currentSection = '';
+            currentType = null;
+            continue;
+        }
+        if (line.startsWith('### ')) {
+            flushDecision();
+            decisionBuffer = [line];
+            continue;
+        }
+        if (decisionBuffer) {
+            decisionBuffer.push(line);
+            continue;
+        }
+        const t = line.trim();
+        if (t.startsWith('- ') && !isPlaceholder(line)) {
+            entries.push({ section: currentSection, type: currentType, text: t });
+        }
+    }
+    flushDecision();
+    return entries;
+}
+// ─── Adapter-routed I/O ─────────────────────────────────────────────────────
+async function resolveFeatureId(workspacePath) {
+    const feature = await loadFeatureConfig(workspacePath);
+    return feature?.id ?? path.basename(workspacePath);
+}
+function assertMessage(message) {
+    if (!message || !message.trim()) {
+        throw new Error('Knowledge entry message cannot be empty.');
+    }
+}
+/** Reads the workspace knowledge file, or `null` when it does not exist. */
+export async function readWorkspaceKnowledge(workspacePath) {
+    const featureId = await resolveFeatureId(workspacePath);
+    if (!(await workspaceFileExists(workspacePath, featureId, KNOWLEDGE_FILE))) {
+        return null;
+    }
+    return readWorkspaceFile(workspacePath, featureId, KNOWLEDGE_FILE);
+}
+/** Reads a repo's base knowledge file, or `null` when it does not exist. */
+export async function readBaseKnowledge(workspacePath, repoName) {
+    if (!(await baseFileExists(workspacePath, repoName, KNOWLEDGE_FILE))) {
+        return null;
+    }
+    return readBaseFile(workspacePath, repoName, KNOWLEDGE_FILE);
+}
+/** Appends a formatted entry to the workspace knowledge file (creating it if missing). */
+export async function addWorkspaceKnowledge(workspacePath, entry) {
+    assertMessage(entry.message);
+    const featureId = await resolveFeatureId(workspacePath);
+    const exists = await workspaceFileExists(workspacePath, featureId, KNOWLEDGE_FILE);
+    const content = exists
+        ? await readWorkspaceFile(workspacePath, featureId, KNOWLEDGE_FILE)
+        : `# Workspace Knowledge — ${featureId}\n`;
+    const aliases = SECTION_ALIASES[entry.type].workspace;
+    const updated = insertUnderHeading(content, aliases, formatEntry(entry, 'workspace'));
+    await writeWorkspaceFile(workspacePath, featureId, KNOWLEDGE_FILE, updated);
+    return {
+        location: resolveWorkspaceFileUrl(workspacePath, featureId, KNOWLEDGE_FILE),
+        section: aliases[0],
+        createdFile: !exists,
+    };
+}
+/**
+ * Inserts already-formatted markdown under a repo's base knowledge section for
+ * the given type (creating the file if missing).
+ */
+async function insertIntoBase(workspacePath, repoName, type, entryMarkdown) {
+    const aliases = SECTION_ALIASES[type].base;
+    if (!aliases) {
+        throw new Error(`'${type}' entries cannot be stored in base (repo) knowledge.`);
+    }
+    const exists = await baseFileExists(workspacePath, repoName, KNOWLEDGE_FILE);
+    const content = exists
+        ? await readBaseFile(workspacePath, repoName, KNOWLEDGE_FILE)
+        : buildBaseKnowledgeContent(repoName);
+    const updated = insertUnderHeading(content, aliases, entryMarkdown);
+    await writeBaseFile(workspacePath, repoName, KNOWLEDGE_FILE, updated);
+    return {
+        location: resolveBaseFileUrl(workspacePath, repoName, KNOWLEDGE_FILE),
+        section: aliases[0],
+        createdFile: !exists,
+    };
+}
+/** Appends a formatted entry to a repo's base knowledge file (creating it if missing). */
+export async function addBaseKnowledge(workspacePath, repoName, entry) {
+    assertMessage(entry.message);
+    return insertIntoBase(workspacePath, repoName, entry.type, formatEntry(entry, 'base'));
+}
+/**
+ * Promotes selected workspace learnings into a repo's persistent base
+ * knowledge so they survive across features. Entries whose type is not
+ * promotable (progress, question) are skipped. In `move` mode the source entry
+ * in the workspace file is replaced with an auditable "promoted" note.
+ */
+export async function promoteKnowledge(workspacePath, options) {
+    const { repoName, entries, mode = 'copy' } = options;
+    const promotable = entries.filter((e) => e.type && SECTION_ALIASES[e.type].base);
+    let baseLocation = resolveBaseFileUrl(workspacePath, repoName, KNOWLEDGE_FILE);
+    for (const e of promotable) {
+        // Preserve the entry's original markdown rather than reformatting it.
+        const res = await insertIntoBase(workspacePath, repoName, e.type, e.text);
+        baseLocation = res.location;
+    }
+    if (mode === 'move' && promotable.length > 0) {
+        const featureId = await resolveFeatureId(workspacePath);
+        if (await workspaceFileExists(workspacePath, featureId, KNOWLEDGE_FILE)) {
+            let content = await readWorkspaceFile(workspacePath, featureId, KNOWLEDGE_FILE);
+            const date = todayIso();
+            for (const e of promotable) {
+                content = content.replace(e.text, `- Promoted to ${repoName} base knowledge on ${date}.`);
+            }
+            await writeWorkspaceFile(workspacePath, featureId, KNOWLEDGE_FILE, content);
+        }
+    }
+    return { promotedCount: promotable.length, baseLocation };
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/core/knowledge.js.map

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

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

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

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

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

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":"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"}

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"}