maestro-flow 0.2.0 → 0.2.1

package/dashboard/dist-server/{dashboard/src/server/docs/doc-scanner.js → src/server/wiki/wiki-indexer.js}

@@ -2,24 +2,32 @@ import { readFile, readdir, stat, lstat } from 'node:fs/promises';
 import { basename, dirname, extname, join, relative, resolve, sep } from 'node:path';
 import { toForwardSlash } from '../../shared/utils.js';
 import { parseFrontmatter } from './frontmatter-util.js';
-import { loadVirtualDocs } from './virtual-doc-adapters.js';
+import { loadVirtualEntries } from './virtual-wiki-adapters.js';
+import { buildGraph } from './graph-analysis.js';
+import { buildInvertedIndex, searchBM25 } from './search.js';
 /**
- * DocScanner: single source of truth for the unified document index.
+ * WikiIndexer: single source of truth for the unified wiki index.
  *
  * Responsibilities:
- *   1. Walk `.workflow/` for known doc sources.
+ *   1. Walk `.workflow/` for known wiki sources.
  *   2. Parse frontmatter + infer missing fields.
- *   3. Adapt JSONL rows as virtual docs.
+ *   3. Adapt JSONL rows as virtual entries.
  *   4. Build backlinks from `related: [[id]]` frontmatter.
- *   5. Cache result, rebuild on invalidate with single-flight guard.
+ *   5. Cache index + memoized graph + BM25 index.
+ *   6. Single-flight rebuild with invalidate().
  */
