@pellux/goodvibes-sdk 0.33.9 → 0.33.11

package/dist/platform/knowledge/packet.js

@@ -1,10 +1,11 @@
+import { isInKnowledgeSpaceScope, } from './spaces.js';
 import { emitKnowledgePacketBuilt } from '../runtime/emitters/index.js';
 import { DEFAULT_PACKET_BUDGET, DEFAULT_PACKET_LIMIT, estimateTokens, isSourcePastRefreshWindow, renderPacket, scoreHaystack, summarizeCompact, tokenize, trimForDetail, } from './shared.js';
-export function searchKnowledge(context, query, limit = 10) {
+export function searchKnowledge(context, query, limit = 10, scope = {}) {
     const taskTokens = tokenize(query);
     if (taskTokens.length === 0)
         return [];
-    const sourceResults = context.store.listSources(Number.MAX_SAFE_INTEGER).map((source) => {
+    const sourceResults = context.store.listSources(Number.MAX_SAFE_INTEGER).filter((source) => isInKnowledgeSpaceScope(source, scope)).map((source) => {
         const extraction = context.store.getExtractionBySourceId(source.id);
         const haystack = [
             source.title ?? '',
@@ -27,7 +28,7 @@ export function searchKnowledge(context, query, limit = 10) {
             source,
         };
     });
-    const nodeResults = context.store.listNodes(Number.MAX_SAFE_INTEGER).map((node) => {
+    const nodeResults = context.store.listNodes(Number.MAX_SAFE_INTEGER).filter((node) => isInKnowledgeSpaceScope(node, scope)).map((node) => {
         const haystack = [
             node.title,
             node.summary ?? '',
@@ -81,6 +82,8 @@ function buildKnowledgePacketFromCurrentState(context, task, writeScope, limit,
     const usageStats = buildUsageStats(context);
     const candidates = [];
     for (const source of context.store.listSources(Number.MAX_SAFE_INTEGER)) {
+        if (!isInKnowledgeSpaceScope(source, options))
+            continue;
         const extraction = context.store.getExtractionBySourceId(source.id);
         const haystack = [
             source.title ?? '',
@@ -101,7 +104,7 @@ function buildKnowledgePacketFromCurrentState(context, task, writeScope, limit,
             ? []
             : (extraction?.sections.slice(0, detail === 'detailed' ? 4 : 2) ?? []);
         const summary = trimForDetail(extraction?.summary ?? source.summary ?? source.description, detail);
-        const relationLabels = collectRelatedLabels(context, 'source', source.id);
+        const relationLabels = collectRelatedLabels(context, 'source', source.id, options);
         const usageBoost = scoreUsageBoost(usageStats.get(`source:${source.id}`));
         const relationBoost = Math.min(18, relationLabels.length * 3);
         const freshnessBoost = isSourcePastRefreshWindow(source) ? -8 : 6;
@@ -126,6 +129,8 @@ function buildKnowledgePacketFromCurrentState(context, task, writeScope, limit,
         candidates.push({ score: item.score, item });
     }
     for (const node of context.store.listNodes(Number.MAX_SAFE_INTEGER)) {
+        if (!isInKnowledgeSpaceScope(node, options))
+            continue;
         const haystack = [
             node.title,
             node.summary ?? '',
@@ -135,7 +140,7 @@ function buildKnowledgePacketFromCurrentState(context, task, writeScope, limit,
         const scored = scoreHaystack(haystack, taskTokens, scopeTokens);
         if (scored.score <= 0)
             continue;
-        const related = collectRelatedLabels(context, 'node', node.id);
+        const related = collectRelatedLabels(context, 'node', node.id, options);
         const usageBoost = scoreUsageBoost(usageStats.get(`node:${node.id}`));
         const relationBoost = Math.min(20, context.store.edgesFor('node', node.id).length * 2);
         const kindBoost = nodeKindBoost(node.kind);
@@ -202,7 +207,7 @@ function buildKnowledgePacketFromCurrentState(context, task, writeScope, limit,
     }));
     return packet;
 }
-function collectRelatedLabels(context, kind, id) {
+function collectRelatedLabels(context, kind, id, scope) {
     const related = context.store.edgesFor(kind, id);
     const labels = [];
     for (const edge of related) {
@@ -210,12 +215,12 @@ function collectRelatedLabels(context, kind, id) {
         const otherId = edge.fromKind === kind && edge.fromId === id ? edge.toId : edge.fromId;
         if (otherKind === 'node') {
             const node = context.store.getNode(otherId);
-            if (node)
+            if (node && isInKnowledgeSpaceScope(node, scope))
                 labels.push(node.title);
         }
         else if (otherKind === 'source') {
             const source = context.store.getSource(otherId);
-            if (source)
+            if (source && isInKnowledgeSpaceScope(source, scope))
                 labels.push(source.title ?? source.canonicalUri ?? source.id);
         }
     }

package/dist/platform/knowledge/projections.d.ts

@@ -1,4 +1,5 @@
 import type { ArtifactStore } from '../artifacts/index.js';
+import { type KnowledgeSpaceScopeInput } from './spaces.js';
 import type { KnowledgeStore } from './store.js';
 import type { KnowledgeConnector, KnowledgeMaterializedProjection, KnowledgeProjectionBundle, KnowledgeProjectionTarget, KnowledgeProjectionTargetKind } from './types.js';
 export interface KnowledgeProjectionServiceOptions {
@@ -9,17 +10,21 @@ export declare class KnowledgeProjectionService {
     private readonly artifactStore;
     private readonly getConnectors;
     constructor(store: KnowledgeStore, artifactStore: ArtifactStore, options?: KnowledgeProjectionServiceOptions);
-    listTargets(limit?: number): Promise<KnowledgeProjectionTarget[]>;
+    listTargets(limit?: number, scope?: KnowledgeSpaceScopeInput): Promise<KnowledgeProjectionTarget[]>;
     render(input: {
         readonly kind: KnowledgeProjectionTargetKind;
         readonly id?: string | undefined;
         readonly limit?: number | undefined;
+        readonly knowledgeSpaceId?: string | undefined;
+        readonly includeAllSpaces?: boolean | undefined;
     }): Promise<KnowledgeProjectionBundle>;
     materialize(input: {
         readonly kind: KnowledgeProjectionTargetKind;
         readonly id?: string | undefined;
         readonly limit?: number | undefined;
         readonly filename?: string | undefined;
+        readonly knowledgeSpaceId?: string | undefined;
+        readonly includeAllSpaces?: boolean | undefined;
     }): Promise<KnowledgeMaterializedProjection>;
     private resolveTarget;
     private createPresetTarget;
@@ -44,5 +49,11 @@ export declare class KnowledgeProjectionService {
     private linkToTarget;
     private combineBundleMarkdown;
     private isGeneratedSourceReference;
+    private edgeInScope;
+    private recordReferenceInScope;
+    private scopedSources;
+    private scopedNodes;
+    private scopedIssues;
+    private scopedExtractions;
 }
 //# sourceMappingURL=projections.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/projections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAiB3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EAElB,+BAA+B,EAE/B,yBAAyB,EAEzB,yBAAyB,EACzB,6BAA6B,EAE9B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,SAAS,kBAAkB,EAAE,CAAC,GAAG,SAAS,CAAC;CACzE;AAED,qBAAa,0BAA0B;IAInC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;gBAGjD,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,aAAa,EAC7C,OAAO,GAAE,iCAAsC;IAK3C,WAAW,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAiB7D,MAAM,CACV,KAAK,EAAE;QACL,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;QAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,GACA,OAAO,CAAC,yBAAyB,CAAC;IA4B/B,WAAW,CACf,KAAK,EAAE;QACL,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;QAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GACA,OAAO,CAAC,+BAA+B,CAAC;IAyC3C,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,kBAAkB;IAoD1B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,gBAAgB;IAwExB,OAAO,CAAC,cAAc;IAuDtB,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,0BAA0B;CAKnC"}
+{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/projections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EAElB,+BAA+B,EAE/B,yBAAyB,EAEzB,yBAAyB,EACzB,6BAA6B,EAE9B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,SAAS,kBAAkB,EAAE,CAAC,GAAG,SAAS,CAAC;CACzE;AAED,qBAAa,0BAA0B;IAInC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;gBAGjD,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,aAAa,EAC7C,OAAO,GAAE,iCAAsC;IAK3C,WAAW,CAAC,KAAK,SAAK,EAAE,KAAK,GAAE,wBAA6B,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAiBnG,MAAM,CACV,KAAK,EAAE;QACL,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;QAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjD,GACA,OAAO,CAAC,yBAAyB,CAAC;IA6B/B,WAAW,CACf,KAAK,EAAE;QACL,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;QAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjD,GACA,OAAO,CAAC,+BAA+B,CAAC;IAyC3C,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,gBAAgB;IAyExB,OAAO,CAAC,cAAc;IAwDtB,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/platform/knowledge/projections.js

@@ -1,4 +1,5 @@
 import { generatedKnowledgeCanonicalUri, generatedKnowledgeSourceId, isGeneratedKnowledgeSource, materializeGeneratedKnowledgeProjection, } from './generated-projections.js';
+import { isInKnowledgeSpaceScope, resolveKnowledgeSpaceScope, } from './spaces.js';
 import { buildBulletList, dedupe, formatDateTime, joinSections, materializedTargetReference, quote, slugify, sortByTitle, } from './projection-utils.js';
 export class KnowledgeProjectionService {
     store;
@@ -9,16 +10,16 @@ export class KnowledgeProjectionService {
         this.artifactStore = artifactStore;
         this.getConnectors = options.connectors ?? (() => []);
     }
-    async listTargets(limit = 25) {
+    async listTargets(limit = 25, scope = {}) {
         await this.store.init();
         const max = Math.max(1, limit);
-        const targets = [this.createPresetTarget('overview'), this.createPresetTarget('bundle')];
+        const targets = [this.createPresetTarget('overview', scope), this.createPresetTarget('bundle', scope)];
         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)
+        const sources = this.scopedSources(scope, perKind).map((source) => this.createSourceTarget(source));
+        const nodes = this.scopedNodes(scope, perKind).map((node) => this.createNodeTarget(node));
+        const issues = this.scopedIssues(scope, perKind).map((issue) => this.createIssueTarget(issue));
+        const rollups = this.scopedNodes(scope)
             .filter((node) => node.kind === 'domain' || node.kind === 'topic' || node.kind === 'bookmark_folder')
             .slice(0, Math.max(2, perKind))
             .map((node) => this.createRollupTarget(node));
@@ -28,27 +29,28 @@ export class KnowledgeProjectionService {
     async render(input) {
         await this.store.init();
         const limit = Math.max(1, input.limit ?? 12);
-        const target = this.resolveTarget(input.kind, input.id);
+        const scope = projectionScope(input);
+        const target = this.resolveTarget(input.kind, input.id, scope);
         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' });
+                return this.bundleFromPages(target, [this.renderOverviewPage(target, limit, scope)], { preset: 'overview' }, scope);
             case 'bundle':
-                return this.renderBundleTarget(target, limit);
+                return this.renderBundleTarget(target, limit, scope);
             case 'source':
-                return this.bundleFromPages(target, [this.renderSourcePage(target.itemId)], {});
+                return this.bundleFromPages(target, [this.renderSourcePage(target.itemId, scope)], {}, scope);
             case 'node':
-                return this.bundleFromPages(target, [this.renderNodePage(target.itemId)], {});
+                return this.bundleFromPages(target, [this.renderNodePage(target.itemId, scope)], {}, scope);
             case 'issue':
-                return this.bundleFromPages(target, [this.renderIssuePage(target.itemId)], {});
+                return this.bundleFromPages(target, [this.renderIssuePage(target.itemId, scope)], {}, scope);
             case 'dashboard':
-                return this.bundleFromPages(target, [this.renderDashboardPage(target, limit)], { preset: 'dashboard' });
+                return this.bundleFromPages(target, [this.renderDashboardPage(target, limit, scope)], { preset: 'dashboard' }, scope);
             case 'rollup':
-                return this.bundleFromPages(target, [this.renderRollupPage(target.itemId, target)], { preset: 'rollup' });
+                return this.bundleFromPages(target, [this.renderRollupPage(target.itemId, target, scope)], { preset: 'rollup' }, scope);
             default:
-                return this.bundleFromPages(target, [this.renderOverviewPage(this.createPresetTarget('overview'), limit)], {});
+                return this.bundleFromPages(target, [this.renderOverviewPage(this.createPresetTarget('overview', scope), limit, scope)], {}, scope);
         }
     }
     async materialize(input) {
@@ -91,31 +93,33 @@ export class KnowledgeProjectionService {
             artifactCreated: generated.artifactCreated,
         };
     }
-    resolveTarget(kind, id) {
+    resolveTarget(kind, id, scope) {
         if (kind === 'overview' || kind === 'bundle')
-            return this.createPresetTarget(kind);
+            return this.createPresetTarget(kind, scope);
         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;
+            return node && isInKnowledgeSpaceScope(node, scope) ? this.createRollupTarget(node) : null;
         }
         if (!id?.trim())
             return null;
         if (kind === 'source') {
             const source = this.store.getSource(id);
-            return source ? this.createSourceTarget(source) : null;
+            return source && isInKnowledgeSpaceScope(source, scope) ? this.createSourceTarget(source) : null;
         }
         if (kind === 'node') {
             const node = this.store.getNode(id);
-            return node ? this.createNodeTarget(node) : null;
+            return node && isInKnowledgeSpaceScope(node, scope) ? this.createNodeTarget(node) : null;
         }
         const issue = this.store.getIssue(id);
-        return issue ? this.createIssueTarget(issue) : null;
+        return issue && isInKnowledgeSpaceScope(issue, scope) ? this.createIssueTarget(issue) : null;
     }
-    createPresetTarget(kind) {
+    createPresetTarget(kind, scope) {
+        const spaceId = resolveKnowledgeSpaceScope(scope);
+        const metadata = spaceId === null ? { includeAllSpaces: true } : { knowledgeSpaceId: spaceId };
         if (kind === 'overview') {
             return {
                 targetId: 'overview',
@@ -124,7 +128,7 @@ export class KnowledgeProjectionService {
                 description: 'A compact markdown projection of the current structured knowledge store.',
                 defaultPath: 'wiki/index.md',
                 defaultFilename: 'knowledge-overview.md',
-                metadata: {},
+                metadata,
             };
         }
         return {
@@ -134,7 +138,7 @@ export class KnowledgeProjectionService {
             description: 'A multi-page markdown bundle containing indexes, dashboards, and recent records.',
             defaultPath: 'wiki/bundle/index.md',
             defaultFilename: 'knowledge-bundle.md',
-            metadata: {},
+            metadata,
         };
     }
     createDashboardTarget(id) {
@@ -221,21 +225,25 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    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);
+    renderOverviewPage(target, limit, scope) {
+        const sources = this.scopedSources(scope, limit);
+        const nodes = this.scopedNodes(scope, limit);
+        const issues = this.scopedIssues(scope, limit);
+        const allSources = this.scopedSources(scope);
+        const allNodes = this.scopedNodes(scope);
+        const allIssues = this.scopedIssues(scope);
+        const edgeCount = this.store.listEdges().filter((edge) => this.edgeInScope(edge, scope)).length;
+        const extractionCount = this.scopedExtractions(scope).length;
         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}`,
+            `- sources: ${allSources.length}`,
+            `- nodes: ${allNodes.length}`,
+            `- edges: ${edgeCount}`,
+            `- issues: ${allIssues.length}`,
+            `- extractions: ${extractionCount}`,
+            `- job runs: ${this.store.listJobRuns(Number.MAX_SAFE_INTEGER).length}`,
         ].join('\n'), [
             '## Connectors',
             buildBulletList(connectors.map((connector) => `\`${connector.id}\` - ${connector.description}`)),
@@ -263,8 +271,8 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderSourceIndexPage(limit) {
-        const sources = sortByTitle(this.store.listSources(Number.MAX_SAFE_INTEGER).slice(0, limit));
+    renderSourceIndexPage(limit, scope) {
+        const sources = sortByTitle(this.scopedSources(scope).slice(0, limit));
         const lines = [
             '# Sources Index',
             '',
@@ -285,8 +293,8 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderNodeIndexPage(limit) {
-        const nodes = sortByTitle(this.store.listNodes(Number.MAX_SAFE_INTEGER).slice(0, limit));
+    renderNodeIndexPage(limit, scope) {
+        const nodes = sortByTitle(this.scopedNodes(scope).slice(0, limit));
         const grouped = new Map();
         for (const node of nodes) {
             const bucket = grouped.get(node.kind) ?? [];
@@ -308,8 +316,8 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderIssueDashboardPage(limit) {
-        const issues = this.store.listIssues(limit);
+    renderIssueDashboardPage(limit, scope) {
+        const issues = this.scopedIssues(scope, limit);
         const severityGroups = ['error', 'warning', 'info'].map((severity) => [
             `## ${severity.toUpperCase()}`,
             buildBulletList(issues
@@ -327,10 +335,11 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderBacklinksPage(limit) {
-        const items = this.store.listSources(limit).map((source) => {
+    renderBacklinksPage(limit, scope) {
+        const items = this.scopedSources(scope, limit).map((source) => {
             const incoming = this.store.listEdges()
-                .filter((edge) => edge.toKind === 'source' && edge.toId === source.id);
+                .filter((edge) => edge.toKind === 'source' && edge.toId === source.id)
+                .filter((edge) => this.edgeInScope(edge, scope));
             return { source, incoming };
         }).filter((entry) => entry.incoming.length > 0);
         const content = [
@@ -341,11 +350,11 @@ export class KnowledgeProjectionService {
                 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}`;
+                        return linked && isInKnowledgeSpaceScope(linked, scope) ? `${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 node && isInKnowledgeSpaceScope(node, scope) ? `${this.linkToTarget(this.createNodeTarget(node))} via \`${edge.relation}\`` : `node:${edge.fromId}`;
                     }
                     return `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``;
                 })),
@@ -362,8 +371,8 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderHealthDashboardPage(limit) {
-        const sources = this.store.listSources(limit);
+    renderHealthDashboardPage(limit, scope) {
+        const sources = this.scopedSources(scope, limit);
         const staleThreshold = Date.now() - (14 * 24 * 60 * 60 * 1000);
         const unhealthy = sources.filter((source) => (source.status !== 'indexed'
             || Boolean(source.crawlError)
@@ -395,19 +404,20 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderSourcePage(id) {
+    renderSourcePage(id, scope) {
         const source = this.store.getSource(id);
-        if (!source)
+        if (!source || !isInKnowledgeSpaceScope(source, scope))
             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 issues = this.scopedIssues(scope).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)));
+            && !this.isGeneratedSourceReference(edge.fromKind, edge.fromId)
+            && this.edgeInScope(edge, scope)));
         const content = joinSections(`# ${target.title}`, extraction?.summary ?? source.summary, [
             '## Metadata',
             `- id: \`${source.id}\``,
@@ -428,10 +438,10 @@ export class KnowledgeProjectionService {
             ...(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})`))),
+            buildBulletList(relatedNodes.filter((node) => isInKnowledgeSpaceScope(node, scope)).map((node) => this.linkToTarget(this.createNodeTarget(node), `${node.title} (${node.kind})`))),
         ].join('\n'), [
             '## Related Sources',
-            buildBulletList(relatedSources.map((entry) => this.linkToTarget(this.createSourceTarget(entry)))),
+            buildBulletList(relatedSources.filter((entry) => isInKnowledgeSpaceScope(entry, scope)).map((entry) => this.linkToTarget(this.createSourceTarget(entry)))),
         ].join('\n'), [
             '## Backlinks',
             buildBulletList(incoming.map((edge) => `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``)),
@@ -452,13 +462,13 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderNodePage(id) {
+    renderNodePage(id, scope) {
         const node = this.store.getNode(id);
-        if (!node)
+        if (!node || !isInKnowledgeSpaceScope(node, scope))
             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 incoming = this.store.listEdges().filter((edge) => edge.toKind === 'node' && edge.toId === node.id && this.edgeInScope(edge, scope));
         const content = joinSections(`# ${target.title}`, node.summary, [
             '## Metadata',
             `- id: \`${node.id}\``,
@@ -472,10 +482,11 @@ export class KnowledgeProjectionService {
             '## Linked Sources',
             buildBulletList((view?.linkedSources ?? [])
                 .filter((source) => !isGeneratedKnowledgeSource(source))
+                .filter((source) => isInKnowledgeSpaceScope(source, scope))
                 .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})`))),
+            buildBulletList((view?.linkedNodes ?? []).filter((entry) => entry.id !== node.id && isInKnowledgeSpaceScope(entry, scope)).map((entry) => this.linkToTarget(this.createNodeTarget(entry), `${entry.title} (${entry.kind})`))),
         ].join('\n'), [
             '## Backlinks',
             buildBulletList(incoming
@@ -483,7 +494,7 @@ export class KnowledgeProjectionService {
                 .map((edge) => `${edge.fromKind}:${edge.fromId} via \`${edge.relation}\``)),
         ].join('\n'), [
             '## Issues',
-            buildBulletList(this.store.listIssues(Number.MAX_SAFE_INTEGER)
+            buildBulletList(this.scopedIssues(scope)
                 .filter((issue) => issue.nodeId === node.id)
                 .map((issue) => this.linkToTarget(this.createIssueTarget(issue), `${issue.severity.toUpperCase()} ${issue.code}: ${issue.message}`))),
         ].join('\n'));
@@ -499,13 +510,15 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderIssuePage(id) {
+    renderIssuePage(id, scope) {
         const issue = this.store.getIssue(id);
-        if (!issue)
+        if (!issue || !isInKnowledgeSpaceScope(issue, scope))
             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 linkedSource = issue.sourceId ? this.store.getSource(issue.sourceId) : null;
+        const linkedNode = issue.nodeId ? this.store.getNode(issue.nodeId) : null;
+        const source = linkedSource && isInKnowledgeSpaceScope(linkedSource, scope) ? linkedSource : null;
+        const node = linkedNode && isInKnowledgeSpaceScope(linkedNode, scope) ? linkedNode : null;
         const content = joinSections(`# ${target.title}`, [
             '## Metadata',
             `- id: \`${issue.id}\``,
@@ -536,15 +549,15 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    renderDashboardPage(target, limit) {
+    renderDashboardPage(target, limit, scope) {
         if (target.itemId === 'backlinks') {
-            return this.renderBacklinksPage(limit);
+            return this.renderBacklinksPage(limit, scope);
         }
-        return this.renderHealthDashboardPage(limit);
+        return this.renderHealthDashboardPage(limit, scope);
     }
-    renderRollupPage(nodeId, target) {
+    renderRollupPage(nodeId, target, scope) {
         const node = this.store.getNode(nodeId);
-        if (!node)
+        if (!node || !isInKnowledgeSpaceScope(node, scope))
             throw new Error(`Unknown rollup node: ${nodeId}`);
         const edges = this.store.edgesFor('node', node.id);
         const sources = edges
@@ -555,7 +568,7 @@ export class KnowledgeProjectionService {
                 return this.store.getSource(edge.toId);
             return null;
         })
-            .filter((source) => Boolean(source));
+            .filter((source) => Boolean(source) && isInKnowledgeSpaceScope(source, scope));
         const linkedNodes = edges
             .map((edge) => {
             if (edge.fromKind === 'node' && edge.fromId !== node.id)
@@ -564,7 +577,7 @@ export class KnowledgeProjectionService {
                 return this.store.getNode(edge.toId);
             return null;
         })
-            .filter((entry) => Boolean(entry));
+            .filter((entry) => Boolean(entry) && isInKnowledgeSpaceScope(entry, scope));
         const content = joinSections(`# ${target.title}`, node.summary, [
             '## Included Sources',
             buildBulletList(sortByTitle(dedupe(sources, (source) => source.id)).map((source) => this.linkToTarget(this.createSourceTarget(source)))),
@@ -584,42 +597,46 @@ export class KnowledgeProjectionService {
             },
         };
     }
-    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));
+    renderBundleTarget(target, limit, scope) {
+        const overview = this.renderOverviewPage(this.createPresetTarget('overview', scope), limit, scope);
+        const sourceIndex = this.renderSourceIndexPage(Math.max(limit * 2, 24), scope);
+        const nodeIndex = this.renderNodeIndexPage(Math.max(limit * 2, 24), scope);
+        const issueDashboard = this.renderIssueDashboardPage(Math.max(limit * 2, 24), scope);
+        const backlinks = this.renderBacklinksPage(Math.max(limit * 2, 16), scope);
+        const health = this.renderHealthDashboardPage(Math.max(limit * 2, 16), scope);
         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 node of this.scopedNodes(scope).filter((entry) => entry.kind === 'domain' || entry.kind === 'topic').slice(0, 4)) {
+            pages.push(this.renderRollupPage(node.id, this.createRollupTarget(node), scope));
         }
-        for (const source of this.store.listSources(perKind)) {
-            pages.push(this.renderSourcePage(source.id));
+        for (const source of this.scopedSources(scope, perKind)) {
+            pages.push(this.renderSourcePage(source.id, scope));
         }
-        for (const node of this.store.listNodes(perKind)) {
-            pages.push(this.renderNodePage(node.id));
+        for (const node of this.scopedNodes(scope, perKind)) {
+            pages.push(this.renderNodePage(node.id, scope));
         }
-        for (const issue of this.store.listIssues(perKind)) {
-            pages.push(this.renderIssuePage(issue.id));
+        for (const issue of this.scopedIssues(scope, perKind)) {
+            pages.push(this.renderIssuePage(issue.id, scope));
         }
         return this.bundleFromPages(target, pages, {
             preset: 'bundle',
-            sourceCount: this.store.status().sourceCount,
-            nodeCount: this.store.status().nodeCount,
-            issueCount: this.store.status().issueCount,
-        });
+            sourceCount: this.scopedSources(scope).length,
+            nodeCount: this.scopedNodes(scope).length,
+            issueCount: this.scopedIssues(scope).length,
+        }, scope);
     }
-    bundleFromPages(target, pages, metadata) {
+    bundleFromPages(target, pages, metadata, scope) {
+        const spaceId = resolveKnowledgeSpaceScope(scope);
         return {
             id: `projection-${slugify(target.targetId)}`,
             target,
             generatedAt: Date.now(),
             pageCount: pages.length,
             pages,
-            metadata,
+            metadata: {
+                ...metadata,
+                ...(spaceId === null ? { includeAllSpaces: true } : { knowledgeSpaceId: spaceId }),
+            },
         };
     }
     linkToTarget(target, label) {
@@ -650,4 +667,49 @@ export class KnowledgeProjectionService {
         const source = this.store.getSource(id);
         return source ? isGeneratedKnowledgeSource(source) : false;
     }
+    edgeInScope(edge, scope) {
+        return this.recordReferenceInScope(edge.fromKind, edge.fromId, scope)
+            && this.recordReferenceInScope(edge.toKind, edge.toId, scope);
+    }
+    recordReferenceInScope(kind, id, scope) {
+        if (kind === 'source') {
+            const source = this.store.getSource(id);
+            return Boolean(source && isInKnowledgeSpaceScope(source, scope));
+        }
+        if (kind === 'node') {
+            const node = this.store.getNode(id);
+            return Boolean(node && isInKnowledgeSpaceScope(node, scope));
+        }
+        if (kind === 'issue') {
+            const issue = this.store.getIssue(id);
+            return Boolean(issue && isInKnowledgeSpaceScope(issue, scope));
+        }
+        return true;
+    }
+    scopedSources(scope, limit = Number.MAX_SAFE_INTEGER) {
+        return this.store.listSources(Number.MAX_SAFE_INTEGER)
+            .filter((source) => isInKnowledgeSpaceScope(source, scope))
+            .slice(0, Math.max(1, limit));
+    }
+    scopedNodes(scope, limit = Number.MAX_SAFE_INTEGER) {
+        return this.store.listNodes(Number.MAX_SAFE_INTEGER)
+            .filter((node) => isInKnowledgeSpaceScope(node, scope))
+            .slice(0, Math.max(1, limit));
+    }
+    scopedIssues(scope, limit = Number.MAX_SAFE_INTEGER) {
+        return this.store.listIssues(Number.MAX_SAFE_INTEGER)
+            .filter((issue) => isInKnowledgeSpaceScope(issue, scope))
+            .slice(0, Math.max(1, limit));
+    }
+    scopedExtractions(scope, limit = Number.MAX_SAFE_INTEGER) {
+        return this.store.listExtractions(Number.MAX_SAFE_INTEGER)
+            .filter((extraction) => isInKnowledgeSpaceScope(extraction, scope))
+            .slice(0, Math.max(1, limit));
+    }
+}
+function projectionScope(input = {}) {
+    return {
+        ...(input.knowledgeSpaceId ? { knowledgeSpaceId: input.knowledgeSpaceId } : {}),
+        ...(input.includeAllSpaces === true ? { includeAllSpaces: true } : {}),
+    };
 }