@hasna/terminal 0.7.4 → 0.7.6

package/dist/cli.js

@@ -83,6 +83,12 @@ if (args[0] === "exec") {
     const { parseOutput, estimateTokens } = await import("./parsers/index.js");
     const { recordSaving, recordUsage } = await import("./economy.js");
     const { isTestOutput, trackTests, formatWatchResult } = await import("./test-watchlist.js");
+    const { detectLoop } = await import("./loop-detector.js");
+    // Loop detection — suggest narrowing if running full test suite repeatedly
+    const loop = detectLoop(command);
+    if (loop.detected) {
+        console.error(`[open-terminal] loop detected: test run #${loop.iteration}${loop.suggestedNarrow ? ` — try: ${loop.suggestedNarrow}` : " — consider narrowing to specific test file"}`);
+    }
     // Rewrite command if possible
     const rw = rewriteCommand(command);
     const actualCmd = rw.changed ? rw.rewritten : command;
@@ -452,6 +458,35 @@ else if (args[0] === "sessions") {
         }
     }
 }
+// ── Overview command ─────────────────────────────────────────────────────────
+else if (args[0] === "overview") {
+    const { existsSync, readFileSync } = await import("fs");
+    const { execSync } = await import("child_process");
+    const run = (cmd) => { try {
+        return execSync(cmd, { encoding: "utf8", cwd: process.cwd() }).trim();
+    }
+    catch {
+        return "";
+    } };
+    let pkg = null;
+    try {
+        pkg = JSON.parse(readFileSync("package.json", "utf8"));
+    }
+    catch { }
+    if (pkg) {
+        console.log(`${pkg.name}@${pkg.version}`);
+        if (pkg.scripts) {
+            console.log("\nScripts:");
+            for (const [k, v] of Object.entries(pkg.scripts).slice(0, 10))
+                console.log(`  ${k}: ${v}`);
+        }
+        if (pkg.dependencies)
+            console.log(`\nDeps: ${Object.keys(pkg.dependencies).join(", ")}`);
+    }
+    const src = run("ls -1 src/ 2>/dev/null || ls -1 lib/ 2>/dev/null");
+    if (src)
+        console.log(`\nSource:\n${src.split("\n").map(f => "  " + f).join("\n")}`);
+}
 // ── Repo command ─────────────────────────────────────────────────────────────
 else if (args[0] === "repo") {
     const { execSync } = await import("child_process");

package/dist/loop-detector.js

@@ -0,0 +1,75 @@
+// Edit-test loop detector — detects repetitive test→edit→test patterns
+// and suggests narrowing to specific test files
+const history = [];
+const MAX_HISTORY = 20;
+// Detect test commands
+const TEST_PATTERNS = [
+    /\bbun\s+test\b/, /\bnpm\s+test\b/, /\bnpx\s+jest\b/, /\bnpx\s+vitest\b/,
+    /\bpnpm\s+test\b/, /\byarn\s+test\b/, /\bpytest\b/, /\bgo\s+test\b/,
+    /\bcargo\s+test\b/, /\brspec\b/, /\bphpunit\b/, /\bmocha\b/,
+];
+function isTestCommand(cmd) {
+    return TEST_PATTERNS.some(p => p.test(cmd));
+}
+function isFullSuiteCommand(cmd) {
+    // Full suite = test command without specific file/pattern
+    if (!isTestCommand(cmd))
+        return false;
+    // If it has a specific file or --grep, it's already narrowed
+    if (/\.(test|spec)\.(ts|tsx|js|jsx|py|rs|go)/.test(cmd))
+        return false;
+    if (/--grep|--filter|-t\s/.test(cmd))
+        return false;
+    return true;
+}
+/** Record a command execution and detect loops */
+export function detectLoop(command) {
+    history.push({ command, timestamp: Date.now() });
+    if (history.length > MAX_HISTORY)
+        history.shift();
+    if (!isTestCommand(command)) {
+        return { detected: false, iteration: 0, testCommand: command };
+    }
+    // Count consecutive test runs (allowing non-test commands between them)
+    let testCount = 0;
+    for (let i = history.length - 1; i >= 0; i--) {
+        if (isTestCommand(history[i].command))
+            testCount++;
+        // If we hit a non-test, non-edit command, stop counting
+        // (edits are invisible to us since we only see exec'd commands)
+    }
+    if (testCount < 3 || !isFullSuiteCommand(command)) {
+        return { detected: false, iteration: testCount, testCommand: command };
+    }
+    // Detected loop — suggest narrowing
+    // Try to find a recently-mentioned test file in recent commands
+    let suggestedNarrow;
+    // Look for file paths in recent history that could be test targets
+    for (let i = history.length - 2; i >= Math.max(0, history.length - 10); i--) {
+        const cmd = history[i].command;
+        // Look for edited/touched files
+        const fileMatch = cmd.match(/(\S+\.(ts|tsx|js|jsx|py|rs|go))\b/);
+        if (fileMatch && !isTestCommand(cmd)) {
+            const file = fileMatch[1];
+            // Suggest corresponding test file
+            const testFile = file.replace(/\.(ts|tsx|js|jsx)$/, ".test.$1");
+            suggestedNarrow = command.replace(/\b(test)\b/, `test ${testFile}`);
+            break;
+        }
+    }
+    // Fallback: suggest adding --grep or specific file
+    if (!suggestedNarrow) {
+        suggestedNarrow = undefined; // Can't determine which file
+    }
+    return {
+        detected: true,
+        iteration: testCount,
+        testCommand: command,
+        suggestedNarrow,
+        reason: `Full test suite run ${testCount} times. Consider narrowing to specific test file.`,
+    };
+}
+/** Reset loop detection (e.g., on session start) */
+export function resetLoopDetector() {
+    history.length = 0;
+}

package/dist/mcp/server.js

@@ -416,6 +416,54 @@ export function createServer() {
         const sessions = listSessions(limit ?? 20);
         return { content: [{ type: "text", text: JSON.stringify(sessions) }] };
     });
