@hasna/terminal 2.3.2 → 3.1.0

package/src/parsers/base.ts

@@ -1,72 +0,0 @@
-// Base types for output parsers
-
-export interface Parser<T = unknown> {
-  /** Name of this parser */
-  readonly name: string;
-
-  /** Test if this parser can handle the given command/output */
-  detect(command: string, output: string): boolean;
-
-  /** Parse the output into structured data */
-  parse(command: string, output: string): T;
-}
-
-export interface FileEntry {
-  name: string;
-  type: "file" | "dir" | "symlink" | "other";
-  size?: number;
-  modified?: string;
-  permissions?: string;
-}
-
-export interface TestResult {
-  passed: number;
-  failed: number;
-  skipped: number;
-  total: number;
-  duration?: string;
-  failures: { test: string; error: string }[];
-}
-
-export interface GitLogEntry {
-  hash: string;
-  author: string;
-  date: string;
-  message: string;
-}
-
-export interface GitStatus {
-  branch: string;
-  staged: string[];
-  unstaged: string[];
-  untracked: string[];
-}
-
-export interface BuildResult {
-  status: "success" | "failure";
-  warnings: number;
-  errors: number;
-  duration?: string;
-  output?: string;
-}
-
-export interface NpmInstallResult {
-  installed: number;
-  duration?: string;
-  vulnerabilities: number;
-}
-
-export interface ErrorInfo {
-  type: string;
-  message: string;
-  file?: string;
-  line?: number;
-  suggestion?: string;
-}
-
-export interface SearchResult {
-  total: number;
-  source: FileEntry[];
-  other: FileEntry[];
-  filtered: { count: number; reason: string }[];
-}

package/src/parsers/build.ts

@@ -1,73 +0,0 @@
-// Parser for build output (npm/bun/pnpm build, tsc, webpack, vite, etc.)
-
-import type { Parser, BuildResult, NpmInstallResult } from "./base.js";
-
-export const buildParser: Parser<BuildResult> = {
-  name: "build",
-
-  detect(command: string, output: string): boolean {
-    if (/\b(npm|bun|pnpm|yarn)\s+(run\s+)?build\b/.test(command)) return true;
-    if (/\btsc\b/.test(command)) return true;
-    if (/\b(webpack|vite|esbuild|rollup|turbo)\b/.test(command)) return true;
-    return /\b(compiled|bundled|built)\b/i.test(output) && /\b(success|error|warning)\b/i.test(output);
-  },
-
-  parse(_command: string, output: string): BuildResult {
-    const lines = output.split("\n");
-    let warnings = 0, errors = 0, duration: string | undefined;
-
-    // Count warnings and errors
-    for (const line of lines) {
-      if (/\bwarning\b/i.test(line)) warnings++;
-      if (/\berror\b/i.test(line) && !/0 errors/.test(line)) errors++;
-    }
-
-    // Specific patterns
-    const tscErrors = output.match(/Found (\d+) error/);
-    if (tscErrors) errors = parseInt(tscErrors[1]);
-
-    const warningCount = output.match(/(\d+)\s+warning/);
-    if (warningCount) warnings = parseInt(warningCount[1]);
-
-    // Duration
-    const timeMatch = output.match(/(?:in|took)\s+([\d.]+\s*(?:s|ms|m))/i) ||
-      output.match(/Done in ([\d.]+s)/);
-    if (timeMatch) duration = timeMatch[1];
-
-    const status: "success" | "failure" = errors > 0 ? "failure" : "success";
-
-    return { status, warnings, errors, duration };
-  },
-};
-
-export const npmInstallParser: Parser<NpmInstallResult> = {
-  name: "npm-install",
-
-  detect(command: string, _output: string): boolean {
-    return /\b(npm|bun|pnpm|yarn)\s+(install|add|i)\b/.test(command);
-  },
-
-  parse(_command: string, output: string): NpmInstallResult {
-    let installed = 0, vulnerabilities = 0, duration: string | undefined;
-
-    // npm: added 47 packages in 3.2s
-    const npmMatch = output.match(/added\s+(\d+)\s+packages?\s+in\s+([\d.]+s)/);
-    if (npmMatch) {
-      installed = parseInt(npmMatch[1]);
-      duration = npmMatch[2];
-    }
-
-    // bun: 47 packages installed [1.2s]
-    const bunMatch = output.match(/(\d+)\s+packages?\s+installed.*?\[([\d.]+[ms]*s)\]/);
-    if (!npmMatch && bunMatch) {
-      installed = parseInt(bunMatch[1]);
-      duration = bunMatch[2];
-    }
-
-    // Vulnerabilities
-    const vulnMatch = output.match(/(\d+)\s+vulnerabilit/);
-    if (vulnMatch) vulnerabilities = parseInt(vulnMatch[1]);
-
-    return { installed, vulnerabilities, duration };
-  },
-};

