@cortexkit/aft-opencode 0.27.0 → 0.28.0

package/dist/lsp-auto-install.d.ts

@@ -19,7 +19,7 @@
  *           installed, log a warning and keep the existing version.
  *           Otherwise skip + warn.
  *
- *   3. Spawn `bun add <pkg>@<version> --cwd <cache_dir> --ignore-scripts`
+ *   3. Spawn `npm install --no-save <pkg>@<version> --ignore-scripts`
  *      in the background. Drop a lockfile while running. Log progress.
  *
  *   4. The newly-installed binary will be picked up on the user's NEXT

package/dist/lsp-auto-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp-auto-install.d.ts","sourceRoot":"","sources":["../src/lsp-auto-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAwBH,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,kGAAkG;IAClG,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;;;OAOG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C;;;;;;;;;OASG;IACH,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAkDD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/D;AA0WD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,SAAS,GAAE,OAAO,KAAa,GAC9B,iBAAiB,CAwEnB"}
+{"version":3,"file":"lsp-auto-install.d.ts","sourceRoot":"","sources":["../src/lsp-auto-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA4BH,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,kGAAkG;IAClG,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;;;OAOG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C;;;;;;;;;OASG;IACH,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AA8DD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/D;AAqXD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,SAAS,GAAE,OAAO,KAAa,GAC9B,iBAAiB,CAwEnB"}

package/dist/lsp-npm-table.d.ts

@@ -22,6 +22,20 @@ export interface NpmServerSpec {
     readonly extensions: readonly string[];
     /** Project-root marker files (presence triggers install). Optional. */
     readonly rootMarkers?: readonly string[];
+    /**
+     * Package names whose presence in `<projectRoot>/package.json` `dependencies`,
+     * `devDependencies`, or `peerDependencies` triggers auto-install. Useful for
+     * frameworks where the config file alone (`vite.config.ts`, etc.) doesn't
+     * reveal which language server is needed — e.g. a Vite project is only a
+     * Vue project if `vue` is in package.json. Optional.
+     *
+     * GitHub issue #48: Vue, Astro, and Svelte projects can have their .vue
+     * /.astro/.svelte files deep enough in a monorepo (or behind skipped
+     * directories like `apps/`) that the bounded extension walk misses them.
+     * Without rootMarkers OR this hint, auto-install never triggers and the
+     * user sees a recurring `lsp_binary_missing` warning.
+     */
+    readonly packageJsonDeps?: readonly string[];
 }
 export declare const NPM_LSP_TABLE: readonly NpmServerSpec[];
 /** Find an entry by AFT server id. */

package/dist/lsp-npm-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp-npm-table.d.ts","sourceRoot":"","sources":["../src/lsp-npm-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,aAAa,EAoEjD,CAAC;AAEF,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEvE;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE/E"}
+{"version":3,"file":"lsp-npm-table.d.ts","sourceRoot":"","sources":["../src/lsp-npm-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,aAAa,EAoFjD,CAAC;AAEF,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEvE;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE/E"}

package/dist/lsp-project-relevance.d.ts

@@ -1,4 +1,17 @@
 export declare function hasRootMarker(projectRoot: string, rootMarkers?: readonly string[]): boolean;
+/**
+ * True when `<projectRoot>/package.json` lists any name from `depNames`
+ * in its `dependencies`, `devDependencies`, or `peerDependencies` maps.
+ *
+ * GitHub issue #48: Vue/Astro/Svelte projects fail the bounded extension
+ * walk for monorepo layouts. Detecting them by package.json dep name
+ * catches Vite-based setups and other frameworks where no framework-
+ * specific config file exists at the project root.
+ *
+ * Reads package.json once per call. Failures (missing file, invalid JSON,
+ * I/O error) return false — this signal is additive, never blocking.
+ */
+export declare function hasPackageJsonDep(projectRoot: string, depNames?: readonly string[]): boolean;
 /**
  * Bounded extension scan for project relevance decisions.
  *

package/dist/lsp-project-relevance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp-project-relevance.d.ts","sourceRoot":"","sources":["../src/lsp-project-relevance.ts"],"names":[],"mappings":"AAiBA,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAM3F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GACvD,GAAG,CAAC,MAAM,CAAC,CAmCb"}
+{"version":3,"file":"lsp-project-relevance.d.ts","sourceRoot":"","sources":["../src/lsp-project-relevance.ts"],"names":[],"mappings":"AAiBA,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAM3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAe5F;AAmBD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GACvD,GAAG,CAAC,MAAM,CAAC,CAmCb"}

package/dist/notifications.d.ts

@@ -74,7 +74,7 @@ export declare function sendStatus(opts: NotificationOptions, message: string):
  * Desktop: ignored message in the active session.
  * TUI: toast with info variant.
  */
-export declare function sendFeatureAnnouncement(opts: NotificationOptions, version: string, features: string[], storageDir?: string): Promise<void>;
+export declare function sendFeatureAnnouncement(opts: NotificationOptions, version: string, features: string[], footer: string, storageDir?: string): Promise<void>;
 export declare function deliverConfigureWarnings(opts: ConfigureWarningOptions, warnings: ConfigureWarning[]): Promise<void>;
 /**
  * Clean up stale AFT warning messages from previous runs.

package/dist/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAmI1D,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAyBF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBvB;AAqED,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C1F;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Cf;AA4ED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C9E"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAmI1D,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAyBF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBvB;AAqED,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C1F;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAsDf;AA4ED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C9E"}

package/dist/tools/hoisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA+JjE;AA8kCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwB/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAgGnF"}
+{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA+JjE;AAmmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwB/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4FnF"}

package/dist/tui.js

@@ -4,7 +4,7 @@ import { createMemo as createMemo2, createSignal as createSignal2, onCleanup as
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.27.0",
+  version: "0.28.0",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) \u2014 tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -28,11 +28,12 @@ var package_default = {
     test: "bun test",
     "test:e2e": "bun test src/__tests__/e2e/",
     lint: "biome check src",
+    schema: "bun scripts/build-schema.ts",
     prepublishOnly: "bun run build"
   },
   dependencies: {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.27.0",
+    "@cortexkit/aft-bridge": "0.28.0",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
     "comment-json": "^4.6.2",
@@ -40,11 +41,12 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.27.0",
-    "@cortexkit/aft-darwin-x64": "0.27.0",
-    "@cortexkit/aft-linux-arm64": "0.27.0",
-    "@cortexkit/aft-linux-x64": "0.27.0",
-    "@cortexkit/aft-win32-x64": "0.27.0"
+    "@cortexkit/aft-darwin-arm64": "0.28.0",
+    "@cortexkit/aft-darwin-x64": "0.28.0",
+    "@cortexkit/aft-linux-arm64": "0.28.0",
+    "@cortexkit/aft-linux-x64": "0.28.0",
+    "@cortexkit/aft-win32-arm64": "0.28.0",
+    "@cortexkit/aft-win32-x64": "0.28.0"
   },
   devDependencies: {
     "@types/node": "^22.0.0",
@@ -594,6 +596,7 @@ var SidebarContent = (props) => {
     });
   }, { defer: false }));
   const s = createMemo(() => status());
+  const notInitialized = () => s()?.cache_role === "not_initialized";
   const searchStatus = () => statusDisplay(s()?.search_index?.status ?? "disabled");
   const semanticStatus = () => statusDisplay(s()?.semantic_index?.status ?? "disabled");
   const trigramBytes = () => s()?.disk?.trigram_disk_bytes ?? 0;
@@ -662,7 +665,7 @@ var SidebarContent = (props) => {
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV("text", {
+          !notInitialized() && /* @__PURE__ */ jsxDEV("text", {
             fg: props.theme.textMuted,
             children: [
               "v",
@@ -682,95 +685,99 @@ var SidebarContent = (props) => {
           ]
         }, undefined, true, undefined, this)
       }, undefined, false, undefined, this),
-      s()?.cache_role === "not_initialized" && /* @__PURE__ */ jsxDEV("box", {
+      notInitialized() && /* @__PURE__ */ jsxDEV("box", {
         marginTop: 1,
         width: "100%",
         children: /* @__PURE__ */ jsxDEV("text", {
           fg: props.theme.textMuted,
-          children: s().message || "Waiting for first tool call to populate"
+          children: s().message || "AFT bridge is now spawned lazily, information here will be populated after first tool call."
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(SectionHeader, {
-        theme: props.theme,
-        title: "Search Index"
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Status",
-        value: searchStatus().label,
-        tone: searchStatus().tone
-      }, undefined, false, undefined, this),
-      (s()?.search_index?.files ?? null) != null && /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Files",
-        value: formatCount(s().search_index.files),
-        tone: "muted"
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Disk",
-        value: formatBytes2(trigramBytes()),
-        tone: "muted"
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(SectionHeader, {
-        theme: props.theme,
-        title: "Semantic Index"
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Status",
-        value: semanticStatus().label,
-        tone: semanticStatus().tone
-      }, undefined, false, undefined, this),
-      s()?.semantic_index?.status === "loading" && s()?.semantic_index?.entries_total != null && s().semantic_index.entries_total > 0 && /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Progress",
-        value: `${formatCount(s().semantic_index.entries_done)} / ${formatCount(s().semantic_index.entries_total)}`,
-        tone: "warn"
-      }, undefined, false, undefined, this),
-      (s()?.semantic_index?.entries ?? null) != null && /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Entries",
-        value: formatCount(s().semantic_index.entries),
-        tone: "muted"
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(StatRow, {
-        theme: props.theme,
-        label: "Disk",
-        value: formatBytes2(semanticBytes()),
-        tone: "muted"
-      }, undefined, false, undefined, this),
-      compressionRows().length > 0 && /* @__PURE__ */ jsxDEV(Fragment, {
+      !notInitialized() && /* @__PURE__ */ jsxDEV(Fragment, {
         children: [
           /* @__PURE__ */ jsxDEV(SectionHeader, {
             theme: props.theme,
-            title: "Compression"
+            title: "Search Index"
           }, undefined, false, undefined, this),
-          compressionRows().map((row) => row.kind === "scope" ? /* @__PURE__ */ jsxDEV("box", {
-            width: "100%",
-            children: /* @__PURE__ */ jsxDEV("text", {
-              fg: props.theme.text,
-              children: row.label
-            }, undefined, false, undefined, this)
-          }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(StatRow, {
+          /* @__PURE__ */ jsxDEV(StatRow, {
             theme: props.theme,
-            label: row.label,
-            value: row.value,
+            label: "Status",
+            value: searchStatus().label,
+            tone: searchStatus().tone
+          }, undefined, false, undefined, this),
+          (s()?.search_index?.files ?? null) != null && /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Files",
+            value: formatCount(s().search_index.files),
             tone: "muted"
-          }, undefined, false, undefined, this))
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Disk",
+            value: formatBytes2(trigramBytes()),
+            tone: "muted"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(SectionHeader, {
+            theme: props.theme,
+            title: "Semantic Index"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Status",
+            value: semanticStatus().label,
+            tone: semanticStatus().tone
+          }, undefined, false, undefined, this),
+          s()?.semantic_index?.status === "loading" && s()?.semantic_index?.entries_total != null && s().semantic_index.entries_total > 0 && /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Progress",
+            value: `${formatCount(s().semantic_index.entries_done)} / ${formatCount(s().semantic_index.entries_total)}`,
+            tone: "warn"
+          }, undefined, false, undefined, this),
+          (s()?.semantic_index?.entries ?? null) != null && /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Entries",
+            value: formatCount(s().semantic_index.entries),
+            tone: "muted"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatRow, {
+            theme: props.theme,
+            label: "Disk",
+            value: formatBytes2(semanticBytes()),
+            tone: "muted"
+          }, undefined, false, undefined, this),
+          compressionRows().length > 0 && /* @__PURE__ */ jsxDEV(Fragment, {
+            children: [
+              /* @__PURE__ */ jsxDEV(SectionHeader, {
+                theme: props.theme,
+                title: "Compression"
+              }, undefined, false, undefined, this),
+              compressionRows().map((row) => row.kind === "scope" ? /* @__PURE__ */ jsxDEV("box", {
+                width: "100%",
+                children: /* @__PURE__ */ jsxDEV("text", {
+                  fg: props.theme.text,
+                  children: row.label
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(StatRow, {
+                theme: props.theme,
+                label: row.label,
+                value: row.value,
+                tone: "muted"
+              }, undefined, false, undefined, this))
+            ]
+          }, undefined, true, undefined, this),
+          s()?.semantic_index?.status === "failed" && s()?.semantic_index?.error && /* @__PURE__ */ jsxDEV("box", {
+            marginTop: 1,
+            width: "100%",
+            children: /* @__PURE__ */ jsxDEV("text", {
+              fg: props.theme.error,
+              children: [
+                "\u26A0 ",
+                s().semantic_index.error
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this)
         ]
-      }, undefined, true, undefined, this),
-      s()?.semantic_index?.status === "failed" && s()?.semantic_index?.error && /* @__PURE__ */ jsxDEV("box", {
-        marginTop: 1,
-        width: "100%",
-        children: /* @__PURE__ */ jsxDEV("text", {
-          fg: props.theme.error,
-          children: [
-            "\u26A0 ",
-            s().semantic_index.error
-          ]
-        }, undefined, true, undefined, this)
-      }, undefined, false, undefined, this)
+      }, undefined, true, undefined, this)
     ]
   }, undefined, true, undefined, this);
 };
@@ -913,7 +920,7 @@ var StatusDialog = (props) => {
               children: "\u26A1 AFT Status"
             }, undefined, false, undefined, this)
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV2("text", {
+          status()?.cache_role !== "not_initialized" && /* @__PURE__ */ jsxDEV2("text", {
             fg: t().textMuted,
             children: [
               "v",
@@ -936,7 +943,7 @@ var StatusDialog = (props) => {
         justifyContent: "center",
         children: /* @__PURE__ */ jsxDEV2("text", {
           fg: t().textMuted,
-          children: status().message || "Waiting for first tool call to populate"
+          children: status().message || "AFT bridge is now spawned lazily, information here will be populated after first tool call."
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this) : null,
       status() && status().cache_role !== "not_initialized" ? /* @__PURE__ */ jsxDEV2("box", {
@@ -962,7 +969,7 @@ var StatusDialog = (props) => {
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this) : null,
-      status() ? /* @__PURE__ */ jsxDEV2("box", {
+      status() && status().cache_role !== "not_initialized" ? /* @__PURE__ */ jsxDEV2("box", {
         flexDirection: "row",
         width: "100%",
         gap: 4,
@@ -1288,11 +1295,17 @@ async function showStartupNotifications(api) {
     if (announcement.show && announcement.version && announcement.features?.length) {
       const featureText = announcement.features.map((f) => `  \u2022 ${f}`).join(`
 `);
+      const hasFooter = typeof announcement.footer === "string" && announcement.footer.trim().length > 0;
+      const message = hasFooter ? `What's new:
+
+${featureText}
+
+${announcement.footer}` : `What's new:
+
+${featureText}`;
       api.ui.dialog.replace(() => /* @__PURE__ */ jsxDEV2(api.ui.DialogAlert, {
         title: `AFT v${announcement.version}`,
-        message: `What's new:
-
-${featureText}`,
+        message,
         onConfirm: () => {
           client.call("mark-announced", {});
         }

package/dist/workflow-hints.d.ts

@@ -1,4 +1,4 @@
-import type { AftConfig } from "./config.js";
+import { type AftConfig } from "./config.js";
 export interface WorkflowHintsOpts {
     /** `tool_surface` setting — controls which tools are registered. */
     toolSurface: "minimal" | "recommended" | "all";
@@ -20,6 +20,10 @@ export declare function buildWorkflowHints(opts: WorkflowHintsOpts): string | nu
 /**
  * Resolve workflow-hints opts from a loaded AftConfig and the active
  * disabled-tools set computed at registration time.
+ *
+ * Background-bash gating reads the resolved bash config so the new
+ * graduated `bash: true` / `bash: { background: true }` shapes enable the
+ * hint, not just the legacy `experimental.bash.background: true` path.
  */
 export declare function buildHintsFromConfig(config: AftConfig, disabledTools: Set<string>): string | null;
 //# sourceMappingURL=workflow-hints.d.ts.map

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,CAmEzE;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,EAAE,KAAK,SAAS,EAAqB,MAAM,aAAa,CAAC;AAEhE,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;;;;;;;GAOG;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.27.0",
+  "version": "0.28.0",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -24,11 +24,12 @@
     "test": "bun test",
     "test:e2e": "bun test src/__tests__/e2e/",
     "lint": "biome check src",
+    "schema": "bun scripts/build-schema.ts",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.27.0",
+    "@cortexkit/aft-bridge": "0.28.0",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
     "comment-json": "^4.6.2",
@@ -36,11 +37,12 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.27.0",
-    "@cortexkit/aft-darwin-x64": "0.27.0",
-    "@cortexkit/aft-linux-arm64": "0.27.0",
-    "@cortexkit/aft-linux-x64": "0.27.0",
-    "@cortexkit/aft-win32-x64": "0.27.0"
+    "@cortexkit/aft-darwin-arm64": "0.28.0",
+    "@cortexkit/aft-darwin-x64": "0.28.0",
+    "@cortexkit/aft-linux-arm64": "0.28.0",
+    "@cortexkit/aft-linux-x64": "0.28.0",
+    "@cortexkit/aft-win32-arm64": "0.28.0",
+    "@cortexkit/aft-win32-x64": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/tui/index.tsx

@@ -174,12 +174,16 @@ const StatusDialog = (props: StatusDialogProps) => {
       paddingTop={1}
       paddingBottom={1}
     >
-      {/* Title */}
+      {/* Title. Hide version while the lazy-spawn placeholder is showing — users
+          read `vunknown` next to "AFT Status" as broken state instead of "AFT
+          has not been used yet for this project". */}
       <box justifyContent="center" width="100%" marginBottom={1} flexDirection="row" gap={2}>
         <text fg={t().accent}>
           <b>⚡ AFT Status</b>
         </text>
-        <text fg={t().textMuted}>v{status()?.version ?? packageJson.version}</text>
+        {status()?.cache_role !== "not_initialized" && (
+          <text fg={t().textMuted}>v{status()?.version ?? packageJson.version}</text>
+        )}
       </box>
 
       {/* Error / not-yet-ready state */}
@@ -197,7 +201,8 @@ const StatusDialog = (props: StatusDialogProps) => {
       {status()?.cache_role === "not_initialized" ? (
         <box width="100%" marginTop={1} justifyContent="center">
           <text fg={t().textMuted}>
-            {status()!.message || "Waiting for first tool call to populate"}
+            {status()!.message ||
+              "AFT bridge is now spawned lazily, information here will be populated after first tool call."}
           </text>
         </box>
       ) : null}
@@ -224,8 +229,10 @@ const StatusDialog = (props: StatusDialogProps) => {
         </box>
       ) : null}
 
-      {/* 2-column body */}
-      {status() ? (
+      {/* 2-column body. Gate on cache_role too so a synthetic not_initialized
+          snapshot doesn't render an empty grid of "unknown" / "—" rows
+          alongside the lazy-spawn placeholder message above. */}
+      {status() && status()!.cache_role !== "not_initialized" ? (
         <box flexDirection="row" width="100%" gap={4}>
           {/* Left column */}
           <box flexDirection="column" flexGrow={1} flexBasis={0}>
@@ -540,16 +547,24 @@ async function showStartupNotifications(api: TuiPluginApi): Promise<void> {
       show?: boolean;
       version?: string;
       features?: string[];
+      footer?: string;
     };
 
     if (announcement.show && announcement.version && announcement.features?.length) {
       const featureText = announcement.features.map((f: string) => `  • ${f}`).join("\n");
+      // Blank-line separator distinguishes the persistent footer (Discord
+      // invite, etc.) from the version-specific bullets.
+      const hasFooter =
+        typeof announcement.footer === "string" && announcement.footer.trim().length > 0;
+      const message = hasFooter
+        ? `What's new:\n\n${featureText}\n\n${announcement.footer}`
+        : `What's new:\n\n${featureText}`;
 
       api.ui.dialog.replace(
         () => (
           <api.ui.DialogAlert
             title={`AFT v${announcement.version}`}
-            message={`What's new:\n\n${featureText}`}
+            message={message}
             onConfirm={() => {
               // Mark as announced so it doesn't show again
               void client.call("mark-announced", {});