@hienlh/ppm 0.19.7 → 0.19.8

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.19.8] - 2026-09-13
+
+### Changed
+- **Codex chats now use a balanced model by default** — PPM asked for no particular model, so Codex fell back to its most capable and most expensive one for every chat. Settings → AI Provider and the chat's model picker still override it, and "Auto (default)" hands the choice back to Codex.
+
 ## [0.19.7] - 2026-09-12
 
 ### Added

package/assets/skills/ppm/SKILL.md

@@ -71,4 +71,4 @@ This skill covers the `ppm` CLI, its HTTP API, and its config DB. It does **not*
 - Third-party extensions (inspect via `ppm ext list`).
 - The Claude Agent SDK internals (separate skill).
 
-<!-- Generated for PPM v0.19.7 at build time. Re-run `ppm export skill --install` to refresh. -->
+<!-- Generated for PPM v0.19.8 at build time. Re-run `ppm export skill --install` to refresh. -->

package/assets/skills/ppm/references/http-api.md

@@ -341,4 +341,4 @@ _Base URL: `http://localhost:8080` (default; override via `ppm config set port <
 - `ws://<host>/ws/terminal` — PTY terminal multiplexer
 - `ws://<host>/ws/extensions` — extension host channel
 
-<!-- Generated from src/server/routes/ for PPM v0.19.7 -->
+<!-- Generated from src/server/routes/ for PPM v0.19.8 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.19.7",
+  "version": "0.19.8",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "author": "hienlh",
   "license": "SEE LICENSE IN LICENSE",

package/src/providers/registry.ts

@@ -2,6 +2,7 @@ import type { AIProvider } from "./provider.interface.ts";
 import { MockProvider } from "./mock-provider.ts";
 import { ClaudeAgentSdkProvider } from "./claude-agent-sdk.ts";
 import { configService } from "../services/config.service.ts";
+import { CODEX_DEFAULT_MODEL } from "../types/config.ts";
 
 export interface ProviderInfo {
   id: string;
@@ -92,12 +93,22 @@ export async function bootstrapProviders(): Promise<void> {
     if (await codex.isAvailable()) {
       providerRegistry.register(codex);
       const ai = configService.get("ai");
+      // Only when codex has never been configured. An absent `model` is a real
+      // choice here — the settings picker writes it for "Auto (default)", which
+      // hands model selection back to codex — so filling one in on every startup
+      // would undo that choice each restart. Existing installs are given the
+      // default once, by migration.
       if (!ai.providers["codex"]) {
         configService.set("ai", {
           ...ai,
           providers: {
             ...ai.providers,
-            codex: { type: "cli", cli_command: "codex", permission_mode: "bypassPermissions" },
+            codex: {
+              type: "cli",
+              cli_command: "codex",
+              permission_mode: "bypassPermissions",
+              model: CODEX_DEFAULT_MODEL,
+            },
           },
         });
       }

package/src/services/db.service.ts

@@ -5,7 +5,8 @@ import { encrypt, decrypt } from "../lib/account-crypto.ts";
 import { getPpmDir } from "./ppm-dir.ts";
 import { assertProdDbAccessAllowed } from "./prod-db-guard.ts";
 import { backupDbSync } from "./db-backup/db-backup-sync.ts";
-export const CURRENT_SCHEMA_VERSION = 44;
+import { CODEX_DEFAULT_MODEL } from "../types/config.ts";
+export const CURRENT_SCHEMA_VERSION = 45;
 
 let db: Database | null = null;
 let dbProfile: string | null = null;
@@ -89,7 +90,8 @@ export function setDb(instance: Database): void {
 // Schema migrations
 // ---------------------------------------------------------------------------
 
-function runMigrations(database: Database): void {
+/** Exported so a test can drive an upgrade from a specific older version. */
+export function runMigrations(database: Database): void {
   const row = database.query("PRAGMA user_version").get() as { user_version: number };
   const current = row.user_version;
 
@@ -1047,6 +1049,35 @@ function runMigrations(database: Database): void {
       PRAGMA user_version = 44;
     `);
   }
+
+  if (current < 45) {
+    // Codex was registered without a model, and PPM sends no model when none is
+    // configured, so codex fell back to its own default — its most capable and
+    // most expensive model — for every chat.
+    //
+    // Applied once, here, rather than on each startup: the settings picker
+    // stores "Auto (default)" as an absent model, so a startup check could not
+    // tell that choice apart from never having chosen and would reimpose this
+    // value at every restart.
+    try {
+      const row = database.query("SELECT value FROM config WHERE key = 'ai'").get() as { value: string } | null;
+      if (row?.value) {
+        const ai = JSON.parse(row.value) as {
+          providers?: Record<string, Record<string, unknown> | undefined>;
+        };
+        const codex = ai.providers?.["codex"];
+        if (codex && codex.model == null) {
+          codex.model = CODEX_DEFAULT_MODEL;
+          database.query("UPDATE config SET value = ? WHERE key = 'ai'").run(JSON.stringify(ai));
+        }
+      }
+    } catch {
+      // A config that cannot be read or parsed is not worth failing the upgrade
+      // over; codex keeps choosing for itself, exactly as before.
+    }
+
+    database.exec(`PRAGMA user_version = 45;`);
+  }
 }
 
 // ---------------------------------------------------------------------------

package/src/types/config.ts

@@ -111,6 +111,20 @@ export interface AIProviderConfig {
   cli_command?: string;
 }
 
+/**
+ * Model a new codex session uses unless the picker says otherwise.
+ *
+ * Codex is registered at runtime rather than shipped in DEFAULT_CONFIG — it only
+ * exists once `@openai/codex` is installed — so its default lives here, beside
+ * Claude's, instead of being invisible inside the registration code.
+ *
+ * Deliberately not codex's own default, which is its most capable model and
+ * bills accordingly; codex describes this one as its balanced agentic coding
+ * model for everyday work, which is what a chat in an IDE mostly does. Changing
+ * it in Settings, or per session in the chat's model picker, overrides this.
+ */
+export const CODEX_DEFAULT_MODEL = "gpt-5.6-terra";
+
 export const DEFAULT_CONFIG: PpmConfig = {
   device_name: "",
   port: 8080,