package/src/parsers/errors.ts

@@ -1,107 +0,0 @@
-// Parser for common error patterns
-
-import type { Parser, ErrorInfo } from "./base.js";
-
-const ERROR_PATTERNS: { type: string; pattern: RegExp; extract: (m: RegExpMatchArray, output: string) => ErrorInfo }[] = [
-  {
-    type: "port_in_use",
-    pattern: /EADDRINUSE.*?(?::(\d+))|port\s+(\d+)\s+(?:is\s+)?(?:already\s+)?in\s+use/i,
-    extract: (m) => ({
-      type: "port_in_use",
-      message: m[0],
-      suggestion: `Kill the process: lsof -i :${m[1] ?? m[2]} -t | xargs kill`,
-    }),
-  },
-  {
-    type: "file_not_found",
-    pattern: /ENOENT.*?'([^']+)'|No such file or directory:\s*(.+)/,
-    extract: (m) => ({
-      type: "file_not_found",
-      message: m[0],
-      file: m[1] ?? m[2]?.trim(),
-      suggestion: "Check the file path exists",
-    }),
-  },
-  {
-    type: "permission_denied",
-    pattern: /EACCES.*?'([^']+)'|Permission denied:\s*(.+)/,
-    extract: (m) => ({
-      type: "permission_denied",
-      message: m[0],
-      file: m[1] ?? m[2]?.trim(),
-      suggestion: "Check file permissions or run with sudo",
-    }),
-  },
-  {
-    type: "command_not_found",
-    pattern: /command not found:\s*(\S+)|(\S+):\s*not found/,
-    extract: (m) => ({
-      type: "command_not_found",
-      message: m[0],
-      suggestion: `Install ${m[1] ?? m[2]} or check your PATH`,
-    }),
-  },
-  {
-    type: "dependency_missing",
-    pattern: /Cannot find module\s+'([^']+)'|Module not found.*?'([^']+)'/,
-    extract: (m) => ({
-      type: "dependency_missing",
-      message: m[0],
-      suggestion: `Install: npm install ${m[1] ?? m[2]}`,
-    }),
-  },
-  {
-    type: "syntax_error",
-    pattern: /SyntaxError:\s*(.+)|error TS\d+:\s*(.+)/,
-    extract: (m, output) => {
-      const fileMatch = output.match(/(\S+\.\w+):(\d+)/);
-      return {
-        type: "syntax_error",
-        message: m[1] ?? m[2] ?? m[0],
-        file: fileMatch?.[1],
-        line: fileMatch ? parseInt(fileMatch[2]) : undefined,
-        suggestion: "Fix the syntax error in the referenced file",
-      };
-    },
-  },
-  {
-    type: "out_of_memory",
-    pattern: /ENOMEM|JavaScript heap out of memory|Killed/,
-    extract: (m) => ({
-      type: "out_of_memory",
-      message: m[0],
-      suggestion: "Increase memory: NODE_OPTIONS=--max-old-space-size=4096",
-    }),
-  },
-  {
-    type: "network_error",
-    pattern: /ECONNREFUSED|ENOTFOUND|ETIMEDOUT|fetch failed/,
-    extract: (m) => ({
-      type: "network_error",
-      message: m[0],
-      suggestion: "Check network connection and target URL/host",
-    }),
-  },
-];
-
-export const errorParser: Parser<ErrorInfo> = {
-  name: "error",
-
-  detect(_command: string, output: string): boolean {
-    return ERROR_PATTERNS.some(({ pattern }) => pattern.test(output));
-  },
-
-  parse(_command: string, output: string): ErrorInfo {
-    for (const { pattern, extract } of ERROR_PATTERNS) {
-      const match = output.match(pattern);
-      if (match) return extract(match, output);
-    }
-
-    // Generic error fallback
-    const errorLine = output.split("\n").find(l => /error/i.test(l));
-    return {
-      type: "unknown",
-      message: errorLine?.trim() ?? "Unknown error",
-    };
-  },
-};

