@noyrax/5d-database-plugin 0.1.0

package/out/api/bootstrap-api.d.ts

@@ -0,0 +1,43 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { EntityReference } from '../models/entity-reference';
+/**
+ * Bootstrap information for first-time system understanding.
+ * Provides everything an agent needs to start without prior knowledge.
+ */
+export interface BootstrapInfo {
+    what_am_i: string;
+    how_do_i_work: string;
+    where_to_start: Array<{
+        entity: EntityReference;
+        reason: string;
+    }>;
+    how_to_navigate: string;
+    example_queries: string[];
+    dimensions_overview: Array<{
+        id: 'X' | 'Y' | 'Z' | 'W' | 'T';
+        name: string;
+        description: string;
+    }>;
+    tools_available: Array<{
+        name: string;
+        description: string;
+        example: any;
+    }>;
+}
+/**
+ * Bootstrap API - first point of contact for agents without prior knowledge.
+ * Provides system description, entry points, and example queries.
+ */
+export declare class BootstrapApi {
+    private dbManager;
+    private selfExplanationApi;
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Gets bootstrap information for first-time system understanding.
+     *
+     * @param pluginId Plugin ID
+     * @returns Promise that resolves to bootstrap information
+     */
+    getBootstrapInfo(pluginId: string): Promise<BootstrapInfo>;
+}
+//# sourceMappingURL=bootstrap-api.d.ts.map

package/out/api/bootstrap-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-api.d.ts","sourceRoot":"","sources":["../../src/api/bootstrap-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,KAAK,CAAC;QAClB,MAAM,EAAE,eAAe,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,EAAE,KAAK,CAAC;QACvB,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,GAAG,CAAC;KAChB,CAAC,CAAC;CACN;AAED;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,SAAS,EAAE,cAAc;IAKrC;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAoEnE"}

package/out/api/bootstrap-api.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BootstrapApi = void 0;
+const self_explanation_api_1 = require("./self-explanation-api");
+/**
+ * Bootstrap API - first point of contact for agents without prior knowledge.
+ * Provides system description, entry points, and example queries.
+ */
+class BootstrapApi {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+        this.selfExplanationApi = new self_explanation_api_1.SelfExplanationApi(dbManager);
+    }
+    /**
+     * Gets bootstrap information for first-time system understanding.
+     *
+     * @param pluginId Plugin ID
+     * @returns Promise that resolves to bootstrap information
+     */
+    async getBootstrapInfo(pluginId) {
+        // Get system explanation
+        const systemExplanation = await this.selfExplanationApi.explainSystem(pluginId);
+        // Get entry points with reasons
+        const entryPoints = systemExplanation.entry_points.map(ep => ({
+            entity: {
+                dimension: ep.dimension,
+                entity_id: ep.entity_id,
+                external_id: ep.external_id
+            },
+            reason: ep.reason || 'Entry point'
+        }));
+        return {
+            what_am_i: systemExplanation.what_am_i,
+            how_do_i_work: systemExplanation.how_do_i_work,
+            where_to_start: entryPoints,
+            how_to_navigate: 'Use semantic_discovery tool with natural language queries. The system will find relevant entities and provide structured context from all 5 dimensions.',
+            example_queries: [
+                'How does ingestion work?',
+                'What are the main components?',
+                'How do I add a new dimension?',
+                'What is the architecture?',
+                'How do dependencies work?',
+                'How does the database system work?',
+                'What are the entry points?',
+                'How do I navigate the codebase?'
+            ],
+            dimensions_overview: systemExplanation.dimensions.map(dim => ({
+                id: dim.id,
+                name: dim.name,
+                description: dim.description
+            })),
+            tools_available: [
+                {
+                    name: 'semantic_discovery',
+                    description: 'Semantic search and context retrieval for LLM understanding',
+                    example: {
+                        query: 'How does ingestion work?',
+                        pluginId
+                    }
+                },
+                {
+                    name: 'system_explanation',
+                    description: 'Get system overview, entry points, and architecture ADRs',
+                    example: {
+                        pluginId
+                    }
+                },
+                {
+                    name: 'learning_path',
+                    description: 'Generate guided learning path for understanding a topic',
+                    example: {
+                        topic: 'ingestion',
+                        pluginId
+                    }
+                },
+                {
+                    name: 'bootstrap',
+                    description: 'Get bootstrap information for first-time system understanding (no prior knowledge required)',
+                    example: {
+                        pluginId
+                    }
+                }
+            ]
+        };
+    }
+}
+exports.BootstrapApi = BootstrapApi;
+//# sourceMappingURL=bootstrap-api.js.map

