@gmickel/gno 1.39.0 → 1.39.2

package/browser-extension/artifacts/gno-browser-clipper-v1.39.2.zip.sha256

@@ -0,0 +1 @@
+82afff37d4a331933c19bebb9c73972fd6eb665ffd1444bbdf65cfb0220dd692  gno-browser-clipper-v1.39.2.zip

package/browser-extension/dist/manifest.json

@@ -21,5 +21,5 @@
   "content_security_policy": {
     "extension_pages": "script-src 'self'; object-src 'none'; connect-src http://127.0.0.1:*"
   },
-  "version": "1.39.0"
+  "version": "1.39.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "1.39.0",
+  "version": "1.39.2",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",

package/spec/cli.md

@@ -1194,34 +1194,36 @@ BM25 keyword search over indexed documents.
 **Synopsis:**
 
 ```bash
-gno search <query> [-n <num>] [--min-score <num>] [-c <collection>] [--since <date>] [--until <date>] [--category <values>] [--author <text>] [--intent <text>] [--exclude <values>] [--tags-all <tags>] [--tags-any <tags>] [--full] [--line-numbers] [--lang <bcp47>] [--json|--files|--csv|--md|--xml]
+gno search [query] [--query-file <path>] [-n <num>] [--min-score <num>] [-c <collection>] [--since <date>] [--until <date>] [--category <values>] [--author <text>] [--intent <text>] [--exclude <values>] [--tags-all <tags>] [--tags-any <tags>] [--full] [--line-numbers] [--lang <bcp47>] [--json|--files|--csv|--md|--xml]
 ```
 
 **Arguments:**
-| Arg | Type | Description |
-|-----|------|-------------|
-| `<query>` | string | Search query |
+
+| Arg       | Type   | Description                                                          |
+| --------- | ------ | -------------------------------------------------------------------- |
+| `[query]` | string | Search query. Optional when `--query-file` is set. Do not pass both. |
 
 **Options:**
 
-| Option                  | Type     | Default                   | Description                                                                                   |
-| ----------------------- | -------- | ------------------------- | --------------------------------------------------------------------------------------------- |
-| `-n`                    | integer  | 5 (20 for --json/--files) | Max results                                                                                   |
-| `--min-score`           | number   | 0                         | Minimum score threshold                                                                       |
-| `-c, --collection`      | string   | all                       | Filter to collection                                                                          |
-| `--since`               | string   | none                      | Modified-at lower bound (ISO date/time or relative token)                                     |
-| `--until`               | string   | none                      | Modified-at upper bound (ISO date/time or relative token)                                     |
-| `--category`            | string   | none                      | Filter to docs with matching category/content type (comma-separated)                          |
-| `--author`              | string   | none                      | Filter to docs where author contains value (case-insensitive)                                 |
-| `--intent`              | string   | none                      | Disambiguating context for ambiguous queries; steers snippets without being searched directly |
-| `--exclude`             | string   | none                      | Hard-prune docs containing any comma-separated term in title/path/body                        |
-| `--tags-all`            | string   | none                      | Filter to docs with ALL tags (comma-separated)                                                |
-| `--tags-any`            | string   | none                      | Filter to docs with ANY tag (comma-separated)                                                 |
-| `--project-root`        | string[] | cwd                       | Trusted project root; repeatable, replaces default cwd/repository affinity                    |
-| `--no-project-affinity` | boolean  | false                     | Disable project-aware soft ranking; invalid with `--project-root`                             |
-| `--full`                | boolean  | false                     | Include full mirror content instead of snippet                                                |
-| `--line-numbers`        | boolean  | false                     | Include line numbers in output                                                                |
-| `--lang`                | string   | auto                      | Language filter/hint (BCP-47)                                                                 |
+| Option                  | Type     | Default                   | Description                                                                                                          |
+| ----------------------- | -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `--query-file`          | string   | none                      | Read the query from a file; `-` reads stdin so the query never appears on argv. Do not also pass a positional query. |
+| `-n`                    | integer  | 5 (20 for --json/--files) | Max results                                                                                                          |
+| `--min-score`           | number   | 0                         | Minimum score threshold                                                                                              |
+| `-c, --collection`      | string   | all                       | Filter to collection                                                                                                 |
+| `--since`               | string   | none                      | Modified-at lower bound (ISO date/time or relative token)                                                            |
+| `--until`               | string   | none                      | Modified-at upper bound (ISO date/time or relative token)                                                            |
+| `--category`            | string   | none                      | Filter to docs with matching category/content type (comma-separated)                                                 |
+| `--author`              | string   | none                      | Filter to docs where author contains value (case-insensitive)                                                        |
+| `--intent`              | string   | none                      | Disambiguating context for ambiguous queries; steers snippets without being searched directly                        |
+| `--exclude`             | string   | none                      | Hard-prune docs containing any comma-separated term in title/path/body                                               |
+| `--tags-all`            | string   | none                      | Filter to docs with ALL tags (comma-separated)                                                                       |
+| `--tags-any`            | string   | none                      | Filter to docs with ANY tag (comma-separated)                                                                        |
+| `--project-root`        | string[] | cwd                       | Trusted project root; repeatable, replaces default cwd/repository affinity                                           |
+| `--no-project-affinity` | boolean  | false                     | Disable project-aware soft ranking; invalid with `--project-root`                                                    |
+| `--full`                | boolean  | false                     | Include full mirror content instead of snippet                                                                       |
+| `--line-numbers`        | boolean  | false                     | Include line numbers in output                                                                                       |
+| `--lang`                | string   | auto                      | Language filter/hint (BCP-47)                                                                                        |
 
 **Scoring:**
 