package/src/parsers/files.ts

@@ -1,91 +0,0 @@
-// Parser for file listing output (ls -la, find, etc.)
-
-import type { Parser, FileEntry, SearchResult } from "./base.js";
-
-const NODE_MODULES_RE = /node_modules/;
-const DIST_RE = /\b(dist|build|\.next|__pycache__|coverage|\.git)\b/;
-const SOURCE_EXTS = /\.(ts|tsx|js|jsx|py|go|rs|java|rb|sh|c|cpp|h|css|scss|html|vue|svelte|md|json|yaml|yml|toml)$/;
-
-export const lsParser: Parser<FileEntry[]> = {
-  name: "ls",
-
-  detect(command: string, output: string): boolean {
-    return /^\s*(ls|ll|la)\b/.test(command) && output.includes(" ");
-  },
-
-  parse(_command: string, output: string): FileEntry[] {
-    const lines = output.split("\n").filter(l => l.trim());
-    const entries: FileEntry[] = [];
-
-    for (const line of lines) {
-      // ls -la format: drwxr-xr-x  5 user group 160 Mar 10 09:00 dirname
-      const match = line.match(/^([dlcbps-])([rwxsStT-]{9})\s+\d+\s+\S+\s+\S+\s+(\d+)\s+(\w+\s+\d+\s+[\d:]+)\s+(.+)$/);
-      if (match) {
-        const typeChar = match[1];
-        entries.push({
-          name: match[5],
-          type: typeChar === "d" ? "dir" : typeChar === "l" ? "symlink" : "file",
-          size: parseInt(match[3]),
-          modified: match[4],
-          permissions: match[1] + match[2],
-        });
-      } else if (line.trim() && !line.startsWith("total ")) {
-        // Simple ls output — just filenames
-        entries.push({ name: line.trim(), type: "file" });
-      }
-    }
-
-    return entries;
-  },
-};
-
-export const findParser: Parser<SearchResult> = {
-  name: "find",
-
-  detect(command: string, _output: string): boolean {
-    return /^\s*(find|fd)\b/.test(command);
-  },
-
-  parse(_command: string, output: string): SearchResult {
-    const lines = output.split("\n").filter(l => l.trim());
-    const source: FileEntry[] = [];
-    const other: FileEntry[] = [];
-    let nodeModulesCount = 0;
-    let distCount = 0;
-
-    for (const line of lines) {
-      const path = line.trim();
-      if (!path) continue;
-
-      if (NODE_MODULES_RE.test(path)) {
-        nodeModulesCount++;
-        continue;
-      }
-
-      if (DIST_RE.test(path)) {
-        distCount++;
-        continue;
-      }
-
-      const name = path.split("/").pop() ?? path;
-      const entry: FileEntry = { name: path, type: SOURCE_EXTS.test(name) ? "file" : "other" };
-
-      if (SOURCE_EXTS.test(name)) {
-        source.push(entry);
-      } else {
-        other.push(entry);
-      }
-    }
-
-    const filtered: { count: number; reason: string }[] = [];
-    if (nodeModulesCount > 0) filtered.push({ count: nodeModulesCount, reason: "node_modules" });
-    if (distCount > 0) filtered.push({ count: distCount, reason: "dist/build" });
-
-    return {
-      total: lines.length,
-      source,
-      other,
-      filtered,
-    };
-  },
-};

