@ngockhoale/ukit 1.6.0 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
   "license": "MIT",
   "type": "module",

package/templates/.claude/ukit/index/route-task.mjs

@@ -433,6 +433,9 @@ function printRouteState(state) {
     console.log(`recent-output: ${recentOutputDisplay}`);
   }
   console.log(`summary: ${compactSummary}`);
+  if (state.routeSummary?.executionContract?.modelTier) {
+    console.log(`modelTier: ${state.routeSummary.executionContract.modelTier}`);
+  }
   if (nextDisplay) {
     console.log(`next: ${nextDisplay}`);
   }
@@ -1655,6 +1658,7 @@ function buildExecutionContract(executionMode = null) {
 
   const contracts = {
     'tiny-fix': {
+      modelTier: 'lite',
       maxReadPasses: 0,
       maxContextPulls: 0,
       verificationPolicy: 'minimal-or-targeted',
@@ -1663,6 +1667,7 @@ function buildExecutionContract(executionMode = null) {
       completionEvidence: ['write-evidence'],
     },
     'local-fix': {
+      modelTier: 'code',
       maxReadPasses: 1,
       maxContextPulls: 1,
       verificationPolicy: 'targeted-if-covered',
@@ -1671,6 +1676,7 @@ function buildExecutionContract(executionMode = null) {
       completionEvidence: ['write-evidence'],
     },
     'local-build': {
+      modelTier: 'code',
       maxReadPasses: 2,
       maxContextPulls: 1,
       verificationPolicy: 'targeted-if-covered',
@@ -1679,6 +1685,7 @@ function buildExecutionContract(executionMode = null) {
       completionEvidence: ['write-evidence'],
     },
     'find-cause': {
+      modelTier: 'smart',
       maxReadPassesBeforeReassess: 3,
       verificationPolicy: 'root-cause-then-targeted',
       completionRule: 'never-claim-fixed-without-write-and-verification',
@@ -1686,6 +1693,7 @@ function buildExecutionContract(executionMode = null) {
       completionEvidence: ['write-evidence', 'verification-evidence'],
     },
     'shared-edit': {
+      modelTier: 'code',
       maxReadPasses: 2,
       maxContextPulls: 2,
       verificationPolicy: 'targeted-then-widen-on-risk',
@@ -1695,6 +1703,7 @@ function buildExecutionContract(executionMode = null) {
       mirrorConsistencyRequired: true,
     },
     'map-impact': {
+      modelTier: 'smart',
       maxReadPasses: 3,
       maxContextPulls: 3,
       verificationPolicy: 'impact-first-then-targeted-then-widen-on-risk',
@@ -1704,6 +1713,7 @@ function buildExecutionContract(executionMode = null) {
       mirrorConsistencyRequired: true,
     },
     'review-release': {
+      modelTier: 'smart',
       verificationPolicy: 'evidence-first',
       completionRule: 'report-findings-not-implementation',
       delegationPolicy: 'allow-review-sidecar',

package/templates/CLAUDE.md

@@ -136,6 +136,32 @@ Khi Handoff mode: đọc `docs/AI_HANDOFF/RULES.md` để biết 4 phase (Idea+P
 - `autonomy.level` in `.ukit/storage/config.json` controls how much UKit acts without asking first: `conservative` (ask more), `balanced` (default), `free-run` (auto-run more).
 - End users should not need to change this; maintainers may tune it per-project.
 
+## 3-Tier Model Routing
+
+**Internal orchestration only — end users still just use natural language. No new commands.**
+
+UKit routes tasks to one of three model tiers based on task complexity:
+
+| Tier | Generic alias | Claude model | Typical tasks |
+|------|--------------|--------------|---------------|
+| lite | `unic-lite` | claude-haiku | Reads, git queries, bash summaries, small doc edits |
+| code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds |
+| smart | `unic-smart` | claude-opus | Deep reasoning, root-cause analysis, release review |
+
+### Contract-to-tier mapping
+
+| Contract | Tier |
+|----------|------|
+| `tiny-fix` | lite |
+| `local-fix`, `local-build`, `shared-edit` | code |
+| `find-cause`, `map-impact`, `review-release` | smart |
+
+### Escalation rule
+
+When the same file or symbol fails `debugLoopThreshold` (default: 2) times in one session, UKit routes the next attempt one tier higher (capped at `smart`). Config: `orchestration.escalation` in `.ukit/storage/config.json`.
+
+This is internal orchestration — end users do not need to know about tiers, thresholds, or escalation. The AI handles routing transparently.
+
 ## Project Snapshot
 
 - Project: {{project.name}} | Root: {{project.root}}