@damaall/ccx 0.1.0

package/dist/core/session-discovery.d.ts

@@ -0,0 +1,26 @@
+export interface SubagentDiscovery {
+    readonly sessionId: string;
+    readonly projectPath: string;
+    readonly subagentsDir: string;
+    readonly agentFiles: readonly AgentFileInfo[];
+}
+export interface AgentFileInfo {
+    readonly filePath: string;
+    readonly agentId: string;
+    readonly sizeBytes: number;
+}
+/**
+ * 根據 leadSessionId 找到 subagents 目錄
+ * 掃描所有 project 目錄下的 session 目錄
+ */
+export declare function discoverSubagents(leadSessionId: string): Promise<SubagentDiscovery | null>;
+/**
+ * 列出 subagents 目錄下的所有 agent JSONL 檔案
+ */
+export declare function listAgentFiles(subagentsDir: string): Promise<AgentFileInfo[]>;
+/**
+ * 監測新的 agent JSONL 出現（watch 模式用）
+ * 比較當前檔案列表和已知列表，回傳新增的
+ */
+export declare function findNewAgentFiles(current: readonly AgentFileInfo[], known: ReadonlySet<string>): AgentFileInfo[];
+//# sourceMappingURL=session-discovery.d.ts.map

package/dist/core/session-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-discovery.d.ts","sourceRoot":"","sources":["../../src/core/session-discovery.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqChG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BnF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB,aAAa,EAAE,CAEjB"}

package/dist/core/session-discovery.js

