@ngockhoale/ukit 2.0.4 → 2.0.5

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to UKit are documented here.
 
+## 2.0.5 - 2026-08-11
+
+### Changed
+
+- **Model IDs refreshed to the Claude 5 family**: `claude-sonnet-4-6` → `claude-sonnet-5`, `claude-opus-4-6` → `claude-opus-5`, across the `code`/`smart` tiers, `orchestration.modelTiers.vision.fallbackModel`, `handoff.defaultModel`/`advisorModel`/`orchestratorModel`, the Codex adapter settings, the `handoff-planner` agent example, and the config's own Vietnamese documentation strings. `claude-haiku-4-5` is unchanged — Haiku 4.5 is still current, so the `lite` tier was already correct. 54 references in live config, source and tests; historical records (`docs/AI_HANDOFF/archive/`, `docs/plans/`, `docs/WORKLOG.md`, `.ukit/storage/backups/`) are deliberately left alone, since rewriting what a past cycle actually ran on would be falsifying the record.
+
 ## 2.0.4 - 2026-08-11
 
 ### Added

package/package.json

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

package/src/core/runtimeConfig.js

@@ -117,14 +117,14 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
     },
     router: {
       enabled: true,
-      defaultModel: 'claude-sonnet-4-6',
-      advisorModel: 'claude-opus-4-6',
+      defaultModel: 'claude-sonnet-5',
+      advisorModel: 'claude-opus-5',
       advisorEnabled: true,
       maxAdvisorCalls: 3,
     },
     orchestration: {
       enabled: true,
-      orchestratorModel: 'claude-sonnet-4-6',
+      orchestratorModel: 'claude-sonnet-5',
       advisorEnabled: true,
       contracts: {
         'tiny-fix': {
@@ -176,12 +176,12 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
       },
       modelTiers: {
         lite: { claudeModel: 'claude-haiku-4-5', genericModel: 'unic-lite' },
-        code: { claudeModel: 'claude-sonnet-4-6', genericModel: 'unic-code' },
-        smart: { claudeModel: 'claude-opus-4-6', genericModel: 'unic-smart' },
+        code: { claudeModel: 'claude-sonnet-5', genericModel: 'unic-code' },
+        smart: { claudeModel: 'claude-opus-5', genericModel: 'unic-smart' },
         vision: {
           claudeModel: 'unic-vision',
           genericModel: 'unic-vision',
-          fallbackModel: 'claude-sonnet-4-6',
+          fallbackModel: 'claude-sonnet-5',
           capabilityTier: true,
           note: 'Capability tier, not a cost tier. Orthogonal to lite/code/smart — never insert into escalation.tierOrder. fallbackModel is used when unicMode is off.',
         },

package/templates/.claude/agents/handoff-planner.md

@@ -52,7 +52,7 @@ If zero testable behavior → write `N/A` + explicit justification in each task'
 Append this footer to `PLAN.md` — mandatory, checked by a hook before the write is allowed:
 ```
 ## Planner Report
-PLANNER_MODEL: <your exact model ID — e.g. claude-opus-4-6>
+PLANNER_MODEL: <your exact model ID — e.g. claude-opus-5>
 ```
 
 ## Phase 2 — Split into TASK-xxx.md

package/templates/.codex/settings.json

@@ -264,7 +264,7 @@
       "configPath": ".ukit/storage/config.json",
       "modelField": "orchestration.orchestratorModel",
       "advisorField": "orchestration.advisorEnabled",
-      "defaultModel": "claude-sonnet-4-6",
+      "defaultModel": "claude-sonnet-5",
       "internalOnly": true,
       "qualityFirst": true,
       "safeUpwardBias": true,

package/templates/ukit/storage/config.json

@@ -73,14 +73,14 @@
   },
   "router": {
     "enabled": true,
-    "defaultModel": "claude-sonnet-4-6",
-    "advisorModel": "claude-opus-4-6",
+    "defaultModel": "claude-sonnet-5",
+    "advisorModel": "claude-opus-5",
     "advisorEnabled": true,
     "maxAdvisorCalls": 3
   },
   "orchestration": {
     "enabled": true,
-    "orchestratorModel": "claude-sonnet-4-6",
+    "orchestratorModel": "claude-sonnet-5",
     "advisorEnabled": true,
     "contracts": {
       "tiny-fix": {
@@ -139,12 +139,12 @@
     },
     "modelTiers": {
       "lite": { "claudeModel": "claude-haiku-4-5", "genericModel": "unic-lite" },
-      "code": { "claudeModel": "claude-sonnet-4-6", "genericModel": "unic-code" },
-      "smart": { "claudeModel": "claude-opus-4-6", "genericModel": "unic-smart" },
+      "code": { "claudeModel": "claude-sonnet-5", "genericModel": "unic-code" },
+      "smart": { "claudeModel": "claude-opus-5", "genericModel": "unic-smart" },
       "vision": {
         "claudeModel": "unic-vision",
         "genericModel": "unic-vision",
-        "fallbackModel": "claude-sonnet-4-6",
+        "fallbackModel": "claude-sonnet-5",
         "capabilityTier": true,
         "note": "Capability tier, not a cost tier. Orthogonal to lite/code/smart — never insert into escalation.tierOrder. fallbackModel is used when unicMode is off."
       }
@@ -192,7 +192,7 @@
       "minTestsHappyPath": 1,
       "minTestsEdgeCase": 1,
       "regressionTestRequiredForBugfix": true,
-      "smartModelHint": "claude-opus-4-6"
+      "smartModelHint": "claude-opus-5"
     },
     "executor": {
       "testFirstRequired": true,
@@ -338,8 +338,8 @@
       "doi_reviewer_model": {
         "field": "handoff.reviewer.model",
         "mac_dinh": "unic-smart",
-        "y_nghia": "Model dùng cho reviewer agent ở Phase 3. BẮT BUỘC khác model executor để bắt được lỗi mà executor miss. Có thể dùng claude-opus-4-6, unic-smart, hoặc bất kỳ model reasoning mạnh nào.",
-        "vi_du": "Nếu executor là unic-code (Kilo Code), set reviewer.model=unic-smart hoặc claude-opus-4-6. Nếu executor là claude-sonnet, set reviewer thành claude-opus."
+        "y_nghia": "Model dùng cho reviewer agent ở Phase 3. BẮT BUỘC khác model executor để bắt được lỗi mà executor miss. Có thể dùng claude-opus-5, unic-smart, hoặc bất kỳ model reasoning mạnh nào.",
+        "vi_du": "Nếu executor là unic-code (Kilo Code), set reviewer.model=unic-smart hoặc claude-opus-5. Nếu executor là claude-sonnet, set reviewer thành claude-opus."
       },
       "tat_reviewer_phase": {
         "field": "handoff.reviewer.enabled",
@@ -485,7 +485,7 @@
         "minTestsHappyPath": "Tối thiểu test cho happy path.",
         "minTestsEdgeCase": "Tối thiểu test cho edge case (null/empty/boundary/concurrent…).",
         "regressionTestRequiredForBugfix": "Bug fix phải có regression test fail-trước-fix.",
-        "smartModelHint": "Gợi ý model mạnh nhất cho phase plan (ví dụ claude-opus-4-6). UKit không tự ép, chỉ ghi hint vào task."
+        "smartModelHint": "Gợi ý model mạnh nhất cho phase plan (ví dụ claude-opus-5). UKit không tự ép, chỉ ghi hint vào task."
       },
       "executor": {
         "testFirstRequired": "Executor phải viết test trước khi implement (RED → GREEN).",
@@ -496,7 +496,7 @@
       },
       "reviewer": {
         "enabled": "Bật Phase 3 review độc lập. Tắt = bỏ lưới an toàn cuối cùng, không khuyến nghị.",
-        "model": "Model reviewer. BẮT BUỘC khác executor model. Mặc định unic-smart; có thể dùng claude-opus-4-6 hoặc bất kỳ model reasoning mạnh nào.",
+        "model": "Model reviewer. BẮT BUỘC khác executor model. Mặc định unic-smart; có thể dùng claude-opus-5 hoặc bất kỳ model reasoning mạnh nào.",
         "agent": "Tên reviewer agent (xem .claude/agents/code-reviewer.md).",
         "mustDifferFromExecutor": "Nếu true, reviewer tự refuse khi phát hiện cùng model với executor.",
         "blockOnCritical": "CRITICAL → block handoff cứng. Set false chỉ khi muốn warning mềm.",