@litfamily/litopencode 1.0.19 → 1.0.21

package/CHANGELOG.md

@@ -5,6 +5,20 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.21 - 2026-10-12
+
+- The README demo on GitHub is a new film of one real OpenCode turn. It plays without music, and a numbered label names each part LitOpenCode adds as it appears: the `lit` word, the status card switching to WORK, the light mode for a small fix, the reply that reads before editing, the fix with its test, the real test run and the closing summary.
+- The README now shows the LIT status card as it looks in OpenCode: quiet before the first lit prompt, bright skill chips while a request runs, and dimmed recent chips after the turn. It also walks through automatic handoff with pictures of the `lit-handoff auto` messages, the message and toast when the handoff runs, and the doctor block, in English and Korean.
+- The quick start has a short prompt to paste into a coding agent so it installs LitOpenCode for you. The agent checks the requirements, shows a dry run and asks before installing, runs `litopencode doctor`, and reminds you to restart OpenCode.
+- The LIT card along the bottom of the screen no longer stays on WORK after the agent has finished. When the session's turn ends it settles to `○ IDLE`, no step stays lit and the skill chips dim to the recent list; a subagent finishing does not change the main card, and your next prompt brings WORK back.
+- Install now asks for a reasoning effort after each model, for the lead and the helpers, and lists every effort OpenCode offers for that model with the recommended one marked as the default. GPT-6 Astra and GPT-6.1 Sol offer low to max; GPT-6 Luna, GPT-6 Sol and the GPT-5.6 models offer none to max, so GPT-5.6 Luna can now use xhigh. OpenCode offers `ultra` for no model, so it is no longer offered either. A route you saved with `ultra` keeps working as `max`, `litopencode doctor` warns about it, and the next install changes it to `max` with a one-line notice after backing up `litopencode.json`.
+- `litopencode doctor` now reads the automatic handoff setting from your project, the same place LitOpenCode itself uses, so a `lit-handoff auto on 70` sent in chat shows up in doctor. Run it from the project folder.
+- lit-pptx now installs sharp 0.35.5, and the readme-studio motion templates use sharp 0.35.5 and source-map-js 1.2.2.
+
+## 1.0.20 - 2026-10-12
+
+- The band along the bottom of OpenCode's main screen is now a small card that stays on screen for the whole session. The top edge shows LIT, the current workflow and its phase. The first row shows PLAN ━ WORK ━ REVIEW with the goal and the next task. The second row shows a chip for each LitOpenCode skill that ran: skills used by the current request are bright and get a short shine as they appear, then dim into a recent list when the answer is done, and extra chips fold into `+N`. The bottom edge shows context use, elapsed time and the git branch. Before you use lit in a session, the card shows the project's last goal. `band: false` still hides it and `band: { card: true }` still adds the detail card.
+
 ## 1.0.19 - 2026-10-11
 
 - The README is shorter for first-time readers. It says what LitOpenCode does, how to install it and what to type first, and the detail now lives in docs pages (guide, skills, screens and brand) in English and Korean. The GitHub page also plays a short film of a real session.

package/README-Ko-KR.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 # LitOpenCode
 
 **LitOpenCode는 OpenCode용 워크플로 플러그인입니다. 프롬프트에 `lit`만 붙이면 계획하고, 만들고, 확인하고, 기록까지 남겨서 다음 세션이 어디서 멈췄는지 바로 압니다.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/badge-version.svg" alt="1.0.19" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/badge-version.svg" alt="1.0.21" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="월간 npm 다운로드 수" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub 스타" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## 더 보기
 
 - [GitHub의 사용 안내](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide-Ko-KR.md): 설치 옵션, 자동 인수인계, 문제 해결, 제거
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/privacy.md)
-- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/reference.md)
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/privacy.md)
+- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>ASCII 로고 복사</summary>

package/README.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 # LitOpenCode
 
 **LitOpenCode is a workflow plugin for OpenCode. Add `lit` to a prompt and the work gets planned, built, checked and written down, so the next session knows where you stopped.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/badge-version.svg" alt="1.0.19" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/badge-version.svg" alt="1.0.21" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="npm downloads per month" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub stars" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## More
 
 - [Guide on GitHub](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide.md): install options, automatic handoff, troubleshooting and removal.
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/reference.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/privacy.md)
-- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.19/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/reference.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/privacy.md)
+- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.21/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>Copy ASCII logo</summary>

