aimux-cli 0.1.0

package/dist/config.js

@@ -0,0 +1,172 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getGlobalAimuxDir, getGlobalConfigPath, getLocalAimuxDir, getConfigPath, getProjectStateDir, } from "./paths.js";
+const DEFAULT_CONFIG = {
+    defaultTool: "claude",
+    contextMaxEntries: 20,
+    liveWindowSize: 20,
+    compactEveryNTurns: 50,
+    notifications: {
+        enabled: true,
+        onPrompt: true,
+        onError: true,
+        onComplete: true,
+    },
+    runtime: {
+        tmux: {
+            sessionPrefix: "aimux",
+        },
+    },
+    worktrees: {
+        baseDir: ".aimux/worktrees",
+    },
+    tools: {
+        claude: {
+            command: "claude",
+            args: ["--dangerously-skip-permissions"],
+            enabled: true,
+            wrapperEnabled: true,
+            preambleFlag: ["--append-system-prompt"],
+            sessionIdFlag: ["--session-id", "{sessionId}"],
+            resumeArgs: ["--resume", "{sessionId}"],
+            resumeByBackendSessionId: false,
+            resumeFallback: ["--continue"],
+            promptPatterns: ["^> $", "\\$ $"],
+            turnPatterns: ["^[❯>]\\s*(.+)", "^❯\\s+(.+)", "^>\\s+(.+)"],
+            compactCommand: "claude --print --output-format text",
+        },
+        codex: {
+            command: "codex",
+            args: ["--dangerously-bypass-approvals-and-sandbox"],
+            enabled: true,
+            resumeArgs: ["resume", "{sessionId}"],
+            resumeByBackendSessionId: true,
+            resumeFallback: ["resume", "--last"],
+            instructionsFile: "AGENTS.md",
+            sessionCapture: {
+                dir: "{home}/.codex/sessions/{yyyy}/{mm}/{dd}",
+                pattern: "([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\\.jsonl$",
+                delayMs: 2000,
+            },
+            promptPatterns: ["^> $"],
+            turnPatterns: ["^[>❯]\\s*(.+)"],
+        },
+        aider: {
+            command: "aider",
+            args: [],
+            enabled: true,
+            resumeFallback: ["--restore-chat-history"],
+            promptPatterns: ["^aider> $", "^> $"],
+            turnPatterns: ["^aider>\\s*(.+)", "^>\\s*(.+)"],
+        },
+    },
+};
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+/**
+ * Load config with hierarchy: defaults → global (~/.aimux/config.json) → project (.aimux/config.json)
+ * Project settings override global, global overrides defaults.
+ */
+export function loadConfig() {
+    let config = cloneJson(DEFAULT_CONFIG);
+    // Layer 1: global config
+    const globalPath = getGlobalConfigPath();
+    if (existsSync(globalPath)) {
+        try {
+            const globalRaw = JSON.parse(readFileSync(globalPath, "utf-8"));
+            config = deepMerge(config, globalRaw);
+        }
+        catch { }
+    }
+    // Layer 2: project config
+    const projectPath = getConfigPath();
+    if (existsSync(projectPath)) {
+        try {
+            const projectRaw = JSON.parse(readFileSync(projectPath, "utf-8"));
+            config = deepMerge(config, projectRaw);
+        }
+        catch { }
+    }
+    return config;
+}
+/** Save config to project-level .aimux/config.json */
+export function saveConfig(config) {
+    const dir = getLocalAimuxDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(getConfigPath(), JSON.stringify(config, null, 2) + "\n");
+}
+/** Save config to global ~/.aimux/config.json */
+export function saveGlobalConfig(config) {
+    const dir = getGlobalAimuxDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(getGlobalConfigPath(), JSON.stringify(config, null, 2) + "\n");
+}
+const GITIGNORE_CONTENTS = `# Runtime-private session state (lives in ~/.aimux/projects/)
+state.json
+graveyard.json
+sessions.json
+instances.json
+
+# Agent-facing shared artifacts
+context/
+history/
+tasks/
+status/
+threads/
+
+# Terminal recordings (large, machine-specific)
+recordings/
+
+# Agent plan files
+plans/
+
+# Managed git worktrees
+worktrees/
+
+`;
+export function initProject() {
+    // In-repo directory (agent-facing shared contract + config/team)
+    const localDir = getLocalAimuxDir();
+    mkdirSync(localDir, { recursive: true });
+    for (const subdir of ["plans", "context", "history", "tasks", "status", "threads"]) {
+        mkdirSync(join(localDir, subdir), { recursive: true });
+    }
+    if (!existsSync(getConfigPath())) {
+        saveConfig(DEFAULT_CONFIG);
+    }
+    const gitignorePath = join(localDir, ".gitignore");
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, GITIGNORE_CONTENTS);
+    }
+    // Global runtime-private project state directory
+    const stateDir = getProjectStateDir();
+    for (const subdir of ["recordings"]) {
+        mkdirSync(join(stateDir, subdir), { recursive: true });
+    }
+}
+/** Deep merge b into a (b values override a). Handles nested objects, not arrays. */
+function deepMerge(a, b) {
+    const result = { ...a };
+    for (const key of Object.keys(b)) {
+        const aVal = a[key];
+        const bVal = b[key];
+        if (aVal &&
+            bVal &&
+            typeof aVal === "object" &&
+            typeof bVal === "object" &&
+            !Array.isArray(aVal) &&
+            !Array.isArray(bVal)) {
+            result[key] = deepMerge(aVal, bVal);
+        }
+        else if (bVal !== undefined) {
+            result[key] = bVal;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/context/compactor.d.ts

@@ -0,0 +1,20 @@
+export interface SummaryProvenance {
+    sessionId: string;
+    mode: "algorithmic" | "llm";
+    generatedAt: string;
+    turns: number;
+    firstTurnTs?: string;
+    lastTurnTs?: string;
+    historyDigest: string;
+    summaryBytes: number;
+}
+/**
+ * Algorithmic compaction: extract key signals from history and write per-session summaries.
+ * Each session gets its own context/{session-id}/summary.md.
+ */
+export declare function algorithmicCompact(sessionIds: string[]): void;
+/**
+ * LLM-powered compaction: send each session's history to claude for summarization.
+ * Each session gets its own context/{session-id}/summary.md.
+ */
+export declare function llmCompact(sessionIds: string[]): void;

package/dist/context/compactor.js

@@ -0,0 +1,212 @@
+import { existsSync, mkdirSync, writeFileSync, appendFileSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { loadConfig } from "../config.js";
+import { getContextDir } from "../paths.js";
+import { readHistory } from "./history.js";
+const MAX_SUMMARY_BYTES = 30 * 1024;
+const DECISION_KEYWORDS = /\b(decided|chose|instead|approach|switched to|went with)\b/i;
+const ERROR_KEYWORDS = /\b(error|failed|blocked|issue|broken|crash|exception)\b/i;
+function historyDigest(turns) {
+    const hash = createHash("sha1");
+    for (const turn of turns) {
+        hash.update(turn.ts);
+        hash.update("\0");
+        hash.update(turn.type);
+        hash.update("\0");
+        hash.update(turn.content);
+        hash.update("\0");
+    }
+    return hash.digest("hex");
+}
+function withSummaryHeader(summary, provenance) {
+    const lines = [
+        `# ${provenance.sessionId} — Session Summary`,
+        `Generated: ${provenance.generatedAt}`,
+        `Source: ${provenance.mode}`,
+        `Turns covered: ${provenance.turns}`,
+    ];
+    if (provenance.firstTurnTs || provenance.lastTurnTs) {
+        lines.push(`History range: ${provenance.firstTurnTs ?? "unknown"} -> ${provenance.lastTurnTs ?? "unknown"}`);
+    }
+    lines.push(`History digest: ${provenance.historyDigest}`);
+    lines.push("");
+    return `${lines.join("\n")}${summary.trimStart() ? `\n${summary.trimStart()}` : ""}`;
+}
+function writeSummaryArtifacts(sessionDir, sessionId, mode, turns, summary) {
+    const generatedAt = new Date().toISOString();
+    const baseProvenance = {
+        sessionId,
+        mode,
+        generatedAt,
+        turns: turns.length,
+        firstTurnTs: turns[0]?.ts,
+        lastTurnTs: turns.at(-1)?.ts,
+        historyDigest: historyDigest(turns),
+        summaryBytes: 0,
+    };
+    const summaryWithHeader = withSummaryHeader(summary, baseProvenance);
+    const provenance = {
+        ...baseProvenance,
+        summaryBytes: Buffer.byteLength(summaryWithHeader),
+    };
+    writeFileSync(join(sessionDir, "summary.md"), summaryWithHeader);
+    writeFileSync(join(sessionDir, "summary.meta.json"), JSON.stringify(provenance, null, 2) + "\n");
+    appendFileSync(join(sessionDir, "summary.checkpoints.jsonl"), JSON.stringify(provenance) + "\n");
+}
+/**
+ * Algorithmic compaction: extract key signals from history and write per-session summaries.
+ * Each session gets its own context/{session-id}/summary.md.
+ */
+export function algorithmicCompact(sessionIds) {
+    const baseDir = getContextDir();
+    if (!existsSync(baseDir))
+        mkdirSync(baseDir, { recursive: true });
+    for (const sessionId of sessionIds) {
+        const turns = readHistory(sessionId);
+        if (turns.length === 0)
+            continue;
+        const sessionDir = join(baseDir, sessionId);
+        if (!existsSync(sessionDir))
+            mkdirSync(sessionDir, { recursive: true });
+        const sections = [];
+        const tasks = [];
+        const fileCounts = new Map();
+        const decisions = [];
+        const errors = [];
+        for (const turn of turns) {
+            if (turn.type === "prompt") {
+                tasks.push(turn.content);
+            }
+            if (turn.type === "response") {
+                for (const line of turn.content.split("\n")) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    if (DECISION_KEYWORDS.test(trimmed)) {
+                        decisions.push(trimmed);
+                    }
+                    if (ERROR_KEYWORDS.test(trimmed)) {
+                        errors.push(trimmed);
+                    }
+                }
+            }
+            if (turn.files) {
+                for (const file of turn.files) {
+                    fileCounts.set(file, (fileCounts.get(file) ?? 0) + 1);
+                }
+            }
+        }
+        sections.push(`${turns.length} turns`);
+        sections.push("");
+        if (tasks.length > 0) {
+            sections.push("### Key tasks");
+            const uniqueTasks = [...new Set(tasks)];
+            for (const task of uniqueTasks.slice(-20)) {
+                sections.push(`- ${truncate(task, 150)}`);
+            }
+            sections.push("");
+        }
+        if (fileCounts.size > 0) {
+            sections.push("### Files modified");
+            const sorted = [...fileCounts.entries()].sort((a, b) => b[1] - a[1]);
+            for (const [file, count] of sorted) {
+                sections.push(`- ${file} (${count} time${count > 1 ? "s" : ""})`);
+            }
+            sections.push("");
+        }
+        if (decisions.length > 0) {
+            sections.push("### Key decisions");
+            for (const d of decisions.slice(-10)) {
+                sections.push(`- ${truncate(d, 200)}`);
+            }
+            sections.push("");
+        }
+        if (errors.length > 0) {
+            sections.push("### Errors & blockers");
+            for (const e of errors.slice(-10)) {
+                sections.push(`- ${truncate(e, 200)}`);
+            }
+            sections.push("");
+        }
+        let content = sections.join("\n");
+        // Enforce size limit
+        if (content.length > MAX_SUMMARY_BYTES) {
+            content = content.slice(0, MAX_SUMMARY_BYTES);
+        }
+        writeSummaryArtifacts(sessionDir, sessionId, "algorithmic", turns, content);
+    }
+}
+/**
+ * LLM-powered compaction: send each session's history to claude for summarization.
+ * Each session gets its own context/{session-id}/summary.md.
+ */
+export function llmCompact(sessionIds) {
+    const baseDir = getContextDir();
+    if (!existsSync(baseDir))
+        mkdirSync(baseDir, { recursive: true });
+    for (const sessionId of sessionIds) {
+        const turns = readHistory(sessionId, { lastN: 200 });
+        if (turns.length === 0)
+            continue;
+        const sessionDir = join(baseDir, sessionId);
+        if (!existsSync(sessionDir))
+            mkdirSync(sessionDir, { recursive: true });
+        const historyParts = [];
+        historyParts.push(`=== Session: ${sessionId} (${turns.length} turns) ===`);
+        for (const turn of turns) {
+            const time = turn.ts.slice(11, 16);
+            if (turn.type === "prompt") {
+                historyParts.push(`[${time}] User: ${turn.content}`);
+            }
+            else if (turn.type === "response") {
+                historyParts.push(`[${time}] Agent: ${truncate(turn.content, 1000)}`);
+                if (turn.files && turn.files.length > 0) {
+                    historyParts.push(`  Files: ${turn.files.join(", ")}`);
+                }
+            }
+            else if (turn.type === "git") {
+                historyParts.push(`[${time}] Git: ${turn.content}`);
+                if (turn.files) {
+                    historyParts.push(`  Files: ${turn.files.join(", ")}`);
+                }
+            }
+        }
+        const history = historyParts.join("\n");
+        if (!history.trim())
+            continue;
+        const prompt = "Summarize the following agent session history. " +
+            "List: key tasks completed, files modified, " +
+            "important decisions made, and any errors or blockers encountered. " +
+            "Be concise but thorough. Output markdown.\n\n" +
+            history;
+        try {
+            // Find compactCommand from any tool that has one configured
+            const config = loadConfig();
+            const compactCmd = Object.values(config.tools).find((t) => t.compactCommand)?.compactCommand ??
+                "claude --print --output-format text";
+            const output = execSync(compactCmd, {
+                input: prompt,
+                encoding: "utf-8",
+                timeout: 60_000,
+                maxBuffer: 1024 * 1024,
+            });
+            let summary = output;
+            if (summary.length > MAX_SUMMARY_BYTES) {
+                summary = summary.slice(0, MAX_SUMMARY_BYTES);
+            }
+            writeSummaryArtifacts(sessionDir, sessionId, "llm", turns, summary);
+        }
+        catch {
+            // If claude CLI fails for this session, fall back to algorithmic for just this session
+            algorithmicCompact([sessionId]);
+        }
+    }
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + "...";
+}
+//# sourceMappingURL=compactor.js.map

package/dist/context/compactor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.js","sourceRoot":"","sources":["../../src/context/compactor.ts"],"names":[],"mappings":"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"}

package/dist/context/context-bridge.d.ts

@@ -0,0 +1,67 @@
+import { type TmuxTarget } from "../tmux-runtime-manager.js";
+/**
+ * Capture git diff and write a context entry on session exit.
+ */
+export declare function captureGitContext(sessionName: string, tool: string): Promise<void>;
+/**
+ * Live context watcher. Tmux pane snapshots are the primary continuity source:
+ * they keep `live.md` current and backfill append-only history when a tool settles.
+ *
+ * Raw terminal recordings are kept as secondary audit/backfill artifacts only.
+ * They may yield extra turns when available, but continuity should not depend on
+ * recordings existing or parsing perfectly.
+ */
+export declare class ContextWatcher {
+    private readonly capturePane;
+    constructor(capturePane?: (target: TmuxTarget) => string);
+    private interval;
+    private sessions;
+    /** Track how far we've read into each session's secondary raw recording */
+    private readOffsets;
+    /** Track last turn type per session to detect response→prompt transitions */
+    private lastTurnTypes;
+    /** Hash of last git diff output for change detection */
+    private lastDiffHash;
+    /** Total turn count across all sessions, for compaction trigger */
+    private totalTurnCount;
+    /** Track which sessions have new turns since last write */
+    private dirtySessions;
+    /** Track last pane snapshot hash per session for tmux-backed live context. */
+    private paneSnapshotHashes;
+    private panePromptVisible;
+    updateSessions(sessions: Array<{
+        id: string;
+        command: string;
+        turnPatterns?: RegExp[];
+        tmuxTarget?: TmuxTarget;
+    }>): void;
+    start(intervalMs?: number): void;
+    stop(): void;
+    syncNow(sessionId?: string): Promise<void>;
+    private initOffset;
+    private recordingPath;
+    private tick;
+    /**
+     * Read new content from a session's raw recording since our last read offset.
+     * This is a secondary audit/backfill path; tmux pane capture is primary.
+     */
+    private extractNewContent;
+    private capturePaneSnapshot;
+    /**
+     * Check for git changes and append a git turn to history if files changed.
+     */
+    private captureGitDiff;
+    /**
+     * Write per-session live context from history JSONL files.
+     * Each session gets its own context/{session-id}/live.md.
+     */
+    private writeLiveContext;
+    /**
+     * Build live.md content for a single session from its history.
+     */
+    private buildSessionLiveContent;
+}
+/** Get recent stripped output from a session's raw recording as a fallback/debug aid. */
+export declare function getRecentOutput(sessionId: string, maxLines?: number): string;
+/** Build a context preamble for a new session from other sessions' per-session context files. */
+export declare function buildContextPreamble(otherSessionIds: string[], maxLinesPerSession?: number): string;