kibi-opencode 0.12.0 → 0.13.0

package/dist/graph-narrator.d.ts

@@ -0,0 +1,25 @@
+export interface GraphNarrativeResult {
+    headline: string;
+    tldr: string;
+    domains: Array<{
+        name: string;
+        changes: string[];
+    }>;
+    relationshipChanges: string[];
+    validationStatus: string;
+}
+export declare function generateGraphNarrative(client: unknown, workspaceCtx: {
+    workspaceRoot: string;
+    branch: string;
+}, changedEntityIds: string[], changedRelationships: Array<{
+    from: string;
+    to: string;
+    type: string;
+}>, checkResult: {
+    count: number;
+    violations: Array<{
+        rule: string;
+        entityId: string;
+        description: string;
+    }>;
+}): Promise<GraphNarrativeResult | null>;

package/dist/graph-narrator.js

@@ -0,0 +1,408 @@
+// implements REQ-opencode-kibi-briefing-v6
+function asRecord(value) {
+    return typeof value === "object" && value !== null
+        ? value
+        : null;
+}
+function asString(value) {
+    return typeof value === "string" ? value : "";
+}
+function asStringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === "string")
+        : [];
+}
+function getSessionApi(client) {
+    const root = asRecord(client);
+    const session = asRecord(root?.session);
+    if (!session) {
+        return null;
+    }
+    const create = session.create;
+    const prompt = session.prompt;
+    if (typeof create !== "function" || typeof prompt !== "function") {
+        return null;
+    }
+    return {
+        create: create,
+        prompt: prompt,
+    };
+}
+function extractSessionId(response) {
+    const root = asRecord(response);
+    if (!root) {
+        return null;
+    }
+    const directId = asString(root.id).trim();
+    if (directId) {
+        return directId;
+    }
+    const data = asRecord(root.data);
+    return asString(data?.id).trim() || null;
+}
+function extractPromptResponseJson(response) {
+    const root = asRecord(response);
+    if (!root)
+        return null;
+    const data = asRecord(root.data);
+    const parts = Array.isArray(data?.parts)
+        ? data.parts
+        : Array.isArray(root.parts)
+            ? root.parts
+            : null;
+    if (!parts)
+        return null;
+    for (const part of parts) {
+        const record = asRecord(part);
+        if (record?.type !== "text") {
+            continue;
+        }
+        const text = asString(record.text);
+        if (!text) {
+            continue;
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+async function invokeTool(sessionApi, sessionID, tool, args) {
+    const response = await sessionApi.prompt({
+        sessionID,
+        parts: [{ type: "text", text: JSON.stringify({ tool, args }) }],
+        tools: { [tool]: true },
+        format: {
+            type: "json_schema",
+            schema: {
+                type: ["object", "array"],
+            },
+        },
+    });
+    return extractPromptResponseJson(response);
+}
+function inferTypeFromId(id) {
+    const prefix = id.split("-")[0]?.toLowerCase() ?? "entity";
+    switch (prefix) {
+        case "req":
+        case "scenario":
+        case "test":
+        case "adr":
+        case "flag":
+        case "event":
+        case "symbol":
+        case "fact":
+            return prefix;
+        case "scen":
+            return "scenario";
+        case "sym":
+            return "symbol";
+        default:
+            return prefix;
+    }
+}
+function humanizeType(type, count = 1) {
+    const singular = {
+        req: "requirement",
+        scenario: "scenario",
+        test: "test",
+        adr: "ADR",
+        flag: "flag",
+        event: "event",
+        symbol: "symbol",
+        fact: "fact",
+    }[type] ?? type;
+    if (count === 1) {
+        return singular;
+    }
+    if (singular === "ADR") {
+        return "ADRs";
+    }
+    return singular.endsWith("s") ? singular : `${singular}s`;
+}
+function humanizeDomain(domain) {
+    const normalized = domain.trim().toLowerCase();
+    switch (normalized) {
+        case "opencode":
+            return "OpenCode";
+        case "mcp":
+            return "MCP";
+        case "cli":
+            return "CLI";
+        case "vscode":
+            return "VSCode";
+        case "core":
+            return "Core";
+        case "requirements":
+            return "Requirements";
+        default:
+            return normalized ? normalized.charAt(0).toUpperCase() + normalized.slice(1) : "Changes";
+    }
+}
+function formatList(items) {
+    if (items.length === 0)
+        return "";
+    if (items.length === 1)
+        return items[0] ?? "";
+    if (items.length === 2)
+        return `${items[0]} and ${items[1]}`;
+    return `${items.slice(0, -1).join(", ")}, and ${items[items.length - 1]}`;
+}
+function normalizeEntity(record, idFallback) {
+    const properties = asRecord(record.properties) ?? {};
+    const id = asString(record.id || properties.id).trim() || idFallback;
+    const type = asString(record.type).trim() ||
+        asString(record.entityType).trim() ||
+        inferTypeFromId(id);
+    const title = asString(record.title).trim() ||
+        asString(properties.title).trim() ||
+        id;
+    const status = asString(record.status).trim() ||
+        asString(properties.status).trim() ||
+        asString(properties.change_kind).trim();
+    const source = asString(record.source).trim() ||
+        asString(properties.source).trim();
+    const tags = [
+        ...asStringArray(record.tags),
+        ...asStringArray(properties.tags),
+    ];
+    const factKind = asString(record.fact_kind).trim() ||
+        asString(properties.fact_kind).trim();
+    return {
+        id,
+        type,
+        title,
+        status,
+        source,
+        tags,
+        factKind,
+        removed: false,
+    };
+}
+function normalizeGraph(value) {
+    const root = asRecord(value);
+    if (!root) {
+        return null;
+    }
+    const edges = Array.isArray(root.edges)
+        ? root.edges
+            .map((edge) => {
+            const record = asRecord(edge);
+            if (!record)
+                return null;
+            const from = asString(record.from).trim();
+            const to = asString(record.to).trim();
+            const type = asString(record.type).trim();
+            return from && to && type ? { from, to, type } : null;
+        })
+            .filter((edge) => edge !== null)
+        : [];
+    return { edges };
+}
+function describeEntity(entity, id) {
+    if (!entity) {
+        return id;
+    }
+    return `${entity.title} (${entity.id})`;
+}
+function inferDomain(entity) {
+    const source = entity.source.replaceAll("\\", "/");
+    const packageMatch = source.match(/packages\/([^/]+)\//);
+    if (packageMatch?.[1]) {
+        return humanizeDomain(packageMatch[1]);
+    }
+    const tagDomain = entity.tags.find((tag) => ["cli", "mcp", "vscode", "opencode", "core"].includes(tag.toLowerCase()));
+    if (tagDomain) {
+        return humanizeDomain(tagDomain);
+    }
+    if (["req", "scenario", "test"].includes(entity.type)) {
+        return "Requirements";
+    }
+    return humanizeDomain(entity.type);
+}
+function classifyRelationship(relationship, entities) {
+    const fromEntity = entities.get(relationship.from);
+    const toEntity = entities.get(relationship.to);
+    const fromText = describeEntity(fromEntity, relationship.from);
+    const toText = describeEntity(toEntity, relationship.to);
+    switch (relationship.type) {
+        case "supersedes":
+            return `${toText} was superseded by ${fromText}`;
+        case "implements":
+            return `${fromText} now implements ${toText}`;
+        case "covered_by":
+            return `${fromText} gained test coverage via ${toText}`;
+        case "verified_by":
+            return `${fromText} is verified by ${toText}`;
+        case "specified_by":
+            return `${fromText} is specified by ${toText}`;
+        case "requires_property":
+            return `${fromText} constrains property ${toText}`;
+        case "constrains":
+            if (toEntity?.type === "fact" && toEntity.factKind === "subject") {
+                return `${fromText} is linked to fact ${toText}`;
+            }
+            return `${fromText} is linked to ${toText}`;
+        default:
+            return null;
+    }
+}
+function uniqueStrings(items) {
+    return [...new Set(items.filter(Boolean))];
+}
+function buildEntityChange(entity, relationships, graph) {
+    const label = describeEntity(entity, entity.id);
+    if (entity.removed) {
+        return `${label} was removed`;
+    }
+    if (entity.status === "superseded") {
+        return `${label} was marked superseded`;
+    }
+    const hasRelationshipChange = relationships.some((relationship) => relationship.from === entity.id || relationship.to === entity.id);
+    const hasGraphEdges = (graph?.edges.length ?? 0) > 0;
+    if (!hasRelationshipChange && !hasGraphEdges) {
+        return `${label} was created`;
+    }
+    return `${label} was updated`;
+}
+function summarizeTypes(entities) {
+    const counts = new Map();
+    for (const entity of entities) {
+        counts.set(entity.type, (counts.get(entity.type) ?? 0) + 1);
+    }
+    return formatList([...counts.entries()].map(([type, count]) => `${count} ${humanizeType(type, count)}`));
+}
+function summarizeTopChanges(domainChanges, relationshipChanges) {
+    const focus = relationshipChanges.length > 0 ? relationshipChanges : domainChanges;
+    const selected = focus.slice(0, 2);
+    return selected.length > 0 ? `Key changes: ${selected.join("; ")}.` : "";
+}
+function validationStatusText(checkResult) {
+    if (checkResult.count <= 0) {
+        return "All checks pass";
+    }
+    return `${checkResult.count} validation issue${checkResult.count === 1 ? "" : "s"}`;
+}
+async function loadEntity(sessionApi, sessionID, id) {
+    const response = await invokeTool(sessionApi, sessionID, "kb_query", { id, limit: 1 });
+    if (!Array.isArray(response)) {
+        throw new Error(`kb_query returned unsupported payload for ${id}`);
+    }
+    if (response.length === 0) {
+        return {
+            id,
+            type: inferTypeFromId(id),
+            title: id,
+            status: "removed",
+            source: "",
+            tags: [],
+            factKind: "",
+            removed: true,
+        };
+    }
+    const record = asRecord(response[0]);
+    if (!record) {
+        throw new Error(`kb_query returned invalid entity for ${id}`);
+    }
+    return normalizeEntity(record, id);
+}
+async function loadGraph(sessionApi, sessionID, id) {
+    const response = await invokeTool(sessionApi, sessionID, "kb_graph", {
+        seedIds: [id],
+        direction: "both",
+        depth: 2,
+        maxNodes: 100,
+        maxEdges: 200,
+    });
+    return normalizeGraph(response);
+}
+// implements REQ-opencode-kibi-briefing-v2
+export async function generateGraphNarrative(client, workspaceCtx, changedEntityIds, changedRelationships, checkResult) {
+    const uniqueIds = uniqueStrings(changedEntityIds);
+    if (uniqueIds.length === 0) {
+        return null;
+    }
+    const sessionApi = getSessionApi(client);
+    if (!sessionApi) {
+        return null;
+    }
+    let sessionID = null;
+    try {
+        const worker = await sessionApi.create({
+            directory: workspaceCtx.workspaceRoot,
+            title: `Kibi Graph Narrator (${workspaceCtx.branch})`,
+        });
+        sessionID = extractSessionId(worker);
+    }
+    catch {
+        return null;
+    }
+    if (!sessionID) {
+        return null;
+    }
+    const entities = new Map();
+    const graphs = new Map();
+    for (const id of uniqueIds) {
+        let entity;
+        try {
+            entity = await loadEntity(sessionApi, sessionID, id);
+        }
+        catch {
+            continue;
+        }
+        if (!entity) {
+            continue;
+        }
+        entities.set(id, entity);
+        if (entity.removed) {
+            graphs.set(id, null);
+            continue;
+        }
+        try {
+            graphs.set(id, await loadGraph(sessionApi, sessionID, id));
+        }
+        catch {
+            graphs.set(id, null);
+        }
+    }
+    const entityList = [...entities.values()];
+    if (entityList.length === 0) {
+        return null;
+    }
+    const relationshipChanges = uniqueStrings(changedRelationships
+        .map((relationship) => classifyRelationship(relationship, entities))
+        .filter((sentence) => !!sentence));
+    const domainMap = new Map();
+    for (const entity of entityList) {
+        const domain = inferDomain(entity);
+        const changes = domainMap.get(domain) ?? [];
+        changes.push(buildEntityChange(entity, changedRelationships, graphs.get(entity.id) ?? null));
+        domainMap.set(domain, changes);
+    }
+    const domains = [...domainMap.entries()]
+        .map(([name, changes]) => ({ name, changes: uniqueStrings(changes) }))
+        .sort((left, right) => left.name.localeCompare(right.name));
+    const domainNames = domains.map((domain) => domain.name);
+    const headline = `${summarizeTypes(entityList)} changed${domainNames.length > 1 ? ` across ${formatList(domainNames)} domains` : ""}.`;
+    const allDomainChanges = domains.flatMap((domain) => domain.changes);
+    const validationStatus = validationStatusText(checkResult);
+    const tldr = [
+        headline,
+        summarizeTopChanges(allDomainChanges, relationshipChanges),
+        validationStatus === "All checks pass"
+            ? "Validation remains clean."
+            : `${validationStatus}.`,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return {
+        headline,
+        tldr,
+        domains,
+        relationshipChanges,
+        validationStatus,
+    };
+}

package/dist/idle-brief-runtime.d.ts

@@ -42,7 +42,14 @@ export interface IdleBriefingResult {
     regressionRisks?: IdleBriefStatement[];
     missingEvidence?: IdleBriefStatement[];
 }
+type IdleBriefRelationship = {
+    from: string;
+    to: string;
+    type: string;
+};
 export declare function generateIdleBrief(client: unknown, workspaceCtx: BriefingWorkspaceCtx, auditDelta: AuditDelta, sessionId: string, options?: {
     sourceFiles?: string[];
     changedEntityIds?: string[];
+    relationships?: IdleBriefRelationship[];
 }): Promise<IdleBriefResult>;
+export {};

package/dist/idle-brief-runtime.js

@@ -1,6 +1,7 @@
 // implements REQ-opencode-kibi-briefing-v4
 import { buildBriefingContext } from "./brief-intent.js";
 import { buildDeliveryReasons } from "./brief-delivery-reasons.js";
+import { generateGraphNarrative } from "./graph-narrator.js";
 import { atomicWriteBrief, pruneOldBriefs, resolveBriefFilePath, } from "./idle-brief-paths.js";
 import { computeContentHash, createBriefId, } from "./idle-brief-store.js";
 import { reconcileAuditEntries } from "./reconcile-engine.js";
@@ -318,7 +319,7 @@ function buildChangeNarrative(auditDelta) {
     }
     return lines;
 }
-function buildEnvelopeParts(briefId, type, sessionId, branch, createdAt, auditDelta, summary, counts, checkResult, briefingResult, deliveryReasons) {
+function buildEnvelopeParts(briefId, type, sessionId, branch, createdAt, auditDelta, summary, counts, checkResult, briefingResult, changeNarrative, deliveryReasons) {
     const reconciled = reconcileAuditEntries(auditDelta.entries);
     return {
         schemaVersion: "2.0",
@@ -350,7 +351,7 @@ function buildEnvelopeParts(briefId, type, sessionId, branch, createdAt, auditDe
             tldr: briefingResult.tldr || summary,
             promptBlock: briefingResult.promptBlock,
             citations: briefingResult.citations,
-            changeNarrative: buildChangeNarrative(auditDelta),
+            changeNarrative,
             ...(deliveryReasons ? { deliveryReasons } : {}),
             ...(briefingResult.constraints && briefingResult.constraints.length > 0
                 ? { constraints: briefingResult.constraints }
@@ -388,11 +389,15 @@ export async function generateIdleBrief(client, workspaceCtx, auditDelta, sessio
         : derivedSourceFiles.length > 0
             ? derivedSourceFiles
             : [auditDelta.entries[0]?.entityId ?? "unknown"];
+    const relationshipEntityIds = (options?.relationships ?? []).flatMap((relationship) => [relationship.from, relationship.to]);
+    const mergedChangedEntityIds = options?.changedEntityIds
+        ? [...new Set([...options.changedEntityIds, ...relationshipEntityIds])]
+        : relationshipEntityIds.length > 0
+            ? [...new Set(relationshipEntityIds)]
+            : undefined;
     const briefingContext = buildBriefingContext({
         sourceFiles,
-        ...(options?.changedEntityIds
-            ? { changedEntityIds: options.changedEntityIds }
-            : {}),
+        ...(mergedChangedEntityIds ? { changedEntityIds: mergedChangedEntityIds } : {}),
     });
     const { seedIds } = briefingContext;
     let checkResult;
@@ -431,6 +436,12 @@ export async function generateIdleBrief(client, workspaceCtx, auditDelta, sessio
     const isSuccess = violationsCount === 0;
     const type = isSuccess ? "success" : "warning";
     const summary = computeSummary(counts, violationsCount);
+    const changedEntityIdsForNarrative = mergedChangedEntityIds ?? [
+        ...reconciled.added.map((item) => item.id),
+        ...reconciled.modified.map((item) => item.id),
+        ...reconciled.removed.map((item) => item.id),
+    ];
+    const changedRelationships = options?.relationships ?? [];
     const deliveryReasons = buildDeliveryReasons({
         entitiesAdded: reconciled.added
             .filter((item) => item.id !== "workspace-sync")
@@ -444,6 +455,13 @@ export async function generateIdleBrief(client, workspaceCtx, auditDelta, sessio
         relationshipsChanged: counts.relationshipsChanged,
         validationCount: checkResult.count,
     });
+    const graphNarrative = await generateGraphNarrative(client, workspaceCtx, changedEntityIdsForNarrative, changedRelationships, checkResult);
+    const changeNarrative = graphNarrative?.relationshipChanges.length || graphNarrative?.domains.length
+        ? [
+            ...graphNarrative.relationshipChanges,
+            ...graphNarrative.domains.flatMap((domain) => domain.changes),
+        ]
+        : buildChangeNarrative(auditDelta);
     if (counts.entitiesAdded === 0 &&
         counts.entitiesModified === 0 &&
         counts.entitiesRemoved === 0 &&
@@ -455,7 +473,7 @@ export async function generateIdleBrief(client, workspaceCtx, auditDelta, sessio
     const briefId = createBriefId();
     const timestamp = Date.now();
     const createdAt = new Date().toISOString();
-    const envelopeWithoutHash = buildEnvelopeParts(briefId, type, sessionId, workspaceCtx.branch, createdAt, auditDelta, summary, counts, checkResult, briefingResult, deliveryReasons);
+    const envelopeWithoutHash = buildEnvelopeParts(briefId, type, sessionId, workspaceCtx.branch, createdAt, auditDelta, summary, counts, checkResult, briefingResult, changeNarrative, deliveryReasons);
     const contentHash = computeContentHash(envelopeWithoutHash);
     const envelope = {
         ...envelopeWithoutHash,

package/dist/plugin.js

@@ -26,6 +26,7 @@ import { getSessionTracker } from "./session-tracker.js";
 import { notifyStartup, } from "./startup-notifier.js";
 import { sendToast, } from "./toast.js";
 import { announceBriefTui, } from "./tui-brief-delivery.js";
+import { deletePendingBriefMarkers, loadPendingBriefMarkers, } from "./utils/brief-marker.js";
 import * as fs from "node:fs";
 function deriveFileBucket(kind) {
     return kind;
@@ -43,6 +44,17 @@ function resolveIdleBriefDeliveryDelayMs(worktree) {
         return 0;
     return Math.min(60_000, Math.trunc(configValue));
 }
+function readKibiOpencodePackageVersion() {
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+        return typeof packageJson.version === "string"
+            ? packageJson.version
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 const startupNotifyGlobals = globalThis;
 /**
  * Lint requirement documents for embedded scenarios/tests and oversized content.
@@ -343,6 +355,17 @@ const kibiOpencodePlugin = async (input) => {
                     // Gather session edits
                     const sessionEdits = sessionEditState.getSessionEdits();
                     const sourceFiles = sessionEdits.map((e) => e.filePath);
+                    const markerResult = loadPendingBriefMarkers(idleWorkspaceRoot, idleBranch);
+                    for (const issue of markerResult.issues) {
+                        logger.warn("idle-brief.marker-invalid", {
+                            event: "idle_brief_marker_invalid",
+                            branch: idleBranch,
+                            filePath: issue.filePath,
+                            reason: issue.reason,
+                        });
+                    }
+                    const markerEntityIds = markerResult.entityIds;
+                    const markerRelationships = markerResult.relationships;
                     const snapshotBeforeSync = getKbSnapshotFingerprint(idleWorkspaceRoot, idleBranch);
                     if (scheduler) {
                         const idleSyncBlocked = runtimeOverlay.primaryCause === "scheduler_sync_failed";
@@ -386,9 +409,33 @@ const kibiOpencodePlugin = async (input) => {
                         ...reconciled.modified.map((e) => e.id),
                         ...reconciled.removed.map((e) => e.id),
                     ];
-                    const result = await generateIdleBrief(input.client, workspaceCtx, auditDelta, input.sessionId ?? "unknown", sourceFiles.length > 0
-                        ? { sourceFiles, changedEntityIds }
-                        : { changedEntityIds });
+                    const mergedChangedEntityIds = [
+                        ...new Set([...changedEntityIds, ...markerEntityIds]),
+                    ];
+                    const mergedSourceFiles = [...new Set([...sourceFiles, ...markerEntityIds])];
+                    const result = await generateIdleBrief(input.client, workspaceCtx, auditDelta, input.sessionId ?? "unknown", mergedSourceFiles.length > 0
+                        ? {
+                            sourceFiles: mergedSourceFiles,
+                            changedEntityIds: mergedChangedEntityIds,
+                            relationships: markerRelationships,
+                        }
+                        : mergedChangedEntityIds.length > 0
+                            ? {
+                                changedEntityIds: mergedChangedEntityIds,
+                                relationships: markerRelationships,
+                            }
+                            : undefined);
+                    if (result.success) {
+                        const deleteResult = await deletePendingBriefMarkers(markerResult.markerPaths);
+                        for (const issue of deleteResult.issues) {
+                            logger.warn("idle-brief.marker-delete-failed", {
+                                event: "idle_brief_marker_delete_failed",
+                                branch: idleBranch,
+                                filePath: issue.filePath,
+                                reason: issue.reason,
+                            });
+                        }
+                    }
                     if (result.success && result.envelope) {
                         const envelope = result.envelope;
                         // Dedupe by semantic contentHash — persisted envelope is the delivery authority
@@ -961,7 +1008,7 @@ const kibiOpencodePlugin = async (input) => {
                     overlay_cause: runtimeOverlay.primaryCause ?? null,
                 });
                 // Emit completion-reminder log only when prompt-visible reminder text is present
-                const REMINDER_TEXT = "Run `kb_check` before completing this task.";
+                const REMINDER_TEXT = "Kibi impact evidence is required before completion/commit: run `kb_check` before completing this task.";
                 if (cfg.guidance.smartEnforcement.completionReminder &&
                     !maintenanceDegraded &&
                     guidance.includes(REMINDER_TEXT)) {
@@ -1057,9 +1104,11 @@ const kibiOpencodePlugin = async (input) => {
                 setTimeout(callback, delayMs);
             });
         scheduleStartupNotify(() => {
+            const version = readKibiOpencodePackageVersion();
             notifyStartup(makeStartupClient(client), {
                 suppressToast: cfg.ux.toastStartup === false,
                 directory: input.directory,
+                ...(version ? { version } : {}),
             });
         }, 2000);
     }

package/dist/prompt.js

@@ -131,13 +131,15 @@ Requirement edits need policy alignment. Run kb_check with required-fields and n
 
 Production code: use \`implements\` (symbol→req) for requirement ownership. Test code: use \`executable_for\` (symbol→test).
 - \`covered_by\` is coverage evidence only
-- Prefer scenario-first: req→scenario→test when scenarios exist`,
+- Prefer scenario-first: req→scenario→test when scenarios exist
+- Kibi impact evidence is required before completion/commit`,
     traceability_candidate: `📝 **Code changes detected**
 
 Production code: use \`implements\` (symbol→req) for requirement ownership. Test code: use \`executable_for\` (symbol→test).
 - \`covered_by\` is coverage evidence only
 - Prefer scenario-first: req→scenario→test when scenarios exist
-- Route durable knowledge comments to KB entities, not inline comments`,
+- Route durable knowledge comments to KB entities, not inline comments
+- documentation/symbols.yaml refresh is required when extraction output changes; do not revert as scope creep`,
     manual_kb_edit: `⚠️  **WARNING: Direct .kb/ edits bypass validation**
 
 The Kibi knowledge base is managed through public MCP tools. Direct manual edits to .kb/** can cause inconsistencies.
@@ -426,7 +428,7 @@ The Kibi workspace is in a maintenance-degraded state. Guidance remains advisory
         REMINDER_RISK_CLASSES.includes(riskClass) &&
         posture !== "root_uninitialized" &&
         posture !== "root_partial") {
-        finalBlock = `${finalBlock}\n- Run \`kb_check\` before completing this task.`;
+        finalBlock = `${finalBlock}\n- Kibi impact evidence is required before completion/commit: run \`kb_check\` before completing this task.`;
     }
     // Return: sentinel + one targeted block (or just sentinel if no block)
     return finalBlock
@@ -502,6 +504,7 @@ Dogfood note for this repo: OpenCode here uses local built \`kibi-mcp\` and \`ki
 4. **Document intent**: If you are about to explain code, STOP. Route that explanation to kb_upsert instead of inline comments.
 5. **Link during work**: When creating KB entities, include relationship rows: specified_by (req→scenario), implements (symbol→req for ownership), covered_by (symbol→test for coverage), executable_for (test code→test).
 6. **Validate**: Run kb_check after KB mutations to catch violations early.
+7. **Before completion/commit**: Kibi impact evidence is required before completion/commit. If extraction output changes, refresh documentation/symbols.yaml and do not revert that update as scope creep.
 
 **Public Kibi tools only:** kb_autopilot_generate, kb_search, kb_query, kb_status, kb_find_gaps, kb_coverage, kb_graph, kb_upsert, kb_delete, kb_check.\n\nDo not invoke Kibi CLI commands directly from the agent.\n\n${buildInitKibiBootstrapReference(capability)}`;
 }

package/dist/scheduler.js

@@ -235,6 +235,8 @@ function truncateSyncOutput(value) {
     }
     return value;
 }
+// Background sync runner: uses default sync (no --refresh-symbol-coordinates)
+// to avoid writing committed coordinate artifacts during automatic background execution.
 async function runKibiSync(worktree) {
     return new Promise((resolve) => {
         try {

package/dist/startup-notifier.js

@@ -2,10 +2,13 @@ import { sendToast, } from "./toast.js";
 // implements REQ-opencode-kibi-plugin-v1
 export function notifyStartup(client, cfg) {
     const message = "kibi-opencode started";
+    const displayMessage = cfg.version
+        ? `${message} (v${cfg.version})`
+        : message;
     const toastPayload = {
         variant: "success",
         title: "Kibi OpenCode",
-        message,
+        message: displayMessage,
         duration: 4000,
     };
     if (!cfg.suppressToast) {

package/dist/utils/brief-marker.d.ts

@@ -0,0 +1,19 @@
+export interface PendingBriefMarkerIssue {
+    filePath: string;
+    reason: "parse" | "schema" | "delete";
+}
+export interface PendingBriefMarkersResult {
+    entityIds: string[];
+    relationships: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    markerPaths: string[];
+    issues: PendingBriefMarkerIssue[];
+}
+export declare function loadPendingBriefMarkers(workspaceRoot: string, branch: string): PendingBriefMarkersResult;
+export declare function deletePendingBriefMarkers(markerPaths: string[]): Promise<{
+    deletedCount: number;
+    issues: PendingBriefMarkerIssue[];
+}>;

package/dist/utils/brief-marker.js

@@ -0,0 +1,101 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+// implements REQ-opencode-kibi-briefing-v2
+export function loadPendingBriefMarkers(workspaceRoot, branch) {
+    const pendingDir = path.join(workspaceRoot, ".kb", "briefs", "pending");
+    if (!fs.existsSync(pendingDir)) {
+        return { entityIds: [], relationships: [], markerPaths: [], issues: [] };
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(pendingDir, { withFileTypes: true });
+    }
+    catch {
+        return { entityIds: [], relationships: [], markerPaths: [], issues: [] };
+    }
+    const issues = [];
+    const markerPaths = [];
+    const entityIds = [];
+    const seenEntityIds = new Set();
+    const relationshipMap = new Map();
+    for (const entry of entries
+        .filter((dirent) => dirent.isFile() && dirent.name.endsWith(".json"))
+        .sort((a, b) => a.name.localeCompare(b.name))) {
+        const filePath = path.join(pendingDir, entry.name);
+        let payload;
+        try {
+            payload = parsePendingBriefMarker(JSON.parse(fs.readFileSync(filePath, "utf8")));
+        }
+        catch (error) {
+            issues.push({
+                filePath,
+                reason: error instanceof SyntaxError ? "parse" : "schema",
+            });
+            continue;
+        }
+        if (payload.branch !== branch) {
+            continue;
+        }
+        markerPaths.push(filePath);
+        for (const entityId of payload.entityIds) {
+            if (seenEntityIds.has(entityId)) {
+                continue;
+            }
+            seenEntityIds.add(entityId);
+            entityIds.push(entityId);
+        }
+        for (const relationship of payload.relationships) {
+            relationshipMap.set(`${relationship.type}\u0000${relationship.from}\u0000${relationship.to}`, relationship);
+        }
+    }
+    return {
+        entityIds,
+        relationships: [...relationshipMap.values()],
+        markerPaths,
+        issues,
+    };
+}
+// implements REQ-opencode-kibi-briefing-v2
+export async function deletePendingBriefMarkers(markerPaths) {
+    let deletedCount = 0;
+    const issues = [];
+    for (const markerPath of markerPaths) {
+        try {
+            const existedBeforeDelete = fs.existsSync(markerPath);
+            await fs.promises.rm(markerPath, { force: true });
+            if (existedBeforeDelete && !fs.existsSync(markerPath)) {
+                deletedCount += 1;
+            }
+        }
+        catch {
+            issues.push({ filePath: markerPath, reason: "delete" });
+        }
+    }
+    return { deletedCount, issues };
+}
+function parsePendingBriefMarker(value) {
+    if (!value || typeof value !== "object") {
+        throw new Error("Invalid marker payload");
+    }
+    const record = value;
+    const branch = typeof record.branch === "string" ? record.branch.trim() : "";
+    const entityIds = Array.isArray(record.entityIds)
+        ? record.entityIds.filter((item) => typeof item === "string" && item.length > 0)
+        : null;
+    const relationships = Array.isArray(record.relationships)
+        ? record.relationships
+            .filter((item) => !!item &&
+            typeof item === "object" &&
+            typeof item.from === "string" &&
+            typeof item.to === "string" &&
+            typeof item.type === "string" &&
+            item.from.length > 0 &&
+            item.to.length > 0 &&
+            item.type.length > 0)
+            .map((item) => ({ from: item.from, to: item.to, type: item.type }))
+        : [];
+    if (!branch || !entityIds) {
+        throw new Error("Invalid marker schema");
+    }
+    return { branch, entityIds, relationships };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-opencode",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Kibi OpenCode plugin - thin adapter to integrate Kibi with OpenCode sessions",
   "type": "module",
   "main": "dist/index.js",
@@ -62,7 +62,7 @@
     "@opencode-ai/plugin": "^1.4.7",
     "@opentui/core": "^0.1.99",
     "@opentui/solid": "^0.1.99",
-    "kibi-cli": "^0.10.0"
+    "kibi-cli": "^0.11.0"
   },
   "devDependencies": {
     "@types/node": "latest",