@within-7/minto 0.0.5-dev.1

package/dist/utils/pluginValidator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/pluginValidator.ts"],
+  "sourcesContent": ["/**\n * Plugin Validation System\n *\n * Validates plugin manifests and component files for correctness.\n * Checks for proper structure, required fields, and file existence.\n */\n\nimport fs from 'fs'\nimport path from 'path'\nimport matter from 'gray-matter'\nimport semver from 'semver'\nimport { z } from 'zod'\nimport { PluginManifestSchema, type PluginManifest, type HookEvent } from '../types/plugin.js'\n\n/**\n * Validation error details\n */\nexport interface ValidationError {\n  type: 'manifest' | 'agent' | 'command' | 'skill' | 'hook' | 'mcp' | 'dependency' | 'engine'\n  file?: string\n  message: string\n  details?: any\n}\n\n/**\n * Validation warning details\n */\nexport interface ValidationWarning {\n  type: string\n  file?: string\n  message: string\n}\n\n/**\n * Complete validation result\n */\nexport interface ValidationResult {\n  valid: boolean\n  errors: ValidationError[]\n  warnings: ValidationWarning[]\n}\n\n/**\n * Agent YAML frontmatter schema\n */\nconst AgentFrontmatterSchema = z.object({\n  name: z.string().min(1, 'Agent name is required'),\n  description: z.string().min(1, 'Agent description is required'),\n  tools: z.union([\n    z.string(), // \"*\" for all tools\n    z.array(z.string()).min(1, 'At least one tool must be specified'),\n  ]).optional(),\n  model: z.string().optional(),\n})\n\n/**\n * Command YAML frontmatter schema\n */\nconst CommandFrontmatterSchema = z.object({\n  name: z.string().min(1, 'Command name is required'),\n  description: z.string().optional(),\n  aliases: z.array(z.string()).optional(),\n  enabled: z.boolean().optional(),\n  hidden: z.boolean().optional(),\n  progressMessage: z.string().optional(),\n  argNames: z.array(z.string()).optional(),\n  'allowed-tools': z.array(z.string()).optional(),\n})\n\n/**\n * Skill YAML frontmatter schema\n */\nconst SkillFrontmatterSchema = z.object({\n  name: z.string().min(1, 'Skill name is required'),\n  description: z.string().min(1, 'Skill description is required'),\n})\n\n/**\n * Hook configuration schema\n */\nconst HookConfigSchema = z.object({\n  event: z.enum([\n    'PreToolUse',\n    'PostToolUse',\n    'UserPromptSubmit',\n    'SessionStart',\n    'SessionEnd',\n    'Stop',\n    'SubagentStop',\n    'Notification',\n    'PreCompact',\n  ] as const),\n  matcher: z.string().optional(),\n  type: z.enum(['command', 'message', 'notification']),\n  command: z.string().optional(),\n  message: z.string().optional(),\n  blocking: z.boolean().optional(),\n  timeout: z.number().optional(),\n})\n\n/**\n * MCP Server configuration schema\n */\nconst MCPServerConfigSchema = z.object({\n  command: z.string().min(1, 'MCP server command is required'),\n  args: z.array(z.string()).optional(),\n  env: z.record(z.string()).optional(),\n  timeout: z.number().optional(),\n})\n\n/**\n * Validate complete plugin including manifest and all components\n */\nexport async function validatePlugin(pluginPath: string): Promise<ValidationResult> {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check if plugin directory exists\n  if (!fs.existsSync(pluginPath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'manifest',\n        message: `Plugin directory does not exist: ${pluginPath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check if it's a directory\n  const stats = fs.statSync(pluginPath)\n  if (!stats.isDirectory()) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'manifest',\n        message: `Plugin path is not a directory: ${pluginPath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Validate manifest\n  const manifestPath = path.join(pluginPath, 'plugin.json')\n  if (!fs.existsSync(manifestPath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'manifest',\n        file: 'plugin.json',\n        message: 'Plugin manifest (plugin.json) not found',\n      }],\n      warnings: [],\n    }\n  }\n\n  let manifest: PluginManifest\n  try {\n    const manifestContent = fs.readFileSync(manifestPath, 'utf-8')\n    const manifestData = JSON.parse(manifestContent)\n\n    // Validate with Zod schema\n    const manifestResult = validateManifest(manifestData)\n    errors.push(...manifestResult.errors)\n    warnings.push(...manifestResult.warnings)\n\n    if (!manifestResult.valid) {\n      return { valid: false, errors, warnings }\n    }\n\n    manifest = manifestData as PluginManifest\n  } catch (error) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'manifest',\n        file: 'plugin.json',\n        message: `Failed to parse manifest: ${error instanceof Error ? error.message : String(error)}`,\n        details: error,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Validate engines compatibility\n  if (manifest.engines) {\n    const engineResult = await validateEngines(manifest.engines)\n    errors.push(...engineResult.errors)\n    warnings.push(...engineResult.warnings)\n  }\n\n  // Validate agent files\n  if (manifest.agents && manifest.agents.length > 0) {\n    for (const agentFile of manifest.agents) {\n      const agentPath = path.join(pluginPath, agentFile)\n      const result = validateAgentFile(agentPath)\n      errors.push(...result.errors)\n      warnings.push(...result.warnings)\n    }\n  }\n\n  // Validate command files\n  if (manifest.commands && manifest.commands.length > 0) {\n    for (const commandFile of manifest.commands) {\n      const commandPath = path.join(pluginPath, commandFile)\n      const result = validateCommandFile(commandPath)\n      errors.push(...result.errors)\n      warnings.push(...result.warnings)\n    }\n  }\n\n  // Validate skill files\n  if (manifest.skills && manifest.skills.length > 0) {\n    for (const skillFile of manifest.skills) {\n      const skillPath = path.join(pluginPath, skillFile)\n      const result = validateSkillFile(skillPath)\n      errors.push(...result.errors)\n      warnings.push(...result.warnings)\n    }\n  }\n\n  // Validate hook files\n  if (manifest.hooks && manifest.hooks.length > 0) {\n    for (const hookFile of manifest.hooks) {\n      const hookPath = path.join(pluginPath, hookFile)\n      const result = validateHookFile(hookPath)\n      errors.push(...result.errors)\n      warnings.push(...result.warnings)\n    }\n  }\n\n  // Validate MCP server configs\n  if (manifest.mcpServers && manifest.mcpServers.length > 0) {\n    for (const mcpFile of manifest.mcpServers) {\n      const mcpPath = path.join(pluginPath, mcpFile)\n      const result = validateMCPServerFile(mcpPath)\n      errors.push(...result.errors)\n      warnings.push(...result.warnings)\n    }\n  }\n\n  // Check for unused files warning\n  const componentFiles = new Set([\n    ...(manifest.agents || []),\n    ...(manifest.commands || []),\n    ...(manifest.skills || []),\n    ...(manifest.hooks || []),\n    ...(manifest.mcpServers || []),\n  ])\n\n  if (componentFiles.size === 0) {\n    warnings.push({\n      type: 'manifest',\n      message: 'Plugin has no components (agents, commands, skills, hooks, or MCP servers)',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate plugin manifest schema\n */\nexport function validateManifest(manifest: any): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check if manifest is an object\n  if (!manifest || typeof manifest !== 'object') {\n    return {\n      valid: false,\n      errors: [{\n        type: 'manifest',\n        message: 'Manifest must be a valid JSON object',\n      }],\n      warnings: [],\n    }\n  }\n\n  // Validate with Zod schema\n  try {\n    PluginManifestSchema.parse(manifest)\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      for (const issue of error.errors) {\n        errors.push({\n          type: 'manifest',\n          message: `${issue.path.join('.')}: ${issue.message}`,\n          details: issue,\n        })\n      }\n    } else {\n      errors.push({\n        type: 'manifest',\n        message: `Manifest validation failed: ${error instanceof Error ? error.message : String(error)}`,\n        details: error,\n      })\n    }\n  }\n\n  // Additional validations\n  if (manifest.name && !/^[a-z0-9-]+$/.test(manifest.name)) {\n    errors.push({\n      type: 'manifest',\n      message: 'Plugin name must be lowercase alphanumeric with hyphens only',\n      details: { name: manifest.name },\n    })\n  }\n\n  // Validate version format (semver)\n  if (manifest.version && !semver.valid(manifest.version)) {\n    errors.push({\n      type: 'manifest',\n      message: `Invalid version format: ${manifest.version}. Must follow semver (e.g., 1.0.0)`,\n      details: { version: manifest.version },\n    })\n  }\n\n  // Validate URLs\n  if (manifest.homepage) {\n    try {\n      new URL(manifest.homepage)\n    } catch {\n      errors.push({\n        type: 'manifest',\n        message: `Invalid homepage URL: ${manifest.homepage}`,\n      })\n    }\n  }\n\n  if (manifest.repository) {\n    try {\n      new URL(manifest.repository)\n    } catch {\n      errors.push({\n        type: 'manifest',\n        message: `Invalid repository URL: ${manifest.repository}`,\n      })\n    }\n  }\n\n  // Warn about missing optional but recommended fields\n  if (!manifest.description) {\n    warnings.push({\n      type: 'manifest',\n      message: 'Missing recommended field: description',\n    })\n  }\n\n  if (!manifest.author) {\n    warnings.push({\n      type: 'manifest',\n      message: 'Missing recommended field: author',\n    })\n  }\n\n  if (!manifest.license) {\n    warnings.push({\n      type: 'manifest',\n      message: 'Missing recommended field: license',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate engine version requirements\n */\nasync function validateEngines(engines: { minto?: string; 'claude-code'?: string; node?: string }): Promise<ValidationResult> {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Validate minto version\n  if (engines.minto) {\n    const validRange = semver.validRange(engines.minto)\n    if (!validRange) {\n      errors.push({\n        type: 'engine',\n        message: `Invalid minto version range: ${engines.minto}`,\n        details: { engine: 'minto', range: engines.minto },\n      })\n    } else {\n      // Check compatibility with current version\n      try {\n        const { VERSION } = await import('../version.js')\n        if (!semver.satisfies(VERSION, engines.minto)) {\n          warnings.push({\n            type: 'engine',\n            message: `Plugin requires minto ${engines.minto}, but current version is ${VERSION}`,\n          })\n        }\n      } catch {\n        // Unable to check current version, skip this validation\n      }\n    }\n  }\n\n  // Validate node version\n  if (engines.node) {\n    const validRange = semver.validRange(engines.node)\n    if (!validRange) {\n      errors.push({\n        type: 'engine',\n        message: `Invalid node version range: ${engines.node}`,\n        details: { engine: 'node', range: engines.node },\n      })\n    } else {\n      // Check compatibility with current node version\n      if (!semver.satisfies(process.version, engines.node)) {\n        warnings.push({\n          type: 'engine',\n          message: `Plugin requires node ${engines.node}, but current version is ${process.version}`,\n        })\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate agent file\n */\nexport function validateAgentFile(filePath: string): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check file exists\n  if (!fs.existsSync(filePath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'agent',\n        file: filePath,\n        message: `Agent file not found: ${filePath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check file extension\n  const ext = path.extname(filePath)\n  if (ext !== '.md' && ext !== '.markdown') {\n    warnings.push({\n      type: 'agent',\n      file: filePath,\n      message: `Agent file should have .md or .markdown extension, got: ${ext}`,\n    })\n  }\n\n  // Parse YAML frontmatter\n  try {\n    const content = fs.readFileSync(filePath, 'utf-8')\n    const parsed = matter(content)\n\n    // Validate frontmatter exists\n    if (!parsed.data || Object.keys(parsed.data).length === 0) {\n      errors.push({\n        type: 'agent',\n        file: filePath,\n        message: 'Agent file must have YAML frontmatter',\n      })\n      return { valid: false, errors, warnings }\n    }\n\n    // Validate frontmatter schema\n    try {\n      AgentFrontmatterSchema.parse(parsed.data)\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        for (const issue of error.errors) {\n          errors.push({\n            type: 'agent',\n            file: filePath,\n            message: `Frontmatter ${issue.path.join('.')}: ${issue.message}`,\n            details: issue,\n          })\n        }\n      }\n    }\n\n    // Check for content\n    if (!parsed.content || parsed.content.trim().length === 0) {\n      warnings.push({\n        type: 'agent',\n        file: filePath,\n        message: 'Agent file has no content after frontmatter',\n      })\n    }\n\n    // Validate tools field\n    if (parsed.data.tools) {\n      if (Array.isArray(parsed.data.tools)) {\n        if (parsed.data.tools.length === 0) {\n          errors.push({\n            type: 'agent',\n            file: filePath,\n            message: 'Tools array cannot be empty (use \"*\" for all tools or omit the field)',\n          })\n        }\n      } else if (parsed.data.tools !== '*') {\n        errors.push({\n          type: 'agent',\n          file: filePath,\n          message: 'Tools must be an array of tool names or \"*\" for all tools',\n          details: { tools: parsed.data.tools },\n        })\n      }\n    }\n\n  } catch (error) {\n    errors.push({\n      type: 'agent',\n      file: filePath,\n      message: `Failed to parse agent file: ${error instanceof Error ? error.message : String(error)}`,\n      details: error,\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate command file\n */\nexport function validateCommandFile(filePath: string): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check file exists\n  if (!fs.existsSync(filePath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'command',\n        file: filePath,\n        message: `Command file not found: ${filePath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check file extension\n  const ext = path.extname(filePath)\n  if (ext !== '.md' && ext !== '.markdown') {\n    warnings.push({\n      type: 'command',\n      file: filePath,\n      message: `Command file should have .md or .markdown extension, got: ${ext}`,\n    })\n  }\n\n  // Parse YAML frontmatter\n  try {\n    const content = fs.readFileSync(filePath, 'utf-8')\n    const parsed = matter(content)\n\n    // Validate frontmatter exists\n    if (!parsed.data || Object.keys(parsed.data).length === 0) {\n      errors.push({\n        type: 'command',\n        file: filePath,\n        message: 'Command file must have YAML frontmatter',\n      })\n      return { valid: false, errors, warnings }\n    }\n\n    // Validate frontmatter schema\n    try {\n      CommandFrontmatterSchema.parse(parsed.data)\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        for (const issue of error.errors) {\n          errors.push({\n            type: 'command',\n            file: filePath,\n            message: `Frontmatter ${issue.path.join('.')}: ${issue.message}`,\n            details: issue,\n          })\n        }\n      }\n    }\n\n    // Check for content\n    if (!parsed.content || parsed.content.trim().length === 0) {\n      warnings.push({\n        type: 'command',\n        file: filePath,\n        message: 'Command file has no content after frontmatter',\n      })\n    }\n\n    // Validate name matches filename\n    const filename = path.basename(filePath, path.extname(filePath))\n    if (parsed.data.name && parsed.data.name !== filename) {\n      warnings.push({\n        type: 'command',\n        file: filePath,\n        message: `Command name \"${parsed.data.name}\" does not match filename \"${filename}\"`,\n      })\n    }\n\n  } catch (error) {\n    errors.push({\n      type: 'command',\n      file: filePath,\n      message: `Failed to parse command file: ${error instanceof Error ? error.message : String(error)}`,\n      details: error,\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate skill file\n */\nexport function validateSkillFile(filePath: string): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check file exists\n  if (!fs.existsSync(filePath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'skill',\n        file: filePath,\n        message: `Skill file not found: ${filePath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check file extension\n  const ext = path.extname(filePath)\n  if (ext !== '.md' && ext !== '.markdown') {\n    warnings.push({\n      type: 'skill',\n      file: filePath,\n      message: `Skill file should have .md or .markdown extension, got: ${ext}`,\n    })\n  }\n\n  // Parse YAML frontmatter\n  try {\n    const content = fs.readFileSync(filePath, 'utf-8')\n    const parsed = matter(content)\n\n    // Validate frontmatter exists\n    if (!parsed.data || Object.keys(parsed.data).length === 0) {\n      errors.push({\n        type: 'skill',\n        file: filePath,\n        message: 'Skill file must have YAML frontmatter',\n      })\n      return { valid: false, errors, warnings }\n    }\n\n    // Validate frontmatter schema\n    try {\n      SkillFrontmatterSchema.parse(parsed.data)\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        for (const issue of error.errors) {\n          errors.push({\n            type: 'skill',\n            file: filePath,\n            message: `Frontmatter ${issue.path.join('.')}: ${issue.message}`,\n            details: issue,\n          })\n        }\n      }\n    }\n\n    // Check for content\n    if (!parsed.content || parsed.content.trim().length === 0) {\n      warnings.push({\n        type: 'skill',\n        file: filePath,\n        message: 'Skill file has no content after frontmatter',\n      })\n    }\n\n  } catch (error) {\n    errors.push({\n      type: 'skill',\n      file: filePath,\n      message: `Failed to parse skill file: ${error instanceof Error ? error.message : String(error)}`,\n      details: error,\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate hook file\n */\nexport function validateHookFile(filePath: string): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check file exists\n  if (!fs.existsSync(filePath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'hook',\n        file: filePath,\n        message: `Hook file not found: ${filePath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check file extension\n  const ext = path.extname(filePath)\n  const validExtensions = ['.js', '.mjs', '.ts', '.tsx', '.json']\n  if (!validExtensions.includes(ext)) {\n    errors.push({\n      type: 'hook',\n      file: filePath,\n      message: `Hook file must have extension: ${validExtensions.join(', ')}. Got: ${ext}`,\n    })\n    return { valid: false, errors, warnings }\n  }\n\n  // For JSON hook configs, validate structure\n  if (ext === '.json') {\n    try {\n      const content = fs.readFileSync(filePath, 'utf-8')\n      const config = JSON.parse(content)\n\n      // Validate hook config schema\n      try {\n        HookConfigSchema.parse(config)\n      } catch (error) {\n        if (error instanceof z.ZodError) {\n          for (const issue of error.errors) {\n            errors.push({\n              type: 'hook',\n              file: filePath,\n              message: `Hook config ${issue.path.join('.')}: ${issue.message}`,\n              details: issue,\n            })\n          }\n        }\n      }\n\n      // Type-specific validation\n      if (config.type === 'command' && !config.command) {\n        errors.push({\n          type: 'hook',\n          file: filePath,\n          message: 'Hook type \"command\" requires a \"command\" field',\n        })\n      }\n\n      if (config.type === 'message' && !config.message) {\n        errors.push({\n          type: 'hook',\n          file: filePath,\n          message: 'Hook type \"message\" requires a \"message\" field',\n        })\n      }\n\n    } catch (error) {\n      errors.push({\n        type: 'hook',\n        file: filePath,\n        message: `Failed to parse hook config: ${error instanceof Error ? error.message : String(error)}`,\n        details: error,\n      })\n    }\n  } else {\n    // For JS/TS files, just check they're readable\n    try {\n      fs.readFileSync(filePath, 'utf-8')\n    } catch (error) {\n      errors.push({\n        type: 'hook',\n        file: filePath,\n        message: `Failed to read hook file: ${error instanceof Error ? error.message : String(error)}`,\n        details: error,\n      })\n    }\n\n    // Warn about JS/TS hooks needing runtime validation\n    warnings.push({\n      type: 'hook',\n      file: filePath,\n      message: 'JavaScript/TypeScript hooks will be validated at runtime',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate MCP server configuration file\n */\nexport function validateMCPServerFile(filePath: string): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  // Check file exists\n  if (!fs.existsSync(filePath)) {\n    return {\n      valid: false,\n      errors: [{\n        type: 'mcp',\n        file: filePath,\n        message: `MCP server config file not found: ${filePath}`,\n      }],\n      warnings: [],\n    }\n  }\n\n  // Check file extension\n  const ext = path.extname(filePath)\n  if (ext !== '.json') {\n    errors.push({\n      type: 'mcp',\n      file: filePath,\n      message: `MCP server config must be a JSON file, got: ${ext}`,\n    })\n    return { valid: false, errors, warnings }\n  }\n\n  // Parse and validate JSON\n  try {\n    const content = fs.readFileSync(filePath, 'utf-8')\n    const config = JSON.parse(content)\n\n    // Validate MCP config schema\n    try {\n      MCPServerConfigSchema.parse(config)\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        for (const issue of error.errors) {\n          errors.push({\n            type: 'mcp',\n            file: filePath,\n            message: `MCP config ${issue.path.join('.')}: ${issue.message}`,\n            details: issue,\n          })\n        }\n      }\n    }\n\n    // Validate command is not empty\n    if (config.command && config.command.trim().length === 0) {\n      errors.push({\n        type: 'mcp',\n        file: filePath,\n        message: 'MCP server command cannot be empty',\n      })\n    }\n\n    // Warn about timeout\n    if (config.timeout && config.timeout < 1000) {\n      warnings.push({\n        type: 'mcp',\n        file: filePath,\n        message: `MCP server timeout is very low (${config.timeout}ms), consider increasing`,\n      })\n    }\n\n  } catch (error) {\n    errors.push({\n      type: 'mcp',\n      file: filePath,\n      message: `Failed to parse MCP server config: ${error instanceof Error ? error.message : String(error)}`,\n      details: error,\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Validate plugin dependencies\n */\nexport function validateDependencies(\n  dependencies: Record<string, string>,\n  installedPackages?: Set<string>\n): ValidationResult {\n  const errors: ValidationError[] = []\n  const warnings: ValidationWarning[] = []\n\n  for (const [pkg, version] of Object.entries(dependencies)) {\n    // Validate version format\n    const validRange = semver.validRange(version)\n    if (!validRange) {\n      errors.push({\n        type: 'dependency',\n        message: `Invalid version range for ${pkg}: ${version}`,\n        details: { package: pkg, version },\n      })\n    }\n\n    // Check if installed (if provided)\n    if (installedPackages && !installedPackages.has(pkg)) {\n      warnings.push({\n        type: 'dependency',\n        message: `Dependency not installed: ${pkg}@${version}`,\n      })\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n\n/**\n * Batch validate multiple plugins\n */\nexport async function validatePlugins(pluginPaths: string[]): Promise<Map<string, ValidationResult>> {\n  const results = new Map<string, ValidationResult>()\n\n  await Promise.all(\n    pluginPaths.map(async (pluginPath) => {\n      const result = await validatePlugin(pluginPath)\n      results.set(pluginPath, result)\n    })\n  )\n\n  return results\n}\n\n/**\n * Format validation result as human-readable string\n */\nexport function formatValidationResult(result: ValidationResult, pluginName?: string): string {\n  const lines: string[] = []\n\n  if (pluginName) {\n    lines.push(`Plugin: ${pluginName}`)\n  }\n\n  if (result.valid) {\n    lines.push('\u2713 Validation passed')\n  } else {\n    lines.push(`\u2717 Validation failed with ${result.errors.length} error(s)`)\n  }\n\n  if (result.errors.length > 0) {\n    lines.push('\\nErrors:')\n    for (const error of result.errors) {\n      const location = error.file ? ` (${error.file})` : ''\n      lines.push(`  \u2022 [${error.type}]${location} ${error.message}`)\n    }\n  }\n\n  if (result.warnings.length > 0) {\n    lines.push('\\nWarnings:')\n    for (const warning of result.warnings) {\n      const location = warning.file ? ` (${warning.file})` : ''\n      lines.push(`  \u2022 [${warning.type}]${location} ${warning.message}`)\n    }\n  }\n\n  return lines.join('\\n')\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/ptyCompat.js

@@ -0,0 +1,125 @@
+function validateRawModeSupport(stream) {
+  if (!stream.isTTY) {
+    return {
+      supported: false,
+      reason: "Not a TTY device",
+      environmentHint: "piped input or redirected stream"
+    };
+  }
+  if (typeof stream.setRawMode !== "function") {
+    return {
+      supported: false,
+      reason: "setRawMode method not available",
+      environmentHint: "non-standard TTY implementation"
+    };
+  }
+  try {
+    const ttyStream = stream;
+    ttyStream.setRawMode(true);
+    ttyStream.setRawMode(false);
+    return { supported: true };
+  } catch (err) {
+    const error = err;
+    const errorCode = error.code || "UNKNOWN";
+    const errorMsg = error.message || "Unknown error";
+    let environmentHint = "incompatible terminal environment";
+    if (errorCode === "EIO") {
+      environmentHint = "Docker container, VS Code terminal, or nested tmux/screen";
+    } else if (errorCode === "ENOTTY") {
+      environmentHint = "not connected to a terminal device";
+    }
+    return {
+      supported: false,
+      reason: `setRawMode failed: ${errorCode} - ${errorMsg}`,
+      environmentHint
+    };
+  }
+}
+function requireRawModeOrExit(stream, exitOnFailure = true) {
+  const result = validateRawModeSupport(stream);
+  if (!result.supported) {
+    console.error("");
+    console.error("\u274C Interactive mode is not supported in this environment");
+    console.error(`   Reason: ${result.reason}`);
+    if (result.environmentHint) {
+      console.error(`   Likely: ${result.environmentHint}`);
+    }
+    console.error("");
+    console.error("\u{1F4CB} Solutions:");
+    console.error("   1. Use a native terminal application:");
+    console.error("      \u2022 macOS: Terminal.app, iTerm2, Warp");
+    console.error("      \u2022 Linux: GNOME Terminal, Konsole, xterm");
+    console.error("      \u2022 Windows: Windows Terminal, ConEmu");
+    console.error("");
+    console.error("   2. Skip interactive onboarding:");
+    console.error('      export ANTHROPIC_API_KEY="sk-ant-..."');
+    console.error("      minto config set -g hasCompletedOnboarding true");
+    console.error("");
+    console.error("   3. Use non-interactive mode:");
+    console.error('      minto --print "your prompt here"');
+    console.error('      echo "prompt" | minto');
+    console.error("");
+    if (exitOnFailure) {
+      process.exit(1);
+    }
+    return false;
+  }
+  return true;
+}
+function describeTerminalEnvironment() {
+  const descriptions = [];
+  if (process.stdin.isTTY) {
+    descriptions.push("TTY");
+  } else {
+    descriptions.push("non-TTY");
+  }
+  if (process.env.TERM) {
+    descriptions.push(`TERM=${process.env.TERM}`);
+  }
+  if (process.env.TERM_PROGRAM) {
+    descriptions.push(`${process.env.TERM_PROGRAM}`);
+  }
+  if (process.env.VSCODE_INJECTION) {
+    descriptions.push("VS Code terminal");
+  }
+  if (process.env.TMUX) {
+    descriptions.push("tmux session");
+  }
+  if (process.env.STY) {
+    descriptions.push("GNU screen");
+  }
+  try {
+    const fs = require("fs");
+    if (fs.existsSync("/.dockerenv")) {
+      descriptions.push("Docker container");
+    }
+  } catch {
+  }
+  return descriptions.join(", ");
+}
+function logTerminalDiagnostics() {
+  console.log("");
+  console.log("\u{1F50D} Terminal Environment Diagnostics:");
+  console.log(`   Description: ${describeTerminalEnvironment()}`);
+  console.log(`   stdin.isTTY: ${process.stdin.isTTY}`);
+  console.log(`   stdout.isTTY: ${process.stdout.isTTY}`);
+  console.log(
+    `   setRawMode available: ${typeof process.stdin.setRawMode === "function"}`
+  );
+  const result = validateRawModeSupport(process.stdin);
+  console.log(`   Raw mode supported: ${result.supported}`);
+  if (!result.supported) {
+    console.log(`   Reason: ${result.reason}`);
+    if (result.environmentHint) {
+      console.log(`   Hint: ${result.environmentHint}`);
+    }
+  }
+  console.log("");
+}
+export {
+  describeTerminalEnvironment,
+  logTerminalDiagnostics,
+  requireRawModeOrExit,
+  validateRawModeSupport
+};
+//# sourceMappingURL=ptyCompat.js.map

package/dist/utils/ptyCompat.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/ptyCompat.ts"],
+  "sourcesContent": ["/**\n * PTY Compatibility Utilities\n *\n * This module provides utilities to detect and handle environments where\n * setRawMode is not supported (e.g., Docker containers, VS Code terminals,\n * SSH sessions with incomplete TTY forwarding, etc.)\n */\n\nimport { ReadStream } from 'tty'\n\nexport interface RawModeCheckResult {\n  supported: boolean\n  reason?: string\n  environmentHint?: string\n}\n\n/**\n * Validate if a stream truly supports raw mode\n *\n * Note: Some environments report isTTY=true but still fail on setRawMode\n * with EIO errors. This function performs an actual test.\n *\n * @param stream - The input stream to test (usually process.stdin)\n * @returns Check result with support status and diagnostic info\n */\nexport function validateRawModeSupport(\n  stream: NodeJS.ReadStream,\n): RawModeCheckResult {\n  // Check 1: Must be a TTY\n  if (!stream.isTTY) {\n    return {\n      supported: false,\n      reason: 'Not a TTY device',\n      environmentHint: 'piped input or redirected stream',\n    }\n  }\n\n  // Check 2: Must have setRawMode method\n  if (typeof (stream as any).setRawMode !== 'function') {\n    return {\n      supported: false,\n      reason: 'setRawMode method not available',\n      environmentHint: 'non-standard TTY implementation',\n    }\n  }\n\n  // Check 3: Actually test setRawMode (catches EIO errors)\n  try {\n    const ttyStream = stream as ReadStream\n    ttyStream.setRawMode(true)\n    ttyStream.setRawMode(false)\n    return { supported: true }\n  } catch (err) {\n    const error = err as NodeJS.ErrnoException\n    const errorCode = error.code || 'UNKNOWN'\n    const errorMsg = error.message || 'Unknown error'\n\n    // Detect common problematic environments\n    let environmentHint = 'incompatible terminal environment'\n\n    if (errorCode === 'EIO') {\n      // EIO is the most common error in problematic PTY environments\n      environmentHint = 'Docker container, VS Code terminal, or nested tmux/screen'\n    } else if (errorCode === 'ENOTTY') {\n      environmentHint = 'not connected to a terminal device'\n    }\n\n    return {\n      supported: false,\n      reason: `setRawMode failed: ${errorCode} - ${errorMsg}`,\n      environmentHint,\n    }\n  }\n}\n\n/**\n * Quick check function that exits the process if raw mode is not supported\n * Use this for commands that absolutely require interactive mode\n *\n * @param stream - The input stream to check\n * @param exitOnFailure - Whether to exit process on failure (default: true)\n */\nexport function requireRawModeOrExit(\n  stream: NodeJS.ReadStream,\n  exitOnFailure = true,\n): boolean {\n  const result = validateRawModeSupport(stream)\n\n  if (!result.supported) {\n    console.error('')\n    console.error('\u274C Interactive mode is not supported in this environment')\n    console.error(`   Reason: ${result.reason}`)\n    if (result.environmentHint) {\n      console.error(`   Likely: ${result.environmentHint}`)\n    }\n    console.error('')\n    console.error('\uD83D\uDCCB Solutions:')\n    console.error('   1. Use a native terminal application:')\n    console.error('      \u2022 macOS: Terminal.app, iTerm2, Warp')\n    console.error('      \u2022 Linux: GNOME Terminal, Konsole, xterm')\n    console.error('      \u2022 Windows: Windows Terminal, ConEmu')\n    console.error('')\n    console.error('   2. Skip interactive onboarding:')\n    console.error('      export ANTHROPIC_API_KEY=\"sk-ant-...\"')\n    console.error('      minto config set -g hasCompletedOnboarding true')\n    console.error('')\n    console.error('   3. Use non-interactive mode:')\n    console.error('      minto --print \"your prompt here\"')\n    console.error('      echo \"prompt\" | minto')\n    console.error('')\n\n    if (exitOnFailure) {\n      process.exit(1)\n    }\n    return false\n  }\n\n  return true\n}\n\n/**\n * Get a user-friendly description of the current terminal environment\n */\nexport function describeTerminalEnvironment(): string {\n  const descriptions: string[] = []\n\n  if (process.stdin.isTTY) {\n    descriptions.push('TTY')\n  } else {\n    descriptions.push('non-TTY')\n  }\n\n  if (process.env.TERM) {\n    descriptions.push(`TERM=${process.env.TERM}`)\n  }\n\n  if (process.env.TERM_PROGRAM) {\n    descriptions.push(`${process.env.TERM_PROGRAM}`)\n  }\n\n  // Detect common environments\n  if (process.env.VSCODE_INJECTION) {\n    descriptions.push('VS Code terminal')\n  }\n\n  if (process.env.TMUX) {\n    descriptions.push('tmux session')\n  }\n\n  if (process.env.STY) {\n    descriptions.push('GNU screen')\n  }\n\n  // Check if running in Docker\n  try {\n    const fs = require('fs')\n    if (fs.existsSync('/.dockerenv')) {\n      descriptions.push('Docker container')\n    }\n  } catch {\n    // Ignore\n  }\n\n  return descriptions.join(', ')\n}\n\n/**\n * Log diagnostic information about the terminal environment\n * Useful for debugging PTY compatibility issues\n */\nexport function logTerminalDiagnostics(): void {\n  console.log('')\n  console.log('\uD83D\uDD0D Terminal Environment Diagnostics:')\n  console.log(`   Description: ${describeTerminalEnvironment()}`)\n  console.log(`   stdin.isTTY: ${process.stdin.isTTY}`)\n  console.log(`   stdout.isTTY: ${process.stdout.isTTY}`)\n  console.log(\n    `   setRawMode available: ${typeof (process.stdin as any).setRawMode === 'function'}`,\n  )\n\n  const result = validateRawModeSupport(process.stdin)\n  console.log(`   Raw mode supported: ${result.supported}`)\n  if (!result.supported) {\n    console.log(`   Reason: ${result.reason}`)\n    if (result.environmentHint) {\n      console.log(`   Hint: ${result.environmentHint}`)\n    }\n  }\n  console.log('')\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/replStateMachine.js

@@ -0,0 +1,145 @@
+import { useState, useCallback } from "react";
+function useREPLStateMachine(initialState = { type: "Idle" }) {
+  const [state, setState] = useState(initialState);
+  const transitions = {
+    /** 转到空闲状态 */
+    toIdle: useCallback(() => {
+      setState({ type: "Idle" });
+    }, []),
+    /** 转到用户输入状态 */
+    toUserTyping: useCallback(() => {
+      setState({ type: "UserTyping" });
+    }, []),
+    /** 转到用户已提交状态 */
+    toUserSubmitted: useCallback(() => {
+      setState({ type: "UserSubmitted" });
+    }, []),
+    /** 转到 AI 思考状态 */
+    toAgentThinking: useCallback((message, spinnerFrame) => {
+      setState({ type: "AgentThinking", message, spinnerFrame });
+    }, []),
+    /** 更新思考消息 (原地更新，不改变状态类型) */
+    updateThinkingMessage: useCallback(
+      (message, spinnerFrame) => {
+        setState((prev) => {
+          if (prev.type === "AgentThinking") {
+            return { ...prev, message, spinnerFrame };
+          }
+          return prev;
+        });
+      },
+      []
+    ),
+    /** 转到工具提议状态 */
+    toAgentProposingTool: useCallback(
+      (toolUse, toolJSX) => {
+        setState({ type: "AgentProposingTool", toolUse, toolJSX });
+      },
+      []
+    ),
+    /** 转到工具执行状态 */
+    toToolExecuting: useCallback(
+      (toolUse, output) => {
+        setState({ type: "ToolExecuting", toolUse, output });
+      },
+      []
+    ),
+    /** 更新工具执行输出 (原地更新) */
+    updateToolOutput: useCallback((output) => {
+      setState((prev) => {
+        if (prev.type === "ToolExecuting") {
+          return { ...prev, output };
+        }
+        return prev;
+      });
+    }, []),
+    /** 转到 AI 回答状态 */
+    toAgentResponding: useCallback(
+      (streamingText, isComplete) => {
+        setState({ type: "AgentResponding", streamingText, isComplete });
+      },
+      []
+    ),
+    /** 更新流式回答文本 (原地更新) */
+    updateStreamingText: useCallback(
+      (streamingText, isComplete) => {
+        setState((prev) => {
+          if (prev.type === "AgentResponding") {
+            return { ...prev, streamingText, isComplete };
+          }
+          return prev;
+        });
+      },
+      []
+    ),
+    /** 转到二元反馈状态 */
+    toBinaryFeedback: useCallback((context) => {
+      setState({ type: "BinaryFeedback", context });
+    }, []),
+    /** 转到错误状态 */
+    toError: useCallback((error, canRecover = true) => {
+      setState({ type: "Error", error, canRecover });
+    }, []),
+    /** 转到消息选择器状态 */
+    toMessageSelector: useCallback(() => {
+      setState({ type: "MessageSelector" });
+    }, [])
+  };
+  const is = {
+    idle: state.type === "Idle",
+    userTyping: state.type === "UserTyping",
+    userSubmitted: state.type === "UserSubmitted",
+    agentThinking: state.type === "AgentThinking",
+    agentProposingTool: state.type === "AgentProposingTool",
+    toolExecuting: state.type === "ToolExecuting",
+    agentResponding: state.type === "AgentResponding",
+    binaryFeedback: state.type === "BinaryFeedback",
+    error: state.type === "Error",
+    messageSelector: state.type === "MessageSelector",
+    /** 是否可以接受用户输入 */
+    canAcceptInput: state.type === "Idle" || state.type === "UserTyping" || state.type === "Error",
+    /** 是否正在加载 (思考、执行、回答) */
+    loading: state.type === "AgentThinking" || state.type === "ToolExecuting" || state.type === "AgentResponding" || state.type === "UserSubmitted",
+    /** 是否需要用户交互 (确认工具、二元反馈、消息选择) */
+    needsUserInteraction: state.type === "AgentProposingTool" || state.type === "BinaryFeedback" || state.type === "MessageSelector"
+  };
+  return {
+    /** 当前状态 */
+    state,
+    /** 状态转换函数 */
+    transitions,
+    /** 状态查询辅助 */
+    is,
+    /** 直接设置状态 (高级用法) */
+    setState
+  };
+}
+function getStateName(state) {
+  switch (state.type) {
+    case "Idle":
+      return "\u23F8 Idle";
+    case "UserTyping":
+      return "\u2328\uFE0F UserTyping";
+    case "UserSubmitted":
+      return "\u23F3 UserSubmitted";
+    case "AgentThinking":
+      return `\u{1F914} AgentThinking: ${state.message}`;
+    case "AgentProposingTool":
+      return `\u{1F527} AgentProposingTool: ${state.toolUse.name}`;
+    case "ToolExecuting":
+      return `\u2699\uFE0F ToolExecuting: ${state.toolUse.name}`;
+    case "AgentResponding":
+      return `\u{1F4AC} AgentResponding (${state.streamingText.length} chars)`;
+    case "BinaryFeedback":
+      return "\u{1F937} BinaryFeedback";
+    case "Error":
+      return `\u274C Error: ${state.error}`;
+    case "MessageSelector":
+      return "\u{1F4DC} MessageSelector";
+  }
+}
+export {
+  getStateName,
+  useREPLStateMachine
+};
+//# sourceMappingURL=replStateMachine.js.map

package/dist/utils/replStateMachine.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/replStateMachine.ts"],
+  "sourcesContent": ["/**\n * REPL \u72B6\u6001\u673A - Claude Code CLI \u98CE\u683C\n *\n * \u6838\u5FC3\u7406\u5FF5\uFF1A\n * 1. \u663E\u5F0F\u72B6\u6001 - \u6E05\u6670\u5B9A\u4E49\u6BCF\u4E2A REPL \u72B6\u6001\n * 2. \u72B6\u6001\u8F6C\u6362 - \u660E\u786E\u7684\u72B6\u6001\u8F6C\u6362\u51FD\u6570\n * 3. \u6E32\u67D3\u9694\u79BB - \u6BCF\u4E2A\u72B6\u6001\u5BF9\u5E94\u72EC\u7ACB\u7684 UI \u6E32\u67D3\n * 4. \u4E92\u65A5\u4FDD\u8BC1 - \u540C\u4E00\u65F6\u95F4\u53EA\u6709\u4E00\u4E2A\u6D3B\u8DC3\u72B6\u6001\n *\n * \u8FD9\u6D88\u9664\u4E86 REPL.tsx \u4E2D\u590D\u6742\u7684 flag \u7EC4\u5408\u903B\u8F91\n */\n\nimport * as React from 'react'\nimport { useState, useCallback } from 'react'\nimport type { ToolUseBlockParam } from '@anthropic-ai/sdk/resources/index.mjs'\nimport type { BinaryFeedbackContext } from '@screens/REPL'\n\n/**\n * REPL \u7684\u6240\u6709\u53EF\u80FD\u72B6\u6001\n *\n * \u57FA\u4E8E Claude Code CLI \u7684\u72B6\u6001\u673A\u8BBE\u8BA1\n */\nexport type REPLState =\n  /** \u7A7A\u95F2 - \u7B49\u5F85\u7528\u6237\u8F93\u5165 */\n  | { type: 'Idle' }\n\n  /** \u7528\u6237\u8F93\u5165\u4E2D - \u7528\u6237\u6B63\u5728\u5E95\u90E8\u8F93\u5165\u6846\u952E\u5165 */\n  | { type: 'UserTyping' }\n\n  /** \u7528\u6237\u5DF2\u63D0\u4EA4 - \u7B49\u5F85 AI \u5904\u7406 */\n  | { type: 'UserSubmitted' }\n\n  /** AI \u601D\u8003\u4E2D - \u8BFB\u53D6\u6587\u4EF6\u3001\u5206\u6790\u4EE3\u7801\u7B49 */\n  | {\n      type: 'AgentThinking'\n      /** \u5F53\u524D\u601D\u8003\u9636\u6BB5\u7684\u6D88\u606F (\u4F8B\u5982\uFF1A\"Reading file...\", \"Analyzing code...\") */\n      message: string\n      /** Spinner \u52A8\u753B\u5E27\u7D22\u5F15 */\n      spinnerFrame?: number\n    }\n\n  /** AI \u63D0\u8BAE\u5DE5\u5177\u6267\u884C - \u7B49\u5F85\u7528\u6237\u786E\u8BA4 */\n  | {\n      type: 'AgentProposingTool'\n      /** \u8981\u6267\u884C\u7684\u5DE5\u5177\u8C03\u7528 */\n      toolUse: ToolUseBlockParam\n      /** \u5DE5\u5177\u7684 JSX \u5C55\u793A (\u53EF\u9009\uFF0C\u7528\u4E8E\u590D\u6742\u7684\u5DE5\u5177 UI) */\n      toolJSX?: React.ReactNode\n    }\n\n  /** \u5DE5\u5177\u6267\u884C\u4E2D - \u547D\u4EE4\u8FD0\u884C\u3001\u6587\u4EF6\u4FEE\u6539\u7B49 */\n  | {\n      type: 'ToolExecuting'\n      /** \u6B63\u5728\u6267\u884C\u7684\u5DE5\u5177\u8C03\u7528 */\n      toolUse: ToolUseBlockParam\n      /** \u5B9E\u65F6\u8F93\u51FA */\n      output?: string\n    }\n\n  /** AI \u56DE\u7B54\u4E2D - \u6D41\u5F0F\u8F93\u51FA\u6700\u7EC8\u56DE\u590D */\n  | {\n      type: 'AgentResponding'\n      /** \u5F53\u524D\u5DF2\u63A5\u6536\u7684\u6587\u672C */\n      streamingText: string\n      /** \u662F\u5426\u5B8C\u6210 */\n      isComplete: boolean\n    }\n\n  /** \u4E8C\u5143\u53CD\u9988 - A/B \u6D4B\u8BD5\u9009\u62E9 */\n  | {\n      type: 'BinaryFeedback'\n      context: BinaryFeedbackContext\n    }\n\n  /** \u9519\u8BEF - \u663E\u793A\u9519\u8BEF\u4FE1\u606F */\n  | {\n      type: 'Error'\n      error: string\n      /** \u53EF\u4EE5\u4ECE\u9519\u8BEF\u6062\u590D\u5230\u7A7A\u95F2\u72B6\u6001 */\n      canRecover: boolean\n    }\n\n  /** \u6D88\u606F\u9009\u62E9\u5668 - \u7528\u6237\u6D4F\u89C8\u5386\u53F2\u6D88\u606F */\n  | { type: 'MessageSelector' }\n\n/**\n * REPL \u72B6\u6001\u673A Hook\n *\n * \u63D0\u4F9B\u6E05\u6670\u7684\u72B6\u6001\u7BA1\u7406\u548C\u8F6C\u6362\u63A5\u53E3\n */\nexport function useREPLStateMachine(\n  initialState: REPLState = { type: 'Idle' },\n) {\n  const [state, setState] = useState<REPLState>(initialState)\n\n  /**\n   * \u72B6\u6001\u8F6C\u6362\u51FD\u6570\u96C6\u5408\n   *\n   * \u6BCF\u4E2A\u51FD\u6570\u5BF9\u5E94\u4E00\u4E2A\u660E\u786E\u7684\u72B6\u6001\u8F6C\u6362\u52A8\u4F5C\n   */\n  const transitions = {\n    /** \u8F6C\u5230\u7A7A\u95F2\u72B6\u6001 */\n    toIdle: useCallback(() => {\n      setState({ type: 'Idle' })\n    }, []),\n\n    /** \u8F6C\u5230\u7528\u6237\u8F93\u5165\u72B6\u6001 */\n    toUserTyping: useCallback(() => {\n      setState({ type: 'UserTyping' })\n    }, []),\n\n    /** \u8F6C\u5230\u7528\u6237\u5DF2\u63D0\u4EA4\u72B6\u6001 */\n    toUserSubmitted: useCallback(() => {\n      setState({ type: 'UserSubmitted' })\n    }, []),\n\n    /** \u8F6C\u5230 AI \u601D\u8003\u72B6\u6001 */\n    toAgentThinking: useCallback((message: string, spinnerFrame?: number) => {\n      setState({ type: 'AgentThinking', message, spinnerFrame })\n    }, []),\n\n    /** \u66F4\u65B0\u601D\u8003\u6D88\u606F (\u539F\u5730\u66F4\u65B0\uFF0C\u4E0D\u6539\u53D8\u72B6\u6001\u7C7B\u578B) */\n    updateThinkingMessage: useCallback(\n      (message: string, spinnerFrame?: number) => {\n        setState(prev => {\n          if (prev.type === 'AgentThinking') {\n            return { ...prev, message, spinnerFrame }\n          }\n          return prev\n        })\n      },\n      [],\n    ),\n\n    /** \u8F6C\u5230\u5DE5\u5177\u63D0\u8BAE\u72B6\u6001 */\n    toAgentProposingTool: useCallback(\n      (toolUse: ToolUseBlockParam, toolJSX?: React.ReactNode) => {\n        setState({ type: 'AgentProposingTool', toolUse, toolJSX })\n      },\n      [],\n    ),\n\n    /** \u8F6C\u5230\u5DE5\u5177\u6267\u884C\u72B6\u6001 */\n    toToolExecuting: useCallback(\n      (toolUse: ToolUseBlockParam, output?: string) => {\n        setState({ type: 'ToolExecuting', toolUse, output })\n      },\n      [],\n    ),\n\n    /** \u66F4\u65B0\u5DE5\u5177\u6267\u884C\u8F93\u51FA (\u539F\u5730\u66F4\u65B0) */\n    updateToolOutput: useCallback((output: string) => {\n      setState(prev => {\n        if (prev.type === 'ToolExecuting') {\n          return { ...prev, output }\n        }\n        return prev\n      })\n    }, []),\n\n    /** \u8F6C\u5230 AI \u56DE\u7B54\u72B6\u6001 */\n    toAgentResponding: useCallback(\n      (streamingText: string, isComplete: boolean) => {\n        setState({ type: 'AgentResponding', streamingText, isComplete })\n      },\n      [],\n    ),\n\n    /** \u66F4\u65B0\u6D41\u5F0F\u56DE\u7B54\u6587\u672C (\u539F\u5730\u66F4\u65B0) */\n    updateStreamingText: useCallback(\n      (streamingText: string, isComplete: boolean) => {\n        setState(prev => {\n          if (prev.type === 'AgentResponding') {\n            return { ...prev, streamingText, isComplete }\n          }\n          return prev\n        })\n      },\n      [],\n    ),\n\n    /** \u8F6C\u5230\u4E8C\u5143\u53CD\u9988\u72B6\u6001 */\n    toBinaryFeedback: useCallback((context: BinaryFeedbackContext) => {\n      setState({ type: 'BinaryFeedback', context })\n    }, []),\n\n    /** \u8F6C\u5230\u9519\u8BEF\u72B6\u6001 */\n    toError: useCallback((error: string, canRecover: boolean = true) => {\n      setState({ type: 'Error', error, canRecover })\n    }, []),\n\n    /** \u8F6C\u5230\u6D88\u606F\u9009\u62E9\u5668\u72B6\u6001 */\n    toMessageSelector: useCallback(() => {\n      setState({ type: 'MessageSelector' })\n    }, []),\n  }\n\n  /**\n   * \u72B6\u6001\u67E5\u8BE2\u8F85\u52A9\u51FD\u6570\n   */\n  const is = {\n    idle: state.type === 'Idle',\n    userTyping: state.type === 'UserTyping',\n    userSubmitted: state.type === 'UserSubmitted',\n    agentThinking: state.type === 'AgentThinking',\n    agentProposingTool: state.type === 'AgentProposingTool',\n    toolExecuting: state.type === 'ToolExecuting',\n    agentResponding: state.type === 'AgentResponding',\n    binaryFeedback: state.type === 'BinaryFeedback',\n    error: state.type === 'Error',\n    messageSelector: state.type === 'MessageSelector',\n\n    /** \u662F\u5426\u53EF\u4EE5\u63A5\u53D7\u7528\u6237\u8F93\u5165 */\n    canAcceptInput:\n      state.type === 'Idle' ||\n      state.type === 'UserTyping' ||\n      state.type === 'Error',\n\n    /** \u662F\u5426\u6B63\u5728\u52A0\u8F7D (\u601D\u8003\u3001\u6267\u884C\u3001\u56DE\u7B54) */\n    loading:\n      state.type === 'AgentThinking' ||\n      state.type === 'ToolExecuting' ||\n      state.type === 'AgentResponding' ||\n      state.type === 'UserSubmitted',\n\n    /** \u662F\u5426\u9700\u8981\u7528\u6237\u4EA4\u4E92 (\u786E\u8BA4\u5DE5\u5177\u3001\u4E8C\u5143\u53CD\u9988\u3001\u6D88\u606F\u9009\u62E9) */\n    needsUserInteraction:\n      state.type === 'AgentProposingTool' ||\n      state.type === 'BinaryFeedback' ||\n      state.type === 'MessageSelector',\n  }\n\n  return {\n    /** \u5F53\u524D\u72B6\u6001 */\n    state,\n    /** \u72B6\u6001\u8F6C\u6362\u51FD\u6570 */\n    transitions,\n    /** \u72B6\u6001\u67E5\u8BE2\u8F85\u52A9 */\n    is,\n    /** \u76F4\u63A5\u8BBE\u7F6E\u72B6\u6001 (\u9AD8\u7EA7\u7528\u6CD5) */\n    setState,\n  }\n}\n\n/**\n * \u72B6\u6001\u673A\u8C03\u8BD5\u8F85\u52A9\n */\nexport function getStateName(state: REPLState): string {\n  switch (state.type) {\n    case 'Idle':\n      return '\u23F8 Idle'\n    case 'UserTyping':\n      return '\u2328\uFE0F UserTyping'\n    case 'UserSubmitted':\n      return '\u23F3 UserSubmitted'\n    case 'AgentThinking':\n      return `\uD83E\uDD14 AgentThinking: ${state.message}`\n    case 'AgentProposingTool':\n      return `\uD83D\uDD27 AgentProposingTool: ${state.toolUse.name}`\n    case 'ToolExecuting':\n      return `\u2699\uFE0F ToolExecuting: ${state.toolUse.name}`\n    case 'AgentResponding':\n      return `\uD83D\uDCAC AgentResponding (${state.streamingText.length} chars)`\n    case 'BinaryFeedback':\n      return '\uD83E\uDD37 BinaryFeedback'\n    case 'Error':\n      return `\u274C Error: ${state.error}`\n    case 'MessageSelector':\n      return '\uD83D\uDCDC MessageSelector'\n  }\n}\n"],
+  "mappings": "AAaA,SAAS,UAAU,mBAAmB;AA6E/B,SAAS,oBACd,eAA0B,EAAE,MAAM,OAAO,GACzC;AACA,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB,YAAY;AAO1D,QAAM,cAAc;AAAA;AAAA,IAElB,QAAQ,YAAY,MAAM;AACxB,eAAS,EAAE,MAAM,OAAO,CAAC;AAAA,IAC3B,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,cAAc,YAAY,MAAM;AAC9B,eAAS,EAAE,MAAM,aAAa,CAAC;AAAA,IACjC,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,iBAAiB,YAAY,MAAM;AACjC,eAAS,EAAE,MAAM,gBAAgB,CAAC;AAAA,IACpC,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,iBAAiB,YAAY,CAAC,SAAiB,iBAA0B;AACvE,eAAS,EAAE,MAAM,iBAAiB,SAAS,aAAa,CAAC;AAAA,IAC3D,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,uBAAuB;AAAA,MACrB,CAAC,SAAiB,iBAA0B;AAC1C,iBAAS,UAAQ;AACf,cAAI,KAAK,SAAS,iBAAiB;AACjC,mBAAO,EAAE,GAAG,MAAM,SAAS,aAAa;AAAA,UAC1C;AACA,iBAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,MACA,CAAC;AAAA,IACH;AAAA;AAAA,IAGA,sBAAsB;AAAA,MACpB,CAAC,SAA4B,YAA8B;AACzD,iBAAS,EAAE,MAAM,sBAAsB,SAAS,QAAQ,CAAC;AAAA,MAC3D;AAAA,MACA,CAAC;AAAA,IACH;AAAA;AAAA,IAGA,iBAAiB;AAAA,MACf,CAAC,SAA4B,WAAoB;AAC/C,iBAAS,EAAE,MAAM,iBAAiB,SAAS,OAAO,CAAC;AAAA,MACrD;AAAA,MACA,CAAC;AAAA,IACH;AAAA;AAAA,IAGA,kBAAkB,YAAY,CAAC,WAAmB;AAChD,eAAS,UAAQ;AACf,YAAI,KAAK,SAAS,iBAAiB;AACjC,iBAAO,EAAE,GAAG,MAAM,OAAO;AAAA,QAC3B;AACA,eAAO;AAAA,MACT,CAAC;AAAA,IACH,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,mBAAmB;AAAA,MACjB,CAAC,eAAuB,eAAwB;AAC9C,iBAAS,EAAE,MAAM,mBAAmB,eAAe,WAAW,CAAC;AAAA,MACjE;AAAA,MACA,CAAC;AAAA,IACH;AAAA;AAAA,IAGA,qBAAqB;AAAA,MACnB,CAAC,eAAuB,eAAwB;AAC9C,iBAAS,UAAQ;AACf,cAAI,KAAK,SAAS,mBAAmB;AACnC,mBAAO,EAAE,GAAG,MAAM,eAAe,WAAW;AAAA,UAC9C;AACA,iBAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,MACA,CAAC;AAAA,IACH;AAAA;AAAA,IAGA,kBAAkB,YAAY,CAAC,YAAmC;AAChE,eAAS,EAAE,MAAM,kBAAkB,QAAQ,CAAC;AAAA,IAC9C,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,SAAS,YAAY,CAAC,OAAe,aAAsB,SAAS;AAClE,eAAS,EAAE,MAAM,SAAS,OAAO,WAAW,CAAC;AAAA,IAC/C,GAAG,CAAC,CAAC;AAAA;AAAA,IAGL,mBAAmB,YAAY,MAAM;AACnC,eAAS,EAAE,MAAM,kBAAkB,CAAC;AAAA,IACtC,GAAG,CAAC,CAAC;AAAA,EACP;AAKA,QAAM,KAAK;AAAA,IACT,MAAM,MAAM,SAAS;AAAA,IACrB,YAAY,MAAM,SAAS;AAAA,IAC3B,eAAe,MAAM,SAAS;AAAA,IAC9B,eAAe,MAAM,SAAS;AAAA,IAC9B,oBAAoB,MAAM,SAAS;AAAA,IACnC,eAAe,MAAM,SAAS;AAAA,IAC9B,iBAAiB,MAAM,SAAS;AAAA,IAChC,gBAAgB,MAAM,SAAS;AAAA,IAC/B,OAAO,MAAM,SAAS;AAAA,IACtB,iBAAiB,MAAM,SAAS;AAAA;AAAA,IAGhC,gBACE,MAAM,SAAS,UACf,MAAM,SAAS,gBACf,MAAM,SAAS;AAAA;AAAA,IAGjB,SACE,MAAM,SAAS,mBACf,MAAM,SAAS,mBACf,MAAM,SAAS,qBACf,MAAM,SAAS;AAAA;AAAA,IAGjB,sBACE,MAAM,SAAS,wBACf,MAAM,SAAS,oBACf,MAAM,SAAS;AAAA,EACnB;AAEA,SAAO;AAAA;AAAA,IAEL;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA,EACF;AACF;AAKO,SAAS,aAAa,OAA0B;AACrD,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,4BAAqB,MAAM,OAAO;AAAA,IAC3C,KAAK;AACH,aAAO,iCAA0B,MAAM,QAAQ,IAAI;AAAA,IACrD,KAAK;AACH,aAAO,+BAAqB,MAAM,QAAQ,IAAI;AAAA,IAChD,KAAK;AACH,aAAO,8BAAuB,MAAM,cAAc,MAAM;AAAA,IAC1D,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,iBAAY,MAAM,KAAK;AAAA,IAChC,KAAK;AACH,aAAO;AAAA,EACX;AACF;",
+  "names": []
+}

package/dist/utils/ripgrep.js

@@ -0,0 +1,131 @@
+import { findActualExecutable } from "spawn-rx";
+import { memoize } from "lodash-es";
+import { fileURLToPath, resolve } from "node:url";
+import * as path from "path";
+import { logError } from "./log.js";
+import { execFileNoThrow } from "./execFileNoThrow.js";
+import { execFile } from "child_process";
+import debug from "debug";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = resolve(
+  __filename,
+  process.env.NODE_ENV === "test" ? "../.." : "."
+);
+const d = debug("claude:ripgrep");
+const useBuiltinRipgrep = !!process.env.USE_BUILTIN_RIPGREP;
+if (useBuiltinRipgrep) {
+  d("Using builtin ripgrep because USE_BUILTIN_RIPGREP is set");
+}
+const ripgrepPath = memoize(() => {
+  const { cmd } = findActualExecutable("rg", []);
+  d(`ripgrep initially resolved as: ${cmd}`);
+  if (cmd !== "rg" && !useBuiltinRipgrep) {
+    return cmd;
+  } else {
+    const rgRoot = path.resolve(__dirname, "vendor", "ripgrep");
+    if (process.platform === "win32") {
+      return path.resolve(rgRoot, "x64-win32", "rg.exe");
+    }
+    const ret = path.resolve(
+      rgRoot,
+      `${process.arch}-${process.platform}`,
+      "rg"
+    );
+    d("internal ripgrep resolved as: %s", ret);
+    return ret;
+  }
+});
+async function ripGrep(args, target, abortSignal) {
+  await codesignRipgrepIfNecessary();
+  const rg = ripgrepPath();
+  d("ripgrep called: %s %o", rg, target, args);
+  return new Promise((resolve2) => {
+    execFile(
+      ripgrepPath(),
+      [...args, target],
+      {
+        maxBuffer: 1e6,
+        signal: abortSignal,
+        timeout: 1e4
+      },
+      (error, stdout) => {
+        if (error) {
+          if (error.code !== 1) {
+            d("ripgrep error: %o", error);
+            logError(error);
+          }
+          resolve2([]);
+        } else {
+          d("ripgrep succeeded with %s", stdout);
+          resolve2(stdout.trim().split("\n").filter(Boolean));
+        }
+      }
+    );
+  });
+}
+async function listAllContentFiles(path2, abortSignal, limit) {
+  try {
+    d("listAllContentFiles called: %s", path2);
+    return (await ripGrep(["-l", ".", path2], path2, abortSignal)).slice(0, limit);
+  } catch (e) {
+    d("listAllContentFiles failed: %o", e);
+    logError(e);
+    return [];
+  }
+}
+let alreadyDoneSignCheck = false;
+async function codesignRipgrepIfNecessary() {
+  if (process.platform !== "darwin" || alreadyDoneSignCheck) {
+    return;
+  }
+  alreadyDoneSignCheck = true;
+  d("checking if ripgrep is already signed");
+  const lines = (await execFileNoThrow(
+    "codesign",
+    ["-vv", "-d", ripgrepPath()],
+    void 0,
+    void 0,
+    false
+  )).stdout.split("\n");
+  const needsSigned = lines.find((line) => line.includes("linker-signed"));
+  if (!needsSigned) {
+    d("seems to be already signed");
+    return;
+  }
+  try {
+    d("signing ripgrep");
+    const signResult = await execFileNoThrow("codesign", [
+      "--sign",
+      "-",
+      "--force",
+      "--preserve-metadata=entitlements,requirements,flags,runtime",
+      ripgrepPath()
+    ]);
+    if (signResult.code !== 0) {
+      d("failed to sign ripgrep: %o", signResult);
+      logError(
+        `Failed to sign ripgrep: ${signResult.stdout} ${signResult.stderr}`
+      );
+    }
+    d("removing quarantine");
+    const quarantineResult = await execFileNoThrow("xattr", [
+      "-d",
+      "com.apple.quarantine",
+      ripgrepPath()
+    ]);
+    if (quarantineResult.code !== 0) {
+      d("failed to remove quarantine: %o", quarantineResult);
+      logError(
+        `Failed to remove quarantine: ${quarantineResult.stdout} ${quarantineResult.stderr}`
+      );
+    }
+  } catch (e) {
+    d("failed during sign: %o", e);
+    logError(e);
+  }
+}
+export {
+  listAllContentFiles,
+  ripGrep
+};
+//# sourceMappingURL=ripgrep.js.map

package/dist/utils/ripgrep.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/ripgrep.ts"],
+  "sourcesContent": ["import { findActualExecutable } from 'spawn-rx'\nimport { memoize } from 'lodash-es'\nimport { fileURLToPath, resolve } from 'node:url'\nimport * as path from 'path'\nimport { logError } from './log'\nimport { execFileNoThrow } from './execFileNoThrow'\nimport { execFile } from 'child_process'\nimport debug from 'debug'\n\nconst __filename = fileURLToPath(import.meta.url)\nconst __dirname = resolve(\n  __filename,\n  process.env.NODE_ENV === 'test' ? '../..' : '.',\n)\n\nconst d = debug('claude:ripgrep')\n\nconst useBuiltinRipgrep = !!process.env.USE_BUILTIN_RIPGREP\nif (useBuiltinRipgrep) {\n  d('Using builtin ripgrep because USE_BUILTIN_RIPGREP is set')\n}\n\nconst ripgrepPath = memoize(() => {\n  const { cmd } = findActualExecutable('rg', [])\n  d(`ripgrep initially resolved as: ${cmd}`)\n\n  if (cmd !== 'rg' && !useBuiltinRipgrep) {\n    // NB: If we're able to find ripgrep in $PATH, cmd will be an absolute\n    // path rather than just returning 'rg'\n    return cmd\n  } else {\n    // Use the one we ship in-box\n    const rgRoot = path.resolve(__dirname, 'vendor', 'ripgrep')\n    if (process.platform === 'win32') {\n      // NB: Ripgrep doesn't ship an aarch64 binary for Windows, boooooo\n      return path.resolve(rgRoot, 'x64-win32', 'rg.exe')\n    }\n\n    const ret = path.resolve(\n      rgRoot,\n      `${process.arch}-${process.platform}`,\n      'rg',\n    )\n\n    d('internal ripgrep resolved as: %s', ret)\n    return ret\n  }\n})\n\nexport async function ripGrep(\n  args: string[],\n  target: string,\n  abortSignal: AbortSignal,\n): Promise<string[]> {\n  await codesignRipgrepIfNecessary()\n  const rg = ripgrepPath()\n  d('ripgrep called: %s %o', rg, target, args)\n\n  // NB: When running interactively, ripgrep does not require a path as its last\n  // argument, but when run non-interactively, it will hang unless a path or file\n  // pattern is provided\n  return new Promise(resolve => {\n    execFile(\n      ripgrepPath(),\n      [...args, target],\n      {\n        maxBuffer: 1_000_000,\n        signal: abortSignal,\n        timeout: 10_000,\n      },\n      (error, stdout) => {\n        if (error) {\n          // Exit code 1 from ripgrep means \"no matches found\" - this is normal\n          if (error.code !== 1) {\n            d('ripgrep error: %o', error)\n            logError(error)\n          }\n          resolve([])\n        } else {\n          d('ripgrep succeeded with %s', stdout)\n          resolve(stdout.trim().split('\\n').filter(Boolean))\n        }\n      },\n    )\n  })\n}\n\n// NB: We do something tricky here. We know that ripgrep processes common\n// ignore files for us, so we just ripgrep for any character, which matches\n// all non-empty files\nexport async function listAllContentFiles(\n  path: string,\n  abortSignal: AbortSignal,\n  limit: number,\n): Promise<string[]> {\n  try {\n    d('listAllContentFiles called: %s', path)\n    return (await ripGrep(['-l', '.', path], path, abortSignal)).slice(0, limit)\n  } catch (e) {\n    d('listAllContentFiles failed: %o', e)\n\n    logError(e)\n    return []\n  }\n}\n\nlet alreadyDoneSignCheck = false\nasync function codesignRipgrepIfNecessary() {\n  if (process.platform !== 'darwin' || alreadyDoneSignCheck) {\n    return\n  }\n\n  alreadyDoneSignCheck = true\n\n  // First, check to see if ripgrep is already signed\n  d('checking if ripgrep is already signed')\n  const lines = (\n    await execFileNoThrow(\n      'codesign',\n      ['-vv', '-d', ripgrepPath()],\n      undefined,\n      undefined,\n      false,\n    )\n  ).stdout.split('\\n')\n\n  const needsSigned = lines.find(line => line.includes('linker-signed'))\n  if (!needsSigned) {\n    d('seems to be already signed')\n    return\n  }\n\n  try {\n    d('signing ripgrep')\n    const signResult = await execFileNoThrow('codesign', [\n      '--sign',\n      '-',\n      '--force',\n      '--preserve-metadata=entitlements,requirements,flags,runtime',\n      ripgrepPath(),\n    ])\n\n    if (signResult.code !== 0) {\n      d('failed to sign ripgrep: %o', signResult)\n      logError(\n        `Failed to sign ripgrep: ${signResult.stdout} ${signResult.stderr}`,\n      )\n    }\n\n    d('removing quarantine')\n    const quarantineResult = await execFileNoThrow('xattr', [\n      '-d',\n      'com.apple.quarantine',\n      ripgrepPath(),\n    ])\n\n    if (quarantineResult.code !== 0) {\n      d('failed to remove quarantine: %o', quarantineResult)\n      logError(\n        `Failed to remove quarantine: ${quarantineResult.stdout} ${quarantineResult.stderr}`,\n      )\n    }\n  } catch (e) {\n    d('failed during sign: %o', e)\n    logError(e)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["resolve", "path"]
+}