@ngockhoale/ukit 2.7.0 → 2.7.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to UKit are documented here.
 
+## 2.7.1 - 2026-09-20
+
+omp native-tier steering — cycle C36 (TASK-001..005).
+
+- `templates/.omp/config.yml` modelRoles now pins omp's native cost tiers
+  `smol`/`default`/`slow` (→ `unic-lite`/`unic-code`/`unic-smart`) so omp's
+  built-in tier steering resolves UKit's gateway aliases directly; `vision`
+  stays `unic-vision` (capability lane — unic-code/unic-smart cannot read
+  images on this gateway).
+- Back-compat: `lite`/`code`/`smart` kept as independent alias keys (not
+  references) resolving to the same unic-* values — a maintainer overriding
+  a cost tier must edit the matching alias too.
+- `.omp/agents/*.md` rebound from direct unic-* names to `@smol`/`@default`/
+  `@slow`/`@vision` frontmatter so agents follow the modelRoles map.
+- Migration: `mergeOmpConfig` merges `modelRoles` per key (user-pinned keys
+  preserved, newly added template keys recorded via `addedModelRoleKeys`)
+  instead of clobbering the whole map.
+- `orchestration.modelTiers.*.ompRole` added to the runtime config template
+  + `runtimeConfig.js` so each tier declares which modelRoles key it binds
+  (lite→smol, code→default, smart→slow, vision→vision).
+
 ## 2.7.0 - 2026-09-20
 
 OMP fully autonomous / unattended mode — cycle C35 (TASK-008..014).

package/package.json

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

package/src/core/ompConfigMerge.js