package/src/parsers/git.ts

@@ -1,101 +0,0 @@
-// Parsers for git output (log, status, diff)
-
-import type { Parser, GitLogEntry, GitStatus } from "./base.js";
-
-export const gitLogParser: Parser<GitLogEntry[]> = {
-  name: "git-log",
-
-  detect(command: string, _output: string): boolean {
-    return /\bgit\s+log\b/.test(command);
-  },
-
-  parse(_command: string, output: string): GitLogEntry[] {
-    const entries: GitLogEntry[] = [];
-    const lines = output.split("\n");
-
-    // Detect oneline format: "abc1234 commit message"
-    const firstLine = lines[0]?.trim() ?? "";
-    const isOneline = /^[a-f0-9]{7,12}\s+/.test(firstLine) && !firstLine.startsWith("commit ");
-
-    if (isOneline) {
-      for (const line of lines) {
-        const match = line.trim().match(/^([a-f0-9]{7,12})\s+(.+)$/);
-        if (match) {
-          entries.push({ hash: match[1], author: "", date: "", message: match[2] });
-        }
-      }
-      return entries;
-    }
-
-    // Verbose format
-    let hash = "", author = "", date = "", message: string[] = [];
-
-    for (const line of lines) {
-      const commitMatch = line.match(/^commit\s+([a-f0-9]+)/);
-      if (commitMatch) {
-        if (hash) {
-          entries.push({ hash: hash.slice(0, 8), author, date, message: message.join(" ").trim() });
-        }
-        hash = commitMatch[1];
-        author = ""; date = ""; message = [];
-        continue;
-      }
-
-      const authorMatch = line.match(/^Author:\s+(.+)/);
-      if (authorMatch) { author = authorMatch[1]; continue; }
-
-      const dateMatch = line.match(/^Date:\s+(.+)/);
-      if (dateMatch) { date = dateMatch[1].trim(); continue; }
-
-      if (line.startsWith("    ")) {
-        message.push(line.trim());
-      }
-    }
-
-    if (hash) {
-      entries.push({ hash: hash.slice(0, 8), author, date, message: message.join(" ").trim() });
-    }
-
-    return entries;
-  },
-};
-
-export const gitStatusParser: Parser<GitStatus> = {
-  name: "git-status",
-
-  detect(command: string, _output: string): boolean {
-    return /\bgit\s+status\b/.test(command);
-  },
-
-  parse(_command: string, output: string): GitStatus {
-    const lines = output.split("\n");
-    let branch = "";
-    const staged: string[] = [];
-    const unstaged: string[] = [];
-    const untracked: string[] = [];
-
-    const branchMatch = output.match(/On branch\s+(\S+)/);
-    if (branchMatch) branch = branchMatch[1];
-
-    let section = "";
-    for (const line of lines) {
-      if (line.includes("Changes to be committed")) { section = "staged"; continue; }
-      if (line.includes("Changes not staged")) { section = "unstaged"; continue; }
-      if (line.includes("Untracked files")) { section = "untracked"; continue; }
-
-      const fileMatch = line.match(/^\s+(?:new file|modified|deleted|renamed):\s+(.+)/);
-      if (fileMatch) {
-        if (section === "staged") staged.push(fileMatch[1].trim());
-        else if (section === "unstaged") unstaged.push(fileMatch[1].trim());
-        continue;
-      }
-
-      // Untracked files are just indented filenames
-      if (section === "untracked" && line.match(/^\s+\S/) && !line.includes("(use ")) {
-        untracked.push(line.trim());
-      }
-    }
-
-    return { branch, staged, unstaged, untracked };
-  },
-};

