@litfamily/litopencode 1.0.4 → 1.0.5

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

@@ -13,6 +13,62 @@ 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 nativeReasoningEfforts: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+export declare const defaultOpenAiRoutes: Readonly<{
+    lead: Readonly<{
+        provider: "openai";
+        model: "gpt-6-astra";
+        effort: "xhigh";
+    }>;
+    helper: Readonly<{
+        provider: "openai";
+        model: "gpt-6-luna";
+        effort: "max";
+    }>;
+}>;
+export declare const newGenerationOpenAiModels: Readonly<{
+    readonly astra: "gpt-6-astra";
+    readonly sol: "gpt-6-sol";
+    readonly luna: "gpt-6-luna";
+}>;
+export declare const previousGenerationOpenAiModels: Readonly<{
+    readonly sol: "gpt-5.6-sol";
+    readonly terra: "gpt-5.6-terra";
+    readonly luna: "gpt-5.6-luna";
+    readonly family: "gpt-5.6";
+}>;
+export declare const legacyManagedModelIds: readonly ["gpt-5.4", "gpt-5.5"];
+export declare const legacyFastAliasModels: readonly ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.6"];
+export declare const hostLimitModelIds: readonly ["gpt-6-luna", "gpt-5.6-luna"];
+export declare const openaiRows: readonly ModelMenuRow[];
+export declare const openaiProviderModels: Readonly<{
+    "gpt-6-astra": Readonly<{
+        name: "GPT-6 Astra";
+        reasoning: true;
+        temperature: false;
+        tool_call: true;
+    }>;
+    "gpt-6-sol": Readonly<{
+        name: "GPT-6 Sol";
+        reasoning: true;
+        temperature: false;
+        tool_call: true;
+    }>;
+    "gpt-6-luna": Readonly<{
+        name: "GPT-6 Luna";
+        reasoning: true;
+        temperature: false;
+        tool_call: true;
+    }>;
+}>;
+export declare function openAiModelRow(model: string): ModelMenuRow | undefined;
+export declare function openAiModelEfforts(model: string): readonly InstallModelEffort[];
+export declare function isInstallModelEffort(value: string): value is InstallModelEffort;
+export declare function openaiModelHelpLine(): string;
+export declare function shippedDefaultsSummary(): string;
+export declare function legacyFastAliasHelp(): string;
+export declare function modelEffortHelp(): string;
 export declare function hostCatalogPath(): string;
 export declare function modelMenuRows(provider: ModelProvider): readonly ModelMenuRow[];
 export declare function isModelProvider(value: string): value is ModelProvider;

package/dist/cli/model-catalog.js

@@ -3,20 +3,77 @@ import os from "node:os";
 import path from "node:path";
 import { isRecord } from "./json.js";
 export const providerMenu = [
-    { provider: "openai", label: "OpenAI GPT-6 Astra / GPT-5.6 family", credentialEnv: "OPENAI_API_KEY" },
+    { 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" }
 ];
-const effortRank = ["low", "medium", "high", "xhigh", "max"];
-// The OpenAI rows are the product policy, not the host catalog. Astra is
-// reasoning-only: all five host-supported effort names are carried through
-// the native `variant`/`reasoningEffort` fields.
-const openaiRows = [
-    { provider: "openai", model: "gpt-6-astra", effort: "xhigh", efforts: ["low", "medium", "high", "xhigh", "max"], hint: "frontier reasoning (recommended lead)" },
-    { provider: "openai", model: "gpt-5.6-sol", effort: "xhigh", efforts: ["high", "xhigh", "max"], hint: "deepest reasoning, slowest (legacy lead)" },
-    { provider: "openai", model: "gpt-5.6-luna", effort: "max", efforts: ["high", "max"], hint: "balanced (recommended helper)" },
-    { provider: "openai", model: "gpt-5.6", effort: "high", efforts: ["high", "xhigh", "max"], hint: "" },
-    { provider: "openai", model: "gpt-5.6-terra", effort: "xhigh", efforts: ["high", "xhigh"], hint: "" }
+export const installModelEfforts = Object.freeze(["low", "medium", "high", "xhigh", "max", "ultra"]);
+export const nativeReasoningEfforts = Object.freeze(["none", "minimal", ...installModelEfforts]);
+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" })
+});
+export const newGenerationOpenAiModels = Object.freeze({
+    astra: defaultOpenAiRoutes.lead.model,
+    sol: "gpt-6-sol",
+    luna: defaultOpenAiRoutes.helper.model
+});
+export const previousGenerationOpenAiModels = Object.freeze({
+    sol: "gpt-5.6-sol",
+    terra: "gpt-5.6-terra",
+    luna: "gpt-5.6-luna",
+    family: "gpt-5.6"
+});
+export const legacyManagedModelIds = Object.freeze(["gpt-5.4", "gpt-5.5"]);
+export const legacyFastAliasModels = Object.freeze([
+    previousGenerationOpenAiModels.sol,
+    previousGenerationOpenAiModels.terra,
+    previousGenerationOpenAiModels.luna,
+    previousGenerationOpenAiModels.family
+]);
+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.
+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: 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" }
 ];
