loopctl-mcp-server 2.104.1 → 2.104.2

package/README.md

@@ -334,7 +334,7 @@ exhausting a paginated walk is not the same as the row being absent.
 |---|---|
 | `knowledge_index` | Browse/paginate the knowledge wiki catalog grouped by category. **Agent callers see only articles they own or marked `shared`.** Honors `category`, `tags`, `offset`, `limit` with deterministic ordering over the filtered set (`meta.categories` reports per-category totals within visibility). Use `fields` (default `id,title,category`; request `tags`/`status`/`updated_at`/`suppressed_at`/`suppressed_by`/`suppression_reason` explicitly; `id` and `category` are always included) to keep the payload small. Pair `suppressed: "only"` with `fields: suppressed_by,suppression_reason` to see who suppressed what and why without a read per row. Optional: `project_id`, `story_id`, `category`, `tags`, `offset`, `limit`, `fields`, `suppressed`. |
 | `embedding_status` | This tenant's embedding-dimension state: active dimension, whether semantic recall is available (and the exact reason when it is not), the instance's supported dimension set, whether the shared system-scoped corpus has been materialized for this tenant, and per-dimension row counts. Call it when semantic search under-returns or reports `fallback_reason: semantic_recall_unavailable`. |
-| `embedding_materialize_system_corpus` | Embed the shared SYSTEM-scoped corpus for THIS tenant at its active dimension with this tenant's own credential (system articles are keyword-only until then). Idempotent, batched. |
+| `embedding_materialize_system_corpus` | Embed the shared SYSTEM-scoped corpus for THIS tenant at its active dimension with this tenant's own credential (system articles are keyword-only until then), and re-embed articles whose text changed since. `already_materialized` when nothing is missing or changed; `in_flight` when a run is already queued, executing or backing off (one run at a time; an orchestrator-or-higher key re-schedules a run backing off after an error to now, and a run left executing by a crashed node holds until Oban's Lifeline rescues it). 409 `materialization_terminal` when the latest run was discarded or cancelled and the key is agent-role; an orchestrator-or-higher key forces a new run. |
 | `embedding_reembed` | Move the tenant's whole corpus (articles, per-tenant system-article materializations and agent memories) onto `target_dimension`. Recall keeps serving at the current dimension throughout; the pin flips and stale rows drop only when everything is present at the target. One-time and cost-bearing; requires `LOOPCTL_ORCH_KEY`. |
 | `knowledge_stats` | Aggregate article counts (`total`, `by_category`, `by_status`) via cheap `COUNT(*) GROUP BY` within agent's visible set — no article metadata loaded. Agent callers see only their own and `shared` articles. Counts span all statuses. Optional: `project_id`. |
 | `knowledge_count` | Count articles matching filters **without returning rows** within agent's visible set. Agent callers see only their own and `shared` articles. Same filters as `knowledge_list` (`category`, `status`, `tags`, `match`, `source_type`, `source_id`, `idempotency_key`, `project_id`). With `tags`+`match: all` (+`status`) → "how many published articles tagged both X and Y (that I can see)". Returns `{ count }`. |

package/index.js

@@ -5104,7 +5104,15 @@ const TOOLS = [
       "Materialize the shared SYSTEM-scoped article corpus for THIS tenant at its active " +
       "embedding dimension, using this tenant's own embedding credential. System articles " +
       "cannot be embedded once for everyone (embeddings are BYO), so until this runs they are " +
-      "matched by keyword only for you. Idempotent and batched; safe to call repeatedly.",
+      "matched by keyword only for you. It embeds the system articles you have not embedded " +
+      "and re-embeds ones whose text changed since; on the side-table read path your searches " +
+      "trigger the same thing, so this is for doing it now. Answers already_materialized when " +
+      "nothing is missing or changed, and in_flight when a run is already queued, executing " +
+      "or backing off (one run at a time; an orchestrator-or-higher key re-schedules a run " +
+      "backing off after an error to now, and a run left executing by a crashed node holds " +
+      "until Oban's Lifeline rescues it). Refused 409 materialization_terminal when your latest run " +
+      "was discarded or cancelled (e.g. no embedding key) and the key is agent-role; an " +
+      "orchestrator-or-higher key forces a new run.",
     inputSchema: { type: "object", properties: {}, required: [] },
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopctl-mcp-server",
-  "version": "2.104.1",
+  "version": "2.104.2",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",