maestro-flow 0.1.3 → 0.2.0

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.js

@@ -0,0 +1,362 @@
+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';
+/**
+ * DocScanner: single source of truth for the unified document index.
+ *
+ * Responsibilities:
+ *   1. Walk `.workflow/` for known doc sources.
+ *   2. Parse frontmatter + infer missing fields.
+ *   3. Adapt JSONL rows as virtual docs.
+ *   4. Build backlinks from `related: [[id]]` frontmatter.
+ *   5. Cache result, rebuild on invalidate with single-flight guard.
+ */
+export class DocScanner {
+    workflowRoot;
+    cache = null;
+    inflight = null;
+    constructor(config) {
+        this.workflowRoot = resolve(config.workflowRoot);
+    }
+    async get() {
+        if (this.cache)
+            return this.cache;
+        return this.rebuild();
+    }
+    async rebuild() {
+        if (this.inflight)
+            return this.inflight;
+        this.inflight = (async () => {
+            const fileDocs = await this.scanFiles();
+            const virtualDocs = await this.scanVirtual();
+            const docs = [...fileDocs, ...virtualDocs];
+            // Stable collision suffix
+            const seen = new Map();
+            for (const d of docs) {
+                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`);
+                    d.id = `${d.id}-${n + 1}`;
+                }
+                seen.set(d.id, n + 1);
+            }
+            const byId = {};
+            const byType = {
+                project: [],
+                roadmap: [],
+                spec: [],
+                phase: [],
+                issue: [],
+                lesson: [],
+                memory: [],
+                note: [],
+            };
+            for (const d of docs) {
+                byId[d.id] = d;
+                byType[d.type].push(d);
+            }
+            const backlinks = this.buildBacklinks(docs, byId);
+            const index = {
+                docs,
+                byId,
+                byType,
+                backlinks,
+                generatedAt: Date.now(),
+            };
+            this.cache = index;
+            return index;
+        })();
+        try {
+            return await this.inflight;
+        }
+        finally {
+            this.inflight = null;
+        }
+    }
+    invalidate(_changedAbsPath) {
+        this.cache = null;
+    }
+    async query(filters) {
+        const index = await this.get();
+        return filterDocs(index.docs, filters);
+    }
+    async groups(filters) {
+        const index = await this.get();
+        const source = filters ? filterDocs(index.docs, filters) : index.docs;
+        const out = {
+            project: [],
+            roadmap: [],
+            spec: [],
+            phase: [],
+            issue: [],
+            lesson: [],
+            memory: [],
+            note: [],
+        };
+        for (const d of source)
+            out[d.type].push(d);
+        return out;
+    }
+    // -------------------------------------------------------------------------
+    // Walk
+    // -------------------------------------------------------------------------
+    async scanFiles() {
+        const out = [];
+        const singletons = [
+            { rel: 'project.md', type: 'project' },
+            { rel: 'roadmap.md', type: 'roadmap' },
+        ];
+        for (const s of singletons) {
+            const entry = await this.parseDocFile(join(this.workflowRoot, s.rel), s.type);
+            if (entry)
+                out.push(entry);
+        }
+        // specs/*.md
+        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');
+            if (entry)
+                out.push(entry);
+        }
+        // phases/NN-slug/*.md
+        const phasesRoot = join(this.workflowRoot, 'phases');
+        for (const phaseDir of await safeReaddir(phasesRoot)) {
+            const abs = join(phasesRoot, phaseDir);
+            let isDir = false;
+            try {
+                const s = await stat(abs);
+                isDir = s.isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (!isDir)
+                continue;
+            const phaseRef = parsePhaseRef(phaseDir);
+            for (const name of await safeReaddir(abs)) {
+                if (extname(name).toLowerCase() !== '.md')
+                    continue;
+                const entry = await this.parseDocFile(join(abs, name), 'phase', { phaseRef });
+                if (entry)
+                    out.push(entry);
+            }
+        }
+        // memory/*.md  (MEM-* → memory, TIP-* → note, others → memory)
+        for (const name of await safeReaddir(join(this.workflowRoot, 'memory'))) {
+            if (extname(name).toLowerCase() !== '.md')
+                continue;
+            const upper = name.toUpperCase();
+            const type = upper.startsWith('TIP-') ? 'note' : 'memory';
+            const entry = await this.parseDocFile(join(this.workflowRoot, 'memory', name), type);
+            if (entry)
+                out.push(entry);
+        }
+        return out;
+    }
+    async scanVirtual() {
+        const out = [];
+        for (const name of await safeReaddir(join(this.workflowRoot, 'issues'))) {
+            if (extname(name).toLowerCase() !== '.jsonl')
+                continue;
+            const abs = join(this.workflowRoot, 'issues', name);
+            if (!this.isInsideRoot(abs))
+                continue;
+            const rel = toForwardSlash(relative(this.workflowRoot, abs));
+            out.push(...(await loadVirtualDocs(abs, 'issue', rel)));
+        }
+        for (const name of await safeReaddir(join(this.workflowRoot, 'learning'))) {
+            if (extname(name).toLowerCase() !== '.jsonl')
+                continue;
+            const abs = join(this.workflowRoot, 'learning', name);
+            if (!this.isInsideRoot(abs))
+                continue;
+            const rel = toForwardSlash(relative(this.workflowRoot, abs));
+            out.push(...(await loadVirtualDocs(abs, 'lesson', rel)));
+        }
+        return out;
+    }
+    async parseDocFile(absPath, type, opts = {}) {
+        if (!this.isInsideRoot(absPath))
+            return null;
+        try {
+            const ls = await lstat(absPath);
+            if (ls.isSymbolicLink())
+                return null;
+            if (!ls.isFile())
+                return null;
+        }
+        catch {
+            return null;
+        }
+        let raw;
+        let stats;
+        try {
+            raw = await readFile(absPath, 'utf-8');
+            stats = await stat(absPath);
+        }
+        catch {
+            return null;
+        }
+        const { data, content } = parseFrontmatter(raw);
+        const fileName = basename(absPath);
+        const stem = basename(fileName, extname(fileName));
+        const title = asString(data.title) || firstHeading(content) || stem;
+        const summary = asString(data.summary) || firstParagraph(content);
+        const tags = extractTags(data);
+        const status = asStatus(data.status) ?? inferStatus(type);
+        const related = normalizeRelated(data.related);
+        const phaseRef = opts.phaseRef ?? parsePhaseRef(basename(dirname(absPath)));
+        const ext = extractExt(data);
+        const rel = toForwardSlash(relative(this.workflowRoot, absPath));
+        const id = `${type}-${slugify(stem)}`;
+        return {
+            id,
+            type,
+            title,
+            summary,
+            tags,
+            status,
+            created: new Date(stats.birthtimeMs || stats.mtimeMs).toISOString(),
+            updated: new Date(stats.mtimeMs).toISOString(),
+            phaseRef: phaseRef ?? null,
+            related,
+            source: { kind: 'file', path: rel },
+            body: content,
+            ext,
+        };
+    }
+    buildBacklinks(docs, byId) {
+        const bl = {};
+        const titleIndex = new Map();
+        for (const d of docs)
+            titleIndex.set(d.title.toLowerCase(), d.id);
+        const push = (target, source) => {
+            const resolved = resolveLink(target, byId, titleIndex);
+            if (!resolved)
+                return;
+            if (!bl[resolved])
+                bl[resolved] = [];
+            if (!bl[resolved].includes(source))
+                bl[resolved].push(source);
+        };
+        const linkRe = /\[\[([^\]]+)\]\]/g;
+        for (const d of docs) {
+            for (const rel of d.related)
+                push(rel, d.id);
+            if (d.body) {
+                let m;
+                while ((m = linkRe.exec(d.body)))
+                    push(m[1], d.id);
+            }
+        }
+        return bl;
+    }
+    isInsideRoot(absPath) {
+        const requested = resolve(absPath);
+        return requested === this.workflowRoot || requested.startsWith(this.workflowRoot + sep);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function asStatus(value) {
+    const allowed = ['draft', 'active', 'completed', 'blocked', 'archived'];
+    return typeof value === 'string' && allowed.includes(value)
+        ? value
+        : null;
+}
+function inferStatus(type) {
+    if (type === 'spec' || type === 'project' || type === 'roadmap')
+        return 'active';
+    return 'draft';
+}
+function firstHeading(body) {
+    const m = body.match(/^#\s+(.+)$/m);
+    return m ? m[1].trim() : '';
+}
+function firstParagraph(body) {
+    const withoutFm = body.replace(/^#\s+.+\n+/, '');
+    const para = withoutFm.split(/\n\s*\n/).find((p) => p.trim().length > 0) ?? '';
+    return para.trim().replace(/\s+/g, ' ').slice(0, 240);
+}
+function extractTags(data) {
+    const tags = data.tags ?? data.keywords;
+    if (!Array.isArray(tags))
+        return [];
+    return tags.map(String).filter((s) => s.length > 0);
+}
+function normalizeRelated(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const v of value) {
+        if (typeof v !== 'string')
+            continue;
+        // Block-array parser keeps surrounding quotes; strip them so
+        // `"[[id]]"` and `[[id]]` both resolve.
+        const unquoted = v.replace(/^["']|["']$/g, '');
+        const m = unquoted.match(/^\[\[([^\]]+)\]\]$/);
+        out.push(m ? m[1] : unquoted);
+    }
+    return out;
+}
+function extractExt(data) {
+    const known = new Set(['title', 'summary', 'tags', 'status', 'related']);
+    const out = {};
+    for (const [k, v] of Object.entries(data)) {
+        if (!known.has(k))
+            out[k] = v;
+    }
+    return out;
+}
+function parsePhaseRef(dirName) {
+    const m = dirName.match(/^(\d+)-/);
+    return m ? Number(m[1]) : null;
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function resolveLink(target, byId, titleIndex) {
+    if (byId[target])
+        return target;
+    const hit = titleIndex.get(target.toLowerCase());
+    return hit ?? null;
+}
+async function safeReaddir(dir) {
+    try {
+        return await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+}
+export function filterDocs(docs, filters) {
+    return docs.filter((d) => {
+        if (filters.type && d.type !== filters.type)
+            return false;
+        if (filters.tag && !d.tags.includes(filters.tag))
+            return false;
+        if (filters.phase !== undefined && d.phaseRef !== filters.phase)
+            return false;
+        if (filters.status && d.status !== filters.status)
+            return false;
+        if (filters.q) {
+            const q = filters.q.toLowerCase();
+            if (!d.title.toLowerCase().includes(q) && !d.summary.toLowerCase().includes(q)) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=doc-scanner.js.map

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.js.map

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

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.test.d.ts

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

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.test.js

@@ -0,0 +1,184 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { writeFile, mkdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { DocScanner, filterDocs } from './doc-scanner.js';
+import { adaptIssueRow, adaptLessonRow } from './virtual-doc-adapters.js';
+// ---------------------------------------------------------------------------
+// L2 Integration: DocScanner against a real .workflow/ tree in tmpdir
+// ---------------------------------------------------------------------------
+let root;
+beforeEach(async () => {
+    root = join(tmpdir(), `docs-scan-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`);
+    await mkdir(root, { recursive: true });
+});
+afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+});
+async function seed(rel, body) {
+    const abs = join(root, rel);
+    await mkdir(join(abs, '..'), { recursive: true });
+    await writeFile(abs, body, 'utf-8');
+}
+// ---------------------------------------------------------------------------
+describe('DocScanner — file sources', () => {
+    it('infers title from first heading when frontmatter omits it', async () => {
+        await seed('project.md', '# Maestro Core\n\nFirst paragraph describing the project.\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        const doc = index.byId['project-project'];
+        expect(doc).toBeDefined();
+        expect(doc.title).toBe('Maestro Core');
+        expect(doc.summary).toContain('First paragraph');
+        expect(doc.type).toBe('project');
+    });
+    it('preserves existing spec frontmatter in ext and maps keywords→tags', async () => {
+        const specBody = `---
+title: "Architecture Constraints"
+readMode: required
+priority: high
+category: planning
+keywords:
+  - architecture
+  - module
+---
+
+# Architecture Constraints
+Content.
+`;
+        await seed('specs/architecture-constraints.md', specBody);
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        const doc = index.byId['spec-architecture-constraints'];
+        expect(doc).toBeDefined();
+        expect(doc.title).toBe('Architecture Constraints');
+        expect(doc.tags).toEqual(['architecture', 'module']);
+        expect(doc.ext.readMode).toBe('required');
+        expect(doc.ext.priority).toBe('high');
+        expect(doc.ext.category).toBe('planning');
+        expect(doc.ext.keywords).toEqual(['architecture', 'module']);
+    });
+    it('parses phase docs and sets phaseRef from directory name', async () => {
+        await seed('phases/01-auth/plan.md', '---\ntitle: "Auth Plan"\n---\n# Auth Plan\nTODO.\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        const phases = index.byType.phase;
+        expect(phases.length).toBe(1);
+        expect(phases[0].phaseRef).toBe(1);
+        expect(phases[0].title).toBe('Auth Plan');
+    });
+    it('distinguishes memory vs note by MEM-/TIP- prefix', async () => {
+        await seed('memory/MEM-20260411.md', '# Session snapshot\nfoo');
+        await seed('memory/TIP-shortcut.md', '# Quick tip\nbar');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        expect(index.byType.memory.length).toBe(1);
+        expect(index.byType.note.length).toBe(1);
+    });
+    it('tolerates missing memory/phases/specs directories', async () => {
+        await seed('project.md', '# Alone\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        expect(index.docs.length).toBeGreaterThanOrEqual(1);
+    });
+});
+describe('DocScanner — virtual JSONL docs', () => {
+    it('adapts issues.jsonl rows into virtual issue docs', async () => {
+        const row = {
+            id: 'ISS-abc',
+            title: 'Test',
+            description: 'Broken thing',
+            type: 'bug',
+            priority: 'high',
+            status: 'resolved',
+            created_at: '2026-03-17T14:32:23.030Z',
+            updated_at: '2026-03-17T14:37:10.399Z',
+        };
+        await seed('issues/issues.jsonl', JSON.stringify(row) + '\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        const doc = index.byId['issue-ISS-abc'];
+        expect(doc).toBeDefined();
+        expect(doc.type).toBe('issue');
+        expect(doc.source.kind).toBe('virtual');
+        expect(doc.tags).toContain('bug');
+        expect(doc.status).toBe('completed');
+    });
+    it('adapts patterns.jsonl rows into virtual lesson docs', async () => {
+        const row = {
+            command: 'claude-code',
+            frequency: 3,
+            successRate: 0.66,
+            avgDuration: 12000,
+            lastUsed: '2026-03-28T13:26:24.190Z',
+            contexts: [],
+        };
+        await seed('learning/patterns.jsonl', JSON.stringify(row) + '\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        const lessons = index.byType.lesson;
+        expect(lessons.length).toBe(1);
+        expect(lessons[0].title).toBe('Pattern: claude-code');
+        expect(lessons[0].summary).toMatch(/Used 3× • 66% success/);
+    });
+    it('skips malformed JSON lines without throwing', async () => {
+        await seed('issues/issues.jsonl', 'not json\n{"id":"ISS-ok","title":"ok"}\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        expect(index.byType.issue.length).toBe(1);
+    });
+});
+describe('DocScanner — backlinks', () => {
+    it('resolves related [[id]] to build reverse index', async () => {
+        await seed('specs/arch.md', '---\ntitle: "Arch"\n---\n# Arch\nbody');
+        await seed('specs/impl.md', '---\ntitle: "Impl"\nrelated:\n  - "[[spec-arch]]"\n---\n# Impl\nbody');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        expect(index.backlinks['spec-arch']).toContain('spec-impl');
+    });
+    it('resolves inline [[wikilink]] in body text', async () => {
+        await seed('specs/arch.md', '---\ntitle: "Arch"\n---\n# Arch\nbody');
+        await seed('specs/impl.md', '---\ntitle: "Impl"\n---\n# Impl\nSee also [[spec-arch]] for details.');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const index = await scanner.get();
+        expect(index.backlinks['spec-arch']).toContain('spec-impl');
+    });
+});
+describe('DocScanner — filters + cache', () => {
+    it('filters by type, tag, phase, status, and q', async () => {
+        await seed('specs/auth.md', '---\ntitle: "Auth"\ntags: [auth]\n---\n# Auth\nLogin flow stuff');
+        await seed('specs/db.md', '---\ntitle: "Database"\ntags: [db]\n---\n# Database\nPostgres');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const all = (await scanner.get()).docs;
+        expect(filterDocs(all, { tag: 'auth' }).length).toBe(1);
+        expect(filterDocs(all, { type: 'spec' }).length).toBe(2);
+        expect(filterDocs(all, { q: 'postgres' }).length).toBe(1);
+    });
+    it('invalidate() forces rebuild on next get()', async () => {
+        await seed('project.md', '# v1\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const first = await scanner.get();
+        await seed('project.md', '# v2 updated\n');
+        scanner.invalidate();
+        const second = await scanner.get();
+        expect(second.generatedAt).toBeGreaterThanOrEqual(first.generatedAt);
+        expect(second.byId['project-project'].title).toBe('v2 updated');
+    });
+    it('returns stable DocIndex from cache when not invalidated', async () => {
+        await seed('project.md', '# same\n');
+        const scanner = new DocScanner({ workflowRoot: root });
+        const a = await scanner.get();
+        const b = await scanner.get();
+        expect(a).toBe(b);
+    });
+});
+describe('virtual adapters — purity', () => {
+    it('adaptIssueRow returns null for non-object input', () => {
+        expect(adaptIssueRow(null, 'x', 1)).toBeNull();
+        expect(adaptIssueRow('string', 'x', 1)).toBeNull();
+    });
+    it('adaptLessonRow returns null when command missing', () => {
+        expect(adaptLessonRow({ frequency: 1 }, 'x', 1)).toBeNull();
+    });
+});
+//# sourceMappingURL=doc-scanner.test.js.map

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.test.js.map

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

package/dashboard/dist-server/dashboard/src/server/docs/doc-types.d.ts

@@ -0,0 +1,52 @@
+export type DocType = 'project' | 'roadmap' | 'spec' | 'phase' | 'issue' | 'lesson' | 'memory' | 'note';
+export type DocStatus = 'draft' | 'active' | 'completed' | 'blocked' | 'archived';
+export interface DocSource {
+    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 {
+    /** Inferred: `<type>-<slug>`. Stable across rebuilds. */
+    id: string;
+    type: DocType;
+    title: string;
+    summary: string;
+    tags: string[];
+    status: DocStatus;
+    /** ISO string from fs.stat.birthtimeMs (or JSONL created_at). */
+    created: string;
+    /** ISO string from fs.stat.mtimeMs (or JSONL updated_at). */
+    updated: string;
+    /** Parsed from `phases/(\d+)-` directory pattern. */
+    phaseRef: number | null;
+    /** Normalized wikilink ids declared via frontmatter `related`. */
+    related: string[];
+    source: DocSource;
+    /** Markdown body (empty string for virtual docs). */
+    body: string;
+    /** Original JSONL row preserved for virtual docs. */
+    raw?: unknown;
+    /**
+     * Preserves non-standard frontmatter fields so existing specs keep their
+     * `category`, `readMode`, `priority`, `keywords` etc. intact.
+     */
+    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. */
+    backlinks: Record<string, string[]>;
+    generatedAt: number;
+}
+export interface DocFilters {
+    type?: DocType;
+    tag?: string;
+    phase?: number;
+    status?: DocStatus;
+    /** Case-insensitive full-text match against title + summary. */
+    q?: string;
+}

package/dashboard/dist-server/dashboard/src/server/docs/doc-types.js

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

package/dashboard/dist-server/dashboard/src/server/docs/doc-types.js.map

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

package/dashboard/dist-server/dashboard/src/server/docs/frontmatter-util.d.ts

@@ -0,0 +1,5 @@
+export interface ParsedFrontmatter {
+    data: Record<string, unknown>;
+    content: string;
+}
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter;