@victor-software-house/pi-multicodex 1.0.10 → 1.1.0

package/README.md

@@ -45,7 +45,9 @@ Run the extension directly during local development:
 pi -e ./index.ts
 ```
 
-## Commands
+## Current commands
+
+These commands reflect the current shipped implementation:
 
 - `/multicodex-use [identifier]`
   - Use an existing managed account, or start the Codex login flow when the account is missing or the stored auth is no longer valid.
@@ -55,6 +57,57 @@ pi -e ./index.ts
 - `/multicodex-footer`
   - Open an interactive panel to configure footer fields and ordering.
 
+## Planned command migration
+
+The next user-facing milestone is a command-surface migration to one command family:
+
+- `/multicodex`
+  - open the main interactive UI
+- `/multicodex show`
+  - show runtime state and active-account summary
+- `/multicodex use [identifier]`
+  - choose or activate an account
+- `/multicodex footer`
+  - open footer settings
+- `/multicodex rotation`
+  - open rotation settings
+- `/multicodex verify`
+  - verify runtime health and local storage access
+- `/multicodex path`
+  - show config and storage paths
+- `/multicodex reset`
+  - reset selected extension state
+- `/multicodex help`
+  - print compact usage text
+
+Migration policy:
+
+- the old top-level commands will be removed once `/multicodex` is ready
+- no backward-compatibility aliases are planned
+- README, roadmap, tests, and release notes will move together in the same change
+
+## Architecture overview
+
+The implementation is currently organized around these modules:
+
+- `provider.ts`
+  - overrides the normal `openai-codex` provider path
+  - mirrors Codex models and installs the managed stream wrapper
+- `stream-wrapper.ts`
+  - account selection, retry, and quota-rotation path during streaming
+- `account-manager.ts`
+  - managed account storage, token refresh, usage cache, activation logic, and auth import sync
+- `auth.ts`
+  - reads pi's `~/.pi/agent/auth.json` and extracts importable `openai-codex` OAuth state
+- `status.ts`
+  - footer rendering, footer settings persistence, footer settings panel, and footer status refresh logic
+- `commands.ts`
+  - current slash command registrations and account-selection flows
+- `hooks.ts`
+  - session-start and session-switch refresh behavior
+- `storage.ts`
+  - persisted account state in `~/.pi/agent/codex-accounts.json`
+
 ## Project direction
 
 This project is maintained as its own package and release line.
@@ -63,15 +116,19 @@ Current direction:
 
 - package name: `@victor-software-house/pi-multicodex`
 - Codex-only scope
-- local state stored at `~/.pi/agent/codex-accounts.json`
-- internal logic split into focused modules
+- local account state stored at `~/.pi/agent/codex-accounts.json`
+- footer and future extension settings stored under `pi-multicodex` in `~/.pi/agent/settings.json`
+- internal logic split into focused modules today, with a broader shared controller planned next
 - current roadmap tracked in `ROADMAP.md`
 
-Current next step:
+Current next milestones:
 
-- refine the footer color palette with small visual adjustments only
-- document the account-rotation behavior contract explicitly
-- improve the `/multicodex-use` and `/multicodex-status` everyday UX
+1. Replace the split command surface with the `/multicodex` command family.
+2. Add dynamic autocomplete for subcommands and managed account identifiers.
+3. Make account inspection and selection consistently actionable.
+4. Persist footer settings immediately instead of waiting for panel close.
+5. Add configurable rotation settings and document the rotation behavior contract.
+6. Broaden the current footer controller into a shared MultiCodex controller.
 
 ## Behavior contract
 
@@ -96,7 +153,7 @@ The current runtime behavior is:
 ### Retry policy
 
 - MultiCodex retries account rotation up to 5 times for a single request.
-- Retries only happen for quota/rate-limit style failures that occur before output is forwarded.
+- Retries only happen for quota and rate-limit style failures that occur before output is forwarded.
 - Once output has started streaming, the original error is surfaced instead of rotating.
 
 ### Manual override behavior
@@ -132,38 +189,57 @@ pnpm check
 npm pack --dry-run
 ```
 
-Release flow:
+## Release process
+
+This repository uses `semantic-release` with npm trusted publishing.
+
+Maintainer flow:
+
+1. Write Conventional Commits.
+2. The local `commit-msg` hook validates commit messages with Lefthook + commitlint.
+3. CI validates commit messages again and runs release checks.
+4. Merge to `main`.
+5. GitHub Actions runs `semantic-release` from `.github/workflows/publish.yml`.
+6. `semantic-release` computes the next version, creates the git tag and GitHub release, updates `package.json` and `CHANGELOG.md`, and publishes to npm through trusted publishing.
 
