@hasna/terminal 3.7.3 → 3.8.0

package/dist/mcp/server.js

@@ -436,7 +436,13 @@ export function createServer() {
     // ── boot: session start context (replaces first 5 agent commands) ──────────
     server.tool("boot", "Get everything an agent needs on session start in ONE call — git state, project info, source structure. Replaces: git status + git log + cat package.json + ls src/. Cached for the session.", async () => {
         const ctx = await getBootContext(process.cwd());
-        return { content: [{ type: "text", text: JSON.stringify(ctx) }] };
+        return { content: [{ type: "text", text: JSON.stringify({
+                        ...ctx,
+                        hints: {
+                            cwd: process.cwd(),
+                            tip: "All terminal tools support relative paths. Use 'src/foo.ts' not the full absolute path. Use commit({message, push:true}) instead of raw git commands. Use run({task:'test'}) instead of bun/npm test. Use lookup({file, items}) instead of grep pipelines.",
+                        },
+                    }) }] };
     });
     // ── 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.", {
@@ -782,6 +788,74 @@ Match by function name, class name, method name (including ClassName.method), in
             return { content: [{ type: "text", text: JSON.stringify({ error: e.message }) }] };
         }
     });
+    server.tool("smart_commit", "AI-powered git commit. Analyzes all changes, groups into logical commits with generated messages, stages and commits each group, optionally pushes. One call replaces the entire git workflow. Agent just says 'commit my work'.", {
+        push: z.boolean().optional().describe("Push after all commits (default: true)"),
+        hint: z.string().optional().describe("Optional context about the changes (e.g., 'fixed auth + added users endpoint')"),
+        cwd: z.string().optional().describe("Working directory"),
+    }, async ({ push, hint, cwd }) => {
+        const start = Date.now();
+        const workDir = cwd ?? process.cwd();
+        // 1. Get all changed files
+        const status = await exec("git status --porcelain", workDir, 10000);
+        const diffStat = await exec("git diff --stat", workDir, 10000);
+        const untrackedDiff = await exec("git diff HEAD --stat", workDir, 10000);
+        const changedFiles = status.stdout.trim();
+        if (!changedFiles) {
+            return { content: [{ type: "text", text: JSON.stringify({ message: "Nothing to commit — working tree clean" }) }] };
+        }
+        // 2. AI groups changes into logical commits
+        const provider = getOutputProvider();
+        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+        const grouping = await provider.complete(`Changed files:\n${changedFiles}\n\nDiff stats:\n${diffStat.stdout}\n${untrackedDiff.stdout}${hint ? `\n\nContext: ${hint}` : ""}`, {
+            model: outputModel,
+            system: `You are a git commit assistant. Group these changed files into logical commits. Return ONLY a JSON array:
+
+[{"message": "conventional commit message", "files": ["file1.ts", "file2.ts"]}]
+
+Rules:
+- Group related changes (same feature, same fix, same refactor)
+- Use conventional commits: feat:, fix:, refactor:, test:, docs:, chore:
+- Message should explain WHY, not WHAT (the diff shows what)
+- Each file appears in exactly one group
+- If all changes are related, use a single commit
+- Extract file paths from the status output (skip the status prefix like M, A, ??)`,
+            maxTokens: 1000,
+            temperature: 0,
+        });
+        let commits = [];
+        try {
+            const jsonMatch = grouping.match(/\[[\s\S]*\]/);
+            if (jsonMatch)
+                commits = JSON.parse(jsonMatch[0]);
+        }
+        catch { }
+        if (commits.length === 0) {
+            // Fallback: single commit with all files
+            commits = [{ message: hint ?? "chore: update files", files: changedFiles.split("\n").map(l => l.slice(3).trim()) }];
+        }
+        // 3. Execute each commit
+        const results = [];
+        for (const c of commits) {
+            const fileArgs = c.files.map(f => `"${f}"`).join(" ");
+            const cmd = `git add ${fileArgs} && git commit -m ${JSON.stringify(c.message)}`;
+            const r = await exec(cmd, workDir, 15000);
+            results.push({ message: c.message, files: c.files.length, ok: r.exitCode === 0 });
+        }
+        // 4. Push if requested
+        let pushed = false;
+        if (push !== false) {
+            const pushResult = await exec("git push", workDir, 30000);
+            pushed = pushResult.exitCode === 0;
+        }
+        invalidateBootCache();
+        logCall("smart_commit", { command: `${commits.length} commits`, durationMs: Date.now() - start, aiProcessed: true });
+        return { content: [{ type: "text", text: JSON.stringify({
+                        commits: results,
+                        pushed,
+                        total: results.length,
+                        ok: results.every(r => r.ok),
+                    }) }] };
+    });
     return server;
 }
 // ── main: start MCP server via stdio ─────────────────────────────────────────

