@cortexkit/aft-opencode 0.22.1 → 0.23.0

package/dist/index.js

@@ -9305,9 +9305,9 @@ import { chmodSync as chmodSync3, copyFileSync as copyFileSync2, existsSync as e
 import { createRequire } from "module";
 import { homedir as homedir4 } from "os";
 import { join as join4 } from "path";
-function copyToVersionedCache(npmBinaryPath) {
+function readBinaryVersion(binaryPath) {
   try {
-    const result = spawnSync(npmBinaryPath, ["--version"], {
+    const result = spawnSync(binaryPath, ["--version"], {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5000
@@ -9315,7 +9315,16 @@ function copyToVersionedCache(npmBinaryPath) {
     const rawVersion = result.stdout?.trim();
     if (!rawVersion)
       return null;
-    const version = rawVersion.replace(/^aft\s+/, "");
+    return rawVersion.replace(/^aft\s+/, "");
+  } catch {
+    return null;
+  }
+}
+function copyToVersionedCache(npmBinaryPath, knownVersion) {
+  try {
+    const version = knownVersion ?? readBinaryVersion(npmBinaryPath);
+    if (!version)
+      return null;
     const tag = version.startsWith("v") ? version : `v${version}`;
     const cacheDir = getCacheDir();
     const versionedDir = join4(cacheDir, tag);
@@ -9370,8 +9379,13 @@ function findBinarySync(expectedVersion) {
     const req = createRequire(import.meta.url);
     const resolved = req.resolve(packageBin);
     if (existsSync3(resolved)) {
-      const copied = copyToVersionedCache(resolved);
-      return copied ?? resolved;
+      const npmVersion = readBinaryVersion(resolved);
+      if (pluginVersion && npmVersion && npmVersion !== pluginVersion) {
+        warn(`npm platform package binary v${npmVersion} does not match plugin v${pluginVersion}; skipping (continuing to PATH lookup)`);
+      } else {
+        const copied = copyToVersionedCache(resolved, npmVersion ?? undefined);
+        return copied ?? resolved;
+      }
     }
   } catch {}
   try {
@@ -30357,21 +30371,21 @@ function arg2(schema) {
 function semanticTools(ctx) {
   const searchTool = {
     description: [
-      "Find symbols by concept when grep keywords fall short. Returns ranked code matches with similarity scores.",
+      "Find symbols by concept using hybrid semantic + lexical search. Returns ranked code matches with similarity scores and provenance tags.",
       "",
       "When to reach for it:",
       "- Exploring an unfamiliar area: 'where is rate limiting handled', 'how does auth flow work'",
       "- Concept doesn't appear as a literal string: 'retry logic', 'cache invalidation', 'graceful shutdown'",
+      "- Filename-shaped concepts: 'the bridge spawn helper', 'the session detection module'",
       "- After 2+ grep attempts that came back empty or noisy",
       "- You know roughly what the function does but not what it's named",
       "",
       "When NOT to use:",
-      "- You have a specific symbol name \u2192 use grep",
       "- You have an error message or stack trace \u2192 use grep",
       "- You want the file/module structure \u2192 use aft_outline",
       "- You're following a call chain \u2192 use aft_navigate",
       "",
-      "Scores below ~0.4 are usually weak matches; treat them as 'maybe relevant' and verify with read."
+      "Each result tags `source` as one of: 'semantic' (embedding match only), 'lexical' (trigram exact-token match the embedding lane missed), or 'hybrid' (both lanes agreed \u2014 strongest signal)."
     ].join(`
 `),
     args: {
@@ -30535,8 +30549,8 @@ function buildWorkflowHints(opts) {
     sections.push(`**Web/URL access**: \`aft_outline({ url })\` first for structure, then \`aft_zoom({ url, symbol: "<heading>" })\` for the specific section.`);
   }
   if (hasOutline && hasZoom && (hasGrep || hasSearch)) {
-    const locator = hasGrep && hasSearch ? `\`${grepName}\` or \`aft_search\`` : hasGrep ? `\`${grepName}\`` : "`aft_search`";
-    sections.push(`**Code exploration**: ${locator} to locate \u2192 \`aft_outline\` for structure \u2192 \`aft_zoom\` for symbol(s).`);
+    const locator = hasGrep ? `\`${grepName}\`` : "`aft_search`";
+    sections.push(hasGrep && hasSearch ? `**Code exploration**: For exact identifiers (\`useState\`, function names, env vars), error messages, or path-shaped queries \u2192 \`${grepName}\` first. For broad concepts ('where is X handled', 'how does Y work') \u2192 \`aft_search\`. Then use \`aft_outline\` for structure \u2192 \`aft_zoom\` for symbol(s).` : `**Code exploration**: ${locator} to locate \u2192 \`aft_outline\` for structure \u2192 \`aft_zoom\` for symbol(s).`);
   }
   if (hasNavigate) {
     sections.push([
@@ -30657,7 +30671,7 @@ var ANNOUNCEMENT_FEATURES = [
 ];
 var plugin = async (input) => initializePluginForDirectory(input);
 async function initializePluginForDirectory(input) {
-  const binaryPath = await findBinary();
+  const binaryPath = await findBinary(PLUGIN_VERSION);
   const aftConfig = loadAftConfig(input.directory);
   const autoUpdateAbort = new AbortController;
   const configOverrides = {};

package/dist/tui.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.22.1",
+  version: "0.23.0",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) \u2014 tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -30,7 +30,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.22.1",
+    "@cortexkit/aft-bridge": "0.23.0",
     "@opencode-ai/plugin": "^1.14.39",
     "@opencode-ai/sdk": "^1.14.39",
     "comment-json": "^4.6.2",
@@ -38,11 +38,11 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.22.1",
-    "@cortexkit/aft-darwin-x64": "0.22.1",
-    "@cortexkit/aft-linux-arm64": "0.22.1",
-    "@cortexkit/aft-linux-x64": "0.22.1",
-    "@cortexkit/aft-win32-x64": "0.22.1"
+    "@cortexkit/aft-darwin-arm64": "0.23.0",
+    "@cortexkit/aft-darwin-x64": "0.23.0",
+    "@cortexkit/aft-linux-arm64": "0.23.0",
+    "@cortexkit/aft-linux-x64": "0.23.0",
+    "@cortexkit/aft-win32-x64": "0.23.0"
   },
   devDependencies: {
     "@types/node": "^22.0.0",

package/dist/workflow-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAsEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAQjG"}
+{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAmEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAQjG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.22.1",
+    "@cortexkit/aft-bridge": "0.23.0",
     "@opencode-ai/plugin": "^1.14.39",
     "@opencode-ai/sdk": "^1.14.39",
     "comment-json": "^4.6.2",
@@ -36,11 +36,11 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.22.1",
-    "@cortexkit/aft-darwin-x64": "0.22.1",
-    "@cortexkit/aft-linux-arm64": "0.22.1",
-    "@cortexkit/aft-linux-x64": "0.22.1",
-    "@cortexkit/aft-win32-x64": "0.22.1"
+    "@cortexkit/aft-darwin-arm64": "0.23.0",
+    "@cortexkit/aft-darwin-x64": "0.23.0",
+    "@cortexkit/aft-linux-arm64": "0.23.0",
+    "@cortexkit/aft-linux-x64": "0.23.0",
+    "@cortexkit/aft-win32-x64": "0.23.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",