maestro-flow 0.1.4 → 0.2.0

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

@@ -0,0 +1,245 @@
+import { describe, it, expect } from 'vitest';
+import { buildInvertedIndex, searchBM25, tokenize } from './search.js';
+import { buildGraph, detectOrphans, detectHubs, computeHealth } from './graph-analysis.js';
+// ---------------------------------------------------------------------------
+// Stress tests for BM25 search and graph analysis at scale.
+// No file I/O — these exercise the pure functions with synthetic corpora.
+// ---------------------------------------------------------------------------
+function makeEntry(id, title, body, related = [], tags = []) {
+    return {
+        id,
+        type: 'spec',
+        title,
+        summary: '',
+        tags,
+        status: 'active',
+        created: '',
+        updated: '',
+        phaseRef: null,
+        related,
+        source: { kind: 'file', path: `specs/${id}.md` },
+        body,
+        ext: {},
+    };
+}
+function makeIndex(entries) {
+    const byId = {};
+    const byType = {
+        project: [],
+        roadmap: [],
+        spec: [],
+        phase: [],
+        issue: [],
+        lesson: [],
+        memory: [],
+        note: [],
+    };
+    const backlinks = {};
+    for (const e of entries) {
+        byId[e.id] = e;
+        byType[e.type].push(e);
+    }
+    // compute naive backlinks mirror of what WikiIndexer would produce
+    for (const e of entries) {
+        const linkRe = /\[\[([^\]]+)\]\]/g;
+        let m;
+        while ((m = linkRe.exec(e.body))) {
+            const target = m[1];
+            if (byId[target]) {
+                if (!backlinks[target])
+                    backlinks[target] = [];
+                if (!backlinks[target].includes(e.id))
+                    backlinks[target].push(e.id);
+            }
+        }
+        for (const rel of e.related) {
+            if (byId[rel]) {
+                if (!backlinks[rel])
+                    backlinks[rel] = [];
+                if (!backlinks[rel].includes(e.id))
+                    backlinks[rel].push(e.id);
+            }
+        }
+    }
+    return { entries, byId, byType, backlinks, generatedAt: Date.now() };
+}
+// ---------------------------------------------------------------------------
+// BM25 stress
+// ---------------------------------------------------------------------------
+describe('BM25 stress — 2000-doc corpus', () => {
+    const VOCAB = [
+        'authentication', 'session', 'token', 'cookie', 'database', 'cache',
+        'redis', 'postgres', 'migration', 'schema', 'index', 'query', 'plan',
+        'performance', 'latency', 'memory', 'cpu', 'network', 'io', 'disk',
+        'http', 'grpc', 'websocket', 'api', 'route', 'middleware', 'guard',
+        'validation', 'serializer', 'parser', 'tokenizer', 'lexer', 'compiler',
+        'interpreter', 'runtime', 'gc', 'heap', 'stack', 'thread', 'process',
+    ];
+    function synthBody(seed) {
+        const parts = [];
+        for (let i = 0; i < 60; i++) {
+            parts.push(VOCAB[(seed * 31 + i * 7) % VOCAB.length]);
+        }
+        return parts.join(' ');
+    }
+    function synthTitle(seed) {
+        const a = VOCAB[seed % VOCAB.length];
+        const b = VOCAB[(seed * 3 + 1) % VOCAB.length];
+        return `${a} ${b}`;
+    }
+    const corpus = [];
+    for (let i = 0; i < 2000; i++) {
+        corpus.push(makeEntry(`spec-${i}`, synthTitle(i), synthBody(i)));
+    }
+    // Inject a canonical "authentication tutorial" entry that should win q=authentication
+    corpus.push(makeEntry('spec-canonical-auth', 'Authentication Tutorial', 'Full guide to authentication with sessions, tokens, cookies and bearer flows.', [], ['security']));
+    it('builds inverted index in under 200ms', () => {
+        const t0 = Date.now();
+        const inv = buildInvertedIndex(corpus);
+        const ms = Date.now() - t0;
+        expect(inv.totalDocs).toBe(2001);
+        expect(inv.postings.size).toBeGreaterThan(0);
+        expect(ms).toBeLessThan(500); // generous upper bound for CI
+    });
+    it('single-term query over 2000 docs returns results in <50ms', () => {
+        const inv = buildInvertedIndex(corpus);
+        const t0 = Date.now();
+        const results = searchBM25(inv, 'authentication', 20);
+        const ms = Date.now() - t0;
+        expect(results.length).toBeGreaterThan(0);
+        expect(ms).toBeLessThan(100);
+    });
+    it('canonical title-match entry ranks in top-3 for q=authentication', () => {
+        const inv = buildInvertedIndex(corpus);
+        const results = searchBM25(inv, 'authentication tutorial', 10);
+        const top = results.slice(0, 3).map((r) => r.docId);
+        expect(top).toContain('spec-canonical-auth');
+    });
+    it('multi-term query rewards docs with more matching terms', () => {
+        const inv = buildInvertedIndex(corpus);
+        const results = searchBM25(inv, 'authentication session token', 10);
+        expect(results.length).toBeGreaterThan(0);
+        // Scores should be monotonically decreasing
+        for (let i = 1; i < results.length; i++) {
+            expect(results[i - 1].score).toBeGreaterThanOrEqual(results[i].score);
+        }
+    });
+    it('stop-word-only query returns empty', () => {
+        const inv = buildInvertedIndex(corpus);
+        expect(searchBM25(inv, 'the and or a an')).toEqual([]);
+    });
+    it('unknown-term query returns empty', () => {
+        const inv = buildInvertedIndex(corpus);
+        expect(searchBM25(inv, 'zzzxxxyyyqqq')).toEqual([]);
+    });
+    it('score stability — same corpus twice yields identical top-10', () => {
+        const inv1 = buildInvertedIndex(corpus);
+        const inv2 = buildInvertedIndex(corpus);
+        const r1 = searchBM25(inv1, 'session token', 10);
+        const r2 = searchBM25(inv2, 'session token', 10);
+        expect(r1.map((r) => r.docId)).toEqual(r2.map((r) => r.docId));
+        expect(r1.map((r) => r.score)).toEqual(r2.map((r) => r.score));
+    });
+    it('tokenize handles Unicode letters and numbers', () => {
+        expect(tokenize('Hello Wörld 123 foo42bar')).toEqual([
+            'hello',
+            'wörld',
+            '123',
+            'foo42bar',
+        ]);
+    });
+    it('tokenize drops stop words and sub-2-char tokens', () => {
+        expect(tokenize('a The an Quick I am')).toEqual(['quick', 'am']);
+    });
+});
+// ---------------------------------------------------------------------------
+// Graph stress
+// ---------------------------------------------------------------------------
+describe('graph-analysis stress — dense 500-doc graph', () => {
+    // Build a ring + hub topology: every node links to the next, and everyone
+    // links to spec-hub. Expect spec-hub to dominate inDegree.
+    const N = 500;
+    const entries = [];
+    entries.push(makeEntry('spec-hub', 'Central Hub', 'Nothing outgoing.'));
+    for (let i = 0; i < N; i++) {
+        const next = `spec-${(i + 1) % N}`;
+        entries.push(makeEntry(`spec-${i}`, `Node ${i}`, `Links [[${next}]] and [[spec-hub]] and [[spec-missing-${i}]].`));
+    }
+    const index = makeIndex(entries);
+    it('builds graph in <100ms', () => {
+        const t0 = Date.now();
+        const g = buildGraph(index);
+        const ms = Date.now() - t0;
+        expect(g.forwardLinks['spec-0']).toContain('spec-hub');
+        expect(ms).toBeLessThan(200);
+    });
+    it('hub dominates inDegree ranking', () => {
+        const g = buildGraph(index);
+        const hubs = detectHubs(g, 5);
+        expect(hubs[0].id).toBe('spec-hub');
+        expect(hubs[0].inDegree).toBe(N);
+    });
+    it('reports N broken links (one per node)', () => {
+        const g = buildGraph(index);
+        expect(g.brokenLinks.length).toBe(N);
+        // every broken link target begins with `spec-missing-`
+        for (const b of g.brokenLinks) {
+            expect(b.target.startsWith('spec-missing-')).toBe(true);
+        }
+    });
+    it('detects no orphans in a fully-connected ring', () => {
+        const g = buildGraph(index);
+        const orphans = detectOrphans(g, index.entries);
+        // spec-hub has incoming but no outgoing → not orphan (incoming > 0)
+        // every ring node has both → not orphan
+        expect(orphans).toEqual([]);
+    });
+    it('health score floored at 0 when broken links exceed 50', () => {
+        const g = buildGraph(index);
+        const health = computeHealth(index, g);
+        // 500 broken * 2 = 1000 penalty → score = max(0, 100 - 1000) = 0
+        expect(health.score).toBe(0);
+        expect(health.totals.brokenLinks).toBe(N);
+        expect(health.totals.entries).toBe(N + 1);
+    });
+});
+describe('graph-analysis stress — disconnected islands', () => {
+    // Two disjoint cliques, plus 20 isolated orphans.
+    const entries = [];
+    // Clique A: 5 nodes, fully connected
+    for (let i = 0; i < 5; i++) {
+        const links = Array.from({ length: 5 }, (_, j) => j)
+            .filter((j) => j !== i)
+            .map((j) => `[[spec-a${j}]]`)
+            .join(' ');
+        entries.push(makeEntry(`spec-a${i}`, `A${i}`, links));
+    }
+    // Clique B: 5 nodes, fully connected
+    for (let i = 0; i < 5; i++) {
+        const links = Array.from({ length: 5 }, (_, j) => j)
+            .filter((j) => j !== i)
+            .map((j) => `[[spec-b${j}]]`)
+            .join(' ');
+        entries.push(makeEntry(`spec-b${i}`, `B${i}`, links));
+    }
+    // 20 orphans
+    for (let i = 0; i < 20; i++) {
+        entries.push(makeEntry(`spec-orph${i}`, `Orph${i}`, 'body with no links'));
+    }
+    const index = makeIndex(entries);
+    it('detects all 20 orphans exactly', () => {
+        const g = buildGraph(index);
+        const orphans = detectOrphans(g, index.entries);
+        expect(orphans.length).toBe(20);
+        for (const id of orphans) {
+            expect(id.startsWith('spec-orph')).toBe(true);
+        }
+    });
+    it('cliques have equal inDegree = 4', () => {
+        const g = buildGraph(index);
+        const hubs = detectHubs(g, 10);
+        const cliqueNodes = hubs.filter((h) => h.inDegree === 4);
+        expect(cliqueNodes.length).toBe(10); // 5 + 5 clique members
+    });
+});
+//# sourceMappingURL=stress.test.js.map

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

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