-1. Prepare the release locally.
-2. Commit the version bump.
-3. Create and push a matching `v*` tag.
-4. Let GitHub Actions publish through trusted publishing.
+Local verification:
+
+```bash
+pnpm check
+npm pack --dry-run
+pnpm release:dry
+```
 
 Local push protection:
 
 - `lefthook` runs `mise run pre-push`
-- the `pre-push` mise task runs the same core validations as the publish workflow:
+- the `pre-push` mise task runs the same core validations as CI:
   - `pnpm check`
   - `npm pack --dry-run`
 
-Prepare locally:
+Do not use local `npm publish` for normal releases in this repo.
 
-```bash
-npm run release:prepare -- <version>
-```
+## npm trusted publishing setup
 
-The helper updates `package.json` with `bun pm pkg set` and then runs the release checks.
+npm-side setup is required in addition to the workflow.
 
-Example:
+Trusted publisher mapping:
+
+- package: `@victor-software-house/pi-multicodex`
+- repository: `victor-founder/pi-multicodex`
+- workflow file: `.github/workflows/publish.yml`
+
+Useful commands:
 
 ```bash
-git add package.json
-git commit -m "release: v<version>"
-git tag v<version>
-git push origin main --tags
+npm trust list @victor-software-house/pi-multicodex
+script -q /dev/null bash -lc 'npm trust github @victor-software-house/pi-multicodex --repository victor-founder/pi-multicodex --file publish.yml --yes'
 ```
 
-Do not use local `npm publish` for normal releases in this repo.
+## Related docs
+
+- `ROADMAP.md` for planned milestones and acceptance criteria
+- `AGENTS.md` for repository-specific agent guidance
 
 ## Acknowledgment
 

package/account-manager.ts

@@ -195,6 +195,25 @@ export class AccountManager {
 		}
 	}
 
+	removeAccount(email: string): boolean {
+		const index = this.data.accounts.findIndex(
+			(account) => account.email === email,
+		);
+		if (index < 0) return false;
+
+		this.data.accounts.splice(index, 1);
+		this.usageCache.delete(email);
+		if (this.manualEmail === email) {
+			this.manualEmail = undefined;
+		}
+		if (this.data.activeEmail === email) {
+			this.data.activeEmail = this.data.accounts[0]?.email;
+		}
+		this.save();
+		this.notifyStateChanged();
+		return true;
+	}
+
 	getCachedUsage(email: string): CodexUsageSnapshot | undefined {
 		return this.usageCache.get(email);
 	}

package/commands.ts

@@ -3,6 +3,14 @@ import type {
 	ExtensionAPI,
 	ExtensionCommandContext,
 } from "@mariozechner/pi-coding-agent";
+import { getSelectListTheme } from "@mariozechner/pi-coding-agent";
+import {
+	Container,
+	Key,
+	matchesKey,
+	SelectList,
+	Text,
+} from "@mariozechner/pi-tui";
 import type { AccountManager } from "./account-manager";
 import { openLoginInBrowser } from "./browser";
 import type { createUsageStatusController } from "./status";
@@ -68,6 +76,109 @@ async function useOrLoginAccount(
 	await loginAndActivateAccount(pi, ctx, accountManager, identifier);
 }
 
