kibi-agent-core 0.0.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # kibi-agent-core
 
+## 0.1.1
+
+### Patch Changes
+
+- 676bac9: The Claude Code, Codex, Cursor, and ZCode plugins now tell the Kibi MCP server which workspace each call is about, so sessions working in a git worktree are answered from that worktree's branch instead of the checkout the server started in. Nothing changes for sessions that stay in one project.
+  - Each plugin's pre-tool hook adds `workspaceRoot`, the agent's current Kibi workspace, to every Kibi MCP call. Claude Code, Cursor, and ZCode send it without a permission decision so the host's own approval flow is unchanged; Codex requires `permissionDecision: "allow"` for input rewrites, which does not override a server's tool approval mode.
+  - `kibi-agent-core` exports `KIBI_WORKSPACE_ARGUMENT`, `isKibiMcpToolName`, and `stampKibiWorkspace` for the plugins.
+  - The Codex hook parser now reads `hook_event_name`, the field Codex actually sends; the Claude and ZCode `PreToolUse` matchers include `mcp__.*__kb_.*`.
+  - The ZCode launcher sets `KIBI_MCP_HOST=zcode` so its usage rows are attributed like the other hosts'.
+
+## 0.1.0
+
+### Minor Changes
+
+- 5a06c03: Kibi's agent plugins now share one fast, consistent implementation for source-path classification, Kibi MCP tool recognition, and symbol-manifest indexing. Codex and ZCode now recognize production code outside `src/`, while Cursor reuses the same size-and-mtime-keyed scanner as Claude instead of parsing the full symbol manifest before an edit.
+  - Add `kibi-agent-core` as the common Node 18-compatible hook-helper package.
+  - Keep host adapters thin while preserving their host-specific event and state contracts.
+  - Replace Cursor's YAML parser dependency with the shared cached line scanner.
+
 ## 0.0.0
 
 - Initial shared hook-helper package.

package/dist/kb-mcp-tools.d.ts

@@ -4,6 +4,24 @@
  * `MCP:kb_check`, `kibi_kb_check`); an unprefixed `kb_check` passes through.
  */
 export declare function canonicalKbToolName(toolName: string | undefined): string | undefined;
+/**
+ * The public tool argument naming the workspace a Kibi MCP call is about.
+ * Host pre-tool hooks fill it from the agent's current directory on every
+ * Kibi MCP call; kibi-mcp answers from that workspace, so a session working
+ * in a git worktree is never answered from another checkout's branch.
+ */
+export declare const KIBI_WORKSPACE_ARGUMENT = "workspaceRoot";
+/**
+ * True for a Kibi MCP tool as hosts name it in pre-tool hooks:
+ * `mcp__<server>__kb_*` from a server whose name mentions kibi, or Cursor's
+ * `MCP:kb_*` (Cursor does not name the server there).
+ */
+export declare function isKibiMcpToolName(toolName: string | undefined): boolean;
+/**
+ * The Kibi MCP tool input with the workspace stamp added, or undefined when
+ * the tool is not a Kibi MCP tool or no workspace is known.
+ */
+export declare function stampKibiWorkspace(toolName: string | undefined, toolInput: unknown, workspaceRoot: string | undefined): Record<string, unknown> | undefined;
 export type KbMcpToolCall = {
     toolName: string;
     impactCheckRun: boolean;

package/dist/kb-mcp-tools.js

@@ -52,6 +52,38 @@ export function canonicalKbToolName(toolName) {
     const operation = lastSegment.replace(/^kibi_/, "");
     return operation.startsWith("kb_") ? operation : undefined;
 }
+/**
+ * The public tool argument naming the workspace a Kibi MCP call is about.
+ * Host pre-tool hooks fill it from the agent's current directory on every
+ * Kibi MCP call; kibi-mcp answers from that workspace, so a session working
+ * in a git worktree is never answered from another checkout's branch.
+ */
+export const KIBI_WORKSPACE_ARGUMENT = "workspaceRoot";
+/**
+ * True for a Kibi MCP tool as hosts name it in pre-tool hooks:
+ * `mcp__<server>__kb_*` from a server whose name mentions kibi, or Cursor's
+ * `MCP:kb_*` (Cursor does not name the server there).
+ */
+export function isKibiMcpToolName(toolName) {
+    const name = toolName?.trim() ?? "";
+    if (/^MCP:kb_[a-z_]+$/i.test(name))
+        return true;
+    const segments = name.split("__");
+    if (segments.length < 3 || segments[0] !== "mcp")
+        return false;
+    const server = segments.slice(1, -1).join("__");
+    return /kibi/i.test(server) && /^kb_[a-z_]+$/.test(segments.at(-1) ?? "");
+}
+/**
+ * The Kibi MCP tool input with the workspace stamp added, or undefined when
+ * the tool is not a Kibi MCP tool or no workspace is known.
+ */
+export function stampKibiWorkspace(toolName, toolInput, workspaceRoot) {
+    if (!workspaceRoot || !isKibiMcpToolName(toolName))
+        return undefined;
+    const base = isRecord(toolInput) ? toolInput : {};
+    return { ...base, [KIBI_WORKSPACE_ARGUMENT]: workspaceRoot };
+}
 export function resolveKibiInterface(mcpState, workspaceTrusted) {
     if (mcpState === "observed") {
         return "mcp";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-agent-core",
-  "version": "0.0.0",
+  "version": "0.1.1",
   "description": "Shared low-latency hook helpers for Kibi agent adapters",
   "type": "module",
   "main": "./dist/index.js",