@miphamai/cli 0.16.2 → 0.16.4

package/bin/mipham.ts

@@ -331,6 +331,32 @@ async function main() {
     process.exit(0)
   }
 
+  // ── Help flag ─────────────────────────────────────────────────────────────
+  if (
+    process.argv.includes('--help') ||
+    process.argv.includes('-h') ||
+    process.argv.slice(2).some((a) => a === 'help')
+  ) {
+    console.log(`Mipham Code — AI-powered coding terminal
+
+Usage:
+  mipham                     Launch interactive CLI
+  mipham update              Update to the latest version
+  mipham upgrade             Same as 'mipham update'
+  mipham plugin <cmd>        Plugin management (install, list, remove, etc.)
+  mipham workflow <cmd>      Workflow orchestration (run, list, resume, etc.)
+  mipham --version           Print version and exit
+  mipham --help              Show this help
+
+Flags:
+  --safe-mode                Skip custom agents, skills, hooks, plugins
+  --version, -v, -V          Print version
+
+Docs: https://mipham.ai/code
+npm:  https://www.npmjs.com/package/@miphamai/cli`)
+    process.exit(0)
+  }
+
   // ── Update / upgrade ──────────────────────────────────────────────────────
   const handledUpdate = await runUpdate()
   if (handledUpdate) return
@@ -343,6 +369,41 @@ async function main() {
   const handled = await runWorkflowCLI()
   if (handled) return
 
+  // ── Unknown command detection ──────────────────────────────────────────────
+  // After all known subcommands are checked, any remaining positional argument
+  // is probably a typo. Show error + suggestions instead of silently launching CLI.
+  const KNOWN_COMMANDS = ['update', 'upgrade', 'plugin', 'workflow', 'help']
+  const firstArg = process.argv.slice(2).find((a) => !a.startsWith('-'))
+  if (firstArg) {
+    // Levenshtein distance to find closest match
+    const distance = (a: string, b: string): number => {
+      const m = a.length
+      const n = b.length
+      const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0))
+      for (let i = 0; i <= m; i++) dp[i]![0] = i
+      for (let j = 0; j <= n; j++) dp[0]![j] = j
+      for (let i = 1; i <= m; i++)
+        for (let j = 1; j <= n; j++)
+          dp[i]![j] =
+            a[i - 1] === b[j - 1]
+              ? dp[i - 1]![j - 1]!
+              : 1 + Math.min(dp[i - 1]![j]!, dp[i]![j - 1]!, dp[i - 1]![j - 1]!)
+      return dp[m]![n]!
+    }
+
+    const best = KNOWN_COMMANDS.map((cmd) => ({ cmd, dist: distance(firstArg, cmd) }))
+      .filter((c) => c.dist <= 3)
+      .sort((a, b) => a.dist - b.dist)
+    const suggestions = best.map((c) => `'mipham ${c.cmd}'`).join(', ')
+
+    console.error(`Unknown command: mipham ${firstArg}`)
+    if (suggestions) {
+      console.error(`Did you mean: ${suggestions}?`)
+    }
+    console.error(`Run 'mipham --help' for usage.`)
+    process.exit(1)
+  }
+
   // Parse --safe-mode flag: skip custom agents, skills, hooks, plugins
   const safeModeFlag = process.argv.includes('--safe-mode')
   if (safeModeFlag) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.16.2",
+  "version": "0.16.4",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",

package/src/ui/app.tsx

@@ -59,16 +59,21 @@ interface AgentProgress {
 // Version is read fresh from package.json at startup via runApp prop
 // (bypasses Bun module caching after npm update)
 
+// Cycle order: Claude Code modes first (manual → accept edits → bypass),
+// then Mipham-specific modes (plan → auto → dont ask).
 const PERMISSION_MODES: PermissionMode[] = [
   'default',
   'acceptEdits',
+  'bypassPermissions',
   'plan',
   'auto',
   'dontAsk',
-  'bypassPermissions',
 ]
+// Labels aligned with Claude Code terminology: describe behavior, not capability.
+// Claude Code modes: manual mode → accept edits on → bypass
+// Mipham extends with 3 extra modes (plan, auto, dontAsk) for finer control.
 const PERMISSION_LABELS: Record<PermissionMode, string> = {
-  default: 'reads free',
+  default: 'manual mode',
   acceptEdits: 'accept edits on',
   plan: 'plan mode · read-only',
   auto: 'auto mode',
@@ -608,7 +613,7 @@ export function App({
       {/* Agent status footer — shows running background agents */}
       <AgentFooter agents={Object.values(runningAgents)} gitBranch={gitBranch} tick={agentTick} />
 
-      {/* Status line — Claude Code style: compact, action-oriented */}
+      {/* Status line — Claude Code style */}
       <Box marginTop={1} flexDirection="column">
         {goalText && (
           <Box>
@@ -619,8 +624,8 @@ export function App({
           <Text color={PERMISSION_COLORS[permissionMode]}>
             ⏵⏵ {PERMISSION_LABELS[permissionMode]} (shift+tab to cycle)
           </Text>
-          <Text dimColor> · Esc to interrupt</Text>
-          <Text dimColor> · ← agents</Text>
+          <Text dimColor> · esc to interrupt</Text>
+          <Text dimColor> · ← for agents</Text>
         </Box>
       </Box>
     </Box>