kibi-opencode 0.15.1 → 0.15.4

package/README.md

@@ -2,6 +2,12 @@
 
 OpenCode plugin for Kibi - repo-local, per-branch, queryable knowledge base.
 
+`kibi-opencode` is optional. It provides OpenCode-specific guidance, startup UX,
+and background sync/check maintenance, but it does not ship a replacement `kibi`
+CLI or `kibi-mcp` server binary. Install and configure the base `kibi-cli`,
+`kibi-mcp`, and `kibi-core` packages in the project first; add this plugin only
+when you want OpenCode-specific behavior.
+
 ## Installation
 
 ```bash
@@ -16,6 +22,11 @@ Or via OpenCode's plugin system in `opencode.json`:
 }
 ```
 
+Configure the MCP server separately with the project-local `kibi-mcp` binary.
+The plugin may run internal maintenance commands such as `kibi sync` and
+`kibi check`, so the project-local `kibi` CLI should resolve from the OpenCode
+process environment.
+
 ## Features
 
 ### Smart Enforcement
@@ -127,6 +138,8 @@ The plugin injects guidance into OpenCode sessions to improve agent grounding. U
 
 OpenCode exposes Kibi MCP prompts as slash commands. The \`/init-kibi\` command triggers the \`kb_autopilot_generate\` workflow to assist in retroactive bootstrap using only public MCP tools.
 
+OpenCode may show Kibi MCP tools with the configured server prefix. For example, canonical MCP names such as `kb_autopilot_generate`, `kb_upsert`, and `kb_check` can appear to agents as `kibi_kb_autopilot_generate`, `kibi_kb_upsert`, and `kibi_kb_check`. Use the visible `kibi_kb_*` identifier when OpenCode requires an exact tool name; it maps to the same MCP operation.
+
 ### Discovery-first MCP guidance
 
 Agent-visible guidance is intentionally limited to the curated public MCP surface:
@@ -134,6 +147,8 @@ Agent-visible guidance is intentionally limited to the curated public MCP surfac
 - Discovery/reporting: `kb_search`, `kb_query`, `kb_status`, `kb_find_gaps`, `kb_coverage`, `kb_graph`
 - Mutation/validation: `kb_upsert`, `kb_delete`, `kb_check`
 
+In OpenCode tool pickers or logs, these may be displayed with the `kibi_` server prefix, for example `kibi_kb_search` or `kibi_kb_upsert`.
+
 The plugin guidance prefers `kb_search` for broad discovery, then `kb_query` for exact/source-linked follow-up.
 
 ### Background Sync Operations
@@ -265,10 +280,6 @@ Disable specific features while keeping others:
 }
 ```
 
-## Dogfooding
-
-This repository's OpenCode setup dogfoods local built artifacts. `opencode.json` starts the local `kibi-mcp` server, `.opencode/plugins/kibi.ts` re-exports `packages/opencode/dist/index.js`, and the published npm package (`kibi-opencode`) remains the distribution artifact for external consumers. See [DEV.md](DEV.md) for the repo-local workflow and rebuild rule.
-
 ## Troubleshooting
 
 If you see a false "workspace needs Kibi bootstrap" warning even though your workspace is already initialized with `.kb/config.json` pointing at relocated `kibi-docs/*` paths, this indicates a stale plugin cache. See [the main troubleshooting docs](../../docs/troubleshooting.md#opencode-shows-workspace-needs-kibi-bootstrap-before-the-tui) for recovery steps.

package/dist/init-kibi-alias.js

@@ -22,9 +22,11 @@ export function buildInitKibiAlias() {
         "",
         "## 2. Synthesize Candidates",
         "Call `kb_autopilot_generate` with the gathered context to synthesize candidate entities. This tool is **read-only**.",
+        "In OpenCode, Kibi MCP tools are host-prefixed: canonical `kb_autopilot_generate`, `kb_upsert`, and `kb_check` may appear as `kibi_kb_autopilot_generate`, `kibi_kb_upsert`, and `kibi_kb_check`.",
+        "OpenCode prefixes Kibi MCP tools with `kibi_`; use the visible prefixed name when the host requires exact tool identifiers.",
         "",
         "## 3. Preview and Approval",
-        "Present the `promptBlock` and a summary of synthesized `candidates` to the user. **Wait for explicit approval** before proceeding to writes.",
+        "Present the `promptBlock`, a summary of synthesized `candidates`, and the exact `applyPlan` payloads to the user. **Wait for explicit approval** before proceeding to writes.",
         "",
         "## 4. Apply Approved Candidates",
         "Apply approved candidates sequentially using `kb_upsert` (following ascending phase order). Confirm success of each write before moving to the next. Run `kb_check` after the batch to verify KB integrity.",

package/dist/version-metadata.json

@@ -1 +1 @@
-{"opencode":"0.15.1","mcp":"0.14.3","cli":"0.11.3","core":"0.5.3"}
+{"opencode":"0.15.4","mcp":"0.15.3","cli":"0.12.3","core":"0.6.0"}

package/package.json

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