@bonginkan/maria 4.3.27 → 4.3.29

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.27",
-      description: "\u{1F680} MARIA v4.3.27 - 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.29",
+      description: "\u{1F680} MARIA v4.3.29 - 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",
@@ -28099,7 +28099,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.27"}`
+              "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.29"}`
             }
           });
           if (response.status === 401) {
@@ -28731,7 +28731,7 @@ async function callApi(path60, init3 = {}) {
     "Authorization": `Bearer ${token}`,
     "X-Device-Id": getDeviceId(),
     "X-Session-Id": getSessionId() || "",
-    "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.27"}`,
+    "User-Agent": `maria-cli/${process.env.CLI_VERSION || "4.3.29"}`,
     "Content-Type": init3.headers?.["Content-Type"] || "application/json"
   });
   const doFetch = async (token) => {
@@ -44443,7 +44443,7 @@ async function applyPlans(plans, opts) {
   try {
     for (const plan of plans) {
       if (opts.signal?.aborted) throw abortErr();
-      const target = path11__namespace.default.join(opts.root, plan.path);
+      const target = plan.absPath ? plan.absPath : path11__namespace.default.join(opts.root, plan.path);
       const dir = path11__namespace.default.dirname(target);
       await fs21.promises.mkdir(dir, { recursive: true });
       const exists2 = await fileExists(target);
@@ -47985,8 +47985,19 @@ async function runImagePipeline(params2, opts) {
     metrics: { durationMs, retries: totalRetries, fallbacks: 0 },
     trace: Math.random().toString(36).slice(2, 8).toUpperCase()
   };
-  const items = successes.filter(Boolean).map((b) => ({ bytes: b, ext: `.${params2.format}` }));
-  const saved = await saveArtifacts({ root: opts.root, kind: "image", baseDir: opts.outDir, flat: true, skipManifest: true }, items, manifest);
+  const baseDir = opts.outDir && opts.outDir.length > 0 ? opts.outDir : "image";
+  const rawPrefix = (params2.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+  let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+  if (!promptPrefix) promptPrefix = "untitled";
+  if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+  const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const filtered = successes.filter(Boolean);
+  const items = filtered.map((b, i2) => ({
+    bytes: b,
+    ext: `.${params2.format}`,
+    logicalName: `${promptPrefix}-${utc}${filtered.length > 1 ? `-${String(i2 + 1).padStart(2, "0")}` : ""}`
+  }));
+  const saved = await saveArtifacts({ root: opts.root, kind: "image", baseDir, flat: true, skipManifest: true }, items, manifest);
   progress.done();
   return {
     saved,
@@ -48402,7 +48413,6 @@ var init_image_command = __esm({
           const spinner = new ProcessAnimation();
           spinner.start();
           try {
-            const useRemote = String(process.env.MARIA_USE_REMOTE_MEDIA || "").toLowerCase() === "1" && await authManager.isAuthenticated();
             if (useRemote) {
               try {
                 const body = {
@@ -48435,14 +48445,23 @@ var init_image_command = __esm({
                   const pathMod = await import('path');
                   const fsMod = await import('fs/promises');
                   const savedPaths = [];
+                  const baseDir = "image";
+                  const rawPrefix = (cli.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+                  let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+                  if (!promptPrefix) promptPrefix = "untitled";
+                  if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+                  const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+                  let idx = 0;
                   for (const f3 of filesInline) {
                     const original = String(f3.file || "").replace(/^[\\/]+/, "");
-                    const name2 = pathMod.basename(original);
-                    const full = pathMod.resolve(root, name2);
+                    const ext2 = pathMod.extname(original) || `.${cli.format}`;
+                    const name2 = `${promptPrefix}-${utc}${filesInline.length > 1 ? `-${String(++idx).padStart(2, "0")}` : ""}${ext2}`;
+                    const rel = pathMod.join(baseDir, name2);
+                    const full = pathMod.resolve(root, rel);
                     await fsMod.mkdir(pathMod.dirname(full), { recursive: true });
                     const buf = Buffer.from(String(f3.bytesBase64 || ""), "base64");
                     await fsMod.writeFile(full, buf);
-                    savedPaths.push(name2);
+                    savedPaths.push(rel.replace(/\\/g, "/"));
                   }
                   const { formatImageOutput: formatImageOutput3 } = await Promise.resolve().then(() => (init_cli_style(), cli_style_exports));
                   const output4 = await formatImageOutput3(root, {
@@ -48468,18 +48487,24 @@ var init_image_command = __esm({
                   const fsMod = await import('fs/promises');
                   const base = (process.env.MARIA_API_BASE || "https://api.maria-code.ai").replace(/\/$/, "");
                   const savedPaths = [];
+                  const baseDir = "image";
+                  const promptPrefix = (cli.prompt || "").slice(0, 20).replace(/\s+/g, "_").replace(/[^A-Za-z0-9_\-]/g, "_") || "untitled";
+                  const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+                  let idx = 0;
                   for (const relRaw of filesList) {
                     const originalRel = String(relRaw || "").replace(/^[\\/]+/, "");
                     const url2 = `${base}/${originalRel}`;
-                    const name2 = pathMod.basename(originalRel);
-                    const full = pathMod.resolve(root, name2);
+                    const ext2 = pathMod.extname(originalRel) || `.${cli.format}`;
+                    const name2 = `${promptPrefix}-${utc}${filesList.length > 1 ? `-${String(++idx).padStart(2, "0")}` : ""}${ext2}`;
+                    const rel = pathMod.join(baseDir, name2);
+                    const full = pathMod.resolve(root, rel);
                     await fsMod.mkdir(pathMod.dirname(full), { recursive: true });
                     const res2 = await fetch(url2);
                     if (!res2.ok) throw new Error(`Failed to download image: ${res2.status}`);
                     const arrayBuf = await res2.arrayBuffer();
                     const buf = Buffer.from(arrayBuf);
                     await fsMod.writeFile(full, buf);
-                    savedPaths.push(name2);
+                    savedPaths.push(rel.replace(/\\/g, "/"));
                   }
                   const { formatImageOutput: formatImageOutput3 } = await Promise.resolve().then(() => (init_cli_style(), cli_style_exports));
                   const output4 = await formatImageOutput3(root, {
@@ -48735,8 +48760,17 @@ async function runVideoPipeline(params2, opts) {
         metrics: { durationMs: Date.now() - started, retries: 0, fallbacks: 0 },
         trace: Math.random().toString(36).slice(2, 8).toUpperCase()
       };
-      const baseDir = opts.outDir || path11__namespace.join("artifacts", "media", "videos", String(manifest2.trace));
-      const saved2 = await saveArtifacts({ root: opts.root, kind: "video", baseDir, flat: true }, [{ bytes, ext: ext2 }], manifest2);
+      const baseDir = opts.outDir && opts.outDir.length > 0 ? opts.outDir : "video";
+      const rawPrefix = (params2.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+      let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:\"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+      if (!promptPrefix) promptPrefix = "untitled";
+      if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+      const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+      const saved2 = await saveArtifacts(
+        { root: opts.root, kind: "video", baseDir, flat: true },
+        [{ bytes, ext: ext2, logicalName: `${promptPrefix}-${utc}` }],
+        manifest2
+      );
       return { saved: saved2, durationMs: Date.now() - started, frames: 0, warnFallback: false, retries: 0 };
     }
   } catch {
@@ -48782,14 +48816,28 @@ async function runVideoPipeline(params2, opts) {
     }
     const outBuf = await muxFramesToMp4(tmpDir, params2.fps);
     {
-      const baseDir = opts.outDir || path11__namespace.join("artifacts", "media", "videos", String(manifest.trace));
-      saved = await saveArtifacts({ root: opts.root, kind: "video", baseDir, flat: true }, [{ bytes: outBuf, ext: ".mp4" }], manifest);
+      const baseDir = opts.outDir && opts.outDir.length > 0 ? opts.outDir : "video";
+      const rawPrefix = (params2.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+      let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:\"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+      if (!promptPrefix) promptPrefix = "untitled";
+      if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+      const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+      saved = await saveArtifacts(
+        { root: opts.root, kind: "video", baseDir, flat: true },
+        [{ bytes: outBuf, ext: ".mp4", logicalName: `${promptPrefix}-${utc}` }],
+        manifest
+      );
     }
     await fsp__namespace.rm(tmpDir, { recursive: true, force: true });
   } else {
-    const items = frames.map((b, i2) => ({ bytes: b, ext: `.png`, logicalName: `frame-${String(i2 + 1).padStart(4, "0")}` }));
+    const rawPrefix = (params2.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+    let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:\"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+    if (!promptPrefix) promptPrefix = "untitled";
+    if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+    const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const items = frames.map((b, i2) => ({ bytes: b, ext: `.png`, logicalName: `${promptPrefix}-${utc}-frame-${String(i2 + 1).padStart(4, "0")}` }));
     {
-      const baseDir = opts.outDir || path11__namespace.join("artifacts", "media", "videos", String(manifest.trace));
+      const baseDir = opts.outDir && opts.outDir.length > 0 ? opts.outDir : "video";
       saved = await saveArtifacts({ root: opts.root, kind: "video", baseDir, flat: true }, items, manifest);
     }
     warnFallback = true;
@@ -48850,8 +48898,8 @@ var init_video_command = __esm({
           const spinner = new ProcessAnimation();
           spinner.start();
           try {
-            const useRemote = String(process.env.MARIA_USE_REMOTE_MEDIA || "").toLowerCase() === "1" && await authManager.isAuthenticated();
-            if (useRemote) {
+            const useRemote2 = String(process.env.MARIA_USE_REMOTE_MEDIA || "").toLowerCase() === "1" && await authManager.isAuthenticated();
+            if (useRemote2) {
               try {
                 const body = {
                   prompt: cli.prompt,
@@ -48881,14 +48929,23 @@ var init_video_command = __esm({
                   const pathMod = await import('path');
                   const fsMod = await import('fs/promises');
                   const savedPaths = [];
+                  const baseDir = "video";
+                  const rawPrefix = (cli.prompt || "").slice(0, 20).replace(/\s+/g, "_");
+                  let promptPrefix = rawPrefix.replace(/[\x00-\x1F<>:"/\\|?*]/g, "_").replace(/[. ]+$/g, "");
+                  if (!promptPrefix) promptPrefix = "untitled";
+                  if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(promptPrefix)) promptPrefix = `${promptPrefix}_`;
+                  const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+                  let idx = 0;
                   for (const f3 of filesInline) {
                     const original = String(f3.file || "").replace(/^[\\/]+/, "");
-                    const name2 = pathMod.basename(original || `video.${cli.format}`);
-                    const full = pathMod.resolve(root, name2);
+                    const ext2 = pathMod.extname(original) || `.${cli.format}`;
+                    const name2 = `${promptPrefix}-${utc}${filesInline.length > 1 ? `-${String(++idx).padStart(2, "0")}` : ""}${ext2}`;
+                    const rel = pathMod.join(baseDir, name2);
+                    const full = pathMod.resolve(root, rel);
                     await fsMod.mkdir(pathMod.dirname(full), { recursive: true });
                     const buf = Buffer.from(String(f3.bytesBase64 || ""), "base64");
                     await fsMod.writeFile(full, buf);
-                    savedPaths.push(name2);
+                    savedPaths.push(rel.replace(/\\/g, "/"));
                   }
                   const { formatVideoOutput: formatVideoOutput3 } = await Promise.resolve().then(() => (init_cli_style(), cli_style_exports));
                   const output4 = await formatVideoOutput3(root, {
@@ -48917,18 +48974,24 @@ var init_video_command = __esm({
                   const fsMod = await import('fs/promises');
                   const base = (process.env.MARIA_API_BASE || "https://api.maria-code.ai").replace(/\/$/, "");
                   const savedPaths = [];
+                  const baseDir = "video";
+                  const promptPrefix = (cli.prompt || "").slice(0, 20).replace(/\s+/g, "_").replace(/[^A-Za-z0-9_\-]/g, "_") || "untitled";
+                  const utc = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+                  let idx = 0;
                   for (const relRaw of filesFromApi) {
-                    const rel = String(relRaw || "").replace(/^[\\/]+/, "");
-                    const url2 = `${base}/${rel}`;
-                    const name2 = pathMod.basename(rel);
-                    const full = pathMod.resolve(root, name2);
+                    const relApi = String(relRaw || "").replace(/^[\\/]+/, "");
+                    const url2 = `${base}/${relApi}`;
+                    const ext2 = pathMod.extname(relApi) || `.${cli.format}`;
+                    const name2 = `${promptPrefix}-${utc}${filesFromApi.length > 1 ? `-${String(++idx).padStart(2, "0")}` : ""}${ext2}`;
+                    const rel = pathMod.join(baseDir, name2);
+                    const full = pathMod.resolve(root, rel);
                     await fsMod.mkdir(pathMod.dirname(full), { recursive: true });
                     const res2 = await fetch(url2);
                     if (!res2.ok) throw new Error(`Failed to download video: ${res2.status}`);
                     const arrayBuf = await res2.arrayBuffer();
                     const buf = Buffer.from(arrayBuf);
                     await fsMod.writeFile(full, buf);
-                    savedPaths.push(name2);
+                    savedPaths.push(rel.replace(/\\/g, "/"));
                   }
                   const { formatVideoOutput: formatVideoOutput3 } = await Promise.resolve().then(() => (init_cli_style(), cli_style_exports));
                   const output4 = await formatVideoOutput3(root, {
@@ -50625,7 +50688,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.27"));
+        output3.push(chalk14__default.default.cyan.bold("\u{1F916} About MARIA v4.3.29"));
         output3.push(chalk14__default.default.gray("\u2550".repeat(40)));
         output3.push("");
         output3.push(chalk14__default.default.white.bold("MARIA - Minimal API, Maximum Power"));
@@ -54127,6 +54190,10 @@ async function normalizePlans(plans, opts) {
   const profile = await scanRepo(opts.root);
   const out = [];
   for (const fp of plans) {
+    if (fp.noNormalize) {
+      out.push(fp);
+      continue;
+    }
     const n = normalizePlanItem(fp, profile);
     if (!n.kind) n.kind = guessKindByPath(n.path);
     out.push(n);
@@ -54171,7 +54238,7 @@ async function validatePlan(plans, opts) {
       skipped.push(fp.path);
       continue;
     }
-    const full = path11__namespace.default.join(opts.root, rel);
+    const full = fp.absPath ? fp.absPath : path11__namespace.default.join(opts.root, rel);
     if (!full.startsWith(path11__namespace.default.resolve(opts.root))) {
       warnings.push(`Outside root denied: ${fp.path}`);
       skipped.push(fp.path);
@@ -54302,10 +54369,10 @@ function formatPlan(summary, opts) {
     budget.diffLines = Math.min(budget.diffLines, 20);
     lines.push("", `Diff preview (truncated to ${budget.diffLines} lines per file):`);
     for (const f3 of summary.files) {
-      if (f3.action === "skip") continue;
-      const before = readCurrentFileSafe(opts.root, f3.path);
+      if (f3.action !== "modify") continue;
+      const before = readCurrentFileSafe(opts.root, f3.path, f3.absPath);
       const after = f3.preview || "";
-      const diff = buildUnifiedDiff(f3.path, before, after, budget);
+      const diff = buildUnifiedDiff(f3.path, before, after, budget, f3.absPath);
       lines.push(diff, "");
     }
   }
@@ -54342,9 +54409,10 @@ function formatPlanAsDiff(files, opts) {
   let shownFiles = 0;
   for (const f3 of files) {
     if (budget.globalMaxFiles !== void 0 && shownFiles >= budget.globalMaxFiles) break;
-    const before = readCurrentFileSafe(opts.root, f3.path);
+    if (f3.action !== "modify") continue;
+    const before = readCurrentFileSafe(opts.root, f3.path, f3.absPath);
     const after = f3.preview || "";
-    const diff = buildUnifiedDiff(f3.path, before, after, budget);
+    const diff = buildUnifiedDiff(f3.path, before, after, budget, f3.absPath);
     const diffBytes = Buffer.byteLength(diff, "utf8");
     if (budget.globalMaxBytes !== void 0 && bytesUsed + diffBytes > budget.globalMaxBytes && shownFiles > 0) {
       lines.push(`
@@ -54361,11 +54429,11 @@ function formatPlanAsDiff(files, opts) {
   }
   return lines.join("\n");
 }
-function readCurrentFileSafe(root, rel) {
-  if (!root) return "";
+function readCurrentFileSafe(root, rel, abs) {
+  if (!root && !abs) return "";
   try {
     const fs49 = __require("fs");
-    const p = __require("path").join(root, rel);
+    const p = abs ? abs : __require("path").join(root, rel);
     return fs49.existsSync(p) ? fs49.readFileSync(p, "utf8") : "";
   } catch {
     return "";
@@ -54382,7 +54450,7 @@ function normalizeDiffBudget(b) {
     globalMaxFiles: Number.isFinite(b?.globalMaxFiles) ? b.globalMaxFiles : envGlobalFiles
   };
 }
-function buildUnifiedDiff(relPath, before, after, b) {
+function buildUnifiedDiff(relPath, before, after, b, abs) {
   const beforeLines = before.split(/\r?\n/);
   const afterLines = after.split(/\r?\n/);
   let i2 = 0;
@@ -54391,14 +54459,15 @@ function buildUnifiedDiff(relPath, before, after, b) {
   while (j < beforeLines.length - i2 && j < afterLines.length - i2 && beforeLines[beforeLines.length - 1 - j] === afterLines[afterLines.length - 1 - j]) j++;
   const oldMid = beforeLines.slice(i2, beforeLines.length - j);
   const newMid = afterLines.slice(i2, afterLines.length - j);
-  const header = [`--- a/${relPath}`, `+++ b/${relPath}`];
+  const headerPath = abs ? abs : relPath;
+  const header = [`--- ${headerPath}`, `+++ ${headerPath}`];
   const body = [];
   const ctxPrefix = Math.max(0, i2 - 3);
   Math.min(beforeLines.length, beforeLines.length - j + 3);
   const preCtx = beforeLines.slice(ctxPrefix, i2).map((l) => ` ${l}`);
   const postCtx = beforeLines.slice(beforeLines.length - j, Math.min(beforeLines.length - j + 3, beforeLines.length)).map((l) => ` ${l}`);
-  const del = oldMid.map((l) => `-${l}`);
-  const add = newMid.map((l) => `+${l}`);
+  const del = oldMid.map((l) => colorRed(`-${l}`));
+  const add = newMid.map((l) => colorGreen(`+${l}`));
   body.push(...preCtx);
   body.push(...del);
   body.push(...add);
@@ -54415,6 +54484,22 @@ function buildUnifiedDiff(relPath, before, after, b) {
   }
   return out;
 }
+function colorGreen(s2) {
+  try {
+    const chalk44 = __require("chalk");
+    return chalk44.green(s2);
+  } catch {
+    return s2;
+  }
+}
+function colorRed(s2) {
+  try {
+    const chalk44 = __require("chalk");
+    return chalk44.red(s2);
+  } catch {
+    return s2;
+  }
+}
 function languageLabel(lang, filePath) {
   if (lang) {
     const l = lang.toLowerCase();
@@ -55041,6 +55126,20 @@ var init_policy = __esm({
   }
 });
 
+// src/utils/esm-compat.ts
+var esm_compat_exports = {};
+__export(esm_compat_exports, {
+  loadGlobby: () => loadGlobby
+});
+async function loadGlobby() {
+  const mod = await import('globby');
+  return mod?.globby ?? mod?.default ?? mod;
+}
+var init_esm_compat = __esm({
+  "src/utils/esm-compat.ts"() {
+  }
+});
+
 // src/services/code-orchestrator/Orchestrator.ts
 var Orchestrator_exports = {};
 __export(Orchestrator_exports, {
@@ -55075,6 +55174,20 @@ async function orchestrate(request, opts) {
   const initial = [];
   const fallbackNotices = [];
   const withNotices = (base) => fallbackNotices.length > 0 ? [...fallbackNotices, ...base] : base;
+  const explicitFilesRaw = parseExplicitFilenames(request);
+  const explicitFiles = explicitFilesRaw.length > 0 ? await resolveExplicitPaths(opts.root, explicitFilesRaw, request) : [];
+  const explicitAbsMap = /* @__PURE__ */ Object.create(null);
+  if (explicitFiles.length > 0) {
+    const pathMod = await import('path');
+    for (const rel of explicitFiles) {
+      explicitAbsMap[rel] = pathMod.join(opts.root, rel);
+    }
+  }
+  const isEditIntent = detectEditIntent(request, {
+    hasAttachments: !!(opts.attachedFiles && opts.attachedFiles.length > 0),
+    explicitFilesCount: explicitFiles.length
+  });
+  const editContext = isEditIntent && explicitFiles.length > 0 ? await buildEditContext(opts.root, explicitFiles, 200, 512 * 1024) : "";
   if (opts.attachedFiles && opts.attachedFiles.length > 0) {
     const mapRes = await mapAttachmentsToTargets(opts.attachedFiles, {
       root: opts.root,
@@ -55094,7 +55207,6 @@ async function orchestrate(request, opts) {
     }
   }
   const onlyAttached = !!opts.flags.onlyAttached;
-  const explicitFiles = parseExplicitFilenames(request);
   if (!onlyAttached) {
     let codeOutput = "";
     if (process.env.MARIA_E2E_FAKE_CODE === "1") {
@@ -55114,9 +55226,17 @@ async function orchestrate(request, opts) {
               "[BEGIN file: path]\n<content>\n[END]",
               "Do not include any prose before/after; no menus/questions/suggestions; start immediately with ``` or [BEGIN file: ...]."
             ].join("\n");
+            const requestPreamble = isEditIntent ? [
+              "// EDIT MODE: modify existing files, preserve unrelated content.",
+              "// Follow existing structure and only touch requested files.",
+              editContext ? "// Current file snapshots provided below." : ""
+            ].filter(Boolean).join("\n") : "";
             const enriched = `${FILE_FORMAT_INSTRUCTIONS}
 
-${request}`;
+${requestPreamble}
+${request}
+
+${editContext}`;
             const response = await executeCode(enriched);
             const raw = (response.output || response?.data?.content || "").trim();
             if (!raw) {
@@ -55161,24 +55281,27 @@ ${request}`;
       const htmlIdx = blocks.findIndex((b) => /html/i.test(b.language));
       const htmlFile = explicitFiles.find((f3) => f3.toLowerCase().endsWith(".html"));
       if (htmlIdx >= 0 && htmlFile) {
-        initial.push({ path: htmlFile, kind: "source", action: "create", description: "HTML page", language: "html", preview: blocks[htmlIdx].code });
+        initial.push({ path: htmlFile, absPath: explicitAbsMap[htmlFile], noNormalize: true, kind: "source", action: "create", description: "HTML page", language: "html", preview: blocks[htmlIdx].code });
         mapped.add(htmlFile);
       }
       const jsIdx = blocks.findIndex((b) => /(ts|tsx|jsx|javascript|js)/i.test(b.language));
       const jsFile = explicitFiles.find((f3) => f3.toLowerCase().endsWith(".js"));
       if (jsIdx >= 0 && jsFile && !mapped.has(jsFile)) {
-        initial.push({ path: jsFile, kind: "source", action: "create", description: "Script", language: "javascript", preview: blocks[jsIdx].code });
+        initial.push({ path: jsFile, absPath: explicitAbsMap[jsFile], noNormalize: true, kind: "source", action: "create", description: "Script", language: "javascript", preview: blocks[jsIdx].code });
         mapped.add(jsFile);
       }
       const cssIdx = blocks.findIndex((b) => /css/i.test(b.language));
       const cssFile = explicitFiles.find((f3) => f3.toLowerCase().endsWith(".css"));
       if (cssIdx >= 0 && cssFile && !mapped.has(cssFile)) {
-        initial.push({ path: cssFile, kind: "source", action: "create", description: "Stylesheet", language: "css", preview: blocks[cssIdx].code });
+        initial.push({ path: cssFile, absPath: explicitAbsMap[cssFile], noNormalize: true, kind: "source", action: "create", description: "Stylesheet", language: "css", preview: blocks[cssIdx].code });
         mapped.add(cssFile);
       }
       for (const f3 of explicitFiles) {
         if (mapped.has(f3)) continue;
-        initial.push(scaffoldForFilename(f3, explicitFiles));
+        const plan = scaffoldForFilename(f3, explicitFiles);
+        plan.absPath = explicitAbsMap[f3];
+        plan.noNormalize = true;
+        initial.push(plan);
       }
     } else {
       for (let i2 = 0; i2 < blocks.length; i2++) {
@@ -55196,12 +55319,26 @@ ${request}`;
       }
     }
   }
+  if (!isEditIntent) {
+    const proposedTop = deriveProjectFolderName(request);
+    const { folderName, detectedTop } = await ensureTopFolder(opts.root, proposedTop, initial);
+    if (folderName) {
+      for (const p of initial) {
+        if (!startsWithTopFolder(p.path, detectedTop || folderName)) {
+          p.path = prefixWithTopFolder(p.path, folderName);
+        }
+      }
+    }
+  }
   if (explicitFiles.length > 0 && initial.filter((f3) => !!f3.preview).length === 0) {
     for (const f3 of explicitFiles) {
       initial.push(scaffoldForFilename(f3, explicitFiles));
     }
   }
-  const normalized = await normalizePlans(initial, { root: opts.root });
+  const normalized = await normalizePlans(
+    initial.map((p) => p.noNormalize ? p : p),
+    { root: opts.root }
+  );
   try {
     const [{ access: access18 }, path60] = await Promise.all([
       import('fs/promises'),
@@ -55209,8 +55346,12 @@ ${request}`;
     ]);
     for (const p of normalized) {
       try {
-        await access18(path60.join(opts.root, p.path));
+        const absCandidate = p.absPath ? p.absPath : path60.join(opts.root, p.path);
+        await access18(absCandidate);
         p.action = "modify";
+        if (isEditIntent) {
+          p.overwritePolicy = "allow";
+        }
       } catch {
         p.action = "create";
       }
@@ -55218,10 +55359,12 @@ ${request}`;
   } catch {
   }
   const validated = await validatePlan(normalized, { root: opts.root, profile, flags: { maxFiles: opts.flags.maxFiles, yes: opts.flags.yes, interactive: !!opts.flags.interactive, ...opts.flags } });
-  const outputMode = resolveOutputMode(opts.flags.output, validated.files.length, !!opts.flags.hideCode);
-  const displayFiles = validated.files.concat(
-    (validated.skipped || []).map((p) => ({ path: p, kind: "source", action: "skip", description: "" }))
-  );
+  const hasAnyModify = validated.files.some((f3) => f3.action === "modify") || isEditIntent;
+  const outputMode = !opts.flags.hideCode && hasAnyModify ? "diff" : resolveOutputMode(opts.flags.output, validated.files.length, !!opts.flags.hideCode);
+  const skippedSetForLookup = new Set(validated.skipped || []);
+  const skippedPlans = normalized.filter((f3) => skippedSetForLookup.has(f3.path));
+  const remainingSkipped = (validated.skipped || []).filter((p) => !skippedPlans.some((sp) => sp.path === p)).map((p) => ({ path: p, kind: "source", action: "skip", description: "" }));
+  const displayFiles = validated.files.concat(skippedPlans).concat(remainingSkipped);
   const summary = summarizePlan(displayFiles);
   const lines = [
     formatPlan(summary, {
@@ -55259,6 +55402,7 @@ ${request}`;
     if (softIssues.hasTrailingWhitespace) lines.push(warnLine("Proposed changes contain trailing whitespace"));
     if (softIssues.hasConflictMarkers) lines.push(warnLine("Proposed changes contain conflict markers"));
   }
+  const preApplyOutput = withNotices(lines);
   let appliedCount = 0;
   let durationMs = 0;
   let rolledBack = false;
@@ -55270,7 +55414,7 @@ ${request}`;
         return { plan: normalized, validated, summaryLines: withNotices([errorLine("working tree not clean (commit or stash first). Re-run after cleaning your git status.")]) };
       }
     }
-    const allowOverwrite = opts.flags.overwriteAllowed === true || !!opts.flags.yes;
+    const allowOverwrite = opts.flags.overwriteAllowed === true || !!opts.flags.yes || isEditIntent;
     const applyRes = await applyPlans(approved, { root: opts.root, overwriteAllowed: allowOverwrite, rollback: opts.flags.rollback !== false, signal: opts.abortSignal, onProgress: (w, t2) => {
     }, eol: profile.eol });
     appliedCount = applyRes.appliedCount;
@@ -55300,7 +55444,7 @@ ${request}`;
     const savedList = [].concat(applyRes.created, applyRes.modified);
     const savedAbs = savedList.map((rel) => path11__namespace.default.resolve(opts.root, rel));
     const footer = savedAbs.length > 0 ? ["Saved files (full paths):", ...savedAbs.map((p) => `- ${p}`)] : [];
-    return { plan: normalized, validated, applied: { count: appliedCount, durationMs, rolledBack }, summaryLines: withNotices([msg, ...footer]) };
+    return { plan: normalized, validated, applied: { count: appliedCount, durationMs, rolledBack }, summaryLines: [...preApplyOutput, "", msg, ...footer] };
   } catch (e2) {
     if (e2?.name === "AbortError") {
       await journalResume(opts.root, request, validated.files);
@@ -55521,6 +55665,218 @@ function parseExplicitFilenames(request) {
   }
   return out;
 }
+function detectEditIntent(request, ctx2) {
+  const r2 = request.toLowerCase();
+  const editKeywords = ["modify", "edit", "update", "fix", "refactor", "change", "patch", "\u5DEE\u5206", "\u4FEE\u6B63", "\u5909\u66F4", "\u65E2\u5B58", "\u8FFD\u8A18"];
+  const mentionsEdit = editKeywords.some((k) => r2.includes(k));
+  return ctx2.hasAttachments || ctx2.explicitFilesCount > 0 || mentionsEdit;
+}
+function sanitizeFolderName(name2) {
+  const base = name2.toLowerCase().replace(/[`~!@#$%^&*()+=\[\]{}|;:'",<>/?\\]/g, " ").replace(/\s+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48);
+  return base || "project";
+}
+function deriveProjectFolderName(request) {
+  const words = request.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2).slice(0, 4).join("-");
+  return sanitizeFolderName(words || "project");
+}
+function startsWithTopFolder(p, folder) {
+  if (!folder) return false;
+  const seg = p.replace(/^\/+/, "").split("/")[0];
+  return seg.toLowerCase() === folder.toLowerCase();
+}
+function prefixWithTopFolder(p, folder) {
+  const rel = p.replace(/^\/+/, "");
+  return `${folder}/${rel}`;
+}
+async function ensureTopFolder(root, proposed, plans) {
+  const tops = /* @__PURE__ */ new Set();
+  for (const p of plans) {
+    const seg = p.path.replace(/^\/+/, "").split("/")[0] || "";
+    if (seg) tops.add(seg);
+  }
+  if (tops.size === 1) {
+    const only = Array.from(tops)[0];
+    const unique2 = await ensureUniqueFolder(root, only);
+    return { folderName: unique2, detectedTop: only };
+  }
+  const unique = await ensureUniqueFolder(root, proposed);
+  return { folderName: unique };
+}
+async function ensureUniqueFolder(root, base) {
+  const fs49 = await import('fs/promises');
+  const pathMod = await import('path');
+  let name2 = sanitizeFolderName(base);
+  let suffix = 0;
+  for (; suffix < Number.MAX_SAFE_INTEGER; ) {
+    const candidate = suffix === 0 ? name2 : `${name2}-${String(suffix).padStart(2, "0")}`;
+    try {
+      await fs49.access(pathMod.join(root, candidate));
+      suffix += 1;
+    } catch {
+      return candidate;
+    }
+  }
+  throw new Error("ensureUniqueFolder: exhausted attempts to find a unique folder name");
+}
+async function buildEditContext(root, files, maxLines, maxBytes) {
+  try {
+    const fs49 = await import('fs/promises');
+    const pathMod = await import('path');
+    const sections = [];
+    for (const rel of files) {
+      const full = pathMod.join(root, rel);
+      try {
+        const buf = await fs49.readFile(full);
+        const clipped = buf.length > maxBytes ? buf.subarray(0, maxBytes) : buf;
+        const text = clipped.toString("utf8").replace(/\r\n/g, "\n");
+        const lines = text.split("\n").slice(0, maxLines).join("\n");
+        sections.push(`[BEGIN file: ${rel}]
+${lines}
+[END]`);
+      } catch {
+      }
+    }
+    if (sections.length === 0) return "";
+    return ["// Current repository files (read-only context):", ...sections].join("\n");
+  } catch {
+    return "";
+  }
+}
+async function resolveExplicitPaths(root, files, hintText) {
+  const fs49 = await import('fs/promises');
+  const pathMod = await import('path');
+  const { loadGlobby: loadGlobby2 } = await Promise.resolve().then(() => (init_esm_compat(), esm_compat_exports));
+  const globby = await loadGlobby2();
+  const ignore = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.maria/**",
+    "**/.next/**",
+    "**/coverage/**"
+  ];
+  const hintTokens = Array.from(new Set(hintText.toLowerCase().replace(/[^a-z0-9_/.-]+/g, " ").split(/\s+/).filter(Boolean)));
+  async function findBest(rel) {
+    const normalized = rel.replace(/^\/+/, "").replace(/\\/g, "/");
+    const fullExact = pathMod.join(root, normalized);
+    try {
+      await fs49.access(fullExact);
+      return normalized;
+    } catch {
+    }
+    const lowerRel = normalized.toLowerCase();
+    const ext2 = (pathMod.extname(normalized) || "").toLowerCase();
+    const base = pathMod.basename(normalized);
+    const nameNoExt = base.replace(/\.[^.]+$/, "").toLowerCase();
+    const parentPath = pathMod.dirname(normalized);
+    const parent = parentPath.split("/").pop() || "";
+    const dirParts = parentPath === "." ? [] : parentPath.split("/").filter(Boolean).map((s2) => s2.toLowerCase());
+    const patterns = [];
+    patterns.push(`**/${normalized}`);
+    if (parent && parent !== "." && parent !== "/") patterns.push(`**/${parent}/${base}`);
+    if (base) patterns.push(`**/${base}`);
+    patterns.push(`**/*${base}`);
+    if (!ext2) {
+      patterns.push(`**/${nameNoExt}.*`);
+    }
+    const uniqPatterns = Array.from(new Set(patterns));
+    const candidatesSet = /* @__PURE__ */ new Set();
+    for (const pat of uniqPatterns) {
+      const found = await globby(pat, { cwd: root, absolute: false, gitignore: true, ignore });
+      for (const f3 of found) {
+        candidatesSet.add(f3.replace(/\\/g, "/"));
+      }
+      if (candidatesSet.size > 200) break;
+    }
+    let candidates = Array.from(candidatesSet);
+    if (dirParts.length > 0) {
+      const filtered = candidates.filter((relp) => {
+        const segs = relp.toLowerCase().split("/");
+        let pos = -1;
+        for (const part of dirParts) {
+          const next = segs.indexOf(part, pos + 1);
+          if (next === -1) return false;
+          pos = next;
+        }
+        return true;
+      });
+      if (filtered.length > 0) candidates = filtered;
+    }
+    if (candidates.length === 0) {
+      const prefixes = ["", "src/", "app/", "pages/"];
+      for (const pre of prefixes) {
+        const cand = pathMod.join(root, pre + normalized);
+        try {
+          await fs49.access(cand);
+          return (pre + normalized).replace(/^\/+/, "");
+        } catch {
+        }
+      }
+      if (dirParts.length > 0) {
+        if (/^(src|app|pages)\//i.test(normalized)) return normalized;
+        const pref = await pickExistingFolderPrefix(root, parentPath);
+        const combined = (pref + normalized).replace(/^\/+/, "").replace(/^(src\/)src\//i, "$1");
+        return combined;
+      }
+      return normalized.replace(/^(src\/)src\//i, "$1");
+    }
+    function score(relPath) {
+      const lower2 = relPath.toLowerCase();
+      let s2 = 0;
+      if (lower2.endsWith(lowerRel)) s2 += 80;
+      if (lower2.split("/").pop() === base.toLowerCase()) s2 += 40;
+      if (ext2 && lower2.endsWith(ext2)) s2 += 10;
+      if (lower2.startsWith("src/")) s2 += 18;
+      if (parent && lower2.includes(`/${parent.toLowerCase()}/`)) s2 += 15;
+      if (parentPath && lower2.endsWith(`/${parentPath.toLowerCase()}/${base.toLowerCase()}`)) s2 += 40;
+      if (dirParts.length > 0) {
+        for (const part of dirParts) {
+          if (lower2.includes(`/${part}/`)) s2 += 20;
+          else s2 -= 120;
+        }
+      }
+      for (const t2 of hintTokens) {
+        if (t2.length >= 3 && lower2.includes(`/${t2}/`)) {
+          s2 += 2;
+        }
+      }
+      s2 -= Math.min(10, Math.floor(relPath.length / 80));
+      return s2;
+    }
+    let best = candidates[0];
+    let bestScore = score(best);
+    for (let i2 = 1; i2 < candidates.length; i2++) {
+      const c = candidates[i2];
+      const sc = score(c);
+      if (sc > bestScore) {
+        best = c;
+        bestScore = sc;
+      }
+    }
+    return best.replace(/^\/+/, "");
+  }
+  const out = [];
+  for (const f3 of files) {
+    out.push(await findBest(f3));
+  }
+  return out;
+}
+async function pickExistingFolderPrefix(root, parentPath) {
+  const fs49 = await import('fs/promises');
+  const pathMod = await import('path');
+  const parts = parentPath.replace(/^\/+/, "").split("/").filter(Boolean);
+  const prefixes = ["src", "app", "pages", ""];
+  for (const pre of prefixes) {
+    const test = pre ? pathMod.join(root, pre, ...parts) : pathMod.join(root, ...parts);
+    try {
+      await fs49.access(test);
+      return pre ? `${pre}/` : "";
+    } catch {
+    }
+  }
+  return "src/";
+}
 function scaffoldForFilename(filename, all) {
   const lower2 = filename.toLowerCase();
   if (lower2.endsWith(".html")) {
@@ -56495,16 +56851,6 @@ var init_resume_command = __esm({
   }
 });
 
-// src/utils/esm-compat.ts
-async function loadGlobby() {
-  const mod = await import('globby');
-  return mod?.globby ?? mod?.default ?? mod;
-}
-var init_esm_compat = __esm({
-  "src/utils/esm-compat.ts"() {
-  }
-});
-
 // src/services/init/scanner.ts
 var scanner_exports = {};
 __export(scanner_exports, {