package/out/api/bootstrap-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-api.js","sourceRoot":"","sources":["../../src/api/bootstrap-api.ts"],"names":[],"mappings":";;;AACA,iEAA4D;AA4B5D;;;GAGG;AACH,MAAa,YAAY;IAIrB,YAAY,SAAyB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,kBAAkB,GAAG,IAAI,yCAAkB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACnC,yBAAyB;QACzB,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEhF,gCAAgC;QAChC,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1D,MAAM,EAAE;gBACJ,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,WAAW,EAAE,EAAE,CAAC,WAAW;aAC9B;YACD,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,aAAa;SACrC,CAAC,CAAC,CAAC;QAEJ,OAAO;YACH,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,cAAc,EAAE,WAAW;YAC3B,eAAe,EAAE,yJAAyJ;YAC1K,eAAe,EAAE;gBACb,0BAA0B;gBAC1B,+BAA+B;gBAC/B,+BAA+B;gBAC/B,2BAA2B;gBAC3B,2BAA2B;gBAC3B,oCAAoC;gBACpC,4BAA4B;gBAC5B,iCAAiC;aACpC;YACD,mBAAmB,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1D,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,WAAW,EAAE,GAAG,CAAC,WAAW;aAC/B,CAAC,CAAC;YACH,eAAe,EAAE;gBACb;oBACI,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EAAE,6DAA6D;oBAC1E,OAAO,EAAE;wBACL,KAAK,EAAE,0BAA0B;wBACjC,QAAQ;qBACX;iBACJ;gBACD;oBACI,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EAAE,0DAA0D;oBACvE,OAAO,EAAE;wBACL,QAAQ;qBACX;iBACJ;gBACD;oBACI,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,yDAAyD;oBACtE,OAAO,EAAE;wBACL,KAAK,EAAE,WAAW;wBAClB,QAAQ;qBACX;iBACJ;gBACD;oBACI,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,6FAA6F;oBAC1G,OAAO,EAAE;wBACL,QAAQ;qBACX;iBACJ;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AAnFD,oCAmFC"}

package/out/api/change-api.d.ts

@@ -0,0 +1,30 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { ChangeReport, SymbolChange, DependencyChange } from '../models/change';
+/**
+ * API for T-Dimension: Changes
+ */
+export declare class ChangeApi {
+    private dbManager;
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Gets all change reports for a plugin.
+     */
+    getAllChangeReports(pluginId: string): Promise<ChangeReport[]>;
+    /**
+     * Gets the latest change report for a plugin.
+     */
+    getLatestChangeReport(pluginId: string): Promise<ChangeReport | null>;
+    /**
+     * Gets symbol changes for a report.
+     */
+    getSymbolChanges(reportId: string): Promise<SymbolChange[]>;
+    /**
+     * Gets dependency changes for a report.
+     */
+    getDependencyChanges(reportId: string): Promise<DependencyChange[]>;
+    /**
+     * Gets a change report by ID.
+     */
+    getChangeReportById(id: string, pluginId: string): Promise<ChangeReport | null>;
+}
+//# sourceMappingURL=change-api.d.ts.map

package/out/api/change-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-api.d.ts","sourceRoot":"","sources":["../../src/api/change-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,EAAE,cAAc;IAIrC;;OAEG;IACU,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM3E;;OAEG;IACU,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMlF;;OAEG;IACU,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMxE;;OAEG;IACU,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMhF;;OAEG;IACU,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAK/F"}

