@noyrax/5d-database-plugin 0.1.14-beta.5 → 0.1.14-beta.8

package/out/api/index.js

@@ -5,7 +5,7 @@
  * This file exports all APIs that can be used from npm package installations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocsPathResolver = exports.IdMapper = exports.MultiDbManager = exports.ContextBuilder = exports.IngestionApi = exports.VectorApi = exports.LearningPathApi = exports.SelfExplanationApi = exports.BootstrapApi = exports.SearchApi = exports.SemanticSearchApi = exports.CrossDimensionApi = exports.ChangeApi = exports.AdrApi = exports.DependencyApi = exports.SymbolApi = exports.ModuleApi = void 0;
+exports.getAllActionHints = exports.getActionHintsForOS = exports.createActionHint = exports.getReasonCodeDescription = exports.parseReasonCode = exports.ReasonCode = exports.DocsPathResolver = exports.IdMapper = exports.MultiDbManager = exports.ContextBuilder = exports.VectorBackendStatusApi = exports.IngestionApi = exports.VectorApi = exports.LearningPathApi = exports.SelfExplanationApi = exports.BootstrapApi = exports.SearchApi = exports.SemanticSearchApi = exports.CrossDimensionApi = exports.ChangeApi = exports.AdrApi = exports.DependencyApi = exports.SymbolApi = exports.ModuleApi = void 0;
 var module_api_1 = require("./module-api");
 Object.defineProperty(exports, "ModuleApi", { enumerable: true, get: function () { return module_api_1.ModuleApi; } });
 var symbol_api_1 = require("./symbol-api");
@@ -32,6 +32,8 @@ var vector_api_1 = require("./vector-api");
 Object.defineProperty(exports, "VectorApi", { enumerable: true, get: function () { return vector_api_1.VectorApi; } });
 var ingestion_api_1 = require("./ingestion-api");
 Object.defineProperty(exports, "IngestionApi", { enumerable: true, get: function () { return ingestion_api_1.IngestionApi; } });
+var vector_backend_status_api_1 = require("./vector-backend-status-api");
+Object.defineProperty(exports, "VectorBackendStatusApi", { enumerable: true, get: function () { return vector_backend_status_api_1.VectorBackendStatusApi; } });
 var context_builder_1 = require("./context-builder");
 Object.defineProperty(exports, "ContextBuilder", { enumerable: true, get: function () { return context_builder_1.ContextBuilder; } });
 // Core classes needed for API initialization
@@ -41,4 +43,12 @@ var id_mapper_1 = require("../core/id-mapper");
 Object.defineProperty(exports, "IdMapper", { enumerable: true, get: function () { return id_mapper_1.IdMapper; } });
 var docs_path_resolver_1 = require("../core/docs-path-resolver");
 Object.defineProperty(exports, "DocsPathResolver", { enumerable: true, get: function () { return docs_path_resolver_1.DocsPathResolver; } });
+var reason_codes_1 = require("../models/reason-codes");
+Object.defineProperty(exports, "ReasonCode", { enumerable: true, get: function () { return reason_codes_1.ReasonCode; } });
+Object.defineProperty(exports, "parseReasonCode", { enumerable: true, get: function () { return reason_codes_1.parseReasonCode; } });
+Object.defineProperty(exports, "getReasonCodeDescription", { enumerable: true, get: function () { return reason_codes_1.getReasonCodeDescription; } });
+var action_hint_1 = require("../models/action-hint");
+Object.defineProperty(exports, "createActionHint", { enumerable: true, get: function () { return action_hint_1.createActionHint; } });
+Object.defineProperty(exports, "getActionHintsForOS", { enumerable: true, get: function () { return action_hint_1.getActionHintsForOS; } });
+Object.defineProperty(exports, "getAllActionHints", { enumerable: true, get: function () { return action_hint_1.getAllActionHints; } });
 //# sourceMappingURL=index.js.map

