kibi-cli 0.5.0 → 0.6.0

package/dist/extractors/manifest.js

@@ -74,23 +74,25 @@ function extractFromParsedManifest(manifest, filePath) {
             throw new ManifestError("Missing required field: title", filePath);
         }
         const id = symbol.id || generateId(filePath, symbol.title);
+        const entity = {
+            id,
+            type: "symbol",
+            title: symbol.title,
+            status: symbol.status || "active",
+            created_at: symbol.created_at || new Date().toISOString(),
+            updated_at: symbol.updated_at || new Date().toISOString(),
+            source: filePath,
+            ...(symbol.tags !== undefined ? { tags: symbol.tags } : {}),
+            ...(symbol.owner !== undefined ? { owner: symbol.owner } : {}),
+            ...(symbol.priority !== undefined ? { priority: symbol.priority } : {}),
+            ...(symbol.severity !== undefined ? { severity: symbol.severity } : {}),
+            ...(symbol.text_ref !== undefined ? { text_ref: symbol.text_ref } : {}),
+        };
+        const sourceFile = symbol.sourceFile ?? symbol.source;
         return {
-            entity: {
-                id,
-                type: "symbol",
-                title: symbol.title,
-                status: symbol.status || "active",
-                created_at: symbol.created_at || new Date().toISOString(),
-                updated_at: symbol.updated_at || new Date().toISOString(),
-                source: filePath,
-                tags: symbol.tags,
-                owner: symbol.owner,
-                priority: symbol.priority,
-                severity: symbol.severity,
-                text_ref: symbol.text_ref,
-            },
+            entity,
             relationships: extractRelationships(id, symbol),
-            sourceFile: symbol.sourceFile ?? symbol.source,
+            ...(sourceFile !== undefined ? { sourceFile } : {}),
         };
     });
 }

package/dist/extractors/markdown.d.ts

@@ -11,6 +11,8 @@ export interface ExtractedEntity {
     priority?: string;
     severity?: string;
     text_ref?: string;
+    verification_scope?: "unit" | "integration" | "end_to_end";
+    verification_perspective?: "internal" | "consumer";
     fact_kind?: "subject" | "property_value" | "observation" | "meta";
     subject_key?: string;
     property_key?: string;

package/dist/extractors/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/extractors/markdown.ts"],"names":[],"mappings":"AAmDA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,SAAS,GAAG,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACtD,UAAU,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAaD,qBAAa,gBAAiB,SAAQ,KAAK;IAOhC,QAAQ,EAAE,MAAM;IANlB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IASM,QAAQ;CAUlB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CA8CV;AA6ND,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAElB;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAatE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQpE"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/extractors/markdown.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,YAAY,CAAC;IAC3D,wBAAwB,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAEnD,SAAS,CAAC,EAAE,SAAS,GAAG,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACtD,UAAU,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AA2BD,qBAAa,gBAAiB,SAAQ,KAAK;IAOhC,QAAQ,EAAE,MAAM;IANlB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAYM,QAAQ;CAUlB;AA8DD,wBAAgB,sBAAsB,CAEpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAkDV;AAmRD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAElB;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAatE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQpE"}

package/dist/extractors/markdown.js

@@ -18,7 +18,7 @@
 import { createHash } from "node:crypto";
 import { readFileSync } from "node:fs";
 import Ajv from "ajv";
