maestro-flow 0.2.0 → 0.2.2

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/src/server/wiki/wiki-types.d.ts

@@ -0,0 +1,52 @@
+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 WikiEntry {
+    /** Inferred: `<type>-<slug>`. Stable across rebuilds. */
+    id: string;
+    type: WikiNodeType;
+    title: string;
+    summary: string;
+    tags: string[];
+    status: WikiStatus;
+    /** 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: WikiSource;
+    /** Markdown body (empty string for virtual entries). */
+    body: string;
+    /** Original JSONL row preserved for virtual entries. */
+    raw?: unknown;
+    /**
+     * Preserves non-standard frontmatter fields so existing specs keep their
+     * `category`, `readMode`, `priority`, `keywords` etc. intact.
+     */
+    ext: Record<string, unknown>;
+}
+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 WikiFilters {
+    type?: WikiNodeType;
+    tag?: string;
+    phase?: number;
+    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 {};

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

@@ -0,0 +1,242 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, mkdir, writeFile, readFile, rm, symlink, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { WikiIndexer } from './wiki-indexer.js';
+import { WikiWriter, WikiWriteError } from './writer.js';
+// ---------------------------------------------------------------------------
+// Stress tests for WikiWriter: concurrency, security (traversal, symlinks,
+// virtual entries), and edge cases the base unit test doesn't cover.
+// ---------------------------------------------------------------------------
+let tmpRoot;
+async function seed(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-writer-stress-'));
+});
+afterEach(async () => {
+    await rm(tmpRoot, { recursive: true, force: true });
+});
+describe('WikiWriter security — path traversal', () => {
+    it('rejects absolute path slug', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'spec', slug: '/etc/passwd', title: 'x', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('rejects dot-traversal slug', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'spec', slug: '..', title: 'x', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('rejects windows-style traversal slug', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({
+            type: 'spec',
+            slug: '..\\..\\windows\\system32',
+            title: 'x',
+            body: 'x',
+        })).rejects.toThrow(WikiWriteError);
+    });
+    it('rejects uppercase slug', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'spec', slug: 'UPPERCASE', title: 'x', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('rejects slug with spaces', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'spec', slug: 'has space', title: 'x', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('rejects empty title', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'spec', slug: 'ok', title: '   ', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('phase requires phaseRef', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({ type: 'phase', slug: 'ok', title: 'T', body: 'x' })).rejects.toThrow(WikiWriteError);
+    });
+    it('phase writes to phases/NN-slug/slug.md', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.create({
+            type: 'phase',
+            slug: 'setup',
+            phaseRef: 3,
+            title: 'Setup Phase',
+            body: '# Setup',
+        });
+        expect(entry.source.path).toBe('phases/03-setup/setup.md');
+    });
+    it('memory writes to memory/MEM-slug.md', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.create({
+            type: 'memory',
+            slug: 'auth-lessons',
+            title: 'Auth Lessons',
+            body: 'learned',
+        });
+        expect(entry.source.path).toBe('memory/MEM-auth-lessons.md');
+    });
+    it('note writes to memory/TIP-slug.md', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.create({
+            type: 'note',
+            slug: 'quick-tip',
+            title: 'Tip',
+            body: 'tip',
+        });
+        expect(entry.source.path).toBe('memory/TIP-quick-tip.md');
+    });
+});
+describe('WikiWriter security — symlink rejection', () => {
+    it('refuses to update a symlinked entry', async () => {
+        // Create a real file outside root, then symlink to it from specs/
+        const outside = join(tmpRoot, '..', `outside-${Date.now()}.md`);
+        await writeFile(outside, '---\ntitle: Outside\n---\n# outside', 'utf-8');
+        await mkdir(join(tmpRoot, 'specs'), { recursive: true });
+        const linkPath = join(tmpRoot, 'specs', 'linked.md');
+        try {
+            await symlink(outside, linkPath);
+        }
+        catch {
+            // Platforms/accounts without symlink permission skip this test
+            return;
+        }
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.update('spec-linked', { body: 'hijacked' })).rejects.toThrow(WikiWriteError);
+        // Ensure the outside file was NOT mutated
+        const raw = await readFile(outside, 'utf-8');
+        expect(raw).toContain('# outside');
+        await rm(outside, { force: true });
+        await rm(linkPath, { force: true });
+    });
+});
+describe('WikiWriter virtual entries — read-only', () => {
+    it('rejects update on virtual issue', async () => {
+        await mkdir(join(tmpRoot, 'issues'), { recursive: true });
+        await writeFile(join(tmpRoot, 'issues', 'current.jsonl'), JSON.stringify({ id: 'I1', title: 'Issue 1', status: 'open' }) + '\n', 'utf-8');
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const issue = index.entries.find((e) => e.type === 'issue');
+        expect(issue).toBeDefined();
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.update(issue.id, { body: 'x' })).rejects.toMatchObject({ code: 'FORBIDDEN' });
+    });
+    it('rejects remove on virtual lesson', async () => {
+        await mkdir(join(tmpRoot, 'learning'), { recursive: true });
+        await writeFile(join(tmpRoot, 'learning', 'lessons.jsonl'), JSON.stringify({ id: 'L1', title: 'Lesson 1', category: 'pattern' }) + '\n', 'utf-8');
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const index = await indexer.get();
+        const lesson = index.entries.find((e) => e.type === 'lesson');
+        if (!lesson)
+            return; // learning adapter may filter
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.remove(lesson.id)).rejects.toMatchObject({ code: 'FORBIDDEN' });
+    });
+});
+describe('WikiWriter concurrency', () => {
+    it('concurrent PUTs — one wins, others see CONFLICT with stale hash', async () => {
+        await seed('specs/s.md', `---\ntitle: Initial\n---\n# s\nv0`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        // Capture the initial hash
+        const raw = await readFile(join(tmpRoot, 'specs', 's.md'));
+        const initialHash = createHash('sha256').update(raw).digest('hex');
+        // Fire 5 concurrent PUTs all providing the SAME stale hash. Each update
+        // serializes through readFile → writeFile, but after the first success the
+        // hash on disk changes, so the remaining 4 must see CONFLICT.
+        const results = await Promise.allSettled(Array.from({ length: 5 }, (_, i) => writer.update('spec-s', {
+            body: `v${i + 1}`,
+            expectedHash: initialHash,
+        })));
+        const ok = results.filter((r) => r.status === 'fulfilled');
+        const conflicts = results.filter((r) => r.status === 'rejected' && r.reason.code === 'CONFLICT');
+        // Exactly one write must have observed the original hash and succeeded.
+        expect(ok.length).toBe(1);
+        expect(conflicts.length).toBe(4);
+    });
+    it('rapid create → update → delete round-trip keeps index consistent', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const created = await writer.create({
+            type: 'spec',
+            slug: 'rt',
+            title: 'Initial',
+            body: '# body',
+        });
+        expect(created.id).toBe('spec-rt');
+        const updated = await writer.update('spec-rt', {
+            title: 'Updated',
+            body: '# updated',
+        });
+        expect(updated.title).toBe('Updated');
+        await writer.remove('spec-rt');
+        const index = await indexer.get();
+        expect(index.byId['spec-rt']).toBeUndefined();
+        // File should be gone from disk too
+        await expect(stat(join(tmpRoot, 'specs', 'rt.md'))).rejects.toThrow();
+    });
+    it('create with frontmatter serializes arrays and strings correctly', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const entry = await writer.create({
+            type: 'spec',
+            slug: 'fm',
+            title: 'Frontmatter Test',
+            body: '# fm\nbody',
+            frontmatter: {
+                tags: ['alpha', 'beta'],
+                priority: 'high',
+            },
+        });
+        expect(entry.tags).toEqual(['alpha', 'beta']);
+        expect(entry.ext.priority).toBe('high');
+    });
+    it('update without body preserves existing body', async () => {
+        await seed('specs/s.md', `---\ntitle: Old\n---\n# Old\noriginal body`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        const updated = await writer.update('spec-s', { title: 'New Title' });
+        expect(updated.title).toBe('New Title');
+        expect(updated.body).toContain('original body');
+    });
+});
+describe('WikiWriter — invalid id validation', () => {
+    it('rejects update with slash in id', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.update('spec/evil', { body: 'x' })).rejects.toMatchObject({ code: 'BAD_REQUEST' });
+    });
+    it('rejects remove with backslash in id', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.remove('spec\\evil')).rejects.toMatchObject({ code: 'BAD_REQUEST' });
+    });
+    it('remove of non-existent id returns NOT_FOUND', async () => {
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.remove('spec-nope')).rejects.toMatchObject({ code: 'NOT_FOUND' });
+    });
+    it('create fails when target file already exists', async () => {
+        await seed('specs/dup.md', `---\ntitle: Existing\n---\n# dup`);
+        const indexer = new WikiIndexer({ workflowRoot: tmpRoot });
+        const writer = new WikiWriter(tmpRoot, indexer);
+        await expect(writer.create({
+            type: 'spec',
+            slug: 'dup',
+            title: 'New',
+            body: 'x',
+        })).rejects.toMatchObject({ code: 'CONFLICT' });
+    });
+});
+//# sourceMappingURL=writer-stress.test.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { WikiEntry } from './wiki-types.js';
+import type { WikiIndexer } from './wiki-indexer.js';
+export type WritableType = 'spec' | 'phase' | 'memory' | 'note';
+export interface CreateWikiReq {
+    type: WritableType;
+    slug: string;
+    phaseRef?: number;
+    title: string;
+    body: string;
+    frontmatter?: Record<string, unknown>;
+}
+export interface UpdateWikiReq {
+    title?: string;
+    body?: string;
+    frontmatter?: Record<string, unknown>;
+    /** sha256 of the previous file bytes for optimistic concurrency. */
+    expectedHash?: string;
+}
+export declare class WikiWriteError extends Error {
+    code: 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN';
+    details?: unknown | undefined;
+    constructor(code: 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN', message: string, details?: unknown | undefined);
+}
+/**
+ * WikiWriter — safe CRUD for real markdown wiki entries.
+ *
+ * Scope: only `spec | phase | memory | note` entries backed by real `.md`
+ * files. Virtual entries (issue/lesson), and the top-level `project.md` /
+ * `roadmap.md` narratives are rejected.
+ *
+ * All writes invalidate the indexer cache on success so the next read
+ * rebuilds. fs-watcher will fire its own `wiki:invalidated` event for the
+ * same change; the single-flight guard on `WikiIndexer.rebuild()` prevents
+ * duplicate work.
+ */
+export declare class WikiWriter {
+    private readonly workflowRoot;
+    private readonly indexer;
+    /** Per-path serializer: chains async writes so TOCTOU hash checks are safe. */
+    private readonly pathLocks;
+    constructor(workflowRoot: string, indexer: WikiIndexer);
+    /**
+     * Serialize async operations touching the same `key`. Each caller's fn runs
+     * after the previous one's promise settles, so read-modify-write sequences
+     * don't interleave for a single path.
+     */
+    private withLock;
+    create(req: CreateWikiReq): Promise<WikiEntry>;
+    update(id: string, req: UpdateWikiReq): Promise<WikiEntry>;
+    remove(id: string): Promise<void>;
+    private assertWritableType;
+    private resolveTargetPath;
+    private isInsideRoot;
+    private isWritablePath;
+}
+export declare function serializeFrontmatter(fm: Record<string, unknown>): string;
+export declare function splitFrontmatterAndBody(raw: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};