@coralai/sps-cli 0.49.16 → 0.50.1

package/dist/services/ChatService.d.ts

@@ -0,0 +1,62 @@
+import type { Clock } from '../infra/clock.js';
+import type { FileSystem } from '../infra/filesystem.js';
+import type { DomainEventBus } from '../shared/domainEvents.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export interface ChatMessage {
+    readonly id: string;
+    readonly role: 'user' | 'assistant' | 'system' | 'error';
+    readonly content: string;
+    readonly ts: string;
+    readonly blocks?: unknown[];
+}
+export interface ChatSession {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly lastMessageAt: string | null;
+    readonly title: string;
+    readonly project: string | null;
+    readonly messageCount: number;
+    readonly messages: ChatMessage[];
+}
+export interface ChatSessionSummary {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly lastMessageAt: string | null;
+    readonly title: string;
+    readonly project: string | null;
+    readonly messageCount: number;
+}
+export interface CreateSessionInput {
+    title?: string;
+    project?: string | null;
+}
+export interface ChatExecutor {
+    /** 停止会话对应的 daemon worker（Delete 时清理） */
+    stopSession(sessionId: string): Promise<void>;
+    /** 中断正在进行的 assistant turn */
+    cancelRun(sessionId: string): Promise<void>;
+}
+export interface ChatServiceDeps {
+    readonly fs: FileSystem;
+    readonly clock: Clock;
+    readonly events: DomainEventBus;
+    readonly executor?: ChatExecutor;
+}
+export declare class ChatService {
+    private readonly deps;
+    constructor(deps: ChatServiceDeps);
+    list(): Promise<Result<ChatSessionSummary[], DomainError>>;
+    create(input?: CreateSessionInput): Promise<Result<ChatSessionSummary, DomainError>>;
+    get(id: string): Promise<Result<ChatSession, DomainError>>;
+    /** 返回 since 之后的消息（供 SSE 重连补偿）。since 缺省返回全部。 */
+    getMessages(id: string, since?: string): Promise<Result<{
+        data: ChatMessage[];
+        total: number;
+    }, DomainError>>;
+    delete(id: string): Promise<Result<void, DomainError>>;
+    interrupt(id: string): Promise<Result<void, DomainError>>;
+    private sessionPath;
+    private summarize;
+}
+//# sourceMappingURL=ChatService.d.ts.map

package/dist/services/ChatService.d.ts.map

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

package/dist/services/ChatService.js

