@litfamily/litopencode 1.0.20 → 1.0.21

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.

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.20/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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.20/docs/assets/readme/badge-version.svg" alt="1.0.20" /></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.20/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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.20/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/privacy.md)
-- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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.20/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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.20/docs/assets/readme/badge-version.svg" alt="1.0.20" /></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.20/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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.20/docs/reference.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/privacy.md)
-- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/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;