package/out/api/change-api.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangeApi = void 0;
+const change_repository_1 = require("../repositories/change-repository");
+/**
+ * API for T-Dimension: Changes
+ */
+class ChangeApi {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+    }
+    /**
+     * Gets all change reports for a plugin.
+     */
+    async getAllChangeReports(pluginId) {
+        const db = await this.dbManager.getDatabase('T');
+        const repository = new change_repository_1.ChangeRepository(db);
+        return repository.getAll(pluginId);
+    }
+    /**
+     * Gets the latest change report for a plugin.
+     */
+    async getLatestChangeReport(pluginId) {
+        const db = await this.dbManager.getDatabase('T');
+        const repository = new change_repository_1.ChangeRepository(db);
+        return repository.getLatest(pluginId);
+    }
+    /**
+     * Gets symbol changes for a report.
+     */
+    async getSymbolChanges(reportId) {
+        const db = await this.dbManager.getDatabase('T');
+        const repository = new change_repository_1.ChangeRepository(db);
+        return repository.getSymbolChanges(reportId);
+    }
+    /**
+     * Gets dependency changes for a report.
+     */
+    async getDependencyChanges(reportId) {
+        const db = await this.dbManager.getDatabase('T');
+        const repository = new change_repository_1.ChangeRepository(db);
+        return repository.getDependencyChanges(reportId);
+    }
+    /**
+     * Gets a change report by ID.
+     */
+    async getChangeReportById(id, pluginId) {
+        const db = await this.dbManager.getDatabase('T');
+        const repository = new change_repository_1.ChangeRepository(db);
+        return repository.getById(id, pluginId);
+    }
+}
+exports.ChangeApi = ChangeApi;
+//# sourceMappingURL=change-api.js.map

package/out/api/change-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-api.js","sourceRoot":"","sources":["../../src/api/change-api.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAGrE;;GAEG;AACH,MAAa,SAAS;IAGlB,YAAY,SAAyB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QAC7C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,qBAAqB,CAAC,QAAgB;QAC/C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QAC1C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QAC9C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,EAAU,EAAE,QAAgB;QACzD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACJ;AAnDD,8BAmDC"}

package/out/api/context-builder.d.ts

