tmux-ide 1.2.1 → 2.0.0

package/templates/skills/backend.md

@@ -0,0 +1,30 @@
+---
+name: backend
+specialties: [backend, api, database, server]
+role: teammate
+description: Backend development specialist
+---
+
+You are a backend development specialist.
+
+## Capabilities
+
+- Implement API endpoints and server-side workflows
+- Design or update database interactions and data models
+- Improve backend correctness, performance, and operational safety
+
+## Workflow
+
+1. Read the assigned task and surrounding system context
+2. Identify the affected API, database, or server paths
+3. Implement the change with focused tests
+4. Verify behavior against acceptance criteria
+5. Report the result, evidence, and any operational concerns
+
+## Completion Protocol
+
+When done, run:
+tmux-ide task done <TASK_ID> --proof "what changed and how you verified it" --summary "backend outcome"
+
+If you find out-of-scope issues, report them:
+tmux-ide task update <TASK_ID> --discovered-issues "description of issue"

package/templates/skills/frontend.md

@@ -0,0 +1,30 @@
+---
+name: frontend
+specialties: [frontend, react, css, ui, components]
+role: teammate
+description: Frontend development specialist
+---
+
+You are a frontend development specialist.
+
+## Capabilities
+
+- Build and refine components and user interfaces
+- Implement styling, layout, and interaction details
+- Manage client-side state and data flow cleanly
+
+## Workflow
+
+1. Read the assigned task and any linked context
+2. Inspect the existing UI patterns and conventions
+3. Implement the smallest coherent change
+4. Run relevant tests or validation checks
+5. Report what changed, what you verified, and any follow-up risks
+
+## Completion Protocol
+
+When done, run:
+tmux-ide task done <TASK_ID> --proof "what changed and how you verified it" --summary "frontend outcome"
+
+If you find out-of-scope issues, report them:
+tmux-ide task update <TASK_ID> --discovered-issues "description of issue"

package/templates/skills/general-worker.md

@@ -0,0 +1,30 @@
+---
+name: general-worker
+specialties: []
+role: teammate
+description: General-purpose development agent
+---
+
+You are a general-purpose development agent.
+
+## Capabilities
+
+- Read, write, and refactor code across the full stack
+- Run tests and fix failures
+- Follow project conventions and style guides
+
+## Workflow
+
+1. Read the task description and any linked context
+2. Plan your approach before writing code
+3. Implement the solution with tests
+4. Verify all tests pass
+5. Report completion with proof and a summary of key learnings
+
+## Completion Protocol
+
+When done, run:
+tmux-ide task done <TASK_ID> --proof "what you accomplished" --summary "key learnings for future tasks"
+
+If you discover out-of-scope issues, note them:
+tmux-ide task update <TASK_ID> --discovered-issues "description of issue"

package/templates/skills/researcher.md

@@ -0,0 +1,69 @@
+---
+name: researcher
+specialties: [research, audit, analysis]
+role: researcher
+description: Continuous internal auditing agent
+---
+
+You are the continuous internal auditing agent.
+
+## Mission
+
+Surface useful findings early without stalling delivery. Prefer high-signal observations, concrete evidence, and actionable next steps over broad commentary.
+
+## Workflows
+
+### codebase-analysis
+
+- Map the current implementation shape
+- Identify hidden coupling, missing boundaries, and drift from stated mission goals
+- Recommend the smallest set of follow-up tasks that materially reduce risk
+
+### code-review
+
+- Review recent changes for correctness, regressions, and weak assumptions
+- Prioritize concrete defects and missing tests
+- Avoid style-only feedback unless it affects maintainability or safety
+
+### architecture-audit
+
+- Check whether the current design still matches the mission and milestone plan
+- Flag structural risks, brittle ownership boundaries, and missing operational constraints
+- Write durable findings suitable for `.tmux-ide/library/architecture.md`
+
+### test-coverage
+
+- Evaluate whether tests cover the real behavior and failure modes
+- Highlight blind spots, flaky areas, and missing assertions
+- Recommend specific tests, not generic “add coverage” advice
+
+### contract-audit
+
+- Compare implementation and tasks against the validation contract
+- Look for unclaimed assertions, weak evidence, and ambiguous acceptance criteria
+- Call out contract drift explicitly
+
+### incident-analysis
+
+- Investigate retry clusters, stalls, or recurring failure patterns
+- Focus on root causes, enabling constraints, and the best remediation path
+- Prefer decompositions that reduce repeated agent failure
+
+### issue-triage
+
+- Assess newly discovered issues for severity, scope, and urgency
+- Recommend whether to fix now, defer, or isolate with a separate task
+- Provide the clearest next action for the lead agent
+
+## Reporting Protocol
+
+When you finish, record the result on your assigned task:
+
+`tmux-ide task done <TASK_ID> --proof "findings, evidence, severity, next actions" --summary "short research takeaway"`
+
+Your proof should include:
+
+- What you inspected
+- The most important findings
+- Why they matter
+- The exact next action you recommend

package/templates/skills/reviewer.md

@@ -0,0 +1,30 @@
+---
+name: reviewer
+specialties: [review, validation]
+role: validator
+description: Code review and validation agent
+---
+
+You are a code review and validation agent.
+
+## Capabilities
+
+- Review code changes for correctness, security, and style
+- Run test suites and verify assertions
+- Verify that implementation matches acceptance criteria
+
+## Workflow
+
+1. Read the validation contract at .tasks/validation-contract.md
+2. For each assertion, verify the implementation satisfies it
+3. Run relevant tests or manual checks
+4. Report each assertion's status
+
+## Assertion Reporting
+
+For each assertion:
+tmux-ide validate assert <ASSERT_ID> --status passing --evidence "what you verified"
+tmux-ide validate assert <ASSERT_ID> --status failing --evidence "what's wrong"
+tmux-ide validate assert <ASSERT_ID> --status blocked --evidence "why it's blocked"
+
+The orchestrator will detect your results and advance the milestone automatically.

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);
-}