package/src/parsers/index.ts

@@ -1,66 +0,0 @@
-// Output parser registry — auto-detect command output type and parse to structured JSON
-
-import type { Parser } from "./base.js";
-import { lsParser, findParser } from "./files.js";
-import { testParser } from "./tests.js";
-import { gitLogParser, gitStatusParser } from "./git.js";
-import { buildParser, npmInstallParser } from "./build.js";
-import { errorParser } from "./errors.js";
-
-export type { Parser } from "./base.js";
-export type {
-  FileEntry, TestResult, GitLogEntry, GitStatus,
-  BuildResult, NpmInstallResult, ErrorInfo, SearchResult,
-} from "./base.js";
-
-// Ordered by specificity — more specific parsers first
-const parsers: Parser[] = [
-  npmInstallParser,
-  testParser,
-  gitLogParser,
-  gitStatusParser,
-  buildParser,
-  findParser,
-  lsParser,
-  errorParser, // fallback for error detection
-];
-
-export interface ParseResult {
-  parser: string;
-  data: unknown;
-  raw: string;
-}
-
-/** Try to parse command output with the best matching parser */
-export function parseOutput(command: string, output: string): ParseResult | null {
-  for (const parser of parsers) {
-    if (parser.detect(command, output)) {
-      try {
-        const data = parser.parse(command, output);
-        return { parser: parser.name, data, raw: output };
-      } catch {
-        continue;
-      }
-    }
-  }
-  return null;
-}
-
-/** Get all parsers that match (for debugging/info) */
-export function detectParsers(command: string, output: string): string[] {
-  return parsers.filter(p => p.detect(command, output)).map(p => p.name);
-}
-
-/** Estimate token count for a string (rough: ~4 chars per token) */
-export function estimateTokens(text: string): number {
-  return Math.ceil(text.length / 4);
-}
-
-/** Calculate token savings between raw output and parsed JSON */
-export function tokenSavings(raw: string, parsed: unknown): { rawTokens: number; parsedTokens: number; saved: number; percent: number } {
-  const rawTokens = estimateTokens(raw);
-  const parsedTokens = estimateTokens(JSON.stringify(parsed));
-  const saved = Math.max(0, rawTokens - parsedTokens);
-  const percent = rawTokens > 0 ? Math.round((saved / rawTokens) * 100) : 0;
-  return { rawTokens, parsedTokens, saved, percent };
-}

package/src/parsers/parsers.test.ts