-export class DocScanner {
+export class WikiIndexer {
     workflowRoot;
     cache = null;
+    graphCache = null;
+    searchCache = null;
     inflight = null;
     constructor(config) {
         this.workflowRoot = resolve(config.workflowRoot);
     }
+    getWorkflowRoot() {
+        return this.workflowRoot;
+    }
     async get() {
         if (this.cache)
             return this.cache;
@@ -29,16 +37,16 @@ export class DocScanner {
         if (this.inflight)
             return this.inflight;
         this.inflight = (async () => {
-            const fileDocs = await this.scanFiles();
-            const virtualDocs = await this.scanVirtual();
-            const docs = [...fileDocs, ...virtualDocs];
+            const fileEntries = await this.scanFiles();
+            const virtualEntries = await this.scanVirtual();
+            const entries = [...fileEntries, ...virtualEntries];
             // Stable collision suffix
             const seen = new Map();
-            for (const d of docs) {
+            for (const d of entries) {
                 const n = seen.get(d.id) ?? 0;
                 if (n > 0) {
                     // eslint-disable-next-line no-console
-                    console.warn(`[doc-scanner] id collision '${d.id}' — suffixing`);
+                    console.warn(`[wiki-indexer] id collision '${d.id}' — suffixing`);
                     d.id = `${d.id}-${n + 1}`;
                 }
                 seen.set(d.id, n + 1);
@@ -54,19 +62,21 @@ export class DocScanner {
                 memory: [],
                 note: [],
             };
-            for (const d of docs) {
+            for (const d of entries) {
                 byId[d.id] = d;
                 byType[d.type].push(d);
             }
-            const backlinks = this.buildBacklinks(docs, byId);
+            const backlinks = this.buildBacklinks(entries, byId);
             const index = {
-                docs,
+                entries,
                 byId,
                 byType,
                 backlinks,
                 generatedAt: Date.now(),
             };
             this.cache = index;
+            this.graphCache = null;
+            this.searchCache = null;
             return index;
         })();
         try {
@@ -78,14 +88,28 @@ export class DocScanner {
     }
     invalidate(_changedAbsPath) {
         this.cache = null;
+        this.graphCache = null;
+        this.searchCache = null;
     }
     async query(filters) {
         const index = await this.get();
-        return filterDocs(index.docs, filters);
+        // Non-q filters first (cheap), then BM25 if q is present.
+        const base = filterEntries(index.entries, { ...filters, q: undefined });
+        if (!filters.q || !filters.q.trim())
+            return base;
+        const bm25 = await this.getSearchIndex();
+        const ranked = searchBM25(bm25, filters.q);
+        const allowed = new Set(base.map((d) => d.id));
+        const out = [];
+        for (const r of ranked) {
+            if (allowed.has(r.docId) && index.byId[r.docId]) {
+                out.push(index.byId[r.docId]);
+            }
+        }
+        return out;
     }
     async groups(filters) {
-        const index = await this.get();
-        const source = filters ? filterDocs(index.docs, filters) : index.docs;
+        const source = filters ? await this.query(filters) : (await this.get()).entries;
         const out = {
             project: [],
             roadmap: [],
@@ -100,6 +124,28 @@ export class DocScanner {
             out[d.type].push(d);
         return out;
     }
+    async getGraph() {
+        if (this.graphCache)
+            return this.graphCache;
+        const index = await this.get();
+        this.graphCache = buildGraph(index);
+        return this.graphCache;
+    }
+    async getSearchIndex() {
+        if (this.searchCache)
+            return this.searchCache;
+        const index = await this.get();
+        this.searchCache = buildInvertedIndex(index.entries);
+        return this.searchCache;
+    }
+    async search(query, limit = 50) {
+        const index = await this.get();
+        const bm25 = await this.getSearchIndex();
+        const ranked = searchBM25(bm25, query, limit);
+        return ranked
+            .map((r) => index.byId[r.docId])
+            .filter((d) => Boolean(d));
+    }
     // -------------------------------------------------------------------------
     // Walk
     // -------------------------------------------------------------------------
@@ -110,7 +156,7 @@ export class DocScanner {
             { rel: 'roadmap.md', type: 'roadmap' },
         ];
         for (const s of singletons) {
-            const entry = await this.parseDocFile(join(this.workflowRoot, s.rel), s.type);
+            const entry = await this.parseFileEntry(join(this.workflowRoot, s.rel), s.type);
             if (entry)
                 out.push(entry);
         }
@@ -118,7 +164,7 @@ export class DocScanner {
         for (const name of await safeReaddir(join(this.workflowRoot, 'specs'))) {
             if (extname(name).toLowerCase() !== '.md')
                 continue;
-            const entry = await this.parseDocFile(join(this.workflowRoot, 'specs', name), 'spec');
+            const entry = await this.parseFileEntry(join(this.workflowRoot, 'specs', name), 'spec');
             if (entry)
                 out.push(entry);
         }
@@ -140,7 +186,7 @@ export class DocScanner {
             for (const name of await safeReaddir(abs)) {
                 if (extname(name).toLowerCase() !== '.md')
                     continue;
-                const entry = await this.parseDocFile(join(abs, name), 'phase', { phaseRef });
+                const entry = await this.parseFileEntry(join(abs, name), 'phase', { phaseRef });
                 if (entry)
                     out.push(entry);
             }
@@ -151,7 +197,7 @@ export class DocScanner {
                 continue;
             const upper = name.toUpperCase();
             const type = upper.startsWith('TIP-') ? 'note' : 'memory';
-            const entry = await this.parseDocFile(join(this.workflowRoot, 'memory', name), type);
+            const entry = await this.parseFileEntry(join(this.workflowRoot, 'memory', name), type);
             if (entry)
                 out.push(entry);
         }
@@ -166,7 +212,7 @@ export class DocScanner {
             if (!this.isInsideRoot(abs))
                 continue;
             const rel = toForwardSlash(relative(this.workflowRoot, abs));
-            out.push(...(await loadVirtualDocs(abs, 'issue', rel)));
+            out.push(...(await loadVirtualEntries(abs, 'issue', rel)));
         }
         for (const name of await safeReaddir(join(this.workflowRoot, 'learning'))) {
             if (extname(name).toLowerCase() !== '.jsonl')
@@ -175,11 +221,11 @@ export class DocScanner {
             if (!this.isInsideRoot(abs))
                 continue;
             const rel = toForwardSlash(relative(this.workflowRoot, abs));
-            out.push(...(await loadVirtualDocs(abs, 'lesson', rel)));
+            out.push(...(await loadVirtualEntries(abs, 'lesson', rel)));
         }
         return out;
     }
-    async parseDocFile(absPath, type, opts = {}) {
+    async parseFileEntry(absPath, type, opts = {}) {
         if (!this.isInsideRoot(absPath))
             return null;
         try {
@@ -212,7 +258,15 @@ export class DocScanner {
         const phaseRef = opts.phaseRef ?? parsePhaseRef(basename(dirname(absPath)));
         const ext = extractExt(data);
         const rel = toForwardSlash(relative(this.workflowRoot, absPath));
-        const id = `${type}-${slugify(stem)}`;
+        // Memory/note files live under memory/ with MEM-<slug>.md or TIP-<slug>.md
+        // naming. Strip the prefix from the id-generating stem so the id matches
+        // what the WikiWriter produced at create time (`memory-<slug>`, `note-<slug>`).
+        let idStem = stem;
+        if (type === 'memory' && /^MEM-/i.test(stem))
+            idStem = stem.slice(4);
+        else if (type === 'note' && /^TIP-/i.test(stem))
+            idStem = stem.slice(4);
+        const id = `${type}-${slugify(idStem)}`;
         return {
             id,
             type,
@@ -229,10 +283,10 @@ export class DocScanner {
             ext,
         };
     }
-    buildBacklinks(docs, byId) {
+    buildBacklinks(entries, byId) {
         const bl = {};
         const titleIndex = new Map();
-        for (const d of docs)
+        for (const d of entries)
             titleIndex.set(d.title.toLowerCase(), d.id);
         const push = (target, source) => {
             const resolved = resolveLink(target, byId, titleIndex);
@@ -243,11 +297,11 @@ export class DocScanner {
             if (!bl[resolved].includes(source))
                 bl[resolved].push(source);
         };
-        const linkRe = /\[\[([^\]]+)\]\]/g;
-        for (const d of docs) {
+        for (const d of entries) {
             for (const rel of d.related)
                 push(rel, d.id);
             if (d.body) {
+                const linkRe = /\[\[([^\]]+)\]\]/g;
                 let m;
                 while ((m = linkRe.exec(d.body)))
                     push(m[1], d.id);
@@ -340,8 +394,8 @@ async function safeReaddir(dir) {
         return [];
     }
 }
-export function filterDocs(docs, filters) {
-    return docs.filter((d) => {
+export function filterEntries(entries, filters) {
+    return entries.filter((d) => {
         if (filters.type && d.type !== filters.type)
             return false;
         if (filters.tag && !d.tags.includes(filters.tag))
@@ -359,4 +413,4 @@ export function filterDocs(docs, filters) {
         return true;
     });
 }
-//# sourceMappingURL=doc-scanner.js.map
+//# sourceMappingURL=wiki-indexer.js.map

package/dashboard/dist-server/src/server/wiki/wiki-indexer.js.map

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

package/dashboard/dist-server/src/server/wiki/wiki-indexer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dashboard/dist-server/src/server/wiki/wiki-indexer.test.js

@@ -0,0 +1,173 @@
+import { mkdtemp, mkdir, writeFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { WikiIndexer } from './wiki-indexer.js';
+import { buildGraph, detectOrphans, detectHubs, computeHealth } from './graph-analysis.js';
+import { buildInvertedIndex, searchBM25, tokenize } from './search.js';
+import { WikiWriter, WikiWriteError } from './writer.js';
+let tmpRoot;
+async function write(rel, body) {
+    const abs = join(tmpRoot, rel);
+    await mkdir(join(abs, '..'), { recursive: true });
+    await writeFile(abs, body, 'utf-8');
+}
+beforeEach(async () => {
+    tmpRoot = await mkdtemp(join(tmpdir(), 'wiki-test-'));
+});
+afterEach(async () => {
+    await rm(tmpRoot, { recursive: true, force: true });
+});
+describe('WikiIndexer', () => {
+    it('indexes files across workflow subtrees', async () => {
+        await write('project.md', `---\ntitle: Project\n---\n# Project\nBody`);
+        await write('specs/one.md', `---\ntitle: Spec One\ntags:\n  - auth\n---\n# Spec One\nAbout [[spec-two]]`);
+        await write('specs/two.md', `---\ntitle: Spec Two\n---\n# Spec Two\nRefs [[spec-one]]`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const ids = index.entries.map((d) => d.id).sort();
+        expect(ids).toContain('spec-one');
+        expect(ids).toContain('spec-two');
+        expect(index.byId['spec-one'].tags).toEqual(['auth']);
+        expect(index.backlinks['spec-one']).toContain('spec-two');
+        expect(index.backlinks['spec-two']).toContain('spec-one');
+    });
+    it('filters by type and tag', async () => {
+        await write('specs/a.md', `---\ntitle: A\ntags:\n  - x\n---\n# A`);
+        await write('specs/b.md', `---\ntitle: B\ntags:\n  - y\n---\n# B`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const xTagged = await indexer.query({ type: 'spec', tag: 'x' });
+        expect(xTagged.map((d) => d.id)).toEqual(['spec-a']);
+    });
+});
+describe('graph-analysis', () => {
+    it('detects orphans as entries with no in and no out edges', async () => {
+        await write('specs/a.md', `---\ntitle: A\n---\n# A\nLinks [[b]]`);
+        await write('specs/b.md', `---\ntitle: B\n---\n# B`);
+        await write('specs/c.md', `---\ntitle: C\n---\n# C`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const graph = buildGraph(index);
+        const orphans = detectOrphans(graph, index.entries);
+        expect(orphans).toContain('spec-c');
+        expect(orphans).not.toContain('spec-a');
+        expect(orphans).not.toContain('spec-b');
+    });
+    it('reports broken links', async () => {
+        await write('specs/a.md', `---\ntitle: A\n---\n# A\n[[does-not-exist]]`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const graph = buildGraph(index);
+        expect(graph.brokenLinks).toEqual(expect.arrayContaining([{ sourceId: 'spec-a', target: 'does-not-exist' }]));
+    });
+    it('ranks hubs by incoming link count', async () => {
+        await write('specs/hub.md', `---\ntitle: Hub\n---\n# Hub`);
+        await write('specs/a.md', `---\ntitle: A\n---\n# A\n[[hub]]`);
+        await write('specs/b.md', `---\ntitle: B\n---\n# B\n[[hub]]`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const graph = buildGraph(index);
+        const hubs = detectHubs(graph, 5);
+        expect(hubs[0]).toEqual({ id: 'spec-hub', inDegree: 2 });
+    });
+    it('computes health score with penalties', async () => {
+        await write('specs/a.md', `---\ntitle: A\n---\n# A\n[[missing]]`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const graph = buildGraph(index);
+        const health = computeHealth(index, graph);
+        expect(health.score).toBeLessThan(100);
+        expect(health.totals.brokenLinks).toBe(1);
+    });
+});
+describe('search (BM25)', () => {
+    it('tokenizes lowercase and drops stop words', () => {
+        expect(tokenize('The Quick Brown Fox')).toEqual(['quick', 'brown', 'fox']);
+    });
+    it('ranks exact title match first', async () => {
+        await write('specs/auth.md', `---\ntitle: Authentication Guide\n---\n# Auth\nJWT bearer tokens`);
+        await write('specs/misc.md', `---\ntitle: Misc\n---\n# Misc\nNothing about auth here`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const inv = buildInvertedIndex(index.entries);
+        const results = searchBM25(inv, 'authentication');
+        expect(results[0].docId).toBe('spec-auth');
+    });
+    it('returns empty for stop-word-only query', async () => {
+        await write('specs/a.md', `---\ntitle: A\n---\n# A`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const inv = buildInvertedIndex(index.entries);
+        expect(searchBM25(inv, 'the and or')).toEqual([]);
+    });
+});
+describe('WikiWriter', () => {
+    it('creates a new spec markdown file', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.create({
+            type: 'spec',
+            slug: 'new-spec',
+            title: 'Fresh Spec',
+            body: '# Fresh Spec\nHello',
+        });
+        expect(entry.id).toBe('spec-new-spec');
+        expect(entry.source.path).toBe('specs/new-spec.md');
+    });
+    it('rejects slug with traversal attempts', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({
+            type: 'spec',
+            slug: '../../../etc/hosts',
+            title: 'evil',
+            body: 'x',
+        })).rejects.toThrow(WikiWriteError);
+    });
+    it('returns 409 on stale expectedHash', async () => {
+        await write('specs/s.md', `---\ntitle: S\n---\n# S\norig`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        try {
+            await writer.update('spec-s', {
+                body: 'updated',
+                expectedHash: 'deadbeef',
+            });
+            expect.fail('expected CONFLICT');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(WikiWriteError);
+            expect(err.code).toBe('CONFLICT');
+        }
+    });
+    it('updates existing spec preserving frontmatter', async () => {
+        await write('specs/s.md', `---\ntitle: Old\ntags:\n  - a\n---\n# Old\nbody`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.update('spec-s', {
+            title: 'New',
+            body: 'new body',
+        });
+        expect(entry.title).toBe('New');
+        expect(entry.tags).toEqual(['a']);
+    });
+    it('removes an existing spec file', async () => {
+        await write('specs/gone.md', `---\ntitle: Gone\n---\n# Gone`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await writer.remove('spec-gone');
+        const index = await indexer.get();
+        expect(index.byId['spec-gone']).toBeUndefined();
+    });
+    it('rejects writes on virtual entries', async () => {
+        await mkdir(join(tmpRoot, 'issues'), { recursive: true });
+        await writeFile(join(tmpRoot, 'issues', 'current.jsonl'), JSON.stringify({ id: 'I1', title: 'Test Issue', status: 'open' }) + '\n', 'utf-8');
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const virtualId = index.entries.find((d) => d.source.kind === 'virtual')?.id;
+        expect(virtualId).toBeDefined();
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.update(virtualId, { body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+});
+//# sourceMappingURL=wiki-indexer.test.js.map

package/dashboard/dist-server/src/server/wiki/wiki-indexer.test.js.map

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

package/dashboard/dist-server/{dashboard/src/server/docs/doc-types.d.ts → src/server/wiki/wiki-types.d.ts}

@@ -1,20 +1,20 @@
-export type DocType = 'project' | 'roadmap' | 'spec' | 'phase' | 'issue' | 'lesson' | 'memory' | 'note';
-export type DocStatus = 'draft' | 'active' | 'completed' | 'blocked' | 'archived';
-export interface DocSource {
+export type WikiNodeType = 'project' | 'roadmap' | 'spec' | 'phase' | 'issue' | 'lesson' | 'memory' | 'note';
+export type WikiStatus = 'draft' | 'active' | 'completed' | 'blocked' | 'archived';
+export interface WikiSource {
     kind: 'file' | 'virtual';
     /** Forward-slash relative path from .workflow/ root. */
     path: string;
     /** 1-based line number for virtual JSONL rows. */
     line?: number;
 }
-export interface DocEntry {
+export interface WikiEntry {
     /** Inferred: `<type>-<slug>`. Stable across rebuilds. */
     id: string;
-    type: DocType;
+    type: WikiNodeType;
     title: string;
     summary: string;
     tags: string[];
-    status: DocStatus;
+    status: WikiStatus;
     /** ISO string from fs.stat.birthtimeMs (or JSONL created_at). */
     created: string;
     /** ISO string from fs.stat.mtimeMs (or JSONL updated_at). */
@@ -23,10 +23,10 @@ export interface DocEntry {
     phaseRef: number | null;
     /** Normalized wikilink ids declared via frontmatter `related`. */
     related: string[];
-    source: DocSource;
-    /** Markdown body (empty string for virtual docs). */
+    source: WikiSource;
+    /** Markdown body (empty string for virtual entries). */
     body: string;
-    /** Original JSONL row preserved for virtual docs. */
+    /** Original JSONL row preserved for virtual entries. */
     raw?: unknown;
     /**
      * Preserves non-standard frontmatter fields so existing specs keep their
@@ -34,19 +34,19 @@ export interface DocEntry {
      */
     ext: Record<string, unknown>;
 }
-export interface DocIndex {
-    docs: DocEntry[];
-    byId: Record<string, DocEntry>;
-    byType: Record<DocType, DocEntry[]>;
-    /** Map of target doc id -> source doc ids that link to it. */
+export interface WikiIndex {
+    entries: WikiEntry[];
+    byId: Record<string, WikiEntry>;
+    byType: Record<WikiNodeType, WikiEntry[]>;
+    /** Map of target entry id -> source entry ids that link to it. */
     backlinks: Record<string, string[]>;
     generatedAt: number;
 }
-export interface DocFilters {
-    type?: DocType;
+export interface WikiFilters {
+    type?: WikiNodeType;
     tag?: string;
     phase?: number;
-    status?: DocStatus;
-    /** Case-insensitive full-text match against title + summary. */
+    status?: WikiStatus;
+    /** BM25 query string — tokenized against title + summary + tags + body. */
     q?: string;
 }

package/dashboard/dist-server/src/server/wiki/wiki-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wiki-types.js.map

package/dashboard/dist-server/src/server/wiki/wiki-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-types.js","sourceRoot":"","sources":["../../../../src/server/wiki/wiki-types.ts"],"names":[],"mappings":""}

package/dashboard/dist-server/src/server/wiki/writer-stress.test.d.ts

@@ -0,0 +1 @@
+export {};