@gmickel/gno 0.28.1 → 0.29.0

package/README.md

@@ -34,7 +34,13 @@ GNO is a local knowledge engine that turns your documents into a searchable, con
 
 ---
 
-## What's New in v0.24
+## What's New in v0.29
+
+- **GNO Desktop Beta**: first mac-first desktop beta shell with deep-link routing, singleton handoff, and the same onboarding/search/edit flows as `gno serve`
+- **Desktop Onboarding Polish**: guided setup now covers folders, presets, model readiness, indexing, connectors, import preview, app tabs, file actions, and recovery without drift between web and desktop
+- **Default Preset Upgrade**: `slim-tuned` is now the built-in default, using the fine-tuned retrieval expansion model while keeping the same embed, rerank, and answer stack as `slim`
+
+### v0.24
 
 - **Structured Query Documents**: first-class multi-line query syntax using `term:`, `intent:`, and `hyde:`
 - **Cross-Surface Rollout**: works across CLI, API, MCP, SDK, and Web Search/Ask
@@ -65,7 +71,7 @@ models:
       embed: hf:gpustack/bge-m3-GGUF/bge-m3-Q4_K_M.gguf
       rerank: hf:ggml-org/Qwen3-Reranker-0.6B-Q8_0-GGUF/qwen3-reranker-0.6b-q8_0.gguf
       expand: hf:guiltylemon/gno-expansion-slim-retrieval-v1/gno-expansion-auto-entity-lock-default-mix-lr95-f16.gguf
-      gen: hf:unsloth/Qwen3-4B-Instruct-2507-GGUF/Qwen3-4B-Instruct-2507-Q4_K_M.gguf
+      gen: hf:unsloth/Qwen3-1.7B-GGUF/Qwen3-1.7B-Q4_K_M.gguf
 ```
 
 Then:
@@ -373,6 +379,8 @@ Open `http://localhost:3000` to:
 - **Edit**: Create, edit, and delete documents with live preview
 - **Ask**: AI-powered Q&A with citations
 - **Manage Collections**: Add, remove, and re-index collections
+- **Connect agents**: Install core Skill/MCP integrations from the app
+- **Manage files safely**: Rename, reveal, or move editable files to Trash with explicit index-vs-disk semantics
 - **Switch presets**: Change models live without restart
 
 ### Search

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",
@@ -166,24 +166,24 @@
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.2",
-    "@biomejs/biome": "2.3.13",
+    "@biomejs/biome": "2.3.14",
     "@tailwindcss/cli": "^4.1.18",
     "@types/bun": "latest",
-    "@types/react": "^19.2.7",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "docx": "^9.5.1",
     "evalite": "^1.0.0-beta.15",
     "exceljs": "^4.4.0",
-    "lefthook": "^2.0.13",
+    "lefthook": "^2.1.0",
     "oxfmt": "^0.28.0",
     "oxlint": "^1.42.0",
-    "oxlint-tsgolint": "^0.11.4",
+    "oxlint-tsgolint": "^0.11.5",
     "pdf-lib": "^1.17.1",
-    "playwright": "^1.52.0",
+    "playwright": "^1.58.2",
     "pptxgenjs": "^4.0.1",