+type AccountPanelResult =
+	| { action: "select"; email: string }
+	| { action: "remove"; email: string }
+	| undefined;
+
+function getAccountLabel(email: string, quotaExhaustedUntil?: number): string {
+	if (!quotaExhaustedUntil || quotaExhaustedUntil <= Date.now()) {
+		return email;
+	}
+	return `${email} (Quota)`;
+}
+
+async function openAccountSelectionPanel(
+	ctx: ExtensionCommandContext,
+	accountManager: AccountManager,
+): Promise<AccountPanelResult> {
+	const accounts = accountManager.getAccounts();
+	const items = accounts.map((account) => ({
+		value: account.email,
+		label: getAccountLabel(account.email, account.quotaExhaustedUntil),
+	}));
+
+	return ctx.ui.custom<AccountPanelResult>((_tui, theme, _kb, done) => {
+		const container = new Container();
+		container.addChild(
+			new Text(theme.fg("accent", theme.bold("Select Account")), 1, 0),
+		);
+		container.addChild(
+			new Text(
+				theme.fg("dim", "Enter: use  Backspace: remove account  Esc: cancel"),
+				1,
+				0,
+			),
+		);
+
+		const selectList = new SelectList(items, 10, getSelectListTheme());
+		selectList.onSelect = (item) => {
+			done({ action: "select", email: item.value });
+		};
+		selectList.onCancel = () => done(undefined);
+		container.addChild(selectList);
+
+		return {
+			render: (width: number) => container.render(width),
+			invalidate: () => container.invalidate(),
+			handleInput: (data: string) => {
+				if (matchesKey(data, Key.backspace)) {
+					const selected = selectList.getSelectedItem();
+					if (selected) {
+						done({ action: "remove", email: selected.value });
+					}
+					return;
+				}
+				selectList.handleInput(data);
+			},
+		};
+	});
+}
+
+async function openAccountSelectionFlow(
+	ctx: ExtensionCommandContext,
+	accountManager: AccountManager,
+	statusController: ReturnType<typeof createUsageStatusController>,
+): Promise<void> {
+	while (true) {
+		const accounts = accountManager.getAccounts();
+		if (accounts.length === 0) {
+			ctx.ui.notify(
+				"No managed accounts found. Use /login or /multicodex-use <identifier> first.",
+				"warning",
+			);
+			return;
+		}
+
+		const result = await openAccountSelectionPanel(ctx, accountManager);
+		if (!result) return;
+
+		if (result.action === "select") {
+			accountManager.setManualAccount(result.email);
+			ctx.ui.notify(`Now using ${result.email}`, "info");
+			await statusController.refreshFor(ctx);
+			return;
+		}
+
+		const accountToRemove = accountManager.getAccount(result.email);
+		if (!accountToRemove) continue;
+
+		const active = accountManager.getActiveAccount();
+		const isActive = active?.email === result.email;
+		const message = isActive
+			? `Remove ${result.email}? This account is currently active and MultiCodex will switch to another account.`
+			: `Remove ${result.email}?`;
+		const confirmed = await ctx.ui.confirm("Remove account", message);
+		if (!confirmed) continue;
+
+		const removed = accountManager.removeAccount(result.email);
+		if (!removed) continue;
+
+		ctx.ui.notify(`Removed ${result.email}`, "info");
+		await statusController.refreshFor(ctx);
+	}
+}
+
 export function registerCommands(
 	pi: ExtensionAPI,
 	accountManager: AccountManager,
@@ -88,30 +199,7 @@ export function registerCommands(
 			}
 
 			await accountManager.syncImportedOpenAICodexAuth();
-			const accounts = accountManager.getAccounts();
-			if (accounts.length === 0) {
-				ctx.ui.notify(
-					"No managed accounts found. Use /login or /multicodex-use <identifier> first.",
-					"warning",
-				);
-				return;
-			}
-
-			const options = accounts.map(
-				(account) =>
-					account.email +
-					(account.quotaExhaustedUntil &&
-					account.quotaExhaustedUntil > Date.now()
-						? " (Quota)"
-						: ""),
-			);
-			const selected = await ctx.ui.select("Select Account", options);
-			if (!selected) return;
-
-			const email = selected.split(" (")[0] ?? selected;
-			accountManager.setManualAccount(email);
-			ctx.ui.notify(`Now using ${email}`, "info");
-			await statusController.refreshFor(ctx);
+			await openAccountSelectionFlow(ctx, accountManager, statusController);
 		},
 	});
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@victor-software-house/pi-multicodex",
-	"version": "1.0.10",
+	"version": "1.1.0",
 	"description": "Codex account rotation extension for pi",
 	"license": "MIT",
 	"type": "module",
@@ -56,8 +56,7 @@
 		"tsgo": "tsgo -p tsconfig.json",
 		"check": "pnpm lint && pnpm tsgo && pnpm test",
 		"pack:dry": "npm pack --dry-run",
-		"release:dry": "bun ./scripts/publish.ts --dry-run",
-		"release:prepare": "bun ./scripts/publish.ts"
+		"release:dry": "pnpm exec semantic-release --dry-run"
 	},
 	"peerDependencies": {
 		"@mariozechner/pi-ai": "*",
@@ -77,11 +76,20 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.4.7",
+		"@commitlint/cli": "^20.4.4",
+		"@commitlint/config-conventional": "^20.4.4",
 		"@mariozechner/pi-ai": "^0.58.1",
 		"@mariozechner/pi-coding-agent": "^0.58.1",
 		"@mariozechner/pi-tui": "^0.58.1",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.1",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^12.0.6",
+		"@semantic-release/npm": "^13.1.5",
+		"@semantic-release/release-notes-generator": "^14.1.0",
 		"@types/node": "^25.5.0",
 		"@typescript/native-preview": "7.0.0-dev.20260314.1",
+		"semantic-release": "^25.0.3",
 		"typescript": "^5.9.3",
 		"vitest": "^4.1.0"
 	},

package/status.ts

@@ -24,6 +24,7 @@ const REFRESH_INTERVAL_MS = 60_000;
 const MODEL_SELECT_REFRESH_DEBOUNCE_MS = 250;
 const UNKNOWN_PERCENT = "--";
 const BRAND_LABEL = "Codex";
