aimux-cli 0.1.0

package/dist/paths.js

@@ -0,0 +1,259 @@
+/**
+ * Central path resolution for aimux.
+ *
+ * Two locations:
+ *   - In-repo:  {repoRoot}/.aimux/  → agent-facing shared artifacts
+ *                (config, team, plans, context, history, tasks, status, threads, sessions.json)
+ *   - Global:   ~/.aimux/projects/<project-id>/  → runtime-private state
+ *                (recordings, metadata, instance ownership, statusline internals, offline state)
+ *
+ * Must call `await initPaths(cwd)` once at startup before using sync path functions.
+ */
+import { createHash } from "node:crypto";
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, readdirSync } from "node:fs";
+import { join, basename, resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+// ── Cached state (populated by initPaths) ──────────────────────────
+let _repoRoot = null;
+let _projectId = null;
+function assertInitialized() {
+    if (!_repoRoot || !_projectId) {
+        throw new Error("paths not initialized — call initPaths() first");
+    }
+}
+// ── Project ID resolution ──────────────────────────────────────────
+function resolveRepoRoot(cwd) {
+    try {
+        const gitCommonDir = execSync("git rev-parse --git-common-dir", {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        // gitCommonDir is either ".git" (main worktree) or an absolute path
+        const absGitDir = resolve(cwd, gitCommonDir);
+        return dirname(absGitDir);
+    }
+    catch {
+        // Not a git repo — use cwd
+        return resolve(cwd);
+    }
+}
+function computeProjectId(repoRoot) {
+    const hash = createHash("sha256").update(repoRoot).digest("hex").slice(0, 12);
+    const name = basename(repoRoot);
+    return `${name}-${hash}`;
+}
+export async function initPaths(cwd) {
+    const dir = cwd ?? process.cwd();
+    _repoRoot = resolveRepoRoot(dir);
+    _projectId = computeProjectId(_repoRoot);
+    // Ensure global project dir exists
+    const projectDir = getProjectStateDir();
+    if (!existsSync(projectDir)) {
+        mkdirSync(projectDir, { recursive: true });
+    }
+    writeFileSync(join(projectDir, "project-root.txt"), `${_repoRoot}\n`);
+    ensureLocalSharedDirs();
+    migrateAgentFacingStateToLocal();
+    registerProject();
+}
+export function getRepoRoot() {
+    assertInitialized();
+    return _repoRoot;
+}
+export function getProjectId() {
+    assertInitialized();
+    return _projectId;
+}
+export function getProjectIdFor(cwd) {
+    return computeProjectId(resolveRepoRoot(cwd));
+}
+export function getProjectStateDirFor(cwd) {
+    return join(getGlobalAimuxDir(), "projects", getProjectIdFor(cwd));
+}
+export function getProjectStateDirById(projectId) {
+    return join(getGlobalAimuxDir(), "projects", projectId);
+}
+// ── Global paths (~/.aimux/...) ────────────────────────────────────
+const HOME = homedir();
+export function getGlobalAimuxDir() {
+    return join(HOME, ".aimux");
+}
+export function getDaemonDir() {
+    return join(getGlobalAimuxDir(), "daemon");
+}
+export function getDaemonInfoPath() {
+    return join(getDaemonDir(), "daemon.json");
+}
+export function getDaemonStatePath() {
+    return join(getDaemonDir(), "state.json");
+}
+export function getProjectStateDir() {
+    assertInitialized();
+    return join(getGlobalAimuxDir(), "projects", _projectId);
+}
+export function getStatePath() {
+    return join(getProjectStateDir(), "state.json");
+}
+export function getGraveyardPath() {
+    return join(getProjectStateDir(), "graveyard.json");
+}
+export function getContextDir() {
+    return join(getLocalAimuxDir(), "context");
+}
+export function getContextPathForDate(date) {
+    const yyyy = date.getFullYear();
+    const mm = String(date.getMonth() + 1).padStart(2, "0");
+    const dd = String(date.getDate()).padStart(2, "0");
+    return join(getContextDir(), `${yyyy}-${mm}-${dd}.md`);
+}
+export function getHistoryDir() {
+    return join(getLocalAimuxDir(), "history");
+}
+export function getRecordingsDir() {
+    return join(getProjectStateDir(), "recordings");
+}
+export function getTasksDir() {
+    return join(getLocalAimuxDir(), "tasks");
+}
+export function getStatusDir() {
+    return join(getLocalAimuxDir(), "status");
+}
+export function getInstancesPath() {
+    return join(getProjectStateDir(), "instances.json");
+}
+export function getMetadataPath() {
+    return join(getProjectStateDir(), "metadata.json");
+}
+export function getNotificationsPath() {
+    return join(getProjectStateDir(), "notifications.json");
+}
+export function getNotificationContextPath() {
+    return join(getProjectStateDir(), "notification-context.json");
+}
+export function getMetadataEndpointPath() {
+    return join(getProjectStateDir(), "metadata-api.json");
+}
+// ── In-repo paths ({repoRoot}/.aimux/...) ──────────────────────────
+export function getLocalAimuxDir() {
+    assertInitialized();
+    return join(_repoRoot, ".aimux");
+}
+export function getConfigPath() {
+    return join(getLocalAimuxDir(), "config.json");
+}
+export function getProjectTeamPath() {
+    return join(getLocalAimuxDir(), "team.json");
+}
+export function getPlansDir() {
+    return join(getLocalAimuxDir(), "plans");
+}
+export function getThreadsDir() {
+    return join(getLocalAimuxDir(), "threads");
+}
+export function getAttachmentsDir() {
+    return join(getLocalAimuxDir(), "attachments");
+}
+export function getSessionMessagesDir() {
+    return join(getLocalAimuxDir(), "session-messages");
+}
+/** Escape hatch for cross-worktree operations. Prefer the no-arg variants above. */
+export function getAimuxDirFor(cwd) {
+    return join(resolveRepoRoot(cwd), ".aimux");
+}
+function ensureLocalSharedDirs() {
+    const localDir = getLocalAimuxDir();
+    mkdirSync(localDir, { recursive: true });
+    for (const subdir of [
+        "plans",
+        "context",
+        "history",
+        "tasks",
+        "status",
+        "threads",
+        "attachments",
+        "session-messages",
+    ]) {
+        mkdirSync(join(localDir, subdir), { recursive: true });
+    }
+}
+function migrateDirIfNeeded(globalSubdir, localDir) {
+    const source = join(getProjectStateDir(), globalSubdir);
+    if (!existsSync(source) || !existsSync(localDir))
+        return;
+    const hasLocalEntries = (() => {
+        try {
+            return readdirSync(localDir).length > 0;
+        }
+        catch {
+            return false;
+        }
+    })();
+    if (hasLocalEntries)
+        return;
+    try {
+        cpSync(source, localDir, { recursive: true, force: false });
+    }
+    catch { }
+}
+function migrateAgentFacingStateToLocal() {
+    migrateDirIfNeeded("context", getContextDir());
+    migrateDirIfNeeded("history", getHistoryDir());
+    migrateDirIfNeeded("tasks", getTasksDir());
+    migrateDirIfNeeded("status", getStatusDir());
+}
+// ── Global non-project paths ───────────────────────────────────────
+export function getGlobalConfigPath() {
+    return join(getGlobalAimuxDir(), "config.json");
+}
+export function getGlobalTeamPath() {
+    return join(getGlobalAimuxDir(), "team.json");
+}
+export function getProjectsRegistryPath() {
+    return join(getGlobalAimuxDir(), "projects.json");
+}
+function loadRegistry() {
+    const path = getProjectsRegistryPath();
+    if (!existsSync(path))
+        return { version: 1, projects: [] };
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return { version: 1, projects: [] };
+    }
+}
+function saveRegistry(registry) {
+    const dir = getGlobalAimuxDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(getProjectsRegistryPath(), JSON.stringify(registry, null, 2) + "\n");
+}
+function registerProject() {
+    assertInitialized();
+    const registry = loadRegistry();
+    const idx = registry.projects.findIndex((p) => p.id === _projectId);
+    const entry = {
+        id: _projectId,
+        name: basename(_repoRoot),
+        repoRoot: _repoRoot,
+        lastSeen: new Date().toISOString(),
+    };
+    if (idx >= 0) {
+        registry.projects[idx] = entry;
+    }
+    else {
+        registry.projects.push(entry);
+    }
+    saveRegistry(registry);
+}
+export function listProjects() {
+    return loadRegistry().projects;
+}
+export function removeProject(id) {
+    const registry = loadRegistry();
+    registry.projects = registry.projects.filter((p) => p.id !== id);
+    saveRegistry(registry);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/plugin-runtime.d.ts

@@ -0,0 +1,46 @@
+import { type MetadataTone, type MetadataApiEndpoint, type SessionContextMetadata, type SessionServiceMetadata } from "./metadata-store.js";
+import type { AgentActivityState, AgentAttentionState, AgentEvent } from "./agent-events.js";
+import { type AlertKind, type ProjectEventBus } from "./project-events.js";
+export interface AimuxMetadataAPI {
+    setStatus(session: string, text: string, tone?: MetadataTone): void;
+    setProgress(session: string, current: number, total: number, label?: string): void;
+    log(session: string, message: string, opts?: {
+        source?: string;
+        tone?: MetadataTone;
+    }): void;
+    clearLog(session: string): void;
+    setContext(session: string, context: SessionContextMetadata): void;
+    setServices(session: string, services: SessionServiceMetadata[]): void;
+    emitEvent(session: string, event: AgentEvent): void;
+    markSeen(session: string): void;
+    setActivity(session: string, activity: AgentActivityState): void;
+    setAttention(session: string, attention: AgentAttentionState): void;
+}
+export interface AimuxPluginAPI {
+    projectRoot: string;
+    projectId: string;
+    serverHost: string;
+    serverPort: number;
+    metadata: AimuxMetadataAPI;
+}
+export interface AimuxPluginInstance {
+    start?(): void | Promise<void>;
+    stop?(): void | Promise<void>;
+}
+export declare class PluginRuntime {
+    private readonly endpoint;
+    private readonly eventBus?;
+    private instances;
+    constructor(endpoint: MetadataApiEndpoint, eventBus?: ProjectEventBus | undefined);
+    private publishEventAlert;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function deriveAlertFromAgentEvent(sessionId: string, event: AgentEvent): {
+    kind: AlertKind;
+    sessionId: string;
+    title: string;
+    message: string;
+    dedupeKey: string;
+    cooldownMs: number;
+} | undefined;

package/dist/plugin-runtime.js

@@ -0,0 +1,180 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { getGlobalAimuxDir, getLocalAimuxDir, getProjectId, getRepoRoot } from "./paths.js";
+import { updateSessionMetadata, clearSessionLogs, } from "./metadata-store.js";
+import { debug } from "./debug.js";
+import { createBuiltinMetadataWatchers } from "./builtin-metadata-watchers.js";
+import { AgentTracker } from "./agent-tracker.js";
+import { createToolOutputWatcher } from "./tool-output-watchers.js";
+function listPluginFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((entry) => entry.endsWith(".js") || entry.endsWith(".mjs"))
+        .map((entry) => join(dir, entry))
+        .filter((path) => statSync(path).isFile());
+}
+export class PluginRuntime {
+    endpoint;
+    eventBus;
+    instances = [];
+    constructor(endpoint, eventBus) {
+        this.endpoint = endpoint;
+        this.eventBus = eventBus;
+    }
+    publishEventAlert(sessionId, event) {
+        if (!this.eventBus)
+            return;
+        const alert = deriveAlertFromAgentEvent(sessionId, event);
+        if (!alert)
+            return;
+        this.eventBus.publishAlert(alert);
+    }
+    async start() {
+        const tracker = new AgentTracker();
+        const api = {
+            projectRoot: getRepoRoot(),
+            projectId: getProjectId(),
+            serverHost: this.endpoint.host,
+            serverPort: this.endpoint.port,
+            metadata: {
+                setStatus: (session, text, tone) => {
+                    updateSessionMetadata(session, (current) => ({
+                        ...current,
+                        status: { text, tone },
+                    }));
+                },
+                setProgress: (session, current, total, label) => {
+                    updateSessionMetadata(session, (existing) => ({
+                        ...existing,
+                        progress: { current, total, label },
+                    }));
+                },
+                log: (session, message, opts) => {
+                    updateSessionMetadata(session, (existing) => ({
+                        ...existing,
+                        logs: [
+                            ...(existing.logs ?? []).slice(-19),
+                            { message, source: opts?.source, tone: opts?.tone, ts: new Date().toISOString() },
+                        ],
+                    }));
+                },
+                clearLog: (session) => {
+                    clearSessionLogs(session);
+                },
+                setContext: (session, context) => {
+                    updateSessionMetadata(session, (existing) => ({
+                        ...existing,
+                        context: {
+                            ...(existing.context ?? {}),
+                            ...context,
+                        },
+                    }));
+                },
+                setServices: (session, services) => {
+                    updateSessionMetadata(session, (existing) => ({
+                        ...existing,
+                        derived: {
+                            ...(existing.derived ?? {}),
+                            services,
+                        },
+                    }));
+                },
+                emitEvent: (session, event) => {
+                    tracker.emit(session, event);
+                    this.publishEventAlert(session, event);
+                },
+                markSeen: (session) => {
+                    tracker.markSeen(session);
+                },
+                setActivity: (session, activity) => {
+                    tracker.setActivity(session, activity);
+                },
+                setAttention: (session, attention) => {
+                    tracker.setAttention(session, attention);
+                },
+            },
+        };
+        for (const watcher of createBuiltinMetadataWatchers(api)) {
+            if (watcher.start)
+                await watcher.start();
+            this.instances.push(watcher);
+        }
+        const outputWatcher = createToolOutputWatcher({ api });
+        if (outputWatcher.start)
+            await outputWatcher.start();
+        this.instances.push(outputWatcher);
+        const pluginFiles = [
+            ...listPluginFiles(join(getGlobalAimuxDir(), "plugins")),
+            ...listPluginFiles(join(getLocalAimuxDir(), "plugins")),
+        ];
+        for (const file of pluginFiles) {
+            try {
+                const mod = (await import(pathToFileURL(file).href));
+                if (typeof mod.default !== "function")
+                    continue;
+                const instance = await mod.default(api);
+                if (instance?.start)
+                    await instance.start();
+                if (instance)
+                    this.instances.push(instance);
+                debug(`loaded plugin ${file}`, "plugin");
+            }
+            catch (error) {
+                debug(`failed plugin ${file}: ${error instanceof Error ? error.message : String(error)}`, "plugin");
+            }
+        }
+    }
+    async stop() {
+        for (const instance of this.instances.reverse()) {
+            try {
+                await instance.stop?.();
+            }
+            catch (error) {
+                debug(`plugin stop failed: ${error instanceof Error ? error.message : String(error)}`, "plugin");
+            }
+        }
+        this.instances = [];
+    }
+}
+export function deriveAlertFromAgentEvent(sessionId, event) {
+    let kind = null;
+    if (event.kind === "needs_input")
+        kind = "needs_input";
+    else if (event.kind === "blocked")
+        kind = "blocked";
+    else if (event.kind === "task_done")
+        kind = "task_done";
+    else if (event.kind === "task_failed")
+        kind = "task_failed";
+    else if (event.kind === "notify" && event.tone === "error")
+        kind = "task_failed";
+    if (!kind)
+        return undefined;
+    const sessionLabel = sessionId.trim() || "agent";
+    const title = kind === "needs_input"
+        ? `${sessionLabel} needs input`
+        : kind === "blocked"
+            ? `${sessionLabel} is blocked`
+            : kind === "task_done"
+                ? `${sessionLabel} finished`
+                : `${sessionLabel} failed`;
+    const message = event.message?.trim() ||
+        (kind === "needs_input"
+            ? "Agent is ready for your input."
+            : kind === "blocked"
+                ? "Agent is blocked."
+                : kind === "task_done"
+                    ? "Agent completed its work."
+                    : "Agent hit an error.");
+    return {
+        kind,
+        sessionId,
+        title,
+        message,
+        dedupeKey: `${kind}:${sessionId}`,
+        cooldownMs: kind === "task_done" ? 10_000 : 15_000,
+    };
+}
+//# sourceMappingURL=plugin-runtime.js.map

package/dist/plugin-runtime.js.map

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

package/dist/project-events.d.ts

@@ -0,0 +1,36 @@
+export type AlertKind = "notification" | "needs_input" | "task_done" | "task_failed" | "blocked" | "message_waiting" | "handoff_waiting" | "task_assigned" | "review_waiting";
+export interface AlertEvent {
+    type: "alert";
+    kind: AlertKind;
+    projectId: string;
+    sessionId?: string;
+    title: string;
+    message: string;
+    ts: string;
+    threadId?: string;
+    taskId?: string;
+    worktreePath?: string;
+    dedupeKey?: string;
+}
+export interface HistoryUpdateEvent {
+    type: "history_update";
+    projectId: string;
+    sessionId: string;
+    ts: string;
+    messages: unknown[];
+    lastN?: number;
+}
+export type ProjectStreamEvent = AlertEvent | HistoryUpdateEvent;
+type ProjectEventListener = (event: ProjectStreamEvent) => void;
+export declare class ProjectEventBus {
+    private listeners;
+    private alertCooldowns;
+    subscribe(listener: ProjectEventListener): () => void;
+    publish(event: ProjectStreamEvent): void;
+    publishHistoryUpdate(input: Omit<HistoryUpdateEvent, "type" | "projectId" | "ts">): void;
+    publishAlert(alert: Omit<AlertEvent, "type" | "projectId" | "ts"> & {
+        dedupeKey?: string;
+        cooldownMs?: number;
+    }): boolean;
+}
+export {};

package/dist/project-events.js

@@ -0,0 +1,63 @@
+import { getProjectId } from "./paths.js";
+import { addNotification } from "./notifications.js";
+export class ProjectEventBus {
+    listeners = new Set();
+    alertCooldowns = new Map();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    publish(event) {
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+    publishHistoryUpdate(input) {
+        this.publish({
+            type: "history_update",
+            projectId: getProjectId(),
+            ts: new Date().toISOString(),
+            sessionId: input.sessionId,
+            messages: input.messages,
+            lastN: input.lastN,
+        });
+    }
+    publishAlert(alert) {
+        const cooldownMs = alert.cooldownMs ?? 15_000;
+        const dedupeKey = alert.dedupeKey?.trim() || undefined;
+        if (dedupeKey) {
+            const now = Date.now();
+            const until = this.alertCooldowns.get(dedupeKey) ?? 0;
+            if (until > now) {
+                return false;
+            }
+            this.alertCooldowns.set(dedupeKey, now + cooldownMs);
+        }
+        const event = {
+            type: "alert",
+            projectId: getProjectId(),
+            ts: new Date().toISOString(),
+            kind: alert.kind,
+            sessionId: alert.sessionId,
+            title: alert.title,
+            message: alert.message,
+            threadId: alert.threadId,
+            taskId: alert.taskId,
+            worktreePath: alert.worktreePath,
+            dedupeKey,
+        };
+        addNotification({
+            title: event.title,
+            body: event.message,
+            sessionId: event.sessionId,
+            kind: event.kind,
+            dedupeKey: event.dedupeKey,
+            createdAt: event.ts,
+        });
+        this.publish(event);
+        return true;
+    }
+}
+//# sourceMappingURL=project-events.js.map

package/dist/project-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-events.js","sourceRoot":"","sources":["../src/project-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAwCrD,MAAM,OAAO,eAAe;IAClB,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,SAAS,CAAC,QAA8B;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAyB;QAC/B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,KAA4D;QAC/E,IAAI,CAAC,OAAO,CAAC;YACX,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,YAAY,EAAE;YACzB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CACV,KAGC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC;QAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACvD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,GAAG,UAAU,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,YAAY,EAAE;YACzB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS;SACW,CAAC;QAEvB,eAAe,CAAC;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,OAAO;YACnB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,EAAE;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/project-scanner.d.ts

@@ -0,0 +1,38 @@
+import { TmuxRuntimeManager } from "./tmux-runtime-manager.js";
+export interface GlobalSession {
+    id: string;
+    tool: string;
+    status: "running" | "idle" | "waiting" | "offline";
+    label?: string;
+    headline?: string;
+    role?: string;
+    worktreePath?: string;
+    ownerPid?: number;
+}
+export interface ProjectInfo {
+    name: string;
+    path: string;
+    sessions: GlobalSession[];
+}
+export interface DesktopProjectInfo {
+    id: string;
+    name: string;
+    path: string;
+    lastSeen?: string;
+    dashboardSessionName: string;
+    sessions: GlobalSession[];
+}
+/**
+ * Discover local projects with aimux state.
+ * Uses the global projects registry plus filesystem scanning as fallback.
+ */
+export declare function discoverProjects(): string[];
+/**
+ * Scan a single project for all sessions (running + offline).
+ */
+export declare function scanProject(projectPath: string): ProjectInfo;
+/**
+ * Scan all discovered projects and return global state.
+ */
+export declare function scanAllProjects(): ProjectInfo[];
+export declare function listDesktopProjects(tmux?: TmuxRuntimeManager): DesktopProjectInfo[];