@gmickel/gno 1.7.0 → 1.7.1

package/assets/skill/SKILL.md

@@ -136,7 +136,7 @@ gno search "error handling" --json | jq -r '.results[].uri' | xargs gno multi-ge
 When using GNO through MCP, prefer this retrieval order:
 
 1. Check `gno_status` first when freshness, missing vectors, or stale results are plausible.
-2. Use `gno_query` first for normal content questions. It returns snippets plus `uri`, `docid`, and often `line`; it also adds bounded one-hop graph neighbors from top seeds when graph data exists.
+2. Use `gno_query` first for normal content questions. It returns snippets plus `uri`, `docid`, and often `line`; pass `graph: true` only when linked context is worth the extra latency.
 3. Use graph/link expansion for relationship context: `gno_graph_neighbors` for nearby documents, `gno_graph_path` for "how are X and Y connected?", `gno_links`/`gno_backlinks` for one-document link expansion, and `gno_similar` for semantic neighbors. Prefer `explicit` graph edges over `inferred`, `ambiguous`, or `similarity` edges when confidence matters.
 4. Use `gno_get` with `fromLine`/`lineCount` for targeted reads, or `gno_multi_get` to batch top refs.
 

package/assets/skill/cli-reference.md

@@ -154,7 +154,7 @@ gno query <query> [options]
 
 | Flag         | Time  | Description                    |
 | ------------ | ----- | ------------------------------ |
-| `--fast`     | ~0.7s | Skip expansion, graph, rerank  |
+| `--fast`     | ~0.7s | Skip expansion and rerank      |
 | (default)    | ~2-3s | Skip expansion, with reranking |
 | `--thorough` | ~5-8s | Full pipeline with expansion   |
 
@@ -164,7 +164,8 @@ Additional options:
 | ------------- | --------------------------------- |
 | `--no-expand` | Disable query expansion           |
 | `--no-rerank` | Disable reranking                 |
-| `--no-graph`  | Disable graph-neighbor candidates |
+| `--graph`     | Enable graph-neighbor candidates  |
+| `--no-graph`  | Compatibility no-op by default    |
 | `--explain`   | Print retrieval details to stderr |
 
 ### gno ask

package/assets/skill/mcp-reference.md

@@ -56,9 +56,8 @@ gno mcp status
 ## Retrieval Order
 
 For normal questions, start with `gno_query`, then read targeted snippets with
-`gno_get` or batch refs with `gno_multi_get`. `gno_query` already does bounded
-one-hop graph expansion from top seeds; pass `noGraph: true` only when comparing
-pure BM25/vector retrieval. Check `gno_status` first when freshness or
+`gno_get` or batch refs with `gno_multi_get`. Pass `graph: true` only when
+linked context is worth the extra latency. Check `gno_status` first when freshness or
 embeddings may be stale.
 
 Use graph tools for relationship context: `gno_graph` for corpus report/stats,

package/package.json

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

package/src/cli/program.ts

@@ -539,7 +539,8 @@ function wireSearchCommands(program: Command): void {
     )
     .option("--no-expand", "disable query expansion")
     .option("--no-rerank", "disable reranking")
-    .option("--no-graph", "disable graph neighbor expansion")
+    .option("--graph", "enable graph neighbor expansion")
+    .option("--no-graph", "compatibility no-op; graph is off by default")
     .option(
       "--query-mode <mode:text>",
       "structured mode entry (repeatable): term:<text>, intent:<text>, or hyde:<text>",
@@ -656,6 +657,7 @@ function wireSearchCommands(program: Command): void {
         lineNumbers: Boolean(cmdOpts.lineNumbers),
         noExpand: depthPolicy.noExpand,
         noRerank: depthPolicy.noRerank,
+        graph: Boolean(cmdOpts.graph),
         noGraph: Boolean(cmdOpts.fast) || cmdOpts.graph === false,
         candidateLimit: depthPolicy.candidateLimit,
         queryModes,

package/src/mcp/tools/index.ts

@@ -456,7 +456,11 @@ export const queryInputSchema = z.object({
   noGraph: z
     .boolean()
     .optional()
-    .describe("Disable bounded one-hop graph neighbor expansion"),
+    .describe("Compatibility no-op unless graph is also true"),
+  graph: z
+    .boolean()
+    .optional()
+    .describe("Enable bounded one-hop graph neighbor expansion"),
   tagsAll: z.array(z.string()).optional().describe("Require ALL of these tags"),
   tagsAny: z.array(z.string()).optional().describe("Require ANY of these tags"),
 });

package/src/mcp/tools/query.ts

@@ -51,6 +51,7 @@ interface QueryInput {
   expand?: boolean;
   rerank?: boolean;
   noGraph?: boolean;
+  graph?: boolean;
   tagsAll?: string[];
   tagsAny?: string[];
 }
@@ -272,6 +273,7 @@ export function handleQuery(
           author: args.author,
           noExpand,
           noRerank,
+          graph: args.graph === true,
           noGraph: args.noGraph || args.fast,
           queryModes,
           tagsAll: normalizeTagFilters(args.tagsAll),

package/src/pipeline/hybrid.ts

@@ -554,7 +554,7 @@ export async function searchHybrid(
     includeSimilar: vectorAvailable,
     limit,
     candidateLimit,
-    disabled: options.noGraph,
+    disabled: !options.graph || options.noGraph,
     lang: options.lang,
     tagsAll: options.tagsAll,
     tagsAny: options.tagsAny,

package/src/pipeline/types.ts

@@ -174,7 +174,9 @@ export type HybridSearchOptions = SearchOptions & {
   candidateLimit?: number;
   /** Enable explain output */
   explain?: boolean;
-  /** Disable bounded one-hop graph candidate expansion */
+  /** Enable bounded one-hop graph candidate expansion */
+  graph?: boolean;
+  /** Compatibility no-op unless graph is also true */
   noGraph?: boolean;
   /** Language hint for prompt selection (does NOT filter retrieval, only affects expansion prompts) */
   queryLanguageHint?: string;

package/src/serve/routes/api.ts

@@ -173,6 +173,7 @@ export interface QueryRequestBody {
   noExpand?: boolean;
   noRerank?: boolean;
   noGraph?: boolean;
+  graph?: boolean;
   /** Comma-separated tags - filter to docs having ALL (AND) */
   tagsAll?: string;
   /** Comma-separated tags - filter to docs having ANY (OR) */
@@ -3311,6 +3312,7 @@ export async function handleQuery(
       queryModes: normalizedQueryModes,
       noExpand: body.noExpand,
       noRerank: body.noRerank,
+      graph: body.graph === true,
       noGraph: body.noGraph,
       tagsAll,
       tagsAny,