@bonginkan/maria 4.2.10 → 4.2.13

package/README.md

@@ -1,4 +1,4 @@
-# MARIA - AI Development Platform v4.2.10
+# MARIA - AI Development Platform v4.2.13
 
 [![npm version](https://img.shields.io/npm/v/@bonginkan/maria.svg)](https://www.npmjs.com/package/@bonginkan/maria)
 [![License](https://img.shields.io/badge/license-Multi--tier-blue.svg)](LICENSE)
@@ -10,7 +10,7 @@
 
 > **Enterprise-grade AI development platform with 100% command availability and comprehensive fallback support**
 
-## 🚀 What's New in v4.2.10 (September 3, 2025)
+## 🚀 What's New in v4.2.13 (September 3, 2025)
 
 ### 🏗️ Build Status - All Systems Operational ✅
 - **CLI NPM Package**: ESM + CJS builds successful (2.02MB/1.16MB)
@@ -61,6 +61,34 @@
 $ npm install -g @bonginkan/maria
 ```
 
+### 🪟 Windows: Add npm global prefix to PATH
+On Windows, npm's global bin directory may not be on PATH by default. After installing, verify and add the directory returned by `npm prefix -g` to PATH.
+
+```powershell
+# Show npm global prefix (this directory should be on PATH)
+npm prefix -g;
+
+# Temporarily add to current PowerShell session
+$env:Path += ";" + (npm prefix -g).Trim(); Get-Command maria;
+
+# Persist for the current user (idempotent)
+$npmBin = (npm prefix -g).Trim();
+$userPath = [Environment]::GetEnvironmentVariable('Path','User');
+if ($userPath -notlike "*$npmBin*") {
+  [Environment]::SetEnvironmentVariable('Path', ($userPath.TrimEnd(';') + ";" + $npmBin), 'User');
+  "Added to PATH: $npmBin";
+} else {
+  "Already on PATH: $npmBin";
+}
+
+# Restart PowerShell, then verify
+maria --version;
+```
+
+Notes:
+- Default location is typically `%APPDATA%\npm` on Windows.
+- You can also run the CLI without installing globally via: `npx @bonginkan/maria --help`
+
 ### 🔗 VS Code Extension (NEW)
 **AI-powered coding directly in your editor**
 
@@ -707,10 +735,10 @@ await secureWorkflow.executeWithAuth(workflowDefinition, securityContext);
 ### Quick Installation
 ```bash
 # Install globally (recommended)
-npm install -g @bonginkan/maria@4.2.10
+npm install -g @bonginkan/maria@4.2.13
 
 # Verify installation
-maria --version  # Should show v4.2.10
+maria --version  # Should show v4.2.13
 
 # Initialize with authentication
 maria /login     # Setup OAuth2.0 + PKCE authentication
@@ -911,7 +939,7 @@ MARIA CODE is distributed under a comprehensive licensing system designed for in
 
 *MARIA v4.1.4 represents the pinnacle of multimodal AI development platform evolution - combining revolutionary voice-to-code capabilities, advanced memory systems, and comprehensive command ecosystems with enterprise-grade security and performance. This release establishes MARIA as the definitive choice for developers and Fortune 500 enterprises seeking intelligent, multimodal development experiences with GraphRAG intelligence, multilingual support, and zero-anxiety coding workflows.*
 
-**Transform your development experience today**: `npm install -g @bonginkan/maria@4.2.10`
+**Transform your development experience today**: `npm install -g @bonginkan/maria@4.2.13`
 
 🌐 **Official Website**: [https://maria-code.ai](https://maria-code.ai)  
 💬 **Community**: [https://discord.gg/SMSmSGcEQy](https://discord.gg/SMSmSGcEQy)  

package/dist/READY.manifest.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2025-09-04T04:59:03.918Z",
+  "generatedAt": "2025-09-04T07:10:40.845Z",
   "totalCommands": 76,
   "readyCount": 74,
   "partialCount": 1,
@@ -356,54 +356,54 @@
       "depsAvailable": true,
       "description": "About MARIA - version, features, and credits"
     },
-    "configuration/setup": {
+    "conversation/clear": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "First-time environment setup wizard"
+      "description": "Clear conversation history"
     },
-    "conversation/clear": {
+    "configuration/setup": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Clear conversation history"
+      "description": "First-time environment setup wizard"
     },
-    "business/sales-dashboard": {
+    "code/mm": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Sales metrics and dashboard"
+      "description": "Multimodal code generation (image/voice to code)"
     },
-    "business/battlecard": {
+    "code/multimodal": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Competitive battlecard generator"
+      "description": "Advanced multimodal AI operations"
     },
-    "code/mm": {
+    "code/code": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Multimodal code generation (image/voice to code)"
+      "description": "Generate code with AI assistance"
     },
-    "code/multimodal": {
+    "business/sales-dashboard": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Advanced multimodal AI operations"
+      "description": "Sales metrics and dashboard"
     },
-    "code/code": {
+    "business/battlecard": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Generate code with AI assistance"
+      "description": "Competitive battlecard generator"
     },
     "ai/gpu": {
       "status": "READY",
@@ -441,47 +441,47 @@
       "depsAvailable": true,
       "description": "AI-powered research and analysis"
     },
-    "configuration/permissions": {
+    "core/update": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Manage permissions and access control"
+      "description": "Update project dependencies and configurations"
     },
-    "configuration/model": {
+    "core/exit": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Select and configure AI model"
+      "description": "Exit MARIA CLI"
     },
-    "configuration/unknown": {
+    "configuration/permissions": {
       "status": "READY",
       "hasExecute": true,
-      "hasMetadata": false,
+      "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Handle unknown command fallback"
+      "description": "Manage permissions and access control"
     },
-    "configuration/config": {
+    "configuration/model": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Configuration management"
+      "description": "Select and configure AI model"
     },
-    "core/update": {
+    "configuration/unknown": {
       "status": "READY",
       "hasExecute": true,
-      "hasMetadata": true,
+      "hasMetadata": false,
       "depsAvailable": true,
-      "description": "Update project dependencies and configurations"
+      "description": "Handle unknown command fallback"
     },
-    "core/exit": {
+    "configuration/config": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Exit MARIA CLI"
+      "description": "Configuration management"
     },
     "monitoring/monitor": {
       "status": "READY",
@@ -497,19 +497,19 @@
       "depsAvailable": true,
       "description": "Advanced memory service operations"
     },
-    "core/enhanced-help": {
+    "configuration/hooks": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Advanced help system with interactive features"
+      "description": "Configure and manage command hooks"
     },
-    "configuration/hooks": {
+    "core/enhanced-help": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Configure and manage command hooks"
+      "description": "Advanced help system with interactive features"
     },
     "business/analytics": {
       "status": "READY",

package/dist/bin/maria.cjs

@@ -21942,8 +21942,8 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@bonginkan/maria",
-      version: "4.2.10",
-      description: "\u{1F680} MARIA v4.2.10 - Enterprise AI Development Platform with 100% Command Availability. Features 74 production-ready commands with comprehensive fallback implementation, local LLM support, and zero external dependencies. Includes natural language coding, AI safety evaluation, intelligent evolution system, episodic memory with PII masking, and real-time monitoring dashboard. Built with TypeScript AST-powered code generation, OAuth2.0 + PKCE authentication, quantum-resistant cryptography, and enterprise-grade performance.",
+      version: "4.2.13",
+      description: "\u{1F680} MARIA v4.2.13 - Enterprise AI Development Platform with 100% Command Availability. Features 74 production-ready commands with comprehensive fallback implementation, local LLM support, and zero external dependencies. Includes natural language coding, AI safety evaluation, intelligent evolution system, episodic memory with PII masking, and real-time monitoring dashboard. Built with TypeScript AST-powered code generation, OAuth2.0 + PKCE authentication, quantum-resistant cryptography, and enterprise-grade performance.",
       keywords: [
         "ai",
         "cli",
@@ -23150,6 +23150,7 @@ var init_AuthenticationManager = __esm({
           this.clientId = config2.clientId;
           this.initialized = true;
         } catch (error2) {
+          console.warn("Auth config initialization failed, using fallbacks:", error2);
           this.authBase = this.getAuthBaseUrl();
           this.apiBase = this.getApiBaseUrl();
           this.clientId = process.env.MARIA_CLIENT_ID || "maria-cli";
@@ -23196,7 +23197,8 @@ var init_AuthenticationManager = __esm({
             return await this.refreshToken();
           }
           return true;
-        } catch {
+        } catch (error2) {
+          console.error("isAuthenticated failed:", error2);
           return false;
         }
       }
@@ -23260,6 +23262,7 @@ var init_AuthenticationManager = __esm({
           if (error2 instanceof AuthenticationRequiredError || error2 instanceof QuotaExceededError) {
             throw error2;
           }
+          console.error("getCurrentUser failed:", error2);
           throw new Error(ERROR_MESSAGES.NETWORK_ERROR);
         }
       }
@@ -23277,12 +23280,17 @@ var init_AuthenticationManager = __esm({
             return await this.loginWithLocalMock();
           }
           let tokens;
-          if (options.device) {
+          const forceDevice = options.device || process.env.MARIA_AUTH_DEVICE_FLOW === "true" || !this.canLaunchBrowser();
+          if (forceDevice) {
+            if (!options.device) {
+              console.warn("PKCE is unavailable in this environment; using device flow.");
+            }
             tokens = await this.loginWithDeviceFlow();
           } else {
             try {
               tokens = await this.loginWithPKCEFlow();
             } catch (error2) {
+              console.error("PKCE flow error:", error2);
               if (error2.message?.includes("ECONNREFUSED") || error2.message?.includes("fetch failed")) {
                 console.error("\n\u274C Authentication service is currently unavailable");
                 console.error("Please try one of the following:");
@@ -23304,6 +23312,7 @@ var init_AuthenticationManager = __esm({
           const user = await this.getCurrentUser();
           return { success: true, user, tokens };
         } catch (error2) {
+          console.error("Login failed:", error2);
           return {
             success: false,
             error: error2.message || "Login failed"
@@ -23395,7 +23404,8 @@ var init_AuthenticationManager = __esm({
           };
           await this.tokenStorage.save(updatedTokens);
           return true;
-        } catch {
+        } catch (error2) {
+          console.error("Token refresh failed:", error2);
           return false;
         }
       }
@@ -23437,6 +23447,7 @@ var init_AuthenticationManager = __esm({
             await (0, import_open.default)(authUrl);
           } catch (error2) {
             server.close();
+            console.error("Failed to open browser for authentication:", error2);
             throw new Error("Failed to open browser");
           }
           const authCode = await this.waitForCallback(server, pkceParams.state);
@@ -23460,57 +23471,62 @@ var init_AuthenticationManager = __esm({
        * Login with device flow (fallback)
        */
       async loginWithDeviceFlow() {
-        const response2 = await fetch(`${this.authBase}/oauth/device/start`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            client_id: this.clientId,
-            scope: "user:profile user:inference org:create_api_key"
-          })
-        });
-        if (!response2.ok) {
-          throw new Error(`Device flow start failed: ${response2.statusText}`);
-        }
-        const raw = await response2.json();
-        const deviceResponse = {
-          verificationUri: raw.verification_uri || raw.verificationUri || "https://auth.maria-code.ai/device",
-          userCode: raw.user_code || raw.userCode || "",
-          deviceCode: raw.device_code || raw.deviceCode || "",
-          interval: (typeof raw.interval === "number" ? raw.interval : parseInt(String(raw.interval || 5), 10)) || 5,
-          expiresIn: (typeof raw.expires_in === "number" ? raw.expires_in : parseInt(String(raw.expires_in || raw.expiresIn || 600), 10)) || 600
-        };
-        const verificationUrl = deviceResponse.verificationUri || `${this.authBase}/device`;
-        console.log(`\u{1F510} Device Login`);
-        console.log(`Open: ${verificationUrl}`);
-        console.log(`Code: ${deviceResponse.userCode}`);
-        const deadline = Date.now() + deviceResponse.expiresIn * 1e3;
-        const intervalMs = Math.max(1500, deviceResponse.interval * 1e3);
-        while (Date.now() < deadline) {
-          await this.sleep(intervalMs);
-          const finishResponse = await fetch(`${this.authBase}/oauth/device/finish`, {
+        try {
+          const response2 = await fetch(`${this.authBase}/oauth/device/start`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
               client_id: this.clientId,
-              device_code: deviceResponse.deviceCode
+              scope: "user:profile user:inference org:create_api_key"
             })
           });
-          if (finishResponse.status === 428 || finishResponse.status === 400) {
-            continue;
-          }
-          if (!finishResponse.ok) {
-            throw new Error(`Device flow failed: ${finishResponse.statusText}`);
-          }
-          const tokens = await finishResponse.json();
-          return {
-            idToken: tokens.id_token || tokens.access_token || "",
-            accessToken: tokens.access_token || tokens.id_token || "",
-            refreshToken: tokens.refresh_token || "",
-            customToken: tokens.custom_token,
-            expiresAt: Date.now() + (tokens.expires_in ? Number(tokens.expires_in) : 600) * 1e3
+          if (!response2.ok) {
+            throw new Error(`Device flow start failed: ${response2.statusText}`);
+          }
+          const raw = await response2.json();
+          const deviceResponse = {
+            verificationUri: raw.verification_uri || raw.verificationUri || "https://auth.maria-code.ai/device",
+            userCode: raw.user_code || raw.userCode || "",
+            deviceCode: raw.device_code || raw.deviceCode || "",
+            interval: (typeof raw.interval === "number" ? raw.interval : parseInt(String(raw.interval || 5), 10)) || 5,
+            expiresIn: (typeof raw.expires_in === "number" ? raw.expires_in : parseInt(String(raw.expires_in || raw.expiresIn || 600), 10)) || 600
           };
+          const verificationUrl = deviceResponse.verificationUri || `${this.authBase}/device`;
+          console.log(`\u{1F510} Device Login`);
+          console.log(`Open: ${verificationUrl}`);
+          console.log(`Code: ${deviceResponse.userCode}`);
+          const deadline = Date.now() + deviceResponse.expiresIn * 1e3;
+          const intervalMs = Math.max(1500, deviceResponse.interval * 1e3);
+          while (Date.now() < deadline) {
+            await this.sleep(intervalMs);
+            const finishResponse = await fetch(`${this.authBase}/oauth/device/finish`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({
+                client_id: this.clientId,
+                device_code: deviceResponse.deviceCode
+              })
+            });
+            if (finishResponse.status === 428 || finishResponse.status === 400) {
+              continue;
+            }
+            if (!finishResponse.ok) {
+              throw new Error(`Device flow failed: ${finishResponse.statusText}`);
+            }
+            const tokens = await finishResponse.json();
+            return {
+              idToken: tokens.id_token || tokens.access_token || "",
+              accessToken: tokens.access_token || tokens.id_token || "",
+              refreshToken: tokens.refresh_token || "",
+              customToken: tokens.custom_token,
+              expiresAt: Date.now() + (tokens.expires_in ? Number(tokens.expires_in) : 600) * 1e3
+            };
+          }
+          throw new Error(ERROR_MESSAGES.LOGIN_TIMEOUT);
+        } catch (error2) {
+          console.error("Device flow error:", error2);
+          throw error2;
         }
-        throw new Error(ERROR_MESSAGES.LOGIN_TIMEOUT);
       }
       /**
        * Generate PKCE parameters
@@ -23549,8 +23565,10 @@ var init_AuthenticationManager = __esm({
           } catch (error2) {
             lastError = error2;
             if (error2.code !== "EADDRINUSE") {
+              console.error("Failed to start callback server:", error2);
               throw error2;
             }
+            console.warn("Callback server port in use, retrying...", error2?.message || error2);
           }
         }
         throw lastError || new Error("Failed to find available port");
@@ -23582,6 +23600,7 @@ var init_AuthenticationManager = __esm({
         return new Promise((resolve4, reject) => {
           const timeout = setTimeout(() => {
             server.close();
+            console.error("OAuth callback timed out");
             reject(new Error(ERROR_MESSAGES.LOGIN_TIMEOUT));
           }, 5 * 60 * 1e3);
           server.on("request", (req, res) => {
@@ -23594,6 +23613,7 @@ var init_AuthenticationManager = __esm({
                 res.writeHead(400, { "Content-Type": "text/html" });
                 res.end(this.getErrorPage(error2));
                 clearTimeout(timeout);
+                console.error("OAuth callback returned error:", error2);
                 reject(new Error(error2));
                 return;
               }
@@ -23601,6 +23621,7 @@ var init_AuthenticationManager = __esm({
                 res.writeHead(400, { "Content-Type": "text/html" });
                 res.end(this.getErrorPage("Invalid state parameter"));
                 clearTimeout(timeout);
+                console.error("OAuth callback invalid state", { received: state, expected: expectedState });
                 reject(new Error(ERROR_MESSAGES.INVALID_STATE));
                 return;
               }
@@ -23618,28 +23639,39 @@ var init_AuthenticationManager = __esm({
        * Exchange authorization code for tokens
        */
       async exchangeCodeForTokens(code, codeVerifier, redirectUri) {
-        const response2 = await fetch(`${this.authBase}/oauth/token`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            grant_type: "authorization_code",
-            client_id: this.clientId,
-            code,
-            code_verifier: codeVerifier,
-            redirect_uri: redirectUri
-          })
-        });
-        if (!response2.ok) {
-          throw new Error(`Token exchange failed: ${response2.statusText}`);
+        try {
+          const response2 = await fetch(`${this.authBase}/oauth/token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              grant_type: "authorization_code",
+              client_id: this.clientId,
+              code,
+              code_verifier: codeVerifier,
+              redirect_uri: redirectUri
+            })
+          });
+          if (!response2.ok) {
+            let bodyText = "";
+            try {
+              bodyText = await response2.text();
+            } catch {
+            }
+            console.error("Token exchange failed:", response2.status, response2.statusText, bodyText);
+            throw new Error(`Token exchange failed: ${response2.status} ${response2.statusText}`);
+          }
+          const tokens = await response2.json();
+          return {
+            idToken: tokens.id_token,
+            accessToken: tokens.access_token,
+            refreshToken: tokens.refresh_token,
+            customToken: tokens.custom_token,
+            expiresAt: Date.now() + tokens.expires_in * 1e3
+          };
+        } catch (error2) {
+          console.error("Token exchange request error:", error2);
+          throw error2;
         }
-        const tokens = await response2.json();
-        return {
-          idToken: tokens.id_token,
-          accessToken: tokens.access_token,
-          refreshToken: tokens.refresh_token,
-          customToken: tokens.custom_token,
-          expiresAt: Date.now() + tokens.expires_in * 1e3
-        };
       }
       /**
        * Revoke tokens on server