@phi-code-admin/phi-code 0.75.5 → 0.75.6

package/extensions/phi/init.ts

@@ -369,14 +369,25 @@ _Edit this file to customize Phi Code's behavior for your project._
 		await writeModelsConfig(config);
 	}
 
-	// ─── Manual model assignment (one model per agent role) ──────────────
+	// ─── Manual model assignment (one model per orchestration role) ─────
+	//
+	// As of 0.75.6, `/phi-init` ONLY configures orchestration role models
+	// (used by `/plan` and the orchestrator). The chat default model is
+	// owned exclusively by `/model` and persisted via the settings manager.
+	// We intentionally do NOT ask "Default model" here — that would override
+	// the user's `/model` choice on every routing decision.
 
 	async function manualMode(
 		availableModels: string[],
 		ctx: any,
 	): Promise<Record<string, { preferred: string; fallback: string }>> {
-		ctx.ui.notify("Manual mode: assign a model to each task category.\n", "info");
-		const modelOptions = ["default (use current model)", ...availableModels];
+		ctx.ui.notify(
+			"Assign a model to each orchestration role.\n" +
+				"These models are used by `/plan` and the orchestrator — NOT by normal chat.\n" +
+				"The chat default model is controlled via `/model` (and stays sticky across prompts).\n",
+			"info",
+		);
+		const modelOptions = ["default (use current chat model)", ...availableModels];
 		const assignments: Record<string, { preferred: string; fallback: string }> = {};
 
 		for (const role of TASK_ROLES) {
@@ -391,9 +402,12 @@ _Edit this file to customize Phi Code's behavior for your project._
 			ctx.ui.notify(`  ${role.label}: ${preferredModel} (fallback: ${fallback})`, "info");
 		}
 
-		const defaultChoice = await ctx.ui.select("Default model (for general tasks)", modelOptions);
-		const defaultModel = defaultChoice && defaultChoice !== modelOptions[0] ? defaultChoice : "default";
-		assignments["default"] = { preferred: defaultModel, fallback: availableModels[0] || "default" };
+		// Orchestrator fallback (used only when a specific route has no model).
+		// This is NOT the chat default — `/model` controls that.
+		assignments["default"] = {
+			preferred: "default",
+			fallback: availableModels[0] || "default",
+		};
 		return assignments;
 	}
 
