@miphamai/cli 0.81.0 → 0.81.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.81.0",
+  "version": "0.81.2",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",
@@ -38,7 +38,8 @@
     "dev": "bun run bin/mipham.ts",
     "build": "bun run scripts/generate-bundled-skills.ts && bun build --compile --minify ./bin/mipham.ts --outfile dist/mipham",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "knip": "knip --production --no-progress --no-exit-code"
   },
   "dependencies": {
     "@larksuiteoapi/node-sdk": "^1.73.0",

package/src/agent/agent-experience.ts

@@ -1,5 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync, existsSync, unlinkSync } from 'node:fs'
 import { join } from 'node:path'
+import { homedir } from 'node:os'
 import { ExperienceRuleExtractor, type ExperienceRule } from './experience-rules.js'
 
 const MAX_EXPERIENCES = 20
@@ -10,7 +11,7 @@ export class AgentExperience {
 
   constructor(
     private readonly agentName: string,
-    baseDir: string = join(process.env.HOME || '~', '.mipham', 'agent-memory'),
+    baseDir: string = join(homedir(), '.mipham', 'agent-memory'),
   ) {
     this.expDir = join(baseDir, agentName)
     this.expFile = join(this.expDir, 'experience.md')

package/src/agent/effectiveness-tracker.ts

@@ -1,5 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs'
 import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
 import type { CrsiProvenanceBridge, CrsiVerdict } from './crsi-provenance-bridge.js'
 import { isRecoverableToolFailure } from './recoverable-failure.js'
 
@@ -31,7 +32,7 @@ export class EffectivenessTracker {
   private storePath: string
   private provenanceBridge?: CrsiProvenanceBridge
 
-  constructor(storeDir: string = join(process.env.HOME || '~', '.mipham', 'rule-engine')) {
+  constructor(storeDir: string = join(homedir(), '.mipham', 'rule-engine')) {
     this.storePath = join(storeDir, STORE_FILE)
     this.data = new Map()
   }

package/src/commands/loop-scaffold.ts

@@ -11,6 +11,7 @@
 
 import { mkdirSync, writeFileSync, existsSync, chmodSync } from 'node:fs'
 import { join, resolve } from 'node:path'
+import { homedir } from 'node:os'
 
 export interface ScaffoldResult {
   created: string[]
@@ -87,7 +88,7 @@ export function scaffoldLoopKit(basePath: string): ScaffoldResult {
   const created: string[] = []
   const skipped: string[] = []
 
-  const resolved = resolve(basePath.replace(/^~/, process.env.HOME || '~'))
+  const resolved = resolve(basePath.replace(/^~/, homedir()))
   const miphamDir = join(resolved, '.mipham')
 
   // ── .mipham/ root ──

package/src/commands/project.ts

@@ -8,6 +8,7 @@
 import type { CommandHandler, CommandContext, CommandResult } from '../ui/commands.js'
 import { getWorkspaceTrust } from '../core/workspace-trust'
 import { atomicWriteFileSync } from '../shared/atomic-write'
+import { homedir } from 'node:os'
 
 export {
   initCmd,
@@ -311,7 +312,7 @@ const setupCmd: CommandHandler = async (ctx, args) => {
   const { existsSync } = await import('node:fs')
   const { join } = await import('node:path')
   const cwd = process.cwd()
-  const home = process.env.HOME || '~'
+  const home = homedir()
 
   const hasProjectMipham = existsSync(join(cwd, 'MIPHAM.md'))
   const hasProjectConfig = existsSync(join(cwd, '.mipham', 'config.yml'))
@@ -688,7 +689,7 @@ permission boundaries. Adding directories here extends read/write access.`,
 
   const { existsSync } = await import('node:fs')
   const { resolve } = await import('node:path')
-  const resolved = resolve(dir.replace(/^~/, process.env.HOME || '~'))
+  const resolved = resolve(dir.replace(/^~/, homedir()))
 
   if (!existsSync(resolved)) {
     return { content: `✗ Directory not found: ${resolved}\n\nCheck the path and try again.` }

package/src/config/wizard-config.ts

@@ -0,0 +1,72 @@
+/**
+ * Data layer for the first-run Config Wizard — no Ink, no React, so it can be
+ * tested directly (the UI component imports it, tests import it too).
+ */
+
+import { DEFAULT_PROVIDERS } from '../shared/constants'
+import type { ModelInfo } from '../shared/types'
+
+/** Providers offered in the wizard's cloud path (Ollama has its own step). */
+export const CLOUD_PROVIDERS = DEFAULT_PROVIDERS.filter(
+  (p) => p.id !== 'ollama' && p.id !== 'mipham',
+)
+
+export function getActiveModels(providerId: string): ModelInfo[] {
+  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
+  return provider?.models.filter((m) => m.status === 'active') || []
+}
+
+/**
+ * Build the config.yml body written by the wizard.
+ *
+ * Built-in providers get **no** `models:` block on purpose: `mergeProviders`
+ * (config/loader.ts) treats a supplied `models:` list as a wholesale
+ * replacement of the built-in list, so writing bare `- id:` lines there would
+ * strip `status` (→ the model picker shows "no active models"),
+ * `contextWindow`, `maxOutput` and `vision` from every built-in model.
+ * `models:` is written only for providers whose built-in list is empty
+ * (Ollama), where it must carry every model field in full.
+ */
+export function buildConfigYaml(
+  providerId: string,
+  modelId: string,
+  storedKey: string,
+  ollamaModels: ModelInfo[] = [],
+): string {
+  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
+  const hasBuiltInModels = (provider?.models.length ?? 0) > 0
+
+  const lines = [
+    '# Mipham Code Configuration',
+    `# Generated by Config Wizard — ${new Date().toISOString()}`,
+    '',
+    'version: 1',
+    `defaultProvider: ${providerId}`,
+    `defaultModel: ${modelId}`,
+    'permission: default',
+    '',
+    'providers:',
+    `  - id: ${providerId}`,
+    `    name: ${provider?.name || providerId}`,
+    `    protocol: ${provider?.protocol || 'openai-compatible'}`,
+    ...(provider?.baseUrl ? [`    baseUrl: ${provider.baseUrl}`] : []),
+    `    apiKey: ${storedKey}`,
+  ]
+
+  if (!hasBuiltInModels) {
+    lines.push('    models:')
+    for (const m of ollamaModels) {
+      lines.push(
+        `      - id: ${m.id}`,
+        `        name: ${m.name}`,
+        `        providerId: ${m.providerId}`,
+        `        contextWindow: ${m.contextWindow}`,
+        `        maxOutput: ${m.maxOutput}`,
+        `        vision: ${m.vision}`,
+        `        status: ${m.status}`,
+      )
+    }
+  }
+
+  return lines.join('\n')
+}

package/src/core/claude-md-audit.ts

@@ -44,21 +44,45 @@ const PATTERNS: Array<{ pattern: RegExp; reason: DerivableReason }> = [
 ]
 
 /**
- * Return `##`/`###` headings whose title matches a derivable-content pattern,
- * in document order. Headings without a match are ignored.
+ * A section that already points at another doc has been disclosed — there is
+ * nothing left to exclude, so the audit stays silent about it.
+ */
+const DOC_POINTER = /\]\([^)\s]*\.md(?:[#?][^)\s]*)?\)/
+
+/**
+ * Return `##`/`###` headings whose title matches a derivable-content pattern and
+ * whose body is not already disclosed behind a `.md` pointer, in document order.
+ * Headings without a match are ignored.
  */
 export function findDerivableSections(content: string): DerivableSection[] {
   const found: DerivableSection[] = []
+  let heading: string | null = null
+  let reason: DerivableReason | null = null
+  let body: string[] = []
+
+  const flush = () => {
+    if (heading !== null && reason !== null && !DOC_POINTER.test(body.join('\n'))) {
+      found.push({ heading, reason })
+    }
+    heading = null
+    reason = null
+    body = []
+  }
+
   for (const line of content.split('\n')) {
     const m = line.match(/^(#{2,3})\s+(.+?)\s*$/)
-    if (!m) continue
-    const heading = m[2]!.trim()
-    for (const { pattern, reason } of PATTERNS) {
-      if (pattern.test(heading)) {
-        found.push({ heading, reason })
-        break
+    if (m) {
+      flush()
+      const title = m[2]!.trim()
+      const hit = PATTERNS.find(({ pattern }) => pattern.test(title))
+      if (hit) {
+        heading = title
+        reason = hit.reason
       }
+      continue
     }
+    if (heading !== null) body.push(line)
   }
+  flush()
   return found
 }

package/src/core/instructions.ts

@@ -1,5 +1,6 @@
 import { readFileSync, existsSync } from 'node:fs'
 import { join, resolve, relative, sep, isAbsolute } from 'node:path'
+import { homedir } from 'node:os'
 import { execSync } from 'node:child_process'
 import { parse as parseYaml } from 'yaml'
 import type { InstructionFile } from '../shared/index.ts'
@@ -126,7 +127,7 @@ export class InstructionsLoader {
     })
 
     // Tier 3: 用户层 ~/.mipham/USER.md
-    const home = process.env.HOME || '~'
+    const home = homedir()
     this.tryLoad(join(home, '.mipham', 'USER.md'), 'user')
 
     // CRSI 教训召回：读 crsi-lessons.md 提取精华，注入系统提示（只写不读 → 写后召回）

package/src/core/rule-engine.ts

@@ -1,6 +1,7 @@
 import type { ExperienceRule } from '../agent/experience-rules.js'
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs'
 import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
 import { MANAGED_RULES } from './crsi-managed-rules'
 
 export interface ToolRule {
@@ -61,7 +62,7 @@ export class ExperienceRuleEngine {
   private rules: ToolRule[]
   private storePath: string
 
-  constructor(storeDir: string = join(process.env.HOME || '~', '.mipham', 'rule-engine')) {
+  constructor(storeDir: string = join(homedir(), '.mipham', 'rule-engine')) {
     this.rules = [...BUILTIN_RULES, ...MANAGED_RULES].map((r) => ({ ...r }))
     this.storePath = join(storeDir, 'rules.json')
     this.load()

package/src/core/session-log.ts

@@ -1,4 +1,5 @@
 import { appendFileSync, readFileSync, mkdirSync, existsSync } from 'node:fs'
+import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { createHash } from 'node:crypto'
 import type { Message, ToolUseContent, ToolResultContent, ToolResult } from '../shared/types'
@@ -101,7 +102,7 @@ export function deriveMessages(events: SessionEvent[]): Message[] {
   return out
 }
 
-const HOME = process.env.HOME || '~'
+const HOME = homedir()
 const LOG_DIR = join(HOME, '.mipham', 'sessions')
 
 /** 将会话名消毒为安全文件名（与 SessionStore 共用；防路径穿越）。 */

package/src/core/session-store.ts

@@ -8,6 +8,7 @@ import {
   existsSync,
   statSync,
 } from 'node:fs'
+import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { createHash } from 'node:crypto'
 import type { Message } from '../shared/types'
@@ -28,7 +29,7 @@ export interface StoredSession {
   messages: Message[]
 }
 
-const HOME = process.env.HOME || '~'
+const HOME = homedir()
 const SESSIONS_DIR = join(HOME, '.mipham', 'sessions')
 const INDEX_FILE = join(SESSIONS_DIR, '.index.json')
 const SUMMARIES_DIR = join(SESSIONS_DIR, '.summaries')

package/src/daemon/database.ts

@@ -1,6 +1,7 @@
 // apps/cli/src/daemon/database.ts
 import { Database } from 'bun:sqlite'
 import { readdirSync, readFileSync, existsSync } from 'node:fs'
+import { homedir } from 'node:os'
 import { join } from 'node:path'
 import type {
   DaemonSession,
@@ -339,7 +340,7 @@ export class DaemonDatabase {
   // ── Migration ──────────────────────────────────────────────
 
   migrateFromJsonl(): number {
-    const sessionsDir = join(process.env.HOME || '/tmp', '.mipham', 'sessions')
+    const sessionsDir = join(homedir(), '.mipham', 'sessions')
 
     if (!existsSync(sessionsDir)) return 0
 

package/src/i18n-core/locales/en-US.json

@@ -901,6 +901,7 @@
       "mode_title": "Choose connection method:",
       "mode_cloud": "🌐 Cloud AI models (recommended)",
       "mode_local": "🖥️ Local models (Ollama)",
+      "mode_cloud_hint": " {count} cloud providers built in",
       "mode_local_hint": " Requires Ollama installed with models downloaded",
       "nav_hint": "↑↓ select · Enter confirm · Esc back",
       "provider_title": "Choose AI model provider:",

package/src/i18n-core/locales/zh-CN.json

@@ -901,6 +901,7 @@
       "mode_title": "选择模型连接方式：",
       "mode_cloud": "🌐 云端 AI 模型（推荐）",
       "mode_local": "🖥️ 本地模型（Ollama）",
+      "mode_cloud_hint": " 内置 {count} 家云端供应商",
       "mode_local_hint": " 需要提前安装 Ollama 并下载模型",
       "nav_hint": "↑↓ 选择 · Enter 确认 · Esc 返回",
       "provider_title": "选择 AI 模型提供商：",

package/src/shared/package-info.ts

@@ -9,7 +9,7 @@
 export const PACKAGE_NAME = '@miphamai/cli' as const
 
 /** 当前发布版本 */
-export const PACKAGE_VERSION = '0.81.0' as const
+export const PACKAGE_VERSION = '0.81.2' as const
 
 /** npm install 全局安装命令 */
 export const NPM_INSTALL_COMMAND = `npm install -g ${PACKAGE_NAME}` as const

package/src/tools/system/config.ts

@@ -1,9 +1,10 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
 import { join } from 'node:path'
+import { homedir } from 'node:os'
 import { parse as parseYaml, stringify } from 'yaml'
 import type { ToolDefinition } from '../../shared/index.ts'
 
-const MIPHAM_DIR = join(process.env.HOME || '~', '.mipham')
+const MIPHAM_DIR = join(homedir(), '.mipham')
 const USER_CONFIG = join(MIPHAM_DIR, 'config.yml')
 
 export const configTool: ToolDefinition = {

package/src/ui/chat.tsx

@@ -2,6 +2,7 @@ import React, { useMemo } from 'react'
 import { Box, Text } from 'ink'
 import { useI18n } from '../i18n-context'
 import type { ChatMessage } from './app'
+import { homedir } from 'node:os'
 
 interface ChatPanelProps {
   messages: ChatMessage[]
@@ -11,7 +12,7 @@ interface ChatPanelProps {
 /** Format cwd for display: replace HOME with ~, truncate if too long */
 function displayCwd(): string {
   const cwd = process.cwd()
-  const home = process.env.HOME || ''
+  const home = homedir()
   if (home && cwd.startsWith(home)) {
     return '~' + cwd.slice(home.length)
   }

package/src/ui/commands.ts

@@ -18,6 +18,7 @@ import { InstructionsLoader } from '../core/instructions'
 import { findDerivableSections, DERIVABLE_HINTS } from '../core/claude-md-audit'
 import { fixDoctor, fixConfig, fixCache, selectRepoClaudeFiles } from '../core/fix'
 import { fixCodeTarget } from '../core/fix-code'
+import { homedir } from 'node:os'
 import { runCrsiModification, approvePending, rejectPending, hasPending } from '../core/crsi-modify'
 import {
   produceCrsiProposal,
@@ -2573,7 +2574,7 @@ const installPluginCmd: CommandHandler = async (ctx, args) => {
 
   if (isLocalPath) {
     const { resolve } = await import('node:path')
-    const resolved = resolve(target.replace(/^~/, process.env.HOME || '~'))
+    const resolved = resolve(target.replace(/^~/, homedir()))
     result = manager.install(resolved)
   } else {
     // Treat as npm package name
@@ -2882,7 +2883,7 @@ const loopCmd: CommandHandler = async (ctx, args) => {
     const { scaffoldLoopKit } = await import('../commands/loop-scaffold')
     const { created, skipped } = scaffoldLoopKit(targetPath)
     const { resolve } = await import('node:path')
-    const resolved = resolve(targetPath.replace(/^~/, process.env.HOME || '~'))
+    const resolved = resolve(targetPath.replace(/^~/, homedir()))
 
     const lines: string[] = ['── LoopKit Vault Created ──', '', `Location: ${resolved}`, '']
 
@@ -3721,7 +3722,7 @@ const cdCmd: CommandHandler = async (ctx, args) => {
 
   const { existsSync } = await import('node:fs')
   const { resolve } = await import('node:path')
-  const resolved = resolve(target.replace(/^~/, process.env.HOME || '~'))
+  const resolved = resolve(target.replace(/^~/, homedir()))
 
   if (!existsSync(resolved)) {
     const suggestions = suggestDirectories(resolved)
@@ -4118,7 +4119,7 @@ const memoryCmd: CommandHandler = async (ctx, args) => {
   const { existsSync, readdirSync, readFileSync, statSync } = await import('node:fs')
   const { join } = await import('node:path')
 
-  const home = process.env.HOME || '~'
+  const home = homedir()
   const memoryDir = join(home, '.mipham', 'memory')
 
   // /memory gc — 记忆卫生：归档「0 召回 + 过期」的 auto-* 记忆（手写只报告）
@@ -4320,7 +4321,7 @@ const workflowsCmd: CommandHandler = async () => {
 
   const locations = [
     join(process.cwd(), '.claude', 'workflows'),
-    join(process.env.HOME || '~', '.claude', 'workflows'),
+    join(homedir(), '.claude', 'workflows'),
   ]
 
   const lines: string[] = ['─ Workflows ─', '']
@@ -4418,7 +4419,7 @@ const workflowRunCmd = async (name: string): Promise<CommandResult> => {
 
   const locations = [
     join(process.cwd(), '.claude', 'workflows'),
-    join(process.env.HOME || '~', '.claude', 'workflows'),
+    join(homedir(), '.claude', 'workflows'),
   ]
 
   for (const loc of locations) {
@@ -4739,7 +4740,7 @@ const logoutCmd: CommandHandler = async () => {
   const { existsSync } = await import('node:fs')
   const { join } = await import('node:path')
 
-  const home = process.env.HOME || '~'
+  const home = homedir()
   const userConfig = join(home, '.mipham', 'config.yml')
   const hasUserConfig = existsSync(userConfig)
 

package/src/ui/config-wizard.tsx

@@ -20,6 +20,7 @@ import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { execSync } from 'node:child_process'
 import { getCredentialKey, encryptApiKey } from '../config/credential-crypto'
+import { CLOUD_PROVIDERS, getActiveModels, buildConfigYaml } from '../config/wizard-config'
 
 // ── Types ──
 
@@ -32,24 +33,15 @@ interface Props {
 
 // ── Constants ──
 
-const CLOUD_PROVIDERS = DEFAULT_PROVIDERS.filter((p) => p.id !== 'ollama' && p.id !== 'mipham')
-
 const SELECTED_COLOR = 'cyan'
 
 // ── Helpers ──
 
-function getActiveModels(providerId: string): ModelInfo[] {
-  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
-  return provider?.models.filter((m) => m.status === 'active') || []
-}
-
 function writeConfigFile(providerId: string, modelId: string, apiKey: string): void {
   const configDir = join(homedir(), '.mipham')
   mkdirSync(configDir, { recursive: true })
 
-  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
-  const models =
-    providerId === 'ollama' ? getOllamaModelListForConfig() : getActiveModels(providerId)
+  const models = providerId === 'ollama' ? getOllamaModelListForConfig() : []
 
   function getOllamaModelListForConfig(): ModelInfo[] {
     // 与 getOllamaModelList 逻辑一致，但用于配置写入
@@ -97,26 +89,10 @@ function writeConfigFile(providerId: string, modelId: string, apiKey: string): v
   }
   const storedKey = encryptApiKey(apiKey, getCredentialKey(configDir))
 
-  const lines = [
-    '# Mipham Code Configuration',
-    `# Generated by Config Wizard — ${new Date().toISOString()}`,
-    '',
-    'version: 1',
-    `defaultProvider: ${providerId}`,
-    `defaultModel: ${modelId}`,
-    'permission: default',
-    '',
-    'providers:',
-    `  - id: ${providerId}`,
-    `    name: ${provider?.name || providerId}`,
-    `    protocol: ${provider?.protocol || 'openai-compatible'}`,
-    ...(provider?.baseUrl ? [`    baseUrl: ${provider.baseUrl}`] : []),
-    `    apiKey: ${storedKey}`,
-    `    models:`,
-    ...models.map((m) => `      - id: ${m.id}`),
-  ]
-
-  atomicWriteFileSync(join(configDir, 'config.yml'), lines.join('\n'))
+  atomicWriteFileSync(
+    join(configDir, 'config.yml'),
+    buildConfigYaml(providerId, modelId, storedKey, models),
+  )
 }
 
 function checkOllama(): { installed: boolean; running: boolean; models: string[] } {
@@ -409,7 +385,9 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
               {cursor === 0 ? '▶' : ' '} {t('ui.wizard.mode_cloud')}
             </Text>
           </Box>
-          <Text dimColor> Claude · DeepSeek · Gemini · 豆包 · Qwen · 混元 · OpenAI</Text>
+          <Text dimColor>
+            {t('ui.wizard.mode_cloud_hint', { count: String(CLOUD_PROVIDERS.length) })}
+          </Text>
 
           <Box marginTop={2} marginBottom={1}>
             <Text color={cursor === 1 ? SELECTED_COLOR : undefined}>