+    // ── project_overview: orient agent in one call ─────────────────────────────
+    server.tool("project_overview", "Get project overview in one call — package.json info, source structure, config files. Replaces: cat package.json + ls src/ + cat tsconfig.json.", {
+        path: z.string().optional().describe("Project root (default: cwd)"),
+    }, async ({ path }) => {
+        const cwd = path ?? process.cwd();
+        const [pkgResult, srcResult, configResult] = await Promise.all([
+            exec("cat package.json 2>/dev/null", cwd),
+            exec("ls -1 src/ 2>/dev/null || ls -1 lib/ 2>/dev/null || ls -1 app/ 2>/dev/null", cwd),
+            exec("ls -1 *.json *.config.* .env* tsconfig* 2>/dev/null", cwd),
+        ]);
+        let pkg = null;
+        try {
+            pkg = JSON.parse(pkgResult.stdout);
+        }
+        catch { }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        name: pkg?.name,
+                        version: pkg?.version,
+                        scripts: pkg?.scripts,
+                        dependencies: pkg?.dependencies ? Object.keys(pkg.dependencies) : [],
+                        devDependencies: pkg?.devDependencies ? Object.keys(pkg.devDependencies) : [],
+                        sourceFiles: srcResult.stdout.split("\n").filter(l => l.trim()),
+                        configFiles: configResult.stdout.split("\n").filter(l => l.trim()),
+                    }) }],
+        };
+    });
+    // ── last_commit: what just happened ───────────────────────────────────────
+    server.tool("last_commit", "Get details of the last commit — hash, message, files changed, diff stats. Replaces: git log -1 + git show --stat + git diff HEAD~1.", {
+        path: z.string().optional().describe("Repo path (default: cwd)"),
+    }, async ({ path }) => {
+        const cwd = path ?? process.cwd();
+        const [logResult, statResult] = await Promise.all([
+            exec("git log -1 --format='%H%n%s%n%an%n%ai'", cwd),
+            exec("git show --stat --format='' HEAD", cwd),
+        ]);
+        const [hash, message, author, date] = logResult.stdout.split("\n");
+        const filesChanged = statResult.stdout.split("\n").filter(l => l.trim() && !l.includes("changed"));
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        hash: hash?.trim(),
+                        message: message?.trim(),
+                        author: author?.trim(),
+                        date: date?.trim(),
+                        filesChanged,
+                    }) }],
+        };
+    });
     // ── read_file: cached file reading ─────────────────────────────────────────
     server.tool("read_file", "Read a file with session caching. Second read of unchanged file returns instantly from cache. Supports offset/limit for pagination without re-reading.", {
         path: z.string().describe("File path"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "bin": {

package/src/cli.tsx

@@ -87,6 +87,13 @@ if (args[0] === "exec") {
   const { parseOutput, estimateTokens } = await import("./parsers/index.js");
   const { recordSaving, recordUsage } = await import("./economy.js");
   const { isTestOutput, trackTests, formatWatchResult } = await import("./test-watchlist.js");
+  const { detectLoop } = await import("./loop-detector.js");
+
+  // Loop detection — suggest narrowing if running full test suite repeatedly
+  const loop = detectLoop(command);
+  if (loop.detected) {
+    console.error(`[open-terminal] loop detected: test run #${loop.iteration}${loop.suggestedNarrow ? ` — try: ${loop.suggestedNarrow}` : " — consider narrowing to specific test file"}`);
+  }
 
   // Rewrite command if possible
   const rw = rewriteCommand(command);
@@ -436,6 +443,29 @@ else if (args[0] === "sessions") {
   }
 }
 
+// ── Overview command ─────────────────────────────────────────────────────────
+
+else if (args[0] === "overview") {
+  const { existsSync, readFileSync } = await import("fs");
+  const { execSync } = await import("child_process");
+  const run = (cmd: string) => { try { return execSync(cmd, { encoding: "utf8", cwd: process.cwd() }).trim(); } catch { return ""; } };
+
+  let pkg: any = null;
+  try { pkg = JSON.parse(readFileSync("package.json", "utf8")); } catch {}
+
+  if (pkg) {
+    console.log(`${pkg.name}@${pkg.version}`);
+    if (pkg.scripts) {
+      console.log("\nScripts:");
+      for (const [k, v] of Object.entries(pkg.scripts).slice(0, 10)) console.log(`  ${k}: ${v}`);
+    }
+    if (pkg.dependencies) console.log(`\nDeps: ${Object.keys(pkg.dependencies).join(", ")}`);
+  }
+
+  const src = run("ls -1 src/ 2>/dev/null || ls -1 lib/ 2>/dev/null");
+  if (src) console.log(`\nSource:\n${src.split("\n").map(f => "  " + f).join("\n")}`);
+}
+
 // ── Repo command ─────────────────────────────────────────────────────────────
 
 else if (args[0] === "repo") {

package/src/loop-detector.ts

@@ -0,0 +1,96 @@
+// Edit-test loop detector — detects repetitive test→edit→test patterns
+// and suggests narrowing to specific test files
+
+interface CommandRecord {
+  command: string;
+  timestamp: number;
+}
+
+const history: CommandRecord[] = [];
+const MAX_HISTORY = 20;
+
+// Detect test commands
+const TEST_PATTERNS = [
+  /\bbun\s+test\b/, /\bnpm\s+test\b/, /\bnpx\s+jest\b/, /\bnpx\s+vitest\b/,
+  /\bpnpm\s+test\b/, /\byarn\s+test\b/, /\bpytest\b/, /\bgo\s+test\b/,
+  /\bcargo\s+test\b/, /\brspec\b/, /\bphpunit\b/, /\bmocha\b/,
+];
+
+function isTestCommand(cmd: string): boolean {
+  return TEST_PATTERNS.some(p => p.test(cmd));
+}
+
+function isFullSuiteCommand(cmd: string): boolean {
+  // Full suite = test command without specific file/pattern
+  if (!isTestCommand(cmd)) return false;
+  // If it has a specific file or --grep, it's already narrowed
+  if (/\.(test|spec)\.(ts|tsx|js|jsx|py|rs|go)/.test(cmd)) return false;
+  if (/--grep|--filter|-t\s/.test(cmd)) return false;
+  return true;
+}
+
+export interface LoopContext {
+  detected: boolean;
+  iteration: number;
+  testCommand: string;
+  suggestedNarrow?: string;
+  reason?: string;
+}
+
+/** Record a command execution and detect loops */
+export function detectLoop(command: string): LoopContext {
+  history.push({ command, timestamp: Date.now() });
+  if (history.length > MAX_HISTORY) history.shift();
+
+  if (!isTestCommand(command)) {
+    return { detected: false, iteration: 0, testCommand: command };
+  }
+
+  // Count consecutive test runs (allowing non-test commands between them)
+  let testCount = 0;
+  for (let i = history.length - 1; i >= 0; i--) {
+    if (isTestCommand(history[i].command)) testCount++;
+    // If we hit a non-test, non-edit command, stop counting
+    // (edits are invisible to us since we only see exec'd commands)
+  }
+
+  if (testCount < 3 || !isFullSuiteCommand(command)) {
+    return { detected: false, iteration: testCount, testCommand: command };
+  }
+
+  // Detected loop — suggest narrowing
+  // Try to find a recently-mentioned test file in recent commands
+  let suggestedNarrow: string | undefined;
+
+  // Look for file paths in recent history that could be test targets
+  for (let i = history.length - 2; i >= Math.max(0, history.length - 10); i--) {
+    const cmd = history[i].command;
+    // Look for edited/touched files
+    const fileMatch = cmd.match(/(\S+\.(ts|tsx|js|jsx|py|rs|go))\b/);
+    if (fileMatch && !isTestCommand(cmd)) {
+      const file = fileMatch[1];
+      // Suggest corresponding test file
+      const testFile = file.replace(/\.(ts|tsx|js|jsx)$/, ".test.$1");
+      suggestedNarrow = command.replace(/\b(test)\b/, `test ${testFile}`);
+      break;
+    }
+  }
+
+  // Fallback: suggest adding --grep or specific file
+  if (!suggestedNarrow) {
+    suggestedNarrow = undefined; // Can't determine which file
+  }
+
+  return {
+    detected: true,
+    iteration: testCount,
+    testCommand: command,
+    suggestedNarrow,
+    reason: `Full test suite run ${testCount} times. Consider narrowing to specific test file.`,
+  };
+}
+
+/** Reset loop detection (e.g., on session start) */
+export function resetLoopDetector(): void {
+  history.length = 0;
+}

package/src/mcp/server.ts

@@ -587,6 +587,69 @@ export function createServer(): McpServer {
     }
   );
 
+  // ── project_overview: orient agent in one call ─────────────────────────────
+
+  server.tool(
+    "project_overview",
+    "Get project overview in one call — package.json info, source structure, config files. Replaces: cat package.json + ls src/ + cat tsconfig.json.",
+    {
+      path: z.string().optional().describe("Project root (default: cwd)"),
+    },
+    async ({ path }) => {
+      const cwd = path ?? process.cwd();
+      const [pkgResult, srcResult, configResult] = await Promise.all([
+        exec("cat package.json 2>/dev/null", cwd),
+        exec("ls -1 src/ 2>/dev/null || ls -1 lib/ 2>/dev/null || ls -1 app/ 2>/dev/null", cwd),
+        exec("ls -1 *.json *.config.* .env* tsconfig* 2>/dev/null", cwd),
+      ]);
+
+      let pkg: any = null;
+      try { pkg = JSON.parse(pkgResult.stdout); } catch {}
+
+      return {
+        content: [{ type: "text" as const, text: JSON.stringify({
+          name: pkg?.name,
+          version: pkg?.version,
+          scripts: pkg?.scripts,
+          dependencies: pkg?.dependencies ? Object.keys(pkg.dependencies) : [],
+          devDependencies: pkg?.devDependencies ? Object.keys(pkg.devDependencies) : [],
+          sourceFiles: srcResult.stdout.split("\n").filter(l => l.trim()),
+          configFiles: configResult.stdout.split("\n").filter(l => l.trim()),
+        }) }],
+      };
+    }
+  );
+
+  // ── last_commit: what just happened ───────────────────────────────────────
+
+  server.tool(
+    "last_commit",
+    "Get details of the last commit — hash, message, files changed, diff stats. Replaces: git log -1 + git show --stat + git diff HEAD~1.",
+    {
+      path: z.string().optional().describe("Repo path (default: cwd)"),
+    },
+    async ({ path }) => {
+      const cwd = path ?? process.cwd();
+      const [logResult, statResult] = await Promise.all([
+        exec("git log -1 --format='%H%n%s%n%an%n%ai'", cwd),
+        exec("git show --stat --format='' HEAD", cwd),
+      ]);
+
+      const [hash, message, author, date] = logResult.stdout.split("\n");
+      const filesChanged = statResult.stdout.split("\n").filter(l => l.trim() && !l.includes("changed"));
+
+      return {
+        content: [{ type: "text" as const, text: JSON.stringify({
+          hash: hash?.trim(),
+          message: message?.trim(),
+          author: author?.trim(),
+          date: date?.trim(),
+          filesChanged,
+        }) }],
+      };
+    }
+  );
+
   // ── read_file: cached file reading ─────────────────────────────────────────
 
   server.tool(