@@ -505,14 +519,14 @@ _Edit this file to customize Phi Code's behavior for your project._
 		handler: async (_args, ctx) => {
 			try {
 				ctx.ui.notify(
-					"NOTE: `/phi-init` is the legacy wizard. The refined replacement is `/setup` " +
-						"(richer flow: Alibaba dual-endpoint, OpenCode Go auto-fetch, ping validation, " +
-						"separate chat/orchestration assignments, hot-reload integration). " +
-						"This legacy command still works for backwards compatibility.",
+					"`/phi-init` configures **orchestration** roles only (Code / Debug / Plan / Explore / " +
+						"Test / Review — used by `/plan` and the orchestrator).\n\n" +
+						"The **chat default model** is owned exclusively by `/model` and stays sticky across " +
+						"prompts. This wizard will NOT change it.",
 					"info",
 				);
 
-				ctx.ui.notify("    Phi Code Setup Wizard", "info");
+				ctx.ui.notify("    Phi Code Setup Wizard (orchestration roles)", "info");
 
 				// 1. Detect providers (env vars + local servers + previously saved keys)
 				ctx.ui.notify("Detecting providers...\n", "info");
@@ -619,17 +633,21 @@ _Edit this file to customize Phi Code's behavior for your project._
 				ctx.ui.notify(`  Config: ${agentDir}`, "info");
 				ctx.ui.notify(`  Memory: ${memoryDir}`, "info");
 				ctx.ui.notify(`  Agents: ${agentsDir}`, "info");
-				ctx.ui.notify("\nModel Assignments:", "info");
+				ctx.ui.notify("\nOrchestration role assignments (used by `/plan`):", "info");
 				for (const role of TASK_ROLES) {
 					const a = assignments[role.key];
 					ctx.ui.notify(`  ${role.label}: \`${a.preferred}\` (fallback: \`${a.fallback}\`)`, "info");
 				}
-				ctx.ui.notify(`  Default: \`${assignments["default"].preferred}\``, "info");
+				ctx.ui.notify(
+					"\nChat default model: use `/model` (this wizard does NOT change the chat default).",
+					"info",
+				);
 				ctx.ui.notify("\nNext steps:", "info");
+				ctx.ui.notify("  - `/model` to pick the chat default model (sticky across prompts)", "info");
+				ctx.ui.notify("  - `/plan <description>` to run the orchestrator with the roles above", "info");
+				ctx.ui.notify("  - `/routing` to inspect the route table (auto-switch is OFF by default)", "info");
+				ctx.ui.notify("  - `/models refresh` to re-fetch the live model catalog", "info");
 				ctx.ui.notify("  - Edit `~/.phi/memory/AGENTS.md` with your project instructions", "info");
-				ctx.ui.notify("  - Run `/agents` to see available sub-agents", "info");
-				ctx.ui.notify("  - Run `/skills` to see available skills", "info");
-				ctx.ui.notify("  - Run `/models refresh` to re-fetch the model catalog", "info");
 				ctx.ui.notify("  - Start coding!\n", "info");
 			} catch (error) {
 				const message = error instanceof Error ? error.message : String(error);

package/extensions/phi/setup.ts

@@ -199,8 +199,7 @@ function buildStatusWidget(
 		lines.push(`  ${icon} ${p.displayName}${note}`);
 	}
 	lines.push("");
-	lines.push("Assignments:");
-	lines.push(`  Default chat   : ${assignments.default ?? "(not set)"}`);
+	lines.push("Orchestration roles (used by /plan — NOT chat):");
 	for (const role of ORCHESTRATION_ROLES) {
 		const a = assignments.orchestration[role.key];
 		const preferred = a?.preferred ?? "(not set)";
@@ -208,6 +207,7 @@ function buildStatusWidget(
 		lines.push(`  ${role.label.padEnd(8)} : ${preferred} / ${fallback}`);
 	}
 	lines.push("");
+	lines.push("Chat default model     : controlled via `/model` (this wizard never overrides it)");
 	lines.push(`Keys file : ${store.configPath} (chmod 0600 on Unix)`);
 	return lines;
 }
@@ -537,15 +537,22 @@ async function configureAssignments(
 		return { defaultModel: "default", orchestration: {} };
 	}
 
-	const defaultModel =
-		(await pickModelFromCatalog(ui, "Default chat model (used when no orchestration is active)", allModelIds)) ??
-		allModelIds[0];
+	ui.notify(
+		"Assigning orchestration role models. The chat default is controlled via `/model` — " +
+			"this wizard does NOT change it.",
+		"info",
+	);
+
+	// Sentinel: the orchestrator falls back to the current chat model when a
+	// route doesn't pin a specific one. We never ask the user for a "default"
+	// chat model here — `/model` owns that.
+	const defaultModel = "default";
 
 	const orchestration: Record<string, RouteAssignment> = {};
 	for (const role of ORCHESTRATION_ROLES) {
 		const preferred =
 			(await pickModelFromCatalog(ui, `${role.label} - preferred model (${role.desc})`, allModelIds)) ??
-			defaultModel;
+			allModelIds[0];
 		const fallbackOptions = allModelIds.filter((m) => m !== preferred);
 		const fallback = fallbackOptions.length > 0
 			? (await pickModelFromCatalog(ui, `${role.label} - fallback model`, fallbackOptions)) ?? preferred
@@ -590,8 +597,11 @@ export default function setupExtension(pi: ExtensionAPI) {
 			try {
 			ui.notify(
 				"**φ Phi Code Setup Wizard**\n\n" +
-					"This wizard configures providers and assigns models to agent roles.\n" +
-					"Keys are stored in `~/.phi/agent/models.json` (chmod 0600 on Unix).\n" +
+					"This wizard configures providers and assigns models to **orchestration roles** " +
+					"(used by `/plan`).\n" +
+					"The **chat default model is controlled via `/model`** and stays sticky across " +
+					"prompts — this wizard will never change it.\n\n" +
+					"Keys are stored in `~/.phi/agent/models.json` (chmod 0600 on Unix). " +
 					"Edit that file directly later to hot-reload (no restart needed).",
 				"info",
 			);

package/extensions/phi/smart-router.ts

@@ -19,6 +19,17 @@ import { homedir } from "node:os";
 
 interface ExtensionConfig {
 	enabled: boolean;
+	/**
+	 * When false (default), the smart router never changes the chat model — it
+	 * only emits an informational notification per prompt. Use `/model` to
+	 * choose the chat model; that choice is now the single source of truth
+	 * and is persisted across sessions via the settings manager.
+	 *
+	 * When true (opt-in via `/routing autoswitch on`), the router switches
+	 * the chat model to the preferred route per prompt, matching the
+	 * pre-0.75.6 behavior.
+	 */
+	autoSwitch: boolean;
 	notifyOnRecommendation: boolean;
 }
 
@@ -31,7 +42,8 @@ export default function smartRouterExtension(pi: ExtensionAPI) {
 	let router = new SmartRouter(SmartRouter.defaultConfig());
 	let extConfig: ExtensionConfig = {
 		enabled: true,
-		notifyOnRecommendation: true,
+		autoSwitch: false,
+		notifyOnRecommendation: false,
 	};
 
 	/**
@@ -95,20 +107,30 @@ export default function smartRouterExtension(pi: ExtensionAPI) {
 
 			const modelToUse = targetModel || fallbackModel;
 
-			if (modelToUse && modelToUse.id !== ctx.model?.id) {
-				// Actually switch the model
+			if (!modelToUse) {
+				if (extConfig.notifyOnRecommendation) {
+					ctx.ui.notify(
+						`Routing suggestion: ${recommendation.category} → \`${recommendation.model}\` (not in registry).`,
+						"info",
+					);
+				}
+			} else if (modelToUse.id === ctx.model?.id) {
+				// Already on the recommended model — nothing to do.
+			} else if (extConfig.autoSwitch) {
+				// Legacy opt-in behavior: actually swap the chat model.
 				const switched = await pi.setModel(modelToUse);
 				if (switched && extConfig.notifyOnRecommendation) {
 					ctx.ui.notify(
-						`🔀 ${recommendation.category} → \`${modelToUse.id}\`${modelToUse.id !== recommendation.model ? ` (fallback)` : ""}`,
-						"info"
+						`Auto-switched (${recommendation.category}) → \`${modelToUse.id}\`${modelToUse.id !== recommendation.model ? " (fallback)" : ""}`,
+						"info",
 					);
 				}
-			} else if (extConfig.notifyOnRecommendation && !modelToUse) {
-				// Model not available — just notify
+			} else if (extConfig.notifyOnRecommendation) {
+				// Default behavior: never override the user's `/model` choice. Just
+				// advertise the suggestion — the chat model stays sticky.
 				ctx.ui.notify(
-					`🔀 ${recommendation.category} → \`${recommendation.model}\` (not available, keeping current)`,
-					"info"
+					`Routing suggestion: ${recommendation.category} → \`${modelToUse.id}\`. Stay on \`${ctx.model?.id}\` (use \`/routing autoswitch on\` to auto-apply, or \`/model\` to change manually).`,
+					"info",
 				);
 			}
 		}
@@ -125,44 +147,66 @@ export default function smartRouterExtension(pi: ExtensionAPI) {
 
 			if (!arg) {
 				const routingConfig = (router as any).config as RoutingConfig;
-				let output = `**🔀 Smart Router** (powered by sigma-agents)\n\n`;
-				output += `Status: ${extConfig.enabled ? "✅ Enabled" : "❌ Disabled"}\n`;
-				output += `Notifications: ${extConfig.notifyOnRecommendation ? "On" : "Off"}\n\n`;
+				let output = `**Smart Router** (powered by sigma-agents)\n\n`;
+				output += `Status:        ${extConfig.enabled ? "enabled" : "disabled"}\n`;
+				output += `Auto-switch:   ${extConfig.autoSwitch ? "on (overrides /model per prompt)" : "off (suggestions only — /model is sticky)"}\n`;
+				output += `Notifications: ${extConfig.notifyOnRecommendation ? "on" : "off"}\n\n`;
 
 				output += `**Routes:**\n`;
 				for (const [cat, route] of Object.entries(routingConfig.routes)) {
 					output += `  **${cat}** → \`${route.preferredModel}\` (fallback: \`${route.fallback}\`) [agent: ${route.agent || "none"}]\n`;
 					output += `    Keywords: ${route.keywords.slice(0, 6).join(", ")}${route.keywords.length > 6 ? "..." : ""}\n`;
 				}
-				output += `\n  **default** → \`${routingConfig.default.model}\`\n`;
+				output += `\n  **default** → \`${routingConfig.default.model}\` (orchestrator fallback only; chat default comes from \`/model\`)\n`;
 
 				output += `\nConfig: \`${configPath}\``;
-				output += `\nCommands: \`/routing enable|disable|notify-on|notify-off|reload|test\``;
+				output += `\nCommands: \`/routing [enable|disable|autoswitch on|autoswitch off|notify-on|notify-off|reload|test]\``;
 
 				ctx.ui.notify(output, "info");
 				return;
 			}
 
+			const tokens = arg.split(/\s+/);
+			const head = tokens[0];
+
+			if (head === "autoswitch") {
+				const flag = tokens[1];
+				if (flag === "on") {
+					extConfig.autoSwitch = true;
+					ctx.ui.notify(
+						"Auto-switch enabled: the smart router will override the chat model per prompt. " +
+							"Disable with `/routing autoswitch off` if it gets in your way.",
+						"info",
+					);
+				} else if (flag === "off") {
+					extConfig.autoSwitch = false;
+					ctx.ui.notify("Auto-switch disabled. The model selected via `/model` is now sticky.", "info");
+				} else {
+					ctx.ui.notify("Usage: `/routing autoswitch on|off`", "warning");
+				}
+				return;
+			}
+
 			switch (arg) {
 				case "enable":
 					extConfig.enabled = true;
-					ctx.ui.notify("✅ Smart routing enabled.", "info");
+					ctx.ui.notify("Smart routing enabled.", "info");
 					break;
 				case "disable":
 					extConfig.enabled = false;
-					ctx.ui.notify("❌ Smart routing disabled.", "info");
+					ctx.ui.notify("Smart routing disabled.", "info");
 					break;
 				case "notify-on":
 					extConfig.notifyOnRecommendation = true;
-					ctx.ui.notify("🔔 Routing notifications enabled.", "info");
+					ctx.ui.notify("Routing notifications enabled.", "info");
 					break;
 				case "notify-off":
 					extConfig.notifyOnRecommendation = false;
-					ctx.ui.notify("🔕 Routing notifications disabled.", "info");
+					ctx.ui.notify("Routing notifications disabled.", "info");
 					break;
 				case "reload":
 					await loadConfig();
-					ctx.ui.notify("🔄 Routing config reloaded from disk.", "info");
+					ctx.ui.notify("Routing config reloaded from disk.", "info");
 					break;
 				case "test": {
 					const tests = [

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@phi-code-admin/phi-code",
-	"version": "0.75.5",
+	"version": "0.75.6",
 	"description": "Coding agent CLI with persistent memory, sub-agents, intelligent routing, and orchestration",
 	"type": "module",
 	"piConfig": {