@@ -1336,15 +1338,18 @@ Hybrid search combining BM25 and vector retrieval with optional expansion and re
 **Synopsis:**
 
 ```bash
-gno query <query> [-n <num>] [--min-score <num>] [-c <collection>] [--since <date>] [--until <date>] [--category <values>] [--author <text>] [--intent <text>] [--exclude <values>] [-C <num>] [--tags-all <tags>] [--tags-any <tags>] [--full] [--line-numbers] [--lang <bcp47>] [--no-expand] [--no-rerank] [--graph] [--no-graph] [--query-mode <mode:text>]... [--explain] [--json|--files|--csv|--md|--xml]
+gno query [query...] [--query-file <path>] [-n <num>] [--min-score <num>] [-c <collection>] [--since <date>] [--until <date>] [--category <values>] [--author <text>] [--intent <text>] [--exclude <values>] [-C <num>] [--tags-all <tags>] [--tags-any <tags>] [--full] [--line-numbers] [--lang <bcp47>] [--no-expand] [--no-rerank] [--graph] [--no-graph] [--query-mode <mode:text>]... [--explain] [--json|--files|--csv|--md|--xml]
 gno query diagnose <query> --target <doc> [-n <num>] [--min-score <num>] [-c <collection>] [--since <date>] [--until <date>] [--category <values>] [--author <text>] [--intent <text>] [--exclude <values>] [-C <num>] [--tags-all <tags>] [--tags-any <tags>] [--lang <bcp47>] [--no-expand] [--no-rerank] [--graph] [--no-graph] [--json]
 ```
 
+The positional query is optional when `--query-file` is set. Do not pass both. `--query-file` is invalid on `query diagnose`.
+
 **Options:** Same as `gno search`, plus:
 
 **Additional Options:**
 | Option | Type | Description |
 |--------|------|-------------|
+| `--query-file` | string | Same as `gno search`: read the query from a file (`-` is stdin). Invalid with a positional query and invalid on `query diagnose`. |
 | `--no-expand` | boolean | Disable query expansion |
 | `--no-rerank` | boolean | Disable cross-encoder reranking |
 | `--graph` | boolean | Explicitly enable the default bounded one-hop graph neighbor expansion |
