@reqlan/analytical 0.6.3 → 0.8.1

package/out/export/write-csv-export.js

@@ -0,0 +1,132 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { formatAttributeValue } from './html-export-utils.js';
+/** Write CSV export(s): ideas.csv with flattened tags/attributes, plus references.csv. */
+export async function writeCsvExport(snapshot, request, onProgress) {
+    const outputDir = join(request.outputDir, request.exportName);
+    await mkdir(outputDir, { recursive: true });
+    const ideasPath = join(outputDir, 'ideas.csv');
+    const referencesPath = join(outputDir, 'references.csv');
+    const total = 2;
+    let completed = 0;
+    onProgress?.({
+        phase: 'write',
+        message: 'Writing ideas.csv…',
+        completed,
+        total,
+    });
+    await writeFile(ideasPath, renderIdeasCsv(snapshot), 'utf8');
+    completed += 1;
+    onProgress?.({
+        phase: 'write',
+        message: 'Writing references.csv…',
+        completed,
+        total,
+    });
+    await writeFile(referencesPath, renderReferencesCsv(snapshot), 'utf8');
+    completed += 1;
+    onProgress?.({
+        phase: 'write',
+        message: `Wrote ${total} CSV files`,
+        completed,
+        total,
+    });
+    return {
+        outputDir,
+        indexFilePath: ideasPath,
+        printFilePath: ideasPath,
+        dataFilePath: referencesPath,
+    };
+}
+function renderIdeasCsv(snapshot) {
+    const attributeKeys = collectAttributeKeys(snapshot.ideas);
+    const headers = [
+        'id',
+        'name',
+        'kind',
+        'fileUri',
+        'lineStart',
+        'status',
+        'tags',
+        'summary',
+        ...attributeKeys.map(key => `attr:${key}`),
+    ];
+    const rows = snapshot.ideas.map(idea => {
+        const cells = [
+            idea.id,
+            idea.name,
+            idea.kind,
+            idea.fileUri,
+            String(idea.lineStart),
+            idea.status ?? '',
+            idea.tags.join(';'),
+            idea.summary,
+            ...attributeKeys.map(key => {
+                if (!(key in idea.attributes)) {
+                    return '';
+                }
+                return formatAttributeValue(idea.attributes[key]);
+            }),
+        ];
+        return cells.map(csvEscape).join(',');
+    });
+    return `${headers.map(csvEscape).join(',')}\n${rows.join('\n')}${rows.length > 0 ? '\n' : ''}`;
+}
+function renderReferencesCsv(snapshot) {
+    const headers = [
+        'sourceIdeaId',
+        'sourceName',
+        'direction',
+        'kind',
+        'label',
+        'targetIdeaId',
+        'targetName',
+        'targetPath',
+        'isResolved',
+        'snippet',
+    ];
+    const rows = [];
+    for (const idea of snapshot.ideas) {
+        for (const group of [
+            { direction: 'outbound', rows: idea.references.outbound },
+            { direction: 'inbound', rows: idea.references.inbound },
+            { direction: 'unresolved', rows: idea.references.unresolved },
+        ]) {
+            for (const row of group.rows) {
+                rows.push([
+                    idea.id,
+                    idea.name,
+                    group.direction,
+                    row.kind,
+                    row.label,
+                    row.targetIdeaId ?? '',
+                    row.targetName,
+                    row.targetPath,
+                    row.isResolved ? 'true' : 'false',
+                    row.snippet ?? '',
+                ].map(csvEscape).join(','));
+            }
+        }
+    }
+    return `${headers.map(csvEscape).join(',')}\n${rows.join('\n')}${rows.length > 0 ? '\n' : ''}`;
+}
+function collectAttributeKeys(ideas) {
+    const keys = new Set();
+    for (const idea of ideas) {
+        for (const key of Object.keys(idea.attributes)) {
+            if (key === 'status' || key === 'tags') {
+                continue;
+            }
+            keys.add(key);
+        }
+    }
+    return [...keys].sort((a, b) => a.localeCompare(b));
+}
+/** RFC 4180-ish CSV cell escaping. */
+export function csvEscape(value) {
+    if (/[",\n\r]/.test(value)) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=write-csv-export.js.map

package/out/export/write-csv-export.js.map

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

package/out/export/write-html-export.d.ts

@@ -1,2 +1,2 @@
-import type { ExportRequest, ExportResult, ExportSnapshot } from './types.js';
-export declare function writeHtmlExport(snapshot: ExportSnapshot, request: ExportRequest): Promise<ExportResult>;
+import type { ExportProgressCallback, ExportRequest, ExportResult, ExportSnapshot } from './types.js';
+export declare function writeHtmlExport(snapshot: ExportSnapshot, request: ExportRequest, onProgress?: ExportProgressCallback): Promise<ExportResult>;

package/out/export/write-html-export.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { APP_JS, SHARED_STYLES, buildSearchIndexScript } from './html-export-assets.js';
 import { renderAttributeDetailPage, renderClusterDetailPage, renderClustersIndexPage, renderCodeFileDetailPage, renderCodeFilesIndexPage, renderFileDetailPage, renderFilesIndexPage, renderGraphPage, renderHomePage, renderIdeaDetailPage, renderIdeasIndexPage, renderAttributesIndexPage, renderPrintClusterPage, renderPrintCodeFilePage, renderPrintFilePage, renderPrintHomePage, renderPrintIdeaPage } from './html-export-template.js';
 import { stringifyJson } from './html-export-utils.js';
-export async function writeHtmlExport(snapshot, request) {
+export async function writeHtmlExport(snapshot, request, onProgress) {
     const outputDir = join(request.outputDir, request.exportName);
     const assetsDir = join(outputDir, 'assets');
     const dataDir = join(outputDir, 'data');
@@ -37,13 +37,13 @@ export async function writeHtmlExport(snapshot, request) {
         mkdir(join(outputDir, 'print/clusters'), { recursive: true })
     ]);
     const writes = [
-        writeFile(join(assetsDir, 'styles.css'), SHARED_STYLES, 'utf8'),
-        writeFile(join(assetsDir, 'app.js'), APP_JS, 'utf8'),
-        writeFile(join(assetsDir, 'search-index.js'), buildSearchIndexScript(snapshot.searchDocuments), 'utf8'),
-        writeFile(dataFilePath, stringifyJson(snapshot), 'utf8'),
-        writeFile(join(dataDir, 'graph.json'), stringifyJson(snapshot.graphs.workspace), 'utf8'),
-        writeFile(join(dataDir, 'search.json'), stringifyJson(snapshot.searchDocuments), 'utf8'),
-        writeFile(manifestFilePath, stringifyJson({
+        () => writeFile(join(assetsDir, 'styles.css'), SHARED_STYLES, 'utf8'),
+        () => writeFile(join(assetsDir, 'app.js'), APP_JS, 'utf8'),
+        () => writeFile(join(assetsDir, 'search-index.js'), buildSearchIndexScript(snapshot.searchDocuments), 'utf8'),
+        () => writeFile(dataFilePath, stringifyJson(snapshot), 'utf8'),
+        () => writeFile(join(dataDir, 'graph.json'), stringifyJson(snapshot.graphs.workspace), 'utf8'),
+        () => writeFile(join(dataDir, 'search.json'), stringifyJson(snapshot.searchDocuments), 'utf8'),
+        () => writeFile(manifestFilePath, stringifyJson({
             ...snapshot.manifest,
             pageOptions: snapshot.pageOptions,
             runtimeMode: snapshot.runtimeMode,
@@ -51,79 +51,89 @@ export async function writeHtmlExport(snapshot, request) {
         }), 'utf8')
     ];
     const isPrintMode = snapshot.runtimeMode === 'print';
-    writes.push(writeFile(indexFilePath, isPrintMode ? renderPrintHomePage(snapshot) : renderHomePage(snapshot), 'utf8'));
+    writes.push(() => writeFile(indexFilePath, isPrintMode ? renderPrintHomePage(snapshot) : renderHomePage(snapshot), 'utf8'));
     if (snapshot.pageOptions.includePrintPages) {
-        writes.push(writeFile(printFilePath, renderPrintHomePage(snapshot), 'utf8'));
+        writes.push(() => writeFile(printFilePath, renderPrintHomePage(snapshot), 'utf8'));
     }
     if (!isPrintMode && requirementsFilePath) {
-        writes.push(writeFile(requirementsFilePath, renderIdeasIndexPage(snapshot), 'utf8'));
+        writes.push(() => writeFile(requirementsFilePath, renderIdeasIndexPage(snapshot), 'utf8'));
     }
     if (!isPrintMode && graphFilePath && snapshot.pageOptions.includeGraphPage) {
-        writes.push(writeFile(graphFilePath, renderGraphPage(snapshot), 'utf8'));
+        writes.push(() => writeFile(graphFilePath, renderGraphPage(snapshot), 'utf8'));
     }
     if (!isPrintMode) {
-        writes.push(writeFile(ideasIndexFilePath, renderIdeasIndexPage(snapshot), 'utf8'));
+        writes.push(() => writeFile(ideasIndexFilePath, renderIdeasIndexPage(snapshot), 'utf8'));
         if (snapshot.pageOptions.includeFilePages) {
-            writes.push(writeFile(filesIndexFilePath, renderFilesIndexPage(snapshot), 'utf8'));
+            writes.push(() => writeFile(filesIndexFilePath, renderFilesIndexPage(snapshot), 'utf8'));
         }
         if (snapshot.pageOptions.includeCodeFilePages) {
-            writes.push(writeFile(codeFilesIndexFilePath, renderCodeFilesIndexPage(snapshot), 'utf8'));
+            writes.push(() => writeFile(codeFilesIndexFilePath, renderCodeFilesIndexPage(snapshot), 'utf8'));
         }
         if (snapshot.pageOptions.includeClusterPages) {
-            writes.push(writeFile(clustersIndexFilePath, renderClustersIndexPage(snapshot), 'utf8'));
+            writes.push(() => writeFile(clustersIndexFilePath, renderClustersIndexPage(snapshot), 'utf8'));
         }
-        writes.push(writeFile(attributesIndexFilePath, renderAttributesIndexPage(snapshot), 'utf8'));
+        writes.push(() => writeFile(attributesIndexFilePath, renderAttributesIndexPage(snapshot), 'utf8'));
     }
     if (!isPrintMode && snapshot.pageOptions.includeIdeaPages) {
         for (const idea of snapshot.ideas) {
-            writes.push(writeFile(join(outputDir, idea.page.path), renderIdeaDetailPage(snapshot, idea), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, idea.page.path), renderIdeaDetailPage(snapshot, idea), 'utf8'));
         }
     }
     if (snapshot.pageOptions.includePrintPages) {
         for (const idea of snapshot.ideas) {
-            if (idea.page.printablePath) {
-                writes.push(writeFile(join(outputDir, idea.page.printablePath), renderPrintIdeaPage(snapshot, idea), 'utf8'));
+            const printablePath = idea.page.printablePath;
+            if (printablePath) {
+                writes.push(() => writeFile(join(outputDir, printablePath), renderPrintIdeaPage(snapshot, idea), 'utf8'));
             }
         }
     }
     if (!isPrintMode && snapshot.pageOptions.includeFilePages) {
         for (const file of snapshot.files) {
-            writes.push(writeFile(join(outputDir, file.page.path), renderFileDetailPage(snapshot, file), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, file.page.path), renderFileDetailPage(snapshot, file), 'utf8'));
         }
     }
     if (snapshot.pageOptions.includePrintPages) {
         for (const file of snapshot.files) {
-            writes.push(writeFile(join(outputDir, file.printPage.path), renderPrintFilePage(snapshot, file), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, file.printPage.path), renderPrintFilePage(snapshot, file), 'utf8'));
         }
     }
     if (!isPrintMode && snapshot.pageOptions.includeCodeFilePages) {
         for (const file of snapshot.codeFiles) {
-            writes.push(writeFile(join(outputDir, file.page.path), renderCodeFileDetailPage(snapshot, file), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, file.page.path), renderCodeFileDetailPage(snapshot, file), 'utf8'));
         }
     }
     if (snapshot.pageOptions.includePrintPages && snapshot.pageOptions.includeCodeFilePages) {
         for (const file of snapshot.codeFiles) {
-            writes.push(writeFile(join(outputDir, file.printPage.path), renderPrintCodeFilePage(snapshot, file), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, file.printPage.path), renderPrintCodeFilePage(snapshot, file), 'utf8'));
         }
     }
     if (!isPrintMode && snapshot.pageOptions.includeClusterPages) {
         for (const cluster of snapshot.clusters) {
-            writes.push(writeFile(join(outputDir, cluster.page.path), renderClusterDetailPage(snapshot, cluster), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, cluster.page.path), renderClusterDetailPage(snapshot, cluster), 'utf8'));
         }
     }
     if (snapshot.pageOptions.includePrintPages && snapshot.pageOptions.includeClusterPages) {
         for (const cluster of snapshot.clusters) {
-            if (cluster.page.printablePath) {
-                writes.push(writeFile(join(outputDir, cluster.page.printablePath), renderPrintClusterPage(snapshot, cluster), 'utf8'));
+            const printablePath = cluster.page.printablePath;
+            if (printablePath) {
+                writes.push(() => writeFile(join(outputDir, printablePath), renderPrintClusterPage(snapshot, cluster), 'utf8'));
             }
         }
     }
     if (!isPrintMode && snapshot.pageOptions.includeAttributePages) {
         for (const attribute of snapshot.attributes) {
-            writes.push(writeFile(join(outputDir, attribute.page.path), renderAttributeDetailPage(snapshot, attribute), 'utf8'));
+            writes.push(() => writeFile(join(outputDir, attribute.page.path), renderAttributeDetailPage(snapshot, attribute), 'utf8'));
         }
     }
-    await Promise.all(writes);
+    const total = writes.length;
+    const report = createWriteProgressReporter(onProgress, total);
+    report(0);
+    let completed = 0;
+    await Promise.all(writes.map(async (write) => {
+        await write();
+        completed += 1;
+        report(completed);
+    }));
     return {
         outputDir,
         indexFilePath,
@@ -139,6 +149,28 @@ export async function writeHtmlExport(snapshot, request) {
         manifestFilePath
     };
 }
+function createWriteProgressReporter(onProgress, total) {
+    if (!onProgress) {
+        return () => undefined;
+    }
+    let lastReported = -1;
+    const step = Math.max(1, Math.floor(total / 40));
+    return (completed) => {
+        const isBoundary = completed === 0 || completed === total || completed - lastReported >= step;
+        if (!isBoundary) {
+            return;
+        }
+        lastReported = completed;
+        onProgress({
+            phase: 'write',
+            message: completed === 0
+                ? `Writing ${total} files…`
+                : `Writing files (${completed}/${total})…`,
+            completed,
+            total,
+        });
+    };
+}
 function ensureHtmlFileName(value) {
     const trimmed = value.trim();
     if (trimmed.toLowerCase().endsWith('.html')) {

package/out/export/write-html-export.js.map

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

package/out/export/write-json-export.d.ts

@@ -0,0 +1,3 @@
+import type { ExportProgressCallback, ExportRequest, ExportResult, ExportSnapshot } from './types.js';
+/** Write a structured JSON export for tooling and AI consumption. */
+export declare function writeJsonExport(snapshot: ExportSnapshot, request: ExportRequest, onProgress?: ExportProgressCallback): Promise<ExportResult>;

package/out/export/write-json-export.js

@@ -0,0 +1,92 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Write a structured JSON export for tooling and AI consumption. */
+export async function writeJsonExport(snapshot, request, onProgress) {
+    const outputDir = join(request.outputDir, request.exportName);
+    await mkdir(outputDir, { recursive: true });
+    const indexFilePath = join(outputDir, 'export.json');
+    onProgress?.({
+        phase: 'write',
+        message: 'Writing export.json…',
+        completed: 0,
+        total: 1,
+    });
+    const payload = {
+        format: 'json',
+        title: snapshot.title,
+        generatedAt: snapshot.generatedAt,
+        workspaceRoot: snapshot.workspaceRoot,
+        scope: snapshot.scope,
+        sourceFileUri: snapshot.sourceFileUri,
+        counts: snapshot.counts,
+        byStatus: snapshot.byStatus,
+        byTag: snapshot.byTag,
+        ideas: snapshot.ideas.map(idea => ({
+            id: idea.id,
+            name: idea.name,
+            kind: idea.kind,
+            fileUri: idea.fileUri,
+            lineStart: idea.lineStart,
+            summary: idea.summary,
+            status: idea.status,
+            tags: idea.tags,
+            attributes: idea.attributes,
+            references: {
+                inbound: idea.references.inbound.map(compactRef),
+                outbound: idea.references.outbound.map(compactRef),
+                unresolved: idea.references.unresolved.map(compactRef),
+            },
+            clusterIds: idea.clusterIds,
+        })),
+        files: snapshot.files.map(file => ({
+            fileUri: file.fileUri,
+            ideaIds: file.ideas.map(idea => idea.id),
+            ideaCount: file.ideas.length,
+            statuses: file.statuses,
+            tags: file.tags,
+        })),
+        clusters: snapshot.clusters.map(cluster => ({
+            id: cluster.id,
+            kind: cluster.kind,
+            label: cluster.label,
+            description: cluster.description,
+            ideaIds: cluster.ideaIds,
+            counts: cluster.counts,
+        })),
+        attributes: snapshot.attributes.map(attribute => ({
+            key: attribute.key,
+            ideaCount: attribute.ideaCount,
+            values: attribute.values.map(value => ({
+                value: value.value,
+                count: value.count,
+                ideaIds: value.ideaIds,
+            })),
+        })),
+    };
+    await writeFile(indexFilePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+    onProgress?.({
+        phase: 'write',
+        message: 'Wrote export.json',
+        completed: 1,
+        total: 1,
+    });
+    return {
+        outputDir,
+        indexFilePath,
+        printFilePath: indexFilePath,
+        dataFilePath: indexFilePath,
+    };
+}
+function compactRef(row) {
+    return {
+        kind: row.kind,
+        label: row.label,
+        targetName: row.targetName,
+        targetPath: row.targetPath,
+        targetIdeaId: row.targetIdeaId,
+        sourceIdeaId: row.sourceIdeaId,
+        isResolved: row.isResolved,
+        snippet: row.snippet,
+    };
+}
+//# sourceMappingURL=write-json-export.js.map

package/out/export/write-json-export.js.map

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

package/out/export/write-markdown-export.d.ts

@@ -0,0 +1,5 @@
+import type { ExportProgressCallback, ExportRequest, ExportResult, ExportSnapshot } from './types.js';
+/** Build markdown paths from HTML-oriented snapshot page paths. */
+export declare function toMarkdownPath(htmlPath: string): string;
+/** Write a multi-file markdown export from an export snapshot. */
+export declare function writeMarkdownExport(snapshot: ExportSnapshot, request: ExportRequest, onProgress?: ExportProgressCallback): Promise<ExportResult>;

package/out/export/write-markdown-export.js

@@ -0,0 +1,177 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { formatAttributeValue } from './html-export-utils.js';
+/** Build markdown paths from HTML-oriented snapshot page paths. */
+export function toMarkdownPath(htmlPath) {
+    return htmlPath.replace(/\.html$/i, '.md');
+}
+/** Write a multi-file markdown export from an export snapshot. */
+export async function writeMarkdownExport(snapshot, request, onProgress) {
+    const outputDir = join(request.outputDir, request.exportName);
+    await mkdir(outputDir, { recursive: true });
+    const indexFilePath = join(outputDir, 'README.md');
+    const ideasDir = join(outputDir, 'ideas');
+    if (snapshot.pageOptions.includeIdeaPages) {
+        await mkdir(ideasDir, { recursive: true });
+    }
+    const writes = [
+        () => writeFile(indexFilePath, renderReadme(snapshot), 'utf8'),
+    ];
+    if (snapshot.pageOptions.includeIdeaPages) {
+        for (const idea of snapshot.ideas) {
+            const path = join(outputDir, ideaMarkdownRelPath(idea));
+            writes.push(() => writeFile(path, renderIdeaMarkdown(snapshot, idea), 'utf8'));
+        }
+    }
+    const total = writes.length;
+    let completed = 0;
+    onProgress?.({
+        phase: 'write',
+        message: `Writing markdown (${total} files)…`,
+        completed: 0,
+        total,
+    });
+    for (const write of writes) {
+        await write();
+        completed += 1;
+        onProgress?.({
+            phase: 'write',
+            message: `Writing markdown (${completed}/${total})…`,
+            completed,
+            total,
+        });
+    }
+    return {
+        outputDir,
+        indexFilePath,
+        printFilePath: indexFilePath,
+        dataFilePath: indexFilePath,
+        ideasIndexFilePath: indexFilePath,
+    };
+}
+function ideaMarkdownRelPath(idea) {
+    return toMarkdownPath(idea.page.path);
+}
+function renderReadme(snapshot) {
+    const lines = [
+        `# ${snapshot.title}`,
+        '',
+        `Generated ${snapshot.generatedAt}`,
+        '',
+        `Ideas: **${snapshot.counts.ideas}** · Files: **${snapshot.counts.files}** · Clusters: **${snapshot.counts.clusters}**`,
+        '',
+    ];
+    if (Object.keys(snapshot.byStatus).length > 0) {
+        lines.push('## Status', '');
+        for (const [status, count] of Object.entries(snapshot.byStatus).sort((a, b) => a[0].localeCompare(b[0]))) {
+            lines.push(`- ${escapeMd(status)}: ${count}`);
+        }
+        lines.push('');
+    }
+    if (Object.keys(snapshot.byTag).length > 0) {
+        lines.push('## Tags', '');
+        for (const [tag, count] of Object.entries(snapshot.byTag).sort((a, b) => a[0].localeCompare(b[0]))) {
+            lines.push(`- ${escapeMd(tag)}: ${count}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Ideas', '');
+    if (snapshot.ideas.length === 0) {
+        lines.push('_No ideas in this export scope._', '');
+    }
+    else if (snapshot.pageOptions.includeIdeaPages) {
+        for (const idea of snapshot.ideas) {
+            const href = ideaMarkdownRelPath(idea);
+            const status = idea.status ? ` · ${escapeMd(idea.status)}` : '';
+            lines.push(`- [${escapeMdLinkText(idea.name)}](${href})${status}`);
+            if (idea.summary?.trim()) {
+                lines.push(`  - ${escapeMd(oneLine(idea.summary))}`);
+            }
+        }
+        lines.push('');
+    }
+    else {
+        for (const idea of snapshot.ideas) {
+            lines.push(renderIdeaMarkdown(snapshot, idea, { headingLevel: 3, omitBackLink: true }));
+            lines.push('');
+        }
+    }
+    if (snapshot.files.length > 0) {
+        lines.push('## Files', '');
+        for (const file of snapshot.files) {
+            lines.push(`- \`${escapeMd(file.fileUri)}\` (${file.ideas.length} ideas)`);
+        }
+        lines.push('');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+function renderIdeaMarkdown(snapshot, idea, options) {
+    const level = options?.headingLevel ?? 1;
+    const heading = `${'#'.repeat(level)} ${escapeMd(idea.name)}`;
+    const lines = [heading, ''];
+    if (!options?.omitBackLink) {
+        lines.push('[← Back to index](../README.md)', '');
+    }
+    if (idea.summary?.trim()) {
+        lines.push(idea.summary.trim(), '');
+    }
+    lines.push(`- **File:** \`${escapeMd(idea.fileUri)}\``);
+    if (idea.status) {
+        lines.push(`- **Status:** ${escapeMd(idea.status)}`);
+    }
+    if (idea.tags.length > 0) {
+        lines.push(`- **Tags:** ${idea.tags.map(tag => `\`${escapeMd(tag)}\``).join(', ')}`);
+    }
+    lines.push('');
+    const attrEntries = Object.entries(idea.attributes).filter(([key]) => key !== 'status' && key !== 'tags');
+    if (attrEntries.length > 0) {
+        lines.push('## Attributes', '');
+        for (const [key, value] of attrEntries.sort((a, b) => a[0].localeCompare(b[0]))) {
+            lines.push(`- **${escapeMd(key)}:** ${escapeMd(formatAttributeValue(value))}`);
+        }
+        lines.push('');
+    }
+    appendRefSection(lines, snapshot, 'Outbound', idea.references.outbound);
+    appendRefSection(lines, snapshot, 'Inbound', idea.references.inbound);
+    if (idea.references.unresolved.length > 0) {
+        lines.push('## Unresolved references', '');
+        for (const row of idea.references.unresolved) {
+            lines.push(`- ${escapeMd(row.label || row.targetName || row.targetPath || 'unresolved')}`);
+        }
+        lines.push('');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+function appendRefSection(lines, snapshot, title, rows) {
+    if (rows.length === 0) {
+        return;
+    }
+    lines.push(`## ${title}`, '');
+    for (const row of rows) {
+        const target = row.targetIdeaId ? snapshot.ideasById[row.targetIdeaId] : undefined;
+        if (target && snapshot.pageOptions.includeIdeaPages) {
+            const fileName = ideaMarkdownRelPath(target).replace(/^ideas\//, '');
+            lines.push(`- [${escapeMdLinkText(target.name)}](./${fileName})`);
+        }
+        else if (target) {
+            lines.push(`- ${escapeMd(target.name)}`);
+        }
+        else if (row.targetPath) {
+            lines.push(`- \`${escapeMd(row.targetPath)}\``);
+        }
+        else {
+            lines.push(`- ${escapeMd(row.targetName || row.label || 'reference')}`);
+        }
+    }
+    lines.push('');
+}
+function oneLine(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+function escapeMd(value) {
+    return value.replace(/([\\`*_{}[\]()#+\-.!|>])/g, '\\$1');
+}
+function escapeMdLinkText(value) {
+    return value.replace(/([\\\[\]])/g, '\\$1');
+}
+//# sourceMappingURL=write-markdown-export.js.map