package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.d.ts

@@ -0,0 +1,4 @@
+import type { WikiEntry } from './wiki-types.js';
+export declare function adaptIssueRow(row: unknown, sourcePath: string, line: number): WikiEntry | null;
+export declare function adaptLessonRow(row: unknown, sourcePath: string, line: number): WikiEntry | null;
+export declare function loadVirtualEntries(absPath: string, kind: 'issue' | 'lesson', relPath: string): Promise<WikiEntry[]>;

package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.js

@@ -0,0 +1,153 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Virtual wiki adapters: read-only reflections of JSONL rows as WikiEntries.
+ * Never mutate the source files. Return null on schema violation (logged once
+ * per process) so a malformed row cannot break the whole scan.
+ */
+const warnOnce = new Set();
+function warn(key, message) {
+    if (warnOnce.has(key))
+        return;
+    warnOnce.add(key);
+    // eslint-disable-next-line no-console
+    console.warn(`[wiki-indexer] ${message}`);
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function toIso(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return new Date(value).toISOString();
+    }
+    return new Date(0).toISOString();
+}
+function mapIssueStatus(raw) {
+    switch (raw) {
+        case 'resolved':
+        case 'closed':
+            return 'completed';
+        case 'deferred':
+            return 'archived';
+        case 'in_progress':
+            return 'active';
+        default:
+            return 'draft';
+    }
+}
+export function adaptIssueRow(row, sourcePath, line) {
+    if (!row || typeof row !== 'object')
+        return null;
+    const r = row;
+    const id = asString(r.id);
+    if (!id) {
+        warn(`issue-no-id:${sourcePath}`, `issue row at ${sourcePath}:${line} missing id`);
+        return null;
+    }
+    const title = asString(r.title) || `Issue ${id}`;
+    const description = asString(r.description);
+    const issueType = asString(r.type);
+    const priority = asString(r.priority);
+    const tags = [];
+    if (issueType)
+        tags.push(issueType);
+    if (priority)
+        tags.push(priority);
+    return {
+        id: `issue-${id}`,
+        type: 'issue',
+        title,
+        summary: description.slice(0, 240),
+        tags,
+        status: mapIssueStatus(r.status),
+        created: toIso(r.created_at),
+        updated: toIso(r.updated_at),
+        phaseRef: null,
+        related: [],
+        source: { kind: 'virtual', path: sourcePath, line },
+        body: '',
+        raw: row,
+        ext: {
+            issueType,
+            priority,
+            rawStatus: r.status,
+            execution: r.execution,
+        },
+    };
+}
+export function adaptLessonRow(row, sourcePath, line) {
+    if (!row || typeof row !== 'object')
+        return null;
+    const r = row;
+    // patterns.jsonl shape: { command, frequency, successRate, avgDuration, lastUsed, contexts[] }
+    const command = asString(r.command);
+    if (!command) {
+        warn(`lesson-no-command:${sourcePath}`, `lesson row at ${sourcePath}:${line} missing command`);
+        return null;
+    }
+    const frequency = typeof r.frequency === 'number' ? r.frequency : 0;
+    const successRate = typeof r.successRate === 'number' ? r.successRate : 0;
+    const avgDuration = typeof r.avgDuration === 'number' ? r.avgDuration : 0;
+    const contexts = Array.isArray(r.contexts) ? r.contexts.map(String) : [];
+    const successPct = Math.round(successRate * 100);
+    const durationSec = Math.round(avgDuration / 1000);
+    const title = `Pattern: ${command}`;
+    const summary = `Used ${frequency}× • ${successPct}% success • ~${durationSec}s avg` +
+        (contexts.length ? ` • ${contexts.length} context(s)` : '');
+    const slug = command.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-|-$/g, '');
+    const lastUsed = toIso(r.lastUsed);
+    return {
+        id: `lesson-${slug || `row${line}`}`,
+        type: 'lesson',
+        title,
+        summary,
+        tags: ['pattern', command],
+        status: 'active',
+        created: lastUsed,
+        updated: lastUsed,
+        phaseRef: null,
+        related: [],
+        source: { kind: 'virtual', path: sourcePath, line },
+        body: '',
+        raw: row,
+        ext: {
+            command,
+            frequency,
+            successRate,
+            avgDuration,
+            contexts,
+        },
+    };
+}
+export async function loadVirtualEntries(absPath, kind, relPath) {
+    let raw;
+    try {
+        raw = await readFile(absPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const lines = raw.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            warn(`bad-json:${absPath}:${i + 1}`, `invalid JSON at ${absPath}:${i + 1}`);
+            continue;
+        }
+        const entry = kind === 'issue'
+            ? adaptIssueRow(parsed, relPath, i + 1)
+            : adaptLessonRow(parsed, relPath, i + 1);
+        if (entry)
+            out.push(entry);
+    }
+    return out;
+}
+//# sourceMappingURL=virtual-wiki-adapters.js.map

