@xagent/x-cli 1.1.57 → 1.1.59

package/.xcli/auto-read-config.json

@@ -0,0 +1,100 @@
+{
+  "enabled": true,
+  "showLoadingMessage": true,
+  "showSummaryMessage": true,
+  "folders": [
+    {
+      "name": "system",
+      "description": "System Architecture & State",
+      "priority": 1,
+      "files": [
+        {
+          "name": "architecture.md",
+          "title": "System Architecture",
+          "description": "Complete system design and technology stack",
+          "icon": "📋",
+          "required": true
+        },
+        {
+          "name": "critical-state.md",
+          "title": "Critical State",
+          "description": "Current system capabilities and status",
+          "icon": "🏗️",
+          "required": false
+        },
+        {
+          "name": "installation.md",
+          "title": "Installation",
+          "description": "Setup and deployment procedures",
+          "icon": "🏗️",
+          "required": false
+        },
+        {
+          "name": "api-schema.md",
+          "title": "API Schema",
+          "description": "API integration specifications",
+          "icon": "🏗️",
+          "required": false
+        },
+        {
+          "name": "auto-read-system.md",
+          "title": "Auto-Read System",
+          "description": "Documentation of this auto-loading feature",
+          "icon": "🏗️",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "sop",
+      "description": "Standard Operating Procedures",
+      "priority": 2,
+      "files": [
+        {
+          "name": "git-workflow.md",
+          "title": "Git Workflow SOP",
+          "description": "Git workflow standards and smart push guidelines",
+          "icon": "🔧",
+          "required": true
+        },
+        {
+          "name": "release-management.md",
+          "title": "Release Management SOP",
+          "description": "Automated release processes and version management",
+          "icon": "📖",
+          "required": false
+        },
+        {
+          "name": "automation-protection.md",
+          "title": "Automation Protection SOP",
+          "description": "Safeguards for automated NPM publishing",
+          "icon": "📖",
+          "required": false
+        },
+        {
+          "name": "npm-publishing-troubleshooting.md",
+          "title": "NPM Publishing Troubleshooting",
+          "description": "NPM publication issue resolution",
+          "icon": "📖",
+          "required": false
+        }
+      ]
+    }
+  ],
+  "customFolders": [
+    // Add custom folders here
+    // {
+    //   "name": "guides",
+    //   "description": "Project Guides",
+    //   "priority": 3,
+    //   "files": [
+    //     {
+    //       "name": "*.md",
+    //       "pattern": true,
+    //       "title": "Guide",
+    //       "icon": "📚"
+    //     }
+    //   ]
+    // }
+  ]
+}

package/README.md

@@ -1,4 +1,4 @@
-## 1.1.57 – Logo Assets & NPM Publication Complete
+## 1.1.59 – Logo Assets & NPM Publication Complete
 
 ✅ **Live on NPM**: [@xagent/x-cli](https://www.npmjs.com/package/@xagent/x-cli) - Fully published and ready for global installation
 
@@ -123,6 +123,15 @@ A conversational AI CLI tool powered by Grok with **Claude Code-level intelligen
 - **💻 Beautiful Terminal UI**: Interactive interface with Claude Code-style animations and feedback
 - **📋 Smart Paste Detection**: Large pasted content automatically summarizes as `[Pasted text #1 +12 lines]` for clean chat history
 
+### 🎛️ **Interactive Chat Interface**
+
+- **Three Interaction Modes**: Chat (immediate), Balanced (smart detection), REPL (full interactive)
+- **Balanced Mode Default**: Automatically chooses workflow based on task complexity
+- **Research Phase**: Agent explains investigation approach with progress indicators
+- **Options Presentation**: Clear recommendations with pros/cons for complex tasks
+- **Confirmation Workflow**: Keyboard shortcuts (y/n/modify/cancel) for efficient decisions
+- **State Persistence**: Settings saved to `~/.xcli/config.json` across sessions
+
 ### 🎨 **Enhanced User Experience**
 
 - **🎭 Professional Welcome Banner**: ASCII art with dynamic context status (`Context: Dynamic │ Files: indexed │ Session: Restored`)
@@ -430,7 +439,7 @@ The **`.agent` folder** is the most powerful feature of X CLI, enabling **self-d
 When you run `npx -y @xagent/x-cli@latest`, the CLI automatically detects and reads `.agent/` documentation:
 
 1. **Auto-Discovery**: Scans for `.agent/` folder in current directory
-2. **Configuration Loading**: Reads `.agent/auto-read-config.json` for custom settings
+2. **Configuration Loading**: Reads `.xcli/auto-read-config.json` (distributed) or `.agent/auto-read-config.json` (project override)
 3. **Smart Loading**: Reads configured documentation files into chat context
 4. **Context Enhancement**: Provides comprehensive project understanding to AI
 

package/dist/index.js

@@ -9293,7 +9293,7 @@ EOF`;
 var package_default = {
   type: "module",
   name: "@xagent/x-cli",
-  version: "1.1.57",
+  version: "1.1.59",
   description: "An open-source AI agent that brings the power of Grok directly into your terminal.",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -9307,6 +9307,13 @@ var package_default = {
   bin: {
     xcli: "dist/index.js"
   },
+  files: [
+    "dist/**/*",
+    ".xcli/**/*",
+    "README.md",
+    "LICENSE",
+    "docs/assets/logos/**/*"
+  ],
   scripts: {
     build: "tsup",
     "build:tsc": "tsc",
@@ -9405,12 +9412,6 @@ var package_default = {
   },
   homepage: "https://grokcli.dev",
   icon: "docs/assets/logos/x-cli-logo.svg",
-  files: [
-    "dist/**/*",
-    "README.md",
-    "LICENSE",
-    "docs/assets/logos/**/*"
-  ],
   publishConfig: {
     access: "public"
   },
@@ -14901,6 +14902,14 @@ function useInputHandler({
       return "brief";
     }
   });
+  const [_interactivityLevel, _setInteractivityLevel] = useState(() => {
+    try {
+      const manager = getSettingsManager();
+      return manager.getUserSetting("interactivityLevel") || "balanced";
+    } catch {
+      return "balanced";
+    }
+  });
   const planMode = usePlanMode({}, agent);
   const handleSpecialKey = (key) => {
     if (isConfirmationActive) {
@@ -15106,6 +15115,7 @@ function useInputHandler({
     { command: "/models", description: "Switch Grok Model" },
     { command: "/verbosity", description: "Control output verbosity (quiet/normal/verbose)" },
     { command: "/explain", description: "Control operation explanations (off/brief/detailed)" },
+    { command: "/interactivity", description: "Set interaction style (chat/balanced/repl)" },
     { command: "/upgrade", description: "Check for updates and upgrade CLI" },
     { command: "/version", description: "Show version information" },
     { command: "/switch", description: "Switch to specific version" },
@@ -18315,12 +18325,20 @@ function ChatInterfaceWithAgent({
       const initialMessages = [];
       let docsRead = 0;
       let config2 = null;
-      const configPath = path7__default.join(".agent", "auto-read-config.json");
-      if (fs__default.existsSync(configPath)) {
-        try {
-          const configContent = fs__default.readFileSync(configPath, "utf8");
-          config2 = JSON.parse(configContent);
-        } catch (_error) {
+      const configPaths = [
+        path7__default.join(".xcli", "auto-read-config.json"),
+        // User config (distributed)
+        path7__default.join(".agent", "auto-read-config.json")
+        // Dev override (gitignored)
+      ];
+      for (const configPath of configPaths) {
+        if (fs__default.existsSync(configPath)) {
+          try {
+            const configContent = fs__default.readFileSync(configPath, "utf8");
+            config2 = JSON.parse(configContent);
+            break;
+          } catch (_error) {
+          }
         }
       }
       const isEnabled = config2?.enabled !== false;