@rnbsolucoes/axion-code 0.1.52 → 0.1.54

package/README.md

@@ -112,6 +112,27 @@ current platform into the local Axion Code bin directory and then executes it. I
 a source clone only, if no packaged binary exists, the wrapper can build from Go
 as a development fallback.
 
+### Terminal setup (multi-line composer)
+
+In the chat composer, **Enter sends** and **Ctrl+J inserts a newline**. Terminals
+do not report Shift+Enter or Ctrl+Enter as distinct keys to the app on Windows,
+so those keys must be mapped to send a newline.
+
+On the **first run**, Axion does this automatically for Windows Terminal: it maps
+**Shift+Enter** and **Ctrl+Enter** to send a newline (only when those keys are
+free — it never overwrites an existing binding), writes a `settings.json.axion-bak`
+backup, and prints a one-line notice. Reopen the terminal tab to apply. This runs
+at runtime (not via an npm `postinstall` hook) and only once, tracked by a marker
+in the local bin directory.
+
+Opt out with `AXION_SKIP_TERMINAL_SETUP=1`. Re-apply or repair anytime with:
+
+```powershell
+axion terminal-setup
+```
+
+On other terminals, bind Shift+Enter / Ctrl+Enter to send a newline (`\n`) manually.
+
 To classify the currently executed binary for support or security review, run:
 
 ```powershell

package/npm/bin/axion.mjs

@@ -328,11 +328,133 @@ async function updateCommandHandler(args) {
   console.log("Axion Code update completed. Run axion again.");
 }
 
+function applyTerminalSetup({ auto = false } = {}) {
+  // Map Shift+Enter and Ctrl+Enter to send a literal newline (LF). Axion's
+  // composer inserts a line break on LF, while plain Enter (CR) still sends.
+  // This is needed because terminals do not report Shift+Enter/Ctrl+Enter as
+  // distinct keys to the app on Windows. In auto mode it stays silent, never
+  // clobbers an existing user binding, and swallows failures.
+  if (!isWindows) {
+    if (!auto) {
+      console.log("axion terminal-setup currently automates Windows Terminal.");
+      console.log("On other terminals, bind Shift+Enter (and/or Ctrl+Enter) to send a newline (\\n).");
+    }
+    return { changed: false, reason: "unsupported" };
+  }
+  const localAppData = process.env.LOCALAPPDATA || join(process.env.USERPROFILE || root, "AppData", "Local");
+  const candidates = [
+    join(localAppData, "Packages", "Microsoft.WindowsTerminal_8wekyb3d8bbwe", "LocalState", "settings.json"),
+    join(localAppData, "Packages", "Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe", "LocalState", "settings.json"),
+    join(localAppData, "Microsoft", "Windows Terminal", "settings.json")
+  ];
+  const settingsPath = candidates.find((p) => existsSync(p));
+  if (!settingsPath) {
+    if (!auto) {
+      console.log("Windows Terminal settings.json not found.");
+      console.log("If you use another terminal, bind Shift+Enter / Ctrl+Enter to send a newline (\\n).");
+    }
+    return { changed: false, reason: "not-found" };
+  }
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+  } catch (err) {
+    if (!auto) {
+      console.error(`Could not parse ${settingsPath}: ${err.message}`);
+      process.exit(1);
+    }
+    return { changed: false, reason: "parse-error" };
+  }
+  if (!Array.isArray(settings.keybindings)) settings.keybindings = [];
+  const wanted = ["shift+enter", "ctrl+enter"];
+  // Windows Terminal may normalize an inline {command,keys} binding into an
+  // id-based one ({id,keys}) plus an entry in `actions`, so resolve both forms.
+  const effectiveCommand = (k) => {
+    if (!k) return null;
+    if (k.command) return k.command;
+    if (k.id) {
+      const a = (settings.actions || []).find((x) => x && x.id === k.id);
+      if (a && a.command) return a.command;
+    }
+    return null;
+  };
+  const isOurs = (k, keys) => {
+    if (!k || k.keys !== keys) return false;
+    const c = effectiveCommand(k);
+    return c && c.action === "sendInput" && c.input === "\n";
+  };
+  if (wanted.every((keys) => settings.keybindings.some((k) => isOurs(k, keys)))) {
+    if (!auto) console.log("Windows Terminal is already set up: Shift+Enter and Ctrl+Enter insert a newline.");
+    return { changed: false, reason: "already" };
+  }
+  if (auto) {
+    // Never overwrite a binding the user assigned to these keys themselves.
+    for (const keys of wanted) {
+      const existing = settings.keybindings.find((k) => k && k.keys === keys);
+      if (existing && !isOurs(existing, keys)) return { changed: false, reason: "conflict" };
+    }
+  }
+  settings.keybindings = settings.keybindings.filter((k) => !(k && wanted.includes(k.keys)));
+  for (const keys of wanted) {
+    settings.keybindings.push({ command: { action: "sendInput", input: "\n" }, keys });
+  }
+  const backup = `${settingsPath}.axion-bak`;
+  try {
+    copyFileSync(settingsPath, backup);
+  } catch {}
+  try {
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 4));
+  } catch (err) {
+    if (!auto) {
+      console.error(err.message);
+      process.exit(1);
+    }
+    return { changed: false, reason: "write-error" };
+  }
+  if (!auto) {
+    console.log("Windows Terminal configured: Shift+Enter and Ctrl+Enter now insert a newline in Axion (Enter still sends).");
+    console.log(`Settings: ${settingsPath}`);
+    console.log(`Backup:   ${backup}`);
+    console.log("Reopen the terminal tab if the change does not take effect immediately.");
+  }
+  return { changed: true, settingsPath, backup };
+}
+
+function terminalSetupHandler() {
+  applyTerminalSetup({ auto: false });
+}
+
+function maybeFirstRunTerminalSetup() {
+  if (!isWindows || process.env.AXION_SKIP_TERMINAL_SETUP) return;
+  const marker = join(binDir, ".axion-terminal-setup-done");
+  if (existsSync(marker)) return;
+  try {
+    const res = applyTerminalSetup({ auto: true });
+    if (res.changed) {
+      console.log(
+        `Axion enabled Shift+Enter and Ctrl+Enter as newline keys in Windows Terminal ` +
+        `(reopen the tab to apply; backup at ${res.backup}, opt out with AXION_SKIP_TERMINAL_SETUP=1, ` +
+        `redo with 'axion terminal-setup').`
+      );
+    }
+  } catch {}
+  try {
+    mkdirSync(binDir, { recursive: true });
+    writeFileSync(marker, new Date().toISOString());
+  } catch {}
+}
+
 const args = process.argv.slice(2);
 if (args[0] === "update") {
   await updateCommandHandler(args.slice(1));
   process.exit(0);
 }
+if (args[0] === "terminal-setup") {
+  terminalSetupHandler();
+  process.exit(0);
+}
+
+maybeFirstRunTerminalSetup();
 
 const updateInfo = await readUpdateInfo();
 ensureBinary();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnbsolucoes/axion-code",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "Axion Code CLI harness for the Axion ecosystem.",
   "type": "module",
   "repository": {