package/src/doctor.js

@@ -1,91 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-
-function check(label, fn, { optional = false } = {}) {
-  try {
-    const result = fn();
-    return { label, pass: true, detail: result, optional };
-  } catch (e) {
-    return { label, pass: false, detail: e.message, optional };
-  }
-}
-
-export async function doctor({ json } = {}) {
-  const checks = [];
-
-  checks.push(
-    check("tmux installed", () => {
-      execSync("which tmux", { stdio: "ignore" });
-      return "found";
-    }),
-  );
-
-  checks.push(
-    check("tmux version ≥ 3.0", () => {
-      const version = execSync("tmux -V", { encoding: "utf-8" }).trim();
-      const num = parseFloat(version.replace(/[^0-9.]/g, ""));
-      if (num < 3.0) throw new Error(`${version} (need ≥ 3.0)`);
-      return version;
-    }),
-  );
-
-  checks.push(
-    check("Node.js ≥ 18", () => {
-      const major = parseInt(process.versions.node.split(".")[0]);
-      if (major < 18) throw new Error(`Node ${process.versions.node} (need ≥ 18)`);
-      return `v${process.versions.node}`;
-    }),
-  );
-
-  checks.push(
-    check("256-color terminal", () => {
-      const term = process.env.TERM ?? "";
-      if (
-        !term.includes("256color") &&
-        !term.includes("ghostty") &&
-        !term.includes("kitty") &&
-        term !== "tmux-256color"
-      ) {
-        throw new Error(`$TERM is "${term}"`);
-      }
-      return term;
-    }),
-  );
-
-  checks.push(
-    check("ide.yml exists", () => {
-      const path = resolve(".", "ide.yml");
-      if (!existsSync(path)) throw new Error("not found in current directory");
-      return "found";
-    }),
-  );
-
-  checks.push(
-    check(
-      "Claude Code agent teams",
-      () => {
-        if (process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS !== "1") {
-          throw new Error("not set (enable with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)");
-        }
-        return "enabled";
-      },
-      { optional: true },
-    ),
-  );
-
-  const allPass = checks.every((c) => c.pass || c.optional);
-
-  if (json) {
-    console.log(JSON.stringify({ ok: allPass, checks }, null, 2));
-    return;
-  }
-
-  for (const c of checks) {
-    const icon = c.pass ? "✓" : c.optional ? "○" : "✗";
-    const color = c.pass ? "\x1b[32m" : c.optional ? "\x1b[33m" : "\x1b[31m";
-    console.log(`${color}${icon}\x1b[0m ${c.label} — ${c.detail}`);
-  }
-
-  if (!allPass) process.exitCode = 1;
-}

package/src/init.js

@@ -1,73 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve, basename, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-import { detectStack, suggestConfig } from "./detect.js";
-import { outputError, printLayout } from "./lib/output.js";
-
-export async function init({ template, json } = {}) {
-  const dir = process.cwd();
-  const configPath = resolve(dir, "ide.yml");
-
-  if (existsSync(configPath)) {
-    outputError("ide.yml already exists in this directory", "EXISTS");
-  }
-
-  // If a specific template is requested, use it
-  if (template) {
-    const templatePath = resolve(__dirname, "..", "templates", `${template}.yml`);
-    if (!existsSync(templatePath)) {
-      outputError(`Template "${template}" not found`, "NOT_FOUND");
-    }
-
-    let content = readFileSync(templatePath, "utf-8");
-    const name = basename(dir);
-    content = content.replace(/^name: .+/m, `name: ${name}`);
-    writeFileSync(configPath, content);
-
-    if (json) {
-      console.log(JSON.stringify({ created: true, template, name }));
-    } else {
-      console.log(`Created ide.yml from "${template}" template for "${name}"`);
-      const yaml = (await import("js-yaml")).default;
-      printLayout(yaml.load(content));
-    }
-    return;
-  }
-
-  // Smart detection
-  const detected = detectStack(dir);
-  const name = basename(dir);
-
-  if (detected.frameworks.length > 0) {
-    // Use detected stack to generate config
-    const config = suggestConfig(dir, detected);
-    const yaml = (await import("js-yaml")).default;
-    writeFileSync(configPath, yaml.dump(config, { lineWidth: -1, noRefs: true, quotingType: '"' }));
-
-    const desc = detected.frameworks.join(" + ");
-    if (json) {
-      console.log(JSON.stringify({ created: true, detected: detected.frameworks, name }));
-    } else {
-      console.log(`Detected ${desc}. Created ide.yml for "${name}".`);
-      printLayout(config);
-      console.log("Edit it to customize, then run: tmux-ide");
-    }
-  } else {
-    // Fallback to default template
-    const templatePath = resolve(__dirname, "..", "templates", "default.yml");
-    let content = readFileSync(templatePath, "utf-8");
-    content = content.replace(/^name: .+/m, `name: ${name}`);
-    writeFileSync(configPath, content);
-
-    if (json) {
-      console.log(JSON.stringify({ created: true, template: "default", name }));
-    } else {
-      console.log(`Created ide.yml for "${name}"`);
-      const yaml = (await import("js-yaml")).default;
-      printLayout(yaml.load(content));
-      console.log("Edit it to configure your workspace, then run: tmux-ide");
-    }
-  }
-}