kibi-cursor 0.2.0 → 0.2.1

package/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "kibi-cursor",
   "displayName": "Kibi",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Optional Cursor adapter for Kibi. Requires SWI-Prolog 9+ and project-local kibi-cli, kibi-mcp, and kibi-core before the bundled MCP server can start.",
   "license": "AGPL-3.0-or-later",
   "author": {

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # kibi-cursor
 
+## 0.2.1
+
+### Patch Changes
+
+- 5d2975a: Cursor stop hooks no longer inject a long multi-line Kibi freshness reminder after every agent response. Follow-ups are now one line, and most sessions stay silent.
+
+  - Track `kb_upsert`, `kb_delete`, and `kb_check` MCP usage during the session.
+  - Emit no stop follow-up when nothing KB-relevant changed, or when `kb_check` already ran after edits.
+  - Emit a short summary (`Kibi KB updated (kb_upsert).`) after KB mutations, or a single-line sync nudge when source files changed without KB activity.
+  - Fix publish workflow to build and pack `kibi-cursor` tarballs before npm publish.
+
+- Cursor sessions now use Cursor's documented workspace root payload when deciding whether Kibi is already configured. This prevents the plugin from telling agents that Kibi needs bootstrapping just because the hook process is running from the plugin install directory instead of the actual workspace. The bootstrap reminder now names the missing `.kb/config.json` condition directly instead of implying MCP is unavailable.
+
+  - Parse `workspace_roots` from Cursor hook payloads and prefer the first workspace root for Kibi config detection.
+  - Add a regression test covering `sessionStart` without `cwd` when `workspace_roots` points at a configured workspace.
+  - Reword the bootstrap reminder to describe a missing workspace config rather than generic initialization failure.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "kibi-cursor",
   "displayName": "Kibi",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Optional Cursor adapter for Kibi. Requires SWI-Prolog 9+ and project-local kibi-cli, kibi-mcp, and kibi-core before the bundled MCP server can start.",
   "license": "AGPL-3.0-or-later",
   "author": {

package/dist/hook-input.d.ts

@@ -2,6 +2,7 @@ export type HookEvent = "sessionStart" | "preToolUse" | "postToolUse" | "beforeR
 export type HookInput = {
     event: string;
     cwd?: string;
+    workspaceRoots?: readonly string[];
     toolName?: string;
     toolInput?: unknown;
     conversationId?: string;

package/dist/hook-input.js

@@ -10,6 +10,19 @@ function readString(record, keys) {
     }
     return undefined;
 }
+function readStringArray(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        const strings = value.filter((item) => typeof item === "string" && item.length > 0);
+        if (strings.length > 0) {
+            return strings;
+        }
+    }
+    return undefined;
+}
 function normalizeEventName(event) {
     const trimmed = event.trim();
     if (trimmed.length === 0) {
@@ -34,6 +47,10 @@ export function parseHookInput(input) {
         "current_working_directory",
         "workspace",
     ]);
+    const workspaceRoots = readStringArray(input, [
+        "workspace_roots",
+        "workspaceRoots",
+    ]);
     const toolName = readString(input, ["toolName", "tool_name", "tool"]);
     const toolInput = input.toolInput ?? input.tool_input ?? input.input;
     const conversationId = readString(input, [
@@ -45,6 +62,9 @@ export function parseHookInput(input) {
     if (cwd !== undefined) {
         parsed.cwd = cwd;
     }
+    if (workspaceRoots !== undefined) {
+        parsed.workspaceRoots = workspaceRoots;
+    }
     if (toolName !== undefined) {
         parsed.toolName = toolName;
     }

package/dist/hook-runner.js

@@ -5,8 +5,8 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { readGuidance, writeGuidance } from "./guidance.js";
 import { parseHookInput, parseStdinJson, readStdin } from "./hook-input.js";
-import { extractKbMcpToolName } from "./kb-mcp-tools.js";
 import { addDirtyPaths, clearSessionHookState, hasGuidedPath, loadHookState, recordKbMcpTool, rememberGuidedPath, resolveStateDir, } from "./hook-state.js";
+import { extractKbMcpToolName } from "./kb-mcp-tools.js";
 import { BOOTSTRAP_REMINDER, DIRECT_KB_EDIT_WARNING, stopFollowupMessage, } from "./messages.js";
 import { extractExplicitPathFields, isDirectKbPath, isMeaningfulTrackedPath, toRepoRelativePath, } from "./path-policy.js";
 const editableTools = new Set([
@@ -33,7 +33,7 @@ function isReadLikeTool(toolName) {
     return toolName === undefined || readTools.has(toolName);
 }
 function resolveWorkspaceRoot(input) {
-    return input.cwd ?? process.cwd();
+    return input.workspaceRoots?.[0] ?? input.cwd ?? process.cwd();
 }
 function resolvePrimaryPath(input) {
     if (input.filePath) {

package/dist/hook-state.js

@@ -231,7 +231,9 @@ export function recordKbMcpTool(stateDir, toolName) {
         if (normalized === "kb_upsert" || normalized === "kb_delete") {
             return {
                 ...state,
-                kbMutationTools: mergeStringPaths(state.kbMutationTools, [normalized]).slice(-maxKbMutationTools),
+                kbMutationTools: mergeStringPaths(state.kbMutationTools, [
+                    normalized,
+                ]).slice(-maxKbMutationTools),
             };
         }
         return state;

package/dist/kb-mcp-tools.js

@@ -27,7 +27,11 @@ export function extractKbMcpToolName(toolName, toolInput) {
     }
     const nestedArgs = toolInput.arguments ?? toolInput.args;
     if (isRecord(nestedArgs)) {
-        const nestedTool = readString(nestedArgs, ["toolName", "tool_name", "name"]);
+        const nestedTool = readString(nestedArgs, [
+            "toolName",
+            "tool_name",
+            "name",
+        ]);
         if (nestedTool?.startsWith("kb_")) {
             return nestedTool;
         }

package/dist/messages.d.ts

@@ -1,5 +1,5 @@
 import type { HookState } from "./hook-state.js";
-export declare const BOOTSTRAP_REMINDER = "Kibi is not initialized for this workspace. Use the Kibi MCP workflow to bootstrap project memory before relying on KB lookups; do not edit .kb/ files directly.";
+export declare const BOOTSTRAP_REMINDER = "Kibi config was not found at the Cursor workspace root. Use the Kibi MCP /init-kibi workflow to bootstrap project memory before relying on KB lookups; do not edit .kb/ files directly.";
 export declare const DIRECT_KB_EDIT_WARNING = "Avoid direct edits to .kb/. Use Kibi MCP tools for KB discovery and mutations so project memory stays valid.";
 export declare function stopFollowupMessage(state: HookState): string | undefined;
 /** @deprecated Use stopFollowupMessage */

package/dist/messages.js

@@ -1,5 +1,5 @@
 import { isKbFreshnessRelevantPath } from "./path-policy.js";
-export const BOOTSTRAP_REMINDER = "Kibi is not initialized for this workspace. Use the Kibi MCP workflow to bootstrap project memory before relying on KB lookups; do not edit .kb/ files directly.";
+export const BOOTSTRAP_REMINDER = "Kibi config was not found at the Cursor workspace root. Use the Kibi MCP /init-kibi workflow to bootstrap project memory before relying on KB lookups; do not edit .kb/ files directly.";
 export const DIRECT_KB_EDIT_WARNING = "Avoid direct edits to .kb/. Use Kibi MCP tools for KB discovery and mutations so project memory stays valid.";
 export function stopFollowupMessage(state) {
     if (state.kbMutationTools.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-cursor",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Kibi Cursor plugin - thin adapter for Cursor MCP integration and editor hooks",
   "type": "module",
   "main": "dist/index.js",