tmux-ide 1.2.1 → 1.3.1

package/dist/status.js

@@ -0,0 +1,29 @@
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { getSessionName } from "./lib/yaml-io.js";
+import { getSessionState, listPanes } from "./lib/tmux.js";
+export async function status(targetDir, { json } = {}) {
+    const dir = resolve(targetDir ?? ".");
+    const { name: session } = getSessionName(dir);
+    const configExists = existsSync(resolve(dir, "ide.yml"));
+    const state = getSessionState(session);
+    const running = state.running;
+    let panes = [];
+    if (running)
+        panes = listPanes(session);
+    const data = { session, running, configExists, panes };
+    if (json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`Session: ${session}`);
+    console.log(`Running: ${running ? "yes" : "no"}`);
+    console.log(`Config:  ${configExists ? "ide.yml found" : "no ide.yml"}`);
+    if (panes.length > 0) {
+        console.log(`\nPanes:`);
+        for (const p of panes) {
+            const active = p.active ? " (active)" : "";
+            console.log(`  ${p.index}: ${p.title} [${p.width}x${p.height}]${active}`);
+        }
+    }
+}

package/dist/stop.d.ts

@@ -0,0 +1,3 @@
+export declare function stop(targetDir: string | undefined, { json }?: {
+    json?: boolean;
+}): Promise<void>;

package/dist/stop.js

