kibi-cli 2.3.0 → 2.4.0

package/dist/cli-json-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-json-command.d.ts","sourceRoot":"","sources":["../src/cli-json-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIpE;AAGD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KACpC,EAAE,CAAC;CACL,CAAC;AAkDF,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,IAAI,CAAC,CAuGf"}
+{"version":3,"file":"cli-json-command.d.ts","sourceRoot":"","sources":["../src/cli-json-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIpE;AAGD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KACpC,EAAE,CAAC;CACL,CAAC;AAkDF,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,IAAI,CAAC,CAuGf"}

package/dist/cli-json-command.js

@@ -4,7 +4,7 @@ import { loadInput } from "./cli-input.js";
 import { loadOperationSpec } from "./cli-operation-loader.js";
 import { executeOperation as executeProtocolOperation } from "./cli-protocol.js";
 import { prepareOperationInput } from "./cli-validate.js";
-import { appendCliDiagnosticUsage } from "./public/diagnostic-usage.js";
+import { appendCliDiagnosticUsage, diagnosticEnvOptIn, } from "./public/diagnostic-usage.js";
 import { createCliRuntime } from "./runtime/cli-runtime.js";
 export function writeOptionalStderr(stderr) {
     if (stderr !== undefined) {
@@ -30,7 +30,7 @@ function findInputConflicts(invocation) {
     return [...positionalConflicts, ...optionConflicts];
 }
 function diagnosticModeEnabled(command) {
-    return (process.env.KIBI_CLI_DIAGNOSTIC_MODE === "1" ||
+    return (diagnosticEnvOptIn() ||
         process.argv.includes("--diagnostic-mode") ||
         command.optsWithGlobals().diagnosticMode === true);
 }

package/dist/cli-operation-metadata.d.ts

@@ -55,7 +55,7 @@ export declare const CLI_OPERATION_METADATA: readonly [{
 }, {
     readonly name: "kb_plan_bootstrap";
     readonly cliName: "plan-bootstrap";
-    readonly description: "Generate a deterministic, snapshot-bound kibi.bootstrap-plan.v1 for repository onboarding. Read-only analysis returns evidence, bounded context questions, exact dependency-ordered actions, a canonical plan hash, and no mutation side effects.";
+    readonly description: "Generate a deterministic, snapshot-bound kibi.bootstrap-plan.v1 for repository onboarding. Read-only analysis of the repository plus any declared knowledge sources and cited intent claims returns evidence, bounded context questions, exact dependency-ordered actions, a canonical plan hash, and no mutation side effects.";
 }, {
     readonly name: "kb_validate_upsert";
     readonly cliName: "validate-upsert";

package/dist/cli-operation-metadata.js

@@ -65,7 +65,7 @@ export const CLI_OPERATION_METADATA = [
     {
         name: "kb_plan_bootstrap",
         cliName: "plan-bootstrap",
-        description: "Generate a deterministic, snapshot-bound kibi.bootstrap-plan.v1 for repository onboarding. Read-only analysis returns evidence, bounded context questions, exact dependency-ordered actions, a canonical plan hash, and no mutation side effects.",
+        description: "Generate a deterministic, snapshot-bound kibi.bootstrap-plan.v1 for repository onboarding. Read-only analysis of the repository plus any declared knowledge sources and cited intent claims returns evidence, bounded context questions, exact dependency-ordered actions, a canonical plan hash, and no mutation side effects.",
     },
     {
         name: "kb_validate_upsert",

package/dist/cli-register-maintenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-register-maintenance.d.ts","sourceRoot":"","sources":["../src/cli-register-maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2JlE"}
+{"version":3,"file":"cli-register-maintenance.d.ts","sourceRoot":"","sources":["../src/cli-register-maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6KlE"}

package/dist/cli-register-maintenance.js

@@ -68,6 +68,13 @@ export function registerMaintenanceCommands(program) {
         .option("--format <format>", "Output format: json|table", "table")
         .option("--limit <n>", "Limit rendered table rows", "50")
         .action(withExitCode(async (options) => (await import("./commands/usage-remediation.js")).usageRemediationCommand(options)));
+    program
+        .command("merge-driver")
+        .description("Git merge driver: three-way merge .kb/symbols.yaml or a relationship shard by record id")
+        .argument("<base>", "Common ancestor version (%O)")
+        .argument("<current>", "Current version, overwritten with the result (%A)")
+        .argument("<other>", "Other branch's version (%B)")
+        .action(withExitCode(async (base, current, other) => (await import("./commands/merge-driver.js")).mergeDriverCommand(base, current, other)));
     program
         .command("branch")
         .description("Manage branch KBs")

package/dist/commands/merge-driver.d.ts

@@ -0,0 +1,31 @@
+import type { CommandResult } from "../cli-command.js";
+export type KbManifestMergeResult = {
+    readonly status: "merged";
+    readonly content: string;
+} | {
+    readonly status: "conflict";
+    readonly conflicts: readonly string[];
+};
+/**
+ * Three-way merge of an id-keyed Kibi manifest (`.kb/symbols.yaml` or a
+ * `.kb/relationships/*.yaml` shard).
+ *
+ * Both sides usually append new records at the end of the list, which Git
+ * reports as a conflict although the additions are independent. This merge
+ * keeps every record either side added, applies edits made on only one
+ * side, honors a deletion made on one side when the other left the record
+ * unchanged, and unions concurrent relationship and link additions on one
+ * symbol. Anything else both sides changed differently is a real conflict
+ * and is reported rather than guessed.
+ */
+export declare function mergeKbManifests(baseContent: string, oursContent: string, theirsContent: string): KbManifestMergeResult;
+/**
+ * Git merge driver entry point: `kibi merge-driver %O %A %B`.
+ *
+ * Writes the merged manifest to the current (`%A`) file and exits 0. On a
+ * real conflict it prints each one and falls back to Git's textual merge so
+ * the file carries ordinary conflict markers, then exits 1 so Git keeps the
+ * path unmerged.
+ */
+export declare function mergeDriverCommand(basePath: string, currentPath: string, otherPath: string): Promise<CommandResult>;
+//# sourceMappingURL=merge-driver.d.ts.map

package/dist/commands/merge-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-driver.d.ts","sourceRoot":"","sources":["../../src/commands/merge-driver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiBvD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAoI3E;;;;;;;;;;;GAWG;AAEH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,qBAAqB,CAyFvB;AAWD;;;;;;;GAOG;AAEH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA8BxB"}

package/dist/commands/merge-driver.js

@@ -0,0 +1,268 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync, writeFileSync } from "node:fs";
+import { isMap, isSeq, parseDocument } from "yaml";
+/**
+ * Same serialization options as authored manifest writes, so a merge that
+ * changes nothing reproduces the input bytes and edits never refold rows.
+ */
+const AUTHORED_YAML_OPTIONS = { lineWidth: 0 };
+/**
+ * Top-level lists Kibi keeps keyed by `id`: `.kb/symbols.yaml` and the
+ * `.kb/relationships/*.yaml` shards.
+ */
+const ID_KEYED_LISTS = ["symbols", "relationships"];
+/** Record fields whose values are sets: concurrent additions union instead of conflicting. */
+const SET_FIELDS = new Set(["relationships", "links"]);
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0));
+        return `{${entries
+            .map(([key, entry]) => `${JSON.stringify(key)}:${canonical(entry)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "undefined";
+}
+function same(left, right) {
+    return canonical(left) === canonical(right);
+}
+function parseManifest(label, content, conflicts) {
+    const doc = parseDocument(content);
+    if (doc.errors.length > 0) {
+        conflicts.push(`${label}: not valid YAML (${doc.errors[0]?.message})`);
+        return null;
+    }
+    const top = doc.toJS() ?? {};
+    if (typeof top !== "object" || Array.isArray(top)) {
+        conflicts.push(`${label}: top level is not a mapping`);
+        return null;
+    }
+    const listKeys = ID_KEYED_LISTS.filter((key) => key in top);
+    if (listKeys.length > 1) {
+        conflicts.push(`${label}: holds both ${listKeys.join(" and ")}`);
+        return null;
+    }
+    const listKey = listKeys[0];
+    const rest = { ...top };
+    if (listKey)
+        delete rest[listKey];
+    const records = new Map();
+    const order = [];
+    const seq = listKey ? doc.get(listKey, true) : undefined;
+    if (seq === undefined || seq === null) {
+        return { doc, listKey, records, order, rest };
+    }
+    if (!isSeq(seq)) {
+        conflicts.push(`${label}: ${listKey} is not a list`);
+        return null;
+    }
+    for (const item of seq.items) {
+        const id = isMap(item) ? item.get("id") : undefined;
+        if (!isMap(item) || typeof id !== "string" || !id) {
+            conflicts.push(`${label}: ${listKey} entry without a string id`);
+            return null;
+        }
+        if (records.has(id)) {
+            conflicts.push(`${label}: duplicate id ${id}`);
+            return null;
+        }
+        records.set(id, { node: item, value: item.toJS(doc) });
+        order.push(id);
+    }
+    return { doc, listKey, records, order, rest };
+}
+/** Three-way merge of a set-valued field: keep ours, drop their removals, add their additions. */
+function mergeSet(base, ours, theirs) {
+    const list = (value) => (Array.isArray(value) ? value : []);
+    const baseKeys = new Set(list(base).map(canonical));
+    const theirKeys = new Set(list(theirs).map(canonical));
+    const merged = list(ours).filter((entry) => {
+        const key = canonical(entry);
+        return !(baseKeys.has(key) && !theirKeys.has(key));
+    });
+    const mergedKeys = new Set(merged.map(canonical));
+    for (const entry of list(theirs)) {
+        const key = canonical(entry);
+        if (baseKeys.has(key) || mergedKeys.has(key))
+            continue;
+        merged.push(entry);
+        mergedKeys.add(key);
+    }
+    return merged;
+}
+function mergeRecord(id, base, ours, theirs, conflicts) {
+    const merged = {};
+    const keys = [
+        ...Object.keys(ours),
+        ...Object.keys(theirs).filter((key) => !(key in ours)),
+    ];
+    for (const key of keys) {
+        const baseValue = base?.[key];
+        const ourValue = ours[key];
+        const theirValue = theirs[key];
+        let value;
+        if (same(ourValue, theirValue) || same(theirValue, baseValue)) {
+            value = ourValue;
+        }
+        else if (same(ourValue, baseValue)) {
+            value = theirValue;
+        }
+        else if (SET_FIELDS.has(key) &&
+            [baseValue, ourValue, theirValue].every((entry) => entry === undefined || Array.isArray(entry))) {
+            value = mergeSet(baseValue, ourValue, theirValue);
+        }
+        else {
+            conflicts.push(`${id}: both sides changed ${key}`);
+            continue;
+        }
+        if (value !== undefined)
+            merged[key] = value;
+    }
+    return merged;
+}
+/**
+ * Three-way merge of an id-keyed Kibi manifest (`.kb/symbols.yaml` or a
+ * `.kb/relationships/*.yaml` shard).
+ *
+ * Both sides usually append new records at the end of the list, which Git
+ * reports as a conflict although the additions are independent. This merge
+ * keeps every record either side added, applies edits made on only one
+ * side, honors a deletion made on one side when the other left the record
+ * unchanged, and unions concurrent relationship and link additions on one
+ * symbol. Anything else both sides changed differently is a real conflict
+ * and is reported rather than guessed.
+ */
+// implements REQ-cli-kb-merge-driver
+export function mergeKbManifests(baseContent, oursContent, theirsContent) {
+    const conflicts = [];
+    const base = parseManifest("base", baseContent, conflicts);
+    const ours = parseManifest("ours", oursContent, conflicts);
+    const theirs = parseManifest("theirs", theirsContent, conflicts);
+    if (!base || !ours || !theirs)
+        return { status: "conflict", conflicts };
+    const listKeys = new Set([base.listKey, ours.listKey, theirs.listKey].filter(Boolean));
+    if (listKeys.size > 1) {
+        return {
+            status: "conflict",
+            conflicts: [`sides hold different lists: ${[...listKeys].join(", ")}`],
+        };
+    }
+    const listKey = ours.listKey ?? theirs.listKey;
+    if (!same(ours.rest, theirs.rest) && !same(theirs.rest, base.rest)) {
+        if (!same(ours.rest, base.rest)) {
+            return {
+                status: "conflict",
+                conflicts: ["both sides changed top-level manifest fields"],
+            };
+        }
+        for (const key of Object.keys(ours.rest)) {
+            if (!(key in theirs.rest))
+                ours.doc.delete(key);
+        }
+        for (const [key, value] of Object.entries(theirs.rest)) {
+            ours.doc.set(key, value);
+        }
+    }
+    if (!listKey) {
+        return {
+            status: "merged",
+            content: ours.doc.toString(AUTHORED_YAML_OPTIONS),
+        };
+    }
+    const items = [];
+    for (const id of ours.order) {
+        const ourRecord = ours.records.get(id);
+        if (!ourRecord)
+            continue;
+        const baseRecord = base.records.get(id);
+        const theirRecord = theirs.records.get(id);
+        if (!theirRecord) {
+            if (!baseRecord)
+                items.push(ourRecord.node);
+            else if (!same(ourRecord.value, baseRecord.value)) {
+                conflicts.push(`${id}: changed on ours but deleted on theirs`);
+            }
+            continue;
+        }
+        if (same(ourRecord.value, theirRecord.value) ||
+            (baseRecord && same(theirRecord.value, baseRecord.value))) {
+            items.push(ourRecord.node);
+        }
+        else if (baseRecord && same(ourRecord.value, baseRecord.value)) {
+            items.push(theirRecord.node.clone());
+        }
+        else {
+            const merged = mergeRecord(id, baseRecord?.value, ourRecord.value, theirRecord.value, conflicts);
+            items.push(ours.doc.createNode(merged));
+        }
+    }
+    for (const id of theirs.order) {
+        if (ours.records.has(id))
+            continue;
+        const theirRecord = theirs.records.get(id);
+        if (!theirRecord)
+            continue;
+        const baseRecord = base.records.get(id);
+        if (!baseRecord)
+            items.push(theirRecord.node.clone());
+        else if (!same(theirRecord.value, baseRecord.value)) {
+            conflicts.push(`${id}: deleted on ours but changed on theirs`);
+        }
+    }
+    if (conflicts.length > 0)
+        return { status: "conflict", conflicts };
+    const seq = ours.doc.get(listKey, true);
+    if (isSeq(seq))
+        seq.items = items;
+    else
+        ours.doc.set(listKey, ours.doc.createNode(items));
+    return {
+        status: "merged",
+        content: ours.doc.toString(AUTHORED_YAML_OPTIONS),
+    };
+}
+function readOptional(filePath) {
+    try {
+        return readFileSync(filePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return "";
+        throw error;
+    }
+}
+/**
+ * Git merge driver entry point: `kibi merge-driver %O %A %B`.
+ *
+ * Writes the merged manifest to the current (`%A`) file and exits 0. On a
+ * real conflict it prints each one and falls back to Git's textual merge so
+ * the file carries ordinary conflict markers, then exits 1 so Git keeps the
+ * path unmerged.
+ */
+// implements REQ-cli-kb-merge-driver
+export async function mergeDriverCommand(basePath, currentPath, otherPath) {
+    const result = mergeKbManifests(readOptional(basePath), readFileSync(currentPath, "utf8"), readFileSync(otherPath, "utf8"));
+    if (result.status === "merged") {
+        writeFileSync(currentPath, result.content);
+        return { exitCode: 0 };
+    }
+    for (const conflict of result.conflicts) {
+        console.error(`kibi merge-driver: ${conflict}`);
+    }
+    spawnSync("git", [
+        "merge-file",
+        "-L",
+        "ours",
+        "-L",
+        "base",
+        "-L",
+        "theirs",
+        currentPath,
+        basePath,
+        otherPath,
+    ], { stdio: "inherit" });
+    return { exitCode: 1 };
+}

package/dist/operations/bootstrap/candidates.js

@@ -91,7 +91,7 @@ function providerCandidate(item, existingIds, minConfidence) {
         },
     ];
 }
-// implements REQ-mcp-kibi-bootstrap-bootstrap-v1, REQ-kibi-operation-interface-parity
+// implements REQ-KIBI-BOOTSTRAP-PLAN, REQ-kibi-operation-interface-parity
 // implements REQ-KIBI-BOOTSTRAP-PLAN
 export function buildBootstrapCandidates(evidence, existingIds, minConfidence, includeGenericMarkdown) {
     const candidates = [];

package/dist/operations/bootstrap/discovery.js

@@ -63,7 +63,7 @@ function frameworks(evidence) {
             : [])),
     ].sort();
 }
-// implements REQ-mcp-kibi-bootstrap-bootstrap-v1, REQ-kibi-operation-interface-parity
+// implements REQ-KIBI-BOOTSTRAP-PLAN, REQ-kibi-operation-interface-parity
 // implements REQ-KIBI-BOOTSTRAP-PLAN
 export async function discoverBootstrap(context) {
     const scan = await scanEvidence(context);

package/dist/operations/bootstrap/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/generate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAKjF,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACzC,SAAS,gBAAgB,EAAE,CAI7B;AA2BD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC1C,OAAO,EAAE,MAAM,GACd;IACD,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CACnE,CAiDA;AA+GD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAyD9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/generate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAMjF,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACzC,SAAS,gBAAgB,EAAE,CAI7B;AA2BD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC1C,OAAO,EAAE,MAAM,GACd;IACD,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CACnE,CAiDA;AA+GD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA4E9B"}

package/dist/operations/bootstrap/generate.js

@@ -5,7 +5,8 @@ import { executeStatus } from "../../public/operations/discovery-executors.js";
 import { readWorkspaceSnapshot } from "../../public/operations/workspace-snapshot.js";
 import { buildBootstrapCandidates } from "./candidates.js";
 import { discoverBootstrap } from "./discovery.js";
-import { presentBootstrap } from "./presentation.js";
+import { buildIntentClaimCandidates } from "./intent-claims.js";
+import { normalizeBootstrapContext, presentBootstrap } from "./presentation.js";
 export function filterSourceOnlySignals(signals, entityTypes) {
     return entityTypes && entityTypes.length > 0
         ? signals.filter((signal) => entityTypes.includes(signal.kind))
@@ -164,7 +165,7 @@ async function expectedSnapshots(context, evidencePaths) {
         };
     }
 }
-// implements REQ-mcp-kibi-bootstrap-bootstrap-v1, REQ-kibi-operation-interface-parity
+// implements REQ-KIBI-BOOTSTRAP-PLAN, REQ-kibi-operation-interface-parity
 // implements REQ-KIBI-BOOTSTRAP-PLAN
 export async function executePlanBootstrap(args, context) {
     const includeGenericMarkdown = args.includeGenericMarkdown ?? true;
@@ -182,8 +183,18 @@ export async function executePlanBootstrap(args, context) {
     const built = discovery.activation.allowCandidateGeneration
         ? buildBootstrapCandidates(discovery.evidence, existingIds, minConfidence, includeGenericMarkdown)
         : { candidates: [], sourceOnlySignals: [] };
-    const filteredSignals = filterSourceOnlySignals(built.sourceOnlySignals, args.entityTypes);
-    const selected = selectBootstrapCandidates(built.candidates.filter((candidate) => candidate.confidence >= minConfidence), existingIds, args.entityTypes, maxCandidates);
+    // Intent harvested from declared knowledge sources joins the repository
+    // evidence under the same activation policy, filters, and selection.
+    const claimed = discovery.activation.allowCandidateGeneration
+        ? buildIntentClaimCandidates(normalizeBootstrapContext(args.bootstrapContext), existingIds, minConfidence)
+        : {
+            candidates: [],
+            sourceOnlySignals: [],
+            suppressed: [],
+            diagnostics: [],
+        };
+    const filteredSignals = filterSourceOnlySignals([...built.sourceOnlySignals, ...claimed.sourceOnlySignals], args.entityTypes);
+    const selected = selectBootstrapCandidates([...built.candidates, ...claimed.candidates].filter((candidate) => candidate.confidence >= minConfidence), existingIds, args.entityTypes, maxCandidates);
     const ignored = discovery.ignoredSources.map((sourcePath) => ({
         candidateId: "",
         reason: "ignored_source",
@@ -201,8 +212,13 @@ export async function executePlanBootstrap(args, context) {
             : {}),
         candidates: selected.candidates,
         sourceOnlySignals: filteredSignals,
-        suppressedCandidates: [...selected.suppressed, ...ignored],
+        suppressedCandidates: [
+            ...selected.suppressed,
+            ...claimed.suppressed,
+            ...ignored,
+        ],
         expected,
         bindingDiagnostics,
+        contextDiagnostics: claimed.diagnostics,
     });
 }

package/dist/operations/bootstrap/guidance-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-actions.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/guidance-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAgBpB,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAuE9C"}
+{"version":3,"file":"guidance-actions.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/guidance-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAkBpB,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAuE9C"}

package/dist/operations/bootstrap/guidance-actions.js

@@ -1,5 +1,8 @@
 import path from "node:path";
 function relative(root, target) {
+    // Intent claims cite tickets and URLs, which are not workspace paths.
+    if (!path.isAbsolute(target))
+        return target;
     const value = path.relative(root, target);
     return value.startsWith("..") || path.isAbsolute(value)
         ? target.split(path.sep).join("/")

package/dist/operations/bootstrap/guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAkFpB,wBAAgB,UAAU,CACxB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,MAAM,GAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgEnC;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG;IACF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CAChE,CA0BA"}
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAwFpB,wBAAgB,UAAU,CACxB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,MAAM,GAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiEnC;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG;IACF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CAChE,CA0BA"}

package/dist/operations/bootstrap/guidance.js

@@ -1,6 +1,9 @@
 import path from "node:path";
 import { buildActions } from "./guidance-actions.js";
 function relative(root, target) {
+    // Intent claims cite tickets and URLs, which are not workspace paths.
+    if (!path.isAbsolute(target))
+        return target;
     const value = path.relative(root, target);
     return value.startsWith("..") || path.isAbsolute(value)
         ? target.split(path.sep).join("/")
@@ -28,6 +31,8 @@ function prompt(root, activation, declared, candidates, signals, warnings) {
         bullets.push(`- Summary: ${declared.projectSummary}`);
     if (declared.sourceOfTruthPaths.length > 0)
         bullets.push(`- Source of truth: ${summary(declared.sourceOfTruthPaths)}.`);
+    if (declared.knowledgeSources)
+        bullets.push(`- Knowledge sources: ${summary(declared.knowledgeSources.map((source) => `${source.title} (${source.authority})`))}; ${declared.intentClaims?.length ?? 0} cited intent claim(s).`);
     if (candidates.length > 0) {
         const formatted = Object.entries(counts(candidates))
             .sort(([left], [right]) => left.localeCompare(right))
@@ -81,7 +86,8 @@ export function confidence(activation, declared, candidates, signals, promptBloc
         declared.sourceOfTruthPaths.length +
             declared.sourceOfTruthNotes.length +
             declared.priorityRoots.length +
-            declared.verificationAnchors.length >
+            declared.verificationAnchors.length +
+            (declared.knowledgeSources?.length ?? 0) >
             0) {
         score += 0.08;
         reasons.push("Declared bootstrap context grounds the output.");

package/dist/operations/bootstrap/intent-claims.d.ts

@@ -0,0 +1,17 @@
+import type { BootstrapDeclaredContext, Candidate, SourceOnlySignal } from "./types.js";
+export type IntentClaimBuildResult = {
+    readonly candidates: readonly Candidate[];
+    readonly sourceOnlySignals: readonly SourceOnlySignal[];
+    readonly suppressed: readonly Readonly<Record<string, unknown>>[];
+    readonly diagnostics: readonly string[];
+};
+/**
+ * Turn intent the agent harvested from declared knowledge sources into cited
+ * bootstrap candidates. Kibi never contacts those sources: it only records
+ * what the agent read, binds it into the plan hash through the declared
+ * context, and keeps the citation on every candidate it produces. A claim the
+ * strict modeler cannot ground stays an explicit authoring follow-up instead
+ * of becoming unverifiable knowledge.
+ */
+export declare function buildIntentClaimCandidates(declared: BootstrapDeclaredContext, existingIds: ReadonlySet<string>, minConfidence: number): IntentClaimBuildResult;
+//# sourceMappingURL=intent-claims.d.ts.map

package/dist/operations/bootstrap/intent-claims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-claims.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/intent-claims.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EAGxB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAQpB,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAClE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAcF;;;;;;;GAOG;AAEH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,aAAa,EAAE,MAAM,GACpB,sBAAsB,CAgFxB"}

package/dist/operations/bootstrap/intent-claims.js

@@ -0,0 +1,95 @@
+import { buildStrictWriteSet } from "../../utils/strict-modeling.js";
+import { confidenceBand, strictPlan } from "./candidate-helpers.js";
+import { claimFor } from "./requirement-claims.js";
+/** How much a claim is trusted follows the authority the human assigned. */
+const AUTHORITY_CONFIDENCE = {
+    authoritative: 0.9,
+    supporting: 0.82,
+};
+function citation(source, claim) {
+    return [
+        `intent_claim:${source.id}:${claim.reference}`,
+        `knowledge_source:${source.kind}:${source.locator}`,
+        `source_authority:${source.authority}`,
+        ...(source.connector ? [`connector:${source.connector}`] : []),
+    ];
+}
+/**
+ * Turn intent the agent harvested from declared knowledge sources into cited
+ * bootstrap candidates. Kibi never contacts those sources: it only records
+ * what the agent read, binds it into the plan hash through the declared
+ * context, and keeps the citation on every candidate it produces. A claim the
+ * strict modeler cannot ground stays an explicit authoring follow-up instead
+ * of becoming unverifiable knowledge.
+ */
+// implements REQ-kibi-bootstrap-knowledge-sources
+export function buildIntentClaimCandidates(declared, existingIds, minConfidence) {
+    const sources = new Map((declared.knowledgeSources ?? []).map((source) => [source.id, source]));
+    const candidates = [];
+    const sourceOnlySignals = [];
+    const suppressed = [];
+    const diagnostics = [];
+    for (const claim of declared.intentClaims ?? []) {
+        const source = sources.get(claim.sourceId);
+        if (!source) {
+            diagnostics.push(`Intent claim cites an undeclared knowledge source "${claim.sourceId}" (${claim.reference}); declare it in knowledgeSources or drop the claim.`);
+            continue;
+        }
+        if (source.authority === "stale") {
+            suppressed.push({
+                candidateId: "",
+                reason: "stale_knowledge_source",
+                sourcePath: claim.reference,
+                entityType: "req",
+                statement: claim.statement,
+                sourceId: source.id,
+            });
+            continue;
+        }
+        const confidence = AUTHORITY_CONFIDENCE[source.authority];
+        const evidence = citation(source, claim);
+        const provenance = `${source.id}:${claim.reference}`;
+        const modeled = claimFor(claim.statement, `knowledge-source:${source.id}`, confidence, provenance);
+        const writeSet = modeled
+            ? buildStrictWriteSet({ claim: modeled, statement: claim.statement })
+            : null;
+        if (writeSet?.isStrict &&
+            confidence >= minConfidence &&
+            !existingIds.has(writeSet.req.id)) {
+            candidates.push({
+                candidateId: `claim:${source.id}:${writeSet.req.id.toLowerCase()}`,
+                entityType: "req",
+                title: claim.statement,
+                sourceKind: "intent_claim",
+                sourcePath: claim.reference,
+                confidence,
+                confidenceBand: confidenceBand(confidence),
+                evidence,
+                relationships: writeSet.relationships.map(({ type, from, to }) => ({
+                    type,
+                    from,
+                    to,
+                })),
+                applyPlan: strictPlan(writeSet),
+            });
+            continue;
+        }
+        if (writeSet?.isStrict && existingIds.has(writeSet.req.id)) {
+            suppressed.push({
+                candidateId: `claim:${source.id}:${writeSet.req.id.toLowerCase()}`,
+                reason: "entity_exists",
+                sourcePath: claim.reference,
+                entityType: "req",
+            });
+            continue;
+        }
+        sourceOnlySignals.push({
+            kind: "req",
+            title: `Author requirement from ${source.title} ${claim.reference}: ${claim.statement}`,
+            sourcePath: claim.reference,
+            confidence,
+            evidence,
+        });
+    }
+    return { candidates, sourceOnlySignals, suppressed, diagnostics };
+}

package/dist/operations/bootstrap/presentation.d.ts

@@ -11,5 +11,7 @@ export declare function presentBootstrap(input: {
     readonly suppressedCandidates: readonly Readonly<Record<string, unknown>>[];
     readonly expected: BootstrapPlanV1["expected"];
     readonly bindingDiagnostics?: readonly string[];
+    /** Advisory findings about declared context; they never block apply. */
+    readonly contextDiagnostics?: readonly string[];
 }): PlanBootstrapResult;
 //# sourceMappingURL=presentation.d.ts.map

package/dist/operations/bootstrap/presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/presentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,EAAE,gBAAgB,GACvB,wBAAwB,CAS1B;AAiBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD,GAAG,mBAAmB,CA0KtB"}
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/operations/bootstrap/presentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EAChB,wBAAwB,EAGxB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAwEpB,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,EAAE,gBAAgB,GACvB,wBAAwB,CAa1B;AAiBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD,GAAG,mBAAmB,CA+KtB"}