@bonginkan/maria 4.3.34 → 4.3.35

package/README.md

@@ -1,4 +1,4 @@
-# MARIA - AI Development Platform v4.3.34
+# MARIA - AI Development Platform v4.3.35
 
 [![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.3.34 (September 29, 2025)
+## 🚀 What's New in v4.3.35 (September 29, 2025)
 
 ### 🎯 Interactive Improvements & Choice Memory
 - **Choice Memory System**: Smart persistence of user selections across sessions
@@ -922,7 +922,7 @@ await secureWorkflow.executeWithAuth(workflowDefinition, securityContext);
 ### Quick Installation
 ```bash
 # Install globally (recommended)
-npm install -g @bonginkan/maria@4.3.34
+npm install -g @bonginkan/maria@4.3.35
 
 # Verify installation
 maria --version  # Should show v4.3.9
@@ -1126,7 +1126,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.3.34`
+**Transform your development experience today**: `npm install -g @bonginkan/maria@4.3.35`
 
 🌐 **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": "lite-1.0.0",
-  "generatedAt": "2025-10-01T05:35:40.844Z",
+  "generatedAt": "2025-10-01T07:40:48.664Z",
   "totalCommands": 16,
   "readyCount": 16,
   "partialCount": 0,
@@ -11,112 +11,128 @@
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Show command help and documentation"
+      "description": "Show command help and documentation",
+      "usage": "/help [command] [--category <category>] [--search <term>] [--quickstart] [--stats]"
     },
     "core/version": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Show version information"
+      "description": "Show version information",
+      "usage": "/version"
     },
     "core/exit": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Exit MARIA CLI"
+      "description": "Exit MARIA CLI",
+      "usage": "/exit"
     },
     "core/update": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Incremental codebase updates; refresh MARIA.md with latest changes"
+      "description": "Incremental codebase updates; refresh MARIA.md with latest changes",
+      "usage": "/update"
     },
     "conversation/clear": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Clear conversation history"
+      "description": "Clear conversation history",
+      "usage": "/clear"
     },
     "system/status": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "System health information"
+      "description": "System health information",
+      "usage": "/status"
     },
     "system/doctor": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "System diagnostics"
+      "description": "System diagnostics",
+      "usage": "/doctor"
     },
     "auth/whoami": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Show current authenticated user information"
+      "description": "Show current authenticated user information",
+      "usage": "/whoami"
     },
     "configuration/setup": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "First-time setup wizard"
+      "description": "First-time setup wizard",
+      "usage": "/setup"
     },
     "configuration/init": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Initialize project guidance and generate MARIA.md at repo root"
+      "description": "Initialize project guidance and generate MARIA.md at repo root",
+      "usage": "/init"
     },
     "code/code": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Generate code with AI assistance"
+      "description": "Generate code with AI assistance",
+      "usage": "/code [options]"
     },
     "memory/recall": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Retrieve stored memories"
+      "description": "Retrieve stored memories",
+      "usage": "/recall [options]"
     },
     "memory/memory-status": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Show memory usage statistics and health"
+      "description": "Show memory usage statistics and health",
+      "usage": "/memory-status"
     },
     "multimodal/image": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Generate images with AI"
+      "description": "Generate images with AI",
+      "usage": "/image \"prompt\" [--size 1024x1024] [--format webp|png|jpg] [--count 1..8] [--model gemini-...] [--seed N] [--out dir] [--apply|--plan-only|--dry-run] [--concurrency N] [--retry N]"
     },
     "multimodal/video": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Generate videos with AI"
+      "description": "Generate videos with AI",
+      "usage": "/video \"prompt\" [options]"
     },
     "workflow/resume": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Resume previous task context and propose next /code step"
+      "description": "Resume previous task context and propose next /code step",
+      "usage": "/workflow/resume [options]"
     }
   }
 }

package/dist/bin/maria.cjs

