tmux-ide 1.3.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/dist/attach.d.ts

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

package/dist/attach.js

@@ -1,14 +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/dist/config.d.ts

@@ -1,5 +0,0 @@
-export declare function config(targetDir: string | null, { json, action, args }?: {
-    json?: boolean;
-    action?: string;
-    args?: string[];
-}): Promise<void>;

package/dist/config.js

@@ -1,269 +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";
-/**
- * Read config safely (read-only, no write). Returns config or undefined on error.
- */
-function readConfigSafe(dir) {
-    let cfg;
-    try {
-        ({ config: cfg } = readConfig(dir));
-    }
-    catch (e) {
-        outputError(`Cannot read ide.yml: ${e.message}`, "READ_ERROR");
-        return;
-    }
-    return cfg;
-}
-/**
- * Read config, validate it's an object, run mutator, then write back.
- * Returns the mutator's return value, or undefined on error.
- */
-function withConfig(dir, mutator) {
-    const cfg = readConfigSafe(dir);
-    if (cfg === undefined)
-        return;
-    if (!isConfigObject(cfg)) {
-        outputError("Invalid ide.yml: config root must be an object", "INVALID_CONFIG");
-        return;
-    }
-    const result = mutator(cfg);
-    writeConfig(dir, cfg);
-    return result;
-}
-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 }) {
-    const cfg = readConfigSafe(dir);
-    if (cfg === undefined)
-        return;
-    if (json) {
-        console.log(JSON.stringify(cfg, null, 2));
-    }
-    else {
-        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 value = rest.join(" ");
-    if (value === "true")
-        value = true;
-    else if (value === "false")
-        value = false;
-    else if (/^\d+$/.test(value))
-        value = parseInt(value);
-    withConfig(dir, (cfg) => {
-        setByPath(cfg, dotpath, value);
-    });
-    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;
-    }
-    const rowIdx = parseIndex(row);
-    if (rowIdx == null) {
-        outputError(`Invalid row index "${row}"`, "USAGE");
-        return;
-    }
-    const pane = {};
-    if (title)
-        pane.title = title;
-    if (command)
-        pane.command = command;
-    if (size)
-        pane.size = size;
-    withConfig(dir, (cfg) => {
-        if (!Array.isArray(cfg.rows)) {
-            outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-        }
-        if (!cfg.rows[rowIdx]) {
-            outputError(`Row ${rowIdx} does not exist`, "INVALID_ROW");
-        }
-        if (!Array.isArray(cfg.rows[rowIdx].panes)) {
-            outputError(`Invalid ide.yml: row ${rowIdx} panes must be an array`, "INVALID_CONFIG");
-        }
-        cfg.rows[rowIdx].panes.push(pane);
-    });
-    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;
-    }
-    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;
-    }
-    let removed;
-    withConfig(dir, (cfg) => {
-        if (!Array.isArray(cfg.rows)) {
-            outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-        }
-        if (!Array.isArray(cfg.rows[rowIdx]?.panes)) {
-            outputError(`Invalid ide.yml: row ${rowIdx} panes must be an array`, "INVALID_CONFIG");
-        }
-        if (!cfg.rows[rowIdx].panes[paneIdx]) {
-            outputError(`Pane ${paneIdx} in row ${rowIdx} does not exist`, "INVALID_PANE");
-        }
-        removed = cfg.rows[rowIdx].panes.splice(paneIdx, 1)[0];
-    });
-    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 rowIdx;
-    withConfig(dir, (cfg) => {
-        if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-            outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-        }
-        const row = { panes: [{ title: "Shell" }] };
-        if (size)
-            row.size = size;
-        cfg.rows = cfg.rows ?? [];
-        cfg.rows.push(row);
-        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 teamName;
-    let result;
-    withConfig(dir, (cfg) => {
-        if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-            outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-        }
-        teamName = name ?? cfg.name ?? "my-team";
-        cfg.team = { name: teamName };
-        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");
-        }
-        result = { team: cfg.team, roles: summarizeRoles(cfg) };
-    });
-    if (json) {
-        console.log(JSON.stringify({ ok: true, ...result }, null, 2));
-    }
-    else {
-        console.log(`Enabled agent team "${teamName}"`);
-    }
-}
-function disableTeam(dir, { json }) {
-    withConfig(dir, (cfg) => {
-        if (cfg.rows !== undefined && !Array.isArray(cfg.rows)) {
-            outputError("Invalid ide.yml: 'rows' must be an array", "INVALID_CONFIG");
-        }
-        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;
-            }
-        }
-    });
-    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/dist/detect.d.ts

@@ -1,15 +0,0 @@
-import type { IdeConfig } from "./types.ts";
-interface DetectedStack {
-    packageManager: string | null;
-    frameworks: string[];
-    devCommand: string | null;
-    language: string | null;
-    reasons: string[];
-}
-export declare function detectStack(dir: string): DetectedStack;
-export declare function suggestConfig(dir: string, detected: DetectedStack): IdeConfig;
-export declare function detect(targetDir: string | undefined, { json, write }?: {
-    json?: boolean;
-    write?: boolean;
-}): Promise<void>;
-export {};