package/out/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,iGAAA,MAAM,OAAA;AACf,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,6CAA6C;AAC7C,6DAAqE;AAA5D,kHAAA,cAAc,OAAA;AACvB,+CAA6C;AAApC,qGAAA,QAAQ,OAAA;AACjB,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,iGAAA,MAAM,OAAA;AACf,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAE/B,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,6CAA6C;AAC7C,6DAAqE;AAA5D,kHAAA,cAAc,OAAA;AACvB,+CAA6C;AAApC,qGAAA,QAAQ,OAAA;AACjB,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA;AASzB,uDAA+F;AAAtF,0GAAA,UAAU,OAAA;AAAE,+GAAA,eAAe,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAE9D,qDAAiG;AAAxF,+GAAA,gBAAgB,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}

package/out/api/learning-path-api.d.ts

@@ -1,6 +1,7 @@
 import { MultiDbManager } from '../core/multi-db-manager';
 import { SemanticSearchApi } from './semantic-search-api';
 import { EntityReference } from '../models/entity-reference';
+import { Evidence } from '../models/evidence';
 /**
  * Learning path step
  */
@@ -17,6 +18,7 @@ export interface LearningPath {
     topic: string;
     path: LearningPathStep[];
     estimated_time?: string;
+    evidence?: Evidence;
 }
 /**
  * Generates guided learning paths for agents.
@@ -28,6 +30,7 @@ export declare class LearningPathApi {
     private dependencyApi;
     private moduleApi;
     private adrApi;
+    private evidenceGrader;
     constructor(dbManager: MultiDbManager, semanticSearchApi: SemanticSearchApi);
     /**
      * Generates a learning path for a topic.

package/out/api/learning-path-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learning-path-api.d.ts","sourceRoot":"","sources":["../../src/api/learning-path-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AAKhF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAGnB,SAAS,EAAE,cAAc,EACzB,iBAAiB,EAAE,iBAAiB;IASxC;;;;;;OAMG;IACG,oBAAoB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;IAgCxB;;OAEG;YACW,eAAe;IAsC7B;;OAEG;YACW,mBAAmB;CA+FpC"}
+{"version":3,"file":"learning-path-api.d.ts","sourceRoot":"","sources":["../../src/api/learning-path-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AAKhF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;gBAGnC,SAAS,EAAE,cAAc,EACzB,iBAAiB,EAAE,iBAAiB;IAUxC;;;;;;OAMG;IACG,oBAAoB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;IA8CxB;;OAEG;YACW,eAAe;IAsC7B;;OAEG;YACW,mBAAmB;CA+FpC"}

package/out/api/learning-path-api.js

@@ -5,6 +5,7 @@ const dependency_api_1 = require("./dependency-api");
 const module_api_1 = require("./module-api");
 const adr_api_1 = require("./adr-api");
 const navigation_repository_1 = require("../repositories/navigation-repository");
+const evidence_grader_1 = require("./evidence-grader");
 /**
  * Generates guided learning paths for agents.
  * Provides step-by-step guidance based on topic/query.
@@ -16,6 +17,7 @@ class LearningPathApi {
         this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
         this.moduleApi = new module_api_1.ModuleApi(dbManager);
         this.adrApi = new adr_api_1.AdrApi(dbManager);
+        this.evidenceGrader = new evidence_grader_1.EvidenceGrader();
     }
     /**
      * Generates a learning path for a topic.
@@ -25,7 +27,6 @@ class LearningPathApi {
      * @returns Promise that resolves to a learning path
      */
     async generateLearningPath(topic, pluginId) {
-        console.log(`[LearningPathApi] Generating learning path for topic: "${topic}"`);
         // 1. Semantic search for topic
         const relevantEntities = await this.semanticSearchApi.search(topic, pluginId, {
             limit: 20
@@ -43,10 +44,22 @@ class LearningPathApi {
         const path = await this.buildDependencyPath(entryPoints, relevantEntities, pluginId);
         // 4. Estimate time (rough: 2-3 minutes per step)
         const estimatedTime = path.length > 0 ? `${path.length * 2}-${path.length * 3} minutes` : '0 minutes';
+        // Create evidence: INFERRED from semantic search and dependency analysis
+        const evidence = this.evidenceGrader.gradeAsInferred([
+            {
+                type: 'DB_QUERY',
+                path: 'semantic_search'
+            },
+            {
+                type: 'DB_QUERY',
+                path: 'dependency_analysis'
+            }
+        ], 'Learning path derived from semantic search results and dependency analysis');
         return {
             topic,
             path,
-            estimated_time: estimatedTime
+            estimated_time: estimatedTime,
+            evidence
         };
     }
     /**

package/out/api/learning-path-api.js.map

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

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

@@ -28,7 +28,6 @@ export declare class ModuleApi {
      * - With/without plugin prefixes
      * - Different separators (normalized to /)
      */
-    private normalizeFilePath;
     /**
      * Gets all modules for a plugin.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"module-api.d.ts","sourceRoot":"","sources":["../../src/api/module-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,EAAE,cAAc;IAIrC;;OAEG;IACU,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMhF;;;;;;;OAOG;IACU,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BxF;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACU,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM/D;;OAEG;IACU,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAKjG"}
+{"version":3,"file":"module-api.d.ts","sourceRoot":"","sources":["../../src/api/module-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,EAAE,cAAc;IAIrC;;OAEG;IACU,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMhF;;;;;;;OAOG;IACU,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA6BxF;;;;;;;;OAQG;IAEH;;OAEG;IACU,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM/D;;OAEG;IACU,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAKjG"}

package/out/api/module-api.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModuleApi = void 0;
 const module_repository_1 = require("../repositories/module-repository");
+const path_normalizer_1 = require("../core/path-normalizer");
 /**
  * API for X-Dimension: Modules
  */
@@ -34,7 +35,7 @@ class ModuleApi {
             return module;
         }
         // Generate normalized path variants
-        const pathVariants = this.normalizeFilePath(filePath);
+        const pathVariants = path_normalizer_1.PathNormalizer.generateLookupVariants(filePath);
         // Try each variant
         for (const variant of pathVariants) {
             module = await repository.getByFilePath(variant, pluginId);
@@ -43,7 +44,8 @@ class ModuleApi {
             }
         }
         // Fallback: Try LIKE search with normalized path
-        const normalized = this.normalizeFilePath(filePath)[0]; // First variant (most normalized)
+        const variants = path_normalizer_1.PathNormalizer.generateLookupVariants(filePath);
+        const normalized = variants[0]; // First variant (most normalized)
         module = await repository.findByFilePathLike(normalized, pluginId);
         return module;
     }
@@ -56,42 +58,6 @@ class ModuleApi {
      * - With/without plugin prefixes
      * - Different separators (normalized to /)
      */
-    normalizeFilePath(filePath) {
-        const variants = [];
-        // Normalize separators to forward slashes
-        let normalized = filePath.replace(/\\/g, '/');
-        variants.push(normalized);
-        // Remove leading slashes
-        const withoutLeadingSlash = normalized.replace(/^\/+/, '');
-        if (withoutLeadingSlash !== normalized) {
-            variants.push(withoutLeadingSlash);
-        }
-        const pluginPrefixes = ['5d-database-plugin/', 'documentation-system-plugin/', 'mcp-server/'];
-        // Remove common plugin prefixes (e.g., "5d-database-plugin/")
-        for (const prefix of pluginPrefixes) {
-            if (normalized.startsWith(prefix)) {
-                const withoutPrefix = normalized.substring(prefix.length);
-                variants.push(withoutPrefix);
-            }
-            // Also try without leading slash
-            if (withoutLeadingSlash.startsWith(prefix)) {
-                const withoutPrefix = withoutLeadingSlash.substring(prefix.length);
-                variants.push(withoutPrefix);
-            }
-        }
-        // ADD variants WITH plugin prefixes (if path doesn't already have one)
-        // This handles cases where modules are stored with plugin prefix but queried without
-        const hasPluginPrefix = pluginPrefixes.some(prefix => normalized.startsWith(prefix) || withoutLeadingSlash.startsWith(prefix));
-        if (!hasPluginPrefix) {
-            // Add variants with each plugin prefix
-            for (const prefix of pluginPrefixes) {
-                variants.push(`${prefix}${withoutLeadingSlash}`);
-                variants.push(`${prefix}${normalized}`);
-            }
-        }
-        // Remove duplicates and return
-        return Array.from(new Set(variants));
-    }
     /**
      * Gets all modules for a plugin.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"module-api.js","sourceRoot":"","sources":["../../src/api/module-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module-api.js","sourceRoot":"","sources":["../../src/api/module-api.ts"],"names":[],"mappings":";;;AAEA,yEAAqE;AAErE,6DAAyD;AAEzD;;GAEG;AACH,MAAa,SAAS;IAGlB,YAAY,SAAyB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CAAC,EAAU,EAAE,QAAgB;QACnD,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;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,QAAgB;QAC3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,oCAAgB,CAAC,EAAE,CAAC,CAAC;QAE5C,wBAAwB;QACxB,IAAI,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChE,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,gCAAc,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAErE,mBAAmB;QACnB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC3D,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,gCAAc,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,kCAAkC;QAClE,MAAM,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEnE,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IAEH;;OAEG;IACI,KAAK,CAAC,aAAa,CAAC,QAAgB;QACvC,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,uBAAuB,CAAC,WAAmB,EAAE,QAAgB;QACtE,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,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACJ;AAhFD,8BAgFC"}

package/out/api/self-explanation-api.d.ts

@@ -1,5 +1,6 @@
 import { MultiDbManager } from '../core/multi-db-manager';
 import { EntityReference } from '../models/entity-reference';
+import { Evidence } from '../models/evidence';
 /**
  * System explanation interface.
  * Describes what the system is, how it works, and entry points.
@@ -8,7 +9,7 @@ export interface SystemExplanation {
     what_am_i: string;
     how_do_i_work: string;
     dimensions: Array<{
-        id: 'X' | 'Y' | 'Z' | 'W' | 'T';
+        id: 'X' | 'Y' | 'Z' | 'W' | 'T' | 'V';
         name: string;
         description: string;
         entity_count?: number;
@@ -21,6 +22,7 @@ export interface SystemExplanation {
         title: string;
     }>;
     suggested_start: string;
+    evidence?: Evidence;
 }
 /**
  * System overview interface.
@@ -38,6 +40,7 @@ export interface SystemOverview {
         adr_number: string;
         title: string;
     }>;
+    evidence?: Evidence;
 }
 /**
  * API for system self-explanation.
@@ -50,6 +53,7 @@ export declare class SelfExplanationApi {
     private symbolApi;
     private dependencyApi;
     private changeApi;
+    private evidenceGrader;
     constructor(dbManager: MultiDbManager);
     /**
      * Gets system overview with statistics and entry points.
@@ -57,6 +61,7 @@ export declare class SelfExplanationApi {
     getSystemOverview(pluginId: string): Promise<SystemOverview>;
     /**
      * Explains the system: what it is, how it works, entry points, and architecture ADRs.
+     * REQUIRED: Must NOT throw if DB files/tables are missing. If DB queries fail, treat as Mode A (No Data).
      */
     explainSystem(pluginId: string): Promise<SystemExplanation>;
     /**
@@ -67,5 +72,10 @@ export declare class SelfExplanationApi {
      * Gets architecture ADRs (typically ADR-001, ADR-002, etc.).
      */
     private getArchitectureAdrs;
+    /**
+     * Identifies the system by reading package.json, README.md, or inferring from data.
+     * Returns system name, description, source, evidence grade, and source path (for FACT sources).
+     */
+    private identifySystem;
 }
 //# sourceMappingURL=self-explanation-api.d.ts.map

package/out/api/self-explanation-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-explanation-api.d.ts","sourceRoot":"","sources":["../../src/api/self-explanation-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,cAAc;IASrC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyBlE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8DjE;;OAEG;YACW,cAAc;IAsB5B;;OAEG;YACW,mBAAmB;CAsBpC"}
+{"version":3,"file":"self-explanation-api.d.ts","sourceRoot":"","sources":["../../src/api/self-explanation-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAQ1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QACtC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAiB;gBAE3B,SAAS,EAAE,cAAc;IAUrC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqDlE;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6KjE;;OAEG;YACW,cAAc;IAsB5B;;OAEG;YACW,mBAAmB;IAuBjC;;;OAGG;YACW,cAAc;CAsI/B"}