kibi-opencode 0.11.0 → 0.12.1

package/README.md

@@ -294,6 +294,15 @@ The plugin provides proactive guidance when agents perform file operations:
 
 - **File-delete safety guidance**: When an agent attempts to delete a file, the plugin injects a safety check reminding the agent to verify if the file implements any Kibi requirements before removal.
 
+### Repository Ignore Support
+
+The OpenCode plugin respects the repository ignore policy used by Kibi's discovery pipeline. In practice this means:
+
+- The plugin's background sync and file-event handling skip paths matched by repository `.gitignore` files, nested `.gitignore` files, and `.git/info/exclude`.
+- The plugin also treats a curated set of tool/runtime directories as never-relevant for KB sync (for example: `.sisyphus`, `.opencode`, `.kb`, `.git`, `node_modules`, `vendor`, `third_party`).
+
+When a file event occurs for an ignored path, the plugin skips processing and will not surface candidate guidance for that file. This avoids noisy briefings and prevents build/editor artifacts from triggering KB sync work.
+
 - **E2e reminder evidence**: File-operation reminders use exact Kibi graph evidence first (`covered_by` links to `[e2e]`-tagged entities or `/e2e/`-sourced entities) and narrow path heuristics second. Package-level e2e tests do not trigger "authoritative evidence" flags at the file level.
 
 - **Session suppression**: To minimize prompt noise, this guidance is suppressed after the first occurrence per path per session.

package/dist/file-filter.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 // implements REQ-opencode-kibi-plugin-v1
 import { createRequire } from "node:module";
 import * as path from "node:path";
+import { createRepoIgnorePolicy } from "kibi-cli/ignore-policy";
 const _require = createRequire(import.meta.url);
 // Lightweight fallback matcher if picomatch isn't installed.
 let picomatch;
@@ -135,6 +136,11 @@ export function shouldHandleFile(filePath, cwd = process.cwd()) {
     const rel = path.isAbsolute(filePath)
         ? path.relative(cwd, filePath).split(path.sep).join("/")
         : filePath.split(path.sep).join("/");
+    // Check shared ignore policy (root .gitignore, nested .gitignore, .git/info/exclude,
+    // and hard denylist such as .sisyphus) before other pattern checks.
+    const policy = createRepoIgnorePolicy(cwd);
+    if (policy.isIgnored(rel))
+        return false;
     const paths = loadKbSyncPaths(cwd);
     // Build include patterns from kibi paths
     const includeCandidates = [

package/dist/plugin.js

@@ -43,6 +43,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.
@@ -961,7 +972,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 +1068,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-opencode",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "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.8.0"
+    "kibi-cli": "^0.10.1"
   },
   "devDependencies": {
     "@types/node": "latest",