@hasna/terminal 0.7.5 → 0.7.6

package/dist/cli.js

@@ -458,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/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.5",
+  "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

@@ -443,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/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(