instar 1.3.706 → 1.3.707

package/dist/core/componentCategories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentCategories.d.ts","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAEjE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAEtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAkE1E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAIrF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}
+{"version":3,"file":"componentCategories.d.ts","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAEjE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAEtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAyF1E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAIrF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/core/componentCategories.js

@@ -91,6 +91,28 @@ export const COMPONENT_CATEGORY = {
     // enrichment then never spends Anthropic quota. Only used by the dark
     // llmEnrichment path; the shipped deterministic auditor makes no LLM calls.
     StandardsCoverageEnrichment: 'job',
+    // ── Previously-uncategorized LLM callsites (LLM Routing Registry audit,
+    //    2026-07-01). Each calls an intelligence provider's .evaluate() but was
+    //    absent from this map AND passes no explicit attribution.category, so it
+    //    resolved to 'other' → the agent default framework (Claude) — silently
+    //    spending Anthropic quota instead of routing off-Claude like its peers.
+    //    Categorized by function (sentinel = background judgment call, gate =
+    //    pre-action allow/deny, reflector = extraction/summarization/analysis).
+    //    The drift-guard test (componentCategories-evaluate-coverage.test.ts)
+    //    keeps this map exhaustive over .evaluate() callsites going forward. ──
+    InputClassifier: 'sentinel', // input auto-approve vs relay classification
+    SessionSummarySentinel: 'sentinel', // summarize tmux output → task/phase/files
+    TelegramAdapter: 'sentinel', // stall/idle alert-suppression judge (parity with SlackAdapter)
+    ResumeValidator: 'gate', // does a resume UUID match the topic? (pre-resume gate)
+    Usher: 'reflector', // route a turn to candidate topics
+    TopicIntentExtractor: 'reflector', // extract topic intent from a turn
+    PreCompactionFlush: 'reflector', // extract durable facts before compaction
+    TreeSynthesis: 'reflector', // synthesize knowledge fragments → answer
+    LLMConflictResolver: 'reflector', // resolve divergent multi-machine state
+    openConversationBrief: 'reflector', // generate an A2A conversation brief
+    'a2a-checkin': 'reflector', // summarize A2A check-in threads (server:a2a-checkin)
+    'correction-learning': 'reflector', // distill recurring corrections → preference (server:correction-learning)
+    'mentor-stage-b': 'reflector', // classify mentor signals → forensic findings
 };
 /**
  * Resolve a component's category. Strips a trailing "/segment" call-site suffix

package/dist/core/componentCategories.js.map

@@ -1 +1 @@
-{"version":3,"file":"componentCategories.js","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO;CAChD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgD;IAC7E,uEAAuE;IACvE,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,UAAU;IACtB,uBAAuB,EAAE,UAAU;IACnC,gBAAgB,EAAE,UAAU;IAC5B,kBAAkB,EAAE,UAAU;IAC9B,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,UAAU;IAC3B,mBAAmB,EAAE,UAAU;IAC/B,wBAAwB,EAAE,UAAU;IACpC,mBAAmB,EAAE,UAAU;IAC/B,eAAe,EAAE,UAAU;IAC3B,0EAA0E;IAC1E,uEAAuE;IACvE,kBAAkB,EAAE,UAAU;IAC9B,mBAAmB,EAAE,UAAU;IAC/B,wEAAwE;IACxE,iDAAiD;IACjD,0BAA0B,EAAE,UAAU;IACtC,iEAAiE;IACjE,YAAY,EAAE,UAAU;IAExB,iDAAiD;IACjD,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,MAAM;IACvB,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,mBAAmB,EAAE,MAAM;IAC3B,aAAa,EAAE,MAAM;IACrB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IACzB,2EAA2E;IAC3E,YAAY,EAAE,MAAM;IACpB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM;IACxB,cAAc,EAAE,MAAM;IAEtB,gEAAgE;IAChE,YAAY,EAAE,WAAW;IACzB,kBAAkB,EAAE,WAAW;IAC/B,iBAAiB,EAAE,WAAW;IAC9B,UAAU,EAAE,WAAW;IACvB,eAAe,EAAE,WAAW;IAC5B,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,WAAW;IAChC,4BAA4B,EAAE,WAAW;IACzC,kBAAkB,EAAE,WAAW;IAE/B,8BAA8B;IAC9B,kBAAkB,EAAE,KAAK;IACzB,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,+EAA+E;IAC/E,iBAAiB,EAAE,KAAK;IACxB,8EAA8E;IAC9E,gFAAgF;IAChF,gFAAgF;IAChF,sEAAsE;IACtE,4EAA4E;IAC5E,2BAA2B,EAAE,KAAK;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"componentCategories.js","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.706",
+  "version": "1.3.707",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-07-02T04:52:58.637Z",
-  "instarVersion": "1.3.706",
+  "generatedAt": "2026-07-02T05:36:09.449Z",
+  "instarVersion": "1.3.707",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {

package/upgrades/1.3.707.md

@@ -0,0 +1,65 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+Thirteen background LLM call sites that were quietly running on the default
+framework (Claude) now route off-Claude with their peers. The framework router
+picks a provider by a component's category; these thirteen were absent from the
+category map, so they resolved to `other` and fell back to Claude — burning
+Anthropic quota while near-identical siblings routed to the cheaper, less
+rate-limited off-Claude providers.
+
+They were the pinned `WIRING_EXCLUSIONS` backlog explicitly deferred from the
+token-audit PR ("each needs its own deliberate routing decision"). This is that
+decision: each is registered by function — `InputClassifier`,
+`SessionSummarySentinel`, `TelegramAdapter` (sentinel; `TelegramAdapter` also fixes
+an asymmetry versus the already-registered `SlackAdapter` alert-suppression judge);
+`ResumeValidator` (gate); and `Usher`, `TopicIntentExtractor`, `PreCompactionFlush`,
+`TreeSynthesis`, `LLMConflictResolver`, `openConversationBrief`, `a2a-checkin`,
+`correction-learning`, `mentor-stage-b` (reflector).
+
+`WIRING_EXCLUSIONS` now holds only the five components that route via an explicit
+`attribution.category` and are correctly map-unregistered. The existing wiring
+ratchet remains the drift guard against future recurrence. Additive and fully
+reversible; no new logic, no new decision authority.
+
+## What to Tell Your User
+
+Thirteen of my small background AI helpers — the ones that classify messages,
+summarize sessions, extract facts before compaction, and similar housekeeping —
+were quietly running on Claude instead of the cheaper providers the rest of my
+background checks use. That was burning Claude subscription quota (the scarce,
+rate-limited resource) on work that never needed it. They now route off Claude
+like their peers, so more of your Claude quota stays available for the
+conversations and heavy work where it matters. Nothing changes in what these
+helpers do — only which provider quietly runs them.
+
+## Summary of New Capabilities
+
+None — no new API routes, config keys, or user-facing behavior. This is a
+routing-map completion: 13 existing internal LLM call sites now resolve to their
+proper category (`sentinel`/`gate`/`reflector`) so the existing
+Provider-Fallback Default Policy routes them off Claude. Operators can still
+override any of them per-agent via `sessions.componentFrameworks.overrides`.
+
+## Evidence
+
+Before: `GET /intelligence/routing` on a live agent showed these 13 components
+absent from the known-components registry, and `categoryForComponent()` in the
+deployed dist resolved each to `'other'` → the agent default framework (Claude).
+Verified against the deployed code during the 2026-07-01 LLM Routing Registry
+audit (docs/LLM-ROUTING-REGISTRY.md), not just the source branch — each of the
+13 calls `.evaluate()` with an `attribution.component` that had no map entry and
+no explicit `attribution.category`, while siblings like `SlackAdapter` (mapped)
+routed off-Claude.
+
+After: `categoryForComponent('InputClassifier')` → `'sentinel'` (and likewise
+for all 13; `'TelegramAdapter'` now matches the already-mapped `SlackAdapter`).
+The wiring ratchet (`tests/unit/llm-attribution-ratchet.test.ts`) proves both
+directions over the real source tree: every literal `attribution.component` in
+`src/` resolves to a registered category or a pinned explicit-category
+exception, and every remaining exception genuinely resolves to `'other'`. The
+router, integration, and e2e routing suites are green unchanged.

package/upgrades/side-effects/llm-routing-register-uncategorized-components.md

@@ -0,0 +1,100 @@
+# Side-Effects Review — Register 13 uncategorized LLM components
+
+**Version / slug:** `llm-routing-register-uncategorized-components`
+**Date:** `2026-07-01`
+**Author:** `echo`
+**Second-pass reviewer:** `not required`
+
+## Summary of the change
+
+Adds 13 previously-unregistered LLM call-site component names to `COMPONENT_CATEGORY`
+in `src/core/componentCategories.ts`, each tagged `sentinel` / `gate` / `reflector`
+by function, so the framework router resolves them to a real category instead of
+`other` (which falls back to the agent default framework, Claude). Correspondingly
+removes those 13 names from the `WIRING_EXCLUSIONS` pinned backlog in
+`tests/unit/llm-attribution-ratchet.test.ts`, leaving only the 5 components that
+route via an explicit `attribution.category` (so they correctly stay map-unregistered).
+Files touched: `src/core/componentCategories.ts`, `tests/unit/llm-attribution-ratchet.test.ts`.
+The change interacts with one decision point — the router's category resolution
+(`categoryForComponent`) — but only feeds it more data; it adds no branching logic.
+
+## Decision-point inventory
+
+- `categoryForComponent` (src/core/componentCategories.ts) — **pass-through** — unchanged
+  function; this change only adds rows to the map it reads. No control-flow edit.
+- `IntelligenceRouter.resolveFramework` (per-component framework routing) — **pass-through** —
+  consumes the category; unchanged. The 13 components now resolve to their category's
+  configured framework instead of the default, which is the intended effect.
+
+---
+
+## 1. Over-block
+
+**What legitimate inputs does this change reject that it shouldn't?**
+
+No block/allow surface — over-block not applicable. This is a routing-map data change,
+not a gate. It changes WHICH provider runs a call, never WHETHER the call is allowed.
+
+---
+
+## 2. Under-block
+
+**What failure modes does this still miss?**
+
+No block/allow surface — under-block not applicable. The change cannot make any gate
+more permissive; gate *authority* is untouched. (The one `gate`-category addition,
+ResumeValidator, keeps its existing behavior; only its provider changes.)
+
+---
+
+## 3. Wrong-provider / routing correctness
+
+**Could a component now route to a provider that can't serve it correctly?**
+
+Low risk. All 13 join categories (`sentinel`/`gate`/`reflector`) that the
+Provider-Fallback Default Policy already routes off-Claude for dozens of live
+components — the target providers (codex-cli → pi-cli → gemini-cli, Claude last)
+are production-exercised. A rate-limited or missing framework degrades via the
+existing per-framework circuit breaker + fallback chain (unchanged). No component
+routes to a provider class not already in use for its category.
+
+The one behavioral nuance: components that make *nuanced/critical* judgments
+(e.g. LLMConflictResolver resolving divergent multi-machine state) now run on a
+non-Claude reasoning-capable model (gpt-5.5 via codex) rather than Claude. This is
+aligned with the operator directive to prefer subsidized non-Claude subscriptions,
+and gpt-5.5 is reasoning-capable. A later nature-based routing pass (operator-reviewed)
+will refine per-task model tiers; this change does not lock that in.
+
+---
+
+## 4. Reversibility / rollback
+
+Fully reversible: remove the 13 rows from `COMPONENT_CATEGORY` (and restore them to
+`WIRING_EXCLUSIONS`) and routing returns to the prior state. No migration, no state
+schema change, no persisted data. An operator can also override any single component
+per-agent via `sessions.componentFrameworks.overrides` without touching this map.
+
+---
+
+## 5. Blast radius
+
+Fleet-wide once shipped (it's a core map), but strictly additive and category-consistent.
+No new code paths execute; the router simply finds a category where it previously found
+none. Existing tests cover it: the wiring ratchet (`llm-attribution-ratchet.test.ts`)
+proves every live `.evaluate()` component now resolves, `intelligence-router.test.ts` and
+the integration/e2e routing suites remain green. Signal-vs-authority: N/A — no detector
+and no authority is added or modified; this is a data-map completion.
+
+---
+
+## 6. Test coverage
+
+- `tests/unit/llm-attribution-ratchet.test.ts` — the drift guard; asserts every literal
+  `attribution.component` in `src/` resolves to a registered category or a pinned
+  (explicit-category) exception, AND that every pinned exception still resolves to `other`.
+  Both sides green after the change.
+- `tests/unit/intelligence-router.test.ts`, `tests/unit/standards-coverage-component-category.test.ts`,
+  `tests/integration/intelligence-routing-routes.test.ts`,
+  `tests/integration/provider-fallback-default-routing.test.ts` — all green.
+- No NEW test added: the existing ratchet already IS the structural guard for this
+  invariant (adding a duplicate would be noise).