package/dist/agents/registry.js

@@ -1,7 +1,7 @@
 import { litOpenCodeDefaultAgents } from "./defaults.js";
 import { litOpenCodeSpecialistAgents } from "./specialists.js";
 import { withReaderFacingCommunicationContract } from "../reader-facing-output.js";
-import { defaultGlobalConfigFile, configSectionWasAuthored, effectiveAgentConfig } from "../config.js";
+import { defaultGlobalConfigFile, configSectionWasAuthored, effectiveAgentConfig, withRetiredEffortsReplaced } from "../config.js";
 import { defaultOpenAiRoutes, newGenerationOpenAiModels, openAiModelEfforts, openaiProviderModels } from "../cli/model-catalog.js";
 import { assertSafeEffectiveAgentRoutes } from "../model-route-policy.js";
 export const litOpenCodeAgents = Object.freeze([
@@ -190,7 +190,7 @@ function routeLeadAgent(config, authoredOverride) {
     if (hasAuthoredRouteFields(config.agents["lit-loop"]))
         return authoredOverride;
     const lead = leadCategoryRoute(config);
-    return lead === undefined ? authoredOverride : { ...authoredOverride, ...lead };
+    return lead === undefined ? authoredOverride : withRetiredEffortsReplaced({ ...authoredOverride, ...lead });
 }
 function applySpecialLeadRoute(agentTarget, agentId) {
     const existing = agentTarget[agentId];

package/dist/cli/doctor.d.ts

@@ -1,2 +1,7 @@
 import type { CliResult } from "./types.ts";
+/**
+ * The project the plugin would use from here: OpenCode's worktree is the git root above the working
+ * directory, and without one the directory itself.
+ */
+export declare function doctorProjectRoot(cwd?: string): string;
 export declare function doctor(root: string): Promise<CliResult>;

package/dist/cli/doctor.js

@@ -1,9 +1,10 @@
+import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { litOpenCodeAgents, registerLitOpenCodeAgents } from "../agents.js";
 import { defaultGlobalConfigFile, loadConfig, mergeConfigs, readLitOpenCodeConfigFile } from "../config.js";
-import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, projectModelRoutesForDiagnostics } from "../model-route-policy.js";
-import { litOpenCodeConfigFileForOpenCodeRoot } from "../state.js";
+import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, retiredEffortRoutes, retiredEffortWarning, projectModelRoutesForDiagnostics } from "../model-route-policy.js";
+import { createRuntimePaths, litOpenCodeConfigFileForOpenCodeRoot } from "../state.js";
 import { isRecord, readJsonObjectIfPresent, readPackageMetadata } from "./json.js";
 import { parseJsonc } from "./jsonc.js";
 import { inspectCommandAliases } from "./command-aliases.js";
@@ -83,6 +84,19 @@ async function inspectPlugin(root, metadata) {
         ...(openCodeConfig.error === undefined ? {} : { error: openCodeConfig.error })
     };
 }