+export const openaiProviderModels = Object.freeze({
+    [newGenerationOpenAiModels.astra]: Object.freeze({ name: "GPT-6 Astra", reasoning: true, temperature: false, tool_call: true }),
+    [newGenerationOpenAiModels.sol]: Object.freeze({ name: "GPT-6 Sol", reasoning: true, temperature: false, tool_call: true }),
+    [newGenerationOpenAiModels.luna]: Object.freeze({ name: "GPT-6 Luna", reasoning: true, temperature: false, tool_call: true })
+});
+export function openAiModelRow(model) {
+    return openaiRows.find((row) => row.model === model);
+}
+export function openAiModelEfforts(model) {
+    return openAiModelRow(model)?.efforts ?? [];
+}
+export function isInstallModelEffort(value) {
+    return installModelEfforts.includes(value);
+}
+export function openaiModelHelpLine() {
+    return openaiRows
+        .map((row) => `${row.model}·${row.effort} (${row.efforts.join("/")})`)
+        .join(", ");
+}
+export function shippedDefaultsSummary() {
+    return `GPT-6 Astra/${defaultOpenAiRoutes.lead.effort} lead + planning/review; GPT-6 Luna/${defaultOpenAiRoutes.helper.effort} execution/research helpers`;
+}
+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.`;
+}
 // 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)" },
@@ -30,7 +87,7 @@ export function hostCatalogPath() {
     return path.join(base, "opencode", "models.json");
 }
 function isEffort(value) {
-    return typeof value === "string" && effortRank.includes(value);
+    return typeof value === "string" && isInstallModelEffort(value);
 }
 function catalogEfforts(entry) {
     if (!Array.isArray(entry.reasoning_options))
@@ -43,7 +100,7 @@ function catalogEfforts(entry) {
             if (isEffort(value) && !values.includes(value))
                 values.push(value);
     }
-    return values.sort((left, right) => effortRank.indexOf(left) - effortRank.indexOf(right));
+    return values.sort((left, right) => installModelEfforts.indexOf(left) - installModelEfforts.indexOf(right));
 }
 function xaiRowsFromCatalog() {
     let parsed;
@@ -84,10 +141,14 @@ export function isModelProvider(value) {
 export function providerCredentialEnv(provider) {
     return providerMenu.find((row) => row.provider === provider)?.credentialEnv;
 }
-// OpenCode exposes `<id>-fast` as a priority-tier alias for legacy OpenAI
-// rows; Astra has no inferred `-fast` alias and remains an exact model id.
+// OpenCode exposes `<id>-fast` as a priority-tier alias for previous-generation
+// OpenAI rows; GPT-6 rows remain exact model ids.
 export function stripFastSuffix(model) {
-    return model !== "gpt-6-astra-fast" && model.endsWith("-fast") ? model.slice(0, -"-fast".length) : model;
+    return legacyFastAliasModels.includes(model)
+        ? model
+        : model.endsWith("-fast") && legacyFastAliasModels.includes(model.slice(0, -"-fast".length))
+            ? model.slice(0, -"-fast".length)
+            : model;
 }
 export function resolveModelRoute(provider, model, effort, optionName) {
     if (!isModelProvider(provider)) {
@@ -99,7 +160,7 @@ export function resolveModelRoute(provider, model, effort, optionName) {
         throw new Error(optionName + " model " + provider + "/" + model + " is not offered; choose one of " + rows.map((candidate) => candidate.model).join(", "));
     }
     if (effort !== undefined && !row.efforts.includes(effort)) {
-        if (row.model === "gpt-5.6-luna")
+        if (row.model === previousGenerationOpenAiModels.luna)
             throw new Error("Luna effort must be high or max");
         throw new Error(provider + "/" + model + " accepts effort " + row.efforts.join(", ") + " (got " + effort + ")");
     }

package/dist/cli/model-policy.js

@@ -1,11 +1,12 @@
 import { defaultGlobalConfigJson } from "../config.js";
 import { isRecord } from "./json.js";
+import { defaultOpenAiRoutes, legacyManagedModelIds, openAiModelEfforts, previousGenerationOpenAiModels } from "./model-catalog.js";
 const categoryIds = ["planning", "execution", "review", "research"];
 const leadCategoryIds = new Set(["planning", "review"]);
-const canonicalModels = new Set(["gpt-5.6-luna"]);
-const legacyModels = new Set(["gpt-5.4", "gpt-5.5"]);
-const offeredEfforts = new Set(["medium", "high", "max"]);
-const astraEfforts = new Set(["low", "medium", "high", "xhigh", "max"]);
+const canonicalModels = new Set([defaultOpenAiRoutes.helper.model, previousGenerationOpenAiModels.luna]);
+const offeredEfforts = new Set(openAiModelEfforts(previousGenerationOpenAiModels.luna));
+const astraEfforts = new Set(openAiModelEfforts(defaultOpenAiRoutes.lead.model));
+const legacyModels = new Set(legacyManagedModelIds);
 const managedLegacyRouteKeys = new Set(["provider", "model", "variant", "textVerbosity"]);
 function normalizedRoute(value) {
     if (!isRecord(value) || typeof value.model !== "string")
@@ -93,7 +94,7 @@ export function classifyModelConfig(rawConfig) {
     if (first.qualifiedModel)
         return result("custom", first.dispatchId);
     if (first.provider === "openai" &&
-        first.model === "gpt-6-astra" &&
+        first.model === defaultOpenAiRoutes.lead.model &&
         first.variant !== undefined &&
         astraEfforts.has(first.variant)) {
         return result("astra_managed", first.dispatchId);
@@ -103,7 +104,7 @@ export function classifyModelConfig(rawConfig) {
         (first.variant === undefined || offeredEfforts.has(first.variant))) {
         return result("gpt56_managed", first.dispatchId);
     }
-    if (first.provider === "openai" && /^gpt-5\.6(?:$|-)/u.test(first.model)) {
+    if (first.provider === "openai" && (first.model === previousGenerationOpenAiModels.family || first.model.startsWith(previousGenerationOpenAiModels.family + "-"))) {
         return result("gpt56_other", first.dispatchId);
     }
     return result("custom", first.dispatchId);

package/dist/cli/types.d.ts

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

package/dist/cli.js

@@ -6,6 +6,7 @@ import { createInstallTui, renderLitOpenCodeWordmark, shouldRenderInstallTui } f
 import { runUpdateNotifier } from "./cli/update-notifier.js";
 import { autoUpdateDiagnostic, canContinueAfterAutoUpdate, runInteractiveAutoUpdate } from "./cli/auto-update.js";
 import { LitOpenCodeConfigError } from "./config.js";
+import { defaultOpenAiRoutes, legacyFastAliasHelp, modelEffortHelp, openaiModelHelpLine, shippedDefaultsSummary } from "./cli/model-catalog.js";
 import { fetchPublicSource } from "./lit-fetch.js";
 import { readPackageMetadata } from "./cli/json.js";
 import path from "node:path";
@@ -22,9 +23,9 @@ function helpText() {
         "  npm exec --package @litfamily/litopencode -- litopencode install --permission-prompt",
         "  npm exec --package @litfamily/litopencode -- litopencode install --permission-mode balanced",
         "  npm exec --package @litfamily/litopencode -- litopencode install --yolo",
-        "  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model gpt-6-astra --effort xhigh",
-        "  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model gpt-5.6-luna --effort max",
-        "  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model gpt-5.6-luna --effort high",
+        `  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model ${defaultOpenAiRoutes.lead.model} --effort ${defaultOpenAiRoutes.lead.effort}`,
+        `  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model ${defaultOpenAiRoutes.helper.model} --effort ${defaultOpenAiRoutes.helper.effort}`,
+        `  npm exec --package @litfamily/litopencode -- litopencode install --provider openai --model ${defaultOpenAiRoutes.helper.model} --effort high`,
         "",
         "Usage:",
         "  litopencode install [--dry-run] [--root <dir>] --provider <openai|xai> --model <id> [--effort <e>] [--subagent-model <provider/id>] [--subagent-effort <e>] [--yolo]",
@@ -84,12 +85,12 @@ function helpText() {
         "Model routing:",
         "  Interactive terminal installs ask provider (openai | xai), LEAD model (planning/review) and HELPER model (execution/research),",
         "  preselecting the current managed route; --yes and --no-model-prompt keep the current non-picker behavior.",
-        "  openai rows: gpt-6-astra·xhigh (low/medium/high/xhigh/max), gpt-5.6-sol·xhigh, gpt-5.6-luna·max, gpt-5.6·high, gpt-5.6-terra·xhigh.",
-        "  The legacy GPT-5.6 rows retain their <id>-fast aliases; gpt-6-astra-fast is not a model alias.",
+        "  openai rows: " + openaiModelHelpLine() + ".",
+        "  " + legacyFastAliasHelp(),
         "  xai rows: reasoning-capable Grok models from the host catalog, grok-4.6 first; XAI_API_KEY is warned about, never required.",
         "  --provider <p> --model <id> [--effort <e>] writes the lead route; --subagent-model <provider/id> [--subagent-effort <e>] the helper route.",
-        "  Astra accepts low, medium, high, xhigh, or max and uses native reasoning effort; LUNA accepts high or max and rejects xhigh.",
-        "  Without flags/reset, planning and review (including lit-loop) use Astra/xhigh; execution and research helpers use LUNA/max.",
+        "  " + modelEffortHelp(),
+        "  Without flags/reset, planning and review (including lit-loop) use Astra/xhigh; execution and research helpers use GPT-6 Luna/max.",
         "  --model-prompt forces the picker on any existing route (managed keys only); --no-model-prompt and --yes keep current model routes.",
         "",
         "Permission behavior:",

package/dist/config-parser.js

@@ -1,4 +1,5 @@
 import fs from "node:fs/promises";
+import { nativeReasoningEfforts } from "./cli/model-catalog.js";
 export class LitOpenCodeConfigError extends Error {
     constructor(message) {
         super(message);
@@ -8,7 +9,7 @@ export class LitOpenCodeConfigError extends Error {
 const logLevels = new Set(["silent", "error", "info", "debug"]);
 const permissionModes = new Set(["safe", "balanced", "yolo"]);
 const outputStyleIds = new Set(["off", "asd-ste100", "asd-ste100-ko", "eli5", "eli5-ko"]);
-const reasoningEfforts = new Set(["none", "minimal", "low", "medium", "high", "xhigh", "max"]);
+const reasoningEfforts = new Set(nativeReasoningEfforts);
 const textVerbosities = new Set(["low", "medium", "high"]);
 const toolIds = new Set(["read", "write", "edit", "bash", "webfetch", "grep"]);
 const permissions = new Set(["ask", "allow", "deny"]);
@@ -87,7 +88,7 @@ function optionalReasoningEffort(value, filePath, field) {
     if (value === undefined || value === null)
         return undefined;
     if (typeof value !== "string" || !reasoningEfforts.has(value)) {
-        throw new LitOpenCodeConfigError(`Malformed LitOpenCode config at ${filePath}: ${field} must be one of none, minimal, low, medium, high, xhigh, max.`);
+        throw new LitOpenCodeConfigError(`Malformed LitOpenCode config at ${filePath}: ${field} must be one of ${nativeReasoningEfforts.join(", ")}.`);
     }
     return value;
 }

package/dist/config.d.ts

@@ -4,7 +4,7 @@ export { LitOpenCodeConfigError, readLitOpenCodeConfigFile } from "./config-pars
 export type LogLevel = "silent" | "error" | "info" | "debug";
 export type LitOpenCodeConfigSource = "defaults" | "global" | "project" | "merged";
 export type LitOpenCodePermissionMode = "safe" | "balanced" | "yolo";
-export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra";
 export type TextVerbosity = "low" | "medium" | "high";
 export type BoundedAuthorityConfig = {
     readonly maxEvents: number;

package/dist/config.js

@@ -1,5 +1,6 @@
 import { createRuntimePaths } from "./state.js";
 import { readLitOpenCodeConfigFile } from "./config-parser.js";
+import { defaultOpenAiRoutes } 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
@@ -23,27 +24,27 @@ export const defaultConfig = Object.freeze({
     knowledge: Object.freeze({ capture: true }),
     categories: Object.freeze({
         planning: Object.freeze({
-            provider: "openai",
-            model: "gpt-6-astra",
-            variant: "xhigh",
+            provider: defaultOpenAiRoutes.lead.provider,
+            model: defaultOpenAiRoutes.lead.model,
+            variant: defaultOpenAiRoutes.lead.effort,
             textVerbosity: "medium"
         }),
         execution: Object.freeze({
-            provider: "openai",
-            model: "gpt-5.6-luna",
-            variant: "max",
+            provider: defaultOpenAiRoutes.helper.provider,
+            model: defaultOpenAiRoutes.helper.model,
+            variant: defaultOpenAiRoutes.helper.effort,
             textVerbosity: "medium"
         }),
         review: Object.freeze({
-            provider: "openai",
-            model: "gpt-6-astra",
-            variant: "xhigh",
+            provider: defaultOpenAiRoutes.lead.provider,
+            model: defaultOpenAiRoutes.lead.model,
+            variant: defaultOpenAiRoutes.lead.effort,
             textVerbosity: "medium"
         }),
         research: Object.freeze({
-            provider: "openai",
-            model: "gpt-5.6-luna",
-            variant: "max",
+            provider: defaultOpenAiRoutes.helper.provider,
+            model: defaultOpenAiRoutes.helper.model,
+            variant: defaultOpenAiRoutes.helper.effort,
             textVerbosity: "medium"
         })
     }),

package/dist/features.d.ts

@@ -1,5 +1,5 @@
 export type LitOpenCodeBindingKind = "agent" | "cli" | "command" | "config" | "hook" | "tool";
-export type LitOpenCodeFeatureId = "planning-start-work-loop" | "lit-litwork-activation" | "start-work" | "review-work" | "litresearch" | "durable-ledger" | "bounded-authority-lifecycle" | "agent-roster" | "lit-plan" | "reference-benchmark-claims" | "native-goal-verdict" | "doctor-install" | "search-workflow-ideas" | "lit-fetch" | "guardrails" | "lit-init" | "lit-crucible" | "refactor" | "lit-burnoff" | "lit-burnoff-file" | "comment-checker" | "lit-code" | "debugging" | "lit-commit" | "lsp" | "lsp-setup" | "rules" | "deep-interview" | "structural-search" | "browser-drive" | "lit-korean" | "lit-recap" | "lit-comprehend" | "lit-handoff" | "lit-scientific-visualization" | "frontend-ui-ux" | "visual-qa" | "autoresearch" | "autoconference" | "wikify";
+export type LitOpenCodeFeatureId = "planning-start-work-loop" | "lit-litwork-activation" | "start-work" | "review-work" | "litresearch" | "durable-ledger" | "bounded-authority-lifecycle" | "agent-roster" | "lit-plan" | "reference-benchmark-claims" | "native-goal-verdict" | "doctor-install" | "search-workflow-ideas" | "lit-fetch" | "guardrails" | "lit-init" | "lit-crucible" | "refactor" | "lit-burnoff" | "lit-burnoff-file" | "comment-checker" | "lit-code" | "debugging" | "lit-commit" | "lsp" | "lsp-setup" | "rules" | "deep-interview" | "structural-search" | "browser-drive" | "lit-korean" | "lit-recap" | "lit-comprehend" | "lit-handoff" | "lit-scientific-visualization" | "readme-studio" | "frontend-ui-ux" | "visual-qa" | "autoresearch" | "autoconference" | "wikify";
 export type LitOpenCodeFeatureBinding = {
     readonly kind: LitOpenCodeBindingKind;
     readonly id: string;
@@ -803,5 +803,21 @@ export declare const litOpenCodeFeatures: readonly ({
         description: string;
     })[];
     verification: string[];
+} | {
+    id: "readme-studio";
+    title: string;
+    summary: string;
+    bindings: ({
+        kind: "config";
+        id: string;
+        surface: string;
+        description: string;
+    } | {
+        kind: "cli";
+        id: string;
+        surface: string;
+        description: string;
+    })[];
+    verification: string[];
 })[];
 export declare function findLitOpenCodeFeature(id: string): LitOpenCodeFeature | undefined;

package/dist/features.js

@@ -1059,6 +1059,16 @@ export const litOpenCodeFeatures = Object.freeze([
         verification: ["node --test test/lit-scientific-visualization.test.mjs", "npm run check:pack-payload"]
     },
     frontendUiUxFeature,
+    {
+        id: "readme-studio", title: "README Studio",
+        summary: "Native-installed README production, safe local typography and portable motion assets.",
+        bindings: [
+            { kind: "config", id: "skills/readme-studio/SKILL.md", surface: "OpenCode native skill readme-studio", description: "Loads fact discovery, capability branches and task-local composition recipes." },
+            { kind: "cli", id: "litopencode install", surface: "LitOpenCode native skill installer", description: "Copies all hash-pinned nested resources." },
+            { kind: "cli", id: "litopencode doctor", surface: "LitOpenCode native skill doctor", description: "Rejects missing or altered resources." }
+        ],
+        verification: ["node --test test/runtime-skills.test.mjs test/cli-install-surface.test.mjs test/packed-artifact.test.mjs", "npm run check:managed-skill-manifest"]
+    },
     visualQaFeature
 ]);
 export function findLitOpenCodeFeature(id) {

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";
+    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 model: string;
     readonly effort: string;
 };

package/dist/model-route-policy.js

@@ -1,7 +1,8 @@
 import { effectiveAgentConfig } from "./config.js";
-const safeLunaEfforts = new Set(["high", "max"]);
-const safeTerraEfforts = new Set(["high", "xhigh"]);
-const safeAstraEfforts = new Set(["low", "medium", "high", "xhigh", "max"]);
+import { defaultOpenAiRoutes, newGenerationOpenAiModels, openAiModelEfforts, previousGenerationOpenAiModels, stripFastSuffix } from "./cli/model-catalog.js";
+const safeLunaEfforts = new Set(openAiModelEfforts(previousGenerationOpenAiModels.luna));
+const safeTerraEfforts = new Set(openAiModelEfforts(previousGenerationOpenAiModels.terra));
+const safeAstraEfforts = new Set(openAiModelEfforts(defaultOpenAiRoutes.lead.model));
 function dispatchedModel(route) {
     if (route.model === undefined)
         return undefined;
@@ -12,7 +13,7 @@ function dispatchedModel(route) {
 export function unqualifiedModel(dispatchId) {
     const separator = dispatchId.lastIndexOf("/");
     const model = separator === -1 ? dispatchId : dispatchId.slice(separator + 1);
-    return model !== "gpt-6-astra-fast" && model.endsWith("-fast") ? model.slice(0, -"-fast".length) : model;
+    return stripFastSuffix(model);
 }
 function dispatchedProvider(dispatchId) {
     const separator = dispatchId.indexOf("/");
@@ -41,7 +42,7 @@ export function diagnoseModelRoutes(routes) {
             continue;
         const modelId = unqualifiedModel(model);
         const effort = describedEffort(route);
-        if (modelId === "gpt-6-astra") {
+        if (modelId === newGenerationOpenAiModels.astra) {
             const variantUnsafe = route.variant !== undefined && !safeAstraEfforts.has(route.variant);
             const reasoningUnsafe = route.reasoningEffort !== undefined && !safeAstraEfforts.has(route.reasoningEffort);
             if (variantUnsafe || reasoningUnsafe || (route.variant === undefined && route.reasoningEffort === undefined)) {
@@ -52,7 +53,19 @@ export function diagnoseModelRoutes(routes) {
             }
             continue;
         }
-        if (modelId === "gpt-5.6-luna") {
+        if (modelId === newGenerationOpenAiModels.sol || modelId === newGenerationOpenAiModels.luna) {
+            const supported = new Set(openAiModelEfforts(modelId));
+            const variantUnsafe = route.variant !== undefined && !supported.has(route.variant);
+            const reasoningUnsafe = route.reasoningEffort !== undefined && !supported.has(route.reasoningEffort);
+            if (variantUnsafe || reasoningUnsafe || (route.variant === undefined && route.reasoningEffort === undefined)) {
+                diagnostics.push({ agentId, code: "model_effort_unsupported", model, effort });
+            }
+            if (route.variant !== undefined && route.reasoningEffort !== undefined && route.variant !== route.reasoningEffort) {
+                diagnostics.push({ agentId, code: "model_effort_conflict", model, effort });
+            }
+            continue;
+        }
+        if (modelId === previousGenerationOpenAiModels.luna) {
             const hasXhigh = route.variant === "xhigh" || route.reasoningEffort === "xhigh";
             if ((route.variant !== undefined && route.variant !== "xhigh" && !safeLunaEfforts.has(route.variant)) ||
                 (route.reasoningEffort !== undefined && route.reasoningEffort !== "xhigh" && !safeLunaEfforts.has(route.reasoningEffort)) ||
@@ -66,7 +79,7 @@ export function diagnoseModelRoutes(routes) {
             }
             continue;
         }
-        if (modelId !== "gpt-5.6-terra")
+        if (modelId !== previousGenerationOpenAiModels.terra)
             continue;
         if ((route.variant !== undefined && !safeTerraEfforts.has(route.variant)) ||
             (route.reasoningEffort !== undefined && !safeTerraEfforts.has(route.reasoningEffort)) ||
@@ -115,6 +128,10 @@ export class UnsafeModelRouteError extends Error {
                     return `${diagnostic.agentId}: Astra requires low, medium, high, xhigh, or max (${diagnostic.model}, ${diagnostic.effort})`;
                 case "astra_effort_conflict":
                     return `${diagnostic.agentId}: Astra effort fields conflict (${diagnostic.model}, ${diagnostic.effort})`;
+                case "model_effort_unsupported":
+                    return `${diagnostic.agentId}: ${diagnostic.model} accepts a supported catalog effort (${diagnostic.model}, ${diagnostic.effort})`;
+                case "model_effort_conflict":
+                    return `${diagnostic.agentId}: ${diagnostic.model} effort fields conflict (${diagnostic.model}, ${diagnostic.effort})`;
             }
         })
             .join("; ");

package/dist/skills.d.ts

@@ -1,5 +1,5 @@
 import type { LitOpenCodeFeatureId } from "./features.ts";
-export type LitOpenCodeRuntimeSkillId = "workflow-loop" | "durable-litgoal" | "agent-roster" | "lit-plan" | "start-work" | "review-work" | "litresearch" | "reference-benchmark-claims" | "native-goal-verdict" | "doctor-installer" | "search-workflow-ideas" | "lit-fetch" | "release-guardrails" | "lit-init" | "lit-crucible" | "refactor" | "lit-burnoff" | "lit-burnoff-file" | "comment-checker" | "lit-code" | "debugging" | "lit-commit" | "lsp" | "lsp-setup" | "rules" | "deep-interview" | "structural-search" | "browser-drive" | "lit-korean" | "lit-recap" | "lit-comprehend" | "lit-handoff" | "lit-scientific-visualization" | "frontend-ui-ux" | "visual-qa" | "autoresearch" | "autoconference" | "wikify";
+export type LitOpenCodeRuntimeSkillId = "workflow-loop" | "durable-litgoal" | "agent-roster" | "lit-plan" | "start-work" | "review-work" | "litresearch" | "reference-benchmark-claims" | "native-goal-verdict" | "doctor-installer" | "search-workflow-ideas" | "lit-fetch" | "release-guardrails" | "lit-init" | "lit-crucible" | "refactor" | "lit-burnoff" | "lit-burnoff-file" | "comment-checker" | "lit-code" | "debugging" | "lit-commit" | "lsp" | "lsp-setup" | "rules" | "deep-interview" | "structural-search" | "browser-drive" | "lit-korean" | "lit-recap" | "lit-comprehend" | "lit-handoff" | "lit-scientific-visualization" | "readme-studio" | "frontend-ui-ux" | "visual-qa" | "autoresearch" | "autoconference" | "wikify";
 export type LitOpenCodeRuntimeSkill = {
     readonly id: LitOpenCodeRuntimeSkillId;
     readonly title: string;
@@ -282,6 +282,13 @@ export declare const litOpenCodeRuntimeSkills: readonly ({
     featureIds: ("planning-start-work-loop" | "litresearch" | "wikify")[];
     discovery: string;
     safety: string[];
+} | {
+    id: "readme-studio";
+    title: string;
+    summary: string;
+    featureIds: ("doctor-install" | "readme-studio")[];
+    discovery: string;
+    safety: string[];
 })[];
 export declare function findLitOpenCodeRuntimeSkill(id: string): LitOpenCodeRuntimeSkill | undefined;
 export declare const litOpenCodeStaticOnlySkills: readonly ({

package/dist/skills.js

@@ -411,6 +411,14 @@ export const litOpenCodeRuntimeSkills = Object.freeze([
         ]
     },
     frontendUiUxRuntimeSkill,
+    {
+        id: "readme-studio",
+        title: "README Studio",
+        summary: "Build factual READMEs and inspected hybrid covers with local outlined type and pinned motion recipes.",
+        featureIds: ["readme-studio", "doctor-install"],
+        discovery: "Select readme-studio using OpenCode's native skill tool; install copies its managed resources and doctor verifies them. No slash or automatic chat route is claimed.",
+        safety: ["Honor review-only and plan-only requests without edits.", "Probe native image capability; report IMAGE_GENERATION_UNAVAILABLE, then accept a supplied background without claiming generation.", "Verify facts, font licenses, glyph coverage, output boundaries and actual renders; public README rendering remains separately gated."]
+    },
     visualQaRuntimeSkill
 ]);
 export function findLitOpenCodeRuntimeSkill(id) {

package/dist/uiux-visual-catalog.js

@@ -1,7 +1,7 @@
 export const frontendUiUxFeature = {
     id: "frontend-ui-ux",
     title: "Frontend UI/UX",
-    summary: "Provides a native-installed, offline, read-only Design Contract workflow with deterministic packaged design intelligence.",
+    summary: "Builds and inspects authorized interfaces using an evolving beta2 contract and offline design intelligence.",
     bindings: [
         {
             kind: "config",
@@ -75,16 +75,16 @@ export const visualQaFeature = {
 export const frontendUiUxRuntimeSkill = {
     id: "frontend-ui-ux",
     title: "Frontend UI/UX",
-    summary: "Create a finite evidence-eligible v1beta2 Design Contract with deterministic offline design intelligence before approved implementation.",
+    summary: "Produce working interfaces and rendered inspection from an authorized brief; evolve the evidence-eligible v1beta2 Design Contract as decisions settle.",
     featureIds: ["frontend-ui-ux", "doctor-install"],
     discovery: "Describe interface work in chat — a making verb aimed at a UI, screen, layout, component, or stylesheet reaches this skill before any file is edited — or select the frontend-ui-ux OpenCode native skill, inspect skills/frontend-ui-ux/SKILL.md, or verify it with litopencode doctor. The post-edit hook also names it when an interface file changes.",
     safety: [
         "Keep retrieval offline, read-only, deterministic, bounded, and honest when no record matches.",
-        "Do not grant command, shell, browser, authentication, agent, tool, MCP, or write authority.",
-        "Require a finite route/state/viewport/theme/permission/auth/terminal/reference inventory before handoff.",
+        "Selection does not grant authority; implement only within the user request and OpenCode permissions. Review-only and plan-only stay read-only.",
+        "Record a compact finite inventory before coding and evolve the contract through implementation.",
         "Validate the exact canonical manifest before its scanner protection or inert read route; never execute its imported scripts or grant them host authority.",
         "Keep the normalized 34-source/2,277-record dataset unchanged and separate from the byte-preserved canonical library.",
-        "Hand off only the immutable contract hash and the evidence schema ids, never a partner skill name."
+        "Deliver working source, inspected renders and material gaps; keep contract hashes in evidence."
     ]
 };
 export const visualQaRuntimeSkill = {