package/package.json

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

package/src/mcp/server.ts

@@ -615,7 +615,13 @@ export function createServer(): McpServer {
     "Get everything an agent needs on session start in ONE call — git state, project info, source structure. Replaces: git status + git log + cat package.json + ls src/. Cached for the session.",
     async () => {
       const ctx = await getBootContext(process.cwd());
-      return { content: [{ type: "text" as const, text: JSON.stringify(ctx) }] };
+      return { content: [{ type: "text" as const, text: JSON.stringify({
+        ...ctx,
+        hints: {
+          cwd: process.cwd(),
+          tip: "All terminal tools support relative paths. Use 'src/foo.ts' not the full absolute path. Use commit({message, push:true}) instead of raw git commands. Use run({task:'test'}) instead of bun/npm test. Use lookup({file, items}) instead of grep pipelines.",
+        },
+      }) }] };
     }
   );
 
@@ -1043,6 +1049,91 @@ Match by function name, class name, method name (including ClassName.method), in
     }
   );
 
+  server.tool(
+    "smart_commit",
+    "AI-powered git commit. Analyzes all changes, groups into logical commits with generated messages, stages and commits each group, optionally pushes. One call replaces the entire git workflow. Agent just says 'commit my work'.",
+    {
+      push: z.boolean().optional().describe("Push after all commits (default: true)"),
+      hint: z.string().optional().describe("Optional context about the changes (e.g., 'fixed auth + added users endpoint')"),
+      cwd: z.string().optional().describe("Working directory"),
+    },
+    async ({ push, hint, cwd }) => {
+      const start = Date.now();
+      const workDir = cwd ?? process.cwd();
+
+      // 1. Get all changed files
+      const status = await exec("git status --porcelain", workDir, 10000);
+      const diffStat = await exec("git diff --stat", workDir, 10000);
+      const untrackedDiff = await exec("git diff HEAD --stat", workDir, 10000);
+
+      const changedFiles = status.stdout.trim();
+      if (!changedFiles) {
+        return { content: [{ type: "text" as const, text: JSON.stringify({ message: "Nothing to commit — working tree clean" }) }] };
+      }
+
+      // 2. AI groups changes into logical commits
+      const provider = getOutputProvider();
+      const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+
+      const grouping = await provider.complete(
+        `Changed files:\n${changedFiles}\n\nDiff stats:\n${diffStat.stdout}\n${untrackedDiff.stdout}${hint ? `\n\nContext: ${hint}` : ""}`,
+        {
+          model: outputModel,
+          system: `You are a git commit assistant. Group these changed files into logical commits. Return ONLY a JSON array:
+
+[{"message": "conventional commit message", "files": ["file1.ts", "file2.ts"]}]
+
+Rules:
+- Group related changes (same feature, same fix, same refactor)
+- Use conventional commits: feat:, fix:, refactor:, test:, docs:, chore:
+- Message should explain WHY, not WHAT (the diff shows what)
+- Each file appears in exactly one group
+- If all changes are related, use a single commit
+- Extract file paths from the status output (skip the status prefix like M, A, ??)`,
+          maxTokens: 1000,
+          temperature: 0,
+        }
+      );
+
+      let commits: { message: string; files: string[] }[] = [];
+      try {
+        const jsonMatch = grouping.match(/\[[\s\S]*\]/);
+        if (jsonMatch) commits = JSON.parse(jsonMatch[0]);
+      } catch {}
+
+      if (commits.length === 0) {
+        // Fallback: single commit with all files
+        commits = [{ message: hint ?? "chore: update files", files: changedFiles.split("\n").map(l => l.slice(3).trim()) }];
+      }
+
+      // 3. Execute each commit
+      const results: { message: string; files: number; ok: boolean }[] = [];
+      for (const c of commits) {
+        const fileArgs = c.files.map(f => `"${f}"`).join(" ");
+        const cmd = `git add ${fileArgs} && git commit -m ${JSON.stringify(c.message)}`;
+        const r = await exec(cmd, workDir, 15000);
+        results.push({ message: c.message, files: c.files.length, ok: r.exitCode === 0 });
+      }
+
+      // 4. Push if requested
+      let pushed = false;
+      if (push !== false) {
+        const pushResult = await exec("git push", workDir, 30000);
+        pushed = pushResult.exitCode === 0;
+      }
+
+      invalidateBootCache();
+      logCall("smart_commit", { command: `${commits.length} commits`, durationMs: Date.now() - start, aiProcessed: true });
+
+      return { content: [{ type: "text" as const, text: JSON.stringify({
+        commits: results,
+        pushed,
+        total: results.length,
+        ok: results.every(r => r.ok),
+      }) }] };
+    }
+  );
+
   return server;
 }