@bonginkan/maria 4.3.34 → 4.3.35

package/dist/cli.cjs

@@ -1709,7 +1709,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) {
@@ -2412,7 +2412,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) => {
@@ -12237,8 +12237,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,
@@ -12745,40 +12747,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);
@@ -12803,7 +12795,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;
           }
@@ -12815,7 +12809,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(
@@ -12833,7 +12827,7 @@ var init_HelpCommand = __esm({
           cmd: "help",
           status: "success",
           latencyMs: Date.now() - startTime,
-          plan: getUserPlan(),
+          plan: await getUserPlan(),
           quotaLeft: context2.quotaLeft || 999
         });
       }
@@ -12863,9 +12857,6 @@ var init_HelpCommand = __esm({
         lines.push("");
         lines.push(chalk40__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) {
@@ -12987,49 +12978,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} ${chalk40__default.default.bold(`/${command.name}`)} - ${command.description}`);
-        lines.push("\u2550".repeat(50));
-        lines.push("");
-        lines.push(chalk40__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(chalk40__default.default.bold("\u{1F3AF} Usage:"));
-        lines.push(`  ${command.usage}`);
-        lines.push("");
-        lines.push(chalk40__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(chalk40__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(chalk40__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
@@ -13163,8 +13155,6 @@ var init_HelpCommand = __esm({
         }
         lines.push("");
         lines.push(chalk40__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"));
@@ -13218,9 +13208,7 @@ var init_HelpCommand = __esm({
         "/help",
         "/help code",
         "/help --category ai",
-        "/help --search config",
-        "/help --quickstart",
-        "/help --stats"
+        "/help --search config"
       ],
       deps: []
     };
@@ -16180,8 +16168,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",
@@ -25909,7 +25897,7 @@ var init_about_command = __esm({
       async execute(args2, context2) {
         const output3 = [];
         output3.push("");
-        output3.push(chalk40__default.default.cyan.bold("\u{1F916} About MARIA v4.3.34"));
+        output3.push(chalk40__default.default.cyan.bold("\u{1F916} About MARIA v4.3.35"));
         output3.push(chalk40__default.default.gray("\u2550".repeat(40)));
         output3.push("");
         output3.push(chalk40__default.default.white.bold("MARIA - Minimal API, Maximum Power"));