@pellux/goodvibes-sdk 0.28.22 → 0.30.0

package/dist/platform/knowledge/projections.js

@@ -1 +1,668 @@
-export * from '../../_internal/platform/knowledge/projections.js';
+import { generatedKnowledgeCanonicalUri, generatedKnowledgeSourceId, isGeneratedKnowledgeSource, materializeGeneratedKnowledgeProjection, } from './generated-projections.js';
+import { buildBulletList, codeFenceJson, dedupe, formatDateTime, joinSections, materializedTargetReference, quote, slugify, sortByTitle, } from './projection-utils.js';
+export class KnowledgeProjectionService {
+    store;
+    artifactStore;
+    getConnectors;
+    constructor(store, artifactStore, options = {}) {
+        this.store = store;
+        this.artifactStore = artifactStore;
+        this.getConnectors = options.connectors ?? (() => []);
+    }
+    async listTargets(limit = 25) {
+        await this.store.init();
+        const max = Math.max(1, limit);
+        const targets = [this.createPresetTarget('overview'), this.createPresetTarget('bundle')];
+        const remaining = Math.max(1, max - targets.length);
+        const perKind = Math.max(1, Math.ceil(remaining / 4));
+        const sources = this.store.listSources(perKind).map((source) => this.createSourceTarget(source));
+        const nodes = this.store.listNodes(perKind).map((node) => this.createNodeTarget(node));
+        const issues = this.store.listIssues(perKind).map((issue) => this.createIssueTarget(issue));
+        const rollups = this.store.listNodes(Number.MAX_SAFE_INTEGER)
+            .filter((node) => node.kind === 'domain' || node.kind === 'topic' || node.kind === 'bookmark_folder')
+            .slice(0, Math.max(2, perKind))
+            .map((node) => this.createRollupTarget(node));
+        const dashboards = [this.createDashboardTarget('source-health'), this.createDashboardTarget('backlinks')];
+        return [...targets, ...sources, ...nodes, ...issues, ...dashboards, ...rollups].slice(0, max);
+    }
+    async render(input) {
+        await this.store.init();
+        const limit = Math.max(1, input.limit ?? 12);
+        const target = this.resolveTarget(input.kind, input.id);
+        if (!target) {
+            throw new Error(`Unknown knowledge projection target: ${input.kind}${input.id ? `/${input.id}` : ''}`);
+        }
+        switch (target.kind) {
+            case 'overview':
+                return this.bundleFromPages(target, [this.renderOverviewPage(target, limit)], { preset: 'overview' });
+            case 'bundle':
+                return this.renderBundleTarget(target, limit);
+            case 'source':
+                return this.bundleFromPages(target, [this.renderSourcePage(target.itemId)], {});
+            case 'node':
+                return this.bundleFromPages(target, [this.renderNodePage(target.itemId)], {});
+            case 'issue':
+                return this.bundleFromPages(target, [this.renderIssuePage(target.itemId)], {});
+            case 'dashboard':
+                return this.bundleFromPages(target, [this.renderDashboardPage(target, limit)], { preset: 'dashboard' });
+            case 'rollup':
+                return this.bundleFromPages(target, [this.renderRollupPage(target.itemId, target)], { preset: 'rollup' });
+            default:
+                return this.bundleFromPages(target, [this.renderOverviewPage(this.createPresetTarget('overview'), limit)], {});
+        }
+    }
+    async materialize(input) {
+        const bundle = await this.render(input);
+        const content = this.combineBundleMarkdown(bundle);
+        const projectionKind = `knowledge-${bundle.target.kind}`;
+        const sourceId = generatedKnowledgeSourceId(projectionKind, bundle.target.targetId);
+        const canonicalUri = generatedKnowledgeCanonicalUri(projectionKind, bundle.target.targetId);
+        const target = materializedTargetReference(bundle.target);
+        const metadata = {
+            projectionId: bundle.id,
+            targetId: bundle.target.targetId,
+            targetKind: bundle.target.kind,
+            pageCount: bundle.pageCount,
+            pagePaths: bundle.pages.map((page) => page.path),
+            itemIds: dedupe(bundle.pages.flatMap((page) => page.itemIds), (id) => id),
+        };
+        const generated = await materializeGeneratedKnowledgeProjection({
+            store: this.store,
+            artifactStore: this.artifactStore,
+            connectorId: 'knowledge-projection',
+            sourceId,
+            canonicalUri,
+            title: bundle.target.title,
+            summary: `Generated markdown projection for ${bundle.target.title}.`,
+            tags: ['knowledge', 'generated-page', 'projection', bundle.target.kind],
+            filename: input.filename?.trim() || bundle.target.defaultFilename,
+            markdown: content,
+            projectionKind,
+            metadata,
+            sourceMetadata: metadata,
+            artifactMetadata: metadata,
+            ...(target ? { target } : {}),
+        });
+        return {
+            bundle,
+            artifact: generated.artifact,
+            source: generated.source,
+            ...(generated.linked ? { linked: generated.linked } : {}),
+            artifactCreated: generated.artifactCreated,
+        };
+    }
+    resolveTarget(kind, id) {
+        if (kind === 'overview' || kind === 'bundle')
+            return this.createPresetTarget(kind);
+        if (kind === 'dashboard')
+            return this.createDashboardTarget(id ?? 'source-health');
+        if (kind === 'rollup') {
+            if (!id?.trim())
+                return null;
+            const node = this.store.getNode(id);
+            return node ? this.createRollupTarget(node) : null;
+        }
+        if (!id?.trim())
+            return null;
+        if (kind === 'source') {
+            const source = this.store.getSource(id);
+            return source ? this.createSourceTarget(source) : null;
+        }
+        if (kind === 'node') {
+            const node = this.store.getNode(id);
+            return node ? this.createNodeTarget(node) : null;
+        }
+        const issue = this.store.getIssue(id);
+        return issue ? this.createIssueTarget(issue) : null;
+    }
+    createPresetTarget(kind) {
+        if (kind === 'overview') {
+            return {
+                targetId: 'overview',
+                kind,
+                title: 'Knowledge Overview',
+                description: 'A compact markdown projection of the current structured knowledge store.',
+                defaultPath: 'wiki/index.md',
+                defaultFilename: 'knowledge-overview.md',
+                metadata: {},
+            };
+        }
+        return {
+            targetId: 'bundle',
+            kind,
+            title: 'Knowledge Bundle',
+            description: 'A multi-page markdown bundle containing indexes, dashboards, and recent records.',
+            defaultPath: 'wiki/bundle/index.md',
+            defaultFilename: 'knowledge-bundle.md',
+            metadata: {},
+        };
+    }
+    createDashboardTarget(id) {
+        if (id === 'backlinks') {
+            return {
+                targetId: 'dashboard:backlinks',
+                kind: 'dashboard',
+                title: 'Backlinks Dashboard',
+                description: 'Derived backlink and cross-reference projection across sources and nodes.',
+                itemId: 'backlinks',
+                defaultPath: 'wiki/dashboards/backlinks.md',
+                defaultFilename: 'knowledge-backlinks.md',
+                metadata: { dashboard: 'backlinks' },
+            };
+        }
+        return {
+            targetId: 'dashboard:source-health',
+            kind: 'dashboard',
+            title: 'Source Health Dashboard',
+            description: 'Derived staleness, issue, and extraction-health projection.',
+            itemId: 'source-health',
+            defaultPath: 'wiki/dashboards/source-health.md',
+            defaultFilename: 'knowledge-source-health.md',
+            metadata: { dashboard: 'source-health' },
+        };
+    }
+    createRollupTarget(node) {
+        return {
+            targetId: `rollup:${node.id}`,
+            kind: 'rollup',
+            title: `${node.title} Rollup`,
+            description: `Rollup projection for ${node.kind} ${node.title}.`,
+            itemId: node.id,
+            defaultPath: `wiki/rollups/${node.kind}-${node.slug}.md`,
+            defaultFilename: `${node.kind}-${node.slug}-rollup.md`,
+            metadata: {
+                kind: node.kind,
+            },
+        };
+    }
+    createSourceTarget(source) {
+        const title = source.title ?? source.canonicalUri ?? source.sourceUri ?? source.id;
+        return {
+            targetId: `source:${source.id}`,
+            kind: 'source',
+            title,
+            description: 'Markdown projection for a structured knowledge source.',
+            itemId: source.id,
+            defaultPath: `wiki/sources/${source.id}.md`,
+            defaultFilename: `${slugify(title)}.md`,
+            metadata: {
+                sourceType: source.sourceType,
+                status: source.status,
+            },
+        };
+    }
+    createNodeTarget(node) {
+        return {
+            targetId: `node:${node.id}`,
+            kind: 'node',
+            title: node.title,
+            description: 'Markdown projection for a structured knowledge node.',
+            itemId: node.id,
+            defaultPath: `wiki/nodes/${node.kind}-${node.slug}.md`,
+            defaultFilename: `${node.kind}-${node.slug}.md`,
+            metadata: {
+                kind: node.kind,
+                status: node.status,
+            },
+        };
+    }
+    createIssueTarget(issue) {
+        return {
+            targetId: `issue:${issue.id}`,
+            kind: 'issue',
+            title: issue.message,
+            description: 'Markdown projection for a structured knowledge lint or health issue.',
+            itemId: issue.id,
+            defaultPath: `wiki/issues/${issue.id}.md`,
+            defaultFilename: `${issue.id}.md`,
+            metadata: {
+                severity: issue.severity,
+                code: issue.code,
+            },
+        };
+    }
+    renderOverviewPage(target, limit) {
+        const status = this.store.status();
+        const sources = this.store.listSources(limit);
+        const nodes = this.store.listNodes(limit);
+        const issues = this.store.listIssues(limit);
+        const connectors = this.getConnectors();
+        const runs = this.store.listJobRuns(5);
+        const content = joinSections(`# ${target.title}`, 'Structured knowledge is canonical in SQL. This markdown page is a derived projection for clients, exports, and future wiki-style surfaces.', [
+            '## Counts',
+            `- sources: ${status.sourceCount}`,
+            `- nodes: ${status.nodeCount}`,
+            `- edges: ${status.edgeCount}`,
+            `- issues: ${status.issueCount}`,
+            `- extractions: ${status.extractionCount}`,
+            `- job runs: ${status.jobRunCount}`,
+        ].join('\n'), [
+            '## Connectors',
+            buildBulletList(connectors.map((connector) => `\`${connector.id}\` - ${connector.description}`)),
+        ].join('\n'), [
+            '## Recent Job Runs',
+            buildBulletList(runs.map((run) => `\`${run.jobId}\` - ${run.status} (${formatDateTime(run.completedAt ?? run.startedAt ?? run.requestedAt) ?? 'n/a'})`)),
+        ].join('\n'), [
+            '## Recent Sources',
+            buildBulletList(sources.map((source) => this.linkToTarget(this.createSourceTarget(source), `${source.title ?? source.canonicalUri ?? source.id} (${source.sourceType})`))),
+        ].join('\n'), [
+            '## Recent Nodes',
+            buildBulletList(nodes.map((node) => this.linkToTarget(this.createNodeTarget(node), `${node.title} (${node.kind})`))),
+        ].join('\n'), [
+            '## Open Issues',
+            buildBulletList(issues.map((issue) => this.linkToTarget(this.createIssueTarget(issue), `${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`))),
+        ].join('\n'));
+        return {
+            path: target.defaultPath,
+            title: target.title,
+            format: 'markdown',
+            content,
+            itemIds: [],
+            metadata: {
+                generatedFrom: 'knowledge-overview',
+            },
+        };
+    }
+    renderSourceIndexPage(limit) {
+        const sources = sortByTitle(this.store.listSources(Number.MAX_SAFE_INTEGER).slice(0, limit));
+        const lines = [
+            '# Sources Index',
+            '',
+            ...sources.map((source) => {
+                const extraction = this.store.getExtractionBySourceId(source.id);
+                const health = source.status === 'indexed' ? 'healthy' : source.status;
+                return `- ${this.linkToTarget(this.createSourceTarget(source), source.title ?? source.canonicalUri ?? source.id)} | ${source.sourceType} | ${health}${extraction ? ` | ${extraction.format}` : ''}`;
+            }),
+        ];
+        return {
+            path: 'wiki/indexes/sources.md',
+            title: 'Sources Index',
+            format: 'markdown',
+            content: lines.join('\n'),
+            itemIds: sources.map((source) => source.id),
+            metadata: {
+                kind: 'sources-index',
+            },
+        };
+    }
+    renderNodeIndexPage(limit) {
+        const nodes = sortByTitle(this.store.listNodes(Number.MAX_SAFE_INTEGER).slice(0, limit));
+        const grouped = new Map();
+        for (const node of nodes) {
+            const bucket = grouped.get(node.kind) ?? [];
+            bucket.push(node);
+            grouped.set(node.kind, bucket);
+        }
+        const sections = [...grouped.entries()].map(([kind, entries]) => [
+            `## ${kind}`,
+            buildBulletList(entries.map((entry) => this.linkToTarget(this.createNodeTarget(entry), `${entry.title} (${entry.status})`))),
+        ].join('\n'));
+        return {
+            path: 'wiki/indexes/nodes.md',
+            title: 'Nodes Index',
+            format: 'markdown',
+            content: ['# Nodes Index', ...sections].join('\n\n'),
+            itemIds: nodes.map((node) => node.id),
+            metadata: {
+                kind: 'nodes-index',
+            },
+        };
+    }
+    renderIssueDashboardPage(limit) {
+        const issues = this.store.listIssues(limit);
+        const severityGroups = ['error', 'warning', 'info'].map((severity) => [
+            `## ${severity.toUpperCase()}`,
+            buildBulletList(issues
+                .filter((issue) => issue.severity === severity)
+                .map((issue) => this.linkToTarget(this.createIssueTarget(issue), `${issue.code}: ${issue.message}`))),
+        ].join('\n'));
+        return {
+            path: 'wiki/dashboards/issues.md',
+            title: 'Issues Dashboard',
+            format: 'markdown',
+            content: ['# Issues Dashboard', ...severityGroups].join('\n\n'),
+            itemIds: issues.map((issue) => issue.id),
+            metadata: {
+                kind: 'issues-dashboard',
+            },
+        };
+    }
+    renderBacklinksPage(limit) {
+        const items = this.store.listSources(limit).map((source) => {
+            const incoming = this.store.listEdges()
+                .filter((edge) => edge.toKind === 'source' && edge.toId === source.id);
+            return { source, incoming };
+        }).filter((entry) => entry.incoming.length > 0);
+        const content = [
+            '# Backlinks Dashboard',
+            '',
+            ...items.map((entry) => [
+                `## ${entry.source.title ?? entry.source.canonicalUri ?? entry.source.id}`,
+                buildBulletList(entry.incoming.map((edge) => {
+                    if (edge.fromKind === 'source') {
+                        const linked = this.store.getSource(edge.fromId);
+                        return linked ? `${this.linkToTarget(this.createSourceTarget(linked))} via \`${edge.relation}\`` : `source:${edge.fromId}`;
+                    }
+                    if (edge.fromKind === 'node') {
+                        const node = this.store.getNode(edge.fromId);
+                        return node ? `${this.linkToTarget(this.createNodeTarget(node))} via \`${edge.relation}\`` : `node:${edge.fromId}`;
+                    }
+                    return `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``;
+                })),
+            ].join('\n')),
+        ].join('\n\n');
+        return {
+            path: 'wiki/dashboards/backlinks.md',
+            title: 'Backlinks Dashboard',
+            format: 'markdown',
+            content,
+            itemIds: items.map((entry) => entry.source.id),
+            metadata: {
+                kind: 'backlinks-dashboard',
+            },
+        };
+    }
+    renderHealthDashboardPage(limit) {
+        const sources = this.store.listSources(limit);
+        const staleThreshold = Date.now() - (14 * 24 * 60 * 60 * 1000);
+        const unhealthy = sources.filter((source) => (source.status !== 'indexed'
+            || Boolean(source.crawlError)
+            || (typeof source.lastCrawledAt === 'number' && source.lastCrawledAt < staleThreshold)
+            || !this.store.getExtractionBySourceId(source.id)));
+        const content = [
+            '# Source Health Dashboard',
+            '',
+            '## Sources Requiring Attention',
+            buildBulletList(unhealthy.map((source) => {
+                const extraction = this.store.getExtractionBySourceId(source.id);
+                const notes = [
+                    `status=${source.status}`,
+                    !extraction ? 'missing extraction' : undefined,
+                    source.crawlError ? `error=${source.crawlError}` : undefined,
+                    source.lastCrawledAt && source.lastCrawledAt < staleThreshold ? 'stale' : undefined,
+                ].filter(Boolean).join(', ');
+                return `${this.linkToTarget(this.createSourceTarget(source))} | ${notes}`;
+            })),
+        ].join('\n');
+        return {
+            path: 'wiki/dashboards/source-health.md',
+            title: 'Source Health Dashboard',
+            format: 'markdown',
+            content,
+            itemIds: unhealthy.map((source) => source.id),
+            metadata: {
+                kind: 'source-health-dashboard',
+            },
+        };
+    }
+    renderSourcePage(id) {
+        const source = this.store.getSource(id);
+        if (!source)
+            throw new Error(`Unknown knowledge source: ${id}`);
+        const extraction = this.store.getExtractionBySourceId(id);
+        const view = this.store.getItem(id);
+        const target = this.createSourceTarget(source);
+        const relatedNodes = view?.linkedNodes ?? [];
+        const relatedSources = view?.linkedSources.filter((entry) => (entry.id !== source.id && !isGeneratedKnowledgeSource(entry))) ?? [];
+        const issues = this.store.listIssues(Number.MAX_SAFE_INTEGER).filter((issue) => issue.sourceId === source.id);
+        const incoming = this.store.listEdges().filter((edge) => (edge.toKind === 'source'
+            && edge.toId === source.id
+            && !this.isGeneratedSourceReference(edge.fromKind, edge.fromId)));
+        const content = joinSections(`# ${target.title}`, extraction?.summary ?? source.summary, [
+            '## Metadata',
+            `- id: \`${source.id}\``,
+            `- connector: \`${source.connectorId}\``,
+            `- source type: \`${source.sourceType}\``,
+            `- status: \`${source.status}\``,
+            ...(source.sourceUri ? [`- source uri: ${source.sourceUri}`] : []),
+            ...(source.canonicalUri ? [`- canonical uri: ${source.canonicalUri}`] : []),
+            ...(source.folderPath ? [`- folder path: ${source.folderPath}`] : []),
+            ...(formatDateTime(source.lastCrawledAt) ? [`- last crawled: ${formatDateTime(source.lastCrawledAt)}`] : []),
+            ...(source.artifactId ? [`- artifact: \`${source.artifactId}\``] : []),
+            ...(source.tags.length > 0 ? [`- tags: ${source.tags.join(', ')}`] : []),
+        ].join('\n'), quote(source.description), extraction ? [
+            '## Extraction',
+            `- format: \`${extraction.format}\``,
+            `- estimated tokens: ${extraction.estimatedTokens}`,
+            ...(extraction.sections.length > 0 ? [`- sections: ${extraction.sections.join(', ')}`] : []),
+            ...(extraction.links.length > 0 ? [`- links: ${extraction.links.join(', ')}`] : []),
+        ].join('\n') : null, extraction?.excerpt ? ['## Excerpt', extraction.excerpt].join('\n') : null, [
+            '## Related Nodes',
+            buildBulletList(relatedNodes.map((node) => this.linkToTarget(this.createNodeTarget(node), `${node.title} (${node.kind})`))),
+        ].join('\n'), [
+            '## Related Sources',
+            buildBulletList(relatedSources.map((entry) => this.linkToTarget(this.createSourceTarget(entry)))),
+        ].join('\n'), [
+            '## Backlinks',
+            buildBulletList(incoming.map((edge) => `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``)),
+        ].join('\n'), [
+            '## Issues',
+            buildBulletList(issues.map((issue) => this.linkToTarget(this.createIssueTarget(issue), `${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`))),
+        ].join('\n'), [
+            '## Metadata JSON',
+            codeFenceJson(source.metadata),
+        ].filter(Boolean).join('\n'), extraction ? [
+            '## Extraction Structure',
+            codeFenceJson(extraction.structure),
+        ].filter(Boolean).join('\n') : null);
+        return {
+            path: target.defaultPath,
+            title: target.title,
+            format: 'markdown',
+            content,
+            itemIds: [source.id],
+            metadata: {
+                sourceId: source.id,
+                sourceType: source.sourceType,
+                ...(extraction ? { extractionId: extraction.id } : {}),
+            },
+        };
+    }
+    renderNodePage(id) {
+        const node = this.store.getNode(id);
+        if (!node)
+            throw new Error(`Unknown knowledge node: ${id}`);
+        const view = this.store.getItem(id);
+        const target = this.createNodeTarget(node);
+        const incoming = this.store.listEdges().filter((edge) => edge.toKind === 'node' && edge.toId === node.id);
+        const content = joinSections(`# ${target.title}`, node.summary, [
+            '## Metadata',
+            `- id: \`${node.id}\``,
+            `- kind: \`${node.kind}\``,
+            `- slug: \`${node.slug}\``,
+            `- status: \`${node.status}\``,
+            `- confidence: ${node.confidence}`,
+            ...(node.aliases.length > 0 ? [`- aliases: ${node.aliases.join(', ')}`] : []),
+            ...(node.sourceId ? [`- source: \`${node.sourceId}\``] : []),
+        ].join('\n'), [
+            '## Linked Sources',
+            buildBulletList((view?.linkedSources ?? [])
+                .filter((source) => !isGeneratedKnowledgeSource(source))
+                .map((source) => this.linkToTarget(this.createSourceTarget(source)))),
+        ].join('\n'), [
+            '## Linked Nodes',
+            buildBulletList((view?.linkedNodes ?? []).filter((entry) => entry.id !== node.id).map((entry) => this.linkToTarget(this.createNodeTarget(entry), `${entry.title} (${entry.kind})`))),
+        ].join('\n'), [
+            '## Backlinks',
+            buildBulletList(incoming
+                .filter((edge) => !this.isGeneratedSourceReference(edge.fromKind, edge.fromId))
+                .map((edge) => `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``)),
+        ].join('\n'), [
+            '## Issues',
+            buildBulletList(this.store.listIssues(Number.MAX_SAFE_INTEGER)
+                .filter((issue) => issue.nodeId === node.id)
+                .map((issue) => this.linkToTarget(this.createIssueTarget(issue), `${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`))),
+        ].join('\n'), [
+            '## Metadata JSON',
+            codeFenceJson(node.metadata),
+        ].filter(Boolean).join('\n'));
+        return {
+            path: target.defaultPath,
+            title: target.title,
+            format: 'markdown',
+            content,
+            itemIds: [node.id],
+            metadata: {
+                nodeId: node.id,
+                kind: node.kind,
+            },
+        };
+    }
+    renderIssuePage(id) {
+        const issue = this.store.getIssue(id);
+        if (!issue)
+            throw new Error(`Unknown knowledge issue: ${id}`);
+        const target = this.createIssueTarget(issue);
+        const source = issue.sourceId ? this.store.getSource(issue.sourceId) : null;
+        const node = issue.nodeId ? this.store.getNode(issue.nodeId) : null;
+        const content = joinSections(`# ${target.title}`, [
+            '## Metadata',
+            `- id: \`${issue.id}\``,
+            `- severity: \`${issue.severity}\``,
+            `- code: \`${issue.code}\``,
+            `- status: \`${issue.status}\``,
+            ...(formatDateTime(issue.createdAt) ? [`- created: ${formatDateTime(issue.createdAt)}`] : []),
+            ...(formatDateTime(issue.updatedAt) ? [`- updated: ${formatDateTime(issue.updatedAt)}`] : []),
+        ].join('\n'), [
+            '## Message',
+            issue.message,
+        ].join('\n'), [
+            '## Linked Records',
+            buildBulletList([
+                ...(source ? [this.linkToTarget(this.createSourceTarget(source), `source: ${source.title ?? source.id}`)] : []),
+                ...(node ? [this.linkToTarget(this.createNodeTarget(node), `node: ${node.title}`)] : []),
+            ]),
+        ].join('\n'), [
+            '## Metadata JSON',
+            codeFenceJson(issue.metadata),
+        ].filter(Boolean).join('\n'));
+        return {
+            path: target.defaultPath,
+            title: target.title,
+            format: 'markdown',
+            content,
+            itemIds: [issue.id, ...(source ? [source.id] : []), ...(node ? [node.id] : [])],
+            metadata: {
+                issueId: issue.id,
+                severity: issue.severity,
+            },
+        };
+    }
+    renderDashboardPage(target, limit) {
+        if (target.itemId === 'backlinks') {
+            return this.renderBacklinksPage(limit);
+        }
+        return this.renderHealthDashboardPage(limit);
+    }
+    renderRollupPage(nodeId, target) {
+        const node = this.store.getNode(nodeId);
+        if (!node)
+            throw new Error(`Unknown rollup node: ${nodeId}`);
+        const edges = this.store.edgesFor('node', node.id);
+        const sources = edges
+            .map((edge) => {
+            if (edge.fromKind === 'source')
+                return this.store.getSource(edge.fromId);
+            if (edge.toKind === 'source')
+                return this.store.getSource(edge.toId);
+            return null;
+        })
+            .filter((source) => Boolean(source));
+        const linkedNodes = edges
+            .map((edge) => {
+            if (edge.fromKind === 'node' && edge.fromId !== node.id)
+                return this.store.getNode(edge.fromId);
+            if (edge.toKind === 'node' && edge.toId !== node.id)
+                return this.store.getNode(edge.toId);
+            return null;
+        })
+            .filter((entry) => Boolean(entry));
+        const content = joinSections(`# ${target.title}`, node.summary, [
+            '## Included Sources',
+            buildBulletList(sortByTitle(dedupe(sources, (source) => source.id)).map((source) => this.linkToTarget(this.createSourceTarget(source)))),
+        ].join('\n'), [
+            '## Related Nodes',
+            buildBulletList(sortByTitle(dedupe(linkedNodes, (entry) => entry.id)).map((entry) => this.linkToTarget(this.createNodeTarget(entry), `${entry.title} (${entry.kind})`))),
+        ].join('\n'), [
+            '## Metadata JSON',
+            codeFenceJson(node.metadata),
+        ].filter(Boolean).join('\n'));
+        return {
+            path: target.defaultPath,
+            title: target.title,
+            format: 'markdown',
+            content,
+            itemIds: [node.id, ...sources.map((source) => source.id)],
+            metadata: {
+                rollupNodeId: node.id,
+                kind: node.kind,
+            },
+        };
+    }
+    renderBundleTarget(target, limit) {
+        const overview = this.renderOverviewPage(this.createPresetTarget('overview'), limit);
+        const sourceIndex = this.renderSourceIndexPage(Math.max(limit * 2, 24));
+        const nodeIndex = this.renderNodeIndexPage(Math.max(limit * 2, 24));
+        const issueDashboard = this.renderIssueDashboardPage(Math.max(limit * 2, 24));
+        const backlinks = this.renderBacklinksPage(Math.max(limit * 2, 16));
+        const health = this.renderHealthDashboardPage(Math.max(limit * 2, 16));
+        const pages = [overview, sourceIndex, nodeIndex, issueDashboard, backlinks, health];
+        const perKind = Math.max(1, Math.ceil(limit / 3));
+        for (const node of this.store.listNodes(Number.MAX_SAFE_INTEGER).filter((entry) => entry.kind === 'domain' || entry.kind === 'topic').slice(0, 4)) {
+            pages.push(this.renderRollupPage(node.id, this.createRollupTarget(node)));
+        }
+        for (const source of this.store.listSources(perKind)) {
+            pages.push(this.renderSourcePage(source.id));
+        }
+        for (const node of this.store.listNodes(perKind)) {
+            pages.push(this.renderNodePage(node.id));
+        }
+        for (const issue of this.store.listIssues(perKind)) {
+            pages.push(this.renderIssuePage(issue.id));
+        }
+        return this.bundleFromPages(target, pages, {
+            preset: 'bundle',
+            sourceCount: this.store.status().sourceCount,
+            nodeCount: this.store.status().nodeCount,
+            issueCount: this.store.status().issueCount,
+        });
+    }
+    bundleFromPages(target, pages, metadata) {
+        return {
+            id: `projection-${slugify(target.targetId)}`,
+            target,
+            generatedAt: Date.now(),
+            pageCount: pages.length,
+            pages,
+            metadata,
+        };
+    }
+    linkToTarget(target, label) {
+        return `[${label ?? target.title}](${target.defaultPath})`;
+    }
+    combineBundleMarkdown(bundle) {
+        if (bundle.pages.length === 1) {
+            return bundle.pages[0].content;
+        }
+        const index = [
+            `# ${bundle.target.title}`,
+            `Generated: ${new Date(bundle.generatedAt).toISOString()}`,
+            '',
+            '## Pages',
+            ...bundle.pages.map((page) => `- [${page.title}](${page.path})`),
+        ].join('\n');
+        const pages = bundle.pages.map((page) => [
+            `## ${page.title}`,
+            `Path: \`${page.path}\``,
+            '',
+            page.content,
+        ].join('\n'));
+        return [index, ...pages].join('\n\n---\n\n');
+    }
+    isGeneratedSourceReference(kind, id) {
+        if (kind !== 'source')
+            return false;
+        const source = this.store.getSource(id);
+        return source ? isGeneratedKnowledgeSource(source) : false;
+    }
+}

package/dist/platform/knowledge/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAyCrC"}

package/dist/platform/knowledge/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8E,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC3J,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CACpB,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC1H,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC;AAED,qBAAa,wBAAwB;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoD;IACnF,OAAO,CAAC,oBAAoB,CAAS;gBAER,OAAO,EAAE,0BAA0B;IAkBhE,QAAQ,IAAI,SAAS,kBAAkB,EAAE;IAIzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqB9B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAiB/F,WAAW,CAAC,KAAK,SAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE;IAIpE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,GAAE;QACL,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;QACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,qBAAqB,CAAC;IAmCjC,OAAO,IAAI,IAAI;YAOD,mBAAmB;YAUnB,uBAAuB;IAiBrC,OAAO,CAAC,kBAAkB;YAQZ,kBAAkB;YAqClB,eAAe;YAmBf,aAAa;CA0D5B"}