@bonginkan/maria 4.3.32 → 4.3.34

package/README.md

@@ -1,4 +1,4 @@
-# MARIA - AI Development Platform v4.3.32
+# MARIA - AI Development Platform v4.3.34
 
 [![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.32 (September 16, 2025)
+## 🚀 What's New in v4.3.34 (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.32
+npm install -g @bonginkan/maria@4.3.34
 
 # 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.32`
+**Transform your development experience today**: `npm install -g @bonginkan/maria@4.3.34`
 
 🌐 **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-09-28T09:23:52.572Z",
+  "generatedAt": "2025-10-01T05:35:40.844Z",
   "totalCommands": 16,
   "readyCount": 16,
   "partialCount": 0,

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.32",
-      description: "\u{1F680} MARIA v4.3.32 - 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.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.",
       keywords: [
         "ai",
         "cli",
@@ -26503,7 +26503,7 @@ var require_package = __commonJS({
         react: "^18.2.0",
         "reflect-metadata": "^0.2.2",
         semver: "^7.7.2",
-        sharp: "^0.34.3",
+        sharp: "^0.34.4",
         "string-width": "^8.0.0",
         "strip-ansi": "^7.1.0",
         "tesseract.js": "^6.0.1",
@@ -27781,25 +27781,29 @@ var init_AuthSecretManager = __esm({
       constructor() {
         this.projectId = process.env.GCLOUD_PROJECT || "maria-code-470602";
         this.useGsm = this.shouldUseGsm();
-        if (this.useGsm) {
-          try {
-            this.client = new secretManager.SecretManagerServiceClient();
-          } catch {
-            this.client = null;
-          }
-        }
+        this.client = null;
       }
       /**
        * Determine whether to use Google Secret Manager in this environment
        */
       shouldUseGsm() {
         if (process.env.MARIA_DISABLE_GSM === "true") return false;
+        if (process.env.MARIA_CLI_USE_GSM === "true") return true;
         if (process.env.GOOGLE_APPLICATION_CREDENTIALS) return true;
-        if (process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT) return true;
-        if (process.env.CLOUD_RUN_SERVICE || process.env.K_SERVICE) return true;
-        if (process.env.GCE_METADATA_HOST) return true;
+        if (process.env.CLOUD_RUN_SERVICE || process.env.K_SERVICE || process.env.GCE_METADATA_HOST) return true;
         return false;
       }
+      /** Lazily create Secret Manager client only when permitted */
+      ensureClient() {
+        if (!this.useGsm) return null;
+        if (this.client) return this.client;
+        try {
+          this.client = new secretManager.SecretManagerServiceClient();
+        } catch {
+          this.client = null;
+        }
+        return this.client;
+      }
       /**
        * Get authentication configuration from Secret Manager
        */
@@ -27819,7 +27823,8 @@ var init_AuthSecretManager = __esm({
        * Get a specific secret from Secret Manager
        */
       async getSecret(secretName) {
-        if (!this.useGsm || !this.client) {
+        const client = this.ensureClient();
+        if (!this.useGsm || !client) {
           return null;
         }
         const cached2 = this.getCachedSecret(secretName);
@@ -27828,7 +27833,7 @@ var init_AuthSecretManager = __esm({
         }
         try {
           const name2 = `projects/${this.projectId}/secrets/${secretName}/versions/latest`;
-          const [version] = await this.client.accessSecretVersion({ name: name2 });
+          const [version] = await client.accessSecretVersion({ name: name2 });
           const payload = version.payload?.data;
           if (!payload) {
             return null;
@@ -28099,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.32"}`
+              "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.34"}`
             }
           });
           if (response.status === 401) {
@@ -28731,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.32"}`,
+    "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.34"}`,
     "Content-Type": init3.headers?.["Content-Type"] || "application/json"
   });
   const doFetch = async (token) => {
@@ -37153,6 +37158,13 @@ var init_logging = __esm({
     _loggingMiddleware = new LoggingMiddleware();
   }
 });
+
+// src/services/telemetry/bigquery-telemetry.ts
+var bigquery_telemetry_exports = {};
+__export(bigquery_telemetry_exports, {
+  BigQueryTelemetryService: () => BigQueryTelemetryService,
+  bigQueryTelemetry: () => bigQueryTelemetry
+});
 async function loadBigQuery() {
   if (bigQueryLoadAttempted) return BigQuery;
   bigQueryLoadAttempted = true;
@@ -37218,7 +37230,7 @@ var init_bigquery_telemetry = __esm({
       };
       constructor() {
         super();
-        this.isEnabled = process.env.TELEMETRY_DISABLED !== "true";
+        this.isEnabled = process.env.TELEMETRY_ENABLED === "true";
         this.httpEndpoint = process.env.TELEMETRY_ENDPOINT || null;
         if (this.isEnabled) {
           this.initialize().catch((error2) => {
@@ -37562,8 +37574,12 @@ async function getUserContext() {
 }
 async function trackCommand(data) {
   try {
+    if (process.env.TELEMETRY_DISABLED === "true") {
+      return;
+    }
     const userContext = await getUserContext();
-    await bigQueryTelemetry.trackCommandExecution({
+    const { bigQueryTelemetry: bigQueryTelemetry2 } = await Promise.resolve().then(() => (init_bigquery_telemetry(), bigquery_telemetry_exports));
+    await bigQueryTelemetry2.trackCommandExecution({
       cmd: data.cmd,
       status: data.status,
       latencyMs: data.latencyMs,
@@ -37604,7 +37620,6 @@ function getNextMonthStart() {
 }
 var init_telemetry_helper = __esm({
   "src/slash-commands/shared/telemetry-helper.ts"() {
-    init_bigquery_telemetry();
   }
 });
 
@@ -37756,6 +37771,7 @@ var init_ReadyCommandsService = __esm({
       lastLoaded = null;
       manifestPath;
       usedFallback = false;
+      helpMeta = {};
       constructor(manifestPath) {
         if (manifestPath) {
           this.manifestPath = manifestPath;
@@ -37839,14 +37855,57 @@ var init_ReadyCommandsService = __esm({
           this.buildLookupMaps();
           this.lastLoaded = /* @__PURE__ */ new Date();
           this.usedFallback = false;
+          await this.tryLoadHelpMeta();
         } catch (error2) {
           logger.debug("READY manifest not found or invalid; using fallback");
           this.readyCommands = this.getFallbackCommands();
           this.buildLookupMaps();
           this.lastLoaded = /* @__PURE__ */ new Date();
           this.usedFallback = true;
+          await this.tryLoadHelpMeta();
+        }
+      }
+      /**
+       * Load enhanced help metadata (e.g., arguments/examples) if available
+       */
+      async tryLoadHelpMeta() {
+        try {
+          const candidates = [
+            path11__namespace.join(process.cwd(), "src/slash-commands/help/command-meta.json"),
+            path11__namespace.join(__dirname, "../../slash-commands/help/command-meta.json"),
+            path11__namespace.join(process.cwd(), "dist/command-meta.json")
+          ];
+          let p = null;
+          for (const c of candidates) {
+            try {
+              await fsp__namespace.access(c);
+              p = c;
+              break;
+            } catch {
+            }
+          }
+          if (!p) return;
+          const raw = await fsp__namespace.readFile(p, "utf8");
+          const json = JSON.parse(raw);
+          const map = {};
+          const arr = Array.isArray(json?.commands) ? json.commands : [];
+          for (const entry of arr) {
+            const name2 = typeof entry?.name === "string" ? entry.name : void 0;
+            if (!name2) continue;
+            const norm = name2.replace(/^\//, "");
+            const title = typeof entry?.title === "string" ? entry.title : void 0;
+            const examples = Array.isArray(entry?.examples) ? entry.examples.filter((e2) => typeof e2 === "string") : void 0;
+            map[norm] = { title, examples };
+          }
+          this.helpMeta = map;
+        } catch {
         }
       }
+      /** Get enhanced help meta for a command if available */
+      getHelpMeta(commandName) {
+        const key = commandName.replace(/^\//, "");
+        return this.helpMeta[key];
+      }
       /**
        * Convert object-format commands to ReadyCommand array
        */
@@ -47395,7 +47454,8 @@ function normalizeImageArgs(raw, root) {
   const out = {
     prompt,
     size: [1024, 1024],
-    format: "webp",
+    // Default to png to avoid surprise webp outputs when converters are unavailable
+    format: "png",
     count: 1,
     concurrency: 2,
     retry: 2,
@@ -47414,10 +47474,13 @@ function normalizeImageArgs(raw, root) {
       case "size":
         out.size = parseSize(String(v));
         break;
-      case "format":
-        if (!["png", "webp", "jpg"].includes(String(v))) throw new Error("invalid format");
-        out.format = v;
+      case "format": {
+        const rawFmt = String(v).toLowerCase();
+        const mapped = rawFmt === "jpeg" ? "jpg" : rawFmt;
+        if (!["png", "webp", "jpg"].includes(mapped)) throw new Error("invalid format");
+        out.format = mapped;
         break;
+      }
       case "count": {
         const n = Number(v);
         if (!Number.isFinite(n) || n < 1) throw new Error("invalid count");
@@ -47790,6 +47853,14 @@ var init_gemini_media = __esm({
       async generateImage(req) {
         const modelName = this.primaryModel;
         const promptPreview = String(req.prompt ?? "").replace(/\s+/g, " ").slice(0, 200);
+        const targetMime = (() => {
+          const fmt = (req.format || "png").toLowerCase();
+          if (fmt === "jpg") return "image/jpeg";
+          if (fmt === "jpeg") return "image/jpeg";
+          if (fmt === "png") return "image/png";
+          if (fmt === "webp") return "image/webp";
+          return "image/png";
+        })();
         let resp;
         try {
           resp = await this.ai.models.generateContent({
@@ -47797,7 +47868,7 @@ var init_gemini_media = __esm({
             contents: [{ role: "user", parts: [{ text: String(req.prompt) }] }],
             generationConfig: {
               responseModalities: ["IMAGE"],
-              responseMimeType: `image/${req.format || "png"}`
+              responseMimeType: targetMime
             }
           });
         } catch (err) {
@@ -47819,7 +47890,7 @@ var init_gemini_media = __esm({
           const mime = p?.inlineData?.mimeType || p?.inline_data?.mime_type || p?.inline_data?.mimeType || p?.inlineData?.mime_type;
           if (data) {
             const buf = Buffer.from(String(data), "base64");
-            if (buf.length > 0) return { bytes: buf, mime: typeof mime === "string" ? mime : `image/${req.format}` };
+            if (buf.length > 0) return { bytes: buf, mime: typeof mime === "string" ? mime : targetMime };
           }
         }
         try {
@@ -47832,7 +47903,7 @@ var init_gemini_media = __esm({
           const bytesB64 = img0?.imageBytes || img0?.bytesBase64Encoded;
           if (bytesB64) {
             const buf = Buffer.from(String(bytesB64), "base64");
-            if (buf.length > 0) return { bytes: buf, mime: `image/${req.format || "png"}` };
+            if (buf.length > 0) return { bytes: buf, mime: targetMime };
           }
         } catch {
         }
@@ -47885,12 +47956,15 @@ var init_Progress = __esm({
 });
 
 // src/services/media-orchestrator/image-post.ts
-async function processImageOptional(bytes, format, keepExif) {
+async function processImageOptional(bytes, format, keepExif, targetSize) {
   try {
-    const useSharp = String(process.env.MARIA_SHARP || "").toLowerCase() === "true" || process.env.MARIA_SHARP === "1";
-    if (!useSharp) return bytes;
     const sharp = (await import('sharp')).default;
     let img = sharp(bytes).toColourspace("srgb");
+    if (targetSize && Number.isFinite(targetSize.width) && Number.isFinite(targetSize.height)) {
+      const width = Math.max(1, Math.floor(targetSize.width));
+      const height = Math.max(1, Math.floor(targetSize.height));
+      img = img.resize(width, height, { fit: "cover" });
+    }
     if (keepExif) img = img.withMetadata();
     const qEnv = Number(process.env.MARIA_SHARP_QUALITY || "80");
     const quality = Number.isFinite(qEnv) ? Math.max(1, Math.min(100, Math.floor(qEnv))) : 80;
@@ -47945,7 +48019,12 @@ async function runImagePipeline(params2, opts) {
           keepExif: params2.keepExif
         });
       }, retryOpts));
-      const processed = await processImageOptional(result.bytes, params2.format, params2.keepExif);
+      const processed = await processImageOptional(
+        result.bytes,
+        params2.format,
+        params2.keepExif,
+        { width: params2.size[0], height: params2.size[1] }
+      );
       successes[i2] = processed;
       totalAttempts += attempts;
       totalRetries += Math.max(0, attempts - 1);
@@ -49669,6 +49748,19 @@ var init_WhoAmICommand = __esm({
         if (user.plan) {
           lines.push(chalk14__default.default.white(`\u{1F48E} Plan: ${chalk14__default.default.cyan(user.plan)}`));
         }
+        try {
+          const { cliAuth: cliAuth2 } = await Promise.resolve().then(() => (init_CLIAuthService(), CLIAuthService_exports));
+          const api = cliAuth2.getAPIClient();
+          const usage = await api.getUsage();
+          lines.push("");
+          lines.push(chalk14__default.default.cyan("\u{1F4CA} Usage"));
+          lines.push(chalk14__default.default.gray("\u2500".repeat(30)));
+          lines.push(chalk14__default.default.white(`Requests: ${usage.used.req}/${usage.limits.req} (${usage.percentage.req}%)`));
+          lines.push(chalk14__default.default.white(`Tokens:   ${usage.used.tokens}/${usage.limits.tokens} (${usage.percentage.tokens}%)`));
+          lines.push(chalk14__default.default.white(`Commands: ${usage.used.code}/${usage.limits.code} (${usage.percentage.code}%)`));
+          lines.push(chalk14__default.default.white(`Reset at: ${new Date(usage.resetAt).toLocaleString()}`));
+        } catch {
+        }
         return this.success(lines.join("\n"), { authenticated: true, user });
       }
     };
@@ -50689,7 +50781,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.32"));
+        output3.push(chalk14__default.default.cyan.bold("\u{1F916} About MARIA v4.3.34"));
         output3.push(chalk14__default.default.gray("\u2550".repeat(40)));
         output3.push("");
         output3.push(chalk14__default.default.white.bold("MARIA - Minimal API, Maximum Power"));
@@ -70893,7 +70985,7 @@ ${files.slice(0, 20).map((f3) => `- ${f3.path}`).join("\n")}`);
         const bundle = parts.join("\n\n");
         const system = [
           "You are an impartial evaluator. Score each criterion between 0 and 1.",
-          "If a local file path is provided, make sure you read the uploaded file before taking any actions.",
+          "If a local file path is provided, make sure you read the uploaded file before taking any actions. Write the string content in plain text and do not use markdown.",
           "Return JSON only in the following schema:",
           '{ "totalScore": number (0..1), "details": [{ "id": string, "score": number (0..1), "reason": string }] }',
           "Keep reasons short (<= 120 chars)."
@@ -71230,7 +71322,8 @@ var init_evaluate_command = __esm({
           // Strong guard: attachments are uploaded; do not ask for local file content
           "The input files are already uploaded and referenced via file URIs.",
           "Use the provided attachments; do not ask the user to paste file contents.",
-          "Do not claim you cannot access local file paths."
+          "Do not claim you cannot access local file paths.",
+          "Write the string content in plain text and do not use markdown."
         ].join("\n");
         if (result === null) {
           const rel = path11__namespace.default.relative(root, criteriaPath);
@@ -71284,6 +71377,12 @@ ${options["code"] || inferred.code}` : void 0
           const content = (response?.data?.content || response?.output || "").trim();
           const uploads = response?.data?.uploads || [];
           if (content) {
+            try {
+              const { cliAuth: cliAuth2 } = await Promise.resolve().then(() => (init_CLIAuthService(), CLIAuthService_exports));
+              const api = cliAuth2.getAPIClient();
+              await api.consumeQuota({ requests: 1, code: 1 });
+            } catch {
+            }
             const uploadNote = uploads.length ? `Attached ${uploads.length} file(s) uploaded and referenced.` : attachments.length ? `Attached ${attachments.length} local file(s).` : void 0;
             const finalText = uploadNote ? `${uploadNote}
 
@@ -71329,6 +71428,12 @@ ${content}` : content;
         });
         const testResult = await this.executeEvaluation(config2);
         const formattedOutput = this.formatEvaluationStart(testResult);
+        try {
+          const { cliAuth: cliAuth2 } = await Promise.resolve().then(() => (init_CLIAuthService(), CLIAuthService_exports));
+          const api = cliAuth2.getAPIClient();
+          await api.consumeQuota({ requests: 1, code: 1 });
+        } catch {
+        }
         return this.success(formattedOutput, {
           testId: testResult.testId,
           status: testResult.status,
@@ -72326,7 +72431,7 @@ var init_slash_commands = __esm({
 });
 async function handleSlash(input3) {
   if (!input3.startsWith("/")) return false;
-  const { cmd, args: args2, flags } = parseSlash(input3);
+  const { cmd, args: args2, options, flags } = parseSlash(input3);
   if (cmd === "clear" || cmd === "cls") {
     try {
       clearTerminal();
@@ -72343,8 +72448,13 @@ async function handleSlash(input3) {
   }
   try {
     if (commandRegistry.has(cmd)) {
-      const flagsObj = {};
-      flags.forEach((f3) => flagsObj[f3] = true);
+      const optionTokens = [];
+      for (const [k, v] of Object.entries(options)) {
+        optionTokens.push(`--${k}`);
+        optionTokens.push(String(v));
+      }
+      const flagTokens = flags.map((f3) => `--${f3}`);
+      const argv = [...args2, ...optionTokens, ...flagTokens];
       let currentUser = void 0;
       try {
         if (await authManager.isAuthenticated()) {
@@ -72357,7 +72467,7 @@ async function handleSlash(input3) {
         user: currentUser,
         environment: { cwd: process.cwd() }
       };
-      const result = await commandRegistry.execute(cmd, args2, ctx2);
+      const result = await commandRegistry.execute(cmd, argv, ctx2);
       if (typeof result?.message === "string" && result.message.trim()) {
         console.log(result.message);
       }
@@ -74386,7 +74496,7 @@ var init_ai_response_service = __esm({
        */
       async callLLM(prompt, opts = {}) {
         const {
-          system = PLAIN_OUTPUT ? "Return ONLY the answer (or ONLY code). No menus, no lists, no guided flows. Always respond in English." : "You are a helpful senior engineer named Maria. Always respond in English. Provide direct, production-quality answers. Make sure you answer in plain text, as a natural chat.",
+          system = PLAIN_OUTPUT ? "Return ONLY the answer (or ONLY code). No menus, no lists, no guided flows. Always respond in English." : "You are a helpful senior engineer named Maria. Always respond in English. Provide direct, production-quality answers. Make sure you answer in plain text, as a natural chat. When asked about the model (not your name or who you are, but the model), say you are a large language model fully trained by Bonginkan.",
           model = void 0,
           provider = DEFAULT_PROVIDER2,
           temperature = 0.2,
@@ -76040,6 +76150,9 @@ var init_cli = __esm({
     session = [];
     commandManager = null;
     startupDisplayed = false;
+    if (!process.env.GOOGLE_AUTH_DISABLE_GCE_CHECK) {
+      process.env.GOOGLE_AUTH_DISABLE_GCE_CHECK = "true";
+    }
     program = createCLI();
     program.parse(process.argv);
   }