tmux-team 1.1.0 → 2.0.0-alpha.1

package/src/config.ts

@@ -0,0 +1,159 @@
+// ─────────────────────────────────────────────────────────────
+// Config loading with XDG support and 3-tier hierarchy
+// ─────────────────────────────────────────────────────────────
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import type { GlobalConfig, LocalConfig, ResolvedConfig, Paths } from './types.js';
+
+const CONFIG_FILENAME = 'config.json';
+const LOCAL_CONFIG_FILENAME = 'tmux-team.json';
+const STATE_FILENAME = 'state.json';
+
+// Default configuration values
+const DEFAULT_CONFIG: Omit<GlobalConfig, 'agents'> & { agents: Record<string, never> } = {
+  mode: 'polling',
+  preambleMode: 'always',
+  defaults: {
+    timeout: 60,
+    pollInterval: 1,
+    captureLines: 100,
+  },
+  agents: {},
+};
+
+/**
+ * Resolve the global config directory path using XDG spec with smart detection.
+ *
+ * Priority:
+ * 1. TMUX_TEAM_HOME env (escape hatch)
+ * 2. XDG_CONFIG_HOME env → ${XDG_CONFIG_HOME}/tmux-team
+ * 3. ~/.config/tmux-team/ exists → use XDG style
+ * 4. ~/.tmux-team/ exists → use legacy
+ * 5. Else (new install) → default to XDG
+ */
+export function resolveGlobalDir(): string {
+  const home = os.homedir();
+
+  // 1. Explicit override
+  if (process.env.TMUX_TEAM_HOME) {
+    return process.env.TMUX_TEAM_HOME;
+  }
+
+  // 2. XDG_CONFIG_HOME is set
+  if (process.env.XDG_CONFIG_HOME) {
+    return path.join(process.env.XDG_CONFIG_HOME, 'tmux-team');
+  }
+
+  const xdgPath = path.join(home, '.config', 'tmux-team');
+  const legacyPath = path.join(home, '.tmux-team');
+
+  // 3. XDG path exists
+  if (fs.existsSync(xdgPath)) {
+    // Edge case: both exist - prefer the one with config.json
+    if (fs.existsSync(legacyPath)) {
+      const xdgHasConfig = fs.existsSync(path.join(xdgPath, CONFIG_FILENAME));
+      const legacyHasConfig = fs.existsSync(path.join(legacyPath, CONFIG_FILENAME));
+
+      if (legacyHasConfig && !xdgHasConfig) {
+        return legacyPath;
+      }
+      // If both have config or only XDG has it, prefer XDG
+    }
+    return xdgPath;
+  }
+
+  // 4. Legacy path exists
+  if (fs.existsSync(legacyPath)) {
+    return legacyPath;
+  }
+
+  // 5. New install - default to XDG
+  return xdgPath;
+}
+
+export function resolvePaths(cwd: string = process.cwd()): Paths {
+  const globalDir = resolveGlobalDir();
+  return {
+    globalDir,
+    globalConfig: path.join(globalDir, CONFIG_FILENAME),
+    localConfig: path.join(cwd, LOCAL_CONFIG_FILENAME),
+    stateFile: path.join(globalDir, STATE_FILENAME),
+  };
+}
+
+export class ConfigParseError extends Error {
+  constructor(
+    public readonly filePath: string,
+    public readonly cause: Error
+  ) {
+    super(`Invalid JSON in ${filePath}: ${cause.message}`);
+    this.name = 'ConfigParseError';
+  }
+}
+
+function loadJsonFile<T>(filePath: string): T | null {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(content) as T;
+  } catch (err) {
+    // Throw on parse errors - don't silently ignore invalid config
+    throw new ConfigParseError(filePath, err as Error);
+  }
+}
+
+/**
+ * Load and merge configuration from all tiers.
+ *
+ * Precedence (lowest → highest):
+ * Defaults → Global config → Local config → CLI flags
+ *
+ * Note: CLI flags are applied by the caller after this function returns.
+ */
+export function loadConfig(paths: Paths): ResolvedConfig {
+  // Start with defaults
+  const config: ResolvedConfig = {
+    ...DEFAULT_CONFIG,
+    defaults: { ...DEFAULT_CONFIG.defaults },
+    agents: {},
+    paneRegistry: {},
+  };
+
+  // Merge global config
+  const globalConfig = loadJsonFile<Partial<GlobalConfig>>(paths.globalConfig);
+  if (globalConfig) {
+    if (globalConfig.mode) config.mode = globalConfig.mode;
+    if (globalConfig.preambleMode) config.preambleMode = globalConfig.preambleMode;
+    if (globalConfig.defaults) {
+      config.defaults = { ...config.defaults, ...globalConfig.defaults };
+    }
+    if (globalConfig.agents) {
+      config.agents = { ...config.agents, ...globalConfig.agents };
+    }
+  }
+
+  // Load local config (pane registry)
+  const localConfig = loadJsonFile<LocalConfig>(paths.localConfig);
+  if (localConfig) {
+    config.paneRegistry = localConfig;
+  }
+
+  return config;
+}
+
+export function saveLocalConfig(
+  paths: Paths,
+  paneRegistry: Record<string, { pane: string; remark?: string }>
+): void {
+  fs.writeFileSync(paths.localConfig, JSON.stringify(paneRegistry, null, 2) + '\n');
+}
+
+export function ensureGlobalDir(paths: Paths): void {
+  if (!fs.existsSync(paths.globalDir)) {
+    fs.mkdirSync(paths.globalDir, { recursive: true });
+  }
+}