@@ -1357,7 +1362,7 @@ gno query diagnose <query> --target <doc> [-n <num>] [--min-score <num>] [-c <co
 | `--target` | ref | Required for `query diagnose`; target document to diagnose |
 
 `query diagnose` accepts the same `--project-root` and
-`--no-project-affinity` controls as `query`.
+`--no-project-affinity` controls as `query`. It rejects `--query-file`.
 
 **Compatibility / Migration:**
 

package/src/cli/program.ts

@@ -46,6 +46,7 @@ import {
   parseOptionalFloat,
   parsePositiveInt,
 } from "./options";
+import { resolveCliQueryText } from "./query-text";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Global State (set by preAction hook)
@@ -625,8 +626,12 @@ function wireTraceCommands(program: Command): void {
 function wireSearchCommands(program: Command): void {
   // search - BM25 keyword search
   program
-    .command("search <query>")
+    .command("search [query]")
     .description("BM25 keyword search")
+    .option(
+      "--query-file <path>",
+      "read query from file; use - for stdin (keeps the query off argv)"
+    )
     .option("-n, --limit <num>", "max results")
     .option("--min-score <num>", "minimum score threshold")
     .option("-c, --collection <name>", "filter by collection")
@@ -662,95 +667,104 @@ function wireSearchCommands(program: Command): void {
     .option("--csv", "CSV output")
     .option("--xml", "XML output")
     .option("--files", "file paths only")
-    .action(async (queryText: string, cmdOpts: Record<string, unknown>) => {
-      const format = getFormat(cmdOpts);
-      assertFormatSupported(CMD.search, format);
-      const globals = getGlobals();
-
-      // Validate empty query
-      if (!queryText.trim()) {
-        throw new CliError("VALIDATION", "Query cannot be empty");
-      }
+    .action(
+      async (
+        queryText: string | undefined,
+        cmdOpts: Record<string, unknown>
+      ) => {
+        const format = getFormat(cmdOpts);
+        assertFormatSupported(CMD.search, format);
+        const globals = getGlobals();
+        queryText = await resolveCliQueryText(queryText, cmdOpts.queryFile);
 
-      // Validate minScore range
-      const minScore = parseOptionalFloat("min-score", cmdOpts.minScore);
-      if (minScore !== undefined && (minScore < 0 || minScore > 1)) {
-        throw new CliError("VALIDATION", "--min-score must be between 0 and 1");
-      }
+        // Validate empty query
+        if (!queryText.trim()) {
+          throw new CliError("VALIDATION", "Query cannot be empty");
+        }
 
-      // Parse and validate tag filters
-      let tagsAll: string[] | undefined;
-      let tagsAny: string[] | undefined;
-      try {
-        tagsAll = cmdOpts.tagsAll
-          ? parseAndValidateTagFilter(cmdOpts.tagsAll as string)
-          : undefined;
-        tagsAny = cmdOpts.tagsAny
-          ? parseAndValidateTagFilter(cmdOpts.tagsAny as string)
-          : undefined;
-      } catch (error) {
-        throw new CliError(
-          "VALIDATION",
-          error instanceof Error ? error.message : "Invalid tag filter"
-        );
-      }
+        // Validate minScore range
+        const minScore = parseOptionalFloat("min-score", cmdOpts.minScore);
+        if (minScore !== undefined && (minScore < 0 || minScore > 1)) {
+          throw new CliError(
+            "VALIDATION",
+            "--min-score must be between 0 and 1"
+          );
+        }
 
-      const limit = cmdOpts.limit
-        ? parsePositiveInt("limit", cmdOpts.limit)
-        : cmdOpts.verify
-          ? 5
-          : getDefaultLimit(format);
-      const categories = parseCsvValues(cmdOpts.category);
-      const exclude = parseCsvValues(cmdOpts.exclude);
-      const projectAffinity = parseCliProjectAffinityOptions(cmdOpts);
+        // Parse and validate tag filters
+        let tagsAll: string[] | undefined;
+        let tagsAny: string[] | undefined;
+        try {
+          tagsAll = cmdOpts.tagsAll
+            ? parseAndValidateTagFilter(cmdOpts.tagsAll as string)
+            : undefined;
+          tagsAny = cmdOpts.tagsAny
+            ? parseAndValidateTagFilter(cmdOpts.tagsAny as string)
+            : undefined;
+        } catch (error) {
+          throw new CliError(
+            "VALIDATION",
+            error instanceof Error ? error.message : "Invalid tag filter"
+          );
+        }
 
-      const { search, formatSearch } = await import("./commands/search");
-      const result = await search(queryText, {
-        configPath: globals.config,
-        indexName: globals.index,
-        limit,
-        minScore,
-        collection: cmdOpts.collection as string | undefined,
-        lang: cmdOpts.lang as string | undefined,
-        since: cmdOpts.since as string | undefined,
-        until: cmdOpts.until as string | undefined,
-        categories,
-        author: cmdOpts.author as string | undefined,
-        intent: cmdOpts.intent as string | undefined,
-        exclude,
-        tagsAll,
-        tagsAny,
-        ...projectAffinity,
-        full: Boolean(cmdOpts.full),
-        lineNumbers: Boolean(cmdOpts.lineNumbers),
-        json: format === "json",
-        md: format === "md",
-        csv: format === "csv",
-        xml: format === "xml",
-        files: format === "files",
-      });
+        const limit = cmdOpts.limit
+          ? parsePositiveInt("limit", cmdOpts.limit)
+          : cmdOpts.verify
+            ? 5
+            : getDefaultLimit(format);
+        const categories = parseCsvValues(cmdOpts.category);
+        const exclude = parseCsvValues(cmdOpts.exclude);
+        const projectAffinity = parseCliProjectAffinityOptions(cmdOpts);
+
+        const { search, formatSearch } = await import("./commands/search");
+        const result = await search(queryText, {
+          configPath: globals.config,
+          indexName: globals.index,
+          limit,
+          minScore,
+          collection: cmdOpts.collection as string | undefined,
+          lang: cmdOpts.lang as string | undefined,
+          since: cmdOpts.since as string | undefined,
+          until: cmdOpts.until as string | undefined,
+          categories,
+          author: cmdOpts.author as string | undefined,
+          intent: cmdOpts.intent as string | undefined,
+          exclude,
+          tagsAll,
+          tagsAny,
+          ...projectAffinity,
+          full: Boolean(cmdOpts.full),
+          lineNumbers: Boolean(cmdOpts.lineNumbers),
+          json: format === "json",
+          md: format === "md",
+          csv: format === "csv",
+          xml: format === "xml",
+          files: format === "files",
+        });
 
-      // Check success before printing - stdout is for successful outputs only
-      if (!result.success) {
-        // Map validation errors to exit code 1
-        throw new CliError(
-          result.isValidation ? "VALIDATION" : "RUNTIME",
-          result.error
-        );
+        // Check success before printing - stdout is for successful outputs only
+        if (!result.success) {
+          // Map validation errors to exit code 1
+          throw new CliError(
+            result.isValidation ? "VALIDATION" : "RUNTIME",
+            result.error
+          );
+        }
+        const output = formatSearch(result, {
+          json: format === "json",
+          md: format === "md",
+          csv: format === "csv",
+          xml: format === "xml",
+          files: format === "files",
+          full: Boolean(cmdOpts.full),
+          lineNumbers: Boolean(cmdOpts.lineNumbers),
+          terminalLinks: await resolveTerminalLinkPolicy(format),
+        });
+        await writeOutput(output, format);
+        writeRetrievalTraceReceipt(result.metadata);
       }
-      const output = formatSearch(result, {
-        json: format === "json",
-        md: format === "md",
-        csv: format === "csv",
-        xml: format === "xml",
-        files: format === "files",
-        full: Boolean(cmdOpts.full),
-        lineNumbers: Boolean(cmdOpts.lineNumbers),
-        terminalLinks: await resolveTerminalLinkPolicy(format),
-      });
-      await writeOutput(output, format);
-      writeRetrievalTraceReceipt(result.metadata);
-    });
+    );
 
   // vsearch - Vector similarity search
   program
@@ -876,8 +890,12 @@ function wireSearchCommands(program: Command): void {
 
   // query - Hybrid search with expansion and reranking
   program
-    .command("query <query...>")
+    .command("query [query...]")
     .description("Hybrid search with expansion and reranking")
+    .option(
+      "--query-file <path>",
+      "read query from file; use - for stdin (keeps the query off argv)"
+    )
     .option("-n, --limit <num>", "max results")
     .option("--min-score <num>", "minimum score threshold")
     .option("-c, --collection <name>", "filter by collection")
@@ -931,103 +949,158 @@ function wireSearchCommands(program: Command): void {
     .option("--csv", "CSV output")
     .option("--xml", "XML output")
     .option("--files", "file paths only")
-    .action(async (queryParts: string[], cmdOpts: Record<string, unknown>) => {
-      const format = getFormat(cmdOpts);
-      const isDiagnose =
-        queryParts[0] === "diagnose" && Boolean(cmdOpts.target);
-      assertFormatSupported(isDiagnose ? CMD.queryDiagnose : CMD.query, format);
-      const diagnoseFormat = format === "json" ? "json" : "terminal";
-      const globals = getGlobals();
-      let queryText = isDiagnose
-        ? queryParts.slice(1).join(" ")
-        : queryParts.join(" ");
+    .action(
+      async (
+        queryParts: string[] | undefined,
+        cmdOpts: Record<string, unknown>
+      ) => {
+        const parts = queryParts ?? [];
+        const format = getFormat(cmdOpts);
+        const isDiagnose = parts[0] === "diagnose" && Boolean(cmdOpts.target);
+        assertFormatSupported(
+          isDiagnose ? CMD.queryDiagnose : CMD.query,
+          format
+        );
+        const diagnoseFormat = format === "json" ? "json" : "terminal";
+        const globals = getGlobals();
+        if (isDiagnose && cmdOpts.queryFile) {
+          throw new CliError(
+            "VALIDATION",
+            "query diagnose does not accept --query-file"
+          );
+        }
+        let queryText = isDiagnose
+          ? parts.slice(1).join(" ")
+          : await resolveCliQueryText(parts.join(" "), cmdOpts.queryFile);
 
-      // Validate empty query
-      if (!queryText.trim()) {
-        throw new CliError("VALIDATION", "Query cannot be empty");
-      }
+        // Validate empty query
+        if (!queryText.trim()) {
+          throw new CliError("VALIDATION", "Query cannot be empty");
+        }
 
-      // Validate minScore range
-      const minScore = parseOptionalFloat("min-score", cmdOpts.minScore);
-      if (minScore !== undefined && (minScore < 0 || minScore > 1)) {
-        throw new CliError("VALIDATION", "--min-score must be between 0 and 1");
-      }
+        // Validate minScore range
+        const minScore = parseOptionalFloat("min-score", cmdOpts.minScore);
+        if (minScore !== undefined && (minScore < 0 || minScore > 1)) {
+          throw new CliError(
+            "VALIDATION",
+            "--min-score must be between 0 and 1"
+          );
+        }
 
-      // Parse optional structured query modes
-      let queryModes: import("../pipeline/types").QueryModeInput[] | undefined;
-      if (Array.isArray(cmdOpts.queryMode) && cmdOpts.queryMode.length > 0) {
-        const { parseQueryModeSpecs } = await import("../pipeline/query-modes");
-        const parsed = parseQueryModeSpecs(cmdOpts.queryMode as string[]);
-        if (!parsed.ok) {
-          throw new CliError("VALIDATION", parsed.error.message);
+        // Parse optional structured query modes
+        let queryModes:
+          | import("../pipeline/types").QueryModeInput[]
+          | undefined;
+        if (Array.isArray(cmdOpts.queryMode) && cmdOpts.queryMode.length > 0) {
+          const { parseQueryModeSpecs } =
+            await import("../pipeline/query-modes");
+          const parsed = parseQueryModeSpecs(cmdOpts.queryMode as string[]);
+          if (!parsed.ok) {
+            throw new CliError("VALIDATION", parsed.error.message);
+          }
+          queryModes = parsed.value;
         }
-        queryModes = parsed.value;
-      }
 
-      const { normalizeStructuredQueryInput } =
-        await import("../core/structured-query");
-      const normalizedInput = normalizeStructuredQueryInput(
-        queryText,
-        queryModes ?? []
-      );
-      if (!normalizedInput.ok) {
-        throw new CliError("VALIDATION", normalizedInput.error.message);
-      }
-      queryText = normalizedInput.value.query;
-      queryModes =
-        normalizedInput.value.queryModes.length > 0
-          ? normalizedInput.value.queryModes
-          : undefined;
+        const { normalizeStructuredQueryInput } =
+          await import("../core/structured-query");
+        const normalizedInput = normalizeStructuredQueryInput(
+          queryText,
+          queryModes ?? []
+        );
+        if (!normalizedInput.ok) {
+          throw new CliError("VALIDATION", normalizedInput.error.message);
+        }
+        queryText = normalizedInput.value.query;
+        queryModes =
+          normalizedInput.value.queryModes.length > 0
+            ? normalizedInput.value.queryModes
+            : undefined;
 
-      // Parse and validate tag filters
-      let tagsAll: string[] | undefined;
-      let tagsAny: string[] | undefined;
-      try {
-        tagsAll = cmdOpts.tagsAll
-          ? parseAndValidateTagFilter(cmdOpts.tagsAll as string)
-          : undefined;
-        tagsAny = cmdOpts.tagsAny
-          ? parseAndValidateTagFilter(cmdOpts.tagsAny as string)
+        // Parse and validate tag filters
+        let tagsAll: string[] | undefined;
+        let tagsAny: string[] | undefined;
+        try {
+          tagsAll = cmdOpts.tagsAll
+            ? parseAndValidateTagFilter(cmdOpts.tagsAll as string)
+            : undefined;
+          tagsAny = cmdOpts.tagsAny
+            ? parseAndValidateTagFilter(cmdOpts.tagsAny as string)
+            : undefined;
+        } catch (error) {
+          throw new CliError(
+            "VALIDATION",
+            error instanceof Error ? error.message : "Invalid tag filter"
+          );
+        }
+
+        const limit = cmdOpts.limit
+          ? parsePositiveInt("limit", cmdOpts.limit)
+          : getDefaultLimit(format);
+        const { loadConfig } = await import("../config");
+        const { getActivePreset } = await import("../llm/registry");
+        const configResult = await loadConfig(globals.config);
+        const activePresetId = configResult.ok
+          ? getActivePreset(configResult.value).id
+          : "slim-tuned";
+        const candidateLimit = cmdOpts.candidateLimit
+          ? parsePositiveInt("candidate-limit", cmdOpts.candidateLimit)
           : undefined;
-      } catch (error) {
-        throw new CliError(
-          "VALIDATION",
-          error instanceof Error ? error.message : "Invalid tag filter"
-        );
-      }
+        const categories = parseCsvValues(cmdOpts.category);
+        const exclude = parseCsvValues(cmdOpts.exclude);
+        const projectAffinity = parseCliProjectAffinityOptions(cmdOpts);
+
+        const depthPolicy = resolveDepthPolicy({
+          presetId: activePresetId,
+          fast: Boolean(cmdOpts.fast),
+          thorough: Boolean(cmdOpts.thorough),
+          expand: cmdOpts.expand === false ? false : undefined,
+          rerank: cmdOpts.rerank === false ? false : undefined,
+          candidateLimit,
+        });
 
-      const limit = cmdOpts.limit
-        ? parsePositiveInt("limit", cmdOpts.limit)
-        : getDefaultLimit(format);
-      const { loadConfig } = await import("../config");
-      const { getActivePreset } = await import("../llm/registry");
-      const configResult = await loadConfig(globals.config);
-      const activePresetId = configResult.ok
-        ? getActivePreset(configResult.value).id
-        : "slim-tuned";
-      const candidateLimit = cmdOpts.candidateLimit
-        ? parsePositiveInt("candidate-limit", cmdOpts.candidateLimit)
-        : undefined;
-      const categories = parseCsvValues(cmdOpts.category);
-      const exclude = parseCsvValues(cmdOpts.exclude);
-      const projectAffinity = parseCliProjectAffinityOptions(cmdOpts);
+        if (isDiagnose) {
+          const { queryDiagnose, formatQueryDiagnose } =
+            await import("./commands/query");
+          const result = await queryDiagnose(queryText, {
+            configPath: globals.config,
+            indexName: globals.index,
+            target: cmdOpts.target as string,
+            limit,
+            minScore,
+            collection: cmdOpts.collection as string | undefined,
+            lang: cmdOpts.lang as string | undefined,
+            since: cmdOpts.since as string | undefined,
+            until: cmdOpts.until as string | undefined,
+            categories,
+            author: cmdOpts.author as string | undefined,
+            intent: cmdOpts.intent as string | undefined,
+            exclude,
+            tagsAll,
+            tagsAny,
+            ...projectAffinity,
+            noExpand: depthPolicy.noExpand,
+            noRerank: depthPolicy.noRerank,
+            graph: cmdOpts.graph !== false,
+            noGraph: Boolean(cmdOpts.fast) || cmdOpts.graph === false,
+            candidateLimit: depthPolicy.candidateLimit,
+            queryModes,
+            json: diagnoseFormat === "json",
+          });
 
-      const depthPolicy = resolveDepthPolicy({
-        presetId: activePresetId,
-        fast: Boolean(cmdOpts.fast),
-        thorough: Boolean(cmdOpts.thorough),
-        expand: cmdOpts.expand === false ? false : undefined,
-        rerank: cmdOpts.rerank === false ? false : undefined,
-        candidateLimit,
-      });
+          if (!result.success) {
+            throw new CliError("RUNTIME", result.error);
+          }
+          await writeOutput(
+            formatQueryDiagnose(result, { format: diagnoseFormat }),
+            diagnoseFormat
+          );
+          return;
+        }
 
-      if (isDiagnose) {
-        const { queryDiagnose, formatQueryDiagnose } =
-          await import("./commands/query");
-        const result = await queryDiagnose(queryText, {
+        const { query, formatQuery } = await import("./commands/query");
+        const result = await query(queryText, {
           configPath: globals.config,
           indexName: globals.index,
-          target: cmdOpts.target as string,
           limit,
           minScore,
           collection: cmdOpts.collection as string | undefined,
@@ -1041,70 +1114,35 @@ function wireSearchCommands(program: Command): void {
           tagsAll,
           tagsAny,
           ...projectAffinity,
+          full: Boolean(cmdOpts.full),
+          lineNumbers: Boolean(cmdOpts.lineNumbers),
           noExpand: depthPolicy.noExpand,
           noRerank: depthPolicy.noRerank,
           graph: cmdOpts.graph !== false,
           noGraph: Boolean(cmdOpts.fast) || cmdOpts.graph === false,
           candidateLimit: depthPolicy.candidateLimit,
           queryModes,
-          json: diagnoseFormat === "json",
+          explain: Boolean(cmdOpts.explain),
+          json: format === "json",
+          md: format === "md",
+          csv: format === "csv",
+          xml: format === "xml",
+          files: format === "files",
         });
 
         if (!result.success) {
           throw new CliError("RUNTIME", result.error);
         }
-        await writeOutput(
-          formatQueryDiagnose(result, { format: diagnoseFormat }),
-          diagnoseFormat
-        );
-        return;
-      }
-
-      const { query, formatQuery } = await import("./commands/query");
-      const result = await query(queryText, {
-        configPath: globals.config,
-        indexName: globals.index,
-        limit,
-        minScore,
-        collection: cmdOpts.collection as string | undefined,
-        lang: cmdOpts.lang as string | undefined,
-        since: cmdOpts.since as string | undefined,
-        until: cmdOpts.until as string | undefined,
-        categories,
-        author: cmdOpts.author as string | undefined,
-        intent: cmdOpts.intent as string | undefined,
-        exclude,
-        tagsAll,
-        tagsAny,
-        ...projectAffinity,
-        full: Boolean(cmdOpts.full),
-        lineNumbers: Boolean(cmdOpts.lineNumbers),
-        noExpand: depthPolicy.noExpand,
-        noRerank: depthPolicy.noRerank,
-        graph: cmdOpts.graph !== false,
-        noGraph: Boolean(cmdOpts.fast) || cmdOpts.graph === false,
-        candidateLimit: depthPolicy.candidateLimit,
-        queryModes,
-        explain: Boolean(cmdOpts.explain),
-        json: format === "json",
-        md: format === "md",
-        csv: format === "csv",
-        xml: format === "xml",
-        files: format === "files",
-      });
-
-      if (!result.success) {
-        throw new CliError("RUNTIME", result.error);
+        const output = formatQuery(result, {
+          format,
+          full: Boolean(cmdOpts.full),
+          lineNumbers: Boolean(cmdOpts.lineNumbers),
+          terminalLinks: await resolveTerminalLinkPolicy(format),
+        });
+        await writeOutput(output, format);
+        writeRetrievalTraceReceipt(result.metadata);
       }
-      const output = formatQuery(result, {
-        format,
-        full: Boolean(cmdOpts.full),
-        lineNumbers: Boolean(cmdOpts.lineNumbers),
-        terminalLinks: await resolveTerminalLinkPolicy(format),
-      });
-      await writeOutput(output, format);
-      writeRetrievalTraceReceipt(result.metadata);
-    });
+    );
 
   // bench - Retrieval benchmark fixture runner
   program
@@ -3201,7 +3239,9 @@ function wireSkillCommands(program: Command): void {
           | "hermes"
           | "all",
         force: Boolean(cmdOpts.force),
-        json: Boolean(cmdOpts.json),
+        // The root program also defines a global --json and may consume the
+        // flag; leave undefined here so the runner falls back to globals.
+        json: cmdOpts.json === true ? true : undefined,
       });
     });
 
@@ -3252,7 +3292,7 @@ function wireSkillCommands(program: Command): void {
           | "openclaw"
           | "hermes"
           | "all",
-        json: Boolean(cmdOpts.json),
+        json: cmdOpts.json === true ? true : undefined,
       });
     });
 
@@ -3316,7 +3356,7 @@ function wireSkillCommands(program: Command): void {
           | "openclaw"
           | "hermes"
           | "all",
-        json: Boolean(cmdOpts.json),
+        json: cmdOpts.json === true ? true : undefined,
       });
     });
 }

package/src/cli/query-text.ts

@@ -0,0 +1,41 @@
+/**
+ * Resolve a search/query string from a positional argument or --query-file.
+ * `--query-file -` reads stdin so callers can keep the query off argv.
+ *
+ * @module src/cli/query-text
+ */
+
+import { CliError } from "./errors";
+
+const readQueryFile = async (path: string): Promise<string> => {
+  if (path.includes("\0")) {
+    throw new CliError("VALIDATION", "--query-file path is invalid");
+  }
+  try {
+    const raw =
+      path === "-" ? await Bun.stdin.text() : await Bun.file(path).text();
+    return raw.replace(/\s+$/u, "");
+  } catch (error) {
+    throw new CliError(
+      "VALIDATION",
+      error instanceof Error
+        ? `Failed to read --query-file: ${error.message}`
+        : "Failed to read --query-file"
+    );
+  }
+};
+
+export const resolveCliQueryText = async (
+  positional: string | undefined,
+  queryFile: unknown
+): Promise<string> => {
+  const file = typeof queryFile === "string" ? queryFile : "";
+  const pos = positional ?? "";
+  if (file !== "" && pos.trim() !== "") {
+    throw new CliError("VALIDATION", "Pass a query or --query-file, not both");
+  }
+  if (file !== "") {
+    return await readQueryFile(file);
+  }
+  return pos;
+};

package/browser-extension/artifacts/gno-browser-clipper-v1.39.0.zip.sha256

@@ -1 +0,0 @@
-b3b2f2609cfe5c821eb9d22d76832b6ad329afa7496c0792e0dd4f5bd0f74fbc  gno-browser-clipper-v1.39.0.zip