@defai.digital/ax-cli 3.5.4 → 3.6.0

package/.ax-cli/memory.json

@@ -1,9 +1,9 @@
 {
   "version": 1,
-  "created_at": "2025-11-22T01:29:46.029Z",
-  "updated_at": "2025-11-22T01:29:46.029Z",
+  "created_at": "2025-11-22T11:59:21.278Z",
+  "updated_at": "2025-11-22T11:59:21.278Z",
   "project_root": "/Users/akiralam/code/ax-cli",
-  "content_hash": "sha256:521da45b50c8e354d21df3dfae144fb636fb98b767c2b753f7b9d7dd2936a4b3",
+  "content_hash": "sha256:213c195995de78eced482260119b8ac69826a6a26f7bffe20ab0e3874b4f0f9f",
   "source": {
     "directories": [
       {
@@ -43,12 +43,12 @@
     ]
   },
   "context": {
-    "formatted": "# Project Context\n\n\n## Architecture Patterns\n- **Project Type**: cli\n- **Primary Language**: TypeScript\n- **Tech Stack**: React, Vitest, Zod, Commander, Ink, ESM, TypeScript\n- **Package Manager**: npm\n- **Entry Point**: dist/index.js\n- **Module System**: ESM\n- **Test Framework**: vitest\n- **Validation**: zod\n- **Linter**: eslint\n- **Key Directories**: source: src, tests: tests\n\n\n## Directory Structure\n```\nsrc/\n├── agent/\n│   ├── specialized/\n│   │   ├── analysis-agent.ts\n│   │   ├── debug-agent.ts\n│   │   ├── documentation-agent.ts\n│   │   ├── index.ts\n│   │   ├── performance-agent.ts\n│   │   ├── refactoring-agent.ts\n│   │   └── testing-agent.ts\n│   ├── context-manager.ts\n│   ├── context-manager.ts.bak\n│   ├── dependency-resolver.ts\n│   ├── index.ts\n│   ├── llm-agent.ts\n│   ├── llm-agent.ts.backup\n│   ├── subagent-orchestrator.ts\n│   ├── subagent-types.ts\n│   └── subagent.ts\n├── analyzers/\n│   ├── architecture/\n│   │   ├── anti-pattern-detectors/\n│   │   ├── pattern-detectors/\n│   │   ├── architecture-analyzer.ts\n│   │   ├── index.ts\n│   │   └── project-structure-scanner.ts\n│   ├── ast/\n│   │   ├── index.ts\n│   │   ├── node-helpers.ts\n│   │   ├── parser.ts\n│   │   ├── traverser.ts\n│   │   └── types.ts\n│   ├── best-practices/\n│   │   ├── rules/\n│   │   ├── base-rule.ts\n│   │   ├── best-practice-validator.ts\n│   │   ├── index.ts\n│   │   └── types.ts\n│   ├── cache/\n│   │   └── analysis-cache.ts\n│   ├── security/\n│   │   ├── detectors/\n│   │   ├── base-detector.ts\n│   │   ├── index.ts\n│   │   ├── security-analyzer.ts\n│   │   └── types.ts\n│   └── errors.ts\n├── checkpoint/\n│   ├── index.ts\n│   ├── manager.ts\n│   ├── storage.ts\n│   └── types.ts\n├── commands/\n│   ├── init/\n│   │   └── wizard.ts\n│   ├── cache.ts\n│   ├── doctor.ts\n│   ├── frontend.ts\n│   ├── init.ts\n│   ├── mcp.ts\n│   ├── memory.ts\n│   ├── models.ts\n│   ├── plan.ts\n│   ├── rewind.ts\n│   ├── setup.ts\n│   ├── templates.ts\n│   ├── update.ts\n│   └── usage.ts\n├── hooks/\n│   ├── use-chat-reducer.ts\n│   ├── use-enhanced-input.ts\n│   ├── use-input-handler.ts\n│   └── use-input-history.ts\n├── llm/\n│   ├── client.ts\n│   ├── tools.ts\n│   └── types.ts\n├── mcp/\n│   ├── client.ts\n│   ├── config.ts\n│   ├── health.ts\n│   ├── reconnection.ts\n│   ├── registry.ts\n│   ├── resources.ts\n│   ├── templates.ts\n│   ├── transports.ts\n│   └── validation.ts\n├── memory/\n│   ├── context-generator.ts\n│   ├── context-injector.ts\n│   ├── context-store.ts\n│   ├── index.ts\n│   ├── schemas.ts\n│   ├── stats-collector.ts\n│   └── types.ts\n├── planner/\n│   ├── prompts/\n│   │   └── planning-prompt.ts\n│   ├── dependency-resolver.ts\n│   ├── index.ts\n│   ├── plan-generator.ts\n│   ├── plan-storage.ts\n│   ├── task-planner.ts\n│   ├── token-estimator.ts\n│   └── types.ts\n├── schemas/\n│   ├── api-schemas.ts\n│   ├── confirmation-schemas.ts\n│   ├── index-unified.ts\n│   ├── index.ts\n│   ├── README.md\n│   ├── settings-schemas.ts\n│   ├── tool-schemas.ts\n│   └── yaml-schemas.ts\n├── sdk/\n│   ├── index.ts\n│   ├── README.md\n│   └── types.ts\n├── tools/\n│   ├── analysis-tools/\n│   │   ├── architecture-tool.ts\n│   │   └── validation-tool.ts\n│   ├── web-search/\n│   │   ├── engines/\n│   │   ├── cache.ts\n│   │   ├── index.ts\n│   │   ├── router.ts\n│   │   ├── types.ts\n│   │   └── web-search-tool.ts\n│   ├── bash-output.ts\n│   ├── bash.ts\n│   ├── confirmation-tool.ts\n│   ├── index.ts\n│   ├── search.ts\n│   ├── text-editor.ts\n│   └── todo-tool.ts\n├── types/\n│   ├── analysis.ts\n│   ├── index.ts\n│   ├── project-analysis.ts\n│   └── template.ts\n├── ui/\n│   ├── components/\n│   │   ├── api-key-input.tsx\n│   │   ├── chat-history.tsx\n│   │   ├── chat-input.tsx\n│   │   ├── chat-interface.tsx\n│   │   ├── collapsible-tool-result.tsx\n│   │   ├── command-suggestions.tsx\n│   │   ├── confirmation-dialog.tsx\n│   │   ├── diff-renderer.tsx\n│   │   ├── index.ts\n│   │   ├── keyboard-hints.tsx\n│   │   ├── loading-spinner.tsx\n│   │   ├── mcp-status.tsx\n│   │   ├── model-selection.tsx\n│   │   ├── phase-progress.tsx\n│   │   ├── quick-actions.tsx\n│   │   ├── reasoning-display.tsx\n│   │   ├── status-bar.tsx\n│   │   ├── subagent-monitor.tsx\n│   │   ├── toast-notification.tsx\n│   │   ├── virtualized-chat-history.tsx\n│   │   └── welcome-panel.tsx\n│   ├── shared/\n│   │   └── max-sized-box.tsx\n│   ├── utils/\n│   │   ├── code-colorizer.tsx\n│   │   ├── colors.ts\n│   │   └── markdown-renderer.tsx\n│   └── app.tsx\n├── utils/\n│   ├── analysis-logger.ts\n│   ├── automatosx-detector.ts\n│   ├── background-task-manager.ts\n│   ├── cache.ts\n│   ├── config-loader.ts\n│   ├── confirmation-service.ts\n│   ├── console-messenger.ts\n│   ├── custom-instructions.ts\n│   ├── error-handler.ts\n│   ├── error-translator.ts\n│   ├── errors.ts\n│   ├── file-cache.ts\n│   ├── history-manager.ts\n│   ├── incremental-analyzer.ts\n│   ├── index.ts\n│   ├── init-previewer.ts\n│   ├── init-validator.ts\n│   ├── instruction-generator.ts\n│   ├── json-utils.ts\n│   ├── llm-optimized-instruction-generator.ts\n│   ├── message-optimizer.ts\n│   ├── onboarding-manager.ts\n│   ├── parallel-analyzer.ts\n│   ├── path-utils.ts\n│   ├── path-validator.ts\n│   ├── performance.ts\n│   ├── progress-tracker.ts\n│   ├── project-analyzer.ts\n│   ├── prompt-builder.ts\n│   ├── settings-manager.ts\n│   └── ... (9 more)\n├── constants.ts\n└── index.ts\npackages/\n└── schemas/\n    ├── __tests__/\n    ├── scripts/\n    ├── src/\n    ├── .eslintrc.js\n    ├── package-lock.json\n    ├── package.json\n    ├── README.md\n    ├── tsconfig.json\n    └── vitest.config.ts\n```\n\n\n## Key Configuration\n\n### README.md\n\n```\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![Tests](https://img.shields.io/badge/tests-562%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98.29%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-\n...\n```\n\n### readme.md\n\n```\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![Tests](https://img.shields.io/badge/tests-562%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98.29%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-\n...\n```\n\n### package.json\n\n- **Name**: @defai.digital/ax-cli\n- **Version**: 3.4.1\n- **Description**: Enterprise-Class AI Command Line Interface - Primary support for GLM (General Language Model) with multi-provider AI orchestration powered by AutomatosX.\n- **Type**: module\n- **CLI**: Yes\n- **Dependencies**: @ax-cli/schemas, @clack/prompts, @modelcontextprotocol/sdk, axios, chalk, clipboardy, commander, dotenv, enquirer, fs-extra (+14 more)\n- **Dev Dependencies**: @types/fs-extra, @types/glob, @types/js-yaml, @types/marked-terminal, @types/node, @types/react, @typescript-eslint/eslint-plugin, @typescript-eslint/parser (+6 more)\n- **Scripts**: build, build:schemas, build:bun, dev, dev:node, start\n\n### tsconfig.json\n\n- **Target**: ES2022\n- **Module**: ESNext\n- **Module Resolution**: Bundler\n- **Strict**: true\n- **Output**: ./dist\n\n### .ax-cli/CUSTOM.md\n\n# @defai.digital/ax-cli - Quick Reference\n\n**Type:** cli | **Lang:** TypeScript | **Ver:**  v2.3.1\n**Stack:** React, Vitest, Zod, Commander, Ink, ESM, TypeScript\n\n---\n\n## 🎯 Critical Rules\n\n1. **ESM Imports:** Always use `.js` extension: `import { x } from './y.js'`\n2. **Validation:** Use zod for all external inputs\n3. **Types:** Explicit return types required on all functions\n4. **Testing:** 80%+ coverage, test error paths\n5. **Modules:** Use `import/export` (not `require/module.exports`)\n6. **File Organization:** Follow standardized output paths (see below)\n\n---\n\n## 📁 Project File Organization\n\n### Standard Output Paths\n\nAll AI-generated and project artifacts must follow this structure:\n\n```\nautomatosx/\n├── PRD/              # Product Requirement Documents\n│   ├── features/     # Feature specifications\n│   ├── api/          # API documentation\n│   └── archive/      # Old/deprecated PRDs\n├── REPORT/           # Project reports and analysis\n│   ├── status/       # Status reports\n│   ├\n[...truncated]\n\n\n## README Summary\n\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![Tests](https://img.shields.io/badge/tests-562%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98.29%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D24.0.0-blue?style=flat-square)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9%2B-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![macOS](https://img.shields.io/badge/macOS-26-blue?style=flat-square&logo=apple)](https://www.apple.com/macos/)\n[![Windows](https://img.shields.io/badge/Windows-11-blue?style=flat-square&logo=windows)](https://www.microsoft.com/windows/)\n[![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-blue?style=flat-square&logo=ubuntu)](https://ubuntu.com/)\n\n![AX CLI Screenshot](.github/assets/screenshot1.png)\n\n<p align=\"center\">\n  <strong>GLM-Optimized CLI • Enterprise Architecture • 98%+ Test Coverage • TypeScript & Zod</strong>\n</p>\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g @defai.digital/ax-cli\n\n# Configure your API key\nax-cli setup\n\n# Initialize your project\nax-cli init\n\n# Start interactive mode\nax-cli\n```\n\n## ✨ Features\n\n- **🤖 GLM-Focused AI CLI**: Optimized for Z.AI's GLM models (glm-4.6, glm-4-air, glm-4-airx)\n  - **Note**: For xAI Grok models, use [grok-cli](https://github.com/superagent-ai/grok-cli)\n  - **Note**: For Anthropic Claude models, use [claude-code](https://claude.ai/code)\n- **🧠 GLM 4.6 Optimized**: Primary support for General Language Model with advanced reasoning\n  - **32K max tokens** (industry-standard, matches Claude Code CLI)\n  - 200K context window, 128K max output capability\n  - 30% more token efficient than GLM 4.5\n  - Optimized for complex code generation and refactoring\n- **🎯 Multi-Phase Task Planner** (NEW in v3.0.0): Intelligent task decomposition for complex requests\n  - Automatic complexity detection (57 keyword patterns)\n  - LLM-based plan generation with phases and dependencies\n  - Phase-by-phase execution with progress tracking\n  - File modification tracking and context pruning between phases\n  - Plan management commands: `/plans`, `/plan`, `/phases`, `/pause`, `/resume`, `/skip`, `/abandon`\n- **🔄 Session Continuity**: Directory-specific conversation history with `--continue` flag\n  - Preserve context across sessions for multi-day development\n  - Each project maintains its own independent history\n  - Seamlessly resume conversations where you left off\n- **🔌 Enhanced MCP Integration**: Model Context Protocol with production-ready templates\n  - **One-command setup**: `ax-cli mcp add figma --template`\n  - **12+ pre-configured templates**: Figma, GitHub, Vercel, Puppeteer, Storybook, Sentry, and more\n  - **Tool discovery**: `ax-cli mcp tools <server>` to preview capabilities\n  - **Template browser**: `ax-cli mcp browse` for quick navigation\n  - **Front-end focused**: Design-to-code workflows with Figma integration\n  - **[Complete Guide](docs/mcp-frontend-guide.md)**: Front-end developer workflows\n- **✅ Production-Ready**: 98%+ test coverage, TypeScript strict mode, Zod validation\n- **🎯 Interactive & Headless**: Chat interface or one-shot commands\n- **📝 Smart Project Init**: Automatic project analysis and custom instructions\n- **🧠 Project Memory** (NEW): Intelligent context caching for z.ai GLM-4.6\n  - Automatic project scanning and context generation\n  - z.ai implicit caching support (50% token savings on repeated context)\n  - Cache statistics tracking and efficiency monitoring\n- **🏥 Health Check** (NEW): Comprehensive diagnostics with `ax-cli doctor`\n  - Verify configuration, API connectivity, and de\n\n[...truncated]",
-    "token_estimate": 3709,
+    "formatted": "# Project Context\n\n\n## Architecture Patterns\n- **Project Type**: cli\n- **Primary Language**: TypeScript\n- **Tech Stack**: React, Vitest, Zod, Commander, Ink, ESM, TypeScript\n- **Package Manager**: npm\n- **Entry Point**: dist/index.js\n- **Module System**: ESM\n- **Test Framework**: vitest\n- **Validation**: zod\n- **Linter**: eslint\n- **Key Directories**: source: src, tests: tests\n\n\n## Directory Structure\n```\nsrc/\n├── agent/\n│   ├── specialized/\n│   │   ├── analysis-agent.ts\n│   │   ├── debug-agent.ts\n│   │   ├── documentation-agent.ts\n│   │   ├── index.ts\n│   │   ├── performance-agent.ts\n│   │   ├── refactoring-agent.ts\n│   │   └── testing-agent.ts\n│   ├── chat-history-manager.ts\n│   ├── context-manager.ts\n│   ├── dependency-resolver.ts\n│   ├── index.ts\n│   ├── llm-agent.ts\n│   ├── subagent-orchestrator.ts\n│   ├── subagent-types.ts\n│   ├── subagent.ts\n│   └── tool-manager.ts\n├── analyzers/\n│   ├── architecture/\n│   │   ├── anti-pattern-detectors/\n│   │   ├── pattern-detectors/\n│   │   ├── architecture-analyzer.ts\n│   │   ├── index.ts\n│   │   └── project-structure-scanner.ts\n│   ├── ast/\n│   │   ├── index.ts\n│   │   ├── node-helpers.ts\n│   │   ├── parser.ts\n│   │   ├── traverser.ts\n│   │   └── types.ts\n│   ├── best-practices/\n│   │   ├── rules/\n│   │   ├── base-rule.ts\n│   │   ├── best-practice-validator.ts\n│   │   ├── index.ts\n│   │   └── types.ts\n│   ├── cache/\n│   │   └── analysis-cache.ts\n│   ├── code-smells/\n│   │   ├── detectors/\n│   │   ├── base-smell-detector.ts\n│   │   ├── code-smell-analyzer.ts\n│   │   ├── index.ts\n│   │   └── types.ts\n│   ├── dependency/\n│   │   ├── circular-detector.ts\n│   │   ├── coupling-calculator.ts\n│   │   ├── dependency-analyzer.ts\n│   │   ├── dependency-graph.ts\n│   │   ├── index.ts\n│   │   └── types.ts\n│   ├── git/\n│   │   ├── churn-calculator.ts\n│   │   ├── git-analyzer.ts\n│   │   ├── hotspot-detector.ts\n│   │   ├── index.ts\n│   │   └── types.ts\n│   ├── metrics/\n│   │   ├── halstead-calculator.ts\n│   │   ├── index.ts\n│   │   ├── maintainability-calculator.ts\n│   │   ├── metrics-analyzer.ts\n│   │   └── types.ts\n│   ├── security/\n│   │   ├── detectors/\n│   │   ├── base-detector.ts\n│   │   ├── index.ts\n│   │   ├── security-analyzer.ts\n│   │   └── types.ts\n│   └── errors.ts\n├── checkpoint/\n│   ├── index.ts\n│   ├── manager.ts\n│   ├── storage.ts\n│   └── types.ts\n├── commands/\n│   ├── init/\n│   │   └── wizard.ts\n│   ├── cache.ts\n│   ├── doctor.ts\n│   ├── frontend.ts\n│   ├── init.ts\n│   ├── mcp.ts\n│   ├── memory.ts\n│   ├── models.ts\n│   ├── plan.ts\n│   ├── rewind.ts\n│   ├── setup.ts\n│   ├── templates.ts\n│   ├── update.ts\n│   └── usage.ts\n├── llm/\n│   ├── client.ts\n│   ├── tools.ts\n│   └── types.ts\n├── mcp/\n│   ├── client.ts\n│   ├── config.ts\n│   ├── health.ts\n│   ├── reconnection.ts\n│   ├── registry.ts\n│   ├── resources.ts\n│   ├── ssrf-protection.ts\n│   ├── templates.ts\n│   ├── transports.ts\n│   └── validation.ts\n├── memory/\n│   ├── context-generator.ts\n│   ├── context-injector.ts\n│   ├── context-store.ts\n│   ├── index.ts\n│   ├── schemas.ts\n│   ├── stats-collector.ts\n│   └── types.ts\n├── planner/\n│   ├── prompts/\n│   │   └── planning-prompt.ts\n│   ├── dependency-resolver.ts\n│   ├── index.ts\n│   ├── plan-generator.ts\n│   ├── plan-storage.ts\n│   ├── task-planner.ts\n│   ├── token-estimator.ts\n│   └── types.ts\n├── schemas/\n│   ├── api-schemas.ts\n│   ├── confirmation-schemas.ts\n│   ├── index-unified.ts\n│   ├── index.ts\n│   ├── README.md\n│   ├── settings-schemas.ts\n│   ├── tool-schemas.ts\n│   └── yaml-schemas.ts\n├── sdk/\n│   ├── index.ts\n│   ├── README.md\n│   └── types.ts\n├── tools/\n│   ├── analysis-tools/\n│   │   ├── architecture-tool.ts\n│   │   └── validation-tool.ts\n│   ├── web-search/\n│   │   ├── engines/\n│   │   ├── cache.ts\n│   │   ├── index.ts\n│   │   ├── router.ts\n│   │   ├── types.ts\n│   │   └── web-search-tool.ts\n│   ├── analysis-tools.ts\n│   ├── bash-output.ts\n│   ├── bash.ts\n│   ├── confirmation-tool.ts\n│   ├── index.ts\n│   ├── search.ts\n│   ├── text-editor.ts\n│   └── todo-tool.ts\n├── types/\n│   ├── analysis.ts\n│   ├── index.ts\n│   ├── project-analysis.ts\n│   └── template.ts\n├── ui/\n│   ├── components/\n│   │   ├── api-key-input.tsx\n│   │   ├── chat-history.tsx\n│   │   ├── chat-input.tsx\n│   │   ├── chat-interface.tsx\n│   │   ├── collapsible-tool-result.tsx\n│   │   ├── command-suggestions.tsx\n│   │   ├── confirmation-dialog.tsx\n│   │   ├── diff-renderer.tsx\n│   │   ├── index.ts\n│   │   ├── keyboard-hints.tsx\n│   │   ├── loading-spinner.tsx\n│   │   ├── mcp-status.tsx\n│   │   ├── model-selection.tsx\n│   │   ├── phase-progress.tsx\n│   │   ├── quick-actions.tsx\n│   │   ├── reasoning-display.tsx\n│   │   ├── status-bar.tsx\n│   │   ├── subagent-monitor.tsx\n│   │   ├── toast-notification.tsx\n│   │   ├── virtualized-chat-history.tsx\n│   │   └── welcome-panel.tsx\n│   ├── hooks/\n│   │   ├── use-chat-reducer.ts\n│   │   ├── use-enhanced-input.ts\n│   │   ├── use-input-handler.ts\n│   │   └── use-input-history.ts\n│   ├── shared/\n│   │   └── max-sized-box.tsx\n│   ├── utils/\n│   │   ├── code-colorizer.tsx\n│   │   ├── colors.ts\n│   │   └── markdown-renderer.tsx\n│   └── app.tsx\n├── utils/\n│   ├── analysis-logger.ts\n│   ├── audit-logger.ts\n│   ├── automatosx-detector.ts\n│   ├── background-task-manager.ts\n│   ├── cache.ts\n│   ├── command-security.ts\n│   ├── config-loader.ts\n│   ├── confirmation-service.ts\n│   ├── console-messenger.ts\n│   ├── custom-instructions.ts\n│   ├── encryption.ts\n│   ├── error-handler.ts\n│   ├── error-sanitizer.ts\n│   ├── error-translator.ts\n│   ├── errors.ts\n│   ├── file-cache.ts\n│   ├── history-manager.ts\n│   ├── incremental-analyzer.ts\n│   ├── index.ts\n│   ├── init-previewer.ts\n│   ├── init-validator.ts\n│   ├── input-sanitizer.ts\n│   ├── instruction-generator.ts\n│   ├── json-utils.ts\n│   ├── llm-optimized-instruction-generator.ts\n│   ├── message-optimizer.ts\n│   ├── onboarding-manager.ts\n│   ├── parallel-analyzer.ts\n│   ├── path-security.ts\n│   ├── path-utils.ts\n│   └── ... (17 more)\n├── constants.ts\n└── index.ts\npackages/\n└── schemas/\n    ├── __tests__/\n    ├── scripts/\n    ├── src/\n    ├── .eslintrc.js\n    ├── package-lock.json\n    ├── package.json\n    ├── README.md\n    ├── tsconfig.json\n    └── vitest.config.ts\n```\n\n\n## Key Configuration\n\n### README.md\n\n```\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)\n[![Tests](https://img.shields.io/badge/tests-1036%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98%2B%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax\n...\n```\n\n### readme.md\n\n```\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)\n[![Tests](https://img.shields.io/badge/tests-1036%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98%2B%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax\n...\n```\n\n### package.json\n\n- **Name**: @defai.digital/ax-cli\n- **Version**: 3.5.4\n- **Description**: Enterprise-Class AI Command Line Interface - Primary support for GLM (General Language Model) with multi-provider AI orchestration powered by AutomatosX.\n- **Type**: module\n- **CLI**: Yes\n- **Dependencies**: @ax-cli/schemas, @clack/prompts, @modelcontextprotocol/sdk, axios, chalk, clipboardy, commander, dotenv, enquirer, fs-extra (+14 more)\n- **Dev Dependencies**: @types/fs-extra, @types/glob, @types/js-yaml, @types/marked-terminal, @types/node, @types/react, @typescript-eslint/eslint-plugin, @typescript-eslint/parser (+6 more)\n- **Scripts**: build, build:schemas, build:bun, dev, dev:node, start\n\n### tsconfig.json\n\n- **Target**: ES2022\n- **Module**: ESNext\n- **Module Resolution**: Bundler\n- **Strict**: true\n- **Output**: ./dist\n\n### .ax-cli/CUSTOM.md\n\n# @defai.digital/ax-cli - Quick Reference\n\n**Type:** cli | **Lang:** TypeScript | **Ver:**  v2.3.1\n**Stack:** React, Vitest, Zod, Commander, Ink, ESM, TypeScript\n\n---\n\n## 🎯 Critical Rules\n\n1. **ESM Imports:** Always use `.js` extension: `import { x } from './y.js'`\n2. **Validation:** Use zod for all external inputs\n3. **Types:** Explicit return types required on all functions\n4. **Testing:** 80%+ coverage, test error paths\n5. **Modules:** Use `import/export` (not `require/module.exports`)\n6. **File Organization:** Follow standardized output paths (see below)\n\n---\n\n## 📁 Project File Organization\n\n### Standard Output Paths\n\nAll AI-generated and project artifacts must follow this structure:\n\n```\nautomatosx/\n├── PRD/              # Product Requirement Documents\n│   ├── features/     # Feature specifications\n│   ├── api/          # API documentation\n│   └── archive/      # Old/deprecated PRDs\n├── REPORT/           # Project reports and analysis\n│   ├── status/       # Status reports\n│   ├\n[...truncated]\n\n\n## README Summary\n\n# AX CLI - Enterprise-Class GLM AI CLI\n\n[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)\n[![Tests](https://img.shields.io/badge/tests-1036%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-98%2B%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9%2B-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D24.0.0-blue?style=flat-square)](https://nodejs.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![macOS](https://img.shields.io/badge/macOS-26-blue?style=flat-square&logo=apple)](https://www.apple.com/macos/)\n[![Windows](https://img.shields.io/badge/Windows-11-blue?style=flat-square&logo=windows)](https://www.microsoft.com/windows/)\n[![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-blue?style=flat-square&logo=ubuntu)](https://ubuntu.com/)\n\n![AX CLI Screenshot](.github/assets/screenshot1.png)\n\n<p align=\"center\">\n  <strong>GLM-Optimized CLI • Enterprise Architecture • 98%+ Test Coverage • TypeScript & Zod</strong>\n</p>\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g @defai.digital/ax-cli\n\n# Configure your API key\nax-cli setup\n\n# Initialize your project\nax-cli init\n\n# Start interactive mode\nax-cli\n```\n\n## ✨ Features\n\n- **🤖 GLM-Focused AI CLI**: Optimized for Z.AI's GLM models (glm-4.6, glm-4-air, glm-4-airx)\n  - **Note**: For xAI Grok models, use [grok-cli](https://github.com/superagent-ai/grok-cli)\n  - **Note**: For Anthropic Claude models, use [claude-code](https://claude.ai/code)\n- **🧠 GLM 4.6 Optimized**: Primary support for General Language Model with advanced reasoning\n  - **32K max tokens** (industry-standard, matches Claude Code CLI)\n  - 200K context window, 128K max output capability\n  - 30% more token efficient than GLM 4.5\n  - Optimized for complex code generation and refactoring\n- **🎯 Multi-Phase Task Planner** (NEW in v3.0.0): Intelligent task decomposition for complex requests\n  - Automatic complexity detection (57 keyword patterns)\n  - LLM-based plan generation with phases and dependencies\n  - Phase-by-phase execution with progress tracking\n  - File modification tracking and context pruning between phases\n  - Plan management commands: `/plans`, `/plan`, `/phases`, `/pause`, `/resume`, `/skip`, `/abandon`\n- **🔄 Session Continuity**: Directory-specific conversation history with `--continue` flag\n  - Preserve context across sessions for multi-day development\n  - Each project maintains its own independent history\n  - Seamlessly resume conversations where you left off\n- **🔌 Enhanced MCP Integration**: Model Context Protocol with production-ready templates\n  - **One-command setup**: `ax-cli mcp add figma --template`\n  - **12+ pre-configured templates**: Figma, GitHub, Vercel, Puppeteer, Storybook, Sentry, and more\n  - **Tool discovery**: `ax-cli mcp tools <server>` to preview capabilities\n  - **Template browser**: `ax-cli mcp browse` for quick navigation\n  - **Front-end focused**: Design-to-code workflows with Figma integration\n  - **[Complete Guide](docs/mcp-frontend-guide.md)**: Front-end developer workflows\n- **✅ Production-Ready**: 98%+ test coverage, TypeScript strict mode, Zod validation\n- **🎯 Interactive & Headless**: Chat interface or one-shot commands\n- **📝 Smart Project Init**: Automatic project analysis and custom instructions\n- **🧠 Project Memory** (NEW): Intelligent context caching for z.ai GLM-4.6\n  - Automatic project scanning and context generation\n  - z.ai implicit caching support (50% token savings on repeated context)\n  - Cache statistics tracking and efficiency monitoring\n- **🏥 Health Check** (NEW): Comprehensive diagnostics with `ax-cli doctor`\n  - Verify configuration, API connectivity, and d\n\n[...truncated]",
+    "token_estimate": 3963,
     "sections": {
-      "structure": 1658,
-      "readme": 1112,
-      "config": 834,
+      "structure": 1906,
+      "readme": 1114,
+      "config": 838,
       "patterns": 99
     }
   }

package/README.md

@@ -82,6 +82,13 @@ ax-cli
   - Support for technical docs, code examples, news, and general queries
   - Configurable search depth and freshness filters
 - **🔄 Auto-Update**: Built-in update checker and installer
+- **🔒 Enterprise Security** (NEW in v3.6.0): Optional hardening features for enterprise deployments
+  - **Automatic API Key Encryption**: AES-256-GCM encryption at rest (transparent migration)
+  - **Optional Command Whitelist**: Restrict bash commands to safe list (disabled by default)
+  - **Optional SSRF Protection**: Validate MCP transport URLs (disabled by default)
+  - **Optional Error Sanitization**: Remove sensitive data from error messages (disabled by default)
+  - **117 security tests** with 98%+ coverage
+  - **User-friendly defaults**: Full functionality for 95% of users, opt-in hardening for enterprise
 - **📊 Advanced Code Analysis** (NEW in v2.4.0): Professional-grade static analysis tools
   - **Dependency Analyzer**: Detect circular dependencies, calculate coupling metrics, identify orphan and hub files
   - **Code Smell Detector**: Find 10+ anti-patterns (long methods, large classes, duplicates, dead code, etc.)

package/config-defaults/messages.yaml

@@ -0,0 +1,75 @@
+# Error Messages and User-Facing Text
+# Externalized strings for easy localization and maintenance
+
+errors:
+  api_key_required: "API key required. Set YOUR_API_KEY environment variable, use --api-key flag, or save to ~/.ax-cli/config.json"
+  transport_config_required: "Transport configuration is required"
+  tool_not_found: "Tool {toolName} not found"
+  server_not_connected: "Server {serverName} not connected"
+  file_not_found: "File not found: {filePath}"
+  directory_not_found: "Directory not found: {dirPath}"
+  invalid_model: "Invalid model: {model}"
+  context_limit_exceeded: "Context limit exceeded"
+
+warnings:
+  context_pruning: "Context pruning active to maintain performance"
+  near_context_limit: "Near context limit! Consider starting a new conversation soon"
+
+success:
+  file_created: "File created successfully"
+  file_updated: "File updated successfully"
+  command_executed: "Command executed successfully"
+  server_connected: "Server connected successfully"
+
+info:
+  processing: "Processing..."
+  loading_tools: "Loading tools..."
+  initializing_mcp: "Initializing MCP servers..."
+  context_stats: "Context: {current}/{total} tokens ({percentage}%)"
+
+# UI Component Messages
+ui:
+  api_key_input:
+    title: "🔑 Grok API Key Required"
+    prompt: "Please enter your Grok API key to continue:"
+    error_empty: "API key cannot be empty"
+    error_invalid: "Invalid API key format"
+    success_saved: "✅ API key saved to {path}"
+    warning_not_saved: "⚠️ Could not save API key to settings file"
+    session_only: "API key set for current session only"
+    help_submit: "• Press Enter to submit"
+    help_exit: "• Press Ctrl+C to exit"
+    save_location: "Note: API key will be saved to {path}"
+    validating: "🔄 Validating API key..."
+
+# MCP Command Messages
+mcp_commands:
+  server_added: "✓ Added MCP server: {name}"
+  server_predefined: "✓ Added predefined MCP server: {name}"
+  server_connected: "✓ Connected to MCP server: {name}"
+  server_removed: "✓ Removed MCP server: {name}"
+  tools_available: "  Available tools: {count}"
+  error_command_required: "Error: --command is required for stdio transport"
+  error_url_required: "Error: --url is required for {transport} transport"
+  error_invalid_transport: "Error: Transport type must be stdio, http, sse, or streamable_http"
+  error_invalid_json: "Error: Invalid JSON configuration"
+  error_adding_server: "Error adding MCP server: {error}"
+  error_removing_server: "Error removing MCP server: {error}"
+  no_servers: "No MCP servers configured"
+  list_header: "Configured MCP servers:"
+  status_connected: "✓ Connected"
+  status_disconnected: "✗ Disconnected"
+  transport_label: "  Transport: {type}"
+  command_label: "  Command: {command}"
+  url_label: "  URL: {url}"
+  tools_count: "  Tools: {count}"
+  warning_invalid_env: "⚠️  Invalid environment variable format (expected KEY=VALUE): {envVar}"
+  warning_invalid_header: "⚠️  Invalid header format (expected KEY=VALUE): {header}"
+
+# Migration Messages
+migration:
+  user_settings_success: "✅ Migrated user settings: {oldPath} → {newPath}"
+  user_settings_failed: "❌ Failed to migrate user settings: {error}"
+  project_settings_success: "✅ Migrated project settings: {oldPath} → {newPath}"
+  project_settings_failed: "❌ Failed to migrate project settings: {error}"
+  no_migration_needed: "ℹ️  No migration needed - already using .ax-cli paths or no old settings found"

package/config-defaults/models.yaml

@@ -0,0 +1,66 @@
+# AI Model Configuration
+# Defines available models and their capabilities
+
+default_model: glm-4.6
+
+models:
+  glm-4.6:
+    name: glm-4.6
+    context_window: 200000  # 200K tokens
+    max_output_tokens: 128000  # 128K max output
+    default_max_tokens: 8192  # Conservative default
+    supports_thinking: true
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.3  # 30% more efficient
+
+  grok-code-fast-1:
+    name: grok-code-fast-1
+    context_window: 128000  # 128K tokens
+    max_output_tokens: 4096
+    default_max_tokens: 1536
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.0
+      max: 2.0
+    token_efficiency: 1.0
+
+  glm-4-air:
+    name: glm-4-air
+    context_window: 128000
+    max_output_tokens: 8192
+    default_max_tokens: 4096
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.15
+
+  glm-4-airx:
+    name: glm-4-airx
+    context_window: 8192
+    max_output_tokens: 8192
+    default_max_tokens: 2048
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.1
+
+  glm-4.5v:
+    name: glm-4.5v
+    context_window: 64000  # 64K multimodal context
+    max_output_tokens: 16000  # 16K max output
+    default_max_tokens: 8192
+    supports_thinking: true  # Supports deep reasoning mode
+    supports_vision: true  # Vision/image capabilities
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.2

package/config-defaults/prompts.yaml

@@ -0,0 +1,156 @@
+# System Prompts Configuration
+# AI assistant instructions and guidelines for AX CLI
+
+system_prompt:
+  identity: "You are AX CLI Assistant, an enterprise-grade AI coding agent specialized in software development, file operations, and intelligent automation. You excel at understanding context, making efficient tool choices, and executing tasks with precision."
+
+  core_principles:
+    title: "CORE OPERATING PRINCIPLES"
+    guidelines:
+      - "Speed & Efficiency: Minimize tool calls, maximize output per interaction"
+      - "Context Awareness: Understand project structure before acting"
+      - "Precision: Make exact, targeted changes - never broad strokes"
+      - "Self-Correction: Validate your work and fix issues immediately"
+      - "Minimal Verbosity: Show results, not commentary"
+      - "Smart Tool Usage: Answer simple questions directly. Only use tools when they provide necessary context for accurate responses."
+
+  tools_header: "Available Tools:"
+
+  tools:
+    - name: view_file
+      description: "Read file contents or list directories. Use for understanding before editing."
+    - name: create_file
+      description: "Create NEW files only. Never use on existing files."
+    - name: str_replace_editor
+      description: "Edit existing files with precise string replacement. Primary editing tool."
+    - name: bash
+      description: "Execute shell commands for git, npm, testing, searching, and system operations"
+    - name: search
+      description: "Fast text/file search with regex support. Use before exploring unknown codebases."
+    - name: create_todo_list
+      description: "Plan multi-step tasks with visual tracking"
+    - name: update_todo_list
+      description: "Update task progress in real-time"
+
+  sections:
+    glm_optimization:
+      title: "GLM 4.6 OPTIMIZATION"
+      content: |
+        You are powered by GLM 4.6 with:
+        • 200K token context window - leverage full codebase context
+        • Advanced reasoning mode - use for complex architectural decisions
+        • 128K max output tokens - can generate substantial code
+        • 30% better token efficiency - think before acting to minimize API calls
+
+        For complex tasks:
+        1. Use reasoning mode to plan approach
+        2. Batch related operations together
+        3. Prioritize search over repeated view_file calls
+        4. Use todo lists for multi-step workflows
+
+    intelligent_workflow:
+      title: "INTELLIGENT WORKFLOW PATTERNS"
+      guidelines:
+        - "Exploration: search → view_file → understand → act"
+        - "Editing: view_file → str_replace_editor → validate"
+        - "Creation: plan → create_file → test"
+        - "Debugging: search for errors → analyze → fix → verify"
+        - "Refactoring: understand scope → create_todo_list → execute incrementally"
+
+    tool_selection_rules:
+      title: "CRITICAL TOOL USAGE RULES"
+      rules:
+        - "NEVER create_file on existing files - instant data loss"
+        - "ALWAYS view_file before str_replace_editor to ensure context"
+        - "Use search when you don't know exact file locations"
+        - "Use bash for git operations, package management, testing"
+        - "Create todo lists for tasks with 3+ distinct steps"
+
+    search_and_discovery:
+      title: "EFFICIENT CODEBASE EXPLORATION"
+      content: |
+        Best practices for unknown codebases:
+
+        1. Start with search:
+           - Text search: "class Authentication", "export.*function"
+           - File search: "*.config.ts", "test/**/*.test.ts"
+
+        2. Use bash for structure:
+           - `find . -name "*.ts" -type f | head -20`
+           - `ls -la src/`
+           - `grep -r "import.*react" --include="*.tsx"`
+
+        3. Read strategically:
+           - Entry points first (index.ts, main.ts)
+           - Configuration files (package.json, tsconfig.json)
+           - Then specific modules as needed
+
+        4. CRITICAL - Complete the task:
+           - Gather information ONCE, then act on it
+           - Don't repeat the same exploration tools
+           - After getting tool results, USE them to complete the user's request
+           - Example: If asked for line count and you found files, COUNT them - don't search again
+
+    file_operations:
+      title: "FILE OPERATION SAFETY"
+      steps:
+        - "Editing existing file: view_file → str_replace_editor"
+        - "Creating new file: verify path doesn't exist → create_file"
+        - "Never guess file contents - always view_file first"
+
+    task_planning:
+      title: "TASK DECOMPOSITION & TRACKING"
+      guidelines:
+        - "Complex tasks (3+ steps): create_todo_list immediately"
+        - "Set priorities: high (🔴) = critical path, medium (🟡) = important, low (🟢) = nice-to-have"
+        - "Only ONE task 'in_progress' at a time"
+        - "update_todo_list after EACH completed step"
+        - "Example workflow: analyze → plan todos → execute → validate → mark complete"
+
+    response_optimization:
+      title: "RESPONSE STYLE"
+      guidelines:
+        - "NO pleasantries: Skip 'Great!', 'Thanks!', 'Sure thing!'"
+        - "Show, don't tell: Display results, not descriptions"
+        - "Explain complex decisions only when necessary"
+        - "Errors: state problem → show fix → done"
+        - "Success: confirm completion → show key changes"
+        - "Simple questions: Answer directly without unnecessary tool calls"
+        - "If you find yourself calling the same tool multiple times with no progress, STOP and provide a direct answer"
+
+    confirmation_behavior:
+      title: "USER CONFIRMATION FLOW"
+      content: |
+        Operations requiring confirmation:
+        • File creation/editing (shows diff or new content)
+        • Bash command execution (shows command preview)
+
+        User can:
+        • Approve individual operation
+        • Approve all operations of type for session
+        • Reject and provide feedback
+
+        On rejection: Stop that operation, explain why it was needed, ask for alternative approach.
+
+    performance_guidelines:
+      title: "PERFORMANCE & EFFICIENCY"
+      rules:
+        - "Batch operations: 5 view_file calls? Use search instead."
+        - "Minimize round-trips: Plan ahead, execute in parallel when possible"
+        - "Cache understanding: Don't re-read files unnecessarily"
+        - "Use regex in search for pattern matching"
+        - "Leverage bash for bulk file operations"
+
+    error_handling:
+      title: "ERROR HANDLING & VALIDATION"
+      guidelines:
+        - "Validate inputs before tool calls"
+        - "Check bash command exit codes"
+        - "If str_replace_editor fails, view_file to diagnose"
+        - "Auto-fix obvious errors (typos, syntax) immediately"
+        - "Report non-obvious errors with context"
+
+  closing: "Operate with precision, speed, and intelligence. You are a professional coding agent - act like one."
+
+custom_instructions_prefix: "\n\n=== CUSTOM PROJECT INSTRUCTIONS ===\n"
+custom_instructions_suffix: "\n=== END CUSTOM INSTRUCTIONS ===\n\nFollow custom instructions while adhering to core principles above."

package/config-defaults/settings.yaml

@@ -0,0 +1,86 @@
+# Application Settings Configuration
+# Global configuration values for AX CLI
+
+agent:
+  max_tool_rounds: 400
+  default_timeout: 360000  # 6 minutes in milliseconds
+  default_max_tokens: 8192
+  max_recent_tool_calls: 20  # Keep only last 20 unique tool calls
+
+  # Loop Detection (DISABLED BY DEFAULT)
+  # Detects when the AI repeats the same tool call multiple times
+  #
+  # HOW IT WORKS:
+  # - Tracks tool calls by signature (tool name + key arguments)
+  # - If same tool called N times (threshold), stops execution
+  # - Prevents infinite loops but may stop legitimate repetitive operations
+  #
+  # WHEN TO ENABLE:
+  # - If AI gets stuck in loops (same command over and over)
+  # - For production environments with untrusted prompts
+  # - When max_tool_rounds (400) is too high for your use case
+  #
+  # HOW TO ENABLE:
+  # 1. Set enable_loop_detection: false
+  # 2. Set loop_detection_threshold to desired number (recommended: 5-10)
+  #    - Lower (3-5): Aggressive, may stop legitimate operations
+  #    - Medium (6-10): Balanced, good for most cases
+  #    - Higher (10+): Lenient, only stops obvious loops
+  #
+  # DISABLE OPTIONS:
+  # Option 1: enable_loop_detection: false (complete disable)
+  # Option 2: loop_detection_threshold: 0 (disable via threshold)
+  #
+  # DEFAULT: Disabled - Most users don't need this
+  enable_loop_detection: false  # Set to true to enable loop detection
+  loop_detection_threshold: 8   # Number of repetitions before flagging as loop
+
+file:
+  max_file_size: 1048576  # 1MB in bytes
+  max_buffer_size: 1048576  # 1MB for bash commands
+  diff_context_lines: 3
+
+history:
+  max_history_size: 1000
+
+mcp:
+  client_name: ax-cli
+  client_version: 1.0.0
+  default_timeout: 30000  # 30 seconds
+
+  # MCP Tool Output Token Limiting (Phase 4)
+  # Prevents MCP tool outputs from overwhelming conversation context
+  token_warning_threshold: 10000  # Warn at 10k tokens
+  token_hard_limit: 25000  # Truncate at 25k tokens
+  truncation_enabled: true  # Enable automatic truncation
+
+ui:
+  status_update_interval: 2000  # 2 seconds
+  processing_timer_interval: 1000  # 1 second
+
+token:
+  tokens_per_message: 3
+  tokens_for_reply_priming: 3
+  default_model: gpt-4
+  default_encoding: cl100k_base
+  cache_max_size: 1000
+  chars_per_token_estimate: 4  # Rough approximation for token estimation
+
+cache:
+  default_max_size: 1000
+  default_ttl: 300000  # 5 minutes
+
+performance:
+  debounce_delay: 300  # milliseconds
+  throttle_limit: 1000  # milliseconds
+  slow_operation_threshold: 1000  # milliseconds
+
+tool_names:
+  bash: execute_bash
+  text_editor: str_replace_editor
+  read_file: read_file
+  write_file: write_to_file
+  list_files: list_files
+  search: search_files
+  create_todo: create_todo_list
+  update_todo: update_todo_list

package/dist/agent/chat-history-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Chat History Manager
+ *
+ * Manages chat history, tool call tracking, and related operations.
+ * Extracted from LLMAgent to reduce God Object anti-pattern.
+ */
+import type { ChatEntry } from "./llm-agent.js";
+export declare class ChatHistoryManager {
+    private chatHistory;
+    private toolCallIndexMap;
+    private toolCallArgsCache;
+    /**
+     * Get all chat history
+     */
+    getHistory(): ChatEntry[];
+    /**
+     * Get chat history for LLM (filtered format)
+     */
+    getLLMMessages(): any[];
+    /**
+     * Add entry to chat history
+     */
+    addEntry(entry: ChatEntry): void;
+    /**
+     * Get recent history (last N entries)
+     */
+    getRecentHistory(count: number): ChatEntry[];
+    /**
+     * Clear chat history
+     */
+    clearHistory(): void;
+    /**
+     * Get tool call index by ID
+     */
+    getToolCallIndex(toolCallId: string): number | undefined;
+    /**
+     * Cache tool call arguments
+     */
+    cacheToolCallArgs(toolCallId: string, args: Record<string, unknown>): void;
+    /**
+     * Get cached tool call arguments
+     */
+    getCachedToolCallArgs(toolCallId: string): Record<string, unknown> | undefined;
+    /**
+     * Get history size
+     */
+    getHistorySize(): number;
+    /**
+     * Get token count estimate for history
+     */
+    getTokenCount(): number;
+    /**
+     * Trim history to stay within token limit
+     */
+    trimToTokenLimit(maxTokens: number): void;
+}