package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.js.map

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

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

@@ -0,0 +1,40 @@
+import type { WikiEntry, WikiFilters, WikiIndex, WikiNodeType } from './wiki-types.js';
+import { type WikiGraph } from './graph-analysis.js';
+import { type InvertedIndex } from './search.js';
+export interface WikiIndexerConfig {
+    workflowRoot: string;
+}
+/**
+ * WikiIndexer: single source of truth for the unified wiki index.
+ *
+ * Responsibilities:
+ *   1. Walk `.workflow/` for known wiki sources.
+ *   2. Parse frontmatter + infer missing fields.
+ *   3. Adapt JSONL rows as virtual entries.
+ *   4. Build backlinks from `related: [[id]]` frontmatter.
+ *   5. Cache index + memoized graph + BM25 index.
+ *   6. Single-flight rebuild with invalidate().
+ */
+export declare class WikiIndexer {
+    private readonly workflowRoot;
+    private cache;
+    private graphCache;
+    private searchCache;
+    private inflight;
+    constructor(config: WikiIndexerConfig);
+    getWorkflowRoot(): string;
+    get(): Promise<WikiIndex>;
+    rebuild(): Promise<WikiIndex>;
+    invalidate(_changedAbsPath?: string): void;
+    query(filters: WikiFilters): Promise<WikiEntry[]>;
+    groups(filters?: WikiFilters): Promise<Record<WikiNodeType, WikiEntry[]>>;
+    getGraph(): Promise<WikiGraph>;
+    getSearchIndex(): Promise<InvertedIndex>;
+    search(query: string, limit?: number): Promise<WikiEntry[]>;
+    private scanFiles;
+    private scanVirtual;
+    private parseFileEntry;
+    private buildBacklinks;
+    isInsideRoot(absPath: string): boolean;
+}
+export declare function filterEntries(entries: WikiEntry[], filters: WikiFilters): WikiEntry[];