@krishivpb60/aether-ai-cli 1.3.1 → 1.3.3

package/HIGHLIGHTS.md

@@ -1,3 +1,16 @@
+# Aether CLI v1.3.3 Highlights
+- **Codex & Claude Code Slash Commands**: Added 7 new advanced developer experience (DX) commands:
+  - `/review`: Analyze staged/unstaged git changes and stream an AI-powered code review.
+  - `/diagnose [cmd]`: Run tests/builds and automatically debug any errors.
+  - `/explain <file>`: Explains design flow and patterns in code.
+  - `/refactor <file>`: Rewrites a target file to optimize it.
+  - `/bug <file>`: Scans a file to detect logical edge case failures.
+  - `/doc <file>`: Automatically writes documentation, inline comments, or JSDoc.
+  - `/translate <file> <lang>`: AI-translates file code into another target language.
+
+# Aether CLI v1.3.2 Highlights
+- **Manual Updater `/update`**: Added a new slash command `/update` to manually check the registry and force-upgrade Aether CLI to the latest version immediately, bypassing the 24-hour cache throttle.
+
 # Aether CLI v1.3.1 Highlights
 - **Codex & Claude Code Fusion**: The powers of OpenAI Codex and Claude Code are now combined directly inside the default **Titan Fusion** (`titan`) mode.
 - **Streamlined Modes**: Removed the individual `codex` and `cloude-code` modes to reduce clutter, automatically redirecting all lookups of these modes to Titan Fusion.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krishivpb60/aether-ai-cli",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Aether Core AI — A cyberpunk command-line AI assistant with multi-mode reasoning, 12-node failover mesh, file context injection, and offline fallbacks.",
   "main": "src/cli.js",
   "bin": {

package/src/chat.js

@@ -47,6 +47,7 @@ import { runMainframeHack } from "./ai/fallback.js";
 import { AGENT_INSTRUCTIONS } from "./agent.js";
 import { checkForUpdates } from "./updater.js";
 import { getSessionTokenStats, getBreakdownByModel, resetSessionTokenStats } from "./ai/tokens.js";
+import { getGitDiff } from "./git.js";
 
 
 
@@ -136,7 +137,8 @@ export async function startChat(options = {}) {
       "/help", "/mode", "/modes", "/attach", "/files", "/clear",
       "/providers", "/export", "/status", "/copy", "/exit", "/quit",
       "/theme", "/themes", "/history-clear", "/game", "/abort", "/cmd", "/write",
-      "/commit", "/run", "/history", "/autopilot", "/tokens"
+      "/commit", "/run", "/history", "/autopilot", "/tokens", "/update",
+      "/review", "/diagnose", "/explain", "/refactor", "/bug", "/doc", "/translate"
     ];
     const customCmds = aiConfig.CUSTOM_COMMANDS || {};
     const commands = [...builtIn, ...Object.keys(customCmds)];
@@ -423,7 +425,9 @@ export async function startChat(options = {}) {
         "/", "/help", "/mode", "/modes", "/attach", "/files", "/clear",
         "/providers", "/export", "/status", "/copy", "/exit", "/quit",
         "/theme", "/themes", "/history-clear", "/game", "/abort", "/cmd",
-        "/guess", "/write", "/commit", "/run", "/history", "/autopilot", "/tokens"
+        "/guess", "/write", "/commit", "/run", "/history", "/autopilot", "/tokens",
+        "/update", "/review", "/diagnose", "/explain", "/refactor", "/bug", "/doc",
+        "/translate"
       ];
       
       const customCmds = aiConfig.CUSTOM_COMMANDS || {};
@@ -514,6 +518,28 @@ async function handleCommand(input, ctx) {
       showActiveProviders(ctx.aiConfig);
       break;
 
+    case "/update":
+      console.log("\n" + label.system + " " + colors.muted("Checking registry for updates..."));
+      await checkForUpdates(true);
+      console.log("");
+      break;
+
+    case "/review":
+      await handleReviewCommand(ctx);
+      break;
+
+    case "/diagnose":
+      await handleDiagnoseCommand(args, ctx);
+      break;
+
+    case "/explain":
+    case "/refactor":
+    case "/bug":
+    case "/doc":
+    case "/translate":
+      await handleFileAICommand(cmd, args, ctx);
+      break;
+
     case "/theme":
       await handleThemeSwitch(args);
       break;
@@ -606,12 +632,20 @@ function showHelp(aiConfig) {
   console.log(keyValue("/history-clear", "Clear saved persistent chat history"));
   console.log(keyValue("/autopilot <mode>", "View or switch agent autopilot level (off, safe, workspace, machine)"));
   console.log(keyValue("/tokens", "View detailed session token usage and exchanges telemetry"));
+  console.log(keyValue("/update", "Force check for updates and update Aether CLI manually"));
   console.log(keyValue("/game", "Start the local mainframe hacking mini-game"));
   console.log(keyValue("/copy", "Copy the last assistant response to clipboard"));
   console.log(keyValue("/cmd <list|add|remove>", "Manage custom command shortcuts"));
   console.log(keyValue("/write <filename>", "Extract last code block and save to file"));
   console.log(keyValue("/commit", "Generate conventional commit message and commit changes"));
   console.log(keyValue("/run <command>", "Execute a shell command interactively"));
+  console.log(keyValue("/review", "Run git diff and stream an AI code review"));
+  console.log(keyValue("/diagnose [cmd]", "Run build/tests and AI-debug any errors"));
+  console.log(keyValue("/explain <file>", "AI-explain the design and logic of a file"));
+  console.log(keyValue("/refactor <file>", "AI-refactor the code of a target file"));
+  console.log(keyValue("/bug <file>", "AI-audit a file to find potential logic bugs"));
+  console.log(keyValue("/doc <file>", "AI-generate documentation/docstrings for a file"));
+  console.log(keyValue("/translate <file> <lang>", "AI-translate code of a file to another language"));
   console.log(keyValue("/exit", "End session"));
 
   if (aiConfig && aiConfig.CUSTOM_COMMANDS) {
@@ -1394,3 +1428,190 @@ async function handleTokensDisplay(ctx) {
   console.log("  " + colors.accent("Total Tokens:") + colors.text(`    Prompt: ${stats.prompt.toLocaleString()} | Completion: ${stats.completion.toLocaleString()} | Sum: `) + colors.brand.bold(stats.total.toLocaleString()));
   console.log(separator("━") + "\n");
 }
+
+/**
+ * Streams an AI query prompt and prints telemetry details at the end.
+ */
+async function executeAISpecialCommand(prompt, specialLabel, ctx) {
+  const systemPrompt = ctx.currentMode.systemPrompt + "\n" + AGENT_INSTRUCTIONS;
+  let hasStarted = false;
+  let responseText = "";
+  const queryStartTime = Date.now();
+  let firstTokenTime = 0;
+
+  const onToken = (token) => {
+    if (!hasStarted) {
+      hasStarted = true;
+      firstTokenTime = Date.now();
+      process.stdout.write("\n" + label.aether + " " + colors.accent(specialLabel) + "\n" + separator("─") + "\n\n");
+    }
+    process.stdout.write(colors.success(token));
+    responseText += token;
+  };
+
+  const result = await routePrompt(prompt, systemPrompt, ctx.aiConfig, onToken);
+  console.log("\n");
+
+  const elapsedSec = ((Date.now() - queryStartTime) / 1000).toFixed(1);
+  let speedText = "";
+  if (firstTokenTime > 0) {
+    const streamElapsed = (Date.now() - firstTokenTime) / 1000;
+    if (streamElapsed > 0.05) {
+      const estimatedTokens = Math.max(1, Math.round(responseText.length / 4));
+      const tps = (estimatedTokens / streamElapsed).toFixed(1);
+      speedText = ` • ${tps} tok/s`;
+    }
+  }
+
+  const showTokens = ctx.aiConfig.SHOW_TOKENS !== "false";
+  let tokensText = "";
+  if (showTokens && result.usage) {
+    const { promptTokens, completionTokens } = result.usage;
+    tokensText = ` • ${promptTokens.toLocaleString()} in / ${completionTokens.toLocaleString()} out tokens`;
+  }
+
+  console.log(separator("─"));
+  console.log(
+    "  " + colors.dim(`Node ${result.node} • ${result.provider}`) +
+    (result.model ? colors.dim(` • ${result.model}`) : "") +
+    colors.dim(` • ${elapsedSec}s${speedText}`) +
+    colors.dim(tokensText)
+  );
+  console.log("");
+}
+
+/**
+ * Handler for the /review command (git diff analysis).
+ */
+async function handleReviewCommand(ctx) {
+  console.log("\n" + label.system + " " + colors.muted("Running git diff to fetch repository changes..."));
+  try {
+    const { diff, isStaged } = await getGitDiff();
+    if (!diff) {
+      console.log(label.system + " " + colors.success("✓ No changes detected in the repository to review.\n"));
+      return;
+    }
+
+    const specialLabel = `Reviewing ${isStaged ? "staged" : "unstaged"} changes...`;
+    const prompt = `Review the following git diff. Identify potential bugs, logical issues, security concerns, performance problems, and recommend optimization or code cleanup. Keep it concise, practical, and highly technical:\n\n\`\`\`diff\n${diff}\n\`\`\``;
+
+    await executeAISpecialCommand(prompt, specialLabel, ctx);
+  } catch (err) {
+    console.log(label.system + " " + colors.danger(`Error: ${err.message}\n`));
+  }
+}
+
+/**
+ * Handler for the /diagnose command (build & test diagnostics execution).
+ */
+async function handleDiagnoseCommand(args, ctx) {
+  const defaultCmd = ctx.aiConfig.DIAGNOSE_CMD || "npm test";
+  const cmdToRun = args.join(" ").trim() || defaultCmd;
+
+  console.log("\n" + label.system + " " + colors.muted(`Running diagnostics command: "${cmdToRun}"...`));
+  
+  const spinner = createSpinner("Executing diagnostics").start();
+  try {
+    const { exec } = await import("node:child_process");
+    const { promisify } = await import("node:util");
+    const execAsync = promisify(exec);
+    await execAsync(cmdToRun);
+    spinner.succeed("Diagnostics complete!");
+    console.log("\n" + label.system + " " + colors.success("✓ Diagnostics clean! Build and tests passed successfully.\n"));
+  } catch (err) {
+    spinner.fail("Diagnostics failed!");
+    
+    const output = (err.stdout || "") + "\n" + (err.stderr || "");
+    console.log("\n" + label.system + " " + colors.warning(`Diagnostics returned exit code ${err.code}.`));
+    console.log(colors.muted("Analyzing compiler/test output logs...\n"));
+
+    const prompt = `The diagnostics command "${cmdToRun}" failed with exit code ${err.code}. Analyze the following stdout and stderr logs to determine the root cause, identify the files/lines causing the failure, and provide a step-by-step resolution and debugging plan:\n\n\`\`\`\n${output.slice(0, 15000)}\n\`\`\``;
+
+    await executeAISpecialCommand(prompt, "Analyzing diagnostics logs...", ctx);
+  }
+}
+
+/**
+ * Handler for file analysis commands: /explain, /refactor, /bug, /doc, /translate.
+ */
+async function handleFileAICommand(cmdName, args, ctx) {
+  const filePath = args[0];
+  if (!filePath) {
+    console.log("\n" + label.system + " " + colors.warning(`Usage: ${cmdName} <file_path>\n`));
+    return;
+  }
+
+  // Resolve path
+  const resolvedPath = resolve(process.cwd(), filePath);
+  
+  // Verify path is inside the workspace
+  const { isInsideWorkspace } = await import("./agent.js");
+  if (!isInsideWorkspace(resolvedPath)) {
+    console.log("\n" + label.system + " " + colors.danger("Error: Path is outside the current workspace sandbox.\n"));
+    return;
+  }
+
+  if (!existsSync(resolvedPath)) {
+    console.log("\n" + label.system + " " + colors.danger(`Error: File does not exist at "${filePath}"\n`));
+    return;
+  }
+
+  const stat = statSync(resolvedPath);
+  if (stat.isDirectory()) {
+    console.log("\n" + label.system + " " + colors.danger(`Error: "${filePath}" is a directory. File path required.\n`));
+    return;
+  }
+
+  if (stat.size > 150 * 1024) { // 150KB limit
+    console.log("\n" + label.system + " " + colors.warning(`Warning: File "${filePath}" is too large (${Math.round(stat.size / 1024)}KB). Limits are 150KB to protect context limit.\n`));
+    return;
+  }
+
+  // Read file content
+  let content;
+  try {
+    const { parseFile } = await import("./file-parser.js");
+    const parsed = await parseFile(resolvedPath);
+    content = parsed.content;
+  } catch (err) {
+    console.log("\n" + label.system + " " + colors.danger(`Error parsing file: ${err.message}\n`));
+    return;
+  }
+
+  let prompt = "";
+  let labelText = "";
+
+  switch (cmdName.toLowerCase()) {
+    case "/explain":
+      labelText = `Explaining ${filePath}...`;
+      prompt = `Explain the architecture, design patterns, logic flow, and purpose of the following code. Be clear, technical, and structured:\n\n\`\`\`\n${content}\n\`\`\``;
+      break;
+    case "/refactor":
+      labelText = `Refactoring ${filePath}...`;
+      prompt = `Suggest refactoring improvements for the following code. Focus on clean code design principles, optimization, readability, reducing complexity, and fixing potential logic bugs. Return both the refactored code block and explanations:\n\n\`\`\`\n${content}\n\`\`\``;
+      break;
+    case "/bug":
+      labelText = `Auditing bugs in ${filePath}...`;
+      prompt = `Perform a thorough static analysis and code review of the following code. Identify potential logical bugs, race conditions, edge case failures, performance bottlenecks, and security hazards. Suggest fixes:\n\n\`\`\`\n${content}\n\`\`\``;
+      break;
+    case "/doc":
+      labelText = `Generating documentation for ${filePath}...`;
+      prompt = `Generate comprehensive API documentation, JSDoc/docstrings, and comments for the following code. Ensure code parameters, return values, and types are documented:\n\n\`\`\`\n${content}\n\`\`\``;
+      break;
+    case "/translate":
+      const targetLang = args[1];
+      if (!targetLang) {
+        console.log("\n" + label.system + " " + colors.warning(`Usage: /translate <file_path> <target_language>\n`));
+        return;
+      }
+      labelText = `Translating ${filePath} to ${targetLang}...`;
+      prompt = `Translate the following code into ${targetLang}. Return a clean, syntactically correct, and beautifully structured code block of the translated code:\n\n\`\`\`\n${content}\n\`\`\``;
+      break;
+  }
+
+  try {
+    await executeAISpecialCommand(prompt, labelText, ctx);
+  } catch (err) {
+    console.log("\n" + label.system + " " + colors.danger(`Error: ${err.message}\n`));
+  }
+}

package/src/config.js

@@ -176,7 +176,7 @@ export function isValidConfigKey(key) {
   const allowedSpecialKeys = [
     "THEME", "CUSTOM_COMMANDS", "AUTOPILOT", 
     "AUTO_UPDATE", "SHOW_HIGHLIGHTS", "LAST_UPDATE_CHECK", "LAST_NOTIFIED_VERSION",
-    "SHOW_TOKENS"
+    "SHOW_TOKENS", "DIAGNOSE_CMD"
   ];
   if (upper.endsWith("_API_KEY") || upper.endsWith("_API_KEYS") || upper.endsWith("_MODEL") || allowedSpecialKeys.includes(upper)) {
     return true;

package/src/updater.js

@@ -105,16 +105,16 @@ export async function showReleaseHighlights(version) {
 /**
  * Checks for updates and runs the automatic updater if configured.
  */
-export async function checkForUpdates() {
+export async function checkForUpdates(force = false) {
   const autoUpdate = (await getConfigValue("AUTO_UPDATE")) !== "false";
   const showHighlights = (await getConfigValue("SHOW_HIGHLIGHTS")) !== "false";
   const lastCheck = parseInt(await getConfigValue("LAST_UPDATE_CHECK") || "0", 10);
   const now = Date.now();
   const currentVersion = pkg.version;
 
-  // Run update check at most once every 24 hours (86,400,000 ms)
+  // Run update check at most once every 24 hours (86,400,000 ms), unless forced
   const checkInterval = 24 * 60 * 60 * 1000;
-  if (now - lastCheck < checkInterval) {
+  if (!force && (now - lastCheck < checkInterval)) {
     // Show highlights if we just updated and haven't shown highlights for this version
     const lastNotified = await getConfigValue("LAST_NOTIFIED_VERSION") || "";
     if (showHighlights && lastNotified !== currentVersion) {
@@ -136,12 +136,17 @@ export async function checkForUpdates() {
     });
     clearTimeout(timeoutId);
 
-    if (!res.ok) return;
+    if (!res.ok) {
+      if (force) {
+        console.log(label.system + " " + colors.warning(`⚠ Update check failed: server returned status ${res.status}`));
+      }
+      return;
+    }
     const data = await res.json();
     const latestVersion = data.version;
 
     if (isNewerVersion(latestVersion, currentVersion)) {
-      if (autoUpdate) {
+      if (autoUpdate || force) {
         console.log("\n" + label.system + " " + colors.brand(`⚡ New version detected! Auto-updating from v${currentVersion} to v${latestVersion}...`));
 
         const isPip = process.env.AETHER_PACKAGER === "pip";
@@ -173,6 +178,9 @@ export async function checkForUpdates() {
         console.log(label.system + " " + colors.muted(`To update, run: ${updateCmd}`));
       }
     } else {
+      if (force) {
+        console.log(label.system + " " + colors.success(`✓ Aether is already up to date (v${currentVersion}).`));
+      }
       // Already on latest version, check if we need to show highlights
       const lastNotified = await getConfigValue("LAST_NOTIFIED_VERSION") || "";
       if (showHighlights && lastNotified !== currentVersion) {
@@ -180,7 +188,9 @@ export async function checkForUpdates() {
         await setConfigValue("LAST_NOTIFIED_VERSION", currentVersion);
       }
     }
-  } catch {
-    // Fail silently (offline or registry down)
+  } catch (err) {
+    if (force) {
+      console.log(label.system + " " + colors.warning(`⚠ Update check failed: ${err.message}`));
+    }
   }
 }

package/test/dx.test.js

@@ -0,0 +1,10 @@
+import { test } from "node:test";
+import assert from "node:assert";
+import { isValidConfigKey } from "../src/config.js";
+
+test("Developer Experience (DX) Commands Suite", async (t) => {
+  await t.test("isValidConfigKey whitelists DIAGNOSE_CMD correctly", () => {
+    assert.strictEqual(isValidConfigKey("DIAGNOSE_CMD"), true);
+    assert.strictEqual(isValidConfigKey("diagnose_cmd"), true);
+  });
+});

package/test/updater.test.js

@@ -87,4 +87,23 @@ test("Auto-Updater & Highlights Suite", async (t) => {
     const updatedCheck = parseInt(await getConfigValue("LAST_UPDATE_CHECK") || "0", 10);
     assert.ok(updatedCheck > now - 10000);
   });
+
+  await t.test("checkForUpdates(true) bypasses 24h throttling when force is true", async () => {
+    const now = Date.now();
+    // Set last check to 1 hour ago (would normally throttle)
+    await setConfigValue("LAST_UPDATE_CHECK", (now - 60 * 60 * 1000).toString());
+
+    let fetchCalled = false;
+    globalThis.fetch = async (url) => {
+      fetchCalled = true;
+      assert.ok(url.includes("registry.npmjs.org"));
+      return {
+        ok: true,
+        json: async () => ({ version: pkg.version })
+      };
+    };
+
+    await checkForUpdates(true); // force = true
+    assert.strictEqual(fetchCalled, true);
+  });
 });