@@ -20,6 +20,7 @@ function emptyReport() {
     strippedPromptApprovals: [],
     coercedPromptPatterns: [],
     preservedModelRoles: false,
+    addedModelRoleKeys: [],
     preservedTopLevelKeys: [],
     preservedPatterns: [],
     parseError: null,
@@ -141,14 +142,42 @@ export function mergeOmpConfig(existingText, renderedText) {
 
   const lines = renderedText.split('\n');
 
-  // §7.3 — modelRoles block splice: replace the rendered `modelRoles:` scalar
-  // map span with the existing span (maintainer edits for non-UNIC providers).
+  // §7.3 / FR-004 — modelRoles per-key union: existing entries win verbatim,
+  // rendered keys absent from existing are appended (rendered order) so new
+  // template roles (e.g. smol/default/slow) reach pre-existing installs while
+  // user-owned roles and overrides survive. The block is regenerated via
+  // YAML.stringify under `modelRoles:`; rendered header comments above the
+  // `modelRoles:` line are untouched. Known limitation: comments *inside* the
+  // existing modelRoles block are dropped — values are preserved, comment
+  // text is not (SPEC §10).
   const renderedRoles = extractScalarMapSpan(lines, 'modelRoles');
-  const existingLines = existingText.split('\n');
-  const existingRoles = extractScalarMapSpan(existingLines, 'modelRoles');
-  if (renderedRoles && existingRoles && isPlainObject(existing.modelRoles)) {
-    lines.splice(renderedRoles.start, renderedRoles.end - renderedRoles.start, ...existingRoles.lines);
-    report.preservedModelRoles = true;
+  if (renderedRoles && isPlainObject(existing.modelRoles)) {
+    const merged = { ...existing.modelRoles };
+    const renderedMap = isPlainObject(rendered?.modelRoles) ? rendered.modelRoles : {};
+    for (const [key, value] of Object.entries(renderedMap)) {
+      if (!(key in merged)) {
+        merged[key] = value;
+        report.addedModelRoleKeys.push(key);
+      }
+    }
+    // Skip regeneration when existing contributed nothing the rendered block
+    // doesn't already state — identical keys and values means the rendered
+    // block (interior comments included) already IS the merged result.
+    // Regenerating here would byte-shift installs whose file matches the
+    // template and break install idempotency.
+    const renderedKeys = Object.keys(renderedMap);
+    const mergedKeys = Object.keys(merged);
+    const identicalToRendered =
+      mergedKeys.length === renderedKeys.length &&
+      mergedKeys.every((k) => k in renderedMap && merged[k] === renderedMap[k]);
+    if (!identicalToRendered) {
+      const fragment = YAML.stringify(merged, { indent: 2 })
+        .trimEnd()
+        .split('\n')
+        .map((line) => `  ${line}`);
+      lines.splice(renderedRoles.start, renderedRoles.end - renderedRoles.start, 'modelRoles:', ...fragment);
+      report.preservedModelRoles = true;
+    }
   }
 
   // §7.2 splice — append preserved allow/deny keys to the rendered

package/src/core/runtimeConfig.js

@@ -144,12 +144,14 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
       permissionMode: 'unattended',
       contracts: buildConfigContracts(),
       modelTiers: {
-        lite: { claudeModel: 'claude-haiku-4-5', genericModel: 'unic-lite' },
-        code: { claudeModel: 'claude-sonnet-5', genericModel: 'unic-code' },
-        smart: { claudeModel: 'claude-opus-5', genericModel: 'unic-smart' },
+        // ompRole is the .omp/config.yml modelRoles key this tier binds to.
+        lite: { claudeModel: 'claude-haiku-4-5', genericModel: 'unic-lite', ompRole: 'smol' },
+        code: { claudeModel: 'claude-sonnet-5', genericModel: 'unic-code', ompRole: 'default' },
+        smart: { claudeModel: 'claude-opus-5', genericModel: 'unic-smart', ompRole: 'slow' },
         vision: {
           claudeModel: 'unic-vision',
           genericModel: 'unic-vision',
+          ompRole: 'vision',
           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/commands/ukit/handoff-create.md

@@ -6,7 +6,7 @@
 - Read/understand → lite model (haiku · unic-lite · cheapest available)
 - Write plan + tasks → strong model (Opus · unic-smart · strongest available)
 
-> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@lite` / `@code` / `@smart`.
+> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@smol` / `@default` / `@slow`.
 
 ## Problem / feature
 $ARGUMENTS

package/templates/.claude/commands/ukit/handoff-fullstack.md

@@ -13,9 +13,9 @@
 
 > Claude Code: spawn `ukit-small-task-maintainer` (haiku) for light steps; spawn `handoff-planner` (opus) for planning; spawn `feature-implementer` (sonnet) agents for implementation; spawn `code-reviewer` (opus) per task for review.
 >
-> omp: same four agents, launched with the `task` tool (`agent: "<name>"`). They live in `.omp/agents/` and bind their tier through `model: "@lite"` / `"@code"` / `"@smart"`, resolved via `modelRoles` in `.omp/config.yml` — you do not pass a model name.
+> omp: same four agents, launched with the `task` tool (`agent: "<name>"`). They live in `.omp/agents/` and bind their tier through `model: "@smol"` / `"@default"` / `"@slow"`, resolved via `modelRoles` in `.omp/config.yml` — you do not pass a model name.
 
-> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@lite` / `@code` / `@smart`.
+> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@smol` / `@default` / `@slow`.
 
 ---
 

package/templates/.claude/commands/ukit/handoff-implement.md

@@ -4,7 +4,7 @@
 **Tool: any** (Claude Code / Codex / omp / Kilo / OpenCode — your choice)
 **Model: code model** (Sonnet · unic-code · cheap-smart)
 
-> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@lite` / `@code` / `@smart`.
+> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@smol` / `@default` / `@slow`.
 
 ## Target (optional)
 $ARGUMENTS

package/templates/.claude/commands/ukit/handoff-review.md

@@ -4,7 +4,7 @@
 **Tool: any** (Claude Code / Codex / omp / Kilo / OpenCode — your choice)
 **Model: strong model, MUST differ from executor** (Opus · unic-smart · strongest available)
 
-> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@lite` / `@code` / `@smart`.
+> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@smol` / `@default` / `@slow`.
 
 ## Target (optional)
 $ARGUMENTS

package/templates/.omp/README.md

@@ -26,19 +26,23 @@ whatever was there before, so local edits are never silently lost — they move,
 
 ## Model roles
 
-`.omp/config.yml` defines four roles. Agent frontmatter references them as `@lite` / `@code` /
-`@smart` / `@vision`, so retargeting a whole tier is a one-line edit in one file.
+`.omp/config.yml` defines omp's native roles `smol` / `default` / `slow` / `vision` plus
+back-compat aliases `lite` / `code` / `smart` that resolve to the same models. Agent frontmatter
+references the native roles as `@smol` / `@default` / `@slow` / `@vision`, so retargeting a whole
+tier is a one-line edit in one file — but remember the matching `lite`/`code`/`smart` alias is an
+independent key: edit it too, or it keeps resolving to the old value.
 
 | Role | Default model | Agents using it |
 |------|---------------|-----------------|
-| `lite` | `unic-lite` | `ukit-small-task-maintainer` |
-| `code` | `unic-code` | `feature-implementer`, `bug-debugger` |
-| `smart` | `unic-smart` | `handoff-planner`, `code-reviewer` |
+| `smol` (alias `lite`) | `unic-lite` | `ukit-small-task-maintainer` |
+| `default` (alias `code`) | `unic-code` | `feature-implementer`, `bug-debugger` |
+| `slow` (alias `smart`) | `unic-smart` | `handoff-planner`, `code-reviewer` |
 | `vision` | `unic-vision` | `ukit-vision-analyst` |
 
 These are **literal model names on the UNIC gateway, not aliases**, and they ship as the installed
-default. If this project does not run against UNIC, a maintainer swaps the three cost tiers for the
-values in `orchestration.modelTiers[*].claudeModel` in `.ukit/storage/config.json`.
+default. If this project does not run against UNIC, a maintainer swaps the three cost tiers
+(`smol`/`default`/`slow` — and their `lite`/`code`/`smart` aliases) for the values in
+`orchestration.modelTiers[*].claudeModel` in `.ukit/storage/config.json`.
 
 `vision` is the exception and stays `unic-vision` either way: it is a *capability* lane, not a cost
 tier. `unic-code` and `unic-smart` cannot read images on this gateway, so substituting one of them

package/templates/.omp/RULES.md

@@ -40,12 +40,12 @@ work really is, read the matching `SKILL.md` without being asked. Users never na
 ## 6. Delegate to bind a model tier
 
 Your own model does not change mid-turn. A tier only applies when work is handed to a task-agent in
-`.omp/agents/`, whose `model:` field (`@lite` / `@code` / `@smart` / `@vision`) resolves through
+`.omp/agents/`, whose `model:` field (`@smol` / `@default` / `@slow` / `@vision`) resolves through
 `modelRoles` in `.omp/config.yml`.
 
-- `tiny-fix` → `@lite` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
-  `@code` · `review-release` → `@smart`
-- Images: `@vision` only. `@code`/`@smart` cannot see images on the UNIC gateway and must never
+- `tiny-fix` → `@smol` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
+  `@default` · `review-release` → `@slow`
+- Images: `@vision` only. `@default`/`@slow` cannot see images on the UNIC gateway and must never
   guess at their contents — hand every image to `ukit-vision-analyst` first.
 
 Doing everything inline is exactly what makes UKit look like it only has one model. Keep direct
@@ -73,5 +73,6 @@ last thing you emit is one short line naming what is unfinished and what you nee
 a status — the user cannot distinguish it from a crash.
 
 > Maintainer note, not a per-turn rule: `modelRoles` in `.omp/config.yml` ships UNIC gateway names.
-> On a non-UNIC provider, edit only the three cost tiers — `lite`, `code`, `smart` — never `vision`,
-> which stays `unic-vision` because it is a capability lane, not a cost tier.
+> On a non-UNIC provider, edit only the three cost tiers — `smol`, `default`, `slow` — never `vision`,
+> which stays `unic-vision` (capability lane, not a cost tier). Old keys `lite`/`code`/`smart` remain
+> as compat aliases — edit each alias alongside its tier (smol↔lite, default↔code, slow↔smart).

package/templates/.omp/agents/bug-debugger.md

@@ -1,7 +1,7 @@
 ---
 name: bug-debugger
 description: "Debugging specialist for reproducible errors, failing tests, and unexpected behavior. Use proactively when investigation will involve noisy logs, stack traces, or a self-contained reproduce-trace-fix-verify loop. Do not use for trivial obvious fixes or broad architecture ideation."
-model: "@code"
+model: "@default"
 tools: ["read","grep","glob","bash","edit","ast_edit"]
 ---
 

package/templates/.omp/agents/code-reviewer.md

@@ -1,7 +1,7 @@
 ---
 name: code-reviewer
 description: "Independent reviewer for handoff Phase 3, for spec/plan documents, and for non-blocking sidecar diff review of daily-flow edits. For code (default): use after executor reports STATUS: DONE on a handoff task, MUST run with a model different from the executor (configured in .ukit/storage/config.json → handoff.reviewer.model, default unic-smart), produces a verdict: APPROVED | APPROVED-WITH-MINOR | CHANGES-REQUESTED | CRITICAL. For spec/plan documents (set REVIEW_TARGET_TYPE=spec or plan): reviews a docs/plans/*.md file for completeness/consistency/clarity/scope/YAGNI, produces Status: Approved | Issues Found. For sidecar diff review (set REVIEW_TARGET_TYPE=diff): reviews the current uncommitted git diff after a local-build/shared-edit task, runs in the background and never blocks the main task, produces STATUS: clean | issues-found."
-model: "@smart"
+model: "@slow"
 tools: ["read","grep","glob","bash"]
 ---
 

package/templates/.omp/agents/feature-implementer.md

@@ -1,7 +1,7 @@
 ---
 name: feature-implementer
 description: "Implementation specialist for clear, self-contained coding tasks. Use proactively when the approach is clear and the work can be completed in a bounded pass with a concise summary. Do not use for trivial one-file tweaks or tightly coupled exploratory work."
-model: "@code"
+model: "@default"
 tools: ["read","edit","write","ast_edit","grep","glob","bash"]
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 name: handoff-planner
 description: "Handoff planning specialist for Phase 1+2. Use when creating a new handoff cycle: writes PLAN.md with full test plan, splits into TASK-xxx.md files with TDD-embedded test cases, and updates INDEX.md. Always use the strongest available model (Opus/unic-smart)."
-model: "@smart"
+model: "@slow"
 tools: ["read","edit","write","ast_edit","glob","bash"]
 ---
 

package/templates/.omp/agents/ukit-small-task-maintainer.md

@@ -1,7 +1,7 @@
 ---
 name: ukit-small-task-maintainer
 description: "Internal UKit maintenance subagent for low-risk, reversible UKit decisions. Use proactively when UKit needs to decide or perform safe cleanup such as pruning docs/TASKS.md, classifying queued work, choosing whether compact/summarization is appropriate, summarizing local docs/status, or maintaining small UKit runtime queues. Do not use for product implementation, security, release/publish, data-loss, architecture, or risky/shared code changes."
-model: "@lite"
+model: "@smol"
 tools: ["read","grep","glob","edit","write","ast_edit"]
 blocking: false
 ---
@@ -11,7 +11,7 @@ You are UKit's internal small-task maintainer. You run as a sidecar/parallel/non
 ## Model Policy
 
 - Use the model selected by `subagents.smallTaskModel` when the host supports model selection for this subagent.
-- Default intended model: `unic-lite`.
+- Default intended model: `unic-lite` (frontmatter `@smol` resolves to `unic-lite` via `.omp/config.yml` modelRoles).
 - If the host cannot bind a model from config directly, still follow this role and report that the configured model is a hint.
 - This lane must run separately from the user's main task model. It must never replace, pause, or slow down the main task.
 

package/templates/.omp/config.yml

@@ -2,17 +2,23 @@
 # models may change during development; orchestration must not branch on vendor names.
 # Do NOT substitute sonnet/opus/haiku here. See PLAN.md §3 D15.
 #
-# Non-UNIC omp provider? A maintainer edits the three cost tiers to the values in
-# orchestration.modelTiers[*].claudeModel (.ukit/storage/config.json) — currently
-# lite: claude-haiku-4-5, code: claude-sonnet-5, smart: claude-opus-5.
+# Non-UNIC omp provider? A maintainer edits the three cost tiers — smol, default, slow —
+# to the values in orchestration.modelTiers[*].claudeModel (.ukit/storage/config.json) —
+# currently lite: claude-haiku-4-5, code: claude-sonnet-5, smart: claude-opus-5.
 # `vision` STAYS unic-vision: its claudeModel is already unic-vision, because
 # unic-code/unic-smart cannot read images on this gateway. claude-sonnet-5 is only
 # modelTiers.vision.fallbackModel, used when unicMode is off — never a drop-in here.
 modelRoles:
+  smol: unic-lite
+  default: unic-code
+  slow: unic-smart
+  vision: unic-vision
+  # Back-compat aliases — INDEPENDENT keys, not references. A maintainer overriding a
+  # cost tier above must edit the matching alias too (smol↔lite, default↔code,
+  # slow↔smart), or the alias keeps resolving to the old unic-* value.
   lite: unic-lite
   code: unic-code
   smart: unic-smart
-  vision: unic-vision
 
 tools:
   # TASK-009 / SPEC FR-003: the unattended approval surface is pinned HERE —

package/templates/AGENTS.md

@@ -136,7 +136,7 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 

package/templates/CLAUDE.md

@@ -136,7 +136,7 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 

package/templates/docs/UKIT_INTERNALS.md

@@ -179,7 +179,7 @@ whose own definition binds that model.
 | Harness | Agent definitions | How to launch one |
 |---------|-------------------|-------------------|
 | Claude Code | `.claude/agents/*.md` (`model:` frontmatter) | Agent tool, `subagent_type: "<name>"` |
-| omp | `.omp/agents/*.md` (`model: "@lite"` / `"@code"` / `"@smart"` / `"@vision"`, resolved through `modelRoles` in `.omp/config.yml`) | task-agent `<name>` |
+| omp | `.omp/agents/*.md` (`model: "@smol"` / `"@default"` / `"@slow"` / `"@vision"`, resolved through `modelRoles` in `.omp/config.yml`) | task-agent `<name>` |
 
 When a task's contract maps to a tier other than the current session model, hand it to the
 matching agent instead of doing it inline. Doing everything inline is exactly what makes

package/templates/instructions/core.md

@@ -133,7 +133,7 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 

package/templates/instructions/overlays/omp-rules.md

@@ -37,12 +37,12 @@ work really is, read the matching `SKILL.md` without being asked. Users never na
 ## 6. Delegate to bind a model tier
 
 Your own model does not change mid-turn. A tier only applies when work is handed to a task-agent in
-`.omp/agents/`, whose `model:` field (`@lite` / `@code` / `@smart` / `@vision`) resolves through
+`.omp/agents/`, whose `model:` field (`@smol` / `@default` / `@slow` / `@vision`) resolves through
 `modelRoles` in `.omp/config.yml`.
 
-- `tiny-fix` → `@lite` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
-  `@code` · `review-release` → `@smart`
-- Images: `@vision` only. `@code`/`@smart` cannot see images on the UNIC gateway and must never
+- `tiny-fix` → `@smol` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
+  `@default` · `review-release` → `@slow`
+- Images: `@vision` only. `@default`/`@slow` cannot see images on the UNIC gateway and must never
   guess at their contents — hand every image to `ukit-vision-analyst` first.
 
 Doing everything inline is exactly what makes UKit look like it only has one model. Keep direct
@@ -70,5 +70,6 @@ last thing you emit is one short line naming what is unfinished and what you nee
 a status — the user cannot distinguish it from a crash.
 
 > Maintainer note, not a per-turn rule: `modelRoles` in `.omp/config.yml` ships UNIC gateway names.
-> On a non-UNIC provider, edit only the three cost tiers — `lite`, `code`, `smart` — never `vision`,
-> which stays `unic-vision` because it is a capability lane, not a cost tier.
+> On a non-UNIC provider, edit only the three cost tiers — `smol`, `default`, `slow` — never `vision`,
+> which stays `unic-vision` (capability lane, not a cost tier). Old keys `lite`/`code`/`smart` remain
+> as compat aliases — edit each alias alongside its tier (smol↔lite, default↔code, slow↔smart).

package/templates/ukit/storage/config.json

@@ -147,19 +147,23 @@
     "modelTiers": {
       "lite": {
         "claudeModel": "claude-haiku-4-5",
-        "genericModel": "unic-lite"
+        "genericModel": "unic-lite",
+        "ompRole": "smol"
       },
       "code": {
         "claudeModel": "claude-sonnet-5",
-        "genericModel": "unic-code"
+        "genericModel": "unic-code",
+        "ompRole": "default"
       },
       "smart": {
         "claudeModel": "claude-opus-5",
-        "genericModel": "unic-smart"
+        "genericModel": "unic-smart",
+        "ompRole": "slow"
       },
       "vision": {
         "claudeModel": "unic-vision",
         "genericModel": "unic-vision",
+        "ompRole": "vision",
         "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."