@@ -1,153 +0,0 @@
-import { describe, it, expect } from "bun:test";
-import { parseOutput, tokenSavings, estimateTokens } from "./index.js";
-
-describe("parseOutput", () => {
-  it("parses ls -la output", () => {
-    const output = `total 32
-drwxr-xr-x  5 user staff  160 Mar 10 09:00 src
--rw-r--r--  1 user staff  450 Mar 10 09:00 package.json
-lrwxr-xr-x  1 user staff   20 Mar 10 09:00 link -> target`;
-
-    const result = parseOutput("ls -la", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("ls");
-    const data = result!.data as any[];
-    expect(data.length).toBe(3);
-    expect(data[0].name).toBe("src");
-    expect(data[0].type).toBe("dir");
-    expect(data[1].name).toBe("package.json");
-    expect(data[1].type).toBe("file");
-    expect(data[2].type).toBe("symlink");
-  });
-
-  it("parses find output and filters node_modules", () => {
-    const output = `./src/lib/webhooks.ts
-./node_modules/@types/node/async_hooks.d.ts
-./node_modules/@types/node/perf_hooks.d.ts
-./dist/lib/webhooks.d.ts
-./src/routes/api.ts`;
-
-    const result = parseOutput("find . -name '*hooks*' -type f", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("find");
-    const data = result!.data as any;
-    expect(data.source.length).toBe(2); // webhooks.ts and api.ts
-    expect(data.filtered.length).toBeGreaterThan(0);
-    expect(data.filtered.find((f: any) => f.reason === "node_modules")?.count).toBe(2);
-  });
-
-  it("parses test output (jest style)", () => {
-    const output = `PASS src/auth.test.ts
-FAIL src/db.test.ts
-  ✗ should connect to database
-    Error: Connection refused
-Tests: 5 passed, 1 failed, 1 skipped, 7 total
-Time: 3.2s`;
-
-    const result = parseOutput("npm test", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("test");
-    const data = result!.data as any;
-    expect(data.passed).toBe(5);
-    expect(data.failed).toBe(1);
-    expect(data.skipped).toBe(1);
-    expect(data.total).toBe(7);
-  });
-
-  it("parses git status", () => {
-    const output = `On branch main
-Changes to be committed:
-  new file:   src/mcp/server.ts
-  modified:   src/ai.ts
-
-Changes not staged for commit:
-  modified:   package.json
-
-Untracked files:
-  src/tree.ts`;
-
-    const result = parseOutput("git status", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("git-status");
-    const data = result!.data as any;
-    expect(data.branch).toBe("main");
-    expect(data.staged.length).toBe(2);
-    expect(data.unstaged.length).toBe(1);
-    expect(data.untracked.length).toBe(1);
-  });
-
-  it("parses git log", () => {
-    const output = `commit af19ce3456789
-Author: Andrei Hasna <andrei@hasna.com>
-Date:   Sat Mar 15 10:00:00 2026
-
-    feat: add MCP server
-
-commit 3963db5123456
-Author: Andrei Hasna <andrei@hasna.com>
-Date:   Fri Mar 14 09:00:00 2026
-
-    feat: tabs and browse mode`;
-
-    const result = parseOutput("git log", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("git-log");
-    const data = result!.data as any[];
-    expect(data.length).toBe(2);
-    expect(data[0].hash).toBe("af19ce34");
-    expect(data[0].message).toBe("feat: add MCP server");
-  });
-
-  it("parses npm install output", () => {
-    const output = `added 47 packages in 3.2s
-2 vulnerabilities found`;
-
-    const result = parseOutput("npm install", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("npm-install");
-    const data = result!.data as any;
-    expect(data.installed).toBe(47);
-    expect(data.duration).toBe("3.2s");
-    expect(data.vulnerabilities).toBe(2);
-  });
-
-  it("parses build output", () => {
-    const output = `Compiling...
-1 warning
-Found 0 errors
-Done in 2.5s`;
-
-    const result = parseOutput("npm run build", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("build");
-    const data = result!.data as any;
-    expect(data.status).toBe("success");
-    expect(data.warnings).toBe(1);
-  });
-
-  it("detects errors", () => {
-    const output = `Error: EADDRINUSE: address already in use :3000`;
-    const result = parseOutput("node server.js", output);
-    expect(result).not.toBeNull();
-    expect(result!.parser).toBe("error");
-    const data = result!.data as any;
-    expect(data.type).toBe("port_in_use");
-  });
-});
-
-describe("estimateTokens", () => {
-  it("estimates roughly 4 chars per token", () => {
-    expect(estimateTokens("hello world")).toBe(3); // 11 chars / 4 = 2.75 → 3
-  });
-});
-
-describe("tokenSavings", () => {
-  it("calculates savings correctly", () => {
-    const raw = "a".repeat(400); // 100 tokens
-    const parsed = { status: "ok" };
-    const result = tokenSavings(raw, parsed);
-    expect(result.rawTokens).toBe(100);
-    expect(result.saved).toBeGreaterThan(0);
-    expect(result.percent).toBeGreaterThan(0);
-  });
-});