-import matter from "gray-matter";
+import { load as yamlLoad } from "js-yaml";
 import entitySchema from "../schemas/entity.schema.json" with { type: "json" };
 // Typed fact field constants for extraction
 const FACT_STRING_FIELDS = [
@@ -42,6 +42,10 @@ const FACT_ONLY_FIELDS = [
     ...FACT_NUMBER_FIELDS,
     ...FACT_BOOLEAN_FIELDS,
 ];
+const TEST_ENUM_FIELDS = [
+    "verification_scope",
+    "verification_perspective",
+];
 const ajv = new Ajv({ strict: false, allErrors: true });
 const validateExtractedEntity = ajv.compile(entitySchema);
 const DEFAULT_STATUS_BY_TYPE = {
@@ -60,12 +64,15 @@ export class FrontmatterError extends Error {
     hint;
     originalError;
     constructor(message, filePath, options) {
+        // implements REQ-003
         super(message);
         this.filePath = filePath;
         this.name = "FrontmatterError";
         this.classification = options?.classification || "Generic Error";
         this.hint = options?.hint || "Check the file for syntax errors.";
-        this.originalError = options?.originalError;
+        if (options?.originalError !== undefined) {
+            this.originalError = options.originalError;
+        }
     }
     toString() {
         let msg = `${this.filePath}: [${this.classification}] ${this.message}`;
@@ -78,41 +85,91 @@ export class FrontmatterError extends Error {
         return msg;
     }
 }
-export function detectEmbeddedEntities(data, entityType) {
+function isObjectRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isVerificationScope(value) {
+    return value === "unit" || value === "integration" || value === "end_to_end";
+}
+function isVerificationPerspective(value) {
+    return value === "internal" || value === "consumer";
+}
+function parseFrontmatter(content) {
+    const trimmedStart = content.trimStart();
+    if (!trimmedStart.startsWith("---")) {
+        return { data: {}, content };
+    }
+    const parts = trimmedStart.split("---");
+    if (parts.length < 3) {
+        return { data: {}, content };
+    }
+    const frontmatter = parts[1];
+    if (frontmatter === undefined) {
+        return { data: {}, content };
+    }
+    const parsed = yamlLoad(frontmatter);
+    return {
+        data: isObjectRecord(parsed) ? parsed : {},
+        content: parts.slice(2).join("---"),
+    };
+}
+function hasLikelyUnquotedColonInTitle(content) {
+    if (!content.trim().startsWith("---")) {
+        return false;
+    }
+    const parts = content.split("---");
+    if (parts.length < 2) {
+        return false;
+    }
+    const frontmatter = parts[1];
+    return frontmatter
+        ? /^\s*title:\s*(?!["'])(?![>|])[^#\n]*:\s+\S.*$/m.test(frontmatter)
+        : false;
+}
+export function detectEmbeddedEntities(
+// implements REQ-007, REQ-004
+data, entityType) {
     if (entityType !== "req") {
         return [];
     }
     const detected = [];
-    const scenarioFields = ["scenarios", "given", "when", "then", "steps"];
+    const hasEmbeddedValue = (value) => value !== null &&
+        value !== undefined &&
+        (Array.isArray(value) ||
+            typeof value === "object" ||
+            typeof value === "string");
+    const scenarioFields = [
+        "scenario",
+        "scenarios",
+        "given",
+        "when",
+        "then",
+        "steps",
+    ];
     for (const field of scenarioFields) {
-        if (field in data) {
-            const value = data[field];
-            if (value !== null &&
-                value !== undefined &&
-                (Array.isArray(value) ||
-                    typeof value === "object" ||
-                    typeof value === "string")) {
-                if (!detected.includes("scenario")) {
-                    detected.push("scenario");
-                }
-                break;
+        if (hasEmbeddedValue(data[field])) {
+            if (!detected.includes("scenario")) {
+                detected.push("scenario");
             }
+            break;
         }
     }
-    const testFields = ["tests", "testCases", "assertions", "testSteps"];
+    const testFields = [
+        "test",
+        "tests",
+        "testCase",
+        "testCases",
+        "assertion",
+        "assertions",
+        "testStep",
+        "testSteps",
+    ];
     for (const field of testFields) {
-        if (field in data) {
-            const value = data[field];
-            if (value !== null &&
-                value !== undefined &&
-                (Array.isArray(value) ||
-                    typeof value === "object" ||
-                    typeof value === "string")) {
-                if (!detected.includes("test")) {
-                    detected.push("test");
-                }
-                break;
+        if (hasEmbeddedValue(data[field])) {
+            if (!detected.includes("test")) {
+                detected.push("test");
             }
+            break;
         }
     }
     return detected;
@@ -120,7 +177,7 @@ export function detectEmbeddedEntities(data, entityType) {
 // implements REQ-007, REQ-004
 function extractFromMarkdownContent(content, filePath) {
     try {
-        const { data } = matter(content);
+        const { data } = parseFrontmatter(content);
         if (content.trim().startsWith("---")) {
             const parts = content.split("---");
             if (parts.length < 3) {
@@ -205,7 +262,43 @@ function extractFromMarkdownContent(content, filePath) {
                 });
             }
         }
+        if (type !== "test") {
+            const invalidTestField = TEST_ENUM_FIELDS.find((field) => data[field] !== undefined);
+            if (invalidTestField) {
+                throw new FrontmatterError(`Test-only fields are only allowed on type: test (found ${invalidTestField})`, filePath, {
+                    classification: "Test Field on Non-Test Entity",
+                    hint: "Remove test-only fields or change the entity type to test.",
+                });
+            }
+        }
+        if (type === "test") {
+            if (data.verification_scope !== undefined) {
+                if (!isVerificationScope(data.verification_scope)) {
+                    throw new FrontmatterError("Invalid verification_scope; expected one of: unit, integration, end_to_end", filePath, {
+                        classification: "Invalid Test Verification Scope",
+                        hint: "Use one of: unit, integration, end_to_end.",
+                    });
+                }
+                entity.verification_scope = data.verification_scope;
+            }
+            if (data.verification_perspective !== undefined) {
+                if (!isVerificationPerspective(data.verification_perspective)) {
+                    throw new FrontmatterError("Invalid verification_perspective; expected one of: internal, consumer", filePath, {
+                        classification: "Invalid Test Verification Perspective",
+                        hint: "Use one of: internal, consumer.",
+                    });
+                }
+                entity.verification_perspective = data.verification_perspective;
+            }
+        }
         // Add typed fact fields only for fact entities
+        //
+        // INTENTIONAL DYNAMIC CAST: The casts below assign parsed markdown frontmatter
+        // values to ExtractedEntity fields. TypeScript cannot verify that a runtime string
+        // from a const array (e.g., FACT_STRING_FIELDS) is a valid key of ExtractedEntity,
+        // even though all fields are declared as optional properties on the interface.
+        // Fields are validated against the JSON Schema (via validateExtractedEntity) below,
+        // so any invalid field will be caught at runtime before the entity is returned.
         if (type === "fact") {
             // String fields
             for (const field of FACT_STRING_FIELDS) {
@@ -255,8 +348,9 @@ function extractFromMarkdownContent(content, filePath) {
             const message = error.message;
             let classification = "Frontmatter YAML syntax error";
             let hint = "Check the YAML syntax in your frontmatter.";
-            if (message.includes("incomplete explicit mapping pair") &&
-                message.includes(":")) {
+            if ((message.includes("incomplete explicit mapping pair") &&
+                message.includes(":")) ||
+                hasLikelyUnquotedColonInTitle(content)) {
                 classification = "Unquoted colon likely in title";
                 hint =
                     'Wrap values containing colons in quotes (e.g., title: "Foo: Bar").';

package/dist/extractors/relationships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/extractors/relationships.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAsBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,MAAM,GACvB,qBAAqB,EAAE,CAyCzB;AA6CD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,EAAE,GAC/B,qBAAqB,EAAE,CAEzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EAAE,EACtC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,KAAK,CAAC;IACP,YAAY,EAAE,qBAAqB,CAAC;IACpC,KAAK,EAAE,cAAc,GAAG,YAAY,CAAC;CACtC,CAAC,CAgBD"}
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/extractors/relationships.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAsBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,MAAM,GACvB,qBAAqB,EAAE,CAyCzB;AAmDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,EAAE,GAC/B,qBAAqB,EAAE,CAEzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EAAE,EACtC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,KAAK,CAAC;IACP,YAAY,EAAE,qBAAqB,CAAC;IACpC,KAAK,EAAE,cAAc,GAAG,YAAY,CAAC;CACtC,CAAC,CAgBD"}

package/dist/extractors/relationships.js

@@ -99,10 +99,16 @@ function convertRecordToRelationship(record) {
         record.source ||
         record.confidence !== undefined) {
         relationship.metadata = {
-            created_at: record.created_at,
-            created_by: record.created_by,
-            source: record.source,
-            confidence: record.confidence,
+            ...(record.created_at !== undefined
+                ? { created_at: record.created_at }
+                : {}),
+            ...(record.created_by !== undefined
+                ? { created_by: record.created_by }
+                : {}),
+            ...(record.source !== undefined ? { source: record.source } : {}),
+            ...(record.confidence !== undefined
+                ? { confidence: record.confidence }
+                : {}),
         };
     }
     return relationship;

package/dist/extractors/symbols-coordinator.d.ts

@@ -1,4 +1,7 @@
-import { type ManifestSymbolEntry } from "./symbols-ts.js";
+import { type ManifestSymbolEntry, enrichSymbolCoordinatesWithTsMorph } from "./symbols-ts.js";
 export type { ManifestSymbolEntry };
-export declare function enrichSymbolCoordinates(entries: ManifestSymbolEntry[], workspaceRoot: string): Promise<ManifestSymbolEntry[]>;
+interface EnrichSymbolCoordinatesDeps {
+    enrichTsCoordinates: typeof enrichSymbolCoordinatesWithTsMorph;
+}
+export declare function enrichSymbolCoordinates(entries: ManifestSymbolEntry[], workspaceRoot: string, deps?: Partial<EnrichSymbolCoordinatesDeps>): Promise<ManifestSymbolEntry[]>;
 //# sourceMappingURL=symbols-coordinator.d.ts.map

package/dist/extractors/symbols-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols-coordinator.d.ts","sourceRoot":"","sources":["../../src/extractors/symbols-coordinator.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAazB,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,mBAAmB,EAAE,EAC9B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoChC"}
+{"version":3,"file":"symbols-coordinator.d.ts","sourceRoot":"","sources":["../../src/extractors/symbols-coordinator.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,mBAAmB,EACxB,kCAAkC,EACnC,MAAM,iBAAiB,CAAC;AAazB,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,OAAO,kCAAkC,CAAC;CAChE;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,mBAAmB,EAAE,EAC9B,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC1C,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqChC"}

package/dist/extractors/symbols-coordinator.js

@@ -28,13 +28,16 @@ const TS_JS_EXTENSIONS = new Set([
     ".mjs",
     ".cjs",
 ]);
-export async function enrichSymbolCoordinates(entries, workspaceRoot) {
+export async function enrichSymbolCoordinates(entries, workspaceRoot, deps) {
     // implements REQ-vscode-traceability
+    const enrichTsCoordinates = deps?.enrichTsCoordinates ?? enrichSymbolCoordinatesWithTsMorph;
     const output = entries.map((entry) => ({ ...entry }));
     const tsIndices = [];
     const tsEntries = [];
     for (let index = 0; index < output.length; index++) {
         const entry = output[index];
+        if (!entry)
+            continue;
         const resolved = resolveSourcePath(entry.sourceFile, workspaceRoot);
         if (!resolved)
             continue;
@@ -47,7 +50,7 @@ export async function enrichSymbolCoordinates(entries, workspaceRoot) {
         output[index] = enrichWithRegexHeuristic(entry, resolved.absolutePath);
     }
     if (tsEntries.length > 0) {
-        const enrichedTs = await enrichSymbolCoordinatesWithTsMorph(tsEntries, workspaceRoot);
+        const enrichedTs = await enrichTsCoordinates(tsEntries, workspaceRoot);
         for (let i = 0; i < tsIndices.length; i++) {
             const target = tsIndices[i];
             const enriched = enrichedTs[i];

package/dist/extractors/symbols-ts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols-ts.d.ts","sourceRoot":"","sources":["../../src/extractors/symbols-ts.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAaD,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,mBAAmB,EAAE,EAC9B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAwDhC"}
+{"version":3,"file":"symbols-ts.d.ts","sourceRoot":"","sources":["../../src/extractors/symbols-ts.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAaD,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,mBAAmB,EAAE,EAC9B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAuEhC"}

package/dist/extractors/symbols-ts.js

@@ -15,7 +15,7 @@
  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
-import * as fs from "node:fs";
+import { access, readFile } from "node:fs/promises";
 import * as path from "node:path";
 import { Project, } from "ts-morph";
 const SUPPORTED_SOURCE_EXTENSIONS = new Set([
@@ -37,14 +37,14 @@ export async function enrichSymbolCoordinatesWithTsMorph(entries, workspaceRoot)
     const enriched = [];
     for (const entry of entries) {
         try {
-            const resolved = resolveSourcePath(entry.sourceFile, workspaceRoot);
-            if (!resolved) {
+            const absolutePath = await resolveSourcePath(entry.sourceFile, workspaceRoot);
+            if (!absolutePath) {
                 enriched.push(entry);
                 continue;
             }
-            const sourceFile = getOrAddSourceFile(project, sourceFileCache, resolved);
+            const sourceFile = getOrAddSourceFile(project, sourceFileCache, absolutePath);
             if (!sourceFile) {
-                enriched.push(entry);
+                enriched.push(await enrichWithTextFallback(entry, absolutePath));
                 continue;
             }
             const match = findNamedDeclaration(sourceFile, entry.title);
@@ -71,12 +71,17 @@ export async function enrichSymbolCoordinatesWithTsMorph(entries, workspaceRoot)
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             console.warn(`[kibi] Failed to enrich symbol coordinates for ${entry.id}: ${message}`);
-            enriched.push(entry);
+            const absolutePath = await resolveSourcePath(entry.sourceFile, workspaceRoot);
+            if (!absolutePath) {
+                enriched.push(entry);
+                continue;
+            }
+            enriched.push(await enrichWithTextFallback(entry, absolutePath));
         }
     }
     return enriched;
 }
-function resolveSourcePath(sourceFile, workspaceRoot) {
+async function resolveSourcePath(sourceFile, workspaceRoot) {
     if (!sourceFile)
         return null;
     const absolute = path.isAbsolute(sourceFile)
@@ -85,8 +90,12 @@ function resolveSourcePath(sourceFile, workspaceRoot) {
     const ext = path.extname(absolute).toLowerCase();
     if (!SUPPORTED_SOURCE_EXTENSIONS.has(ext))
         return null;
-    if (!fs.existsSync(absolute))
+    try {
+        await access(absolute);
+    }
+    catch {
         return null;
+    }
     return absolute;
 }
 function getOrAddSourceFile(project, cache, absolutePath) {
@@ -102,6 +111,37 @@ function getOrAddSourceFile(project, cache, absolutePath) {
         return null;
     }
 }
+function enrichWithTextFallback(entry, absolutePath) {
+    return enrichWithTextFallbackInternal(entry, absolutePath);
+}
+async function enrichWithTextFallbackInternal(entry, absolutePath) {
+    try {
+        const content = await readFile(absolutePath, "utf8");
+        const lines = content.split(/\r?\n/);
+        const escapedTitle = entry.title.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const pattern = new RegExp(`\\b${escapedTitle}\\b`);
+        for (let index = 0; index < lines.length; index++) {
+            const line = lines[index];
+            if (!line)
+                continue;
+            const match = pattern.exec(line);
+            if (!match || match.index < 0)
+                continue;
+            return {
+                ...entry,
+                sourceLine: index + 1,
+                sourceColumn: match.index,
+                sourceEndLine: index + 1,
+                sourceEndColumn: match.index + entry.title.length,
+                coordinatesGeneratedAt: new Date().toISOString(),
+            };
+        }
+        return entry;
+    }
+    catch {
+        return entry;
+    }
+}
 function findNamedDeclaration(sourceFile, title) {
     const candidates = [];
     for (const decl of sourceFile.getFunctions()) {
@@ -179,7 +219,10 @@ function findNamedDeclaration(sourceFile, title) {
         }
         // Fail closed: only return if exactly one unique match
         if (internalCandidates.length === 1) {
-            return internalCandidates[0];
+            const candidate = internalCandidates[0];
+            if (candidate) {
+                return candidate;
+            }
         }
         // Third pass: unique class methods
         const methodCandidates = [];
@@ -195,7 +238,10 @@ function findNamedDeclaration(sourceFile, title) {
         }
         // Fail closed: only return if exactly one unique match
         if (methodCandidates.length === 1) {
-            return methodCandidates[0];
+            const candidate = methodCandidates[0];
+            if (candidate) {
+                return candidate;
+            }
         }
         return null;
     }

package/dist/prolog/codec.d.ts

@@ -23,53 +23,15 @@ export declare function toPrologString(value: string): string;
  * Alias for escapeAtom for semantic clarity.
  */
 export declare function escapeAtomContent(value: string): string;
-/**
- * Parse a Prolog list of lists into a JavaScript array.
- * Input: "[[a,b,c],[d,e,f]]"
- * Output: [["a", "b", "c"], ["d", "e", "f"]]
- */
 export declare function parseListOfLists(listStr: string): string[][];
-/**
- * Parse a single entity from Prolog binding format.
- * Input: "[abc123, req, [id=abc123, title=\"Test\", ...]]"
- */
 export declare function parseEntityFromBinding(bindingStr: string): Record<string, unknown>;
-/**
- * Parse entity from array returned by parseListOfLists.
- * Input: ["abc123", "req", "[id=abc123, title=\"Test\", ...]"]
- */
 export declare function parseEntityFromList(data: string[]): Record<string, unknown>;
-/**
- * Parse Prolog property list into JavaScript object.
- * Input: "[id=abc123, title=\"Test\"]"
- */
 export declare function parsePropertyList(propsStr: string): Record<string, unknown>;
-/**
- * Parse a single Prolog value, handling typed literals and URIs.
- */
 export declare function parsePrologValue(valueInput: string): unknown;
-/**
- * General-purpose split at top level (not inside brackets or quotes).
- * More robust version used by property parsing.
- */
 export declare function splitTopLevelGeneral(str: string, delimiter: string): string[];
-/**
- * Split a string by delimiter at the top level (not inside brackets or quotes).
- * @see splitTopLevelGeneral
- */
 export declare function splitTopLevel(str: string, delimiter: string): string[];
-/**
- * Parse an atom list from Prolog response.
- * Input: "[a, b, c]" or atom string
- */
 export declare function parseAtomList(raw: string): string[];
-/**
- * Parse a list of pairs from Prolog response.
- */
 export declare function parsePairList(raw: string): Array<[string, string]>;
-/**
- * Parse a list of triples from Prolog response.
- */
 export declare function parseTriples(raw: string): Array<[string, string, string]>;
 /**
  * Parsed violation from Prolog check output.
@@ -81,10 +43,5 @@ export interface ParsedViolation {
     suggestion: string;
     source?: string;
 }
-/**
- * Parse a Prolog list of violation/5 terms into JavaScript objects.
- * Handles descriptions and suggestions that contain commas or nested parens.
- * Input: "[violation(rule,'EntityId',\"Desc\",\"Sugg\",'src')]"
- */
 export declare function parseViolationRows(raw: string): ParsedViolation[];
 //# sourceMappingURL=codec.d.ts.map

package/dist/prolog/codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/prolog/codec.ts"],"names":[],"mappings":"AAUA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CA6C5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6B3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAwF5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAoD7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtE;AA2BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAclE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAczE;AA6DD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CA0CjE"}
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/prolog/codec.ts"],"names":[],"mappings":"AAUA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CA8C5D;AAED,wBAAgB,sBAAsB,CAEpC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB3E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8B3E;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA8F5D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAoD7E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtE;AAqBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAenD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmBlE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBzE;AAuDD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CA6DjE"}