+/**
+ * The project the plugin would use from here: OpenCode's worktree is the git root above the working
+ * directory, and without one the directory itself.
+ */
+export function doctorProjectRoot(cwd = process.cwd()) {
+    const start = path.resolve(cwd);
+    for (let dir = start;; dir = path.dirname(dir)) {
+        if (fsSync.existsSync(path.join(dir, ".git")))
+            return dir;
+        if (path.dirname(dir) === dir)
+            return start;
+    }
+}
 export async function doctor(root) {
     const metadata = await readPackageMetadata();
     const loaded = await loadConfig(root);
@@ -117,9 +131,14 @@ export async function doctor(root) {
     const tui = await inspectTuiPlugin(root, installPlugin.present && installPlugin.configured !== null ? installPlugin.configured : installPlugin.expected);
     const hostConfig = await readOpenCodeConfig(root);
     const motion = probeMotionRuntime(metadata.packageRoot);
+    // The plugin keeps the auto-handoff setting per project, so doctor reads it from the project too.
+    const project = doctorProjectRoot();
+    const projectPaths = createRuntimePaths(project);
+    const projectLitConfig = await readLitOpenCodeConfigFile(projectPaths.configFile);
+    const autoHandoffConfig = projectLitConfig === undefined ? effectiveOpenCodeConfig : mergeConfigs(effectiveOpenCodeConfig, projectLitConfig);
     const autoHandoff = await createAutoHandoffSettings({
-        stateFile: loaded.paths.autoHandoffFile,
-        config: loaded.config.autoHandoff
+        stateFile: projectPaths.autoHandoffFile,
+        config: autoHandoffConfig.autoHandoff
     }).resolve();
     const hostCompaction = inspectHostCompactionPoint(hostConfig.config);
     const autoHandoffWarnings = [...autoHandoff.warnings];
@@ -137,7 +156,8 @@ export async function doctor(root) {
                 enabled: autoHandoff.enabled,
                 percent: autoHandoff.percent,
                 sources: autoHandoff.sources,
-                stateFile: loaded.paths.autoHandoffFile,
+                project,
+                stateFile: projectPaths.autoHandoffFile,
                 env: { enabled: autoHandoffEnvEnabled, percent: autoHandoffEnvPercent },
                 host: { autoCompaction: hostCompaction.autoCompaction, compactionPercent: hostCompaction.percent },
                 compaction: "The plugin starts compaction itself after the handoff is saved; the user does not need to run /compact.",
@@ -160,7 +180,8 @@ export async function doctor(root) {
                 agents: Object.keys(effectiveOpenCodeConfig.agents),
                 categories: Object.keys(effectiveOpenCodeConfig.categories),
                 effective: projectModelRoutesForDiagnostics(reportedRoutes, routeDiagnostics),
-                routeDiagnostics
+                routeDiagnostics,
+                retiredEfforts: retiredEffortRoutes(await readJsonObjectIfPresent(openCodeLitConfigPath)).map(retiredEffortWarning)
             },
             state: {
                 runtimeDir: loaded.paths.runtimeDir,

package/dist/cli/install-config.d.ts

@@ -9,6 +9,12 @@ export declare function renderOpenCodeConfig(filePath: string, currentText: stri
 export declare function writeOpenCodeConfig(filePath: string, next: Record<string, unknown>): Promise<void>;
 export declare function readInstallModelClassification(root: string): Promise<ModelConfigClassification>;
 export declare function readInstallModelSelection(root: string): Promise<InstallModelSelection | undefined>;
+/**
+ * Rewrites saved routes that name an effort OpenCode no longer offers (ultra) to its replacement
+ * (max), after copying the file to `<file>.litopencode-backup`. Returns the one-line notice, or
+ * undefined when nothing changed. A dry run writes nothing and says nothing.
+ */
+export declare function migrateRetiredEfforts(root: string, dryRun: boolean): Promise<string | undefined>;
 export declare function assertExistingModelRoutesSafe(root: string): Promise<void>;
 export declare function describeInstallRoutes(root: string, hostConfig: Record<string, unknown> | null, selection: InstallModelSelection | undefined, permissionMode: InstallPermissionMode, permissionModeExplicit: boolean, outputStyle: string): Promise<NonNullable<InstallReport["routes"]>>;
 export declare function readExistingOutputStyle(root: string): Promise<string>;

package/dist/cli/install-config.js

@@ -3,11 +3,11 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { litOpenCodeAgents, registerLitOpenCodeAgents } from "../agents.js";
 import { defaultGlobalConfigFile, defaultGlobalConfigJson, mergeConfigs, readLitOpenCodeConfigFile } from "../config.js";
-import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, UnsafeModelRouteError } from "../model-route-policy.js";
+import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, retiredEffortRoutes, UnsafeModelRouteError } from "../model-route-policy.js";
 import { litOpenCodeConfigFileForOpenCodeRoot } from "../state.js";
 import { isRecord, readJsonObjectIfPresent, readTextIfPresent } from "./json.js";
 import { editJsoncObject, formatJsoncMember, hasJsoncComments, lineEnding } from "./jsonc.js";
-import { installModelEfforts, isModelProvider, modelMenuRows, stripFastSuffix } from "./model-catalog.js";
+import { installModelEfforts, isModelProvider, modelMenuRows, replacedRetiredEffort, stripFastSuffix } from "./model-catalog.js";
 import { classifyModelConfig, selectedLitConfig } from "./model-policy.js";
 export async function writeTextAtomically(filePath, text, overrides = {}) {
     const tempPath = path.join(path.dirname(filePath), "." + path.basename(filePath) + ".tmp-" + randomUUID());
@@ -101,6 +101,36 @@ export async function readInstallModelSelection(root) {
         return undefined;
     return { ...planning, helper: execution };
 }
+// The same suffix the TUI config backups use.
+const litConfigBackupSuffix = ".litopencode-backup";
+/**
+ * Rewrites saved routes that name an effort OpenCode no longer offers (ultra) to its replacement
+ * (max), after copying the file to `<file>.litopencode-backup`. Returns the one-line notice, or
+ * undefined when nothing changed. A dry run writes nothing and says nothing.
+ */
+export async function migrateRetiredEfforts(root, dryRun) {
+    const filePath = litOpenCodeConfigFileForOpenCodeRoot(root);
+    const existing = await readValidatedConfig(root);
+    const retired = retiredEffortRoutes(existing);
+    if (existing === null || retired.length === 0 || dryRun)
+        return undefined;
+    const next = structuredClone(existing);
+    for (const { section, id } of retired) {
+        const route = next[section][id];
+        const provider = typeof route.provider === "string" ? route.provider : undefined;
+        const model = route.model;
+        for (const field of ["variant", "reasoningEffort"]) {
+            const replacement = replacedRetiredEffort(provider, model, typeof route[field] === "string" ? route[field] : undefined);
+            if (replacement !== undefined)
+                route[field] = replacement;
+        }
+    }
+    const backup = filePath + litConfigBackupSuffix;
+    await writeTextAtomically(backup, await fs.readFile(filePath, "utf8"));
+    await writeTextAtomically(filePath, JSON.stringify(next, null, 2) + "\n");
+    const count = retired.length === 1 ? "1 route" : `${retired.length} routes`;
+    return `Moved ${count} from ultra to max, which OpenCode no longer offers; the old file is at ${backup}.`;
+}
 export async function assertExistingModelRoutesSafe(root) {
     const existing = await readValidatedConfig(root);
     if (existing === null)

package/dist/cli/install.js

@@ -7,7 +7,7 @@ import { createRuntimePaths } from "../state.js";
 import { describeCommandAliasMutation, ensureCommandAliases, inspectCommandAliases } from "./command-aliases.js";
 import { openCodeHostCapabilities } from "./host-capabilities.js";
 import { applyHostLimits, describeHostLimitMutation, ensureHostLimits } from "./host-limits.js";
-import { assertExistingModelRoutesSafe, describeInstallRoutes, describeLitConfigMutation, ensureLitConfig, OpenCodeConfigCommentError, readExistingOutputStyle, readInstallModelClassification, readInstallModelSelection, renderOpenCodeConfig, writeOpenCodeConfig } from "./install-config.js";
+import { assertExistingModelRoutesSafe, migrateRetiredEfforts, describeInstallRoutes, describeLitConfigMutation, ensureLitConfig, OpenCodeConfigCommentError, readExistingOutputStyle, readInstallModelClassification, readInstallModelSelection, renderOpenCodeConfig, writeOpenCodeConfig } from "./install-config.js";
 import { readJsonObjectIfPresent, readPackageMetadata, readTextIfPresent } from "./json.js";
 import { renderInstallReport, wrapReceiptLine } from "./install-report.js";
 import { renderLitOpenCodeWordmark } from "./install-tui.js";
@@ -215,6 +215,9 @@ async function verifyInstalledSurfaces(root, configFile, target, metadata, selec
         throw new Error("Install verification failed: " + failures.join("; "));
 }
 export async function install(root, dryRun, modelSelection = undefined, modelPrompt = "auto", permissionMode = "safe", permissionModeExplicit = false, permissionPrompt = "auto", progress, outputStylePrompt = "auto") {
+    const retiredNotice = await migrateRetiredEfforts(root, dryRun);
+    if (retiredNotice !== undefined)
+        process.stdout.write(retiredNotice + "\n");
     await assertExistingModelRoutesSafe(root);
     const classification = await readInstallModelClassification(root);
     const currentModel = await readInstallModelSelection(root);

package/dist/cli/model-catalog.d.ts

@@ -13,7 +13,7 @@ export type ProviderMenuRow = {
     readonly credentialEnv: string;
 };
 export declare const providerMenu: readonly ProviderMenuRow[];
-export declare const installModelEfforts: readonly ["low", "medium", "high", "xhigh", "max", "ultra"];
+export declare const installModelEfforts: readonly ["none", "low", "medium", "high", "xhigh", "max"];
 export declare const nativeReasoningEfforts: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
 export declare const defaultOpenAiRoutes: Readonly<{
     lead: Readonly<{
@@ -73,6 +73,11 @@ export declare const openaiProviderModels: Readonly<{
 }>;
 export declare function openAiModelRow(model: string): ModelMenuRow | undefined;
 export declare function openAiModelEfforts(model: string): readonly InstallModelEffort[];
+/**
+ * OpenCode no longer offers `ultra` for any OpenAI row. A saved route that names it on a catalog
+ * model runs as `max`, and the next install rewrites it; this returns that replacement, or undefined.
+ */
+export declare function replacedRetiredEffort(provider: string | undefined, model: string | undefined, effort: string | undefined): "max" | undefined;
 export declare function isInstallModelEffort(value: string): value is InstallModelEffort;
 export declare function openaiModelHelpLine(): string;
 export declare function shippedDefaultsSummary(): string;

package/dist/cli/model-catalog.js

@@ -6,8 +6,13 @@ export const providerMenu = [
     { provider: "openai", label: "OpenAI GPT-6 family / GPT-5.6 previous generation", credentialEnv: "OPENAI_API_KEY" },
     { provider: "xai", label: "xAI Grok", credentialEnv: "XAI_API_KEY" }
 ];
-export const installModelEfforts = Object.freeze(["low", "medium", "high", "xhigh", "max", "ultra"]);
-export const nativeReasoningEfforts = Object.freeze(["none", "minimal", ...installModelEfforts]);
+export const installModelEfforts = Object.freeze(["none", "low", "medium", "high", "xhigh", "max"]);
+// What a config file may name. Custom models are user-owned, so this stays wider than any catalog row.
+export const nativeReasoningEfforts = Object.freeze(["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"]);
+// The efforts OpenCode itself offers for each OpenAI row: the model's `variants` in
+// `opencode models openai --verbose`, checked on OpenCode 1.18.35.
+const hostEffortsWithNone = installModelEfforts;
+const hostEffortsFromLow = installModelEfforts.slice(1);
 export const defaultOpenAiRoutes = Object.freeze({
     lead: Object.freeze({ provider: "openai", model: "gpt-6-astra", effort: "xhigh" }),
     helper: Object.freeze({ provider: "openai", model: "gpt-6-luna", effort: "max" })
@@ -39,18 +44,18 @@ export const hostLimitModelIds = Object.freeze([
     defaultOpenAiRoutes.helper.model,
     previousGenerationOpenAiModels.luna
 ]);
-// The OpenAI rows are the product policy, not the host catalog. Keep every
-// supported effort here so the picker, flags, config reader, and route guard
-// all consume one catalog rather than maintaining independent literal lists.
+// The OpenAI rows choose the models and their recommended efforts; each row's
+// efforts are the host list above. The picker, flags, config reader, and route
+// guard all consume this one catalog rather than independent literal lists.
 export const openaiRows = [
-    { provider: "openai", model: defaultOpenAiRoutes.lead.model, effort: defaultOpenAiRoutes.lead.effort, efforts: installModelEfforts, hint: "frontier reasoning (recommended lead)" },
-    { provider: "openai", model: newGenerationOpenAiModels.sol, effort: "xhigh", efforts: installModelEfforts, hint: "coding lead (recommended alternative)" },
-    { provider: "openai", model: defaultOpenAiRoutes.helper.model, effort: defaultOpenAiRoutes.helper.effort, efforts: installModelEfforts.slice(0, 5), hint: "balanced (recommended helper)" },
-    { provider: "openai", model: previousGpt6OpenAiModels.sol, effort: "xhigh", efforts: installModelEfforts, hint: "coding lead, previous generation" },
-    { provider: "openai", model: previousGenerationOpenAiModels.sol, effort: "xhigh", efforts: ["high", "xhigh", "max"], hint: "deepest reasoning, previous generation" },
-    { provider: "openai", model: previousGenerationOpenAiModels.luna, effort: "max", efforts: ["high", "max"], hint: "balanced, previous generation" },
-    { provider: "openai", model: previousGenerationOpenAiModels.family, effort: "high", efforts: ["high", "xhigh", "max"], hint: "previous generation" },
-    { provider: "openai", model: previousGenerationOpenAiModels.terra, effort: "xhigh", efforts: ["high", "xhigh"], hint: "previous generation" }
+    { provider: "openai", model: defaultOpenAiRoutes.lead.model, effort: defaultOpenAiRoutes.lead.effort, efforts: hostEffortsFromLow, hint: "frontier reasoning (recommended lead)" },
+    { provider: "openai", model: newGenerationOpenAiModels.sol, effort: "xhigh", efforts: hostEffortsFromLow, hint: "coding lead (recommended alternative)" },
+    { provider: "openai", model: defaultOpenAiRoutes.helper.model, effort: defaultOpenAiRoutes.helper.effort, efforts: hostEffortsWithNone, hint: "balanced (recommended helper)" },
+    { provider: "openai", model: previousGpt6OpenAiModels.sol, effort: "xhigh", efforts: hostEffortsWithNone, hint: "coding lead, previous generation" },
+    { provider: "openai", model: previousGenerationOpenAiModels.sol, effort: "xhigh", efforts: hostEffortsWithNone, hint: "deepest reasoning, previous generation" },
+    { provider: "openai", model: previousGenerationOpenAiModels.luna, effort: "max", efforts: hostEffortsWithNone, hint: "balanced, previous generation" },
+    { provider: "openai", model: previousGenerationOpenAiModels.family, effort: "high", efforts: hostEffortsWithNone, hint: "previous generation" },
+    { provider: "openai", model: previousGenerationOpenAiModels.terra, effort: "xhigh", efforts: hostEffortsWithNone, hint: "previous generation" }
 ];
 export const openaiProviderModels = Object.freeze({
     [newGenerationOpenAiModels.astra]: Object.freeze({ name: "GPT-6 Astra", reasoning: true, temperature: false, tool_call: true }),
@@ -64,6 +69,18 @@ export function openAiModelRow(model) {
 export function openAiModelEfforts(model) {
     return openAiModelRow(model)?.efforts ?? [];
 }
+/**
+ * OpenCode no longer offers `ultra` for any OpenAI row. A saved route that names it on a catalog
+ * model runs as `max`, and the next install rewrites it; this returns that replacement, or undefined.
+ */
+export function replacedRetiredEffort(provider, model, effort) {
+    if (effort !== "ultra" || model === undefined)
+        return undefined;
+    const slash = model.indexOf("/");
+    const owner = slash > 0 ? model.slice(0, slash) : provider;
+    const id = slash > 0 ? model.slice(slash + 1) : model;
+    return owner === "openai" && openAiModelRow(stripFastSuffix(id)) !== undefined ? "max" : undefined;
+}
 export function isInstallModelEffort(value) {
     return installModelEfforts.includes(value);
 }
@@ -79,13 +96,13 @@ export function legacyFastAliasHelp() {
     return "The previous-generation GPT-5.6 rows retain their <id>-fast aliases; GPT-6 rows have no inferred -fast alias.";
 }
 export function modelEffortHelp() {
-    return `GPT-6 Astra and Sol accept ${installModelEfforts.join(", ")}; GPT-6 Luna accepts ${openAiModelEfforts(newGenerationOpenAiModels.luna).join(", ")} and rejects ultra.`;
+    return `GPT-6 Astra and GPT-6.1 Sol accept ${openAiModelEfforts(newGenerationOpenAiModels.astra).join(", ")}; GPT-6 Luna, GPT-6 Sol and the GPT-5.6 rows accept ${openAiModelEfforts(newGenerationOpenAiModels.luna).join(", ")}.`;
 }
 // Used only when the host catalog (~/.cache/opencode/models.json) is absent or unreadable.
 const fallbackXaiRows = [
     { provider: "xai", model: "grok-4.6", effort: "xhigh", efforts: ["low", "medium", "high", "xhigh"], hint: "frontier reasoning (catalog unavailable)" },
     { provider: "xai", model: "grok-4.5", effort: "high", efforts: ["low", "medium", "high"], hint: "catalog unavailable" },
-    { provider: "xai", model: "grok-4.3", effort: "high", efforts: ["low", "medium", "high"], hint: "catalog unavailable" }
+    { provider: "xai", model: "grok-4.3", effort: "high", efforts: ["none", "low", "medium", "high"], hint: "catalog unavailable" }
 ];
 const xaiRowLimit = 3;
 export function hostCatalogPath() {

package/dist/cli/model-routing.js

@@ -120,19 +120,24 @@ async function chooseProvider(reader, title, defaultProvider) {
     const index = await chooseIndex(reader, title, providerMenu.map((row) => ({ label: row.label.padEnd(35, " ") + " (" + row.provider + ")", hint: "" })), defaultIndex);
     return providerMenu[index].provider;
 }
-async function chooseRoute(reader, title, provider, defaultIndex, preferred) {
+// After a model, the role's effort: every effort the host offers for that model, the
+// recommended one marked, and the current route's effort as the default when it is still offered.
+async function chooseEffort(reader, role, row, current) {
+    const preferred = current !== undefined && row.efforts.includes(current) ? current : row.effort;
+    const index = await chooseIndex(reader, "Choose the " + role + " reasoning effort for " + row.model + ".", row.efforts.map((effort) => ({ label: effort, hint: effort === row.effort ? "recommended" : "" })), Math.max(0, row.efforts.indexOf(preferred)));
+    return row.efforts[index];
+}
+async function chooseRoute(reader, title, role, provider, defaultIndex, preferred) {
     const rows = modelMenuRows(provider);
     const preferredModel = preferred === undefined ? undefined : provider === "openai" ? stripFastSuffix(preferred.model) : preferred.model;
     const preferredIndex = preferredModel === undefined ? -1 : rows.findIndex((row) => row.model === preferredModel);
     const selectedDefault = preferredIndex >= 0 ? preferredIndex : Math.min(defaultIndex, rows.length - 1);
     const index = await chooseIndex(reader, title, rows.map((row) => ({ label: menuLabel(row), hint: row.hint })), selectedDefault);
     const row = rows[index];
-    if (preferred !== undefined &&
-        row.provider === preferred.provider &&
-        row.model === preferredModel) {
-        return preferred;
-    }
-    return { provider: row.provider, model: row.model, effort: row.effort };
+    const same = preferred !== undefined && row.provider === preferred.provider && row.model === preferredModel;
+    const effort = await chooseEffort(reader, role, row, same ? preferred.effort : undefined);
+    // An existing route keeps its exact model id (a -fast alias included).
+    return same ? { ...preferred, effort } : { provider: row.provider, model: row.model, effort };
 }
 function recommendedHelperIndex(provider) {
     return Math.max(0, modelMenuRows(provider).findIndex((row) => row.hint.includes("recommended helper")));
@@ -193,10 +198,10 @@ export async function promptModelSelection(selection, mode, dryRun, classificati
             process.stdout.write("\nExisting route (" + classification.class + ") will be rewritten in managed keys only.\n");
         }
         const leadProvider = await chooseProvider(reader, "Choose the provider for LitOpenCode agents.", preferredSelection !== undefined && isModelProvider(preferredSelection.provider) ? preferredSelection.provider : "openai");
-        const lead = await chooseRoute(reader, "Choose the LEAD model (plans and reviews).", leadProvider, 0, preferredSelection);
+        const lead = await chooseRoute(reader, "Choose the LEAD model (plans and reviews).", "LEAD", leadProvider, 0, preferredSelection);
         const preferredHelper = preferredSelection?.helper;
         const helperProvider = await chooseProvider(reader, "Choose the provider for HELPER agents (workers, explorers, librarians).", preferredHelper !== undefined && isModelProvider(preferredHelper.provider) ? preferredHelper.provider : leadProvider);
-        const helper = await chooseRoute(reader, "Choose the HELPER model (spawned and delegated agents).", helperProvider, recommendedHelperIndex(helperProvider), preferredHelper);
+        const helper = await chooseRoute(reader, "Choose the HELPER model (spawned and delegated agents).", "HELPER", helperProvider, recommendedHelperIndex(helperProvider), preferredHelper);
         const chosen = { ...lead, helper };
         process.stdout.write(renderModelRouteCard(chosen, configPath));
         await askLine(reader, "");

package/dist/cli/types.d.ts

@@ -54,7 +54,7 @@ export type InstallModelRoute = {
 export type InstallModelSelection = InstallModelRoute & {
     readonly helper?: InstallModelRoute;
 };
-export type InstallModelEffort = "low" | "medium" | "high" | "xhigh" | "max" | "ultra";
+export type InstallModelEffort = "none" | "low" | "medium" | "high" | "xhigh" | "max";
 export type ModelConfigClass = "fresh" | "managed_legacy" | "gpt56_managed" | "astra_managed" | "gpt56_other" | "custom" | "mixed";
 export type ModelConfigClassification = {
     readonly class: ModelConfigClass;

package/dist/config.d.ts

@@ -74,4 +74,6 @@ export declare function mergeConfigs(base: LitOpenCodeConfig, override: Partial<
 export declare function defaultGlobalConfigFile(): LitOpenCodeConfig;
 export declare function defaultGlobalConfigJson(): Record<string, unknown>;
 export declare function effectiveAgentConfig(config: LitOpenCodeConfig, agentId: string): LitOpenCodeAgentModelConfig;
+/** A saved route on an effort OpenCode no longer offers runs as its replacement until install rewrites it. */
+export declare function withRetiredEffortsReplaced(route: LitOpenCodeAgentModelConfig): LitOpenCodeAgentModelConfig;
 export declare function loadConfig(projectRoot: string): Promise<LoadedConfig>;

package/dist/config.js

@@ -1,6 +1,6 @@
 import { createRuntimePaths } from "./state.js";
 import { readLitOpenCodeConfigFile } from "./config-parser.js";
-import { defaultOpenAiRoutes } from "./cli/model-catalog.js";
+import { defaultOpenAiRoutes, replacedRetiredEffort } from "./cli/model-catalog.js";
 export { LitOpenCodeConfigError, readLitOpenCodeConfigFile } from "./config-parser.js";
 // The runtime receives a merged config, so keep source ownership alongside
 // (rather than inside) the JSON-shaped config. This never serializes into a
@@ -140,7 +140,15 @@ export function defaultGlobalConfigJson() {
 export function effectiveAgentConfig(config, agentId) {
     const agentConfig = config.agents[agentId] ?? {};
     const categoryConfig = agentConfig.category ? config.categories[agentConfig.category] : undefined;
-    return mergeAgentModelConfig(categoryConfig, agentConfig);
+    return withRetiredEffortsReplaced(mergeAgentModelConfig(categoryConfig, agentConfig));
+}
+/** A saved route on an effort OpenCode no longer offers runs as its replacement until install rewrites it. */
+export function withRetiredEffortsReplaced(route) {
+    const variant = replacedRetiredEffort(route.provider, route.model, route.variant);
+    const reasoningEffort = replacedRetiredEffort(route.provider, route.model, route.reasoningEffort);
+    if (variant === undefined && reasoningEffort === undefined)
+        return route;
+    return { ...route, ...(variant === undefined ? {} : { variant }), ...(reasoningEffort === undefined ? {} : { reasoningEffort }) };
 }
 export async function loadConfig(projectRoot) {
     const paths = createRuntimePaths(projectRoot);

package/dist/model-route-policy.d.ts

@@ -1,7 +1,7 @@
 import { type LitOpenCodeAgentModelConfig, type LitOpenCodeConfig } from "./config.ts";
 export type ModelRouteDiagnostic = {
     readonly agentId: string;
-    readonly code: "luna_effort_below_high" | "luna_xhigh_forbidden" | "luna_effort_conflict" | "terra_effort_below_high" | "terra_effort_conflict" | "astra_effort_unsupported" | "astra_effort_conflict" | "model_effort_unsupported" | "model_effort_conflict";
+    readonly code: "astra_effort_unsupported" | "astra_effort_conflict" | "model_effort_unsupported" | "model_effort_conflict";
     readonly model: string;
     readonly effort: string;
 };
@@ -23,3 +23,11 @@ export declare class UnsafeModelRouteError extends Error {
     constructor(diagnostics: readonly ModelRouteDiagnostic[]);
 }
 export declare function assertSafeEffectiveAgentRoutes(config: LitOpenCodeConfig, agentIds: readonly string[]): void;
+export type RetiredEffortRoute = {
+    readonly section: "categories" | "agents";
+    readonly id: string;
+    readonly model: string;
+};
+/** The saved routes in a litopencode.json object that still name an effort OpenCode no longer offers. */
+export declare function retiredEffortRoutes(config: unknown): readonly RetiredEffortRoute[];
+export declare function retiredEffortWarning(route: RetiredEffortRoute): string;