package/src/context.ts

@@ -0,0 +1,38 @@
+// ─────────────────────────────────────────────────────────────
+// Context object - passed to all commands
+// ─────────────────────────────────────────────────────────────
+
+import type { Context, Flags } from './types.js';
+import { resolvePaths, loadConfig } from './config.js';
+import { createUI } from './ui.js';
+import { createTmux } from './tmux.js';
+import { ExitCodes } from './exits.js';
+
+export interface CreateContextOptions {
+  argv: string[];
+  flags: Flags;
+  cwd?: string;
+}
+
+export function createContext(options: CreateContextOptions): Context {
+  const { argv, flags, cwd = process.cwd() } = options;
+
+  const paths = resolvePaths(cwd);
+  const config = loadConfig(paths);
+  const ui = createUI(flags.json);
+  const tmux = createTmux();
+
+  return {
+    argv,
+    flags,
+    ui,
+    config,
+    tmux,
+    paths,
+    exit(code: number): never {
+      process.exit(code);
+    },
+  };
+}
+
+export { ExitCodes };

package/src/exits.ts

@@ -0,0 +1,14 @@
+// ─────────────────────────────────────────────────────────────
+// Exit code registry
+// ─────────────────────────────────────────────────────────────
+
+export const ExitCodes = {
+  SUCCESS: 0,
+  ERROR: 1,
+  CONFIG_MISSING: 2,
+  PANE_NOT_FOUND: 3,
+  TIMEOUT: 4,
+  CONFLICT: 5,
+} as const;
+
+export type ExitCode = (typeof ExitCodes)[keyof typeof ExitCodes];

package/src/pm/commands.test.ts