@@ -0,0 +1,89 @@
+/**
+ * SessionDiscovery：掃描 projects/ 建立 sessionId → subagents path 索引
+ *
+ * Claude Code 的目錄結構：
+ *   ~/.claude/projects/{encoded-project-path}/{sessionId}/subagents/agent-{id}.jsonl
+ *
+ * 目標：給定 leadSessionId，找到對應的 subagents 目錄
+ */
+import { readdir, access, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { claudePaths } from './paths.js';
+/**
+ * 根據 leadSessionId 找到 subagents 目錄
+ * 掃描所有 project 目錄下的 session 目錄
+ */
+export async function discoverSubagents(leadSessionId) {
+    const projectsDir = claudePaths.projects;
+    try {
+        const projectEntries = await readdir(projectsDir, { withFileTypes: true });
+        for (const projectEntry of projectEntries) {
+            if (!projectEntry.isDirectory())
+                continue;
+            const projectPath = projectEntry.name;
+            const sessionDir = join(projectsDir, projectPath, leadSessionId);
+            try {
+                await access(sessionDir);
+            }
+            catch {
+                continue;
+            }
+            const subagentsDir = join(sessionDir, 'subagents');
+            try {
+                await access(subagentsDir);
+            }
+            catch {
+                continue;
+            }
+            const agentFiles = await listAgentFiles(subagentsDir);
+            return {
+                sessionId: leadSessionId,
+                projectPath,
+                subagentsDir,
+                agentFiles,
+            };
+        }
+    }
+    catch {
+        // projects 目錄不存在
+    }
+    return null;
+}
+/**
+ * 列出 subagents 目錄下的所有 agent JSONL 檔案
+ */
+export async function listAgentFiles(subagentsDir) {
+    try {
+        const entries = await readdir(subagentsDir);
+        const agentFiles = [];
+        for (const entry of entries) {
+            if (!entry.startsWith('agent-') || !entry.endsWith('.jsonl'))
+                continue;
+            const agentId = entry.replace('agent-', '').replace('.jsonl', '');
+            const filePath = join(subagentsDir, entry);
+            try {
+                const fileStat = await stat(filePath);
+                agentFiles.push({
+                    filePath,
+                    agentId,
+                    sizeBytes: fileStat.size,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+        return agentFiles.sort((a, b) => a.agentId.localeCompare(b.agentId));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 監測新的 agent JSONL 出現（watch 模式用）
+ * 比較當前檔案列表和已知列表，回傳新增的
+ */
+export function findNewAgentFiles(current, known) {
+    return current.filter(f => !known.has(f.agentId));
+}
+//# sourceMappingURL=session-discovery.js.map

package/dist/core/session-discovery.js.map

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

package/dist/core/snapshot-manager.d.ts

@@ -0,0 +1,29 @@
+import type { StateAggregator } from './state-aggregator.js';
+export declare class SnapshotManager {
+    private readonly aggregator;
+    private readonly sessionName;
+    private readonly sessionDir;
+    private debounceTimer;
+    private initialized;
+    private finalized;
+    constructor(aggregator: StateAggregator, teamName: string);
+    get sessionPath(): string;
+    get name(): string;
+    /**
+     * 初始化：建立目錄 + 寫入 initial snapshot
+     */
+    initialize(): Promise<void>;
+    /**
+     * Finalize：取消 debounce timer + 寫入最終 snapshot
+     */
+    finalize(): Promise<void>;
+    /**
+     * Debounced write schedule
+     */
+    private scheduleWrite;
+    /**
+     * 實際寫入 snapshot 到磁碟
+     */
+    private writeSnapshot;
+}
+//# sourceMappingURL=snapshot-manager.d.ts.map

package/dist/core/snapshot-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-manager.d.ts","sourceRoot":"","sources":["../../src/core/snapshot-manager.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAK5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAQ;gBAEb,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM;IAazD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;YACW,aAAa;CAoC5B"}

package/dist/core/snapshot-manager.js

@@ -0,0 +1,120 @@
+/**
+ * SnapshotManager：event-driven + debounced 快照寫入
+ *
+ * 設計：
+ * - trailing-edge debounce 500ms（多事件合併成一次寫入）
+ * - 寫入 ~/.ccx/sessions/{team}-{timestamp}/
+ * - Atomic write（寫 .tmp → rename）
+ * - SIGINT 時 finalize
+ */
+import { mkdir, writeFile, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { stringify } from 'yaml';
+import { ccxPaths } from './paths.js';
+const DEBOUNCE_MS = 500;
+export class SnapshotManager {
+    aggregator;
+    sessionName;
+    sessionDir;
+    debounceTimer = null;
+    initialized = false;
+    finalized = false;
+    constructor(aggregator, teamName) {
+        this.aggregator = aggregator;
+        const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        this.sessionName = `${teamName}-${ts}`;
+        this.sessionDir = ccxPaths.session(this.sessionName);
+        // 監聽 state events → debounced write
+        this.aggregator.on('event', (event) => {
+            if (this.finalized)
+                return;
+            this.scheduleWrite();
+        });
+    }
+    get sessionPath() {
+        return this.sessionDir;
+    }
+    get name() {
+        return this.sessionName;
+    }
+    /**
+     * 初始化：建立目錄 + 寫入 initial snapshot
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await mkdir(this.sessionDir, { recursive: true, mode: 0o700 });
+        await this.writeSnapshot();
+        this.initialized = true;
+    }
+    /**
+     * Finalize：取消 debounce timer + 寫入最終 snapshot
+     */
+    async finalize() {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        await this.writeSnapshot(true);
+    }
+    /**
+     * Debounced write schedule
+     */
+    scheduleWrite() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(async () => {
+            this.debounceTimer = null;
+            await this.writeSnapshot();
+        }, DEBOUNCE_MS);
+    }
+    /**
+     * 實際寫入 snapshot 到磁碟
+     */
+    async writeSnapshot(isFinal = false) {
+        const state = this.aggregator.getState();
+        const snapshot = {
+            teamName: state.teamName,
+            sessionId: this.sessionName,
+            startedAt: state.startedAt,
+            lastUpdatedAt: Date.now(),
+            finalized: isFinal,
+            agents: state.agents.map(a => ({
+                agentId: a.agentId,
+                name: a.name,
+                model: a.model,
+                tokenUsage: a.tokenUsage,
+                cost: a.cost,
+                status: a.status,
+            })),
+            tasks: state.tasks,
+            totalCost: state.totalCost,
+            totalTokens: state.totalTokens,
+            alerts: state.alerts,
+        };
+        try {
+            await mkdir(this.sessionDir, { recursive: true, mode: 0o700 });
+            await atomicWriteYaml(join(this.sessionDir, 'snapshot.yaml'), snapshot);
+            this.aggregator.emit('event', {
+                type: 'snapshot_written',
+                path: this.sessionDir,
+            });
+        }
+        catch (err) {
+            // Snapshot 寫入失敗不應該 crash watch
+            // 靜默忽略，下次 debounce 再試
+        }
+    }
+}
+// ─── Atomic write ───
+async function atomicWriteYaml(targetPath, data) {
+    const tmpPath = `${targetPath}.tmp`;
+    const content = stringify(data, { indent: 2 });
+    await writeFile(tmpPath, content, { encoding: 'utf-8', mode: 0o600 });
+    await rename(tmpPath, targetPath);
+}
+//# sourceMappingURL=snapshot-manager.js.map

package/dist/core/snapshot-manager.js.map

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

package/dist/core/snapshot-reader.d.ts

@@ -0,0 +1,23 @@
+import type { SessionSnapshot } from './types.js';
+/**
+ * 列出所有 saved sessions
+ */
+export declare function listSessions(): Promise<SessionInfo[]>;
+export interface SessionInfo {
+    readonly name: string;
+    readonly teamName: string;
+    readonly startedAt: number;
+    readonly lastUpdatedAt: number;
+    readonly finalized: boolean;
+    readonly totalCost: number;
+    readonly agentCount: number;
+}
+/**
+ * 讀取 snapshot YAML
+ */
+export declare function readSnapshot(sessionName: string): Promise<SessionSnapshot | null>;
+/**
+ * 根據 session name 或 team name 查找 snapshot
+ */
+export declare function findSnapshot(nameOrTeam: string): Promise<SessionSnapshot | null>;
+//# sourceMappingURL=snapshot-reader.d.ts.map

package/dist/core/snapshot-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-reader.d.ts","sourceRoot":"","sources":["../../src/core/snapshot-reader.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAmD,MAAM,YAAY,CAAA;AAGlG;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAyB3D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CASvF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBtF"}

package/dist/core/snapshot-reader.js

@@ -0,0 +1,142 @@
+/**
+ * SnapshotReader：讀取 ~/.ccx/sessions/ 下的 snapshot
+ *
+ * 資料來源優先級：
+ * 1. ~/.claude/teams/* 仍存在 → 用 watcher 讀即時資料
+ * 2. ~/.claude/teams/* 已刪除 → 讀 ~/.ccx/sessions/* 副本
+ * 3. 都沒有 → 報錯
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { ccxPaths } from './paths.js';
+import { emptyUsage } from './pricing.js';
+/**
+ * 列出所有 saved sessions
+ */
+export async function listSessions() {
+    try {
+        const entries = await readdir(ccxPaths.sessions, { withFileTypes: true });
+        const sessions = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const snapshot = await readSnapshot(entry.name);
+            if (snapshot) {
+                sessions.push({
+                    name: entry.name,
+                    teamName: snapshot.teamName,
+                    startedAt: snapshot.startedAt,
+                    lastUpdatedAt: snapshot.lastUpdatedAt,
+                    finalized: snapshot.finalized,
+                    totalCost: snapshot.totalCost,
+                    agentCount: snapshot.agents.length,
+                });
+            }
+        }
+        return sessions.sort((a, b) => b.lastUpdatedAt - a.lastUpdatedAt);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 讀取 snapshot YAML
+ */
+export async function readSnapshot(sessionName) {
+    const snapshotPath = join(ccxPaths.sessions, sessionName, 'snapshot.yaml');
+    try {
+        const raw = await readFile(snapshotPath, 'utf-8');
+        const data = parseYaml(raw);
+        return normalizeSnapshot(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 根據 session name 或 team name 查找 snapshot
+ */
+export async function findSnapshot(nameOrTeam) {
+    // 精確匹配 session name
+    const exact = await readSnapshot(nameOrTeam);
+    if (exact)
+        return exact;
+    // 模糊匹配 team name（取最新的）
+    const sessions = await listSessions();
+    const matching = sessions.filter(s => s.teamName === nameOrTeam);
+    if (matching.length > 0) {
+        return readSnapshot(matching[0].name);
+    }
+    // 前綴匹配
+    const prefixMatch = sessions.find(s => s.name.startsWith(nameOrTeam));
+    if (prefixMatch) {
+        return readSnapshot(prefixMatch.name);
+    }
+    return null;
+}
+// ─── YAML normalization ───
+function normalizeSnapshot(data) {
+    if (!data || typeof data !== 'object')
+        return null;
+    const d = data;
+    return {
+        teamName: String(d.teamName ?? 'unknown'),
+        sessionId: String(d.sessionId ?? ''),
+        startedAt: Number(d.startedAt ?? 0),
+        lastUpdatedAt: Number(d.lastUpdatedAt ?? 0),
+        finalized: Boolean(d.finalized ?? false),
+        agents: normalizeAgents(d.agents),
+        tasks: normalizeTasks(d.tasks),
+        totalCost: Number(d.totalCost ?? 0),
+        totalTokens: normalizeUsage(d.totalTokens),
+        alerts: normalizeAlerts(d.alerts),
+    };
+}
+function normalizeAgents(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map(a => ({
+        agentId: String(a?.agentId ?? ''),
+        name: String(a?.name ?? ''),
+        model: String(a?.model ?? ''),
+        tokenUsage: normalizeUsage(a?.tokenUsage),
+        cost: Number(a?.cost ?? 0),
+        status: a?.status ?? 'unknown',
+    }));
+}
+function normalizeTasks(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map(t => ({
+        id: String(t?.id ?? ''),
+        subject: String(t?.subject ?? ''),
+        description: String(t?.description ?? ''),
+        activeForm: String(t?.activeForm ?? ''),
+        owner: String(t?.owner ?? ''),
+        status: t?.status ?? 'pending',
+        blocks: Array.isArray(t?.blocks) ? t.blocks.map(String) : [],
+        blockedBy: Array.isArray(t?.blockedBy) ? t.blockedBy.map(String) : [],
+    }));
+}
+function normalizeUsage(raw) {
+    if (!raw || typeof raw !== 'object')
+        return emptyUsage();
+    const u = raw;
+    return {
+        input_tokens: Number(u.input_tokens ?? 0),
+        output_tokens: Number(u.output_tokens ?? 0),
+        cache_creation_input_tokens: Number(u.cache_creation_input_tokens ?? 0),
+        cache_read_input_tokens: Number(u.cache_read_input_tokens ?? 0),
+    };
+}
+function normalizeAlerts(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map(a => ({
+        level: a?.level ?? 'info',
+        message: String(a?.message ?? ''),
+        timestamp: Number(a?.timestamp ?? 0),
+    }));
+}
+//# sourceMappingURL=snapshot-reader.js.map

package/dist/core/snapshot-reader.js.map

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

package/dist/core/state-aggregator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * StateAggregator：純計算層，解耦 readers 和 consumers
+ *
+ * 接收所有 reader 的輸出 → 計算統一的 TeamState → 發射 events
+ */
+import { EventEmitter } from 'node:events';
+import type { TeamConfig, TaskData, TeamState, FileCursor } from './types.js';
+import type { InboxData } from './inbox-reader.js';
+export declare class StateAggregator extends EventEmitter {
+    private teamConfig;
+    private tasks;
+    private inboxes;
+    private cursors;
+    private alerts;
+    private startedAt;
+    private budget;
+    private stuckThresholdMs;
+    constructor(options?: {
+        budget?: number;
+        stuckThresholdMs?: number;
+    });
+    updateTeamConfig(config: TeamConfig): void;
+    updateTasks(tasks: TaskData[]): void;
+    updateInbox(inbox: InboxData): void;
+    updateCursor(cursor: FileCursor): void;
+    markTeamDeleted(): void;
+    getState(): TeamState;
+    private buildAgentState;
+    private inferAgentStatus;
+    private computeTotalTokens;
+    private computeTotalCost;
+    private lastBudgetLevel;
+    private checkBudgetThresholds;
+    private addAlert;
+}
+//# sourceMappingURL=state-aggregator.d.ts.map

package/dist/core/state-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-aggregator.d.ts","sourceRoot":"","sources":["../../src/core/state-aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EAGR,SAAS,EAGT,UAAU,EAEX,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAMlD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE;IAQpE,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAK1C,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAOpC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAInC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAsBtC,eAAe,IAAI,IAAI;IAMvB,QAAQ,IAAI,SAAS;IAqBrB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe,CAAI;IAE3B,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,QAAQ;CAGjB"}