@gmickel/gno 2.12.2 → 2.13.0

package/README.md

@@ -139,7 +139,7 @@ See the [guide](docs/COMPILED-CONTEXT.md).
 
 <!-- public-truth:current-version -->
 
-> Current source version: **v2.12.2**. See [CHANGELOG.md](./CHANGELOG.md).
+> Current source version: **v2.13.0**. See [CHANGELOG.md](./CHANGELOG.md).
 
 <!-- /public-truth -->
 

package/assets/skill/SKILL.md

@@ -160,7 +160,7 @@ missing: `gno query diagnose` before falling back to grep.
 
 ```
 -n <num>              Max results (default: 5)
--c, --collection      Filter to collection
+-c, --collection      Filter to collection (repeat for several; search/vsearch/query)
 --tags-any <t1,t2>    Has ANY of these tags
 --tags-all <t1,t2>    Has ALL of these tags
 --since <date>        Modified after date (ISO: 2026-03-01)

package/assets/skill/cli-reference.md

@@ -151,6 +151,19 @@ gno index [options]
 | `--models-pull`       | Download models if missing |
 | `--git-pull`          | Git pull before indexing   |
 
+### gno convert
+
+Print the Markdown GNO would index for one file. Needs no config or index and
+writes nothing.
+
+```bash
+gno convert <file> [--json]
+```
+
+`--json` adds `title`, `converter`, `mirrorHash` and `warnings`. Mail archives,
+calendars and other multi-record formats are refused (`MULTI_DOCUMENT`); index
+them in a collection instead.
+
 ### gno embed
 
 Generate embeddings only.
@@ -393,16 +406,16 @@ BM25 keyword search.
 gno search <query> [options]
 ```
 
-| Option             | Default | Description                      |
-| ------------------ | ------- | -------------------------------- |
-| `-n`               | 5       | Max results                      |
-| `--min-score`      | 0       | Minimum score (0-1)              |
-| `-c, --collection` | all     | Filter to collection             |
-| `--tags-any`       | -       | Filter: has ANY tag (comma-sep)  |
-| `--tags-all`       | -       | Filter: has ALL tags (comma-sep) |
-| `--full`           | false   | Full content (not snippets)      |
-| `--line-numbers`   | false   | Include line numbers             |
-| `--lang`           | auto    | Language filter                  |
+| Option             | Default | Description                                            |
+| ------------------ | ------- | ------------------------------------------------------ |
+| `-n`               | 5       | Max results                                            |
+| `--min-score`      | 0       | Minimum score (0-1)                                    |
+| `-c, --collection` | all     | Filter to collection; repeat (`-c a -c b`) for several |
+| `--tags-any`       | -       | Filter: has ANY tag (comma-sep)                        |
+| `--tags-all`       | -       | Filter: has ALL tags (comma-sep)                       |
+| `--full`           | false   | Full content (not snippets)                            |
+| `--line-numbers`   | false   | Include line numbers                                   |
+| `--lang`           | auto    | Language filter                                        |
 
 Output formats: `--json`, `--files`, `--csv`, `--md`, `--xml`
 

package/assets/skill/mcp-reference.md

@@ -114,6 +114,8 @@ abstains unless every substantive claim is supported. This is a support
 classification against the retained Capsule, not a guarantee that the corpus
 is complete or its sources are true. Bounded graph expansion is on by default;
 set `graph: false` or `noGraph: true` only for an explicit BM25/vector-only path.
+To search several collections, pass `collections: ["a", "b"]` to `gno_query`,
+`gno_search` or `gno_vsearch` instead of `collection` (not both).
 Check `gno_peek` first for counts, backlog, serve liveness, or recent files.
 Use `gno_status` for activation, onboarding, or heavy health (missing vectors,
 stale embeddings). Use `gno_query_diagnose` when a known target document

package/browser-extension/artifacts/gno-browser-clipper-v2.13.0.zip.sha256

@@ -0,0 +1 @@
+477bb4440a241369687ec7c27d3720e4ce46b8f7139dfec842c5eee10d09e0ea  gno-browser-clipper-v2.13.0.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": "2.12.2"
+  "version": "2.13.0"
 }

package/package.json

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

package/spec/cli.md

@@ -91,6 +91,7 @@ equivalent files fail closed as ambiguous.
 | sessions           | yes    | no      | no    | no   | no    | terminal |
 | get                | yes    | no      | no    | yes  | no    | terminal |
 | multi-get          | yes    | yes     | no    | yes  | no    | terminal |