@@ -0,0 +1,81 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { IdMapper } from '../core/id-mapper';
+import { EntityReference } from '../models/entity-reference';
+/**
+ * Structured context for an entity or set of entities.
+ * Contains all relevant information from 5D-DBs WITHOUT AI generation.
+ */
+export interface StructuredContext {
+    entities: Array<{
+        dimension: 'X' | 'Y' | 'Z' | 'W' | 'T';
+        entityId: string;
+        externalId: string;
+        details: any;
+    }>;
+    related: Array<{
+        entityRef: EntityReference;
+        relationship: string;
+    }>;
+    adrs: Array<{
+        adr_number: string;
+        title: string;
+        content_preview: string;
+    }>;
+    dependencies: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    entryPoints: Array<EntityReference>;
+}
+/**
+ * Builds structured, deterministic context from 5D-DBs.
+ * NO AI generation - only data from databases.
+ */
+export declare class ContextBuilder {
+    private dbManager;
+    private crossDimensionApi;
+    private moduleApi;
+    private symbolApi;
+    private dependencyApi;
+    private adrApi;
+    private changeApi;
+    constructor(dbManager: MultiDbManager, idMapper: IdMapper);
+    /**
+     * Builds structured context for a set of entity references.
+     *
+     * @param entityRefs Entity references to build context for
+     * @param pluginId Plugin ID
+     * @returns Promise that resolves to structured context
+     */
+    buildContext(entityRefs: EntityReference[], pluginId: string): Promise<StructuredContext>;
+    /**
+     * Gets entity details from the corresponding dimension.
+     */
+    private getEntityDetails;
+    /**
+     * Gets related entities via CrossDimensionApi.
+     */
+    private getRelatedEntities;
+    /**
+     * Gets relevant ADRs for an entity.
+     */
+    private getRelevantAdrs;
+    /**
+     * Gets dependencies for an entity.
+     */
+    private getDependencies;
+    /**
+     * Gets entry points for the system.
+     */
+    private getEntryPoints;
+    /**
+     * Deduplicates ADRs by adr_number.
+     */
+    private deduplicateAdrs;
+    /**
+     * Deduplicates dependencies by from+to+type.
+     */
+    private deduplicateDependencies;
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/out/api/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/api/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQ7C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAO7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,eAAe,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,EAAE,KAAK,CAAC;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ;IAUzD;;;;;;OAMG;IACG,YAAY,CACd,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAiD7B;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;YACW,kBAAkB;IAwEhC;;OAEG;YACW,eAAe;IAoC7B;;OAEG;YACW,eAAe;IA4C7B;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgBlC"}

package/out/api/context-builder.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextBuilder = void 0;
+const cross_dimension_api_1 = require("./cross-dimension-api");
+const module_api_1 = require("./module-api");
+const symbol_api_1 = require("./symbol-api");
+const dependency_api_1 = require("./dependency-api");
+const adr_api_1 = require("./adr-api");
+const change_api_1 = require("./change-api");
+const navigation_repository_1 = require("../repositories/navigation-repository");
+/**
+ * Builds structured, deterministic context from 5D-DBs.
+ * NO AI generation - only data from databases.
+ */
+class ContextBuilder {
+    constructor(dbManager, idMapper) {
+        this.dbManager = dbManager;
+        this.crossDimensionApi = new cross_dimension_api_1.CrossDimensionApi(dbManager, idMapper);
+        this.moduleApi = new module_api_1.ModuleApi(dbManager);
+        this.symbolApi = new symbol_api_1.SymbolApi(dbManager);
+        this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
+        this.adrApi = new adr_api_1.AdrApi(dbManager);
+        this.changeApi = new change_api_1.ChangeApi(dbManager);
+    }
+    /**
+     * Builds structured context for a set of entity references.
+     *
+     * @param entityRefs Entity references to build context for
+     * @param pluginId Plugin ID
+     * @returns Promise that resolves to structured context
+     */
+    async buildContext(entityRefs, pluginId) {
+        const entities = [];
+        const related = [];
+        const adrs = [];
+        const dependencies = [];
+        const entryPoints = [];
+        // 1. Get entity details from corresponding dimensions
+        for (const entityRef of entityRefs) {
+            // Skip V-dimension entities (they're metadata, not content)
+            if (entityRef.dimension === 'V') {
+                continue;
+            }
+            const details = await this.getEntityDetails(entityRef, pluginId);
+            if (details) {
+                entities.push({
+                    dimension: entityRef.dimension,
+                    entityId: entityRef.entity_id,
+                    externalId: entityRef.external_id,
+                    details
+                });
+                // 2. Get related entities via CrossDimensionApi
+                const relatedEntities = await this.getRelatedEntities(entityRef, pluginId);
+                related.push(...relatedEntities);
+                // 3. Get relevant ADRs
+                const entityAdrs = await this.getRelevantAdrs(entityRef, pluginId);
+                adrs.push(...entityAdrs);
+                // 4. Get dependencies
+                const entityDeps = await this.getDependencies(entityRef, pluginId);
+                dependencies.push(...entityDeps);
+            }
+        }
+        // 5. Get entry points
+        const entryPointsList = await this.getEntryPoints(pluginId);
+        entryPoints.push(...entryPointsList);
+        return {
+            entities,
+            related,
+            adrs: this.deduplicateAdrs(adrs),
+            dependencies: this.deduplicateDependencies(dependencies),
+            entryPoints
+        };
+    }
+    /**
+     * Gets entity details from the corresponding dimension.
+     */
+    async getEntityDetails(entityRef, pluginId) {
+        switch (entityRef.dimension) {
+            case 'X': {
+                const module = await this.moduleApi.getModuleById(entityRef.entity_id, pluginId);
+                return module;
+            }
+            case 'Y': {
+                const symbol = await this.symbolApi.getSymbolById(entityRef.external_id, pluginId);
+                return symbol;
+            }
+            case 'Z': {
+                const dependency = await this.dependencyApi.getDependencyById(entityRef.entity_id, pluginId);
+                return dependency;
+            }
+            case 'W': {
+                const adr = await this.adrApi.getAdrByNumber(entityRef.external_id, pluginId);
+                return adr;
+            }
+            case 'T': {
+                const changeReport = await this.changeApi.getChangeReportById(entityRef.entity_id, pluginId);
+                return changeReport;
+            }
+        }
+    }
+    /**
+     * Gets related entities via CrossDimensionApi.
+     */
+    async getRelatedEntities(entityRef, pluginId) {
+        const related = [];
+        switch (entityRef.dimension) {
+            case 'X': {
+                // Module → Symbols
+                const module = await this.moduleApi.getModuleById(entityRef.entity_id, pluginId);
+                if (module) {
+                    const symbols = await this.crossDimensionApi.getSymbolsForModule(module.file_path, pluginId);
+                    for (const symbolRef of symbols) {
+                        related.push({ entityRef: symbolRef, relationship: 'contains' });
+                    }
+                }
+                break;
+            }
+            case 'Y': {
+                // Symbol → Module
+                const symbol = await this.symbolApi.getSymbolById(entityRef.external_id, pluginId);
+                if (symbol) {
+                    const moduleRef = await this.crossDimensionApi.resolveSymbolToModule(entityRef.external_id, pluginId);
+                    if (moduleRef) {
+                        related.push({ entityRef: moduleRef, relationship: 'belongs_to' });
+                    }
+                }
+                break;
+            }
+            case 'Z': {
+                // Dependency → From/To Modules
+                const dependency = await this.dependencyApi.getDependencyById(entityRef.entity_id, pluginId);
+                if (dependency) {
+                    const fromModule = await this.moduleApi.getModuleByPath(dependency.from_module, pluginId);
+                    const toModule = await this.moduleApi.getModuleByPath(dependency.to_module, pluginId);
+                    if (fromModule) {
+                        related.push({
+                            entityRef: {
+                                dimension: 'X',
+                                entity_id: fromModule.id,
+                                external_id: fromModule.file_path
+                            },
+                            relationship: 'from_module'
+                        });
+                    }
+                    if (toModule) {
+                        related.push({
+                            entityRef: {
+                                dimension: 'X',
+                                entity_id: toModule.id,
+                                external_id: toModule.file_path
+                            },
+                            relationship: 'to_module'
+                        });
+                    }
+                }
+                break;
+            }
+            case 'W': {
+                // ADR → Referenced Files
+                const adr = await this.adrApi.getAdrByNumber(entityRef.external_id, pluginId);
+                if (adr) {
+                    const fileAdrs = await this.adrApi.getAdrsByFilePath('', pluginId); // Get all for now
+                    // Filter by ADR file mappings would be better, but this is a start
+                }
+                break;
+            }
+        }
+        return related;
+    }
+    /**
+     * Gets relevant ADRs for an entity.
+     */
+    async getRelevantAdrs(entityRef, pluginId) {
+        const adrs = [];
+        // Get navigation metadata for related ADRs
+        // Only for X, Y, Z, W, T dimensions (not V)
+        if (entityRef.dimension === 'V') {
+            return [];
+        }
+        const db = await this.dbManager.getDatabase('V');
+        const navRepo = new navigation_repository_1.NavigationRepository(db);
+        const metadata = await navRepo.getByEntity(entityRef.dimension, entityRef.entity_id, pluginId);
+        if (metadata && metadata.related_adrs) {
+            try {
+                const adrNumbers = JSON.parse(metadata.related_adrs);
+                for (const adrNumber of adrNumbers) {
+                    const adr = await this.adrApi.getAdrByNumber(adrNumber, pluginId);
+                    if (adr) {
+                        adrs.push({
+                            adr_number: adr.adr_number,
+                            title: adr.title,
+                            content_preview: adr.content_markdown.substring(0, 500)
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                console.warn(`[ContextBuilder] Failed to parse related ADRs: ${error}`);
+            }
+        }
+        return adrs;
+    }
+    /**
+     * Gets dependencies for an entity.
+     */
+    async getDependencies(entityRef, pluginId) {
+        const dependencies = [];
+        switch (entityRef.dimension) {
+            case 'X': {
+                // Module dependencies
+                const module = await this.moduleApi.getModuleById(entityRef.entity_id, pluginId);
+                if (module) {
+                    const deps = await this.dependencyApi.getDependenciesByFromModule(module.file_path, pluginId);
+                    for (const dep of deps) {
+                        dependencies.push({
+                            from: dep.from_module,
+                            to: dep.to_module,
+                            type: dep.dependency_type
+                        });
+                    }
+                }
+                break;
+            }
+            case 'Z': {
+                // Dependency itself
+                const dependency = await this.dependencyApi.getDependencyById(entityRef.entity_id, pluginId);
+                if (dependency) {
+                    dependencies.push({
+                        from: dependency.from_module,
+                        to: dependency.to_module,
+                        type: dependency.dependency_type
+                    });
+                }
+                break;
+            }
+            case 'Y':
+            case 'W':
+            case 'T':
+                // No dependencies for these dimensions
+                break;
+        }
+        return dependencies;
+    }
+    /**
+     * Gets entry points for the system.
+     */
+    async getEntryPoints(pluginId) {
+        const db = await this.dbManager.getDatabase('V');
+        const navRepo = new navigation_repository_1.NavigationRepository(db);
+        const entryPoints = await navRepo.getEntryPoints('X', pluginId);
+        return entryPoints.map(ep => ({
+            dimension: ep.dimension,
+            entity_id: ep.entity_id,
+            external_id: '' // Will be resolved from module
+        }));
+    }
+    /**
+     * Deduplicates ADRs by adr_number.
+     */
+    deduplicateAdrs(adrs) {
+        const seen = new Set();
+        const unique = [];
+        for (const adr of adrs) {
+            if (!seen.has(adr.adr_number)) {
+                seen.add(adr.adr_number);
+                unique.push(adr);
+            }
+        }
+        return unique;
+    }
+    /**
+     * Deduplicates dependencies by from+to+type.
+     */
+    deduplicateDependencies(deps) {
+        const seen = new Set();
+        const unique = [];
+        for (const dep of deps) {
+            const key = `${dep.from}→${dep.to}[${dep.type}]`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(dep);
+            }
+        }
+        return unique;
+    }
+}
+exports.ContextBuilder = ContextBuilder;
+//# sourceMappingURL=context-builder.js.map

package/out/api/context-builder.js.map

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

package/out/api/cross-dimension-api.d.ts

@@ -0,0 +1,43 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { IdMapper } from '../core/id-mapper';
+import { EntityReference } from '../models/entity-reference';
+/**
+ * API for cross-dimension queries.
+ * Combines data from multiple dimensions.
+ */
+export declare class CrossDimensionApi {
+    private dbManager;
+    private idMapper;
+    private linker;
+    private systemBuilder;
+    constructor(dbManager: MultiDbManager, idMapper: IdMapper);
+    /**
+     * Resolves a symbol ID to its module reference.
+     */
+    resolveSymbolToModule(symbolId: string, pluginId: string): Promise<EntityReference | null>;
+    /**
+     * Gets all ADRs that reference a specific file path.
+     */
+    getAdrsForFilePath(filePath: string, pluginId: string): Promise<EntityReference[]>;
+    /**
+     * Gets all symbols for a module.
+     */
+    getSymbolsForModule(filePath: string, pluginId: string): Promise<EntityReference[]>;
+    /**
+     * Builds a module dependency graph.
+     */
+    buildModuleDependencyGraph(pluginId: string): Promise<Map<string, string[]>>;
+    /**
+     * Builds a symbol dependency tree for a file.
+     */
+    buildSymbolDependencyTree(filePath: string, pluginId: string): Promise<Map<string, string[]>>;
+    /**
+     * Builds an architectural view combining modules, ADRs, and dependencies.
+     */
+    buildArchitecturalView(pluginId: string): Promise<Array<{
+        module: any;
+        adrs: any[];
+        dependencies: any[];
+    }>>;
+}
+//# sourceMappingURL=cross-dimension-api.d.ts.map