tmux-team 1.1.0 → 2.0.0-alpha.3

package/src/tmux.ts

@@ -0,0 +1,27 @@
+// ─────────────────────────────────────────────────────────────
+// Pure tmux wrapper - send-keys, capture-pane
+// ─────────────────────────────────────────────────────────────
+
+import { execSync } from 'child_process';
+import type { Tmux } from './types.js';
+
+export function createTmux(): Tmux {
+  return {
+    send(paneId: string, message: string): void {
+      execSync(`tmux send-keys -t "${paneId}" ${JSON.stringify(message)}`, {
+        stdio: 'pipe',
+      });
+      execSync(`tmux send-keys -t "${paneId}" Enter`, {
+        stdio: 'pipe',
+      });
+    },
+
+    capture(paneId: string, lines: number): string {
+      const output = execSync(`tmux capture-pane -t "${paneId}" -p -S -${lines}`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      return output;
+    },
+  };
+}

package/src/types.ts

@@ -0,0 +1,97 @@
+// ─────────────────────────────────────────────────────────────
+// Shared TypeScript interfaces for tmux-team
+// ─────────────────────────────────────────────────────────────
+
+export interface AgentConfig {
+  preamble?: string;
+  deny?: string[]; // Permission deny patterns, e.g., ["pm:task:update(status)"]
+}
+
+export interface PaneEntry {
+  pane: string;
+  remark?: string;
+}
+
+export interface ConfigDefaults {
+  timeout: number; // seconds
+  pollInterval: number; // seconds
+  captureLines: number;
+}
+
+export interface GlobalConfig {
+  mode: 'polling' | 'wait';
+  preambleMode: 'always' | 'disabled';
+  defaults: ConfigDefaults;
+  agents: Record<string, AgentConfig>;
+}
+
+export interface LocalSettings {
+  mode?: 'polling' | 'wait';
+  preambleMode?: 'always' | 'disabled';
+}
+
+export interface LocalConfigFile {
+  $config?: LocalSettings;
+  [agentName: string]: PaneEntry | LocalSettings | undefined;
+}
+
+export interface LocalConfig {
+  [agentName: string]: PaneEntry;
+}
+
+export interface ResolvedConfig {
+  mode: 'polling' | 'wait';
+  preambleMode: 'always' | 'disabled';
+  defaults: ConfigDefaults;
+  agents: Record<string, AgentConfig>;
+  paneRegistry: Record<string, PaneEntry>;
+}
+
+export interface Flags {
+  json: boolean;
+  verbose: boolean;
+  config?: string;
+  force?: boolean;
+  delay?: number; // seconds
+  wait?: boolean;
+  timeout?: number; // seconds
+  noPreamble?: boolean;
+}
+
+export interface Paths {
+  globalDir: string;
+  globalConfig: string;
+  localConfig: string;
+  stateFile: string;
+}
+
+export interface UI {
+  info: (msg: string) => void;
+  success: (msg: string) => void;
+  warn: (msg: string) => void;
+  error: (msg: string) => void;
+  table: (headers: string[], rows: string[][]) => void;
+  json: (data: unknown) => void;
+}
+
+export interface Tmux {
+  send: (paneId: string, message: string) => void;
+  capture: (paneId: string, lines: number) => string;
+}
+
+export interface WaitResult {
+  requestId: string;
+  nonce: string;
+  marker: string;
+  response: string;
+}
+
+export interface Context {
+  argv: string[];
+  flags: Flags;
+  ui: UI;
+  config: ResolvedConfig;
+  tmux: Tmux;
+  paths: Paths;
+  exit: (code: number) => never;
+}

package/src/ui.ts

@@ -0,0 +1,76 @@
+// ─────────────────────────────────────────────────────────────
+// UI utilities - colors, logging, output formatting
+// ─────────────────────────────────────────────────────────────
+
+import type { UI } from './types.js';
+
+const isTTY = process.stdout.isTTY;
+
+// Strip ANSI escape codes for accurate length calculation
+const stripAnsi = (s: string) => s.replace(/\x1b\[[0-9;]*m/g, '');
+
+export const colors = {
+  red: (s: string) => (isTTY ? `\x1b[31m${s}\x1b[0m` : s),
+  green: (s: string) => (isTTY ? `\x1b[32m${s}\x1b[0m` : s),
+  yellow: (s: string) => (isTTY ? `\x1b[33m${s}\x1b[0m` : s),
+  blue: (s: string) => (isTTY ? `\x1b[34m${s}\x1b[0m` : s),
+  cyan: (s: string) => (isTTY ? `\x1b[36m${s}\x1b[0m` : s),
+  dim: (s: string) => (isTTY ? `\x1b[2m${s}\x1b[0m` : s),
+};
+
+export function createUI(jsonMode: boolean): UI {
+  if (jsonMode) {
+    // In JSON mode, suppress all human-friendly output
+    return {
+      info: () => {},
+      success: () => {},
+      warn: () => {},
+      error: (msg: string) => {
+        console.error(JSON.stringify({ error: msg }));
+      },
+      table: () => {},
+      json: (data: unknown) => {
+        console.log(JSON.stringify(data, null, 2));
+      },
+    };
+  }
+
+  return {
+    info: (msg: string) => {
+      console.log(`${colors.blue('ℹ')} ${msg}`);
+    },
+    success: (msg: string) => {
+      console.log(`${colors.green('✓')} ${msg}`);
+    },
+    warn: (msg: string) => {
+      console.log(`${colors.yellow('⚠')} ${msg}`);
+    },
+    error: (msg: string) => {
+      console.error(`${colors.red('✗')} ${msg}`);
+    },
+    table: (headers: string[], rows: string[][]) => {
+      // Calculate column widths (strip ANSI codes for accurate length)
+      const widths = headers.map((h, i) =>
+        Math.max(h.length, ...rows.map((r) => stripAnsi(r[i] || '').length))
+      );
+
+      // Print header
+      console.log('  ' + headers.map((h, i) => colors.yellow(h.padEnd(widths[i]))).join(' '));
+      console.log('  ' + widths.map((w) => '─'.repeat(w)).join(' '));
+
+      // Print rows (pad based on visible length, not byte length)
+      for (const row of rows) {
+        const cells = row.map((c, i) => {
+          const cell = c || '-';
+          const visibleLen = stripAnsi(cell).length;
+          const padding = ' '.repeat(Math.max(0, widths[i] - visibleLen));
+          return cell + padding;
+        });
+        console.log('  ' + cells.join(' '));
+      }
+    },
+    json: (data: unknown) => {
+      console.log(JSON.stringify(data, null, 2));
+    },
+  };
+}

package/src/version.ts

@@ -0,0 +1,21 @@
+// ─────────────────────────────────────────────────────────────
+// Version - read from package.json
+// ─────────────────────────────────────────────────────────────
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function getVersion(): string {
+  try {
+    const pkgPath = path.join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+  } catch {
+    return '2.0.0';
+  }
+}
+
+export const VERSION = getVersion();