@@ -0,0 +1,21 @@
+import { resolve } from "node:path";
+import { getSessionName } from "./lib/yaml-io.js";
+import { outputError } from "./lib/output.js";
+import { killSession, stopSessionMonitor } from "./lib/tmux.js";
+export async function stop(targetDir, { json } = {}) {
+    const dir = resolve(targetDir ?? ".");
+    const { name: session } = getSessionName(dir);
+    // Stop the session monitor before killing the session
+    stopSessionMonitor(session);
+    const result = killSession(session);
+    if (result.stopped) {
+        if (json) {
+            console.log(JSON.stringify({ stopped: session }));
+        }
+        else {
+            console.log(`Stopped session "${session}"`);
+        }
+        return;
+    }
+    outputError(`No active session "${session}" found`, "NOT_RUNNING");
+}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export interface IdeConfig {
+    name?: string;
+    before?: string;
+    team?: {
+        name: string;
+    };
+    rows: Row[];
+    theme?: ThemeConfig;
+}
+export interface Row {
+    size?: string;
+    panes: Pane[];
+}
+export interface Pane {
+    title?: string;
+    command?: string;
+    dir?: string;
+    size?: string;
+    focus?: boolean;
+    env?: Record<string, string | number>;
+    role?: "lead" | "teammate";
+    task?: string;
+}
+export interface ThemeConfig {
+    accent?: string;
+    border?: string;
+    bg?: string;
+    fg?: string;
+}
+export type TmuxCommand = string[];
+export interface PaneAction {
+    targetPane: string;
+    title: string | null;
+    chdir: string | null;
+    exports: string[];
+    command: string | null;
+}
+export interface SessionState {
+    running: boolean;
+    reason: string | null;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/validate.d.ts

@@ -0,0 +1,4 @@
+export declare function validateConfig(config: unknown): string[];
+export declare function validate(targetDir: string | undefined, { json }?: {
+    json?: boolean;
+}): Promise<void>;

package/dist/validate.js

@@ -0,0 +1,172 @@
+import { resolve } from "node:path";
+import { readConfig } from "./lib/yaml-io.js";
+import { outputError } from "./lib/output.js";
+export function validateConfig(config) {
+    const errors = [];
+    if (config == null || typeof config !== "object" || Array.isArray(config)) {
+        errors.push("config must be an object");
+        return errors;
+    }
+    const cfg = config;
+    if (cfg.name !== undefined && typeof cfg.name !== "string") {
+        errors.push("'name' must be a string");
+    }
+    if (cfg.before !== undefined && typeof cfg.before !== "string") {
+        errors.push("'before' must be a string");
+    }
+    if (!Array.isArray(cfg.rows)) {
+        errors.push("'rows' must be an array");
+    }
+    else if (cfg.rows.length === 0) {
+        errors.push("'rows' must not be empty");
+    }
+    else {
+        for (let i = 0; i < cfg.rows.length; i++) {
+            const row = cfg.rows[i];
+            if (!row.panes || !Array.isArray(row.panes)) {
+                errors.push(`rows[${i}].panes must be an array`);
+                continue;
+            }
+            if (row.panes.length === 0) {
+                errors.push(`rows[${i}].panes must not be empty`);
+            }
+            if (row.size !== undefined) {
+                validateSize(row.size, `rows[${i}].size`, errors);
+            }
+            for (let j = 0; j < row.panes.length; j++) {
+                const pane = row.panes[j];
+                if (pane.title !== undefined && typeof pane.title !== "string") {
+                    errors.push(`rows[${i}].panes[${j}].title must be a string`);
+                }
+                if (pane.command !== undefined && typeof pane.command !== "string") {
+                    errors.push(`rows[${i}].panes[${j}].command must be a string`);
+                }
+                if (pane.dir !== undefined && typeof pane.dir !== "string") {
+                    errors.push(`rows[${i}].panes[${j}].dir must be a string`);
+                }
+                if (pane.focus !== undefined && typeof pane.focus !== "boolean") {
+                    errors.push(`rows[${i}].panes[${j}].focus must be a boolean`);
+                }
+                if (pane.env !== undefined) {
+                    if (pane.env == null || typeof pane.env !== "object" || Array.isArray(pane.env)) {
+                        errors.push(`rows[${i}].panes[${j}].env must be an object`);
+                    }
+                    else {
+                        for (const [key, val] of Object.entries(pane.env)) {
+                            if (typeof val !== "string" && typeof val !== "number") {
+                                errors.push(`rows[${i}].panes[${j}].env.${key} must be a string or number`);
+                            }
+                        }
+                    }
+                }
+                if (pane.size !== undefined) {
+                    validateSize(pane.size, `rows[${i}].panes[${j}].size`, errors);
+                }
+                if (pane.role !== undefined) {
+                    if (pane.role !== "lead" && pane.role !== "teammate") {
+                        errors.push(`rows[${i}].panes[${j}].role must be "lead" or "teammate"`);
+                    }
+                }
+                if (pane.task !== undefined && typeof pane.task !== "string") {
+                    errors.push(`rows[${i}].panes[${j}].task must be a string`);
+                }
+            }
+            // Check multiple focus panes in this row
+            const focusCount = row.panes.filter((p) => p.focus === true).length;
+            if (focusCount > 1) {
+                errors.push(`Row ${i} has ${focusCount} panes with focus: true (max 1)`);
+            }
+            // Check pane sizes sum within this row
+            const paneSizes = row.panes
+                .map((p) => p.size)
+                .filter((s) => typeof s === "string" && /^[1-9]\d*%$/.test(s))
+                .map((s) => parseInt(s, 10));
+            const paneSum = paneSizes.reduce((a, b) => a + b, 0);
+            if (paneSum > 100) {
+                errors.push(`Row ${i} pane sizes sum to ${paneSum}%, which exceeds 100%`);
+            }
+        }
+        // Check row sizes sum
+        const rowSizes = cfg.rows
+            .map((r) => r.size)
+            .filter((s) => typeof s === "string" && /^[1-9]\d*%$/.test(s))
+            .map((s) => parseInt(s, 10));
+        const rowSum = rowSizes.reduce((a, b) => a + b, 0);
+        if (rowSum > 100) {
+            errors.push(`Row sizes sum to ${rowSum}%, which exceeds 100%`);
+        }
+    }
+    // Validate team config
+    if (cfg.team !== undefined) {
+        if (cfg.team == null || typeof cfg.team !== "object" || Array.isArray(cfg.team)) {
+            errors.push("'team' must be an object");
+        }
+        else {
+            const team = cfg.team;
+            if (team.name === undefined) {
+                errors.push("'team.name' is required when team is specified");
+            }
+            else if (typeof team.name !== "string") {
+                errors.push("'team.name' must be a string");
+            }
+            if (team.model !== undefined && typeof team.model !== "string") {
+                errors.push("'team.model' must be a string");
+            }
+            if (team.permissions !== undefined && !Array.isArray(team.permissions)) {
+                errors.push("'team.permissions' must be an array");
+            }
+        }
+    }
+    if (cfg.theme !== undefined) {
+        if (cfg.theme == null || typeof cfg.theme !== "object" || Array.isArray(cfg.theme)) {
+            errors.push("'theme' must be an object");
+        }
+        else {
+            const theme = cfg.theme;
+            for (const key of ["accent", "border", "bg", "fg"]) {
+                if (theme[key] !== undefined && typeof theme[key] !== "string") {
+                    errors.push(`theme.${key} must be a string`);
+                }
+            }
+        }
+    }
+    return errors;
+}
+function validateSize(value, path, errors) {
+    const s = String(value);
+    if (!/^[1-9]\d*%$/.test(s)) {
+        errors.push(`${path} "${value}" must be a percentage (e.g. "50%")`);
+        return;
+    }
+    const num = parseInt(s, 10);
+    if (num > 100) {
+        errors.push(`${path} must not exceed 100%`);
+    }
+}
+export async function validate(targetDir, { json } = {}) {
+    const dir = resolve(targetDir ?? ".");
+    let config;
+    try {
+        ({ config } = readConfig(dir));
+    }
+    catch (e) {
+        outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
+        return;
+    }
+    const errors = validateConfig(config);
+    const valid = errors.length === 0;
+    if (json) {
+        console.log(JSON.stringify({ valid, errors }, null, 2));
+        return;
+    }
+    if (valid) {
+        console.log("✓ ide.yml is valid");
+    }
+    else {
+        console.log("✗ ide.yml has errors:");
+        for (const e of errors) {
+            console.log(`  - ${e}`);
+        }
+        process.exitCode = 1;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmux-ide",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "Turn any project into a tmux-powered terminal IDE with a simple ide.yml",
   "type": "module",
   "bin": {
@@ -8,17 +8,19 @@
   },
   "files": [
     "bin",
-    "src/**/*.js",
-    "!src/**/*.test.js",
+    "dist",
     "scripts",
     "skill",
     "templates"
   ],
   "scripts": {
-    "dev": "node bin/cli.js",
-    "test": "node --test src/*.test.js src/lib/*.test.js",
-    "test:unit": "node --test src/cli.test.js src/config-cli.test.js src/detect.test.js src/launch.test.js src/validate.test.js src/lib/*.test.js",
-    "test:integration": "node --test src/integration.test.js",
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "node --experimental-strip-types bin/cli.js",
+    "test": "node --experimental-strip-types --test src/*.test.ts src/lib/*.test.ts",
+    "test:unit": "node --experimental-strip-types --test src/cli.test.ts src/config-cli.test.ts src/config.test.ts src/detect.test.ts src/doctor.test.ts src/init.test.ts src/inspect.test.ts src/launch.test.ts src/ls.test.ts src/stop.test.ts src/validate.test.ts src/lib/*.test.ts",
+    "test:integration": "node --experimental-strip-types --test src/integration.test.ts",
     "lint": "eslint .",
     "lint:workspace": "turbo run lint",
     "format": "prettier --write .",
@@ -27,8 +29,8 @@
     "typecheck:workspace": "turbo run typecheck",
     "docs:build": "turbo run build --filter=@tmux-ide/docs",
     "pack:check": "npm pack --dry-run --cache /tmp/tmux-ide-npm-cache > /dev/null",
-    "check": "pnpm run lint:workspace && pnpm run format:check && pnpm run test:unit && pnpm run docs:build && pnpm run pack:check",
-    "prepublishOnly": "pnpm run check",
+    "check": "pnpm run lint:workspace && pnpm run format:check && pnpm run build && pnpm run test:unit && pnpm run docs:build && pnpm run pack:check",
+    "prepublishOnly": "pnpm run build",
     "postinstall": "node scripts/postinstall.js",
     "docs": "turbo run dev --filter=@tmux-ide/docs"
   },
@@ -57,9 +59,13 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "eslint": "^10.0.3",
     "globals": "^17.4.0",
     "prettier": "^3.8.1",
-    "turbo": "^2.3.3"
+    "turbo": "^2.3.3",
+    "typescript": "^5.9.3"
   }
 }

package/src/attach.js

@@ -1,17 +0,0 @@
-import { resolve } from "node:path";
-import { getSessionName } from "./lib/yaml-io.js";
-import { outputError } from "./lib/output.js";
-import { attachSession, getSessionState } from "./lib/tmux.js";
-
-export async function attach(targetDir, { json: _json } = {}) {
-  const dir = resolve(targetDir ?? ".");
-  const { name: session } = getSessionName(dir);
-  const state = getSessionState(session);
-
-  if (!state.running) {
-    outputError(`Session "${session}" is not running. Start it with: tmux-ide`, "NOT_RUNNING");
-    return;
-  }
-
-  attachSession(session);
-}

package/src/config.js

@@ -1,341 +0,0 @@
-import { resolve } from "node:path";
-import { readConfig, writeConfig } from "./lib/yaml-io.js";
-import { setByPath } from "./lib/dot-path.js";
-import { outputError } from "./lib/output.js";
-
-export async function config(targetDir, { json, action, args } = {}) {
-  const dir = resolve(targetDir ?? ".");
-
-  switch (action) {
-    case "dump":
-      return dumpConfig(dir, { json });
-    case "set":
-      return setConfig(dir, args, { json });
-    case "add-pane":
-      return addPane(dir, args, { json });
-    case "remove-pane":
-      return removePane(dir, args, { json });
-    case "add-row":
-      return addRow(dir, args, { json });
-    case "enable-team":
-      return enableTeam(dir, args, { json });
-    case "disable-team":
-      return disableTeam(dir, { json });
-    default:
-      return dumpConfig(dir, { json });
-  }
-}
-
-function dumpConfig(dir, { json }) {
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (json) {
-    console.log(JSON.stringify(cfg, null, 2));
-  } else {
-    // Pretty print for humans
-    console.log(JSON.stringify(cfg, null, 2));
-  }
-}
-
-function setConfig(dir, args, { json }) {
-  const [dotpath, ...rest] = args;
-  if (!dotpath || rest.length === 0) {
-    outputError("Usage: tmux-ide config set <dotpath> <value>", "USAGE");
-    return;
-  }
-
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!isConfigObject(cfg)) {
-    outputError("Invalid ide.yml: config root must be an object", "INVALID_CONFIG");
-    return;
-  }
-
-  let value = rest.join(" ");
-  // Try to parse as number or boolean
-  if (value === "true") value = true;
-  else if (value === "false") value = false;
-  else if (/^\d+$/.test(value)) value = parseInt(value);
-
-  setByPath(cfg, dotpath, value);
-  writeConfig(dir, cfg);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: true, path: dotpath, value }, null, 2));
-  } else {
-    console.log(`Set ${dotpath} = ${JSON.stringify(value)}`);
-  }
-}
-
-function addPane(dir, args, { json }) {
-  const { row, title, command, size } = parseNamedArgs(args);
-  if (row === undefined) {
-    outputError(
-      "Usage: tmux-ide config add-pane --row <N> --title <T> [--command <C>] [--size <S>]",
-      "USAGE",
-    );
-    return;
-  }
-
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!Array.isArray(cfg?.rows)) {
-    outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-    return;
-  }
-
-  const rowIdx = parseIndex(row);
-  if (rowIdx == null) {
-    outputError(`Invalid row index "${row}"`, "USAGE");
-    return;
-  }
-
-  if (!cfg.rows[rowIdx]) {
-    outputError(`Row ${rowIdx} does not exist`, "INVALID_ROW");
-    return;
-  }
-
-  if (!Array.isArray(cfg.rows[rowIdx].panes)) {
-    outputError(`Invalid ide.yml: row ${rowIdx} panes must be an array`, "INVALID_CONFIG");
-    return;
-  }
-
-  const pane = {};
-  if (title) pane.title = title;
-  if (command) pane.command = command;
-  if (size) pane.size = size;
-
-  cfg.rows[rowIdx].panes.push(pane);
-  writeConfig(dir, cfg);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: true, row: rowIdx, pane }, null, 2));
-  } else {
-    console.log(`Added pane "${title ?? "untitled"}" to row ${rowIdx}`);
-  }
-}
-
-function removePane(dir, args, { json }) {
-  const { row, pane } = parseNamedArgs(args);
-  if (row === undefined || pane === undefined) {
-    outputError("Usage: tmux-ide config remove-pane --row <N> --pane <M>", "USAGE");
-    return;
-  }
-
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!Array.isArray(cfg?.rows)) {
-    outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-    return;
-  }
-
-  const rowIdx = parseIndex(row);
-  const paneIdx = parseIndex(pane);
-  if (rowIdx == null || paneIdx == null) {
-    outputError("Usage: tmux-ide config remove-pane --row <N> --pane <M>", "USAGE");
-    return;
-  }
-
-  if (!Array.isArray(cfg.rows[rowIdx]?.panes)) {
-    outputError(`Invalid ide.yml: row ${rowIdx} panes must be an array`, "INVALID_CONFIG");
-    return;
-  }
-
-  if (!cfg.rows[rowIdx].panes[paneIdx]) {
-    outputError(`Pane ${paneIdx} in row ${rowIdx} does not exist`, "INVALID_PANE");
-    return;
-  }
-
-  const removed = cfg.rows[rowIdx].panes.splice(paneIdx, 1)[0];
-  writeConfig(dir, cfg);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: true, row: rowIdx, pane: paneIdx, removed }, null, 2));
-  } else {
-    console.log(`Removed pane ${paneIdx} ("${removed.title ?? "untitled"}") from row ${rowIdx}`);
-  }
-}
-
-function addRow(dir, args, { json }) {
-  const { size } = parseNamedArgs(args);
-
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!isConfigObject(cfg)) {
-    outputError("Invalid ide.yml: config root must be an object", "INVALID_CONFIG");
-    return;
-  }
-
-  if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-    outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-    return;
-  }
-
-  const row = { panes: [{ title: "Shell" }] };
-  if (size) row.size = size;
-
-  cfg.rows = cfg.rows ?? [];
-  cfg.rows.push(row);
-  writeConfig(dir, cfg);
-
-  const rowIdx = cfg.rows.length - 1;
-  if (json) {
-    console.log(JSON.stringify({ ok: true, row: rowIdx, size: size ?? null }, null, 2));
-  } else {
-    console.log(`Added row ${rowIdx}${size ? ` (${size})` : ""}`);
-  }
-}
-
-function enableTeam(dir, args, { json }) {
-  const { name } = parseNamedArgs(args);
-
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!isConfigObject(cfg)) {
-    outputError("Invalid ide.yml: config root must be an object", "INVALID_CONFIG");
-    return;
-  }
-
-  if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-    outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-    return;
-  }
-
-  const teamName = name ?? cfg.name ?? "my-team";
-  cfg.team = { name: teamName };
-
-  // Find claude panes and assign roles: first as lead, rest as teammates
-  let leadAssigned = false;
-  for (const row of cfg.rows ?? []) {
-    for (const pane of row.panes ?? []) {
-      if (pane.command === "claude" || pane.role === "lead" || pane.role === "teammate") {
-        if (!leadAssigned) {
-          pane.role = "lead";
-          leadAssigned = true;
-        } else {
-          pane.role = "teammate";
-        }
-      }
-    }
-  }
-  if (!leadAssigned) {
-    delete cfg.team;
-    outputError("Cannot enable agent team: no Claude panes found", "INVALID_CONFIG");
-    return;
-  }
-
-  writeConfig(dir, cfg);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: true, team: cfg.team, roles: summarizeRoles(cfg) }, null, 2));
-  } else {
-    console.log(`Enabled agent team "${teamName}"`);
-  }
-}
-
-function disableTeam(dir, { json }) {
-  let cfg;
-  try {
-    ({ config: cfg } = readConfig(dir));
-  } catch (e) {
-    outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-    return;
-  }
-
-  if (!isConfigObject(cfg)) {
-    outputError("Invalid ide.yml: config root must be an object", "INVALID_CONFIG");
-    return;
-  }
-
-  if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-    outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-    return;
-  }
-
-  delete cfg.team;
-  for (const row of cfg.rows ?? []) {
-    if (!Array.isArray(row?.panes)) continue;
-    for (const pane of row.panes ?? []) {
-      delete pane.role;
-      delete pane.task;
-    }
-  }
-
-  writeConfig(dir, cfg);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: true, disabled: true }, null, 2));
-  } else {
-    console.log("Disabled agent team");
-  }
-}
-
-function summarizeRoles(cfg) {
-  const roles = [];
-  for (let i = 0; i < (cfg.rows ?? []).length; i++) {
-    for (let j = 0; j < (cfg.rows[i].panes ?? []).length; j++) {
-      const p = cfg.rows[i].panes[j];
-      if (p.role) {
-        roles.push({ row: i, pane: j, title: p.title ?? null, role: p.role });
-      }
-    }
-  }
-  return roles;
-}
-
-function parseNamedArgs(args) {
-  const result = {};
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith("--") && i + 1 < args.length) {
-      const key = args[i].slice(2);
-      result[key] = args[i + 1];
-      i++;
-    }
-  }
-  return result;
-}
-
-function isConfigObject(value) {
-  return value != null && typeof value === "object" && !Array.isArray(value);
-}
-
-function parseIndex(value) {
-  if (!/^\d+$/.test(String(value))) return null;
-  return Number.parseInt(value, 10);
-}