-    "ultracite": "7.1.3",
+    "ultracite": "7.1.5",
     "vitest": "^4.0.16"
   },
   "peerDependencies": {

package/src/app/constants.ts

@@ -6,7 +6,7 @@
  */
 
 import { homedir, platform } from "node:os";
-import { join } from "node:path";
+import { basename, join } from "node:path";
 
 // Bun supports JSON imports natively - version single source of truth
 import pkg from "../../package.json";
@@ -232,7 +232,9 @@ export function getConfigPath(dirs: ResolvedDirs = resolveDirs()): string {
  * Get path to models cache directory.
  */
 export function getModelsCachePath(dirs: ResolvedDirs = resolveDirs()): string {
-  return join(dirs.cache, "models");
+  return basename(dirs.cache) === "models"
+    ? dirs.cache
+    : join(dirs.cache, "models");
 }
 
 // ─────────────────────────────────────────────────────────────────────────────

package/src/cli/commands/mcp/install.ts

@@ -46,7 +46,7 @@ export interface InstallOptions {
   quiet?: boolean;
 }
 
-interface InstallResult {
+export interface McpInstallResult {
   target: McpTarget;
   scope: McpScope;
   configPath: string;
@@ -61,7 +61,7 @@ interface InstallResult {
 /**
  * Install gno to a single target.
  */
-async function installToTarget(
+export async function installMcpToTarget(
   target: McpTarget,
   scope: McpScope,
   serverEntry: StandardMcpEntry,
@@ -71,7 +71,7 @@ async function installToTarget(
     cwd?: string;
     homeDir?: string;
   }
-): Promise<InstallResult> {
+): Promise<McpInstallResult> {
   const { force = false, dryRun = false, cwd, homeDir } = options;
 
   const { configPath, configFormat } = resolveMcpConfigPath({
@@ -165,7 +165,7 @@ export async function installMcp(opts: InstallOptions = {}): Promise<void> {
   const serverEntry = buildMcpServerEntry({ enableWrite });
 
   // Install
-  const result = await installToTarget(target, scope, serverEntry, {
+  const result = await installMcpToTarget(target, scope, serverEntry, {
     force,
     dryRun,
     cwd: opts.cwd,

package/src/cli/commands/mcp/status.ts

@@ -37,7 +37,7 @@ export interface StatusOptions {
   json?: boolean;
 }
 
-interface TargetStatus {
+export interface McpTargetStatus {
   target: McpTarget;
   scope: McpScope;
   configPath: string;
@@ -47,7 +47,7 @@ interface TargetStatus {
 }
 
 interface StatusResult {
-  targets: TargetStatus[];
+  targets: McpTargetStatus[];
   summary: {
     configured: number;
     total: number;
@@ -72,11 +72,11 @@ function normalizeEntry(
   return entry as StandardMcpEntry;
 }
 
-async function checkTargetStatus(
+export async function checkMcpTargetStatus(
   target: McpTarget,
   scope: McpScope,
   options: { cwd?: string; homeDir?: string }
-): Promise<TargetStatus> {
+): Promise<McpTargetStatus> {
   const { cwd, homeDir } = options;
 
   const { configPath, configFormat } = resolveMcpConfigPath({
@@ -151,7 +151,7 @@ export async function statusMcp(opts: StatusOptions = {}): Promise<void> {
   const targets: McpTarget[] =
     targetFilter === "all" ? MCP_TARGETS : [targetFilter];
 
-  const results: TargetStatus[] = [];
+  const results: McpTargetStatus[] = [];
 
   for (const target of targets) {
     const supportsProject = TARGETS_WITH_PROJECT_SCOPE.includes(target);
@@ -163,7 +163,7 @@ export async function statusMcp(opts: StatusOptions = {}): Promise<void> {
 
       for (const scope of scopes) {
         results.push(
-          await checkTargetStatus(target, scope, {
+          await checkMcpTargetStatus(target, scope, {
             cwd: opts.cwd,
             homeDir: opts.homeDir,
           })
@@ -172,7 +172,7 @@ export async function statusMcp(opts: StatusOptions = {}): Promise<void> {
     } else if (scopeFilter === "all" || scopeFilter === "user") {
       // User scope only - skip if filtering by project
       results.push(
-        await checkTargetStatus(target, "user", {
+        await checkMcpTargetStatus(target, "user", {
           cwd: opts.cwd,
           homeDir: opts.homeDir,
         })

package/src/cli/commands/skill/install.ts

@@ -54,7 +54,7 @@ export interface InstallOptions {
   quiet?: boolean;
 }
 
-interface InstallResult {
+export interface SkillInstallResult {
   target: SkillTarget;
   scope: SkillScope;
   path: string;
@@ -63,12 +63,12 @@ interface InstallResult {
 /**
  * Install skill to a single target.
  */
-async function installToTarget(
+export async function installSkillToTarget(
   scope: SkillScope,
   target: SkillTarget,
   force: boolean,
   overrides?: { cwd?: string; homeDir?: string }
-): Promise<InstallResult> {
+): Promise<SkillInstallResult> {
   const sourceDir = getSkillSourceDir();
   const paths = resolveSkillPaths({ scope, target, ...overrides });
 
@@ -174,10 +174,10 @@ export async function installSkill(opts: InstallOptions = {}): Promise<void> {
 
   const targets: SkillTarget[] = target === "all" ? SKILL_TARGETS : [target];
 
-  const results: InstallResult[] = [];
+  const results: SkillInstallResult[] = [];
 
   for (const t of targets) {
-    const result = await installToTarget(scope, t, force || yes, {
+    const result = await installSkillToTarget(scope, t, force || yes, {
       cwd: opts.cwd,
       homeDir: opts.homeDir,
     });

package/src/cli/program.ts

@@ -542,7 +542,7 @@ function wireSearchCommands(program: Command): void {
       const configResult = await loadConfig(globals.config);
       const activePresetId = configResult.ok
         ? getActivePreset(configResult.value).id
-        : "slim";
+        : "slim-tuned";
       const candidateLimit = cmdOpts.candidateLimit
         ? parsePositiveInt("candidate-limit", cmdOpts.candidateLimit)
         : undefined;
@@ -655,7 +655,7 @@ function wireSearchCommands(program: Command): void {
       const configResult = await loadConfig(globals.config);
       const activePresetId = configResult.ok
         ? getActivePreset(configResult.value).id
-        : "slim";
+        : "slim-tuned";
       const candidateLimit = cmdOpts.candidateLimit
         ? parsePositiveInt("candidate-limit", cmdOpts.candidateLimit)
         : undefined;

package/src/collection/add.ts

@@ -73,6 +73,16 @@ export async function addCollection(
     };
   }
 
+  // Check for duplicate path
+  const existingPath = config.collections.find((c) => c.path === absolutePath);
+  if (existingPath) {
+    return {
+      ok: false,
+      code: "DUPLICATE_PATH",
+      message: `Path is already indexed by collection "${existingPath.name}"`,
+    };
+  }
+
   // Parse include/exclude lists
   const includeList = parseList(input.include);
   const excludeList =

package/src/collection/types.ts

@@ -60,6 +60,7 @@ export interface CollectionError {
     | "VALIDATION"
     | "NOT_FOUND"
     | "DUPLICATE"
+    | "DUPLICATE_PATH"
     | "PATH_NOT_FOUND"
     | "HAS_REFERENCES";
   message: string;

package/src/config/types.ts

@@ -176,9 +176,19 @@ export type ModelPreset = z.infer<typeof ModelPresetSchema>;
 
 /** Default model presets */
 export const DEFAULT_MODEL_PRESETS: ModelPreset[] = [
+  {
+    id: "slim-tuned",
+    name: "GNO Slim Tuned (Default, ~1GB)",
+    embed: "hf:gpustack/bge-m3-GGUF/bge-m3-Q4_K_M.gguf",
+    rerank:
+      "hf:ggml-org/Qwen3-Reranker-0.6B-Q8_0-GGUF/qwen3-reranker-0.6b-q8_0.gguf",
+    expand:
+      "hf:guiltylemon/gno-expansion-slim-retrieval-v1/gno-expansion-auto-entity-lock-default-mix-lr95-f16.gguf",
+    gen: "hf:unsloth/Qwen3-1.7B-GGUF/Qwen3-1.7B-Q4_K_M.gguf",
+  },
   {
     id: "slim",
-    name: "Slim (Default, ~1GB)",
+    name: "Slim (~1GB)",
     embed: "hf:gpustack/bge-m3-GGUF/bge-m3-Q4_K_M.gguf",
     rerank:
       "hf:ggml-org/Qwen3-Reranker-0.6B-Q8_0-GGUF/qwen3-reranker-0.6b-q8_0.gguf",
@@ -209,7 +219,7 @@ export const DEFAULT_MODEL_PRESETS: ModelPreset[] = [
 
 export const ModelConfigSchema = z.object({
   /** Active preset ID */
-  activePreset: z.string().default("slim"),
+  activePreset: z.string().default("slim-tuned"),
   /** Model presets */
   presets: z.array(ModelPresetSchema).default(DEFAULT_MODEL_PRESETS),
   /** Model load timeout in ms */

package/src/core/depth-policy.ts

@@ -21,7 +21,7 @@ export interface ResolvedDepthPolicy {
 export const DEFAULT_THOROUGH_CANDIDATE_LIMIT = 40;
 
 function normalizePresetId(presetId?: string): string {
-  return presetId?.trim().toLowerCase() || "slim";
+  return presetId?.trim().toLowerCase() || "slim-tuned";
 }
 
 export function balancedUsesExpansion(presetId?: string): boolean {

package/src/core/file-ops.ts

@@ -6,6 +6,10 @@
 
 // node:fs/promises for rename/unlink (no Bun equivalent for structure ops)
 import { rename, unlink } from "node:fs/promises";
+// node:os platform: no Bun equivalent
+import { platform } from "node:os";
+// node:path dirname: no Bun equivalent
+import { dirname } from "node:path";
 
 export async function atomicWrite(
   path: string,
@@ -22,3 +26,37 @@ export async function atomicWrite(
     throw e;
   }
 }
+
+async function runCommand(cmd: string[]): Promise<void> {
+  const proc = Bun.spawn({
+    cmd,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+  const exitCode = await proc.exited;
+  if (exitCode === 0) {
+    return;
+  }
+  const stderr = await new Response(proc.stderr).text();
+  throw new Error(stderr.trim() || `Command failed: ${cmd.join(" ")}`);
+}
+
+export async function renameFilePath(
+  currentPath: string,
+  nextPath: string
+): Promise<void> {
+  await rename(currentPath, nextPath);
+}
+
+export async function trashFilePath(path: string): Promise<void> {
+  await runCommand(["trash", path]);
+}
+
+export async function revealFilePath(path: string): Promise<void> {
+  if (platform() === "darwin") {
+    await runCommand(["open", "-R", path]);
+    return;
+  }
+
+  await runCommand(["xdg-open", dirname(path)]);
+}

package/src/llm/registry.ts

@@ -18,11 +18,27 @@ import { DEFAULT_MODEL_PRESETS } from "../config/types";
  * Get model config with defaults.
  */
 export function getModelConfig(config: Config): ModelConfig {
+  const customPresets = config.models?.presets ?? [];
+  const presetsById = new Map(
+    DEFAULT_MODEL_PRESETS.map((preset) => [preset.id, preset] as const)
+  );
+
+  for (const preset of customPresets) {
+    presetsById.set(preset.id, preset);
+  }
+
+  const mergedPresets = [
+    ...DEFAULT_MODEL_PRESETS.map(
+      (preset) => presetsById.get(preset.id) ?? preset
+    ),
+    ...customPresets.filter(
+      (preset) => !DEFAULT_MODEL_PRESETS.some((base) => base.id === preset.id)
+    ),
+  ];
+
   return {
-    activePreset: config.models?.activePreset ?? "slim",
-    presets: config.models?.presets?.length
-      ? config.models.presets
-      : DEFAULT_MODEL_PRESETS,
+    activePreset: config.models?.activePreset ?? "slim-tuned",
+    presets: mergedPresets,
     loadTimeout: config.models?.loadTimeout ?? 60_000,
     inferenceTimeout: config.models?.inferenceTimeout ?? 30_000,
     expandContextSize: config.models?.expandContextSize ?? 2_048,

package/src/serve/AGENTS.md

@@ -65,22 +65,22 @@ Answer generation uses shared module to stay in sync with CLI:
 
 ## API Endpoints
 
-| Endpoint             | Method | Description                |
-| -------------------- | ------ | -------------------------- |
-| `/api/health`        | GET    | Health check               |
-| `/api/status`        | GET    | Index stats, collections   |
-| `/api/capabilities`  | GET    | Available features         |
-| `/api/collections`   | GET    | List collections           |
-| `/api/docs`          | GET    | List documents             |
-| `/api/doc`           | GET    | Get document content       |
-| `/api/search`        | POST   | BM25 search                |
-| `/api/query`         | POST   | Hybrid search              |
-| `/api/ask`           | POST   | AI answer with citations   |
-| `/api/presets`       | GET    | List model presets         |
-| `/api/presets`       | POST   | Switch preset (hot-reload) |
-| `/api/models/status` | GET    | Download progress          |
-| `/api/models/pull`   | POST   | Start model download       |
-| `/api/tags`          | GET    | List tags (with counts)    |
+| Endpoint             | Method | Description                                |
+| -------------------- | ------ | ------------------------------------------ |
+| `/api/health`        | GET    | Health check                               |
+| `/api/status`        | GET    | Index stats, onboarding, health, bootstrap |
+| `/api/capabilities`  | GET    | Available features                         |
+| `/api/collections`   | GET    | List collections                           |
+| `/api/docs`          | GET    | List documents                             |
+| `/api/doc`           | GET    | Get document content                       |
+| `/api/search`        | POST   | BM25 search                                |
+| `/api/query`         | POST   | Hybrid search                              |
+| `/api/ask`           | POST   | AI answer with citations                   |
+| `/api/presets`       | GET    | List model presets                         |
+| `/api/presets`       | POST   | Switch preset (hot-reload)                 |
+| `/api/models/status` | GET    | Download progress                          |
+| `/api/models/pull`   | POST   | Start model download                       |
+| `/api/tags`          | GET    | List tags (with counts)                    |
 
 ## Frontend
 

package/src/serve/CLAUDE.md

@@ -65,22 +65,22 @@ Answer generation uses shared module to stay in sync with CLI:
 
 ## API Endpoints
 
-| Endpoint             | Method | Description                |
-| -------------------- | ------ | -------------------------- |
-| `/api/health`        | GET    | Health check               |
-| `/api/status`        | GET    | Index stats, collections   |
-| `/api/capabilities`  | GET    | Available features         |
-| `/api/collections`   | GET    | List collections           |
-| `/api/docs`          | GET    | List documents             |
-| `/api/doc`           | GET    | Get document content       |
-| `/api/search`        | POST   | BM25 search                |
-| `/api/query`         | POST   | Hybrid search              |
-| `/api/ask`           | POST   | AI answer with citations   |
-| `/api/presets`       | GET    | List model presets         |
-| `/api/presets`       | POST   | Switch preset (hot-reload) |
-| `/api/models/status` | GET    | Download progress          |
-| `/api/models/pull`   | POST   | Start model download       |
-| `/api/tags`          | GET    | List tags (with counts)    |
+| Endpoint             | Method | Description                                |
+| -------------------- | ------ | ------------------------------------------ |
+| `/api/health`        | GET    | Health check                               |
+| `/api/status`        | GET    | Index stats, onboarding, health, bootstrap |
+| `/api/capabilities`  | GET    | Available features                         |
+| `/api/collections`   | GET    | List collections                           |
+| `/api/docs`          | GET    | List documents                             |
+| `/api/doc`           | GET    | Get document content                       |
+| `/api/search`        | POST   | BM25 search                                |
+| `/api/query`         | POST   | Hybrid search                              |
+| `/api/ask`           | POST   | AI answer with citations                   |
+| `/api/presets`       | GET    | List model presets                         |
+| `/api/presets`       | POST   | Switch preset (hot-reload)                 |
+| `/api/models/status` | GET    | Download progress                          |
+| `/api/models/pull`   | POST   | Start model download                       |
+| `/api/tags`          | GET    | List tags (with counts)                    |
 
 ## Frontend
 

package/src/serve/config-sync.ts

@@ -40,7 +40,7 @@ export async function applyConfigChange(
   mutate: (config: Config) => Promise<MutationResult> | MutationResult,
   configPath?: string
 ): Promise<ApplyConfigResult> {
-  return applyConfigChangeCore(
+  const result = await applyConfigChangeCore(
     {
       store,
       configPath,
@@ -51,4 +51,35 @@ export async function applyConfigChange(
     },
     mutate
   );
+
+  if (result.ok) {
+    ctxHolder.watchService?.updateCollections(ctxHolder.config.collections);
+  }
+
+  return result;
+}
+
+export async function applyConfigChangeTyped<T>(
+  ctxHolder: ContextHolder,
+  store: SqliteAdapter,
+  mutate: (config: Config) => Promise<MutationResult<T>> | MutationResult<T>,
+  configPath?: string
+): Promise<ApplyConfigResult<T>> {
+  const result = await applyConfigChangeCore(
+    {
+      store,
+      configPath,
+      onConfigUpdated: (config) => {
+        ctxHolder.config = config;
+        ctxHolder.current = { ...ctxHolder.current, config };
+      },
+    },
+    mutate
+  );
+
+  if (result.ok) {
+    ctxHolder.watchService?.updateCollections(ctxHolder.config.collections);
+  }
+
+  return result;
 }