@xagent/x-cli 1.1.56 → 1.1.58

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.56 – Logo Assets & NPM Publication Complete
+## 1.1.58 – 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
 
@@ -430,8 +430,9 @@ 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. **Smart Loading**: Reads key documentation files into chat context
-3. **Context Enhancement**: Provides comprehensive project understanding to AI
+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
 
 ### 📂 **Key Components**
 

package/dist/index.js

@@ -9293,7 +9293,7 @@ EOF`;
 var package_default = {
   type: "module",
   name: "@xagent/x-cli",
-  version: "1.1.56",
+  version: "1.1.58",
   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"
   },
@@ -18314,75 +18315,88 @@ function ChatInterfaceWithAgent({
     if (fs__default.existsSync(".agent")) {
       const initialMessages = [];
       let docsRead = 0;
-      initialMessages.push({
-        type: "assistant",
-        content: "\u{1F4DA} Reading core documentation into memory...",
-        timestamp: /* @__PURE__ */ new Date()
-      });
-      const archPath = path7__default.join(".agent", "system", "architecture.md");
-      if (fs__default.existsSync(archPath)) {
-        try {
-          const archContent = fs__default.readFileSync(archPath, "utf8");
-          initialMessages.push({
-            type: "assistant",
-            content: `\u{1F4CB} **System Architecture (from .agent/system/architecture.md)**
-
-${archContent}`,
-            timestamp: /* @__PURE__ */ new Date()
-          });
-          docsRead++;
-        } catch (_error) {
+      let config2 = null;
+      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 workflowPath = path7__default.join(".agent", "sop", "git-workflow.md");
-      if (fs__default.existsSync(workflowPath)) {
-        try {
-          const workflowContent = fs__default.readFileSync(workflowPath, "utf8");
-          initialMessages.push({
-            type: "assistant",
-            content: `\u{1F527} **Git Workflow SOP (from .agent/sop/git-workflow.md)**
-
-${workflowContent}`,
-            timestamp: /* @__PURE__ */ new Date()
-          });
-          docsRead++;
-        } catch (_error) {
-        }
+      const isEnabled = config2?.enabled !== false;
+      const showLoadingMessage = config2?.showLoadingMessage !== false;
+      const showSummaryMessage = config2?.showSummaryMessage !== false;
+      if (!isEnabled) {
+        return;
       }
-      const sopDir = path7__default.join(".agent", "sop");
-      if (fs__default.existsSync(sopDir)) {
-        const sopFiles = ["release-management.md", "automation-protection.md"];
-        for (const file of sopFiles) {
-          const filePath = path7__default.join(sopDir, file);
-          if (fs__default.existsSync(filePath)) {
-            try {
-              const content = fs__default.readFileSync(filePath, "utf8");
-              const title = file.replace(".md", "").replace("-", " ").toUpperCase();
-              initialMessages.push({
-                type: "assistant",
-                content: `\u{1F4D6} **${title} SOP (from .agent/sop/${file})**
-
-${content}`,
-                timestamp: /* @__PURE__ */ new Date()
-              });
-              docsRead++;
-            } catch (_error) {
-            }
-          }
+      if (showLoadingMessage) {
+        initialMessages.push({
+          type: "assistant",
+          content: "\u{1F4DA} Reading core documentation into memory...",
+          timestamp: /* @__PURE__ */ new Date()
+        });
+      }
+      const folders = config2?.folders || [
+        {
+          name: "system",
+          priority: 1,
+          files: [
+            { name: "architecture.md", title: "System Architecture", icon: "\u{1F4CB}", required: true },
+            { name: "critical-state.md", title: "Critical State", icon: "\u{1F3D7}\uFE0F", required: false },
+            { name: "installation.md", title: "Installation", icon: "\u{1F3D7}\uFE0F", required: false },
+            { name: "api-schema.md", title: "API Schema", icon: "\u{1F3D7}\uFE0F", required: false },
+            { name: "auto-read-system.md", title: "Auto-Read System", icon: "\u{1F3D7}\uFE0F", required: false }
+          ]
+        },
+        {
+          name: "sop",
+          priority: 2,
+          files: [
+            { name: "git-workflow.md", title: "Git Workflow SOP", icon: "\u{1F527}", required: true },
+            { name: "release-management.md", title: "Release Management SOP", icon: "\u{1F4D6}", required: false },
+            { name: "automation-protection.md", title: "Automation Protection SOP", icon: "\u{1F4D6}", required: false },
+            { name: "npm-publishing-troubleshooting.md", title: "NPM Publishing Troubleshooting", icon: "\u{1F4D6}", required: false }
+          ]
         }
+      ];
+      if (config2?.customFolders) {
+        folders.push(...config2.customFolders);
       }
-      const systemDir = path7__default.join(".agent", "system");
-      if (fs__default.existsSync(systemDir)) {
-        const systemFiles = ["critical-state.md", "installation.md", "api-schema.md", "auto-read-system.md"];
-        for (const file of systemFiles) {
-          const filePath = path7__default.join(systemDir, file);
-          if (fs__default.existsSync(filePath)) {
+      folders.sort((a, b) => (a.priority || 999) - (b.priority || 999));
+      for (const folder of folders) {
+        const folderPath = path7__default.join(".agent", folder.name);
+        if (!fs__default.existsSync(folderPath)) {
+          continue;
+        }
+        for (const file of folder.files) {
+          let filePaths = [];
+          if (file.pattern) {
+            continue;
+          } else {
+            filePaths = [file.name];
+          }
+          for (const fileName of filePaths) {
+            const filePath = path7__default.join(folderPath, fileName);
+            if (!fs__default.existsSync(filePath)) {
+              if (file.required) ;
+              continue;
+            }
             try {
               const content = fs__default.readFileSync(filePath, "utf8");
-              const title = file.replace(".md", "").replace("-", " ").toUpperCase();
+              const displayTitle = file.title || fileName.replace(".md", "").replace("-", " ").toUpperCase();
+              const icon = file.icon || "\u{1F4C4}";
               initialMessages.push({
                 type: "assistant",
-                content: `\u{1F3D7}\uFE0F **${title} (from .agent/system/${file})**
+                content: `${icon} **${displayTitle} (from .agent/${folder.name}/${fileName})**
 
 ${content}`,
                 timestamp: /* @__PURE__ */ new Date()
@@ -18393,7 +18407,7 @@ ${content}`,
           }
         }
       }
-      if (docsRead > 0) {
+      if (showSummaryMessage && docsRead > 0) {
         initialMessages.push({
           type: "assistant",
           content: `\u2705 ${docsRead} documentation files read - I have a complete understanding of the current architecture and operational procedures.`,