@@ -26066,8 +26066,8 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@bonginkan/maria",
-      version: "4.3.34",
-      description: "\u{1F680} MARIA v4.3.34 - Enterprise AI Development Platform with identity system and character voice implementation. 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.3.35",
+      description: "\u{1F680} MARIA v4.3.35 - Enterprise AI Development Platform with identity system and character voice implementation. 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",
@@ -28104,7 +28104,7 @@ var init_AuthenticationManager = __esm({
           const response = await fetch(`${this.apiBase}/api/user/profile`, {
             headers: {
               "Authorization": `Bearer ${tokens2.accessToken}`,
-              "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.34"}`
+              "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.35"}`
             }
           });
           if (response.status === 401) {
@@ -28736,7 +28736,7 @@ async function callApi(path64, init3 = {}) {
     "Authorization": `Bearer ${token}`,
     "X-Device-Id": getDeviceId(),
     "X-Session-Id": getSessionId() || "",
-    "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.34"}`,
+    "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.35"}`,
     "Content-Type": init3.headers?.["Content-Type"] || "application/json"
   });
   const doFetch = async (token) => {
@@ -37921,8 +37921,10 @@ var init_ReadyCommandsService = __esm({
               category,
               aliases: [],
               description: cmd.description || descriptions[commandName] || "No description available",
-              usage: `/${commandName} [options]`,
-              examples: [`/${commandName}`],
+              usage: typeof cmd.usage === "string" ? cmd.usage : `/${commandName} [options]`,
+              examples: Array.isArray(cmd.examples) ? cmd.examples : [`/${commandName}`],
+              // flags is optional; keep it if present to power /help details
+              ...cmd.flags && typeof cmd.flags === "object" ? { flags: cmd.flags } : {},
               status: "READY" /* READY */,
               contract: {
                 tty: true,
@@ -38429,40 +38431,30 @@ var init_HelpCommand = __esm({
       examples = [
         {
           input: "/help",
-          _description: "Show READY commands with GPU labels",
+          description: "Show READY commands with GPU labels",
           output: "Contract-validated commands with performance info"
         },
         {
           input: "/help code",
-          _description: "Show detailed help for specific command",
+          description: "Show detailed help for specific command",
           output: "Usage, examples, and contract info for /code"
         },
         {
           input: "/help --category ai",
-          _description: "Show all READY commands in AI category",
+          description: "Show all READY commands in AI category",
           output: "List of AI READY commands with GPU labels"
         },
         {
           input: '/help --search "config"',
-          _description: "Search READY commands for configuration",
+          description: "Search READY commands for configuration",
           output: 'READY commands matching "config" with match scores'
-        },
-        {
-          input: "/help --stats",
-          _description: "Show READY command statistics",
-          output: "Performance stats and command counts"
-        },
-        {
-          input: "/help --quickstart",
-          _description: "Show essential commands for getting started",
-          output: "Most important READY commands for new users"
         }
       ];
       async execute(args2, context2) {
         const startTime = Date.now();
         try {
           const { parsed, options } = args2;
-          const _positional = parsed["_positional"] || [];
+          const _positional = parsed["positional"] || parsed["_positional"] || [];
           if (options && options["stats"]) {
             const result2 = await this.showStatistics();
             await this.trackSuccess(startTime, context2);
@@ -38487,7 +38479,9 @@ var init_HelpCommand = __esm({
             return result2;
           }
           if (options && options["search"]) {
-            const result2 = await this.searchCommands(options["search"]);
+            const proxy = (process.env.HELP_SEARCH_PROXY ?? "1").toLowerCase();
+            const shouldProxy = proxy !== "0" && proxy !== "false";
+            const result2 = shouldProxy ? await this.showGeneralHelp() : await this.searchCommands(options["search"]);
             await this.trackSuccess(startTime, context2);
             return result2;
           }
@@ -38499,7 +38493,7 @@ var init_HelpCommand = __esm({
             cmd: "help",
             status: "error",
             latencyMs: Date.now() - startTime,
-            plan: getUserPlan(),
+            plan: await getUserPlan(),
             quotaLeft: context2.quotaLeft || 999
           });
           return this.error(
@@ -38517,7 +38511,7 @@ var init_HelpCommand = __esm({
           cmd: "help",
           status: "success",
           latencyMs: Date.now() - startTime,
-          plan: getUserPlan(),
+          plan: await getUserPlan(),
           quotaLeft: context2.quotaLeft || 999
         });
       }
@@ -38547,9 +38541,6 @@ var init_HelpCommand = __esm({
         lines.push("");
         lines.push(chalk14__default.default.bold("Quick Access:"));
         lines.push("  /help <command>      - Detailed help for specific command");
-        lines.push("  /help --quickstart   - Essential commands for new users");
-        lines.push("  /help --stats        - Performance statistics");
-        lines.push("  /help --search <term> - Search with fuzzy matching");
         lines.push("");
         let globalMaxNameLength = 0;
         for (const category of categories2) {
@@ -38671,49 +38662,50 @@ var init_HelpCommand = __esm({
             }
           );
         }
-        const lines = this.formatCommandHelp(command);
+        const lines = this.formatMinimalUsage(command);
         return this.success(lines);
       }
       /**
        * Format detailed help for a command
        */
-      formatCommandHelp(command) {
+      formatMinimalUsage(command) {
         const lines = [];
+        lines.push(`Usage: ${command.usage}`);
         lines.push("");
-        lines.push(`\u{1F4D6} ${chalk14__default.default.bold(`/${command.name}`)} - ${command.description}`);
-        lines.push("\u2550".repeat(50));
-        lines.push("");
-        lines.push(chalk14__default.default.bold("\u2139\uFE0F Information:"));
-        lines.push(`  Category: ${this.readyService["getCategoryEmoji"](command.category)} ${command.category}`);
-        lines.push(`  Status: \u2705 READY (contract validated)`);
-        if (command.aliases && command.aliases.length > 0) {
-          lines.push(`  Aliases: ${command.aliases.map((a) => `/${a}`).join(", ")}`);
+        const flags = command.flags;
+        const effective = flags && Object.keys(flags).length > 0 ? flags : this.extractFlagsFromUsage(command.usage);
+        if (effective && Object.keys(effective).length > 0) {
+          lines.push("Flags:");
+          const entries = Object.entries(effective).sort(([a], [b]) => a.localeCompare(b));
+          for (const [k, v] of entries) {
+            const hint = v ? ` ${v}` : "";
+            lines.push(`  --${k}${hint}`);
+          }
         }
-        lines.push("");
-        lines.push(chalk14__default.default.bold("\u{1F3AF} Usage:"));
-        lines.push(`  ${command.usage}`);
-        lines.push("");
-        lines.push(chalk14__default.default.bold("\u{1F4CB} Contract Validation:"));
-        lines.push(`  \u26A1 Performance: ${command.contract.maxResponseTime}ms (tested)`);
-        lines.push(`  \u{1F4BB} TTY Mode: ${command.contract.tty ? "\u2705 Supported" : "\u274C Not supported"}`);
-        lines.push(`  \u{1F527} Non-TTY Mode: ${command.contract.nonTty ? "\u2705 Supported" : "\u274C Not supported"}`);
-        lines.push(`  \u{1F500} Pipe Mode: ${command.contract.pipe ? "\u2705 Supported" : "\u274C Not supported"}`);
-        lines.push("");
-        if (command.examples && command.examples.length > 0) {
-          lines.push(chalk14__default.default.bold("\u{1F4DD} Examples:"));
-          for (const example of command.examples) {
-            lines.push(`  ${example}`);
+        return lines.join("\n");
+      }
+      extractFlagsFromUsage(usage) {
+        if (!usage || typeof usage !== "string") return void 0;
+        const out = {};
+        const pattern = /--([a-zA-Z0-9][a-zA-Z0-9\-]*)\s*([^\]\s][^\]]*)?/g;
+        const blocks = usage.match(/\[[^\]]+\]/g) || [];
+        for (const b of blocks) {
+          let m3;
+          pattern.lastIndex = 0;
+          while ((m3 = pattern.exec(b)) !== null) {
+            const key = m3[1];
+            const hint = (m3[2] || "").trim();
+            out[key] = hint;
           }
-          lines.push("");
         }
-        lines.push(chalk14__default.default.bold("\u{1F4A1} Quick Tips:"));
-        lines.push(`  \u2022 This command is production-ready and fully tested`);
-        lines.push(`  \u2022 Try /${command.name} --help for additional options`);
-        if (command.category !== "core") {
-          lines.push(`  \u2022 See more ${command.category} commands: /help --category ${command.category}`);
+        let m2;
+        pattern.lastIndex = 0;
+        while ((m2 = pattern.exec(usage)) !== null) {
+          const key = m2[1];
+          const hint = (m2[2] || "").trim();
+          if (!(key in out)) out[key] = hint;
         }
-        lines.push("");
-        return lines.join("\n");
+        return Object.keys(out).length ? out : void 0;
       }
       /**
        * Show category help
@@ -38847,8 +38839,6 @@ var init_HelpCommand = __esm({
         }
         lines.push("");
         lines.push(chalk14__default.default.bold("\u{1F4A1} Next Steps:"));
-        lines.push("  \u2022 /help --category <name> - Explore command categories");
-        lines.push("  \u2022 /help --search <term> - Find specific functionality");
         lines.push("  \u2022 /help <command> - Get detailed command help");
         lines.push("");
         return this.success(lines.join("\n"));
@@ -38902,9 +38892,7 @@ var init_HelpCommand = __esm({
         "/help",
         "/help code",
         "/help --category ai",
-        "/help --search config",
-        "/help --quickstart",
-        "/help --stats"
+        "/help --search config"
       ],
       deps: []
     };
@@ -50781,7 +50769,7 @@ var init_about_command = __esm({
       async execute(args2, context2) {
         const output3 = [];
         output3.push("");
-        output3.push(chalk14__default.default.cyan.bold("\u{1F916} About MARIA v4.3.34"));
+        output3.push(chalk14__default.default.cyan.bold("\u{1F916} About MARIA v4.3.35"));
         output3.push(chalk14__default.default.gray("\u2550".repeat(40)));
         output3.push("");
         output3.push(chalk14__default.default.white.bold("MARIA - Minimal API, Maximum Power"));