kibi-cli 0.7.0 → 0.10.0

package/dist/public/ignore-policy.js

@@ -0,0 +1,219 @@
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import * as path from "node:path";
+import ignore from "ignore";
+const HARD_DENYLIST = [
+    ".kb",
+    ".git",
+    "node_modules",
+    "vendor",
+    "third_party",
+    ".sisyphus",
+    ".opencode",
+];
+function readIgnoreFileLines(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    try {
+        const content = readFileSync(filePath, "utf8");
+        return content
+            .split(/\r?\n/)
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith("#"));
+    }
+    catch {
+        return [];
+    }
+}
+function toPosix(p) {
+    return p.split(path.sep).join("/");
+}
+// implements REQ-001
+export function createRepoIgnorePolicy(workspaceRoot) {
+    const root = path.resolve(workspaceRoot);
+    // Load root .gitignore
+    const rootGitignorePath = path.join(root, ".gitignore");
+    const rootGitPatterns = readIgnoreFileLines(rootGitignorePath);
+    // Load .git/info/exclude
+    const gitInfoExcludePath = path.join(root, ".git", "info", "exclude");
+    const gitInfoPatterns = readIgnoreFileLines(gitInfoExcludePath);
+    // Find nested .gitignore files (skip scanning inside hard denylist directories)
+    const nestedPatterns = new Map();
+    function walk(dirAbs) {
+        let entries;
+        try {
+            entries = readdirSync(dirAbs, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const ent of entries) {
+            const name = String(ent.name);
+            const abs = path.join(dirAbs, name);
+            if (ent.isDirectory()) {
+                // avoid descending into common heavy or control directories
+                if (HARD_DENYLIST.includes(name))
+                    continue;
+                // also avoid .git itself to prevent reading internal excludes as nested
+                if (name === ".git")
+                    continue;
+                walk(abs);
+            }
+            else if (ent.isFile()) {
+                if (name === ".gitignore") {
+                    // skip root .gitignore (we already loaded it)
+                    if (path.resolve(dirAbs) === root)
+                        continue;
+                    const patterns = readIgnoreFileLines(abs);
+                    const relDir = path.relative(root, dirAbs) || ".";
+                    nestedPatterns.set(toPosix(relDir), patterns);
+                }
+            }
+        }
+    }
+    walk(root);
+    // Create ignore instances
+    const rootIgnore = ignore();
+    if (rootGitPatterns.length > 0)
+        rootIgnore.add(rootGitPatterns);
+    const gitInfoIgnore = ignore();
+    if (gitInfoPatterns.length > 0)
+        gitInfoIgnore.add(gitInfoPatterns);
+    const nestedIgnoreMap = new Map();
+    for (const [dirRel, pats] of nestedPatterns.entries()) {
+        const ig = ignore();
+        if (pats.length > 0)
+            ig.add(pats);
+        nestedIgnoreMap.set(dirRel, ig);
+    }
+    // Prepare nested directories sorted by specificity (longest first)
+    const nestedDirsSorted = Array.from(nestedIgnoreMap.keys()).sort((a, b) => b.length - a.length);
+    function isPathOutsideWorkspace(absPath) {
+        const rel = path.relative(root, absPath);
+        // path.relative returns paths starting with '..' for outside
+        return rel === "" ? false : rel.split(path.sep)[0] === "..";
+    }
+    function matchesHardDeny(relPosix) {
+        const segments = relPosix.split("/").filter(Boolean);
+        for (const deny of HARD_DENYLIST) {
+            if (segments.includes(deny))
+                return true;
+        }
+        return false;
+    }
+    function isIgnoredInternal(inputPath) {
+        // Resolve to absolute and relative path inside workspace
+        const abs = path.isAbsolute(inputPath) ? path.resolve(inputPath) : path.resolve(root, inputPath);
+        if (path.isAbsolute(inputPath) && isPathOutsideWorkspace(abs)) {
+            return { ignored: true, reason: "outside_workspace" };
+        }
+        const rel = path.relative(root, abs) || ".";
+        const relPosix = toPosix(rel);
+        // Hard denylist always wins
+        if (matchesHardDeny(relPosix))
+            return { ignored: true, reason: "hard_deny" };
+        // Root .gitignore
+        try {
+            if (rootGitPatterns.length > 0 && rootIgnore.ignores(relPosix)) {
+                return { ignored: true, reason: "gitignored" };
+            }
+        }
+        catch (e) {
+            // ignore errors from library usage; continue
+        }
+        // .git/info/exclude
+        try {
+            if (gitInfoPatterns.length > 0 && gitInfoIgnore.ignores(relPosix)) {
+                return { ignored: true, reason: "git_info_exclude" };
+            }
+        }
+        catch (e) {
+            // noop
+        }
+        // Nested .gitignore (apply relative to their directory)
+        for (const dirRel of nestedDirsSorted) {
+            // dirRel is '.' for nested at root which we skipped, so dirRel will be like 'docs'
+            if (dirRel === ".")
+                continue;
+            if (relPosix === dirRel || relPosix.startsWith(dirRel + "/")) {
+                const sub = relPosix === dirRel ? "." : relPosix.slice(dirRel.length + 1);
+                const ig = nestedIgnoreMap.get(dirRel);
+                try {
+                    if (ig && ig.ignores(sub))
+                        return { ignored: true, reason: "gitignored" };
+                }
+                catch (e) {
+                    // noop
+                }
+            }
+        }
+        return { ignored: false };
+    }
+    function getFastGlobIgnoreGlobs() {
+        const globs = [];
+        // Hard denylist globs
+        for (const d of HARD_DENYLIST) {
+            // match directory and its contents anywhere
+            globs.push(`**/${d}/**`);
+            globs.push(`**/${d}`);
+        }
+        // Root .gitignore patterns (convert to simple globs)
+        for (const p of rootGitPatterns) {
+            if (!p || p.startsWith("#") || p.startsWith("!"))
+                continue;
+            let pat = p;
+            if (pat.startsWith("/"))
+                pat = pat.slice(1);
+            if (pat.includes("/")) {
+                // anchored path
+                globs.push(`**/${toPosix(pat)}`);
+            }
+            else {
+                globs.push(`**/${pat}`);
+            }
+        }
+        // .git/info/exclude patterns
+        for (const p of gitInfoPatterns) {
+            if (!p || p.startsWith("#") || p.startsWith("!"))
+                continue;
+            let pat = p;
+            if (pat.startsWith("/"))
+                pat = pat.slice(1);
+            if (pat.includes("/")) {
+                globs.push(`**/${toPosix(pat)}`);
+            }
+            else {
+                globs.push(`**/${pat}`);
+            }
+        }
+        // Nested .gitignore patterns - prefix with directory path
+        // Use the raw patterns collected in nestedPatterns so we scope patterns
+        // to the nested directory instead of ignoring the entire directory.
+        // Debug: print nested patterns and the computed globs to help diagnosing test failures.
+        for (const [dirRel, patterns] of nestedPatterns.entries()) {
+            for (const p of patterns) {
+                if (!p || p.startsWith("#") || p.startsWith("!"))
+                    continue;
+                let pat = p;
+                if (pat.startsWith("/"))
+                    pat = pat.slice(1);
+                const prefix = dirRel === "." ? "" : `${dirRel}/`;
+                if (pat.includes("/")) {
+                    globs.push(`**/${prefix}${toPosix(pat)}`);
+                }
+                else {
+                    globs.push(`**/${prefix}${pat}`);
+                }
+            }
+        }
+        return Array.from(new Set(globs));
+    }
+    return {
+        isIgnored(inputPath) {
+            return isIgnoredInternal(inputPath).ignored;
+        },
+        getFastGlobIgnoreGlobs,
+        explain(inputPath) {
+            return isIgnoredInternal(inputPath);
+        },
+    };
+}

package/dist/public/operational-artifacts.d.ts

@@ -0,0 +1,2 @@
+export declare function isOperationalArtifactPath(pathLike: string): boolean;
+//# sourceMappingURL=operational-artifacts.d.ts.map

package/dist/public/operational-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational-artifacts.d.ts","sourceRoot":"","sources":["../../src/public/operational-artifacts.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInE"}

package/dist/public/operational-artifacts.js

@@ -0,0 +1,4 @@
+export function isOperationalArtifactPath(pathLike) {
+    const normalized = pathLike.replaceAll("\\", "/");
+    return /(^|\/)\.sisyphus\//.test(normalized);
+}

package/dist/public/schema-version.d.ts

@@ -0,0 +1,3 @@
+export type { SchemaVersionStatus } from "../utils/schema-version.js";
+export { LATEST_KB_SCHEMA_VERSION, getSchemaVersionStatus, normalizeSchemaVersion, } from "../utils/schema-version.js";
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/public/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/public/schema-version.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC"}

package/dist/public/schema-version.js

@@ -0,0 +1 @@
+export { LATEST_KB_SCHEMA_VERSION, getSchemaVersionStatus, normalizeSchemaVersion, } from "../utils/schema-version.js";

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;AAGD,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,CAyBxB;AA+FD,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;AAmGD,wBAAsB,gBAAgB,CAEpC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB"}

package/dist/search-ranking.js

@@ -1,10 +1,47 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+const SEARCH_STOP_WORDS = new Set([
+    "to",
+    "in",
+    "out",
+    "log",
+    "logged",
+    "unable",
+    "the",
+    "a",
+    "an",
+    "is",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "being",
+    "have",
+    "has",
+    "had",
+    "do",
+    "does",
+    "did",
+    "will",
+    "would",
+    "could",
+    "should",
+    "may",
+    "might",
+    "shall",
+    "can",
+    "not",
+]);
 // implements REQ-mcp-search-discovery, REQ-002, REQ-003
 export async function rankEntities(entities, query, workspaceRoot) {
+    const queryContext = buildSearchQueryContext(query);
+    if (!queryContext.rawTrimmedQuery || queryContext.signalTokens.length === 0) {
+        return [];
+    }
     const matches = [];
     for (const entity of entities) {
-        const match = await rankEntity(entity, query, workspaceRoot);
+        const match = await rankEntity(entity, queryContext, workspaceRoot);
         if (match) {
             matches.push(match);
         }
@@ -22,9 +59,8 @@ export async function rankEntities(entities, query, workspaceRoot) {
     });
     return matches;
 }
-async function rankEntity(entity, query, workspaceRoot) {
-    const normalizedQuery = normalize(query);
-    const tokens = normalizedQuery.split(/\s+/).filter(Boolean);
+// implements REQ-mcp-search-discovery
+async function rankEntity(entity, queryContext, workspaceRoot) {
     const reasons = [];
     let score = 0;
     const id = String(entity.id ?? "");
@@ -37,55 +73,56 @@ async function rankEntity(entity, query, workspaceRoot) {
     const tags = Array.isArray(entity.tags)
         ? entity.tags.map((tag) => String(tag))
         : [];
-    const normalizedTitle = normalize(title);
-    const normalizedId = normalize(id);
-    if (normalizedTitle === normalizedQuery) {
+    const titleForms = buildSearchTextForms(title);
+    const idForms = buildSearchTextForms(id);
+    if (isExactSearchMatch(titleForms, queryContext.phrase)) {
         score += 100;
         reasons.push("exact title match");
     }
-    else if (normalizedTitle.includes(normalizedQuery)) {
+    else if (isPhraseSearchMatch(titleForms, queryContext.phrase)) {
         score += 60;
         reasons.push("title phrase match");
     }
-    if (normalizedId === normalizedQuery) {
+    if (isExactSearchMatch(idForms, queryContext.phrase)) {
         score += 90;
         reasons.push("exact ID match");
     }
-    else if (normalizedId.includes(normalizedQuery)) {
+    else if (isPhraseSearchMatch(idForms, queryContext.phrase)) {
         score += 55;
         reasons.push("ID match");
     }
     const metadataFields = [type, source, owner, priority, severity];
-    const metadataMatched = metadataFields.some((field) => normalize(field).includes(normalizedQuery));
+    const metadataMatched = metadataFields.some((field) => isPhraseSearchMatch(buildSearchTextForms(field), queryContext.phrase));
     if (metadataMatched) {
         score += 20;
         reasons.push("metadata match");
     }
-    const matchingTags = tags.filter((tag) => normalize(tag).includes(normalizedQuery));
+    const matchingTags = tags.filter((tag) => isPhraseSearchMatch(buildSearchTextForms(tag), queryContext.phrase));
     if (matchingTags.length > 0) {
         score += 30;
         reasons.push("tag match");
     }
-    const titleTokenMatches = countTokenMatches(normalizedTitle, tokens);
+    const titleTokenMatches = countTokenMatches(titleForms, queryContext.signalTokens);
     if (titleTokenMatches > 0) {
         score += titleTokenMatches * 8;
         reasons.push("title token coverage");
     }
-    const bodyText = await loadMarkdownBody(source, workspaceRoot);
+    const bodyText = (await loadMarkdownBody(source, workspaceRoot)) ??
+        getInlineBodyText(entity);
     let snippet;
     if (bodyText) {
-        const normalizedBody = normalize(bodyText);
-        if (normalizedBody.includes(normalizedQuery)) {
+        const bodyForms = buildSearchTextForms(bodyText);
+        if (isPhraseSearchMatch(bodyForms, queryContext.phrase)) {
             score += 15;
             reasons.push("markdown body match");
-            snippet = buildSnippet(bodyText, query);
+            snippet = buildSnippet(bodyText, queryContext.phrase);
         }
         else {
-            const bodyTokenMatches = countTokenMatches(normalizedBody, tokens);
+            const bodyTokenMatches = countTokenMatches(bodyForms, queryContext.signalTokens);
             if (bodyTokenMatches > 0) {
                 score += bodyTokenMatches * 3;
                 reasons.push("markdown body token coverage");
-                snippet = buildSnippet(bodyText, query);
+                snippet = buildSnippet(bodyText, queryContext.phrase);
             }
         }
     }
@@ -126,6 +163,7 @@ source, workspaceRoot) {
         return null;
     }
 }
+// implements REQ-mcp-search-discovery
 function stripFrontmatter(content) {
     const trimmedContent = content.trimStart();
     if (!trimmedContent.startsWith("---")) {
@@ -143,19 +181,88 @@ function stripFrontmatter(content) {
     }
     return trimmedContent.slice(match.index + match[0].length);
 }
-function normalize(value) {
-    return value.trim().toLowerCase();
+// implements REQ-mcp-search-discovery
+function buildSearchQueryContext(query) {
+    return {
+        phrase: buildSearchTextForms(query),
+        signalTokens: tokenizeSignalTerms(query),
+        rawTrimmedQuery: query.trim(),
+    };
+}
+// implements REQ-mcp-search-discovery
+function buildSearchTextForms(value) {
+    const normalized = normalizeSearchText(value);
+    return {
+        normalized,
+        compact: normalized.replace(/\s+/g, ""),
+    };
+}
+// implements REQ-mcp-search-discovery
+function normalizeSearchText(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[-_]+/g, " ")
+        .replace(/[^a-z0-9\s]+/g, " ")
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(singularizeSimplePlural)
+        .join(" ");
+}
+// implements REQ-mcp-search-discovery
+function tokenizeSignalTerms(value) {
+    return Array.from(new Set(normalizeSearchText(value)
+        .split(/\s+/)
+        .filter((token) => token && !SEARCH_STOP_WORDS.has(token))));
 }
+// implements REQ-mcp-search-discovery
+function singularizeSimplePlural(token) {
+    if (token.length <= 4 ||
+        !token.endsWith("s") ||
+        token.endsWith("ss") ||
+        token.endsWith("us") ||
+        token.endsWith("is")) {
+        return token;
+    }
+    return token.slice(0, -1);
+}
+// implements REQ-mcp-search-discovery
+function isExactSearchMatch(haystack, needle) {
+    return (haystack.normalized === needle.normalized ||
+        (needle.compact !== "" && haystack.compact === needle.compact));
+}
+// implements REQ-mcp-search-discovery
+function isPhraseSearchMatch(haystack, needle) {
+    return (haystack.normalized.includes(needle.normalized) ||
+        (needle.compact !== "" && haystack.compact.includes(needle.compact)));
+}
+// implements REQ-mcp-search-discovery
 function countTokenMatches(haystack, tokens) {
-    return tokens.filter((token) => haystack.includes(token)).length;
+    return tokens.filter((token) => haystack.normalized.includes(token) || haystack.compact.includes(token)).length;
+}
+// implements REQ-mcp-search-discovery
+function getInlineBodyText(entity) {
+    const candidates = [
+        entity.body,
+        entity.markdownBody,
+        entity.markdown_body,
+        entity.content,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === "string" && candidate.trim() !== "") {
+            return candidate;
+        }
+    }
+    return null;
 }
-function buildSnippet(bodyText, query) {
+// implements REQ-mcp-search-discovery
+function buildSnippet(bodyText, queryForms) {
     const lines = bodyText
         .split(/\r?\n/)
         .map((line) => line.trim())
         .filter(Boolean);
-    const normalizedQuery = normalize(query);
-    const matchedLine = lines.find((line) => normalize(line).includes(normalizedQuery)) ?? lines[0];
+    const matchedLine = lines.find((line) => isPhraseSearchMatch(buildSearchTextForms(line), queryForms)) ?? lines[0];
     if (!matchedLine) {
         return undefined;
     }

package/dist/utils/config.d.ts

@@ -35,6 +35,7 @@ export interface BriefsConfig {
  */
 export interface KbConfig {
     paths: KbConfigPaths;
+    schemaVersion?: number | string;
     briefs?: BriefsConfig;
     /**
      * @deprecated defaultBranch is deprecated. Branch lifecycle now follows git naturally

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,OAAO,CAAC;QAChB,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;IACF,GAAG,EAAE;QACH,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAwBxD,eAAO,MAAM,cAAc,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAexD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAShC,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAqChE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAqCpE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,OAAO,CAAC;QAChB,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;IACF,GAAG,EAAE;QACH,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAwBxD,eAAO,MAAM,cAAc,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAgBxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAShC,CAAC;AA8CF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAiChE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAiCpE"}

package/dist/utils/config.js

@@ -18,6 +18,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import * as path from "node:path";
 import { DEFAULT_CHECKS_CONFIG, } from "./rule-registry.js";
+import { LATEST_KB_SCHEMA_VERSION } from "./schema-version.js";
 /**
  * Default configuration values for new repositories.
  */
@@ -41,6 +42,7 @@ const DEFAULT_BRIEFS_CONFIG = {
 // implements REQ-003
 export const DEFAULT_CONFIG = {
     $schema: "https://raw.githubusercontent.com/Looted/kibi/master/packages/cli/schema/config.json",
+    schemaVersion: LATEST_KB_SCHEMA_VERSION,
     paths: {
         requirements: "documentation/requirements",
         scenarios: "documentation/scenarios",
@@ -85,6 +87,27 @@ function mergeBriefsConfig(userBriefs) {
         },
     };
 }
+function readUserConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return {
+            userConfig: {},
+            useDefaultSchemaVersion: true,
+        };
+    }
+    try {
+        const content = readFileSync(configPath, "utf8");
+        return {
+            userConfig: JSON.parse(content),
+            useDefaultSchemaVersion: false,
+        };
+    }
+    catch {
+        return {
+            userConfig: {},
+            useDefaultSchemaVersion: true,
+        };
+    }
+}
 /**
  * Load and parse the Kibi configuration from .kb/config.json.
  * Falls back to DEFAULT_CONFIG if the file doesn't exist or is invalid.
@@ -95,22 +118,17 @@ function mergeBriefsConfig(userBriefs) {
 export function loadConfig(cwd = process.cwd()) {
     // implements REQ-003
     const configPath = path.join(cwd, ".kb/config.json");
-    let userConfig = {};
-    if (existsSync(configPath)) {
-        try {
-            const content = readFileSync(configPath, "utf8");
-            userConfig = JSON.parse(content);
-        }
-        catch {
-            // Invalid config, use defaults
-            userConfig = {};
-        }
-    }
+    const { userConfig, useDefaultSchemaVersion } = readUserConfig(configPath);
     return {
         paths: {
             ...DEFAULT_CONFIG.paths,
             ...userConfig.paths,
         },
+        ...((userConfig.schemaVersion !== undefined || useDefaultSchemaVersion)
+            ? {
+                schemaVersion: userConfig.schemaVersion ?? DEFAULT_CONFIG.schemaVersion,
+            }
+            : {}),
         briefs: mergeBriefsConfig(userConfig.briefs),
         ...(userConfig.defaultBranch !== undefined
             ? { defaultBranch: userConfig.defaultBranch }
@@ -140,22 +158,17 @@ export function loadConfig(cwd = process.cwd()) {
 export function loadSyncConfig(cwd = process.cwd()) {
     // implements REQ-003
     const configPath = path.join(cwd, ".kb/config.json");
-    let userConfig = {};
-    if (existsSync(configPath)) {
-        try {
-            const content = readFileSync(configPath, "utf8");
-            userConfig = JSON.parse(content);
-        }
-        catch {
-            // Invalid config, use defaults
-            userConfig = {};
-        }
-    }
+    const { userConfig, useDefaultSchemaVersion } = readUserConfig(configPath);
     return {
         paths: {
             ...DEFAULT_SYNC_PATHS,
             ...userConfig.paths,
         },
+        ...((userConfig.schemaVersion !== undefined || useDefaultSchemaVersion)
+            ? {
+                schemaVersion: userConfig.schemaVersion ?? DEFAULT_CONFIG.schemaVersion,
+            }
+            : {}),
         briefs: mergeBriefsConfig(userConfig.briefs),
         ...(userConfig.defaultBranch !== undefined
             ? { defaultBranch: userConfig.defaultBranch }

package/dist/utils/rule-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-registry.d.ts","sourceRoot":"","sources":["../../src/utils/rule-registry.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,cAAc,EAqEjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,aAAoC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAC;AAEF;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,CAAC,CAsBb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAWd"}
+{"version":3,"file":"rule-registry.d.ts","sourceRoot":"","sources":["../../src/utils/rule-registry.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,cAAc,EA4EjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,aAAoC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAC;AAEF;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,CAAC,CAsBb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAWd"}

package/dist/utils/rule-registry.js

@@ -81,6 +81,12 @@ export const RULES = [
         defaultEnabled: false,
         category: "integrity",
     },
+    {
+        name: "strict-readiness",
+        description: "Report strict contradiction-readiness levels for requirements that are still prose-only or otherwise not contradiction-ready",
+        defaultEnabled: false,
+        category: "integrity",
+    },
 ];
 /**
  * Set of all rule names for quick lookups.

package/dist/utils/schema-version.d.ts

@@ -0,0 +1,14 @@
+import type { KbConfig } from "./config.js";
+export declare const LATEST_KB_SCHEMA_VERSION = 1;
+export interface SchemaVersionStatus {
+    status: "missing" | "invalid" | "older" | "current" | "newer";
+    currentVersion: number | null;
+    latestVersion: number;
+    needsMigration: boolean;
+    warning: string | null;
+}
+type SchemaVersionConfig = Pick<KbConfig, "schemaVersion"> | null | undefined;
+export declare function normalizeSchemaVersion(schemaVersion: number | string | null | undefined): number | null;
+export declare function getSchemaVersionStatus(config?: SchemaVersionConfig): SchemaVersionStatus;
+export {};
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/utils/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/utils/schema-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAC9D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAG9E,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,GAAG,IAAI,CAgBf;AAGD,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,mBAAmB,CA8CrB"}