@adhd/backlog 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,3 +1,51 @@
+## 1.0.1 (2026-09-26)
+
+### 🚀 Features
+
+- **backlog:** skill §9 — hard rule to file a feature request when the tool is friction ([cf42c407](https://github.com/PseudoSky/adhd/commit/cf42c407))
+- **backlog:** live embedding config + embedding-status verb ([#23](https://github.com/PseudoSky/adhd/pull/23))
+- **backlog:** mount the three stats/rollup reads as apigen ops ([1859a5ae](https://github.com/PseudoSky/adhd/commit/1859a5ae))
+- **backlog:** deliver the embedding funnel on the successor line ([b985215a](https://github.com/PseudoSky/adhd/commit/b985215a))
+- **vite-plugins:** absorb perf/test-resolve-fix — test-time @adhd/\* source resolution ([3e344506](https://github.com/PseudoSky/adhd/commit/3e344506))
+
+### 🩹 Fixes
+
+- ⚠️ **apigen:** regenerate the ADR-0004 golden snapshot, add the MAJOR release note, clear the format gate ([1fea3c2f](https://github.com/PseudoSky/adhd/commit/1fea3c2f))
+- **backlog:** mirror the optional store's additive probe type locally, decoupling the build from a lagging install ([c15c4cdf](https://github.com/PseudoSky/adhd/commit/c15c4cdf))
+- **apigen:** ADR-0004 — MCP tool output is the flat content payload ([7896594d](https://github.com/PseudoSky/adhd/commit/7896594d))
+- **backlog:** directory citation is E_VALIDATION, not a retryable E_IO; log raw E_IO cause (56a2133e) ([f538387c](https://github.com/PseudoSky/adhd/commit/f538387c))
+- **backlog:** close the baked-IR freshness gate's transitive-import hole ([182ae496](https://github.com/PseudoSky/adhd/commit/182ae496))
+- **backlog:** exclude the backlog store from the citation default root ([715f3f97](https://github.com/PseudoSky/adhd/commit/715f3f97))
+- **backlog:** narrow citation default external root + single-source missing-path taxonomy ([b86e98d5](https://github.com/PseudoSky/adhd/commit/b86e98d5))
+- **backlog:** allow citations under configured external roots (c6d35272) ([69e475ae](https://github.com/PseudoSky/adhd/commit/69e475ae))
+- **nx:** reconcile main's e2e lane with the flat ESLint config + fix missing-deps ([cf72a2ab](https://github.com/PseudoSky/adhd/commit/cf72a2ab))
+- **backlog:** format PR #23 files; ignore pnpm-lock.yaml in prettier ([#24](https://github.com/PseudoSky/adhd/pull/24), [#23](https://github.com/PseudoSky/adhd/issues/23))
+- **nx-build:** run-scoped release manifest token + apigen-cli readiness flake + codegen test output ([#15](https://github.com/PseudoSky/adhd/pull/15))
+- **backlog:** self-watchdog + detached group reap so a killed test can't strand funnel consumers ([f3755c3d](https://github.com/PseudoSky/adhd/commit/f3755c3d))
+- **backlog:** drop the forbidden 'store-engine' term from the CPU-THRASH-SKIP comment ([4dae6ee2](https://github.com/PseudoSky/adhd/commit/4dae6ee2))
+- **vite:** restore import.meta.url in CJS output under vite 8 ([7916e639](https://github.com/PseudoSky/adhd/commit/7916e639))
+- **nx:** finish the ESLint v9 flat-config upgrade and unblock the gate ([53f4ff3e](https://github.com/PseudoSky/adhd/commit/53f4ff3e))
+
+### 🔥 Performance
+
+- **backlog:** bake the IR artifact at build; startup never loads ts-morph ([da81f673](https://github.com/PseudoSky/adhd/commit/da81f673))
+
+### ⚠️ Breaking Changes
+
+- **apigen:** regenerate the ADR-0004 golden snapshot, add the MAJOR release note, clear the format gate ([1fea3c2f](https://github.com/PseudoSky/adhd/commit/1fea3c2f))
+  McpOutputAdapter.wrapped (exported from
+  @adhd/apigen-engine-runtime and @adhd/apigen-plugin-mcp) kept its name but
+  inverted its meaning (true now means "the return is already a top-level object,
+  emit the value as flat structuredContent", not "wrapped under result"), and an
+  MCP tool return that is not a top-level object no longer emits an outputSchema
+  or structuredContent. This is semver-MAJOR for those two packages; republish
+  them first per ADR-0004 D6.
+
+### ❤️ Thank You
+
+- pseudosky
+- Sky
+
 ## 1.0.0 (Unreleased)
 
 The first stable release. `@adhd/backlog` is a self-contained backlog system: one store, mounted live to a CLI, an MCP server, and an HTTP surface with zero duplicated logic across hosts. Every operation returns an outcome envelope — `{ok:true, data}` or `{ok:false, error:{code,message,details}}` — so a caller never has to guess whether a call succeeded from a thrown exception.

package/README.md

@@ -43,7 +43,7 @@ adhd-backlog upsert-project --input '{
 ```
 
 ```json
-{"ok":true,"data":{"uid":"49ec673b-…","created":true,"project":{"uid":"49ec673b-…","name":"demo-project","path":"/tmp/demo"}}}
+{ "ok": true, "data": { "uid": "49ec673b-…", "created": true, "project": { "uid": "49ec673b-…", "name": "demo-project", "path": "/tmp/demo" } } }
 ```
 
 File an issue against it:
@@ -60,7 +60,7 @@ adhd-backlog create --input '{
 ```
 
 ```json
-{"ok":true,"data":{"created":true,"uid":"b3b2da0e-…","item":{"uid":"b3b2da0e-…","title":"Query pagination drops the last page under offset paging","kind":"issue","status":"open","priority":"HIGH","project":"49ec673b-…","component":"65c4e373-…","createdAt":"2026-09-24T00:14:38.802Z","author":"agent:worker-1","gitContext":"feat/backlog-hard-replacement @ 4bf902fc"}}}
+{ "ok": true, "data": { "created": true, "uid": "b3b2da0e-…", "item": { "uid": "b3b2da0e-…", "title": "Query pagination drops the last page under offset paging", "kind": "issue", "status": "open", "priority": "HIGH", "project": "49ec673b-…", "component": "65c4e373-…", "createdAt": "2026-09-24T00:14:38.802Z", "author": "agent:worker-1", "gitContext": "feat/backlog-hard-replacement @ 4bf902fc" } } }
 ```
 
 > `project` and `component` in the result are `uid`s, not names. `gitContext`
@@ -73,7 +73,7 @@ adhd-backlog query --input '{"filter":{"project":"demo-project","status":"open"}
 ```
 
 ```json
-{"ok":true,"data":{"view":"list","items":[{"uid":"b3b2da0e-…","title":"Query pagination drops the last page under offset paging","kind":"issue","status":"open","priority":"HIGH"}],"hasMore":false},"meta":{"total":1,"returned":1,"limit":50}}
+{ "ok": true, "data": { "view": "list", "items": [{ "uid": "b3b2da0e-…", "title": "Query pagination drops the last page under offset paging", "kind": "issue", "status": "open", "priority": "HIGH" }], "hasMore": false }, "meta": { "total": 1, "returned": 1, "limit": 50 } }
 ```
 
 Move it forward — a `transition` records the status change in the issue's audit
@@ -92,13 +92,13 @@ adhd-backlog transition --input '{
 ```
 
 ```json
-{"ok":true,"data":{"uid":"b3b2da0e-…","fromStatus":"open","toStatus":"in-progress","transitionUid":"9bcb9844-…"}}
+{ "ok": true, "data": { "uid": "b3b2da0e-…", "fromStatus": "open", "toStatus": "in-progress", "transitionUid": "9bcb9844-…" } }
 ```
 
 A failed call returns the same envelope with `ok:false` instead of throwing:
 
 ```json
-{"ok":false,"error":{"code":"item_not_found","message":"No live issue found for uid \"does-not-exist\"","details":{"retryable":false}}}
+{ "ok": false, "error": { "code": "item_not_found", "message": "No live issue found for uid \"does-not-exist\"", "details": { "retryable": false } } }
 ```
 
 Every output above was captured from the built binary
@@ -126,7 +126,7 @@ adhd-backlog claim --input '{"uid":"b3b2da0e-…","by":"agent:worker-1","action"
 ```
 
 ```json
-{"ok":true,"data":{"uid":"b3b2da0e-…","status":"claimed","claimedBy":"agent:worker-1","claimedAt":"2026-09-24T00:14:39.978Z"}}
+{ "ok": true, "data": { "uid": "b3b2da0e-…", "status": "claimed", "claimedBy": "agent:worker-1", "claimedAt": "2026-09-24T00:14:39.978Z" } }
 ```
 
 ### 3. Structured, verifiable citations
@@ -149,7 +149,7 @@ adhd-backlog get --input '{"registry":"project","name":"demo-project"}'
 ```
 
 ```json
-{"ok":true,"data":{"uid":"49ec673b-…","name":"demo-project","path":"/tmp/demo","components":[{"name":"(root)"}],"locations":[]}}
+{ "ok": true, "data": { "uid": "49ec673b-…", "name": "demo-project", "path": "/tmp/demo", "components": [{ "name": "(root)" }], "locations": [] } }
 ```
 
 ### 5. Optional semantic search, optional Markdown rendering
@@ -184,13 +184,14 @@ forward to it. The old `uid` remains queryable history: addressing it returns
 resolve to the wrong record.
 
 ```json
-{"ok":false,"error":{"code":"conflict","message":"Issue \"63c2f57e-…\" was superseded by a body edit and is no longer the live issue; it now lives under \"e3b32183-…\"","details":{"retryable":false}}}
+{ "ok": false, "error": { "code": "conflict", "message": "Issue \"63c2f57e-…\" was superseded by a body edit and is no longer the live issue; it now lives under \"e3b32183-…\"", "details": { "retryable": false } } }
 ```
 
 ## Command surface
 
-Every verb takes a single `--input` flag carrying one JSON object; there are no
-per-field flags. Eighteen operations (the 17 verbs plus `batch`):
+Every verb but `embedding-status` takes a single `--input` flag carrying one JSON
+object; there are no per-field flags. Nineteen operations (the 18 verbs plus
+`batch`):
 
 | Verb              | CLI                             | MCP tool                   |
 | ----------------- | ------------------------------- | -------------------------- |
@@ -199,6 +200,7 @@ per-field flags. Eighteen operations (the 17 verbs plus `batch`):
 | `priorityMatrix`  | `adhd-backlog priority-matrix`  | `backlog_priority_matrix`  |
 | `partOfRollup`    | `adhd-backlog part-of-rollup`   | `backlog_part_of_rollup`   |
 | `openCurve`       | `adhd-backlog open-curve`       | `backlog_open_curve`       |
+| `embeddingStatus` | `adhd-backlog embedding-status` | `backlog_embedding_status` |
 | `lookup`          | `adhd-backlog lookup`           | `backlog_lookup`           |
 | `create`          | `adhd-backlog create`           | `backlog_create`           |
 | `update`          | `adhd-backlog update`           | `backlog_update`           |
@@ -215,7 +217,7 @@ per-field flags. Eighteen operations (the 17 verbs plus `batch`):
 
 `--help` prints these as `backlog <verb>`; the CLI also accepts the bare
 `adhd-backlog <verb>` form shown above, and accepts the explicit namespace
-prefix at any position. `get`/`query`/`lookup` are reads.
+prefix at any position. `get`/`query`/`lookup`/`embedding-status` are reads.
 `create`/`update`/`transition`/`claim`/`relate`/`move`/`delete` mutate one
 issue. The four `upsert*`/`rmLocation` verbs manage the **registry** —
 projects, components, and locations. `batch action` fans any one of them out
@@ -248,17 +250,17 @@ looks complete.
 
 ### Error codes
 
-| Code                  | Meaning                                                                                                                         | CLI exit code |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| `not_found`           | A referenced catalog entry (project/component/kind/status/priority) doesn't exist                                               | 4             |
-| `item_not_found`      | The addressed issue doesn't exist                                                                                               | 1             |
-| `invalid_argument`    | Malformed flag or parameter shape                                                                                               | 2             |
-| `validation`          | Schema rejection — unknown filter key, unknown projection field, over-limit                                                     | 2             |
-| `store_busy`          | Store contention (a lease or a write conflict); `details.retryable` and `details.retryAfterMs` indicate whether/how to retry    | 1             |
-| `rag_not_configured`  | A semantic/similarity read was requested but no embedding backend is configured, or the vector space is empty                   | 1             |
-| `conflict`            | Someone else holds the claim, a single-valued relation is already taken, or a supersede raced                                   | 1             |
+| Code                  | Meaning                                                                                                                                                   | CLI exit code |
+| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
+| `not_found`           | A referenced catalog entry (project/component/kind/status/priority) doesn't exist                                                                         | 4             |
+| `item_not_found`      | The addressed issue doesn't exist                                                                                                                         | 1             |
+| `invalid_argument`    | Malformed flag or parameter shape                                                                                                                         | 2             |
+| `validation`          | Schema rejection — unknown filter key, unknown projection field, over-limit                                                                               | 2             |
+| `store_busy`          | Store contention (a lease or a write conflict); `details.retryable` and `details.retryAfterMs` indicate whether/how to retry                              | 1             |
+| `rag_not_configured`  | A semantic/similarity read was requested but no embedding backend is configured, or the vector space is empty                                             | 1             |
+| `conflict`            | Someone else holds the claim, a single-valued relation is already taken, or a supersede raced                                                             | 1             |
 | `precondition_failed` | A gate refused the write — a terminal transition missing its required citation/note, or a citation that couldn't be verified against a known project path | 1             |
-| `internal`            | Unclassified server-side failure                                                                                                | 1             |
+| `internal`            | Unclassified server-side failure                                                                                                                          | 1             |
 
 Success always exits 0. `item_not_found` and `internal` are deliberately
 distinct codes even though they share exit code 1 — a caller distinguishes
@@ -269,7 +271,9 @@ code alone.
 
 A citation is `{ file, lines?, context?, symbol? }`. Pass `citations` on
 `create`, or on the `transition` that moves an issue into a terminal status
-when the project's policy requires it.
+when the project's policy requires it. `file` must name a file, not a
+directory: a directory target is rejected as a non-retryable `validation`
+error.
 
 The item-level **`gitContext`** is separate from a citation's own `context`:
 it records the repo disclosure contract's `<active git context>` — the first
@@ -290,6 +294,39 @@ and is rejected with `invalid_argument`, and the stats/rollup ops
 priority-matrix` lines against this page if a documented field or verb is
 refused.
 
+## Build & startup
+
+`nx build backlog` emits TWO things into `dist/`: the compiled
+`index.js` + `api.d.ts`, and `api.ir.json` — the extracted operation
+descriptors for `api.d.ts`, produced by the build's own hidden `ir-artifact`
+subcommand:
+
+```bash
+node dist/index.js ir-artifact --out dist/api.ir.json
+```
+
+Startup (the CLI, an MCP `initialize`, `--help`) reads `api.ir.json` and
+derives the mounted surface from it **without loading the type extractor**, so
+a cold start is fast without any warm cache — the fix for a startup path that
+previously paid a multi-second synchronous extraction on every invocation.
+
+`api.ir.json` is trusted only while it still matches the built declarations
+beside it: the artifact records content hashes of the WHOLE `dist/**.d.ts`
+surface it was extracted from (not just `api.d.ts` — extraction resolves types
+through `api.d.ts`'s sibling imports), and startup re-hashes that surface
+before using it. A missing, corrupt, or stale artifact (any `.d.ts` changed
+since the bake) is refused, and startup falls back to a live extraction through
+the extract-stage IR cache, which persists the result for the next run.
+
+`ir-artifact` is a build step, not a user command — it is absent from `--help`
+and store-free (it never opens the graph store and never writes under
+`~/.adhd`).
+
+| Setting          | Env var                    | Default                              | Notes                                                                                                                                    |
+| ---------------- | -------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| IR cache enabled | `APIGEN_IR_CACHE_ENABLED`  | `1`                                  | Governs ONLY the **runtime fallback** cache. It does **not** bypass the baked `api.ir.json` artifact — that artifact is the startup path, not a cache |
+| IR cache file    | `APIGEN_IR_CACHE_FILE`     | a machine-global path under `~/.adhd` | Where a fallback extraction's result is cached                                                                                            |
+
 ## Library API
 
 Beyond the CLI/MCP/HTTP surface, the package exports its query layer
@@ -318,16 +355,16 @@ spanning every project on the machine, not one per repository — so an agent
 working across repos sees the same graph everywhere unless it explicitly opts
 into a narrower scope.
 
-| Setting            | Env var                                               | Default                    | Notes                                                        |
-| ------------------ | ----------------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
-| Database path      | `ADHD_BACKLOG_DATABASE_PATH`                          | resolved under the scope root | Where the graph store's data file lives                   |
-| Write busy timeout | `ADHD_BACKLOG_DATABASE_BUSY_TIMEOUT_MS`               | `5000`                     | How long a write waits on a contended lock before giving up  |
-| Log level          | `ADHD_BACKLOG_LOG_LEVEL`                              | `info`                     | `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal`\|`silent` |
-| Scope              | `ADHD_BACKLOG_SCOPE` (falls back to `ADHD_ENV_SCOPE`) | `global`                   | Which store root to resolve against                          |
-| Namespace          | `--namespace <value>` CLI flag (no env var)           | `production`               | Which path segment under the scope root to resolve against (`<root>/backlog/<namespace>/…`) — one of `production`\|`test`\|`sandbox`. `--namespace sandbox` ALSO mints a fresh throwaway root and writes a real `config.yaml` there with `embedding.enabled: false`, so a sandboxed invocation is isolated along two independent axes plus a deliberate config, never an accident of an empty directory |
-| Semantic search    | `ADHD_BACKLOG_EMBEDDING_ENABLED`                      | `false`                    | See below                                                    |
-| Embedding provider | `ADHD_BACKLOG_EMBEDDING_PROVIDER`                     | `fastembed`                | Only consulted when embedding is enabled                     |
-| Embedding model    | `ADHD_BACKLOG_EMBEDDING_MODEL`                        | `bge-base-en-v1.5` (768-dim) | Only consulted when embedding is enabled                   |
+| Setting            | Env var                                               | Default                       | Notes                                                                                                                                                                                                                                                                                                                                                                                                   |
+| ------------------ | ----------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Database path      | `ADHD_BACKLOG_DATABASE_PATH`                          | resolved under the scope root | Where the graph store's data file lives                                                                                                                                                                                                                                                                                                                                                                 |
+| Write busy timeout | `ADHD_BACKLOG_DATABASE_BUSY_TIMEOUT_MS`               | `5000`                        | How long a write waits on a contended lock before giving up                                                                                                                                                                                                                                                                                                                                             |
+| Log level          | `ADHD_BACKLOG_LOG_LEVEL`                              | `info`                        | `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal`\|`silent`                                                                                                                                                                                                                                                                                                                                            |
+| Scope              | `ADHD_BACKLOG_SCOPE` (falls back to `ADHD_ENV_SCOPE`) | `global`                      | Which store root to resolve against                                                                                                                                                                                                                                                                                                                                                                     |
+| Namespace          | `--namespace <value>` CLI flag (no env var)           | `production`                  | Which path segment under the scope root to resolve against (`<root>/backlog/<namespace>/…`) — one of `production`\|`test`\|`sandbox`. `--namespace sandbox` ALSO mints a fresh throwaway root and writes a real `config.yaml` there with `embedding.enabled: false`, so a sandboxed invocation is isolated along two independent axes plus a deliberate config, never an accident of an empty directory |
+| Semantic search    | `ADHD_BACKLOG_EMBEDDING_ENABLED`                      | `false`                       | See below                                                                                                                                                                                                                                                                                                                                                                                               |
+| Embedding provider | `ADHD_BACKLOG_EMBEDDING_PROVIDER`                     | `fastembed`                   | Only consulted when embedding is enabled                                                                                                                                                                                                                                                                                                                                                                |
+| Embedding model    | `ADHD_BACKLOG_EMBEDDING_MODEL`                        | `bge-base-en-v1.5` (768-dim)  | Only consulted when embedding is enabled                                                                                                                                                                                                                                                                                                                                                                |
 
 **Embedding (semantic search) is entirely optional.** With it left at its
 default (`false`), `@adhd/backlog` works fully — every verb, keyword filtering

package/api.d.ts

@@ -8,6 +8,7 @@ import { IUpdateIssueInput, IUpdateIssueOutcome } from './write/update.js';
 import { ICreateIssueInput, ICreateIssueResult } from './write/create-issue.js';
 import { IIssueGetInput, IIssueGetResult, IIssueQueryInput, IIssueQueryResult, ILookupResult } from './query/types.js';
 import { IPriorityMatrixInput, IPriorityMatrixResult, IPartOfRollupInput, IPartOfRollupResult, IOpenCurveInput, IOpenCurveResult } from './query/views/stats.js';
+import { EmbeddingLiveConfig } from './write/embedding-config.js';
 import { IOutcomeEnvelope } from './envelope.js';
 import { GraphBacklogStore } from './store/graph-backlog-store.js';
 import { BacklogConfig } from './env.js';
@@ -17,6 +18,18 @@ import { Environment } from '@adhd/environment';
 export interface BacklogCtx {
     store: GraphBacklogStore;
     env: Environment<BacklogConfig>;
+    /**
+     * Per-process liveness holder for the `embedding.*` config family
+     * (`write/embedding-config.ts`). Optional and additive: every existing
+     * caller/test that builds a ctx by hand keeps the pre-existing resolve-once
+     * behaviour exactly (`ctx.env.config.embedding` is the effective value).
+     *
+     * `startBacklogServer` attaches one; `ensureSemanticReady` refreshes it
+     * before each semantic verb so an on-disk `config.yaml` edit is adopted
+     * without a restart. `db.*`/`logging.level` are deliberately NOT covered —
+     * they stay restart-required (see the holder's own doc comment).
+     */
+    embeddingConfig?: EmbeddingLiveConfig;
     /**
      * Test-isolation escape hatch ONLY — mirrors `BuildBacklogEnvOptions.adhdRoot`
      * (the same value passed to `buildBacklogEnv({ adhdRoot })` when constructing
@@ -80,6 +93,43 @@ export declare function partOfRollup(ctx: BacklogCtx, input: IPartOfRollupInput)
  * `queryHandle` gates.
  */
 export declare function openCurve(ctx: BacklogCtx, input: IOpenCurveInput): Promise<IOutcomeEnvelope<IOpenCurveResult>>;
+/** The `embedding_status` read op's payload (see {@link embeddingStatus}). */
+export interface IEmbeddingStatusResult {
+    /** The on-disk `embedding.enabled` (observed from the config layers). */
+    readonly configuredEnabled: boolean;
+    /** The value the running process is actually using right now. */
+    readonly effectiveEnabled: boolean;
+    readonly provider: string;
+    readonly model: string;
+    /** Whether the resolved semantic members are currently retained for the store. */
+    readonly membersPresent: {
+        readonly embedding: boolean;
+        readonly search: boolean;
+    };
+    /** `configuredEnabled !== effectiveEnabled` — on-disk enabled, process not (yet) adopted. */
+    readonly divergent: boolean;
+    /** Config hash the process started with (`ctx.env.version.configHash`). */
+    readonly startupHash: string;
+    /** Config hash currently observed on disk. */
+    readonly currentHash: string;
+}
+/**
+ * Health/observability read for the semantic layer: EFFECTIVE vs CONFIGURED
+ * `embedding.*`, member presence, and both config hashes.
+ *
+ * A READ op — it never opens the cold semantic backend (`queryHandle` is not
+ * touched), so a caller can ask "is RAG on, and is on-disk ahead of me?"
+ * cheaply. `provider`/`model` are the effective values; `divergent` is the
+ * one non-obvious bit — on-disk says enabled while the process is still
+ * effectively disabled, which normally resolves on the next semantic verb
+ * (see {@link ensureSemanticReady}).
+ *
+ * A first-class read op (rather than a `query` view) because it is a property
+ * of the PROCESS and its config, not of the issue graph — and because the
+ * write path's own loudness net (`write/bootstrap.ts`) reports the same
+ * divergence, so operators can confirm it out-of-band.
+ */
+export declare function embeddingStatus(ctx: BacklogCtx): Promise<IOutcomeEnvelope<IEmbeddingStatusResult>>;
 /**
  * Resolve a free-text reference to a project, component or location in the
  * registry.