@@ -0,0 +1,157 @@
+/**
+ * @module        services/ChatService
+ * @description   Chat 会话 CRUD service
+ *
+ * @layer         services
+ *
+ * Phase 2 范围：
+ *   - session 生命周期（list / create / get / delete）
+ *   - messages diff 查询
+ *
+ * Phase 3 追加：
+ *   - sendMessage（走 daemon IPC + SSE 流式推送）—— 通过注入 ChatExecutor port
+ *
+ * 本 service 隐藏 chat session JSON 文件的存储细节，使用 FileSystem port。
+ */
+import { randomUUID } from 'node:crypto';
+import { resolve } from 'node:path';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { chatSessionsDir } from '../shared/runtimePaths.js';
+export class ChatService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async list() {
+        const dir = chatSessionsDir();
+        if (!this.deps.fs.exists(dir))
+            return ok([]);
+        let files;
+        try {
+            files = this.deps.fs.readDir(dir).filter((e) => e.isFile && e.name.endsWith('.json'));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_LIST_FAIL', '会话列表读取失败', { cause }));
+        }
+        const summaries = [];
+        for (const entry of files) {
+            const path = resolve(dir, entry.name);
+            try {
+                const raw = this.deps.fs.readFile(path);
+                const session = JSON.parse(raw);
+                summaries.push(this.summarize(session));
+            }
+            catch {
+                /* 跳过坏 session */
+            }
+        }
+        summaries.sort((a, b) => {
+            const ta = a.lastMessageAt ?? a.createdAt;
+            const tb = b.lastMessageAt ?? b.createdAt;
+            return Date.parse(tb) - Date.parse(ta);
+        });
+        return ok(summaries);
+    }
+    async create(input = {}) {
+        const id = randomUUID();
+        const session = {
+            id,
+            createdAt: this.deps.clock.nowIso(),
+            lastMessageAt: null,
+            title: input.title?.trim() || '新对话',
+            project: input.project ?? null,
+            messageCount: 0,
+            messages: [],
+        };
+        try {
+            this.deps.fs.writeFileAtomic(this.sessionPath(id), JSON.stringify(session));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_CREATE_FAIL', '会话创建失败', { cause }));
+        }
+        return ok(this.summarize(session));
+    }
+    async get(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        const path = this.sessionPath(id);
+        if (!this.deps.fs.exists(path)) {
+            return err(domainError('not-found', 'CHAT_SESSION_NOT_FOUND', '会话不存在'));
+        }
+        try {
+            const raw = this.deps.fs.readFile(path);
+            return ok(JSON.parse(raw));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_READ_FAIL', '会话读取失败', { cause }));
+        }
+    }
+    /** 返回 since 之后的消息（供 SSE 重连补偿）。since 缺省返回全部。 */
+    async getMessages(id, since) {
+        const sessionR = await this.get(id);
+        if (!sessionR.ok)
+            return sessionR;
+        const session = sessionR.value;
+        const messages = since ? session.messages.filter((m) => m.ts > since) : session.messages;
+        return ok({ data: messages, total: session.messages.length });
+    }
+    async delete(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        const path = this.sessionPath(id);
+        if (this.deps.fs.exists(path)) {
+            try {
+                this.deps.fs.unlink(path);
+            }
+            catch (cause) {
+                return err(domainError('internal', 'CHAT_DELETE_FAIL', '会话删除失败', { cause }));
+            }
+        }
+        // best effort 停止 daemon worker
+        if (this.deps.executor) {
+            try {
+                await this.deps.executor.stopSession(id);
+            }
+            catch {
+                /* 不阻塞删除 */
+            }
+        }
+        return ok(undefined);
+    }
+    async interrupt(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        if (!this.deps.executor) {
+            return err(domainError('internal', 'EXECUTOR_MISSING', 'ChatExecutor 未注入'));
+        }
+        try {
+            await this.deps.executor.cancelRun(id);
+        }
+        catch (cause) {
+            return err(domainError('external', 'CHAT_CANCEL_FAIL', '中断会话失败', { cause }));
+        }
+        return ok(undefined);
+    }
+    // ─── helpers ──────────────────────────────────────────────────────
+    sessionPath(id) {
+        return resolve(chatSessionsDir(), `${id}.json`);
+    }
+    summarize(s) {
+        return {
+            id: s.id,
+            createdAt: s.createdAt,
+            lastMessageAt: s.lastMessageAt,
+            title: s.title,
+            project: s.project,
+            messageCount: s.messageCount,
+        };
+    }
+}
+function isValidSessionId(id) {
+    return typeof id === 'string' && /^[a-zA-Z0-9-]+$/.test(id);
+}
+function invalidId() {
+    return domainError('validation', 'INVALID_SESSION_ID', 'session id 非法');
+}
+//# sourceMappingURL=ChatService.js.map

package/dist/services/ChatService.js.map

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

package/dist/services/LogService.d.ts

@@ -0,0 +1,46 @@
+import type { FileSystem } from '../infra/filesystem.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export interface LogLine {
+    readonly ts: string | null;
+    readonly worker: number | null;
+    readonly level: 'debug' | 'info' | 'warn' | 'error' | 'trace';
+    readonly msg: string;
+    readonly raw: string;
+    readonly project?: string;
+}
+export interface LogQueryOpts {
+    project: string;
+    worker?: number;
+    limit?: number;
+    /** ISO datetime string —— 只返时间 >= since 的行 */
+    since?: string;
+}
+export interface LogQueryResult {
+    readonly data: LogLine[];
+    readonly file: string | null;
+    readonly files: string[];
+}
+export interface AggregateOpts {
+    worker?: number;
+    limit?: number;
+    since?: string;
+}
+export interface AggregateResult {
+    readonly data: LogLine[];
+    readonly files: string[];
+}
+export interface LogServiceDeps {
+    readonly fs: FileSystem;
+}
+export declare class LogService {
+    private readonly deps;
+    constructor(deps: LogServiceDeps);
+    /** 单项目 tail。 */
+    tail(opts: LogQueryOpts): Promise<Result<LogQueryResult, DomainError>>;
+    /** 跨项目聚合 tail。 */
+    aggregate(opts?: AggregateOpts): Promise<Result<AggregateResult, DomainError>>;
+    private findLogFiles;
+}
+export declare function parseLogLine(raw: string): LogLine;
+//# sourceMappingURL=LogService.d.ts.map

package/dist/services/LogService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogService.d.ts","sourceRoot":"","sources":["../../src/services/LogService.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD,gBAAgB;IACV,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAoB5E,kBAAkB;IACZ,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IA2CxF,OAAO,CAAC,YAAY;CAwBrB;AA4BD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsBjD"}

package/dist/services/LogService.js