+| convert            | yes    | no      | no    | no   | no    | Markdown |
 | ls                 | yes    | yes     | no    | yes  | no    | terminal |
 | daemon             | yes¹   | no      | no    | no   | no    | terminal |
 | context add        | no     | no      | no    | no   | no    | terminal |
@@ -1245,13 +1246,14 @@ Build or update the index end-to-end (update + embed).
 **Synopsis:**
 
 ```bash
-gno index [collection] [--no-embed] [--models-pull] [--git-pull] [--json] [--yes] [--lock-wait <duration>] [--no-wait]
+gno index [collection] [--path <path...>] [--no-embed] [--models-pull] [--git-pull] [--json] [--yes] [--lock-wait <duration>] [--no-wait]
 ```
 
 **Options:**
 | Option | Type | Description |
 |--------|------|-------------|
 | `--collection` | string | Scope to single collection |
+| `--path <path...>` | string[] | Reindex only these files of the collection (relative to its root, or absolute inside it); at most 256, not directories; requires a collection, not combinable with `--git-pull` |
 | `--no-embed` | boolean | Run ingestion only, skip embedding |
 | `--models-pull` | boolean | Download models if missing (prompts unless `--yes`) |
 | `--git-pull` | boolean | Run `git pull` in git repositories |
@@ -1264,6 +1266,7 @@ gno index [collection] [--no-embed] [--models-pull] [--git-pull] [--json] [--yes
 
 - Runs two separable stages: `lexical` (`update`) then `embed`
 - With `--no-embed`, runs the `lexical` stage only (embed stage `skipped`)
+- With `--path`, the `lexical` stage re-reads only the listed files and marks a listed file that no longer exists inactive; the collection's update command does not run. A path outside the collection root (including through a symlink), `--path` without a collection, or `--path` with `--git-pull` exits 1 (`VALIDATION`) before anything is written
 - Waits by default for the shared write lease; `--no-wait` fails immediately with exit 4
 
 **Staged, resumable contract:** each stage persists its own progress inside
@@ -1472,7 +1475,7 @@ BM25 keyword search over indexed documents.
 **Synopsis:**
 
 ```bash
-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]
+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:**
@@ -1488,7 +1491,7 @@ gno search [query] [--query-file <path>] [-n <num>] [--min-score <num>] [-c <col
 | `--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                                                                                                 |
+| `-c, --collection`      | string[] | all                       | Filter to collection; repeat to search several collections (at most 256)                                             |
 | `--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)                                                 |
@@ -1621,6 +1624,19 @@ gno search "deploy staging" -n 10 --collection work
 gno search "contract" --json | jq '.[] | .uri'
 ```
 
+**Collection scope (`search`, `vsearch`, `query`):** one `-c` filters to that
+collection. Repeating `-c` (`-c work -c notes`) searches only those
+collections; the filter applies before every candidate limit, so other
+collections never take result slots, graph neighbours or rerank budget. Names
+are trimmed, lowercased, de-duplicated and sorted, and `--json` echoes them as
+`meta.collections` (`meta.collection` stays the single-collection field). More
+than 256 names after normalization exits 1 (`VALIDATION`); names that are not
+configured exit 2 with `Collection not found: <name>` or
+`Collections not found: <a>, <b>`, the same as a single unknown `-c`. When the
+listed collections resolve different embed, expand or rerank models, that role
+uses the unscoped default; when they agree, their shared model is used.
+`gno query diagnose` accepts one `-c` and exits 1 when given several.
+
 ---
 
 Keyword retrieval applies collection/path scope, caller allowlists, tags, modified-date bounds, category and author filters, managed-memory visibility, and whole-document exclusions before its ranked candidate limit. Higher-ranked ineligible documents cannot consume that window; fewer eligible matches still produce a short result. Existing BM25 weights, query syntax, recency/project-affinity reranking and minimum-score behavior are unchanged.
@@ -1632,7 +1648,7 @@ Vector semantic search over indexed documents.
 **Synopsis:**
 
 ```bash
-gno vsearch <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 vsearch <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]
 ```
 
 **Options:** Same as `gno search` (including temporal/category/author, tag, and
@@ -1677,7 +1693,7 @@ Hybrid search combining BM25 and vector retrieval with optional expansion and re
 **Synopsis:**
 
 ```bash
-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 [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]
 ```
 
@@ -2496,6 +2512,51 @@ See [Output Schemas](./output-schemas/multi-get.schema.json)
 
 ---
 
+### gno convert
+
+Print the Markdown GNO would index for one file. The file goes through the
+same conversion path as indexing (MIME detection, converter, canonical
+Markdown, mirror hash) with the default indexing limits, so the output equals
+the mirror `gno update` stores for the same bytes. No config, index, store or
+cache is read or written, and the command works with no GNO config present.
+
+**Synopsis:**
+
+```bash
+gno convert <file> [--json]
+```
+
+**Arguments:**
+| Arg | Type | Description |
+|-----|------|-------------|
+| `<file>` | path | One regular file (a symlink to a regular file is followed) |
+
+**Output:**
+
+- Terminal: exactly the Markdown on stdout; conversion warnings go to stderr.
+- `--json`: [convert@1.0](./output-schemas/convert.schema.json) with `source`
+  (`path`, `mime`, `ext`, `sizeBytes`), `converter` (`id`, `version`),
+  `title`, `languageHint`, `markdown`, `mirrorHash` (SHA-256 hex, as stored by
+  indexing) and `warnings`.
+
+Single-document formats are supported. Formats whose adapters split one file
+into several records (mail archives, calendars and the other record adapters)
+are refused, because their record identity comes from the collection and path.
+
+**Errors:** the standard error envelope, with `details.reason`:
+
+| Case                                                         | `details.reason`                                               | Exit |
+| ------------------------------------------------------------ | -------------------------------------------------------------- | ---- |
+| Path missing, a directory or another non-regular file        | `NOT_FOUND`                                                    | 1    |
+| Larger than the indexing size limit (checked before reading) | `TOO_LARGE`                                                    | 1    |
+| No converter for the type                                    | `UNSUPPORTED`                                                  | 1    |
+| Multi-record format (`details.format` names it)              | `MULTI_DOCUMENT`                                               | 1    |
+| Converter failure, timeout, memory limit or corrupt input    | the converter's code (`CORRUPT`, `PERMISSION`, `TIMEOUT`, ...) | 2    |
+
+The SDK exposes the same operation as `convertFile(path)`.
+
+---
+
 ### gno ls
 
 List documents in a collection or prefix.

package/spec/mcp.md

@@ -230,6 +230,50 @@ All write tools acquire an OS-backed advisory lock at `.mcp-write.lock` under th
 If another process holds the lock, tools return `LOCKED`.
 For async jobs, the lock is held for the full job duration.
 
+### Reindex Queue
+
+`gno_sync` and `gno_index` (and REST `POST /api/sync`) never reject a request
+because another job in the same server is running:
+
+- With no job running or waiting, the request starts at once (`status:
+"started"`), taking the write lock as above; another process holding it
+  returns `LOCKED`.
+- Otherwise it is queued (`status: "queued"`) and starts when the jobs ahead
+  of it finish, taking the write lock then. A queued job that cannot get the
+  lock fails with `LOCKED` in its job status.
+- A request joins a waiting job of the same tool and collection and returns
+  its `jobId`, so any number of requests cause at most one more pass:
+  - a request with `paths` joins any such job (its files are added to the
+    pass, or covered by a whole-collection pass);
+  - a whole-collection request joins a job that only has path requests
+    (widening it and setting its options) or a whole-collection job with the
+    same `gitPull` / `runUpdateCmd`. Whole-collection requests with different
+    options stay separate passes, and a path-only pass never runs `gitPull`
+    or an update command.
+  - a path-only job whose merged files pass 256 becomes a whole-collection
+    pass with no `gitPull` or update command.
+- A queued pass uses the configuration of the latest request that joined it;
+  `gno_index` resolves its embedding model when the pass starts, so a model
+  or preset change while it waits is picked up.
+- At most 64 distinct scopes wait at once; a new scope beyond that returns
+  `QUEUE_FULL`. Retry after the running job finishes.
+- The queue lives in the server process. Jobs still waiting when it stops are
+  failed at shutdown and unknown after a restart (`NOT_FOUND` from
+  `gno_job_status`); the index stays consistent.
+
+### Path-Level Reindex
+
+`paths` on `gno_sync` / `gno_index` reindexes only the listed files of one
+collection: each path is relative to the collection root or absolute inside
+it, and only those files are re-read. A listed file that no longer exists is
+marked inactive. `paths` requires `collection` and cannot be combined with
+`gitPull` or `runUpdateCmd`; an empty list, more than 256 paths, a
+directory, a path outside the root (including through a symlink) or a
+non-string entry is rejected before anything is queued (`INVALID_INPUT` /
+`INVALID_PATH`), and so is a path the collection's own `pattern`, `include`
+or `exclude` rules leave out. To reindex a directory or more than 256 files,
+reindex the whole collection.
+
 `gno_remember` is the one write tool whose adapter takes no lock of its own:
 the core memory service acquires the same `.mcp-write.lock` lease for every
 memory write, so an MCP remember and a CLI writer serialise on one lease. A
@@ -603,6 +647,19 @@ opaque remote hints. The server never stats, realpaths, discovers repositories,
 or infers its cwd from them; remote hints produce redacted zero-affinity
 metadata and no ranking change.
 
+`gno_search`, `gno_vsearch` and `gno_query` also accept an optional
+`collections` allowlist. The filter applies before every candidate limit (BM25,
+vector, fusion, graph expansion, hydration and rerank), so unlisted collections
+never take result slots. Names are trimmed, lowercased, de-duplicated and
+sorted; responses echo them as `meta.collections`, and `meta.collection` keeps
+its single-collection meaning. Passing both `collection` and `collections`, an
+empty list, a non-string member, or more than 256 names after normalization is
+a `VALIDATION` error; unconfigured names give `Collection not found: <name>` /
+`Collections not found: <a>, <b>`. Over HTTP the egress check covers exactly
+the listed collections, so the most restrictive listed collection decides.
+When the listed collections resolve different models for a role, that role uses
+the unscoped default. `gno_query_diagnose` does not accept `collections`.
+
 **Input Schema:**
 
 ```json
@@ -617,6 +674,11 @@ metadata and no ranking change.
       "type": "string",
       "description": "Optional collection name to filter results"
     },
+    "collections": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional allowlist: filter to any of these collection names (1-256); use instead of collection"
+    },
     "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-100)",
@@ -738,6 +800,11 @@ Vector semantic search over indexed documents.
       "type": "string",
       "description": "Optional collection name to filter results"
     },
+    "collections": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional allowlist: filter to any of these collection names (1-256); use instead of collection"
+    },
     "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-100)",
@@ -822,6 +889,11 @@ Hybrid search combining BM25 and vector retrieval with optional expansion and re
       "type": "string",
       "description": "Optional collection name to filter results"
     },
+    "collections": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional allowlist: filter to any of these collection names (1-256); use instead of collection"
+    },
     "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-100)",
@@ -2719,6 +2791,12 @@ Reindex one or all collections (write-enabled).
       "type": "boolean",
       "description": "Run updateCmd before indexing (default: false for MCP)",
       "default": false
+    },
+    "paths": {
+      "type": "array",
+      "items": { "type": "string" },
+      "maxItems": 256,
+      "description": "Reindex only these files of the collection (see Path-Level Reindex); requires collection"
     }
   }
 }
@@ -2726,6 +2804,9 @@ Reindex one or all collections (write-enabled).
 
 **Output Schema:** `gno://schemas/mcp-sync-result@1.0`
 
+`status` is `started` or `queued` (see [Reindex Queue](#reindex-queue));
+`paths` echoes the resolved collection-relative paths of a path-level sync.
+
 ---
 
 ### gno_embed
@@ -2818,6 +2899,12 @@ Full index: sync files + generate embeddings (write-enabled). Runs as background
       "type": "boolean",
       "description": "Run git pull before sync",
       "default": false
+    },
+    "paths": {
+      "type": "array",
+      "items": { "type": "string" },
+      "maxItems": 256,
+      "description": "Reindex only these files of the collection (see Path-Level Reindex); requires collection"
     }
   }
 }
@@ -2852,6 +2939,7 @@ Full index: sync files + generate embeddings (write-enabled). Runs as background
 
 - Requires `--enable-write` flag
 - Runs sync phase first, then embed phase
+- `status` is `started` or `queued` (see [Reindex Queue](#reindex-queue)); a path-level index adds `paths`
 - `runUpdateCmd` is always false for MCP (security)
 - Fails fast if embedding model not cached
 - Poll job status with `gno_job_status`
@@ -2902,6 +2990,11 @@ Get status of a background job.
 
 **Output Schema:** `gno://schemas/mcp-job-status@1.0`
 
+`status` is `queued` while a reindex job waits behind another job, then
+`running`, `completed` or `failed`. Reindex jobs also report `scope`: the
+collection (`null` for all) and the merged `paths` (`null` for the whole
+collection).
+
 ---
 
 ### gno_list_jobs
@@ -3062,8 +3155,9 @@ Resource errors use standard MCP error responses.
 - `HAS_REFERENCES` — Collection referenced by contexts
 - `INVALID_PATH` — Path violates safety rules
 - `PATH_NOT_FOUND` — Path does not exist
-- `JOB_CONFLICT` — Another job is already running
+- `JOB_CONFLICT` — Another job is already running (not returned by `gno_sync` / `gno_index`, which queue instead)
 - `LOCKED` — Another MCP process holds the write lock
+- `QUEUE_FULL` — Too many reindex scopes are already waiting; retry later
 - `CAPTURE_SYNC_FAILED` — `gno_capture` wrote the file but lexical sync failed
 - `WRITE_DISABLED` — Write tool dispatched while writes are disabled
 - `MEMORY_*` — Memory contract errors from `gno_recall` / `gno_remember`;
@@ -3106,6 +3200,7 @@ Clients should check schema version for compatibility.
 - No persistent state between tool calls
 - Each tool call is independent
 - Server handles concurrent tool calls sequentially; an accepted background job (`gno_sync`, `gno_embed`, `gno_index`) waits for the call in progress, then runs without holding that queue, so reads are not blocked while it runs
+- The retrieval tools (`gno_search`, `gno_vsearch`, `gno_query`, `gno_get`, `gno_multi_get`, `gno_status`, `gno_list_tags`, `gno_links`, `gno_backlinks`, `gno_similar`) read on a second connection, so they see only committed index data, never a sync batch still being written
 
 ---
 

package/spec/output-schemas/convert.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/convert@1.0",
+  "title": "GNO Convert Result",
+  "description": "Output of gno convert --json and SDK convertFile: the Markdown GNO would index for one file",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "source",
+    "converter",
+    "title",
+    "languageHint",
+    "markdown",
+    "mirrorHash",
+    "warnings"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "const": "convert@1.0"
+    },
+    "source": {
+      "type": "object",
+      "required": ["path", "mime", "ext", "sizeBytes"],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Absolute path of the converted file"
+        },
+        "mime": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Detected MIME type"
+        },
+        "ext": {
+          "type": "string",
+          "description": "File extension, including the dot"
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "converter": {
+      "type": "object",
+      "required": ["id", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "title": {
+      "type": ["string", "null"],
+      "description": "Title from conversion, or null"
+    },
+    "languageHint": {
+      "type": ["string", "null"],
+      "description": "BCP-47 language hint from conversion, or null"
+    },
+    "markdown": {
+      "type": "string",
+      "description": "Canonical Markdown, identical to the mirror indexing stores"
+    },
+    "mirrorHash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$",
+      "description": "SHA-256 hex of the canonical Markdown, as stored by indexing"
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "message"],
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string",
+            "minLength": 1
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/mcp-job-status.schema.json

@@ -223,7 +223,7 @@
     "status": {
       "type": "string",
       "description": "Job status",
-      "enum": ["running", "completed", "failed"]
+      "enum": ["queued", "running", "completed", "failed"]
     },
     "startedAt": {
       "type": "string",
@@ -247,6 +247,22 @@
       "type": "string",
       "description": "Error message if failed"
     },
+    "scope": {
+      "type": "object",
+      "description": "Reindex jobs: what the job covers after merging requests",
+      "required": ["collection", "paths"],
+      "properties": {
+        "collection": {
+          "type": ["string", "null"],
+          "description": "Collection name, or null for all collections"
+        },
+        "paths": {
+          "type": ["array", "null"],
+          "description": "Collection-relative files, or null for the whole collection",
+          "items": { "type": "string" }
+        }
+      }
+    },
     "serverInstanceId": {
       "type": "string",
       "description": "Server instance UUID",

package/spec/output-schemas/mcp-sync-result.schema.json

@@ -19,8 +19,15 @@
     },
     "status": {
       "type": "string",
-      "description": "Job status",
-      "enum": ["started"]
+      "description": "started: the job is running; queued: it waits behind another write job (requests for the same scope share one queued job)",
+      "enum": ["started", "queued"]
+    },
+    "paths": {
+      "type": "array",
+      "description": "Collection-relative files this sync reindexes; absent for a whole-collection sync",
+      "items": {
+        "type": "string"
+      }
     },
     "options": {
       "type": "object",

package/spec/output-schemas/search-results.schema.json

@@ -454,6 +454,13 @@
           "type": "string",
           "description": "Collection filter if applied"
         },
+        "collections": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1,
+          "maxItems": 256,
+          "description": "Normalized collection allowlist if applied (sorted, lowercase)"
+        },
         "intent": {
           "type": "string",
           "description": "Disambiguating context used to steer retrieval without being searched directly"