+const SEGMENT_SEPARATOR = "·";
 const FIVE_HOUR_LABEL = "5h:";
 const SEVEN_DAY_LABEL = "7d:";
 
@@ -148,25 +149,40 @@ function formatLoading(ctx: ExtensionContext): string {
 	return ctx.ui.theme.fg("muted", "loading...");
 }
 
-function formatPercent(
-	ctx: ExtensionContext,
+function formatSeparator(ctx: ExtensionContext): string {
+	return ctx.ui.theme.fg("muted", SEGMENT_SEPARATOR);
+}
+
+function getUsageSeverityToken(
 	displayPercent: number | undefined,
 	mode: PercentDisplayMode,
-): string {
+): "success" | "thinkingMedium" | "warning" | "error" | "dim" {
 	if (typeof displayPercent !== "number" || Number.isNaN(displayPercent)) {
-		return ctx.ui.theme.fg("dim", UNKNOWN_PERCENT);
+		return "dim";
 	}
 
-	const text = `${Math.round(clampPercent(displayPercent))}% ${mode}`;
 	if (mode === "left") {
-		if (displayPercent <= 10) return ctx.ui.theme.fg("error", text);
-		if (displayPercent <= 25) return ctx.ui.theme.fg("warning", text);
-		return ctx.ui.theme.fg("success", text);
+		if (displayPercent <= 10) return "error";
+		if (displayPercent <= 25) return "warning";
+		if (displayPercent <= 50) return "thinkingMedium";
+		return "success";
 	}
 
-	if (displayPercent >= 90) return ctx.ui.theme.fg("error", text);
-	if (displayPercent >= 75) return ctx.ui.theme.fg("warning", text);
-	return ctx.ui.theme.fg("success", text);
+	if (displayPercent >= 90) return "error";
+	if (displayPercent >= 75) return "warning";
+	if (displayPercent >= 50) return "thinkingMedium";
+	return "success";
+}
+
+function formatPercent(
+	displayPercent: number | undefined,
+	mode: PercentDisplayMode,
+): string {
+	if (typeof displayPercent !== "number" || Number.isNaN(displayPercent)) {
+		return UNKNOWN_PERCENT;
+	}
+
+	return `${Math.round(clampPercent(displayPercent))}% ${mode}`;
 }
 
 function formatResetCountdown(resetAt: number | undefined): string | undefined {
@@ -200,20 +216,23 @@ function formatUsageSegment(
 	showReset: boolean,
 	preferences: FooterPreferences,
 ): string {
+	const displayPercent = usedToDisplayPercent(
+		usedPercent,
+		preferences.usageMode,
+	);
 	const parts = [
-		`${ctx.ui.theme.fg("dim", label)}${formatPercent(
-			ctx,
-			usedToDisplayPercent(usedPercent, preferences.usageMode),
-			preferences.usageMode,
-		)}`,
+		`${label}${formatPercent(displayPercent, preferences.usageMode)}`,
 	];
 	if (showReset) {
 		const countdown = formatResetCountdown(resetAt);
 		if (countdown) {
-			parts.push(ctx.ui.theme.fg("muted", `(↺${countdown})`));
+			parts.push(`(↺${countdown})`);
 		}
 	}
-	return parts.join(" ");
+	return ctx.ui.theme.fg(
+		getUsageSeverityToken(displayPercent, preferences.usageMode),
+		parts.join(" "),
+	);
 }
 
 export function isManagedModel(model: MaybeModel): boolean {
@@ -227,7 +246,7 @@ export function formatActiveAccountStatus(
 	preferences: FooterPreferences,
 ): string {
 	const accountText = preferences.showAccount
-		? ctx.ui.theme.fg("muted", accountEmail)
+		? ctx.ui.theme.fg("text", accountEmail)
 		: undefined;
 	if (!usage) {
 		return [formatBrand(ctx), accountText, formatLoading(ctx)]
@@ -252,16 +271,18 @@ export function formatActiveAccountStatus(
 		preferences,
 	);
 
+	const usageSegments = [fiveHour, sevenDay].filter(Boolean);
+	const usageText = usageSegments.join(` ${formatSeparator(ctx)} `);
 	const leading =
 		preferences.order === "account-first"
-			? [formatBrand(ctx), accountText]
-			: [formatBrand(ctx)];
+			? [formatBrand(ctx), accountText, usageText]
+			: [formatBrand(ctx), usageText];
 	const trailing =
 		preferences.order === "account-first" ? [] : [accountText].filter(Boolean);
 
-	return [...leading, fiveHour, sevenDay, ...trailing]
+	return [...leading, ...trailing]
 		.filter(Boolean)
-		.join(" ");
+		.join(` ${formatSeparator(ctx)} `);
 }
 
 function getBooleanLabel(value: boolean): string {