@@ -0,0 +1,185 @@
+/**
+ * @module        services/LogService
+ * @description   日志 tail + 聚合 service
+ *
+ * @layer         services
+ *
+ * 职责：
+ *   - 单项目 tail（可选 worker 过滤、since 过滤、limit 截断）
+ *   - 跨项目聚合 tail
+ *   - 解析 log 行 → 结构化 LogLine（ts / level / worker / msg）
+ *
+ * 注意：SSE 流式 tail 是 Delivery 层职责（route 用 fs.watch），Service 只做一次性查询。
+ */
+import { createReadStream, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { home, logsDir, projectsDir, workerLogLineTag } from '../shared/runtimePaths.js';
+const MAX_SCAN_BYTES = 4 * 1024 * 1024;
+export class LogService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 单项目 tail。 */
+    async tail(opts) {
+        const limit = clampLimit(opts.limit);
+        const files = this.findLogFiles(opts.project, opts.worker);
+        if (files.length === 0) {
+            return ok({ data: [], file: null, files: [] });
+        }
+        const file = files[0];
+        try {
+            const lines = await readTailLines(file, limit);
+            const filtered = opts.since ? filterSince(lines, opts.since) : lines;
+            return ok({
+                data: filtered,
+                file: rel(file),
+                files: files.map(rel),
+            });
+        }
+        catch (cause) {
+            return err(domainError('internal', 'LOG_READ_FAIL', '日志读取失败', { cause }));
+        }
+    }
+    /** 跨项目聚合 tail。 */
+    async aggregate(opts = {}) {
+        const limit = clampLimit(opts.limit);
+        const root = projectsDir();
+        if (!this.deps.fs.exists(root)) {
+            return ok({ data: [], files: [] });
+        }
+        let projects;
+        try {
+            projects = this.deps.fs.readDir(root).filter((e) => e.isDirectory).map((e) => e.name);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'PROJECTS_READ_FAIL', '项目目录读取失败', { cause }));
+        }
+        // 每项目最新 log
+        const picked = [];
+        for (const p of projects) {
+            const files = this.findLogFiles(p, opts.worker);
+            if (files.length > 0)
+                picked.push({ project: p, file: files[0] });
+        }
+        const perLimit = Math.max(50, Math.floor(limit / Math.max(picked.length, 1)) * 2);
+        const merged = [];
+        for (const { project, file } of picked) {
+            try {
+                const lines = await readTailLines(file, perLimit);
+                for (const l of lines)
+                    merged.push({ ...l, project });
+            }
+            catch {
+                /* 跳过读不了的，不一票否决 */
+            }
+        }
+        // 按 ts 升序（老的在前，新的在末），取末尾 limit
+        merged.sort((a, b) => {
+            const at = a.ts ? Date.parse(a.ts) : 0;
+            const bt = b.ts ? Date.parse(b.ts) : 0;
+            return at - bt;
+        });
+        const filtered = opts.since ? filterSince(merged, opts.since) : merged;
+        return ok({
+            data: filtered.slice(-limit),
+            files: picked.map((p) => rel(p.file)),
+        });
+    }
+    // ─── 内部 ─────────────────────────────────────────────────────────
+    findLogFiles(project, worker) {
+        const dir = logsDir(project);
+        if (!this.deps.fs.exists(dir))
+            return [];
+        let entries;
+        try {
+            entries = this.deps.fs.readDir(dir);
+        }
+        catch {
+            return [];
+        }
+        const workerTag = worker !== undefined ? workerLogLineTag(worker) : null;
+        const files = entries
+            .filter((e) => e.isFile && e.name.endsWith('.log'))
+            .filter((e) => {
+            if (!workerTag)
+                return true;
+            return e.name.includes(workerTag) || e.name.includes(`-${worker}-`);
+        })
+            .map((e) => resolve(dir, e.name))
+            .sort((a, b) => {
+            const sa = this.deps.fs.stat(a);
+            const sb = this.deps.fs.stat(b);
+            return (sb?.mtimeMs ?? 0) - (sa?.mtimeMs ?? 0);
+        });
+        return files;
+    }
+}
+// ─── helpers ──────────────────────────────────────────────────────
+function clampLimit(input) {
+    const n = input ?? 500;
+    if (!Number.isFinite(n) || n <= 0)
+        return 500;
+    return Math.min(n, 2000);
+}
+function filterSince(lines, since) {
+    const parsed = Date.parse(since);
+    if (Number.isNaN(parsed))
+        return lines;
+    return lines.filter((l) => {
+        if (!l.ts)
+            return true;
+        const lt = Date.parse(l.ts);
+        return Number.isNaN(lt) || lt >= parsed;
+    });
+}
+function rel(path) {
+    try {
+        return path.replace(home(), '~');
+    }
+    catch {
+        return path;
+    }
+}
+export function parseLogLine(raw) {
+    const cleaned = raw.replace(/\[[0-9;]*m/g, '');
+    const m = cleaned.match(/(\d{4}-\d{2}-\d{2}[T ][\d:.]+Z?)\s*(?:\[)?(DEBUG|INFO|WARN|WARNING|ERROR|TRACE)\]?\s*(?:\[?(worker-\d+|acp|claude|supervisor|event-handler|skill|console)\]?\s*)?(.*)$/i);
+    if (m) {
+        const tsRaw = m[1] ?? '';
+        const lvl = (m[2] ?? 'info').toLowerCase().replace('warning', 'warn');
+        const src = m[3] ?? '';
+        const msg = m[4] ?? cleaned;
+        let worker = null;
+        const wm = src.match(/worker-(\d+)/);
+        if (wm)
+            worker = Number.parseInt(wm[1] ?? '', 10);
+        return {
+            ts: tsRaw.includes('T') ? tsRaw : `${tsRaw.replace(' ', 'T')}Z`,
+            worker,
+            level: lvl,
+            msg: src && !src.startsWith('worker-') ? `[${src}] ${msg}` : msg,
+            raw: cleaned,
+        };
+    }
+    return { ts: null, worker: null, level: 'info', msg: cleaned, raw: cleaned };
+}
+async function readTailLines(filePath, limit) {
+    const stat = statSync(filePath);
+    const start = Math.max(0, stat.size - MAX_SCAN_BYTES);
+    const lines = [];
+    await new Promise((resolveP) => {
+        const stream = createReadStream(filePath, { start, encoding: 'utf-8' });
+        const rl = createInterface({ input: stream });
+        rl.on('line', (l) => {
+            lines.push(parseLogLine(l));
+            if (lines.length > limit * 3)
+                lines.splice(0, lines.length - limit * 3);
+        });
+        rl.on('close', () => resolveP());
+    });
+    return lines.slice(-limit);
+}
+//# sourceMappingURL=LogService.js.map

package/dist/services/LogService.js.map

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

package/dist/services/PipelineService.d.ts

@@ -0,0 +1,71 @@
+import type { Clock } from '../infra/clock.js';
+import type { FileSystem } from '../infra/filesystem.js';
+import type { ProcessSpawner } from '../infra/spawn.js';
+import type { DomainEventBus } from '../shared/domainEvents.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export type PipelineStatus = 'idle' | 'running';
+export interface PipelineStatusInfo {
+    readonly status: PipelineStatus;
+    readonly pid: number | null;
+}
+export interface PipelineSummary {
+    readonly active: string | null;
+    readonly available: Array<{
+        name: string;
+        isActive: boolean;
+    }>;
+}
+export interface PipelineFileContent {
+    readonly content: string;
+    readonly etag: string;
+    readonly parsed: unknown;
+    readonly parseError: string | null;
+    readonly isActive: boolean;
+}
+export interface CreatePipelineInput {
+    name: string;
+    template?: 'blank' | 'sample' | 'active';
+}
+export interface ResetPipelineOpts {
+    all?: boolean;
+    cards?: number[];
+}
+/** CLI 命令层注入的钩子（Phase 3） */
+export interface PipelineExecutor {
+    stop(project: string): Promise<void>;
+    reset(project: string, opts: ResetPipelineOpts): Promise<void>;
+}
+export interface PipelineServiceDeps {
+    readonly fs: FileSystem;
+    readonly clock: Clock;
+    readonly events: DomainEventBus;
+    readonly spawner: ProcessSpawner;
+    readonly executor?: PipelineExecutor;
+}
+export declare class PipelineService {
+    private readonly deps;
+    constructor(deps: PipelineServiceDeps);
+    /** 启动 pipeline —— 已在跑直接返当前 pid。 */
+    start(project: string): Promise<Result<PipelineStatusInfo, DomainError>>;
+    stop(project: string): Promise<Result<void, DomainError>>;
+    reset(project: string, opts?: ResetPipelineOpts): Promise<Result<void, DomainError>>;
+    status(project: string): Promise<Result<PipelineStatusInfo, DomainError>>;
+    listPipelines(project: string): Promise<Result<PipelineSummary>>;
+    readPipeline(project: string, filename: string): Promise<Result<PipelineFileContent, DomainError>>;
+    writePipeline(project: string, filename: string, content: string, etag: string): Promise<Result<{
+        etag: string;
+    }, DomainError>>;
+    createPipeline(project: string, input: CreatePipelineInput): Promise<Result<{
+        name: string;
+        content: string;
+        etag: string;
+    }, DomainError>>;
+    deletePipeline(project: string, filename: string): Promise<Result<void, DomainError>>;
+    /** 切换 active pipeline —— 复制指定文件到 project.yaml。 */
+    switchActive(project: string, filename: string): Promise<Result<{
+        activePipeline: string;
+    }, DomainError>>;
+    private readSupervisorPid;
+}
+//# sourceMappingURL=PipelineService.d.ts.map

package/dist/services/PipelineService.d.ts.map

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