kibi-cli 2.21.2 → 2.22.1

package/dist/operations/migration/symbol-legacy-links.js

@@ -0,0 +1,319 @@
+/*
+ Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ Copyright (C) 2026 Piotr Franczyk
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU Affero General Public License for more details.
+
+ 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 { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { load as parseYAML } from "js-yaml";
+import { createTsMorphSourceAnalysisProvider } from "../../extractors/symbols-ts.js";
+import { coarseLinkBehavioralNames, isTraceabilityRelationshipType, } from "../../public/symbol-granularity.js";
+import { extractSymbolsFromStagedFile, } from "../../traceability/symbol-extract.js";
+import { KB_PATHS } from "../../utils/kb-paths.js";
+import { writeFileAtomically } from "./kb-sources.js";
+/**
+ * Mark the coarse traceability links of a symbols manifest
+ * `granularity_reason: legacy-link`.
+ *
+ * A link is coarse by the staged granularity gate's own rule
+ * (`coarseLinkBehavioralNames`): the source declares behavioral symbols
+ * narrower than the manifest symbol, so `kibi check --staged` would block the
+ * first commit that touches it. The pass is idempotent and independent of
+ * the schema version: it marks whatever the current rule calls coarse and
+ * has no reason yet, and a second run finds nothing.
+ */
+/** Automatic migration action code of the legacy-link pass. */
+// implements REQ-cli-schema-migration
+export const SYMBOL_LEGACY_LINK_MARK_CODE = "symbol_legacy_link_mark";
+// implements REQ-cli-schema-migration
+export const SYMBOL_LEGACY_LINK_MARK_ACTION_ID = "symbol-legacy-link-mark";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function linkType(link) {
+    // A bare string link compiles as `implements`; a typed link keeps its type.
+    if (typeof link === "string")
+        return "implements";
+    return isRecord(link) ? link.type : undefined;
+}
+/** True when the record compiles at least one traceability relationship. */
+function hasTraceabilityRelationship(record) {
+    const links = Array.isArray(record.links) ? record.links : [];
+    const relationships = Array.isArray(record.relationships)
+        ? record.relationships
+        : [];
+    return [
+        ...links.map(linkType),
+        ...relationships.map((relationship) => isRecord(relationship) ? relationship.type : undefined),
+    ].some(isTraceabilityRelationshipType);
+}
+/**
+ * The analyzer the staged gate uses (the built-in ts-morph provider), built
+ * once per pass: a provider per file would rebuild the TypeScript project for
+ * every source the manifest names.
+ */
+function sharedAnalyzer() {
+    let provider = null;
+    return (filePath, content) => {
+        provider ??= createTsMorphSourceAnalysisProvider();
+        return provider.supportsFile(filePath)
+            ? provider.analyzeText(filePath, content)
+            : null;
+    };
+}
+function sourceSymbols(workspaceRoot, sourceFile, analyzeText) {
+    const absolutePath = path.isAbsolute(sourceFile)
+        ? sourceFile
+        : path.join(workspaceRoot, sourceFile);
+    if (!existsSync(absolutePath))
+        return [];
+    try {
+        return extractSymbolsFromStagedFile({
+            path: sourceFile,
+            status: "M",
+            hunkRanges: [{ start: 1, end: Number.MAX_SAFE_INTEGER }],
+            content: readFileSync(absolutePath, "utf8"),
+        }, undefined, { analyzeText });
+    }
+    catch {
+        return [];
+    }
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * True when `title` is an exported function, variable (not a class
+ * expression), interface, type or enum declaration of the source file
+ * and no class of that name exists. The extractor then reports `title`
+ * itself and no `title.*` member, so nothing is narrower and the link is not
+ * coarse: the full analysis reaches the same answer, only much slower, and a
+ * manifest names hundreds of such functions.
+ */
+function declaresMemberlessSymbol(workspaceRoot, sourceFile, title, cache) {
+    if (!/^[A-Za-z_$][\w$]*$/.test(title))
+        return false;
+    let content = cache.get(sourceFile);
+    if (content === undefined) {
+        try {
+            content = readFileSync(path.resolve(workspaceRoot, sourceFile), "utf8");
+        }
+        catch {
+            content = null;
+        }
+        cache.set(sourceFile, content);
+    }
+    if (content === null)
+        return false;
+    const name = escapeRegExp(title);
+    if (new RegExp(`\\bclass\\s+${name}\\b`).test(content))
+        return false;
+    return [
+        `^export\\s+(?:default\\s+)?(?:async\\s+)?function\\s*\\*?\\s*${name}\\s*[(<]`,
+        `^export\\s+(?:declare\\s+)?(?:interface|type|enum|const\\s+enum)\\s+${name}\\b`,
+        // A variable, unless its initializer is a class expression (members).
+        `^export\\s+(?:const|let|var)\\s+${name}\\s*(?::[^=\\n]*)?=\\s*(?!class\\b)\\S`,
+    ].some((pattern) => new RegExp(pattern, "m").test(content));
+}
+function digest(content) {
+    return createHash("sha256").update(content, "utf8").digest("hex");
+}
+/**
+ * The coarse links of `manifestPath` (default `.kb/symbols.yaml`) that carry
+ * no granularity_reason yet. Read-only.
+ */
+// implements REQ-cli-schema-migration, REQ-symbol-behavioral-anchors
+export function planSymbolLegacyLinks(workspaceRoot, manifestPath = KB_PATHS.symbolsManifest) {
+    const absolute = path.resolve(workspaceRoot, manifestPath);
+    let content;
+    try {
+        content = readFileSync(absolute, "utf8");
+    }
+    catch {
+        return { manifestPath, manifestHash: null, targets: [] };
+    }
+    const empty = { manifestPath, manifestHash: digest(content), targets: [] };
+    let parsed;
+    try {
+        parsed = parseYAML(content);
+    }
+    catch {
+        // A malformed manifest fails sync with its own diagnostic.
+        return empty;
+    }
+    if (!isRecord(parsed) || !Array.isArray(parsed.symbols))
+        return empty;
+    const targets = [];
+    const symbolsByFile = new Map();
+    const analyzeText = sharedAnalyzer();
+    const sourceText = new Map();
+    for (const record of parsed.symbols) {
+        if (!isRecord(record))
+            continue;
+        if (typeof record.id !== "string" ||
+            typeof record.title !== "string" ||
+            typeof record.sourceFile !== "string")
+            continue;
+        if (record.granularity_reason !== undefined)
+            continue;
+        if (!hasTraceabilityRelationship(record))
+            continue;
+        if (declaresMemberlessSymbol(workspaceRoot, record.sourceFile, record.title, sourceText))
+            continue;
+        let symbols = symbolsByFile.get(record.sourceFile);
+        if (symbols === undefined) {
+            symbols = sourceSymbols(workspaceRoot, record.sourceFile, analyzeText);
+            symbolsByFile.set(record.sourceFile, symbols);
+        }
+        const granularSymbols = coarseLinkBehavioralNames(record.title, symbols);
+        if (granularSymbols.length === 0)
+            continue;
+        targets.push({
+            id: record.id,
+            title: record.title,
+            sourceFile: record.sourceFile,
+            granularSymbols,
+        });
+    }
+    return { manifestPath, manifestHash: digest(content), targets };
+}
+function unquoted(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2 &&
+        (trimmed.startsWith('"') || trimmed.startsWith("'")) &&
+        trimmed.endsWith(trimmed[0] ?? "")) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/**
+ * Insert `granularity_reason: legacy-link` into each listed symbol entry,
+ * leaving every other byte of the manifest as it was.
+ */
+function withLegacyReasons(content, symbolIds) {
+    const lines = content.split("\n");
+    const output = [];
+    let activeId = null;
+    let activeHasReason = false;
+    let activePropertyIndent = "";
+    const flushLegacyReason = () => {
+        if (activeId !== null &&
+            symbolIds.has(activeId) &&
+            !activeHasReason &&
+            activePropertyIndent.length > 0) {
+            output.push(`${activePropertyIndent}granularity_reason: legacy-link`);
+            activeHasReason = true;
+        }
+    };
+    for (const line of lines) {
+        const idMatch = line.match(/^(\s*)-\s+id:\s+(.+?)\s*$/);
+        if (idMatch) {
+            flushLegacyReason();
+            activeId = unquoted(idMatch[2] ?? "");
+            activeHasReason = false;
+            activePropertyIndent = `${idMatch[1] ?? ""}  `;
+        }
+        if (activeId !== null && /^\s+granularity_reason:\s+/.test(line)) {
+            activeHasReason = true;
+        }
+        if (activeId !== null &&
+            symbolIds.has(activeId) &&
+            !activeHasReason &&
+            /^\s+status:\s+/.test(line)) {
+            const indent = line.match(/^\s*/)?.[0] ?? "";
+            output.push(`${indent}granularity_reason: legacy-link`);
+            activeHasReason = true;
+        }
+        output.push(line);
+    }
+    flushLegacyReason();
+    return output.join("\n");
+}
+/**
+ * Mark the coarse links found by `planSymbolLegacyLinks`. With
+ * `expectedHash` (a migration plan's evidence), the manifest must still hold
+ * the bytes the plan was read from; a manifest whose planned links are all
+ * marked already is left alone, so the pass is idempotent. Returns the ids
+ * marked, and the planned ones that could not be marked in place (an entry
+ * whose `id` is not its first key, for example).
+ */
+// implements REQ-cli-schema-migration, REQ-symbol-behavioral-anchors
+export function applySymbolLegacyLinks(workspaceRoot, options = {}) {
+    const plan = planSymbolLegacyLinks(workspaceRoot, options.manifestPath ?? KB_PATHS.symbolsManifest);
+    if (plan.targets.length === 0)
+        return { marked: [], unmarked: [] };
+    if (options.expectedHash !== undefined &&
+        plan.manifestHash !== options.expectedHash) {
+        throw new Error(`${plan.manifestPath} changed since planning; rerun kibi migrate and approve the new plan.`);
+    }
+    const ids = new Set(plan.targets
+        .map((target) => target.id)
+        .filter((id) => options.expectedIds === undefined || options.expectedIds.includes(id)));
+    if (ids.size === 0)
+        return { marked: [], unmarked: [] };
+    const absolute = path.resolve(workspaceRoot, plan.manifestPath);
+    const content = readFileSync(absolute, "utf8");
+    const next = withLegacyReasons(content, ids);
+    const marked = markedIds(content, next, ids);
+    if (marked === null)
+        throw new Error(`${plan.manifestPath}: legacy-link reasons could not be added without changing other symbol fields; add granularity_reason: legacy-link by hand.`);
+    if (marked.length > 0)
+        writeFileAtomically(absolute, next);
+    return {
+        marked,
+        unmarked: [...ids].filter((id) => !marked.includes(id)).sort(),
+    };
+}
+/**
+ * The ids whose only change between `before` and `after` is a new
+ * `granularity_reason: legacy-link`, or null when anything else changed.
+ */
+function markedIds(before, after, ids) {
+    try {
+        const previous = parseYAML(before);
+        const next = parseYAML(after);
+        if (!Array.isArray(previous.symbols) ||
+            !Array.isArray(next.symbols) ||
+            previous.symbols.length !== next.symbols.length)
+            return null;
+        const marked = [];
+        for (const [index, entry] of next.symbols.entries()) {
+            const old = previous.symbols[index];
+            if (!isRecord(entry) || !isRecord(old)) {
+                if (!isDeepStrictEqual(entry, old))
+                    return null;
+                continue;
+            }
+            const { granularity_reason: reason, ...rest } = entry;
+            const { granularity_reason: oldReason, ...oldRest } = old;
+            if (!isDeepStrictEqual(rest, oldRest))
+                return null;
+            if (reason === oldReason)
+                continue;
+            if (reason !== "legacy-link" ||
+                oldReason !== undefined ||
+                typeof entry.id !== "string" ||
+                !ids.has(entry.id))
+                return null;
+            marked.push(entry.id);
+        }
+        return marked.sort();
+    }
+    catch {
+        return null;
+    }
+}

package/dist/operations/mutation/context-warning.d.ts

@@ -1,13 +1,23 @@
 import type { UpsertInput } from "./types.js";
+/**
+ * Where the upsert's authored document lives. `writtenPath` is the file a
+ * real write just published; `targetPath` is the file a write would update
+ * (a dry run resolves it the same way the write does, because the preview
+ * entity's `source` is the runtime marker rather than the authored file).
+ */
+export interface UpsertDocumentPaths {
+    readonly writtenPath?: string | undefined;
+    readonly targetPath?: string | undefined;
+}
 /**
  * The body the authored document has, or will have, after this upsert: the
  * written file when there is one, the supplied body, the preserved body of
  * the entity's existing document, or the default a new requirement gets.
  */
-export declare function upsertDocumentBody(input: UpsertInput, entity: Readonly<Record<string, unknown>>, workspaceRoot: string, writtenPath?: string): string;
+export declare function upsertDocumentBody(input: UpsertInput, entity: Readonly<Record<string, unknown>>, workspaceRoot: string, paths?: UpsertDocumentPaths): string;
 /**
  * kb_upsert warning for a written entity whose body lacks context. The same
  * finding blocks `kb_check` as entity-context-missing, so agents see it first.
  */
-export declare function entityContextWarnings(input: UpsertInput, entity: Readonly<Record<string, unknown>>, workspaceRoot: string, writtenPath?: string): readonly string[];
+export declare function entityContextWarnings(input: UpsertInput, entity: Readonly<Record<string, unknown>>, workspaceRoot: string, paths?: UpsertDocumentPaths): readonly string[];
 //# sourceMappingURL=context-warning.d.ts.map

package/dist/operations/mutation/context-warning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-warning.d.ts","sourceRoot":"","sources":["../../../src/operations/mutation/context-warning.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C;;;;GAIG;AAEH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR;AAED;;;GAGG;AAEH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,MAAM,EAAE,CA2BnB"}
+{"version":3,"file":"context-warning.d.ts","sourceRoot":"","sources":["../../../src/operations/mutation/context-warning.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;GAIG;AAEH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,mBAAwB,GAC9B,MAAM,CAYR;AAED;;;GAGG;AAEH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,mBAAwB,GAC9B,SAAS,MAAM,EAAE,CA2BnB"}

package/dist/operations/mutation/context-warning.js

@@ -20,15 +20,15 @@ function readBody(workspaceRoot, source) {
  * the entity's existing document, or the default a new requirement gets.
  */
 // implements REQ-kb-entity-body-context
-export function upsertDocumentBody(input, entity, workspaceRoot, writtenPath) {
-    if (writtenPath !== undefined) {
-        const written = readBody(workspaceRoot, writtenPath);
+export function upsertDocumentBody(input, entity, workspaceRoot, paths = {}) {
+    if (paths.writtenPath !== undefined) {
+        const written = readBody(workspaceRoot, paths.writtenPath);
         if (written !== undefined)
             return written;
     }
     if (input.document?.body !== undefined)
         return input.document.body;
-    const existing = readBody(workspaceRoot, input.document?.path ?? entity.source);
+    const existing = readBody(workspaceRoot, input.document?.path ?? paths.targetPath ?? entity.source);
     if (existing !== undefined)
         return existing;
     return input.type === "req" ? `${String(entity.semantic_text ?? "")}\n` : "";
@@ -38,8 +38,8 @@ export function upsertDocumentBody(input, entity, workspaceRoot, writtenPath) {
  * finding blocks `kb_check` as entity-context-missing, so agents see it first.
  */
 // implements REQ-kb-entity-body-context
-export function entityContextWarnings(input, entity, workspaceRoot, writtenPath) {
-    const body = upsertDocumentBody(input, entity, workspaceRoot, writtenPath);
+export function entityContextWarnings(input, entity, workspaceRoot, paths = {}) {
+    const body = upsertDocumentBody(input, entity, workspaceRoot, paths);
     const semanticText = typeof entity.semantic_text === "string" && entity.semantic_text.trim()
         ? entity.semantic_text
         : input.type === "req"

package/dist/operations/mutation/source-authoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-authoring.d.ts","sourceRoot":"","sources":["../../../src/operations/mutation/source-authoring.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-authoring.d.ts","sourceRoot":"","sources":["../../../src/operations/mutation/source-authoring.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAOjF,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAmBH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI,CAiBN;AAED,KAAK,SAAS,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAExD,8EAA8E;AAE9E,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOpE;AAED;;;;GAIG;AAEH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,GAAG,IAAI,GACtB,IAAI,CAON;AAeD;;;;GAIG;AAEH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,IAAI,CAMN;AAED;;;;;;GAMG;AAEH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CA8BT;AAgBD,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAqCR;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAoBR;AAkCD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAyMD,uFAAuF;AAEvF,eAAO,MAAM,uBAAuB,uGAM1B,CAAC;AA8BX,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GACZ,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCzC;AAwRD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CA6C7C;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAChD,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA4DpC;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAiEpC;AAED;;;;GAIG;AAEH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,YAAY,EAAE,MAAM,GACnB,MAAM,CAsBR;AAED;;;;;;;GAOG;AAEH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAaT;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC5C,OAAO,CAAC,EAAE,gBAAgB,EAC1B,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC;IACT,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,GAAG,IAAI,CAAC,CA+IR;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3C,MAAM,CAOR"}

package/dist/operations/mutation/source-authoring.js

@@ -5,7 +5,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { dump as dumpYaml, load as loadYaml } from "js-yaml";
-import { parseDocument, stringify } from "yaml";
+import { isCollection, isMap, isNode, isScalar, parseDocument, stringify, } from "yaml";
 import { OperationError } from "../../cli-errors.js";
 import { requirementSemanticText } from "../../extractors/markdown.js";
 import { canonicalFilesystemPath } from "../../utils/canonical-path.js";
@@ -169,22 +169,32 @@ export function normalizeAuthoredSourcePath(workspaceRoot, source) {
         .relative(path.resolve(workspaceRoot), resolveContainedSourcePath(workspaceRoot, relative))
         .replaceAll(path.sep, "/");
 }
-function bodyAndFrontmatter(content) {
+/** The raw front matter block of a Markdown document, split at its fences. */
+function frontmatterBlock(content) {
     if (!content.startsWith("---"))
-        return { frontmatter: {}, body: content };
+        return undefined;
     const firstEnd = content.indexOf("\n", 3);
     if (firstEnd < 0)
-        return { frontmatter: {}, body: content };
+        return undefined;
     const marker = content.indexOf("\n---", firstEnd);
     if (marker < 0)
+        return undefined;
+    return {
+        opening: content.slice(0, firstEnd + 1),
+        raw: content.slice(firstEnd + 1, marker),
+        body: content.slice(marker + "\n---".length),
+    };
+}
+function bodyAndFrontmatter(content) {
+    const block = frontmatterBlock(content);
+    if (block === undefined)
         return { frontmatter: {}, body: content };
-    const raw = content.slice(firstEnd + 1, marker);
-    const parsed = loadYaml(raw);
+    const parsed = loadYaml(block.raw);
     return {
         frontmatter: parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
             ? parsed
             : {},
-        body: content.slice(marker + "\n---".length),
+        body: block.body,
     };
 }
 /**
@@ -238,6 +248,105 @@ function sourcePath(context, input, entity, existing) {
     }
     return resolveContainedSourcePath(context.workspaceRoot, relative);
 }
+/**
+ * Front matter keys an upsert never writes: runtime provenance/timestamps
+ * belong to the compiled entity, not to the authored source artifact, and
+ * relationships live in `links`/shards. Keeping them out also makes the
+ * source diff deterministic across CLI and MCP transports.
+ */
+const UNAUTHORED_FRONTMATTER_KEYS = new Set([
+    "id",
+    "type",
+    "source",
+    "links",
+    "relationships",
+    "created_at",
+    "updated_at",
+]);
+/** The front matter values an upsert of `entity` sets, in write order. */
+function entityFrontmatterUpdates(entity, existing, body) {
+    const updates = Object.fromEntries(Object.entries(entity).filter(([key, value]) => value !== undefined && !UNAUTHORED_FRONTMATTER_KEYS.has(key)));
+    updates.id = entity.id;
+    if (updates.title === undefined && existing.title === undefined) {
+        updates.title = entity.id;
+    }
+    updates.type = entity.type;
+    // The checked meaning is always stated, never derived from a body that now
+    // also carries context sections.
+    const semanticText = updates.semantic_text ?? existing.semantic_text;
+    if (entity.type === "req" &&
+        (typeof semanticText !== "string" || semanticText.trim() === "")) {
+        const derived = requirementSemanticText(body);
+        if (derived !== "")
+            updates.semantic_text = derived;
+    }
+    return updates;
+}
+/**
+ * Apply `updates` to an existing front matter block without re-serializing
+ * it: only keys whose value actually changes are rewritten (or appended), so
+ * every untouched key keeps its authored bytes (quoting, timestamps, flow
+ * lists, indentation, comments). Returns undefined when the block is not a
+ * plain block mapping that can be patched in place.
+ */
+// implements REQ-core-persistence
+function patchFrontmatter(raw, loaded, updates) {
+    const doc = parseDocument(raw);
+    if (doc.errors.length > 0)
+        return undefined;
+    const contents = doc.contents;
+    if (contents === null && raw.trim() !== "")
+        return undefined;
+    if (contents !== null && (!isMap(contents) || contents.flow)) {
+        return undefined;
+    }
+    const pairs = contents === null ? [] : contents.items;
+    const current = (doc.toJS() ?? {});
+    const edits = [];
+    const appended = [];
+    for (const [key, value] of Object.entries(updates)) {
+        const pair = pairs.find((candidate) => isScalar(candidate.key) && String(candidate.key.value) === key);
+        if (pair !== undefined &&
+            (isDeepStrictEqual(current[key], value) ||
+                isDeepStrictEqual(loaded[key], value))) {
+            continue;
+        }
+        const valueNode = pair?.value;
+        const flow = isCollection(valueNode) && valueNode.flow === true;
+        const text = dumpYaml({ [key]: value }, {
+            noRefs: true,
+            lineWidth: -1,
+            sortKeys: false,
+            ...(flow ? { flowLevel: 1 } : {}),
+        }).replace(/\n$/, "");
+        if (pair === undefined) {
+            appended.push(text);
+            continue;
+        }
+        const keyRange = isScalar(pair.key) ? pair.key.range : undefined;
+        if (!keyRange)
+            return undefined;
+        const start = keyRange[0];
+        let end = isNode(valueNode) && valueNode.range ? valueNode.range[1] : keyRange[2];
+        // `key:` with no value: replace through the end of the key's line.
+        if (end <= keyRange[1]) {
+            const lineEnd = raw.indexOf("\n", keyRange[1]);
+            end = lineEnd < 0 ? raw.length : lineEnd;
+        }
+        while (end > start && /[\r\n]/.test(raw[end - 1] ?? ""))
+            end -= 1;
+        edits.push({ start, end, text });
+    }
+    let patched = raw;
+    for (const edit of edits.sort((left, right) => right.start - left.start)) {
+        patched = `${patched.slice(0, edit.start)}${edit.text}${patched.slice(edit.end)}`;
+    }
+    if (appended.length > 0) {
+        const separator = patched === "" || patched.endsWith("\n") ? "" : "\n";
+        patched = `${patched}${separator}${appended.join("\n")}`;
+    }
+    return patched;
+}
 function renderEntityDocument(input, entity, existingContent) {
     const existing = existingContent
         ? bodyAndFrontmatter(existingContent)
@@ -249,35 +358,21 @@ function renderEntityDocument(input, entity, existingContent) {
             : input.type === "req"
                 ? `${String(entity.semantic_text ?? "").trim()}\n`
                 : "\n";
-    const frontmatter = {
-        ...existing.frontmatter,
-        ...Object.fromEntries(Object.entries(entity).filter(([key]) => 
-        // Runtime provenance/timestamps belong to the compiled entity, not to
-        // the authored source artifact. Keeping them out also makes the source
-        // diff deterministic across CLI and MCP transports.
-        ![
-            "id",
-            "type",
-            "source",
-            "links",
-            "relationships",
-            "created_at",
-            "updated_at",
-        ].includes(key))),
-    };
-    frontmatter.id = entity.id;
-    frontmatter.title ??= entity.id;
-    frontmatter.type = entity.type;
-    // The checked meaning is always stated, never derived from a body that now
-    // also carries context sections.
-    if (entity.type === "req" &&
-        (typeof frontmatter.semantic_text !== "string" ||
-            frontmatter.semantic_text.trim() === "")) {
-        const derived = requirementSemanticText(body);
-        if (derived !== "")
-            frontmatter.semantic_text = derived;
+    const updates = entityFrontmatterUpdates(entity, existing.frontmatter, body);
+    const bodySuffix = `${body.startsWith("\n") ? "" : "\n"}${body}`;
+    // An existing document keeps its authored front matter bytes; only the
+    // keys this upsert changes are rewritten.
+    const block = existingContent !== undefined
+        ? frontmatterBlock(existingContent)
+        : undefined;
+    if (block !== undefined) {
+        const patched = patchFrontmatter(block.raw, existing.frontmatter, updates);
+        if (patched !== undefined) {
+            return `${block.opening}${patched}\n---${bodySuffix}`;
+        }
     }
-    return `---\n${dumpYaml(frontmatter, { noRefs: true, lineWidth: -1, sortKeys: false })}---${body.startsWith("\n") ? "" : "\n"}${body}`;
+    const frontmatter = { ...existing.frontmatter, ...updates };
+    return `---\n${dumpYaml(frontmatter, { noRefs: true, lineWidth: -1, sortKeys: false })}---${bodySuffix}`;
 }
 /** Generated coordinate fields belong exclusively to `.kb/symbol-coordinates.yaml`. */
 // implements REQ-generated-coordinate-persistence

package/dist/operations/mutation/types.d.ts

@@ -52,7 +52,8 @@ export type UpsertPayload = {
     readonly updated: number;
     readonly relationships_created: number;
     readonly warnings: readonly string[];
-    readonly semanticAdvisor: SemanticAdvisorReceipt;
+    /** The requirement semantic advisor receipt; absent for other entity types. */
+    readonly semanticAdvisor?: SemanticAdvisorReceipt;
     /**
      * For a fact that carries claim_text: the stored claim_key, derived from
      * claim_text when the payload did not supply it, so the writer learns the

package/dist/operations/mutation/types.d.ts.map

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