@ngockhoale/ukit 3.0.5 → 3.0.6

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to UKit are documented here.
 
+## 3.0.6 - 2026-09-24
+
+- Clarified the project owner's `unic-decision` contract in owner instructions, project memory, the technical spec, and shipped internals: a local Lava/JEV model in UNIC Provider, not an LLM; the OpenAI-compatible API is transport for convenient integration, not evidence of remote hosting or generative-model pricing.
+- Documented the preferred bounded typed-decision usage and the existing stage-off rollout/fallback in package-side client/config comments and the installed adapter, without changing runtime behavior or enabling decision calls.
+
 
 ## 3.0.5 - 2026-09-24
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex and omp (Oh My Pi).",
   "license": "MIT",
   "type": "module",

package/src/core/runtimeConfig.js

@@ -293,9 +293,12 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
       fastPath: { stage: 'off' },
       escalation: { stage: 'off' },
     },
-    // C52 M07 UNIC Decision Agent (docs/pstack/UNIC_DECISION_SPEC §17). All
-    // stages ship 'off' — zero outbound calls, deterministic policy stays
-    // authoritative. `enabled:false` is the global emergency disable.
+    // C52 M07: `unic-decision` is the owner's local non-LLM Lava/JEV model in
+    // UNIC Provider. Its OpenAI-compatible API is transport only, not proof of
+    // remote hosting or generative-LLM billing. Prefer bounded typed decisions
+    // when staged on; all stages currently ship 'off' (no decision request),
+    // deterministic safety/completion policy stays authoritative.
+    // `enabled:false` is the global emergency disable.
     decisionPlane: {
       enabled: true,
       stage: 'off',

package/src/decision/client.js

@@ -1,9 +1,17 @@
 /**
  * client.js (TASK-002 / M07)
  *
- * Typed client for the UNIC Decision Agent: OpenAI-compatible
- * `POST <baseUrl>/v1/chat/completions` against the configured UNIC gateway
- * (docs/pstack/UNIC_DECISION_SPEC.md §3/§15/§16).
+ * Typed client for the owner's LOCAL `unic-decision` model in UNIC Provider.
+ * It uses Lava/JEV technology and is NOT an LLM. OpenAI-compatible
+ * `POST <baseUrl>/v1/chat/completions` is only its interoperability transport,
+ * not evidence of remote hosting, generative semantics, or LLM pricing.
+ * See docs/pstack/UNIC_DECISION_SPEC.md (identity, §3/§15/§16).
+ *
+ * Prefer bounded classify/select/rank/score questions when decisionPlane.stage
+ * enables the caller; derive candidates in code, pass compact state and typed
+ * questions to createDecisionClient(...).requestBatch({ statePacket, questions }),
+ * then validate the outcome and retain deterministic safety/permission gates.
+ * The client does not itself switch a disabled rollout stage on.
  *
  * - Endpoint + credentials resolve via gatewayProbe env indirection only —
  *   no literal keys, no new credential store.

package/template_project/.claude/ukit/index/unic-decision.mjs

@@ -2,8 +2,12 @@
 /**
  * unic-decision.mjs (TASK-005 / M07, SPEC §5 FR-011)
  *
- * Standalone installed-side adapter for the UNIC Decision Agent
- * (docs/pstack/UNIC_DECISION_SPEC.md §8/§9, CONTRACTS.md C13/C14).
+ * Standalone installed-side adapter for the owner's local, non-LLM
+ * Lava/JEV `unic-decision` model in UNIC Provider. OpenAI-compatible
+ * /v1/chat/completions is a transport for easy integration, not evidence of
+ * an external generative LLM or LLM pricing. Prefer bounded typed semantic
+ * decisions when the caller's decisionPlane stage is enabled; this adapter
+ * does not change the rollout stage or override deterministic safety gates.
  *
  * Modes:
  *   node unic-decision.mjs --health-probe        one no-tools request; the ONLY

package/template_project/docs/UKIT_INTERNALS.md

@@ -140,6 +140,15 @@ the root contract is the only carrier — keep both in sync with
 
 ## 3-Tier Model Routing — full detail
 
+`unic-decision` is **not** another LLM tier. The owner built this local,
+near-zero-cost Lava/JEV model in UNIC Provider for fast typed semantic
+decisions; the OpenAI-compatible API is a convenience transport, not a
+generative-LLM or external-hosting claim. When `decisionPlane.stage` enables
+it, use bounded candidate choices/rankings/scores through
+`.claude/ukit/index/unic-decision.mjs`; keep safety, authorization and
+completion gates deterministic. The shipped stage is `off` until explicitly
+promoted. See `docs/pstack/UNIC_DECISION_SPEC.md` in the UKit development repo.
+
 UKit routes tasks to one of three model tiers based on task complexity. The main session
 model never changes mid-turn: a tier only takes effect when work is handed to an agent
 whose own definition binds that model.