kibi-cli 0.8.0 → 0.10.1

package/dist/commands/sync/manifest.js

@@ -14,11 +14,13 @@
 
  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 { existsSync, readFileSync, writeFileSync } from "node:fs";
 import * as path from "node:path";
 import { dump as dumpYAML, load as parseYAML } from "js-yaml";
 import { enrichSymbolCoordinates, } from "../../extractors/symbols-coordinator.js";
+import { writeCoordinateArtifact } from "../../extractors/symbol-coordinates.js";
+import { resolveSymbolsManifestPaths } from "../../utils/manifest-paths.js";
 function resolveDeps(overrides) {
     return {
         dumpYAML,
@@ -27,6 +29,8 @@ function resolveDeps(overrides) {
         parseYAML,
         readFileSync,
         writeFileSync,
+        writeCoordinateArtifact,
+        resolveSymbolsManifestPaths,
         ...overrides,
     };
 }
@@ -34,7 +38,7 @@ export const SYMBOLS_MANIFEST_COMMENT_BLOCK = `# symbols.yaml
 # AUTHORED fields (edit freely):
 #   id, title, sourceFile, links, status, tags, owner, priority
 # GENERATED fields (never edit manually — overwritten by kibi sync and kb.symbols.refresh):
-#   sourceLine, sourceColumn, sourceEndLine, sourceEndColumn, coordinatesGeneratedAt
+#   sourceLine, sourceColumn, sourceEndLine, sourceEndColumn
 # Run \`kibi sync\` or call the \`kb.symbols.refresh\` MCP tool to refresh coordinates.
 `;
 const SYMBOL_COORD_EXTENSIONS = new Set([
@@ -52,12 +56,12 @@ const GENERATED_COORD_FIELDS = [
     "sourceColumn",
     "sourceEndLine",
     "sourceEndColumn",
-    "coordinatesGeneratedAt",
 ];
 export async function refreshManifestCoordinates(
 // implements REQ-003
 manifestPath, workspaceRoot, deps) {
     const resolved = resolveDeps(deps);
+    const shouldRefreshCoordinates = deps?.refreshSymbolCoordinates ?? false;
     const rawContent = resolved.readFileSync(manifestPath, "utf8");
     const parsed = resolved.parseYAML(rawContent);
     if (!isRecord(parsed)) {
@@ -69,11 +73,54 @@ manifestPath, workspaceRoot, deps) {
         console.warn(`Warning: symbols manifest ${manifestPath} has no symbols array; skipping coordinate refresh`);
         return;
     }
-    const before = rawSymbols.map((entry) => isRecord(entry)
-        ? { ...entry }
-        : {});
+    const before = rawSymbols.map((entry) => isRecord(entry) ? { ...entry } : {});
     const enriched = await resolved.enrichSymbolCoordinates(before, workspaceRoot);
-    parsed.symbols = enriched;
+    // Build coordinates map keyed by symbol id
+    const coordinatesMap = {};
+    for (const entry of enriched) {
+        const id = typeof entry?.id === "string" ? entry.id : undefined;
+        if (!id)
+            continue;
+        if (typeof entry.sourceFile === "string" &&
+            typeof entry.sourceLine === "number" &&
+            typeof entry.sourceColumn === "number" &&
+            typeof entry.sourceEndLine === "number" &&
+            typeof entry.sourceEndColumn === "number") {
+            coordinatesMap[id] = {
+                sourceFile: entry.sourceFile,
+                sourceLine: entry.sourceLine,
+                sourceColumn: entry.sourceColumn,
+                sourceEndLine: entry.sourceEndLine,
+                sourceEndColumn: entry.sourceEndColumn,
+            };
+        }
+    }
+    // Optionally write the coordinate artifact to the coordinates path when explicitly requested
+    if (shouldRefreshCoordinates) {
+        try {
+            const coordinatesPath = resolved.resolveSymbolsManifestPaths(workspaceRoot).coordinatesPath;
+            const artifactContent = resolved.writeCoordinateArtifact(coordinatesMap);
+            resolved.writeFileSync(coordinatesPath, artifactContent, "utf8");
+        }
+        catch (err) {
+            console.warn(`Warning: Failed to write symbol-coordinates artifact: ${String(err)}`);
+        }
+    }
+    // Strip generated fields from symbols.yaml entries only if original had them
+    const strippedEnriched = enriched.map((current, idx) => {
+        const prev = before[idx] ?? {};
+        const out = { ...current };
+        const originalHadGenerated = GENERATED_COORD_FIELDS.some((f) => prev[f] !== undefined);
+        if (originalHadGenerated) {
+            for (const field of GENERATED_COORD_FIELDS) {
+                delete out[field];
+            }
+        }
+        // Ensure we never write coordinatesGeneratedAt
+        delete out["coordinatesGeneratedAt"];
+        return out;
+    });
+    parsed.symbols = strippedEnriched;
     let refreshed = 0;
     let failed = 0;
     let unchanged = 0;
@@ -106,7 +153,7 @@ manifestPath, workspaceRoot, deps) {
     if (rawContent !== nextContent) {
         resolved.writeFileSync(manifestPath, nextContent, "utf8");
     }
-    console.log(`✓ Refreshed symbol coordinates in ${path.relative(workspaceRoot, manifestPath)} (refreshed=${refreshed}, unchanged=${unchanged}, failed=${failed})`);
+    console.log(`\u2713 Refreshed symbol coordinates in ${path.relative(workspaceRoot, manifestPath)} (refreshed=${refreshed}, unchanged=${unchanged}, failed=${failed})`);
 }
 export function hasAllGeneratedCoordinates(
 // implements REQ-003
@@ -114,9 +161,7 @@ entry) {
     return (typeof entry.sourceLine === "number" &&
         typeof entry.sourceColumn === "number" &&
         typeof entry.sourceEndLine === "number" &&
-        typeof entry.sourceEndColumn === "number" &&
-        typeof entry.coordinatesGeneratedAt === "string" &&
-        entry.coordinatesGeneratedAt.length > 0);
+        typeof entry.sourceEndColumn === "number");
 }
 export function isEligibleForCoordinateRefresh(
 // implements REQ-003

package/dist/commands/sync.d.ts

@@ -25,6 +25,7 @@ interface SyncCommandRuntime {
 export declare function syncCommand(options?: {
     validateOnly?: boolean;
     rebuild?: boolean;
+    refreshSymbolCoordinates?: boolean;
 }, runtime?: SyncCommandRuntime): Promise<SyncResult>;
 export { normalizeMarkdownPath } from "./sync/discovery.js";
 //# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAejE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4B7C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAGD,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,CACZ,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,yBAAyB,GAAG;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,KACzD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,aAAa,CAAC;CAChE;AAGD,wBAAsB,WAAW,CAC/B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,EAC3D,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAmbrB;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAejE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4B7C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAGD,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,CACZ,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,yBAAyB,GAAG;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,KACzD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,aAAa,CAAC;CAChE;AAGD,wBAAsB,WAAW,CAC/B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAO,EAC/F,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAkbrB;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/commands/sync.js

@@ -140,13 +140,15 @@ export async function syncCommand(options = {}, runtime = {}) {
             }
         }
         if (!validateOnly) {
-            for (const file of manifestFiles) {
-                try {
-                    await refreshManifestCoordinates(file, process.cwd());
-                }
-                catch (error) {
-                    const message = error instanceof Error ? error.message : String(error);
-                    console.warn(`Warning: Failed to refresh symbol coordinates in ${file}: ${message}`);
+            if (options.refreshSymbolCoordinates) {
+                for (const file of manifestFiles) {
+                    try {
+                        await refreshManifestCoordinates(file, process.cwd(), { refreshSymbolCoordinates: options.refreshSymbolCoordinates });
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        console.warn(`Warning: Failed to refresh symbol coordinates in ${file}: ${message}`);
+                    }
                 }
             }
         }

package/dist/extractors/manifest.d.ts

@@ -27,6 +27,36 @@ export declare class ManifestError extends Error {
     filePath: string;
     constructor(message: string, filePath: string);
 }
+export interface ManifestSymbolRecord {
+    id?: string;
+    title?: string;
+    source?: string;
+    sourceFile?: string;
+    status?: string;
+    tags?: string[];
+    owner?: string;
+    priority?: string;
+    severity?: string;
+    text_ref?: string;
+    created_at?: string;
+    updated_at?: string;
+    links?: Array<string | {
+        type: string;
+        target: string;
+    }>;
+    relationships?: Array<{
+        type: string;
+        target: string;
+    }>;
+    sourceLine?: number;
+    sourceColumn?: number;
+    sourceEndLine?: number;
+    sourceEndColumn?: number;
+    coordinatesGeneratedAt?: string;
+    [key: string]: unknown;
+}
 export declare function extractFromManifestString(content: string, filePath: string): ExtractionResult[];
+export declare function extractManifestSymbolRecordsString(content: string, filePath: string): ManifestSymbolRecord[];
 export declare function extractFromManifest(filePath: string): ExtractionResult[];
+export declare function readManifestWithCoordinateOverlay(manifestPath: string, coordinatesPath?: string): ManifestSymbolRecord[];
 //# sourceMappingURL=manifest.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/extractors/manifest.ts"],"names":[],"mappings":"AAsBA,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;CACnB;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;IACvC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAc,SAAQ,KAAK;IAG7B,QAAQ,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM;CAK1B;AA+GD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAmBpB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGxE"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/extractors/manifest.ts"],"names":[],"mappings":"AA6BA,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;CACnB;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;IACvC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAc,SAAQ,KAAK;IAG7B,QAAQ,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM;CAK1B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,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,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAmHD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAmBpB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,oBAAoB,EAAE,CAmBxB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAKxE;AAsCD,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,oBAAoB,EAAE,CAWxB"}

package/dist/extractors/manifest.js

@@ -16,8 +16,11 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 import { createHash } from "node:crypto";
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
+import * as path from "node:path";
 import { load as parseYAML } from "js-yaml";
+import { DEFAULT_COORDINATES_PATH } from "../utils/manifest-paths.js";
+import { mergeCoordinatesWithManifest, readCoordinateArtifact, } from "./symbol-coordinates.js";
 export class ManifestError extends Error {
     filePath;
     constructor(message, filePath) {
@@ -26,6 +29,12 @@ export class ManifestError extends Error {
         this.name = "ManifestError";
     }
 }
+function getManifestSymbols(manifest, filePath) {
+    if (!manifest.symbols || !Array.isArray(manifest.symbols)) {
+        throw new ManifestError("No symbols array found in manifest", filePath);
+    }
+    return manifest.symbols;
+}
 function extractRelationships(id, symbol) {
     const relationships = [];
     if (Array.isArray(symbol.links)) {
@@ -66,10 +75,10 @@ function extractRelationships(id, symbol) {
     return relationships;
 }
 function extractFromParsedManifest(manifest, filePath) {
-    if (!manifest.symbols || !Array.isArray(manifest.symbols)) {
-        throw new ManifestError("No symbols array found in manifest", filePath);
-    }
-    return manifest.symbols.map((symbol) => {
+    return extractFromManifestSymbolRecords(getManifestSymbols(manifest, filePath), filePath);
+}
+function extractFromManifestSymbolRecords(manifestSymbols, filePath) {
+    return manifestSymbols.map((symbol) => {
         if (!symbol.title) {
             throw new ManifestError("Missing required field: title", filePath);
         }
@@ -96,6 +105,9 @@ function extractFromParsedManifest(manifest, filePath) {
         };
     });
 }
+function cloneManifestSymbols(manifest, filePath) {
+    return getManifestSymbols(manifest, filePath).map((symbol) => ({ ...symbol }));
+}
 // implements REQ-007
 export function extractFromManifestString(content, filePath) {
     try {
@@ -112,9 +124,50 @@ export function extractFromManifestString(content, filePath) {
         throw error;
     }
 }
+export function extractManifestSymbolRecordsString(content, filePath) {
+    try {
+        const manifest = parseYAML(content);
+        return cloneManifestSymbols(manifest, filePath);
+    }
+    catch (error) {
+        if (error instanceof ManifestError) {
+            throw error;
+        }
+        if (error instanceof Error) {
+            throw new ManifestError(`Failed to parse manifest: ${error.message}`, filePath);
+        }
+        throw error;
+    }
+}
 export function extractFromManifest(filePath) {
-    const content = readFileSync(filePath, "utf8");
-    return extractFromManifestString(content, filePath);
+    return extractFromManifestSymbolRecords(readManifestWithCoordinateOverlay(filePath), filePath);
+}
+function resolveCoordinatesPath(manifestPath, coordinatesPath) {
+    if (coordinatesPath) {
+        return coordinatesPath;
+    }
+    return path.join(path.dirname(manifestPath), path.basename(DEFAULT_COORDINATES_PATH));
+}
+function readCoordinateArtifactFromFile(coordinatesPath) {
+    if (!existsSync(coordinatesPath)) {
+        return null;
+    }
+    try {
+        return readCoordinateArtifact(readFileSync(coordinatesPath, "utf8"));
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new ManifestError(`Failed to parse coordinate artifact: ${error.message}`, coordinatesPath);
+        }
+        throw error;
+    }
+}
+// implements REQ-core-extractors
+export function readManifestWithCoordinateOverlay(manifestPath, coordinatesPath) {
+    const manifestContent = readFileSync(manifestPath, "utf8");
+    const manifestRecords = extractManifestSymbolRecordsString(manifestContent, manifestPath);
+    const coordinateArtifact = readCoordinateArtifactFromFile(resolveCoordinatesPath(manifestPath, coordinatesPath));
+    return mergeCoordinatesWithManifest(manifestRecords, coordinateArtifact);
 }
 function generateId(filePath, title) {
     const hash = createHash("sha256");

package/dist/extractors/symbol-coordinates.d.ts

@@ -0,0 +1,15 @@
+import type { ManifestSymbolRecord } from "./manifest.js";
+export interface SymbolCoordinatesRecord {
+    sourceFile: string;
+    sourceLine: number;
+    sourceColumn: number;
+    sourceEndLine: number;
+    sourceEndColumn: number;
+}
+export interface SymbolCoordinatesArtifact {
+    coordinates: Record<string, SymbolCoordinatesRecord>;
+}
+export declare function readCoordinateArtifact(content: string): SymbolCoordinatesArtifact;
+export declare function writeCoordinateArtifact(coordinates: Record<string, SymbolCoordinatesRecord>): string;
+export declare function mergeCoordinatesWithManifest(symbolRecords: ManifestSymbolRecord[], coordinateArtifact: SymbolCoordinatesArtifact | null): ManifestSymbolRecord[];
+//# sourceMappingURL=symbol-coordinates.d.ts.map

package/dist/extractors/symbol-coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-coordinates.d.ts","sourceRoot":"","sources":["../../src/extractors/symbol-coordinates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACtD;AA0DD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GACd,yBAAyB,CAkB3B;AAGD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,GACnD,MAAM,CAUR;AAGD,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,oBAAoB,EAAE,EACrC,kBAAkB,EAAE,yBAAyB,GAAG,IAAI,GACnD,oBAAoB,EAAE,CAoBxB"}

package/dist/extractors/symbol-coordinates.js

@@ -0,0 +1,83 @@
+import { dump as dumpYAML, load as parseYAML } from "js-yaml";
+const SYMBOL_COORDINATES_COMMENT_BLOCK = `# symbol-coordinates.yaml
+# GENERATED coordinate artifact — do not edit manually.
+# Run \`kibi sync --refresh-symbol-coordinates\` to refresh.
+`;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeCoordinateRecord(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const { sourceColumn, sourceEndColumn, sourceEndLine, sourceFile, sourceLine } = value;
+    if (typeof sourceFile !== "string" ||
+        typeof sourceLine !== "number" ||
+        typeof sourceColumn !== "number" ||
+        typeof sourceEndLine !== "number" ||
+        typeof sourceEndColumn !== "number") {
+        return null;
+    }
+    return {
+        sourceFile,
+        sourceLine,
+        sourceColumn,
+        sourceEndLine,
+        sourceEndColumn,
+    };
+}
+function sortCoordinates(coordinates) {
+    const sortedCoordinates = {};
+    for (const symbolId of Object.keys(coordinates).sort((left, right) => left.localeCompare(right))) {
+        const record = normalizeCoordinateRecord(coordinates[symbolId]);
+        if (!record) {
+            continue;
+        }
+        sortedCoordinates[symbolId] = record;
+    }
+    return sortedCoordinates;
+}
+// implements REQ-core-extractors
+export function readCoordinateArtifact(content) {
+    const parsed = parseYAML(content);
+    if (!isRecord(parsed) || !isRecord(parsed.coordinates)) {
+        return { coordinates: {} };
+    }
+    const coordinates = {};
+    for (const [symbolId, record] of Object.entries(parsed.coordinates)) {
+        const normalizedRecord = normalizeCoordinateRecord(record);
+        if (!normalizedRecord) {
+            continue;
+        }
+        coordinates[symbolId] = normalizedRecord;
+    }
+    return { coordinates };
+}
+// implements REQ-core-extractors
+export function writeCoordinateArtifact(coordinates) {
+    const artifact = {
+        coordinates: sortCoordinates(coordinates),
+    };
+    return `${SYMBOL_COORDINATES_COMMENT_BLOCK}${dumpYAML(artifact, {
+        lineWidth: -1,
+        noRefs: true,
+        sortKeys: true,
+    })}`;
+}
+// implements REQ-core-extractors
+export function mergeCoordinatesWithManifest(symbolRecords, coordinateArtifact) {
+    const coordinates = coordinateArtifact?.coordinates ?? {};
+    return symbolRecords.map((symbolRecord) => {
+        const legacyRecord = { ...symbolRecord };
+        const symbolId = typeof symbolRecord.id === "string" ? symbolRecord.id : undefined;
+        const coordinateRecord = symbolId ? coordinates[symbolId] : undefined;
+        if (!coordinateRecord) {
+            return legacyRecord;
+        }
+        const { coordinatesGeneratedAt: _coordinatesGeneratedAt, ...mergedRecord } = legacyRecord;
+        return {
+            ...mergedRecord,
+            ...coordinateRecord,
+        };
+    });
+}

package/dist/public/check-types.d.ts

@@ -1,7 +1,9 @@
 /**
- * Public re-export barrel for shared check types.
+ * Public re-export barrel for shared check types and MCP-consumed modeling helpers.
  * Import from "kibi-cli/public/check-types" in MCP or external consumers.
  */
 export type { ChecksConfig, RuleDefinition, SymbolTraceabilityOptions, Violation, } from "../utils/rule-registry.js";
+export type { SemanticClaim, StableRequirementIds, StrictModelInput, StrictWriteSet, } from "../utils/strict-modeling.js";
 export { DEFAULT_CHECKS_CONFIG, RULE_NAMES, RULES, getEffectiveRules, mergeChecksConfig, validateRuleName, } from "../utils/rule-registry.js";
+export { buildStableRequirementIds, buildStrictWriteSet, modelRequirementClaims, normalizePropertyKey, normalizeSubjectKey, } from "../utils/strict-modeling.js";
 //# sourceMappingURL=check-types.d.ts.map

package/dist/public/check-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-types.d.ts","sourceRoot":"","sources":["../../src/public/check-types.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,SAAS,GACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"check-types.d.ts","sourceRoot":"","sources":["../../src/public/check-types.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC"}

package/dist/public/check-types.js

@@ -16,3 +16,4 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 export { DEFAULT_CHECKS_CONFIG, RULE_NAMES, RULES, getEffectiveRules, mergeChecksConfig, validateRuleName, } from "../utils/rule-registry.js";
+export { buildStableRequirementIds, buildStrictWriteSet, modelRequirementClaims, normalizePropertyKey, normalizeSubjectKey, } from "../utils/strict-modeling.js";

package/dist/public/extractors/manifest.d.ts

@@ -1,2 +1,2 @@
-export { extractFromManifest, extractFromManifestString, type ExtractionResult, type ManifestError, } from "../../extractors/manifest.js";
+export { extractFromManifest, extractFromManifestString, readManifestWithCoordinateOverlay, type ExtractionResult, type ManifestError, type ManifestSymbolRecord, } from "../../extractors/manifest.js";
 //# sourceMappingURL=manifest.d.ts.map

package/dist/public/extractors/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/public/extractors/manifest.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/public/extractors/manifest.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iCAAiC,EACjC,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC"}

package/dist/public/extractors/manifest.js

@@ -15,4 +15,4 @@
  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/>.
 */
-export { extractFromManifest, extractFromManifestString, } from "../../extractors/manifest.js";
+export { extractFromManifest, extractFromManifestString, readManifestWithCoordinateOverlay, } from "../../extractors/manifest.js";

package/dist/public/ignore-policy.d.ts

@@ -0,0 +1,10 @@
+export interface IgnorePolicy {
+    isIgnored(inputPath: string): boolean;
+    getFastGlobIgnoreGlobs(): string[];
+    explain(inputPath: string): {
+        ignored: boolean;
+        reason?: string;
+    };
+}
+export declare function createRepoIgnorePolicy(workspaceRoot: string): IgnorePolicy;
+//# sourceMappingURL=ignore-policy.d.ts.map

package/dist/public/ignore-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-policy.d.ts","sourceRoot":"","sources":["../../src/public/ignore-policy.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,sBAAsB,IAAI,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAoBD,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,CA8L1E"}