@xagent/x-cli 1.1.82 → 1.1.83

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@xagent/x-cli",
-  "version": "1.1.82",
+  "version": "1.1.83",
   "description": "An open-source AI agent that brings advanced AI capabilities directly into your terminal.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -13,37 +13,29 @@
     }
   },
   "bin": {
-    "xcli": "dist/index.js"
+    "grok": "./dist/index.js"
   },
   "files": [
-    "dist/**/*",
-    ".xcli/**/*",
+    "dist",
     "README.md",
-    "LICENSE",
-    "docs/assets/logos/**/*"
+    "package.json"
   ],
   "scripts": {
-    "build": "tsup",
-    "build:tsc": "tsc",
-    "dev": "npm run build && node dist/index.js --prompt 'Development test: Hello X-CLI!'",
-    "dev:node": "tsx src/index.ts",
-    "dev:watch": "npm run build && node --watch dist/index.js",
-    "start": "node dist/index.js",
-    "local": "node scripts/local.js",
-    "test:workflow": "node scripts/test-workflow.js",
-    "start:bun": "bun run dist/index.js",
-    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-pattern 'dist/**'",
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsx watch src/index.ts",
+    "lint": "eslint src --ext .ts",
     "typecheck": "tsc --noEmit",
-    "install:bun": "bun install",
-    "preinstall": "echo '🤖 Installing X CLI...'",
-    "postinstall": "echo '==================================================' && echo '✅ X CLI installed successfully!' && echo '==================================================' && echo '🚀 Try: xcli --help' && echo '💡 If \"command not found\", add to PATH:' && node -e \"const p=process.platform;const isMac=p==='darwin';const isLinux=p==='linux';if(isMac||isLinux){const shell=isMac?'zshrc':'bashrc';console.log((isMac?'🍎 Mac':'🐧 Linux')+': echo \\'export PATH=\\\"$(npm config get prefix)/bin:$PATH\\\"\\' >> ~/.'+shell+' && source ~/.'+shell);}\" && echo '📖 Docs: https://github.com/hinetapora/x-cli-hurry-mode#installation' && echo '🔑 Set API key: export GROK_API_KEY=your_key_here' && echo '==================================================' && echo '🔧 Auto-setup PATH? Press Enter to add (or Ctrl+C to skip)' && read -t 10 && node -e \"const fs=require('fs');const p=process.platform;const isMac=p==='darwin';const isLinux=p==='linux';if(isMac||isLinux){const shellFile=isMac?'.zshrc':'.bashrc';const rcPath=process.env.HOME+'/'+shellFile;const pathCmd='export PATH=\\\"$(npm config get prefix)/bin:$PATH\\\"';try{const content=fs.readFileSync(rcPath,'utf8');if(!content.includes(pathCmd)){fs.appendFileSync(rcPath,'\\n'+pathCmd+'\\n');console.log('✅ Added to ~/'+shellFile+' - restart terminal');}else{console.log('ℹ️ Already in ~/'+shellFile);}}catch(e){console.log('⚠️ Could not modify ~/'+shellFile+' - add manually');}}\" && echo '🔍 Verifying: ' && xcli --version 2>/dev/null || echo '⚠️ xcli not in PATH yet - follow above steps'",
     "prepare": "husky install",
     "dev:site": "cd apps/site && npm run start",
     "build:site": "cd apps/site && npm run build",
     "sync:docs": "cd apps/site && node src/scripts/sync-agent-docs.js",
-    "smart-push": "./scripts/smart-push.sh"
+    "smart-push": "./scripts/smart-push.sh",
+    "push": "echo '🚨 BLOCKED: Use npm run smart-push instead' && echo '💡 Direct git push bypasses automation' && exit 1",
+    "git-push": "echo '🚨 BLOCKED: Use npm run smart-push instead' && echo '💡 Direct git push bypasses automation' && exit 1"
   },
   "lint-staged": {
+    ".agent/**/*.{md,mdx}": "prettier --write",
+    "apps/site/docs/**/*.{md,mdx}": [],
     "*.{ts,tsx}": [
       "eslint --fix --ignore-pattern 'dist/**'"
     ],

package/docs/README.md

@@ -1,212 +0,0 @@
-# X-CLI Workflow Documentation
-
-## Overview
-
-This documentation directory contains comprehensive guides for X-CLI's revolutionary "Research → Recommend → Execute → Auto-Doc" workflow system. These documents explain how to effectively use and integrate with the complete AI-assisted development workflow.
-
-## Documentation Structure
-
-### 📚 User Guide (`workflow-user-guide.md`)
-**Primary guide for end users and developers**
-
-- **Complete workflow walkthrough** - Step-by-step guide through all phases
-- **Interactive examples** - Real console output and decision flows
-- **Best practices** - Task formulation, decision making, error recovery
-- **Advanced usage** - CLI flags, environment variables, configuration
-- **Troubleshooting** - Common issues and solutions
-- **Integration examples** - CI/CD, development workflows
-
-**Perfect for:**
-- New users learning the workflow
-- Developers implementing features
-- Teams adopting X-CLI workflows
-
-### 🔧 API Reference (`api-reference.md`)
-**Technical documentation for developers and integrators**
-
-- **Complete type definitions** - All interfaces and data structures
-- **Service class documentation** - Methods, parameters, return values
-- **Configuration options** - Environment variables, config files
-- **Integration examples** - Programmatic usage, CI/CD integration
-- **Error handling** - Exception types and recovery patterns
-- **Performance optimization** - Memory management, caching strategies
-
-**Perfect for:**
-- Building custom integrations
-- Extending X-CLI with new tools
-- CI/CD pipeline development
-- Advanced configuration
-
-### 🏗️ Architecture Overview (`.agent/system/workflow-overview.md`)
-**System design and technical architecture**
-
-- **Core principles** - Safety, operator-in-the-loop, context intelligence
-- **Workflow phases** - Detailed breakdown of each stage
-- **Integration points** - How components work together
-- **Safety guarantees** - Data protection and error boundaries
-- **Future extensions** - Planned features and integrations
-
-**Perfect for:**
-- Understanding system design
-- Planning integrations
-- Technical architecture reviews
-
-## Quick Start
-
-### For End Users
-1. **Read the User Guide** - Start with `workflow-user-guide.md`
-2. **Try basic examples** - Use the command examples provided
-3. **Explore advanced features** - Check configuration and integration sections
-
-### For Developers
-1. **Review API Reference** - Understand available interfaces
-2. **Check Architecture** - Learn system design principles
-3. **Follow Integration Examples** - See real-world usage patterns
-
-### For Teams
-1. **Study User Guide** - Train team members on workflow usage
-2. **Review Architecture** - Understand safety and reliability features
-3. **Plan Integration** - Use API Reference for CI/CD and tool integration
-
-## Key Concepts
-
-### The Workflow
-
-X-CLI transforms complex tasks into safe, structured experiences through four phases:
-
-1. **🤖 Research** - AI analyzes task with project context
-2. **💡 Recommend** - Presents options with trade-offs for approval
-3. **⚡ Execute** - Runs approved plan with safety guarantees
-4. **📝 Auto-Doc** - Documents completion and learns lessons
-
-### Safety First
-
-- **Zero data loss** - All changes have patches and backups
-- **Version control** - Automatic git commits for all modifications
-- **Error recovery** - Intelligent handling of execution failures
-- **Audit trail** - Complete record of all decisions and actions
-
-### Context Intelligence
-
-- **Automatic loading** - Project docs provide AI context on startup
-- **Knowledge accumulation** - Past executions inform future recommendations
-- **Adaptive learning** - System improves through documented lessons
-- **Project memory** - Institutional knowledge preserved in `.agent/` files
-
-## Usage Examples
-
-### Simple Task
-```bash
-$ xcli "add input validation to user registration form"
-
-🔍 Researching and analyzing...
-[... structured analysis output ...]
-Proceed with recommendation? (Y/n) [R=revise] Y
-
-🚀 Starting execution...
-✅ Execution completed: 3/3 steps successful
-📝 Documentation saved
-```
-
-### Complex Task with Recovery
-```bash
-$ xcli "implement payment processing system"
-
-🔍 Researching and analyzing...
-[... comprehensive analysis ...]
-Proceed with recommendation? (Y/n) [R=revise] Y
-
-🚀 Starting execution...
-🚨 ISSUE ENCOUNTERED: test failures detected
-🔄 Initiating adaptive recovery...
-[... recovery analysis ...]
-Proceed with recovery plan? (Y/n) [R=revise] Y
-
-✅ Recovery completed. Resuming execution...
-✅ Execution completed: 8/8 steps successful
-```
-
-### CI/CD Integration
-```yaml
-- name: Implement Feature
-  run: |
-    npx @xagent/x-cli@latest --headless "add error logging"
-  env:
-    X_API_KEY: ${{ secrets.X_API_KEY }}
-```
-
-## Configuration
-
-### Environment Variables
-```bash
-# Required
-X_API_KEY=your_api_key
-
-# Optional
-XCLI_PATCH_DIR=/custom/patches      # Custom patch storage
-XCLI_CONTEXT_BUDGET=500             # Context size limit (KB)
-XCLI_MAX_RECOVERY_ATTEMPTS=3        # Recovery retry limit
-```
-
-### Configuration Files
-- **User settings**: `~/.xcli/config.json`
-- **Project settings**: `.xcli/project.json`
-- **Context docs**: `.agent/` directory structure
-
-## Integration Points
-
-### Programmatic Usage
-```typescript
-import { ResearchRecommendService } from '@xagent/x-cli';
-
-const service = new ResearchRecommendService(agent);
-const result = await service.researchRecommendExecute(request);
-```
-
-### Tool Extensions
-- Add custom tools to the GrokAgent
-- Extend execution capabilities
-- Integrate with external systems
-
-### CI/CD Pipelines
-- Headless mode for automation
-- Structured output for parsing
-- Patch file generation for reviews
-
-## Support & Resources
-
-### Getting Help
-- **User Guide** - Step-by-step walkthroughs and examples
-- **API Reference** - Technical details and integration guides
-- **Architecture Docs** - System design and principles
-- **Generated Docs** - Auto-created `.agent/tasks/` files
-
-### Common Issues
-- **Context loading** - Check `.agent/` directory structure
-- **API errors** - Verify X_API_KEY configuration
-- **Execution failures** - Review patch files and backups
-- **Performance** - Adjust context budget and timeouts
-
-### Community
-- **GitHub Issues** - Bug reports and feature requests
-- **Discord Community** - Usage questions and discussions
-- **Documentation PRs** - Help improve these guides
-
-## Version History
-
-### Current Version: Sprint Complete ✅
-- **5-stage implementation** complete
-- **Full workflow operational**
-- **Production-ready features**
-- **Comprehensive documentation**
-
-### Key Features Delivered
-- ✅ Intelligent context loading (Stage 1)
-- ✅ Research → Recommend flow (Stage 2)
-- ✅ Safe execution with patches/backups (Stage 3)
-- ✅ Adaptive error recovery (Stage 4)
-- ✅ Auto-documentation & learning (Stage 5)
-
----
-
-*This documentation represents the complete guide to X-CLI's workflow system. Start with the User Guide for practical usage, then explore the API Reference for technical integration details.*

package/docs/assets/logos/README.md

@@ -1,70 +0,0 @@
-# X CLI Logo Assets
-
-This directory contains all logo assets for the X CLI project.
-
-## Files
-
-### Core Logo Files
-
-- **`x-cli-logo.svg`** - Standard logo (100x100px)
-- **`x-cli-logo-small.svg`** - Small version (32x32px)
-- **`x-cli-logo-large.svg`** - Large version (200x200px)
-
-### Specialized Assets
-
-- **`favicon.svg`** - Favicon for web use (32x32px)
-- **`github-social-preview.svg`** - GitHub repository social preview (1200x630px)
-
-## Usage Guidelines
-
-### Colors
-
-- **Red**: `#ea4335` (Google Red)
-- **Yellow**: `#fbbc04` (Google Yellow)
-- **Green**: `#34a853` (Google Green)
-- **Blue**: `#4285f4` (Google Blue)
-- **Center**: `#1a73e8` (Darker Blue)
-
-### Design Elements
-
-- Chrome-inspired circular design with 4 color segments
-- Central blue circle with white inner circle
-- "X" symbol in center representing the CLI name
-- Clean, professional appearance suitable for terminal tools
-
-### Recommended Usage
-
-- **README.md**: Use `x-cli-logo-large.svg` at 120px width
-- **Documentation**: Use `x-cli-logo.svg` at 100px width
-- **Icons**: Use `x-cli-logo-small.svg` or `favicon.svg`
-- **Social Media**: Use `github-social-preview.svg`
-
-## Brand Guidelines
-
-### Do's
-
-✅ Use the logo with sufficient white space  
-✅ Maintain aspect ratio when scaling  
-✅ Use on light or dark backgrounds with proper contrast  
-✅ Use SVG format for crisp display at any size
-
-### Don'ts
-
-❌ Modify the colors or proportions  
-❌ Add effects, shadows, or outlines  
-❌ Use on busy backgrounds that reduce visibility  
-❌ Stretch or distort the logo
-
-## Integration
-
-These assets are automatically included in NPM packages via the `files` field in `package.json`:
-
-```json
-{
-  "files": ["docs/assets/logos/**/*"]
-}
-```
-
-## Attribution
-
-Logo design inspired by Chrome's visual language, customized for X CLI branding.

package/docs/assets/logos/favicon.svg

@@ -1,8 +0,0 @@
-<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
-  <!-- X CLI Logo - Black Fill - Favicon -->
-  <g transform="translate(5, 12) scale(0.65, 0.65)">
-    <path d="M0.00555015 7.77631L9.75248 22H14.085L4.33691 7.77631H0.00555015ZM4.33358 15.6762L0 22H4.3358L6.50092 18.8387L4.33358 15.6762ZM15.076 0L7.58515 10.9308L9.75248 14.0944L19.4118 0H15.076ZM15.8606 6.76374V22H19.4118V1.5818L15.8606 6.76374Z" fill="black"/>
-    <path d="M21.0122 7.77826V22H25.348H32.924V18.8387H24.924V10.9328L29.5 10.9308L26.5 7.77631L24.924 7.77826H21.0122ZM30 11.9727V17.4727H33V11.9727H30Z" fill="black"/>
-    <path d="M33 7.77631L32.924 10.9328L30 7.77631H33Z" fill="black"/>
-  </g>
-</svg>

package/docs/assets/logos/github-social-preview.svg

@@ -1,39 +0,0 @@
-<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
-  <!-- GitHub Social Preview for X CLI -->
-  <defs>
-    <linearGradient id="backgroundGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#1e293b"/>
-      <stop offset="100%" style="stop-color:#0f172a"/>
-    </linearGradient>
-    <radialGradient id="logoGradient" cx="50%" cy="50%" r="50%">
-      <stop offset="0%" style="stop-color:#4285f4"/>
-      <stop offset="100%" style="stop-color:#1a73e8"/>
-    </radialGradient>
-  </defs>
-  
-  <!-- Background -->
-  <rect width="1200" height="630" fill="url(#backgroundGradient)"/>
-  
-  <!-- Logo (scaled and positioned) -->
-  <g transform="translate(400, 200) scale(6, 6)">
-    <path d="M0.00555015 7.77631L9.75248 22H14.085L4.33691 7.77631H0.00555015ZM4.33358 15.6762L0 22H4.3358L6.50092 18.8387L4.33358 15.6762ZM15.076 0L7.58515 10.9308L9.75248 14.0944L19.4118 0H15.076ZM15.8606 6.76374V22H19.4118V1.5818L15.8606 6.76374Z" fill="white"/>
-    <path d="M21.0122 7.77826V22H25.348H32.924V18.8387H24.924V10.9328L29.5 10.9308L26.5 7.77631L24.924 7.77826H21.0122ZM30 11.9727V17.4727H33V11.9727H30Z" fill="white"/>
-    <path d="M33 7.77631L32.924 10.9328L30 7.77631H33Z" fill="white"/>
-  </g>
-  
-  <!-- Title -->
-  <text x="550" y="280" font-family="Inter, Arial, sans-serif" font-size="64" font-weight="bold" fill="white">X CLI</text>
-  
-  <!-- Subtitle -->
-  <text x="550" y="340" font-family="Inter, Arial, sans-serif" font-size="28" fill="#94a3b8">Claude Code-level intelligence in your terminal</text>
-  
-  <!-- Features -->
-  <text x="550" y="390" font-family="Inter, Arial, sans-serif" font-size="20" fill="#64748b">🚀 Advanced File Operations  •  🧠 AI-Powered Tools  •  🔧 MCP Integration</text>
-  
-  <!-- Command -->
-  <rect x="520" y="450" width="400" height="50" rx="8" fill="#1e293b" stroke="#334155" stroke-width="2"/>
-  <text x="540" y="480" font-family="JetBrains Mono, monospace" font-size="18" fill="#10b981">npm install -g @xagent/x-cli</text>
-  
-  <!-- GitHub URL -->
-  <text x="550" y="550" font-family="Inter, Arial, sans-serif" font-size="16" fill="#475569">github.com/x-cli-team/x-cli</text>
-</svg>

package/docs/assets/logos/x-cli-logo-large.svg

@@ -1,8 +0,0 @@
-<svg width="200" height="200" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
-  <!-- X CLI Logo - Black Fill - Large -->
-  <g transform="translate(17, 39) scale(2, 2)">
-    <path d="M0.00555015 7.77631L9.75248 22H14.085L4.33691 7.77631H0.00555015ZM4.33358 15.6762L0 22H4.3358L6.50092 18.8387L4.33358 15.6762ZM15.076 0L7.58515 10.9308L9.75248 14.0944L19.4118 0H15.076ZM15.8606 6.76374V22H19.4118V1.5818L15.8606 6.76374Z" fill="black"/>
-    <path d="M21.0122 7.77826V22H25.348H32.924V18.8387H24.924V10.9328L29.5 10.9308L26.5 7.77631L24.924 7.77826H21.0122ZM30 11.9727V17.4727H33V11.9727H30Z" fill="black"/>
-    <path d="M33 7.77631L32.924 10.9328L30 7.77631H33Z" fill="black"/>
-  </g>
-</svg>

package/docs/assets/logos/x-cli-logo-small.svg

@@ -1,8 +0,0 @@
-<svg width="32" height="32" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
-  <!-- X CLI Logo - Black Fill - Small -->
-  <g transform="translate(17, 39) scale(2, 2)">
-    <path d="M0.00555015 7.77631L9.75248 22H14.085L4.33691 7.77631H0.00555015ZM4.33358 15.6762L0 22H4.3358L6.50092 18.8387L4.33358 15.6762ZM15.076 0L7.58515 10.9308L9.75248 14.0944L19.4118 0H15.076ZM15.8606 6.76374V22H19.4118V1.5818L15.8606 6.76374Z" fill="black"/>
-    <path d="M21.0122 7.77826V22H25.348H32.924V18.8387H24.924V10.9328L29.5 10.9308L26.5 7.77631L24.924 7.77826H21.0122ZM30 11.9727V17.4727H33V11.9727H30Z" fill="black"/>
-    <path d="M33 7.77631L32.924 10.9328L30 7.77631H33Z" fill="black"/>
-  </g>
-</svg>

package/docs/assets/logos/x-cli-logo.svg

@@ -1,8 +0,0 @@
-<svg width="100" height="100" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
-  <!-- X CLI Logo - Black Fill -->
-  <g transform="translate(17, 39) scale(2, 2)">
-    <path d="M0.00555015 7.77631L9.75248 22H14.085L4.33691 7.77631H0.00555015ZM4.33358 15.6762L0 22H4.3358L6.50092 18.8387L4.33358 15.6762ZM15.076 0L7.58515 10.9308L9.75248 14.0944L19.4118 0H15.076ZM15.8606 6.76374V22H19.4118V1.5818L15.8606 6.76374Z" fill="black"/>
-    <path d="M21.0122 7.77826V22H25.348H32.924V18.8387H24.924V10.9328L29.5 10.9308L26.5 7.77631L24.924 7.77826H21.0122ZM30 11.9727V17.4727H33V11.9727H30Z" fill="black"/>
-    <path d="M33 7.77631L32.924 10.9328L30 7.77631H33Z" fill="black"/>
-  </g>
-</svg>