nexus-agents 2.133.0 → 2.134.0

package/dist/{chunk-QJIHSQZX.js → chunk-DBDWMHUL.js}

@@ -3,7 +3,7 @@ import {
   getDecisionCostFile,
   isPersistenceEnabled,
   nexusDataPath
-} from "./chunk-RUSP5PJR.js";
+} from "./chunk-GZ4NF4ZW.js";
 import {
   __require
 } from "./chunk-ZPWHCABL.js";
@@ -2339,7 +2339,7 @@ function setDefaultRegistry(registry) {
 }
 async function reloadDefaultRegistry() {
   globalRegistry = buildDefaultRegistry();
-  const { resetGlobalRegistry } = await import("./unified-registry-UFNSWKZA.js");
+  const { resetGlobalRegistry } = await import("./unified-registry-IMAL3SY6.js");
   resetGlobalRegistry();
   return globalRegistry;
 }
@@ -4104,7 +4104,10 @@ var TOOL_MANIFEST = [
     sideEffects: [
       { category: "implicit", description: "Consumes rate limit quota" },
       { category: "implicit", description: "May trigger reflective retrieval (MemR3)" }
-    ]
+    ],
+    // #3930: memory READ surface. Deliberately orthogonal to memory_write (mutate);
+    // a rarely-used read must never be flagged for folding into the writer.
+    orthogonalityGroup: "memory-read"
   },
   {
     name: "memory_stats",
@@ -4115,7 +4118,10 @@ var TOOL_MANIFEST = [
       idempotentHint: true,
       openWorldHint: false
     },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
+    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }],
+    // #3930: memory READ/introspection surface — same orthogonality domain as
+    // memory_query, distinct from the memory_write mutate surface.
+    orthogonalityGroup: "memory-read"
   },
   {
     name: "memory_write",
@@ -4129,7 +4135,10 @@ var TOOL_MANIFEST = [
     sideEffects: [
       { category: "explicit", description: "Writes data to memory backend" },
       { category: "implicit", description: "Consumes rate limit quota" }
-    ]
+    ],
+    // #3930: memory MUTATE surface. Orthogonal to the memory-read tools — a
+    // distinct capability domain, never a consolidation target for the readers.
+    orthogonalityGroup: "memory-write"
   },
   {
     name: "weather_report",
@@ -4208,7 +4217,11 @@ var TOOL_MANIFEST = [
     },
     sideEffects: [
       { category: "implicit", description: "Reads execution trace JSONL files from disk" }
-    ]
+    ],
+    // #3930: reads execution-trace JSONL. Deliberately distinct data domain from
+    // query_task_state (structured task-state log) despite the shared `query_`
+    // prefix — not interchangeable, so not a consolidation pair.
+    orthogonalityGroup: "query-trace"
   },
   {
     name: "query_task_state",
@@ -4221,7 +4234,10 @@ var TOOL_MANIFEST = [
     },
     sideEffects: [
       { category: "implicit", description: "Reads the structured task-state log (#2278)" }
-    ]
+    ],
+    // #3930: reads the structured task-state log — a distinct data domain from
+    // query_trace's execution traces. Shared prefix, orthogonal capability.
+    orthogonalityGroup: "query-task-state"
   },
   {
     name: "get_job_result",
@@ -4273,7 +4289,10 @@ var TOOL_MANIFEST = [
         category: "coupling",
         description: "Triggers AbortSignal unwind in same-process dispatcher (cross-process workers must poll)"
       }
-    ]
+    ],
+    // #3930: break-glass kill-switch — you only call it to abort a runaway async
+    // job, so it is low-usage BY DESIGN, not dead weight. Never auto-deprecate.
+    neverDeprecate: true
   },
   {
     name: "ci_health_check",
@@ -4293,7 +4312,11 @@ var TOOL_MANIFEST = [
         category: "implicit",
         description: "Appends a local CI-health telemetry event per call for observability (#3530)"
       }
-    ]
+    ],
+    // #3930: incident diagnostic — used BEFORE long auto-merge waits to detect an
+    // org-wide CI wedge. Rare by design (only when CI is suspected broken), so a
+    // low invocation count is expected, not a deprecation signal.
+    neverDeprecate: true
   },
   {
     name: "verify_audit_chain",
@@ -4309,7 +4332,11 @@ var TOOL_MANIFEST = [
         category: "implicit",
         description: "Reads the immutable audit log and verifies the hash chain"
       }
-    ]
+    ],
+    // #3930: tamper-evidence integrity tool — invoked rarely (on-demand chain
+    // verification), but it is the substrate's audit-integrity guarantee. Low
+    // usage is by design; deprecating it would silently drop tamper detection.
+    neverDeprecate: true
   },
   {
     name: "repo_analyze",
@@ -4326,7 +4353,11 @@ var TOOL_MANIFEST = [
         description: "Fetches repository metadata from GitHub API via gh CLI"
       },
       { category: "implicit", description: "Consumes rate limit quota" }
-    ]
+    ],
+    // #3930: general repo-structure analysis. Distinct capability domain from
+    // repo_security_plan (security-scanning recommendation) — shared `repo_`
+    // prefix but not substitutable.
+    orthogonalityGroup: "repo-analyze"
   },
   {
     name: "repo_security_plan",
@@ -4343,7 +4374,11 @@ var TOOL_MANIFEST = [
         description: "Fetches repository metadata from GitHub API via gh CLI"
       },
       { category: "implicit", description: "Consumes rate limit quota" }
-    ]
+    ],
+    // #3930: security-scanning pipeline recommendation. Orthogonal domain to
+    // repo_analyze (general structure) — a security-specific capability that
+    // must not be folded into the general analyzer.
+    orthogonalityGroup: "repo-security"
   },
   {
     name: "extract_symbols",
@@ -4531,6 +4566,20 @@ var TOOL_MANIFEST = [
     ]
   }
 ];
+var NEVER_DEPRECATE_TOOLS = new Set(
+  TOOL_MANIFEST.filter((t) => t.neverDeprecate === true).map((t) => t.name)
+);
+var TOOL_ORTHOGONALITY_GROUPS = new Map(
+  TOOL_MANIFEST.filter(
+    (t) => t.orthogonalityGroup !== void 0
+  ).map((t) => [t.name, t.orthogonalityGroup])
+);
+function isDeclaredNeverDeprecate(tool) {
+  return NEVER_DEPRECATE_TOOLS.has(tool);
+}
+function declaredOrthogonalityGroup(tool) {
+  return TOOL_ORTHOGONALITY_GROUPS.get(tool);
+}
 
 // src/core/task-analysis/capability-gap-detector.ts
 var AVAILABLE_TOOLS = new Set(TOOL_MANIFEST.map((t) => t.name));
@@ -13519,7 +13568,7 @@ var CompositeRouter = class _CompositeRouter {
    */
   async consultUnifiedContext(task) {
     try {
-      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-5OVRAWNZ.js");
+      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-I4NEOUEV.js");
       const ctx = await getContextForTask({
         task: task.content,
         category: inferTaskCategory(task.content),
@@ -14953,6 +15002,8 @@ export {
   SharedTaskAnalyzer,
   createSharedTaskAnalyzer,
   TOOL_MANIFEST,
+  isDeclaredNeverDeprecate,
+  declaredOrthogonalityGroup,
   detectCapabilityGaps,
   getGapLedger,
   recordRoutingGaps,
@@ -15020,4 +15071,4 @@ export {
   AgentCapability,
   OrchestratorError
 };
-//# sourceMappingURL=chunk-QJIHSQZX.js.map
+//# sourceMappingURL=chunk-DBDWMHUL.js.map