kibi-cli 0.19.0 → 2.0.0

package/dist/search-ranking.d.ts

@@ -6,4 +6,5 @@ export interface SearchMatch {
 }
 export declare function rankEntities(entities: Record<string, unknown>[], query: string, workspaceRoot: string): Promise<SearchMatch[]>;
 export declare function loadMarkdownBody(source: string, workspaceRoot: string): Promise<string | null>;
+export declare function snippetFromMatchedLine(matchedLine: string | undefined): string | undefined;
 //# sourceMappingURL=search-ranking.d.ts.map

package/dist/search-ranking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-ranking.d.ts","sourceRoot":"","sources":["../src/search-ranking.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgDD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BxB;AAsGD,wBAAsB,gBAAgB,CAEpC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB"}
+{"version":3,"file":"search-ranking.d.ts","sourceRoot":"","sources":["../src/search-ranking.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgDD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BxB;AAsGD,wBAAsB,gBAAgB,CAEpC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB;AAuJD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAQpB"}

package/dist/search-ranking.js

@@ -263,6 +263,9 @@ function buildSnippet(bodyText, queryForms) {
         .map((line) => line.trim())
         .filter(Boolean);
     const matchedLine = lines.find((line) => isPhraseSearchMatch(buildSearchTextForms(line), queryForms)) ?? lines[0];
+    return snippetFromMatchedLine(matchedLine);
+}
+export function snippetFromMatchedLine(matchedLine) {
     if (!matchedLine) {
         return undefined;
     }

package/dist/traceability/evidence-model.d.ts

@@ -8,9 +8,9 @@
 export declare const KIBI_STAGED_IMPACT_EVIDENCE_DOC = "docs/cli-reference.md#staged-impact-evidence";
 export declare const KIBI_ENTITY_SCHEMA_DOC = "docs/entity-schema.md";
 /** Canonical symbols manifest path used by staged traceability enforcement. */
-export declare const KIBI_SYMBOLS_MANIFEST_PATH = "documentation/symbols.yaml";
+export declare const KIBI_SYMBOLS_MANIFEST_PATH = ".kb/symbols.yaml";
 /** Canonical symbol coordinates artifact used by staged traceability enforcement. */
-export declare const KIBI_SYMBOL_COORDINATES_PATH = "documentation/symbol-coordinates.yaml";
+export declare const KIBI_SYMBOL_COORDINATES_PATH = ".kb/symbol-coordinates.yaml";
 /** Explicit declaration string for audited no-impact overrides. */
 export declare const KIBI_NO_IMPACT_DECLARATION = "Kibi-Impact: none";
 /** Canonical Kibi entity types that can provide staged evidence. */
@@ -49,6 +49,28 @@ export interface KibiImpactKbArtifact {
     /** Repo-relative source paths explicitly covered by this artifact. */
     sourcePaths: string[];
 }
+/**
+ * Per-file explanation of why symbol evidence does not match extraction.
+ *
+ * Titles come from comparing the extractor's view of the staged source content
+ * against the staged manifest+coordinates records for the same path, so the
+ * diagnostic can name the exact symbols a commit's evidence is missing.
+ */
+export interface KibiImpactSymbolsManifestFileDetail {
+    /** Repo-relative staged source path the diff describes. */
+    path: string;
+    /** Symbol count extraction finds in the staged source content. */
+    expectedCount: number;
+    /** Symbol count the staged manifest+coordinates evidence covers. */
+    coveredCount: number;
+    /** Extracted symbols with no evidence entry (title + definition line). */
+    missing: Array<{
+        title: string;
+        line: number;
+    }>;
+    /** Evidence entries the extractor no longer finds at the recorded shape. */
+    extra: string[];
+}
 /**
  * Deterministic symbol coordinates artifact state for the staged change-set.
  *
@@ -66,6 +88,12 @@ export interface KibiImpactSymbolsManifest {
     state: "not_required" | "fresh" | "stale" | "missing";
     /** Repo-relative staged source paths whose symbol output this state describes. */
     sourcePaths: string[];
+    /**
+     * Per-file extraction-vs-evidence diffs for the paths this state describes.
+     * Present only when extraction output changed; lets diagnostics name the
+     * uncovered symbols instead of reporting a bare "stale" verdict.
+     */
+    fileDetails?: readonly KibiImpactSymbolsManifestFileDetail[];
 }
 /** Supported audited reasons for a no-impact override. */
 export type KibiNoImpactReason = "false_positive" | "non_behavioral_source_edit";

package/dist/traceability/evidence-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evidence-model.d.ts","sourceRoot":"","sources":["../../src/traceability/evidence-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evidence-model.d.ts","sourceRoot":"","sources":["../../src/traceability/evidence-model.ts"],"names":[],"mappings":"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"}

package/dist/traceability/evidence-model.js

@@ -8,9 +8,9 @@
 export const KIBI_STAGED_IMPACT_EVIDENCE_DOC = "docs/cli-reference.md#staged-impact-evidence";
 export const KIBI_ENTITY_SCHEMA_DOC = "docs/entity-schema.md";
 /** Canonical symbols manifest path used by staged traceability enforcement. */
-export const KIBI_SYMBOLS_MANIFEST_PATH = "documentation/symbols.yaml";
+export const KIBI_SYMBOLS_MANIFEST_PATH = ".kb/symbols.yaml";
 /** Canonical symbol coordinates artifact used by staged traceability enforcement. */
-export const KIBI_SYMBOL_COORDINATES_PATH = "documentation/symbol-coordinates.yaml";
+export const KIBI_SYMBOL_COORDINATES_PATH = ".kb/symbol-coordinates.yaml";
 /** Explicit declaration string for audited no-impact overrides. */
 export const KIBI_NO_IMPACT_DECLARATION = "Kibi-Impact: none";
 function uniqueSorted(values) {

package/dist/traceability/git-staged.d.ts

@@ -11,9 +11,21 @@ export interface StagedFile {
     diffText?: string;
     content?: string;
 }
+export type StagedAnalysisDepth = "symbol" | "metadata" | "file" | "none";
+export type StagedDisposition = "checked" | "advisory" | "skipped";
+export type StagedSkipReason = "binary" | "unsupported_encoding" | "symlink" | "submodule";
+/** Complete Git-index record used by staged validation before any filtering. */
+export interface StagedPath extends StagedFile {
+    analysisDepth: StagedAnalysisDepth;
+    disposition: StagedDisposition;
+    gitMode?: string;
+    previousContent?: string;
+    skipReason?: StagedSkipReason;
+}
 type ExecFn = (cmd: string, opts: {
     encoding: "utf8";
 }) => string;
+export type GitArgsExecFn = (args: readonly string[]) => Buffer;
 /**
  * Parse null-separated name-status output from git
  */
@@ -21,6 +33,14 @@ export declare function parseNameStatusNull(input: string): Array<{
     status: string;
     parts: string[];
 }>;
+/**
+ * Read every staged path from the index, preserving records that staged symbol
+ * validation cannot inspect deeply. Blob contents always come from Git rather
+ * than the working tree.
+ */
+export declare function getStagedInventory(exec?: GitArgsExecFn): StagedPath[];
+/** Convert the complete inventory to the historical supported staged-file set. */
+export declare function supportedStagedFiles(inventory: readonly StagedPath[]): StagedFile[];
 /**
  * Parse unified diff hunks (new-file coordinates) from git diff output
  */

package/dist/traceability/git-staged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAalE;;GAEG;AAEH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwB5C;AAsED;;GAEG;AACH,wBAAgB,kBAAkB,CAEhC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAuBb;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAiB,GAAG,UAAU,EAAE,CAwGpE;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,sBAAsB,GACtB,SAAS,GACT,WAAW,CAAC;AAEhB,gFAAgF;AAChF,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,aAAa,EAAE,mBAAmB,CAAC;IACnC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AAwChE;;GAEG;AAEH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwB5C;AAsFD;;;;GAIG;AAEH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,aAAkC,GACvC,UAAU,EAAE,CAuFd;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,UAAU,EAAE,GAC/B,UAAU,EAAE,CAmBd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAEhC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAuBb;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAoB,GAAG,UAAU,EAAE,CAwGvE;AAED,eAAe,cAAc,CAAC"}

package/dist/traceability/git-staged.js

@@ -1,6 +1,30 @@
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { isCliTraceOrDebugEnabled } from "../env.js";
-import { loadConfig } from "../utils/config.js";
+import { isEntityLanePath, isSymbolsManifestPath } from "../utils/kb-paths.js";
+// Staged manifests (e.g., .kb/symbols.yaml) can exceed Node's default 1 MiB
+// exec buffer; without a larger bound the staged file is silently skipped and
+// freshness checks compare against stale HEAD state.
+const GIT_EXEC_MAX_BUFFER = 64 * 1024 * 1024;
+function defaultExec(cmd, opts) {
+    return execSync(cmd, { ...opts, maxBuffer: GIT_EXEC_MAX_BUFFER });
+}
+function defaultGitArgsExec(args) {
+    return execFileSync("git", args, {
+        encoding: "buffer",
+        maxBuffer: GIT_EXEC_MAX_BUFFER,
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+}
+function runGitArgs(args, exec) {
+    try {
+        return exec(args);
+    }
+    catch (err) {
+        const e = err;
+        const message = e?.message ? String(e.message) : String(err);
+        throw new Error(`git command failed: git ${args.join(" ")} -> ${message}`);
+    }
+}
 function runGit(cmd, exec) {
     try {
         return exec(cmd, { encoding: "utf8" });
@@ -49,19 +73,10 @@ const SUPPORTED_EXT = new Set([
     ".cjs",
 ]);
 const SUPPORTED_MANIFEST = new Set([
-    "symbols.yaml",
-    "symbols.yml",
-    "symbol-coordinates.yaml",
+    ".kb/symbols.yaml",
+    ".kb/symbols.yml",
+    ".kb/symbol-coordinates.yaml",
 ]);
-const ENTITY_MARKDOWN_DIRS = [
-    "/requirements/",
-    "/scenarios/",
-    "/tests/",
-    "/facts/",
-    "/adr/",
-    "/flags/",
-    "/events/",
-];
 function shouldLogTraceDebug() {
     return isCliTraceOrDebugEnabled();
 }
@@ -76,34 +91,138 @@ function hasSupportedExt(p) {
     return false;
 }
 function isEntityMarkdown(p) {
-    if (!p.endsWith(".md"))
-        return false;
-    for (const dir of ENTITY_MARKDOWN_DIRS) {
-        if (p.includes(dir))
-            return true;
-    }
-    return false;
+    return p.endsWith(".md") && isEntityLanePath(p);
 }
 function isManifestFile(p) {
-    const base = p.split(/[\\/]/).pop();
-    if (!base)
-        return false;
-    for (const name of SUPPORTED_MANIFEST) {
-        if (base === name)
-            return true;
-    }
+    const posix = p.replaceAll("\\", "/");
+    return SUPPORTED_MANIFEST.has(posix) || isSymbolsManifestPath(posix);
+}
+function isRelationshipShard(p) {
+    const posix = p.replaceAll("\\", "/");
+    return (posix.startsWith(".kb/relationships/") &&
+        (posix.endsWith(".yaml") || posix.endsWith(".yml")));
+}
+function isKibiMetadataPath(p) {
+    const posix = p.replaceAll("\\", "/");
+    return (isEntityMarkdown(posix) ||
+        isManifestFile(posix) ||
+        isRelationshipShard(posix) ||
+        posix === ".kb/manifest.json");
+}
+function decodeText(buffer) {
+    if (buffer.includes(0))
+        return { skipReason: "binary" };
     try {
-        const config = loadConfig(process.cwd());
-        if (config.paths.symbols) {
-            const configuredBase = config.paths.symbols.split(/[\\/]/).pop();
-            if (configuredBase && base === configuredBase)
-                return true;
-        }
+        return {
+            content: new TextDecoder("utf-8", { fatal: true }).decode(buffer),
+        };
     }
     catch {
-        // ignore config read errors
+        return { skipReason: "unsupported_encoding" };
     }
-    return false;
+}
+function parseMode(output) {
+    const text = output.toString("utf8");
+    return text.match(/^(\d{6})\s/)?.[1];
+}
+function normalizeNewFileHunks(ranges, content) {
+    const lineCount = Math.max(1, content.split(/\r?\n/).length);
+    for (const range of ranges) {
+        if (range.end === Number.MAX_SAFE_INTEGER)
+            range.end = lineCount;
+    }
+}
+/**
+ * Read every staged path from the index, preserving records that staged symbol
+ * validation cannot inspect deeply. Blob contents always come from Git rather
+ * than the working tree.
+ */
+// implements REQ-014
+export function getStagedInventory(exec = defaultGitArgsExec) {
+    let parsed;
+    try {
+        parsed = parseNameStatusNull(runGitArgs(["diff", "--cached", "--name-status", "-z", "--diff-filter=ACMRD"], exec).toString("utf8"));
+    }
+    catch (error) {
+        throw new Error(`failed to list staged files: ${String(error)}`);
+    }
+    return parsed.map((entry) => {
+        const status = entry.status[0] || "M";
+        const oldPath = status === "R" ? entry.parts[0] : undefined;
+        const path = status === "R"
+            ? (entry.parts[1] ?? entry.parts[0] ?? "")
+            : (entry.parts[0] ?? "");
+        const lookupPath = status === "D" ? (oldPath ?? path) : path;
+        const modeArgs = status === "D"
+            ? ["ls-tree", "-z", "HEAD", "--", lookupPath]
+            : ["ls-files", "--stage", "-z", "--", lookupPath];
+        const gitMode = parseMode(runGitArgs(modeArgs, exec));
+        if (gitMode === "120000" || gitMode === "160000") {
+            return {
+                path,
+                status,
+                ...(oldPath ? { oldPath } : {}),
+                hunkRanges: [],
+                gitMode,
+                analysisDepth: "none",
+                disposition: "skipped",
+                skipReason: gitMode === "120000" ? "symlink" : "submodule",
+            };
+        }
+        const diffText = runGitArgs(["diff", "--cached", "-U0", "--", path], exec).toString("utf8");
+        const isNewFile = status === "A" || /\bdev\/null\b/.test(diffText);
+        const hunkRanges = parseHunksFromDiff(diffText, isNewFile);
+        const blobArgs = status === "D" ? ["show", `HEAD:${lookupPath}`] : ["show", `:${path}`];
+        const decoded = decodeText(runGitArgs(blobArgs, exec));
+        if ("skipReason" in decoded) {
+            return {
+                path,
+                status,
+                ...(oldPath ? { oldPath } : {}),
+                hunkRanges,
+                diffText,
+                ...(gitMode ? { gitMode } : {}),
+                analysisDepth: "none",
+                disposition: "skipped",
+                skipReason: decoded.skipReason,
+            };
+        }
+        normalizeNewFileHunks(hunkRanges, decoded.content);
+        const deleted = status === "D";
+        const analysisDepth = deleted
+            ? "file"
+            : hasSupportedExt(path)
+                ? "symbol"
+                : isKibiMetadataPath(path)
+                    ? "metadata"
+                    : "file";
+        const content = deleted ? undefined : decoded.content;
+        const previousContent = deleted ? decoded.content : undefined;
+        return {
+            path,
+            status,
+            ...(oldPath ? { oldPath } : {}),
+            hunkRanges,
+            diffText,
+            ...(content !== undefined ? { content } : {}),
+            ...(previousContent !== undefined ? { previousContent } : {}),
+            ...(gitMode ? { gitMode } : {}),
+            analysisDepth,
+            disposition: analysisDepth === "file" ? "advisory" : "checked",
+        };
+    });
+}
+/** Convert the complete inventory to the historical supported staged-file set. */
+export function supportedStagedFiles(inventory) {
+    return inventory.flatMap((entry) => {
+        if (entry.status === "D" ||
+            entry.disposition === "skipped" ||
+            (entry.analysisDepth !== "symbol" && entry.analysisDepth !== "metadata")) {
+            return [];
+        }
+        const { analysisDepth: _analysisDepth, disposition: _disposition, gitMode: _gitMode, previousContent: _previousContent, skipReason: _skipReason, ...file } = entry;
+        return [file];
+    });
 }
 /**
  * Parse unified diff hunks (new-file coordinates) from git diff output
@@ -140,7 +259,7 @@ diffText, isNewFile = false) {
  * Get staged files with statuses, hunks and content.
  */
 // implements REQ-014
-export function getStagedFiles(exec = execSync) {
+export function getStagedFiles(exec = defaultExec) {
     // 1. get staged name-status -z
     let nameStatus;
     try {

package/dist/traceability/markdown-validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-validate.d.ts","sourceRoot":"","sources":["../../src/traceability/markdown-validate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,wBAAwB,CAgC1B"}
+{"version":3,"file":"markdown-validate.d.ts","sourceRoot":"","sources":["../../src/traceability/markdown-validate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,wBAAwB,CAgC1B"}

package/dist/traceability/markdown-validate.js

@@ -1,5 +1,6 @@
 import matter from "gray-matter";
 import { FrontmatterError, detectEmbeddedEntities, } from "../extractors/markdown.js";
+import { entityLaneForPath } from "../utils/kb-paths.js";
 export function validateStagedMarkdown(filePath, content) {
     const errors = [];
     try {
@@ -25,11 +26,15 @@ export function validateStagedMarkdown(filePath, content) {
     return { filePath, errors };
 }
 function inferTypeFromPath(filePath) {
-    if (filePath.includes("/requirements/"))
-        return "req";
-    if (filePath.includes("/scenarios/"))
-        return "scenario";
-    if (filePath.includes("/tests/"))
-        return "test";
-    return null;
+    const lane = entityLaneForPath(filePath);
+    switch (lane) {
+        case "requirements":
+            return "req";
+        case "scenarios":
+            return "scenario";
+        case "tests":
+            return "test";
+        default:
+            return null;
+    }
 }

package/dist/traceability/staged-diagnostics.d.ts

@@ -13,7 +13,14 @@ export interface KibiImpactDiagnostic extends QualityDiagnostic {
     message: string;
     /** Deterministic remediation guidance. */
     suggestion: string;
+    /**
+     * Cause-level lines (per file: extraction vs evidence symbol counts, the
+     * uncovered symbol names) rendered between the Files and Docs lines so the
+     * error names what to fix instead of only the verdict.
+     */
+    details?: readonly string[];
 }
+export declare function createMissingOverrideRationaleDiagnostic(evidence: KibiImpactEvidence): KibiImpactDiagnostic;
 /**
  * Collects deterministic staged diagnostics for Kibi impact enforcement.
  *

package/dist/traceability/staged-diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staged-diagnostics.d.ts","sourceRoot":"","sources":["../../src/traceability/staged-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAGL,KAAK,kBAAkB,EAIxB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,sBAAsB,GAC9B,8BAA8B,GAC9B,wBAAwB,GACxB,8BAA8B,GAC9B,+BAA+B,GAC/B,iCAAiC,GACjC,oCAAoC,GACpC,gCAAgC,GAChC,0BAA0B,GAC1B,2BAA2B,GAC3B,6BAA6B,GAC7B,yBAAyB,GACzB,wCAAwC,CAAC;AAE7C,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,uDAAuD;IACvD,EAAE,EAAE,sBAAsB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAgED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,kBAAkB,EAC5B,mBAAmB,GAAE,MAAmC,GACvD,oBAAoB,EAAE,CA8CxB"}
+{"version":3,"file":"staged-diagnostics.d.ts","sourceRoot":"","sources":["../../src/traceability/staged-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAGL,KAAK,kBAAkB,EAKxB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,sBAAsB,GAC9B,8BAA8B,GAC9B,wBAAwB,GACxB,8BAA8B,GAC9B,+BAA+B,GAC/B,iCAAiC,GACjC,oCAAoC,GACpC,gCAAgC,GAChC,0BAA0B,GAC1B,2BAA2B,GAC3B,6BAA6B,GAC7B,yBAAyB,GACzB,wCAAwC,CAAC;AAE7C,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,uDAAuD;IACvD,EAAE,EAAE,sBAAsB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAwID,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,kBAAkB,GAC3B,oBAAoB,CAoBtB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,kBAAkB,EAC5B,mBAAmB,GAAE,MAAmC,GACvD,oBAAoB,EAAE,CAiDxB"}

package/dist/traceability/staged-diagnostics.js

@@ -8,7 +8,46 @@ function deriveCoordinatesPath(symbolsManifestPath) {
 function formatFileList(paths) {
     return paths.join(", ");
 }
-function createMissingEvidenceDiagnostic(paths, symbolsManifestPath, coordinatesPath) {
+/** Max symbol names rendered per detail line before "+N more". */
+const MAX_DETAIL_NAMES = 6;
+function formatNameList(names) {
+    const shown = names.slice(0, MAX_DETAIL_NAMES);
+    const overflow = names.length - shown.length;
+    const rendered = shown.join(", ");
+    return overflow > 0 ? `${rendered} … and ${overflow} more` : rendered;
+}
+function symbolsManifestFileDetails(evidence, paths) {
+    const pathSet = new Set(paths);
+    return (evidence.symbolsManifest.fileDetails ?? []).filter((detail) => pathSet.has(detail.path));
+}
+function manifestDetailLines(detail, symbolsManifestPath) {
+    const lines = [
+        `${detail.path} — extraction finds ${detail.expectedCount} symbol(s), evidence covers ${detail.coveredCount}.`,
+    ];
+    if (detail.missing.length > 0) {
+        const names = detail.missing.map((entry) => `${entry.title} (line ${entry.line})`);
+        lines.push(`    Not in ${symbolsManifestPath}: ${formatNameList(names)}`);
+    }
+    if (detail.extra.length > 0) {
+        lines.push(`    Evidence without a matching symbol: ${formatNameList(detail.extra)}`);
+    }
+    return lines;
+}
+function createMissingEvidenceDiagnostic(paths, symbolsManifestPath, coordinatesPath, fileDetails = []) {
+    const uncoveredByPath = new Map(fileDetails
+        .filter((detail) => detail.missing.length > 0)
+        .map((detail) => [detail.path, detail]));
+    const details = paths.flatMap((filePath) => {
+        const detail = uncoveredByPath.get(filePath);
+        if (!detail)
+            return [];
+        return [
+            `${filePath} — symbols without authored evidence: ${formatNameList(detail.missing.map((entry) => entry.title))}`,
+        ];
+    });
+    const suggestionSuffix = details.length > 0
+        ? ` For symbol-level evidence, author ${symbolsManifestPath} entries (kibi upsert) for the listed uncovered symbols.`
+        : "";
     return {
         id: "kibi_impact_evidence_missing",
         severity: "error",
@@ -17,10 +56,27 @@ function createMissingEvidenceDiagnostic(paths, symbolsManifestPath, coordinates
         files: [...paths],
         docs: [KIBI_STAGED_IMPACT_EVIDENCE_DOC],
         message: `Behavior-changing staged files are missing staged Kibi impact evidence (see ${KIBI_STAGED_IMPACT_EVIDENCE_DOC}): ${formatFileList(paths)}`,
-        suggestion: `Query Kibi via MCP before deciding. MCP writes update KB state but do not stage tracked evidence; also stage requirement/scenario/test/fact/symbol markdown, authored ${symbolsManifestPath} metadata, or refreshed ${coordinatesPath}. Re-run kibi check --staged after staging tracked evidence.`,
+        suggestion: `Query Kibi via MCP before deciding. MCP writes update KB state but do not stage tracked evidence; also stage requirement/scenario/test/fact/symbol markdown, authored ${symbolsManifestPath} metadata, or refreshed ${coordinatesPath}. Re-run kibi check --staged after staging tracked evidence.${suggestionSuffix}`,
+        ...(details.length > 0
+            ? {
+                details,
+                evidence: {
+                    uncoveredSymbols: fileDetails.map((detail) => ({
+                        path: detail.path,
+                        titles: detail.missing.map((entry) => entry.title),
+                    })),
+                },
+            }
+            : {}),
     };
 }
-function createSymbolsManifestStaleDiagnostic(paths, symbolsManifestPath, coordinatesPath) {
+function createSymbolsManifestStaleDiagnostic(paths, symbolsManifestPath, coordinatesPath, fileDetails = []) {
+    const hasMissingSymbols = fileDetails.some((detail) => detail.missing.length > 0);
+    const details = fileDetails.flatMap((detail) => manifestDetailLines(detail, symbolsManifestPath));
+    const refreshSteps = `kibi sync --refresh-symbol-coordinates && git add ${coordinatesPath} ${symbolsManifestPath}, then re-run kibi check --staged.`;
+    const suggestion = hasMissingSymbols
+        ? `Author ${symbolsManifestPath} entries for the uncovered symbols (kibi upsert, with implements/covered_by links), then run ${refreshSteps}`
+        : `Run ${refreshSteps}`;
     return {
         id: "symbols_manifest_stale",
         severity: "error",
@@ -29,10 +85,24 @@ function createSymbolsManifestStaleDiagnostic(paths, symbolsManifestPath, coordi
         files: [coordinatesPath, ...paths],
         docs: [KIBI_STAGED_IMPACT_EVIDENCE_DOC],
         message: `${coordinatesPath} is stale or missing for staged source files: ${formatFileList(paths)}`,
-        suggestion: `Run kibi sync --refresh-symbol-coordinates && git add ${coordinatesPath} ${symbolsManifestPath}, then re-run kibi check --staged.`,
+        suggestion,
+        ...(fileDetails.length > 0
+            ? {
+                details,
+                evidence: {
+                    symbolsManifest: fileDetails.map((detail) => ({
+                        path: detail.path,
+                        expectedCount: detail.expectedCount,
+                        coveredCount: detail.coveredCount,
+                        missing: detail.missing,
+                        extra: detail.extra,
+                    })),
+                },
+            }
+            : {}),
     };
 }
-function createMissingOverrideRationaleDiagnostic(evidence) {
+export function createMissingOverrideRationaleDiagnostic(evidence) {
     if (evidence.mode.kind !== "no_impact_override") {
         throw new Error("Override rationale diagnostic requires a no-impact override");
     }
@@ -65,11 +135,12 @@ export function collectStagedKibiDiagnostics(evidence, symbolsManifestPath = KIB
     if ((evidence.symbolsManifest.state === "stale" ||
         evidence.symbolsManifest.state === "missing") &&
         evidence.symbolsManifest.sourcePaths.length > 0) {
-        diagnostics.push(createSymbolsManifestStaleDiagnostic([...evidence.symbolsManifest.sourcePaths].sort(), symbolsManifestPath, coordinatesPath));
+        const stalePaths = [...evidence.symbolsManifest.sourcePaths].sort();
+        diagnostics.push(createSymbolsManifestStaleDiagnostic(stalePaths, symbolsManifestPath, coordinatesPath, symbolsManifestFileDetails(evidence, stalePaths)));
     }
     const missingBehaviorPaths = getMissingBehaviorSourcePaths(evidence);
     if (missingBehaviorPaths.length > 0) {
-        diagnostics.push(createMissingEvidenceDiagnostic(missingBehaviorPaths, symbolsManifestPath, coordinatesPath));
+        diagnostics.push(createMissingEvidenceDiagnostic(missingBehaviorPaths, symbolsManifestPath, coordinatesPath, symbolsManifestFileDetails(evidence, missingBehaviorPaths)));
     }
     if (evidence.mode.kind === "no_impact_override" &&
         evidence.mode.override.sourcePaths.length === 0 &&

package/dist/traceability/staged-file-coverage.d.ts

@@ -0,0 +1,33 @@
+import type { StagedPath } from "./git-staged.js";
+export declare const STAGED_FILE_COVERAGE_RESULT_VERSION: "kibi.staged-file-coverage.v1";
+export interface StagedFileCoverageRecord {
+    path: string;
+    oldPath?: string;
+    status: StagedPath["status"];
+    analysisDepth: StagedPath["analysisDepth"];
+    disposition: StagedPath["disposition"];
+    reason?: StagedPath["skipReason"];
+    requirementIds: string[];
+    evidencePaths: string[];
+    providerId: string | null;
+}
+export interface StagedFileCoverageDiagnostic {
+    id: "staged_file_ownership_missing" | "staged_file_impact_review_needed";
+    severity: "warning";
+    blocking: false;
+    path: string;
+    message: string;
+    suggestion: string;
+    requirementIds: string[];
+    evidencePaths: string[];
+}
+export interface StagedFileCoverageResult {
+    version: typeof STAGED_FILE_COVERAGE_RESULT_VERSION;
+    files: StagedFileCoverageRecord[];
+    diagnostics: StagedFileCoverageDiagnostic[];
+}
+type GitReader = (args: readonly string[]) => Buffer;
+/** Resolve advisory file-level ownership from committed knowledge plus staged evidence. */
+export declare function analyzeStagedFileCoverage(inventory: readonly StagedPath[], reader?: GitReader): StagedFileCoverageResult;
+export {};
+//# sourceMappingURL=staged-file-coverage.d.ts.map

package/dist/traceability/staged-file-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-file-coverage.d.ts","sourceRoot":"","sources":["../../src/traceability/staged-file-coverage.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,mCAAmC,EAC9C,8BAAuC,CAAC;AAE1C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IAC3C,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,+BAA+B,GAAG,kCAAkC,CAAC;IACzE,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,mCAAmC,CAAC;IACpD,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,WAAW,EAAE,4BAA4B,EAAE,CAAC;CAC7C;AAGD,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AA+OrD,2FAA2F;AAC3F,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,UAAU,EAAE,EAChC,MAAM,GAAE,SAA4B,GACnC,wBAAwB,CA0G1B"}