@coralai/sps-cli 0.49.16 → 0.50.1

package/dist/services/ProjectService.js

@@ -0,0 +1,346 @@
+/**
+ * @module        services/ProjectService
+ * @description   项目生命周期 service —— list / get / create / delete / conf CRUD
+ *
+ * @layer         services
+ *
+ * 职责：
+ *   - 扫 ~/.coral/projects/ 汇总每项目的概览（cards / workers / pipelineStatus）
+ *   - 通过 executeProjectInit 创建新项目（CLI 和 Console 共用同一条路径）
+ *   - conf 文件读写 + etag 乐观锁
+ *   - 删项目（可选同时删 repo 的 .claude/）
+ *
+ * 不直接触发 executeProjectInit —— 保留为 Phase 3 才接 CLI 命令层迁移时注入的
+ * 钩子，这里先用 fs 原语实现 conf 读写，项目创建接一个 ProjectInitExecutor port。
+ */
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { cardsDir, projectConfFile, projectDir, projectsDir, runtimeDir, slotFromMarkerFilename, supervisorPidFile, WorkerMarkerFilenameRe, } from '../shared/runtimePaths.js';
+export class ProjectService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 列出 ~/.coral/projects/ 下所有项目的概览。 */
+    async list() {
+        const base = projectsDir();
+        if (!this.deps.fs.exists(base)) {
+            return ok([]);
+        }
+        let entries;
+        try {
+            entries = this.deps.fs.readDir(base);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'PROJECTS_DIR_READ_FAIL', '无法读取项目目录', { cause }));
+        }
+        const names = entries.filter((e) => e.isDirectory).map((e) => e.name).sort();
+        const summaries = [];
+        for (const name of names) {
+            const r = this.readSummary(name);
+            if (r)
+                summaries.push(r);
+        }
+        return ok(summaries);
+    }
+    /** 获取单个项目概览。找不到返 not-found。 */
+    async get(name) {
+        if (!this.isValidName(name)) {
+            return err(invalidName());
+        }
+        const dir = projectDir(name);
+        if (!this.deps.fs.exists(dir)) {
+            return err(projectNotFound(name));
+        }
+        const summary = this.readSummary(name);
+        if (!summary) {
+            return err(projectNotFound(name));
+        }
+        return ok(summary);
+    }
+    /**
+     * 创建项目。需要 ProjectInitExecutor 注入。
+     * 已存在返 conflict。
+     */
+    async create(input) {
+        if (!this.isValidName(input.name)) {
+            return err(invalidName());
+        }
+        if (this.deps.fs.exists(projectDir(input.name))) {
+            return err(domainError('conflict', 'PROJECT_EXISTS', `项目 ${input.name} 已存在`, {
+                details: { name: input.name },
+            }));
+        }
+        if (!this.deps.initExecutor) {
+            return err(domainError('internal', 'INIT_EXECUTOR_MISSING', '项目创建需要 ProjectInitExecutor 注入（Phase 3 task）'));
+        }
+        try {
+            await this.deps.initExecutor.init(input.name, input);
+        }
+        catch (cause) {
+            return err(domainError('external', 'PROJECT_INIT_FAIL', '项目初始化失败', {
+                cause,
+                details: { message: cause instanceof Error ? cause.message : String(cause) },
+            }));
+        }
+        const summary = this.readSummary(input.name);
+        if (!summary) {
+            return err(domainError('internal', 'PROJECT_INIT_POST_READ_FAIL', '初始化完成但读不到项目概览'));
+        }
+        return ok(summary);
+    }
+    /**
+     * 删除项目。pipeline 在跑时拒绝（conflict）。
+     * opts.includeClaudeDir 默认 true，也会删对应 repo 的 .claude/。
+     */
+    async delete(name, opts = {}) {
+        if (!this.isValidName(name)) {
+            return err(invalidName());
+        }
+        const dir = projectDir(name);
+        if (!this.deps.fs.exists(dir)) {
+            return err(projectNotFound(name));
+        }
+        if (this.isPipelineRunning(name)) {
+            return err(domainError('conflict', 'PIPELINE_RUNNING', '项目 pipeline 正在运行，先停止再删除', {
+                details: { project: name },
+            }));
+        }
+        const includeClaude = opts.includeClaudeDir !== false;
+        let repoDirPath = null;
+        if (includeClaude) {
+            try {
+                const conf = this.deps.fs.readFile(projectConfFile(name));
+                const match = conf.match(/export\s+PROJECT_DIR=["']?([^"'\n]+)/);
+                repoDirPath = match?.[1]?.trim() || null;
+            }
+            catch {
+                // conf 丢了就不处理 claude/
+            }
+        }
+        try {
+            this.deps.fs.rm(dir, { recursive: true, force: true });
+        }
+        catch (cause) {
+            return err(domainError('internal', 'PROJECT_DELETE_FAIL', '项目目录删除失败', { cause }));
+        }
+        const claudeRemoved = [];
+        if (includeClaude && repoDirPath) {
+            const claudePath = resolve(repoDirPath, '.claude');
+            if (this.deps.fs.exists(claudePath)) {
+                try {
+                    this.deps.fs.rm(claudePath, { recursive: true, force: true });
+                    claudeRemoved.push({ path: claudePath, ok: true });
+                }
+                catch (cause) {
+                    claudeRemoved.push({
+                        path: claudePath,
+                        ok: false,
+                        error: cause instanceof Error ? cause.message : String(cause),
+                    });
+                }
+            }
+        }
+        return ok({ name, claudeRemoved });
+    }
+    /** 读 conf 文件 —— 返回 content + etag（SHA-256 前 16 位）。 */
+    async readConf(name) {
+        if (!this.isValidName(name))
+            return err(invalidName());
+        const confPath = projectConfFile(name);
+        if (!this.deps.fs.exists(confPath)) {
+            return err(domainError('not-found', 'CONF_NOT_FOUND', `项目 ${name} 的 conf 文件不存在`));
+        }
+        try {
+            const content = this.deps.fs.readFile(confPath);
+            return ok({ content, etag: hashEtag(content) });
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CONF_READ_FAIL', 'conf 读取失败', { cause }));
+        }
+    }
+    /**
+     * 写 conf —— etag 乐观锁。mismatch 返 conflict；内容相同 etag 不变。
+     * 文件权限保持 0600（conf 可能含 secret）。
+     */
+    async writeConf(name, content, etag) {
+        if (!this.isValidName(name))
+            return err(invalidName());
+        const confPath = projectConfFile(name);
+        if (!this.deps.fs.exists(confPath)) {
+            return err(domainError('not-found', 'CONF_NOT_FOUND', `项目 ${name} 的 conf 文件不存在`));
+        }
+        if (!etag || typeof etag !== 'string') {
+            return err(domainError('validation', 'ETAG_REQUIRED', 'etag 必填 —— 避免并发覆盖'));
+        }
+        let current;
+        try {
+            current = this.deps.fs.readFile(confPath);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CONF_READ_FAIL', 'conf 读取失败', { cause }));
+        }
+        const currentEtag = hashEtag(current);
+        if (etag !== currentEtag) {
+            return err(domainError('conflict', 'CONF_ETAG_MISMATCH', 'conf 已被其它编辑修改，请重新加载', { details: { currentEtag } }));
+        }
+        try {
+            this.deps.fs.writeFileAtomic(confPath, content);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CONF_WRITE_FAIL', 'conf 写入失败', { cause }));
+        }
+        return ok({ etag: hashEtag(content) });
+    }
+    // ─── 内部 helpers ────────────────────────────────────────────────
+    isValidName(name) {
+        return typeof name === 'string' && /^[a-zA-Z0-9_-]+$/.test(name);
+    }
+    readSummary(name) {
+        const dir = projectDir(name);
+        if (!this.deps.fs.exists(dir))
+            return null;
+        const conf = this.parseConf(name);
+        const cards = this.countCards(name);
+        const workers = this.countWorkers(name);
+        const pipelineStatus = this.isPipelineRunning(name) ? 'running' : 'idle';
+        const lastActivityAt = (() => {
+            const st = this.deps.fs.stat(runtimeDir(name));
+            return st ? new Date(st.mtimeMs).toISOString() : null;
+        })();
+        return {
+            name,
+            repoDir: conf.PROJECT_DIR ?? conf.REPO_DIR ?? null,
+            pmBackend: conf.PM_TOOL ?? 'markdown',
+            agentProvider: conf.AGENT_PROVIDER ?? 'claude',
+            cards,
+            workers,
+            pipelineStatus,
+            lastActivityAt,
+        };
+    }
+    parseConf(name) {
+        const path = projectConfFile(name);
+        if (!this.deps.fs.exists(path))
+            return {};
+        const out = {};
+        try {
+            const text = this.deps.fs.readFile(path);
+            for (const line of text.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                const m = trimmed.match(/^(?:export\s+)?([A-Z_][A-Z0-9_]*)=["']?(.*?)["']?\s*$/);
+                if (m)
+                    out[m[1]] = m[2];
+            }
+        }
+        catch {
+            /* silently empty */
+        }
+        return out;
+    }
+    /**
+     * 卡片计数 —— 遍历 cards/<state>/*.md 子目录。
+     * v0.49.15 修过同一个坑，现在统一走 runtimePaths + 在 service 层单点实现。
+     */
+    countCards(name) {
+        const dir = cardsDir(name);
+        if (!this.deps.fs.exists(dir))
+            return { total: 0, inprogress: 0, done: 0 };
+        let total = 0;
+        let inprogress = 0;
+        let done = 0;
+        try {
+            for (const entry of this.deps.fs.readDir(dir)) {
+                if (!entry.isDirectory)
+                    continue;
+                const sub = resolve(dir, entry.name);
+                const dirLower = entry.name.toLowerCase();
+                let files;
+                try {
+                    files = this.deps.fs.readDir(sub).filter((e) => e.isFile && /^\d+.*\.md$/.test(e.name));
+                }
+                catch {
+                    continue;
+                }
+                total += files.length;
+                if (dirLower === 'inprogress')
+                    inprogress += files.length;
+                else if (dirLower === 'done')
+                    done += files.length;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return { total, inprogress, done };
+    }
+    /**
+     * Worker marker 计数 —— 匹配双前缀 + 老单前缀两种格式（v0.49.16 之前遗留）。
+     * 活跃判定：marker 最近 5 分钟内更新。
+     */
+    countWorkers(name) {
+        const dir = runtimeDir(name);
+        if (!this.deps.fs.exists(dir))
+            return { total: 0, active: 0 };
+        let total = 0;
+        let active = 0;
+        const now = this.deps.clock.now();
+        try {
+            for (const entry of this.deps.fs.readDir(dir)) {
+                if (!entry.isFile)
+                    continue;
+                if (!WorkerMarkerFilenameRe.test(entry.name))
+                    continue;
+                total++;
+                const slot = slotFromMarkerFilename(entry.name);
+                if (slot === null)
+                    continue;
+                const stat = this.deps.fs.stat(resolve(dir, entry.name));
+                if (stat && now - stat.mtimeMs < 5 * 60 * 1000)
+                    active++;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return { total, active };
+    }
+    isPipelineRunning(name) {
+        const pidPath = supervisorPidFile(name);
+        if (!this.deps.fs.exists(pidPath))
+            return false;
+        try {
+            const raw = this.deps.fs.readFile(pidPath);
+            const pid = Number.parseInt(raw.trim(), 10);
+            if (!Number.isFinite(pid) || pid <= 0)
+                return false;
+            try {
+                process.kill(pid, 0);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── Error factories ──────────────────────────────────────────────
+function projectNotFound(name) {
+    return domainError('not-found', 'PROJECT_NOT_FOUND', `项目 ${name} 不存在`, {
+        details: { name },
+    });
+}
+function invalidName() {
+    return domainError('validation', 'INVALID_PROJECT_NAME', '项目名非法 —— 只允许字母、数字、_ 和 -');
+}
+function hashEtag(content) {
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=ProjectService.js.map

package/dist/services/ProjectService.js.map

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

package/dist/services/SkillService.d.ts

@@ -0,0 +1,38 @@
+import type { DomainEventBus } from '../shared/domainEvents.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export type SkillCategory = 'language' | 'end' | 'persona' | 'workflow' | 'other';
+export type SkillLinkState = 'absent' | 'linked' | 'frozen';
+export interface SkillSummary {
+    readonly name: string;
+    readonly category: SkillCategory;
+    readonly description: string;
+    readonly origin: string;
+    readonly linkedProjects: string[];
+    /** 当 opts.project 提供时附 */
+    readonly stateInProject?: SkillLinkState;
+}
+export interface SkillDetail extends SkillSummary {
+    readonly body: string;
+    readonly references: Array<{
+        name: string;
+        lines: number;
+    }>;
+    readonly linkedProjects: string[];
+}
+export interface SkillServiceDeps {
+    readonly events: DomainEventBus;
+}
+export declare class SkillService {
+    private readonly deps;
+    constructor(deps: SkillServiceDeps);
+    /** 列出 user-level skills。可选带 project 参数以得到 stateInProject。 */
+    list(project?: string): Promise<Result<SkillSummary[], DomainError>>;
+    get(name: string): Promise<Result<SkillDetail, DomainError>>;
+    sync(): Promise<Result<void, DomainError>>;
+    link(skill: string, project: string): Promise<Result<void, DomainError>>;
+    unlink(skill: string, project: string): Promise<Result<void, DomainError>>;
+    freeze(skill: string, project: string): Promise<Result<void, DomainError>>;
+    unfreeze(skill: string, project: string): Promise<Result<void, DomainError>>;
+}
+//# sourceMappingURL=SkillService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkillService.d.ts","sourceRoot":"","sources":["../../src/services/SkillService.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAClF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,gBAAgB;IAEnD,6DAA6D;IACvD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,WAAW,CAAC,CAAC;IAwBpE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IA+B5D,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAiB1C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAyBxE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAiB1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAY1E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;CAWnF"}