@@ -0,0 +1,158 @@
+// ─────────────────────────────────────────────────────────────
+// PM Commands Tests
+// ─────────────────────────────────────────────────────────────
+
+import { describe, it } from 'vitest';
+
+describe('requireTeam', () => {
+  // Test finds team from .tmux-team-id file
+  it.todo('finds team ID from .tmux-team-id file in cwd');
+
+  // Test finds team from TMUX_TEAM_ID env
+  it.todo('finds team ID from TMUX_TEAM_ID environment variable');
+
+  // Test validates team.json exists
+  it.todo('validates team.json exists for team ID');
+
+  // Test error for missing team link
+  it.todo('exits with error when no .tmux-team-id found');
+
+  // Test error for stale team ID
+  it.todo('exits with error when team.json does not exist (stale ID)');
+});
+
+describe('cmdPmInit', () => {
+  // Test creates team with UUID
+  it.todo('creates team with generated UUID');
+
+  // Test creates team with custom name
+  it.todo('uses --name flag for team name');
+
+  // Test creates .tmux-team-id link file
+  it.todo('creates .tmux-team-id file in current directory');
+
+  // Test logs team_created event
+  it.todo('logs team_created event to audit log');
+
+  // Test JSON output
+  it.todo('outputs team info in JSON when --json flag set');
+});
+
+describe('cmdPmMilestone', () => {
+  // Test milestone add
+  it.todo('creates milestone with given name');
+
+  // Test milestone list
+  it.todo('lists all milestones in table format');
+
+  // Test milestone done
+  it.todo('marks milestone as done');
+
+  // Test milestone not found error
+  it.todo('exits with error for non-existent milestone');
+
+  // Test shorthand "m" routing
+  it.todo('routes "pm m add" to milestone add');
+});
+
+describe('cmdPmTask', () => {
+  // Test task add
+  it.todo('creates task with given title');
+
+  // Test task add with --milestone
+  it.todo('creates task with milestone reference');
+
+  // Test task add with --assignee
+  it.todo('creates task with assignee');
+
+  // Test task list
+  it.todo('lists all tasks in table format');
+
+  // Test task list with --status filter
+  it.todo('filters task list by status');
+
+  // Test task list with --milestone filter
+  it.todo('filters task list by milestone');
+
+  // Test task show
+  it.todo('displays task details');
+
+  // Test task update --status
+  it.todo('updates task status');
+
+  // Test task update --assignee
+  it.todo('updates task assignee');
+
+  // Test task done
+  it.todo('marks task as done');
+
+  // Test task not found error
+  it.todo('exits with error for non-existent task');
+
+  // Test shorthand "t" routing
+  it.todo('routes "pm t add" to task add');
+});
+
+describe('cmdPmDoc', () => {
+  // Test doc print mode
+  it.todo('prints task documentation with --print flag');
+
+  // Test doc edit mode (spawns editor)
+  it.todo('opens documentation in $EDITOR');
+
+  // Test doc for non-existent task
+  it.todo('exits with error for non-existent task');
+});
+
+describe('cmdPmLog', () => {
+  // Test log display
+  it.todo('displays audit events');
+
+  // Test log with --limit
+  it.todo('limits number of events displayed');
+
+  // Test log JSON output
+  it.todo('outputs events in JSON when --json flag set');
+
+  // Test empty log message
+  it.todo('shows info message when no events');
+});
+
+describe('cmdPmList', () => {
+  // Test lists all teams
+  it.todo('lists all teams in table format');
+
+  // Test no teams message
+  it.todo('shows info message when no teams');
+
+  // Test JSON output
+  it.todo('outputs teams in JSON when --json flag set');
+});
+
+describe('cmdPm router', () => {
+  // Test command routing
+  it.todo('routes to correct subcommand');
+
+  // Test shorthand expansion
+  it.todo('expands m to milestone, t to task');
+
+  // Test unknown command error
+  it.todo('exits with error for unknown subcommand');
+
+  // Test help command
+  it.todo('displays help for pm help');
+});
+
+describe('parseStatus', () => {
+  // Test valid statuses
+  it.todo('parses pending, in_progress, done');
+
+  // Test hyphen to underscore normalization
+  it.todo('normalizes in-progress to in_progress');
+
+  // Test case insensitivity
+  it.todo('handles case insensitive input');
+
+  // Test invalid status error
+  it.todo('throws error for invalid status');
+});