@coralai/sps-cli 0.49.16 → 0.50.1

package/dist/services/SkillService.js

@@ -0,0 +1,301 @@
+/**
+ * @module        services/SkillService
+ * @description   Skill 注册 + link/unlink/freeze service
+ *
+ * @layer         services
+ *
+ * 包装 core/skillStore 的能力，让 Delivery 层不再直接调 Domain。
+ * Phase 3 会用 SkillRegistry port 替代，当前先内部 wrap。
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { projectConfFile, projectsDir, userSkillsDir } from '../shared/runtimePaths.js';
+export class SkillService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 列出 user-level skills。可选带 project 参数以得到 stateInProject。 */
+    async list(project) {
+        const { listUserSkills, inspectProjectSkill } = await import('../core/skillStore.js');
+        const users = listUserSkills();
+        const enriched = users.map((u) => {
+            const fm = readFrontmatter(resolve(u.userPath, 'SKILL.md'));
+            const base = {
+                name: u.name,
+                category: classifyCategory(u.name),
+                description: fm.description,
+                origin: fm.origin,
+                linkedProjects: collectLinkedProjects(u.name).map((p) => p.project),
+            };
+            if (project) {
+                const repo = findProjectRepoDir(project);
+                const state = repo
+                    ? inspectProjectSkill(repo, u.name)?.state ?? 'absent'
+                    : 'absent';
+                return { ...base, stateInProject: state };
+            }
+            return base;
+        });
+        return ok(enriched);
+    }
+    async get(name) {
+        if (!isValidSkillName(name)) {
+            return err(domainError('validation', 'INVALID_SKILL_NAME', 'skill 名非法'));
+        }
+        const { listUserSkills } = await import('../core/skillStore.js');
+        const found = listUserSkills().find((u) => u.name === name);
+        if (!found) {
+            return err(domainError('not-found', 'SKILL_NOT_FOUND', `skill ${name} 不存在`));
+        }
+        const fm = readFrontmatter(resolve(found.userPath, 'SKILL.md'));
+        const body = readFileOrEmpty(resolve(found.userPath, 'SKILL.md'));
+        const refsDir = resolve(found.userPath, 'references');
+        const references = existsSync(refsDir)
+            ? readdirSync(refsDir)
+                .filter((f) => f.endsWith('.md'))
+                .map((f) => {
+                const full = resolve(refsDir, f);
+                return { name: f, lines: readFileOrEmpty(full).split('\n').length };
+            })
+            : [];
+        return ok({
+            name,
+            category: classifyCategory(name),
+            description: fm.description,
+            origin: fm.origin,
+            body,
+            references,
+            linkedProjects: collectLinkedProjects(name).map((p) => p.project),
+        });
+    }
+    async sync() {
+        const skillStore = await import('../core/skillStore.js');
+        // syncBundledSkillsToUser 需要 bundled skills 目录参数。defaults 让它自己查找内置。
+        // Phase 3 重构 bundled 目录定位时再传显式参数。
+        const bundled = findBundledSkillsDir();
+        if (!bundled) {
+            // 没有 bundled skills 就是成功 noop
+            return ok(undefined);
+        }
+        try {
+            skillStore.syncBundledSkillsToUser(bundled);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'SKILL_SYNC_FAIL', 'skill 同步失败', { cause }));
+        }
+        return ok(undefined);
+    }
+    async link(skill, project) {
+        if (!isValidSkillName(skill))
+            return err(invalidSkill());
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const repo = findProjectRepoDir(project);
+        if (!repo)
+            return err(projectNotFound(project));
+        const { addSkillToProject } = await import('../core/skillStore.js');
+        const result = addSkillToProject(repo, skill);
+        if (result === 'skipped-absent') {
+            return err(domainError('not-found', 'SKILL_NOT_FOUND', `skill ${skill} 不在 user registry`));
+        }
+        // 已在工程中（symlink 或 frozen copy）→ 幂等 ok，不再 emit
+        if (result === 'skipped-linked' || result === 'skipped-frozen') {
+            return ok(undefined);
+        }
+        this.deps.events.emit({
+            type: 'skill.linked',
+            project,
+            skill,
+            ts: Date.now(),
+        });
+        return ok(undefined);
+    }
+    async unlink(skill, project) {
+        if (!isValidSkillName(skill))
+            return err(invalidSkill());
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const repo = findProjectRepoDir(project);
+        if (!repo)
+            return err(projectNotFound(project));
+        const { removeSkillFromProject } = await import('../core/skillStore.js');
+        const removed = removeSkillFromProject(repo, skill);
+        if (!removed)
+            return ok(undefined); // idempotent
+        this.deps.events.emit({
+            type: 'skill.unlinked',
+            project,
+            skill,
+            ts: Date.now(),
+        });
+        return ok(undefined);
+    }
+    async freeze(skill, project) {
+        if (!isValidSkillName(skill))
+            return err(invalidSkill());
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const repo = findProjectRepoDir(project);
+        if (!repo)
+            return err(projectNotFound(project));
+        const { freezeSkillInProject } = await import('../core/skillStore.js');
+        if (!freezeSkillInProject(repo, skill)) {
+            return err(domainError('conflict', 'FREEZE_FAIL', '冻结失败 —— 可能未 link'));
+        }
+        return ok(undefined);
+    }
+    async unfreeze(skill, project) {
+        if (!isValidSkillName(skill))
+            return err(invalidSkill());
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const repo = findProjectRepoDir(project);
+        if (!repo)
+            return err(projectNotFound(project));
+        const { unfreezeSkillInProject } = await import('../core/skillStore.js');
+        if (!unfreezeSkillInProject(repo, skill)) {
+            return err(domainError('conflict', 'UNFREEZE_FAIL', '解冻失败 —— 可能未冻结'));
+        }
+        return ok(undefined);
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────
+function classifyCategory(name) {
+    const LANGUAGES = new Set(['python', 'typescript', 'golang', 'rust', 'kotlin', 'swift', 'java']);
+    const ENDS = new Set(['frontend', 'backend', 'mobile', 'database', 'devops']);
+    const PERSONAS = new Set([
+        'backend-architect',
+        'frontend-developer',
+        'code-reviewer',
+        'database-optimizer',
+        'devops-automator',
+        'security-engineer',
+        'qa-tester',
+    ]);
+    const WORKFLOWS = new Set([
+        'coding-standards',
+        'tdd-workflow',
+        'git-workflow',
+        'architecture-decision-records',
+        'debugging-workflow',
+    ]);
+    if (LANGUAGES.has(name))
+        return 'language';
+    if (ENDS.has(name))
+        return 'end';
+    if (PERSONAS.has(name))
+        return 'persona';
+    if (WORKFLOWS.has(name))
+        return 'workflow';
+    return 'other';
+}
+function readFrontmatter(path) {
+    if (!existsSync(path))
+        return { description: '', origin: '' };
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        if (!raw.startsWith('---'))
+            return { description: '', origin: '' };
+        const end = raw.indexOf('\n---', 3);
+        if (end === -1)
+            return { description: '', origin: '' };
+        const yaml = raw.slice(3, end);
+        const desc = yaml.match(/^description:\s*(.+)$/m)?.[1] ?? '';
+        const origin = yaml.match(/^origin:\s*(.+)$/m)?.[1] ?? '';
+        return {
+            description: desc.trim().replace(/^["']|["']$/g, ''),
+            origin: origin.trim().replace(/^["']|["']$/g, ''),
+        };
+    }
+    catch {
+        return { description: '', origin: '' };
+    }
+}
+function readFileOrEmpty(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+function collectLinkedProjects(skillName) {
+    const root = projectsDir();
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const projects = readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+    for (const name of projects) {
+        const repo = findProjectRepoDir(name);
+        if (!repo || !existsSync(repo))
+            continue;
+        // Avoid importing skillStore here —— dynamic import in methods that need it
+        // 此 helper 仅供 list/get 内部预计算，用脏读直接 fs 判定：
+        const linked = resolve(repo, '.claude', 'skills', skillName);
+        if (existsSync(linked)) {
+            const frozen = existsSync(resolve(linked, '.frozen'));
+            out.push({ project: name, state: frozen ? 'frozen' : 'linked' });
+        }
+    }
+    return out;
+}
+function findProjectRepoDir(project) {
+    const confPath = projectConfFile(project);
+    if (!existsSync(confPath))
+        return null;
+    try {
+        const content = readFileSync(confPath, 'utf-8');
+        const match = content.match(/^(?:export\s+)?(?:PROJECT_DIR|REPO_DIR)=["']?([^"'\n]+)["']?/m);
+        return match ? match[1] ?? null : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isValidProject(project) {
+    return typeof project === 'string' && /^[a-zA-Z0-9_-]+$/.test(project);
+}
+function isValidSkillName(name) {
+    return typeof name === 'string' && /^[a-zA-Z0-9_-]+$/.test(name);
+}
+function invalidSkill() {
+    return domainError('validation', 'INVALID_SKILL_NAME', 'skill 名非法');
+}
+function invalidProject() {
+    return domainError('validation', 'INVALID_PROJECT_NAME', '项目名非法');
+}
+function projectNotFound(name) {
+    return domainError('not-found', 'PROJECT_NOT_FOUND', `项目 ${name} 不存在`);
+}
+/**
+ * 定位仓库里的 `skills/` bundled 目录（project-template 模板同级）。
+ * 和 console-server/routes/skills.ts::findBundledSkillsDir 逻辑一致 ——
+ * Phase 3 迁移 Delivery 时再合并到 shared helper。
+ */
+function findBundledSkillsDir() {
+    const candidates = [
+        resolve(process.cwd(), 'skills'),
+        // 从 src/services/SkillService.ts 往上数：services → src → workflow-cli → skills
+        resolve(__dirname, '..', '..', 'skills'),
+    ];
+    for (const c of candidates) {
+        try {
+            if (existsSync(c))
+                return c;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return null;
+}
+// void —— 让 TypeScript 不要 warn userSkillsDir 没直接用
+void userSkillsDir;
+//# sourceMappingURL=SkillService.js.map

package/dist/services/SkillService.js.map

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

package/dist/services/SystemService.d.ts

@@ -0,0 +1,67 @@
+import type { Clock } from '../infra/clock.js';
+import type { FileSystem } from '../infra/filesystem.js';
+import type { ProcessSpawner } from '../infra/spawn.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export interface SystemInfo {
+    readonly version: string;
+    readonly nodeVersion: string;
+    readonly startedAt: string;
+    readonly uptimeMs: number;
+    readonly platform: string;
+    readonly pid: number;
+}
+export interface EnvEntry {
+    readonly key: string;
+    readonly value: string;
+    readonly masked: boolean;
+}
+export interface EnvListing {
+    readonly path: string;
+    readonly exists: boolean;
+    readonly entries: EnvEntry[];
+}
+export interface EnvRaw {
+    readonly path: string;
+    readonly exists: boolean;
+    readonly content: string;
+    readonly etag: string;
+}
+export interface LatestVersion {
+    readonly current: string;
+    readonly latest: string;
+    readonly upToDate: boolean;
+}
+export interface UpgradeResult {
+    readonly ok: boolean;
+    readonly output: string;
+}
+export interface DoctorReport {
+    readonly project: string;
+    readonly issues: string[];
+    readonly ok: boolean;
+}
+export interface SystemServiceDeps {
+    readonly fs: FileSystem;
+    readonly clock: Clock;
+    readonly spawner: ProcessSpawner;
+    readonly version: string;
+    readonly startedAt: Date;
+}
+export declare class SystemService {
+    private readonly deps;
+    constructor(deps: SystemServiceDeps);
+    info(): SystemInfo;
+    readEnv(): Promise<Result<EnvListing, DomainError>>;
+    readEnvRaw(): Promise<Result<EnvRaw, DomainError>>;
+    writeEnv(content: string, etag: string | undefined): Promise<Result<{
+        etag: string;
+    }, DomainError>>;
+    latestVersion(): Promise<Result<LatestVersion, DomainError>>;
+    /** 执行 npm i -g —— pipeline 在跑时拒绝以保证原子性。 */
+    upgrade(): Promise<Result<UpgradeResult, DomainError>>;
+    doctorAll(): Promise<Result<DoctorReport[], DomainError>>;
+    /** 列出当前在跑 pipeline 的项目名 —— upgrade 前置检查用 */
+    private listRunningPipelines;
+}
+//# sourceMappingURL=SystemService.d.ts.map

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

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

package/dist/services/SystemService.js

@@ -0,0 +1,278 @@
+/**
+ * @module        services/SystemService
+ * @description   系统级信息 + ~/.coral/env CRUD + npm upgrade + doctor
+ *
+ * @layer         services
+ */
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { chmodSync } from 'node:fs';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { globalEnvFile, projectConfFile, projectsDir, runtimeDir, supervisorPidFile, WorkerMarkerFilenameRe, } from '../shared/runtimePaths.js';
+import { resolve } from 'node:path';
+const SECRET_KEY_PATTERNS = [
+    /_TOKEN$/,
+    /_KEY$/,
+    /_SECRET$/,
+    /_PASSWORD$/,
+    /_PASS$/,
+    /^(ANTHROPIC|OPENAI|CLAUDE|PLANE|TRELLO|MATRIX)_/,
+];
+export class SystemService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    info() {
+        return {
+            version: this.deps.version,
+            nodeVersion: process.version,
+            startedAt: this.deps.startedAt.toISOString(),
+            uptimeMs: this.deps.clock.now() - this.deps.startedAt.getTime(),
+            platform: process.platform,
+            pid: process.pid,
+        };
+    }
+    async readEnv() {
+        const path = globalEnvFile();
+        if (!this.deps.fs.exists(path)) {
+            return ok({ path, exists: false, entries: [] });
+        }
+        try {
+            const raw = this.deps.fs.readFile(path);
+            const entries = [];
+            for (const line of raw.split('\n')) {
+                const t = line.trim();
+                if (!t || t.startsWith('#'))
+                    continue;
+                const m = t.match(/^(?:export\s+)?([A-Z_][A-Z0-9_]*)=["']?(.*?)["']?\s*$/);
+                if (!m)
+                    continue;
+                const key = m[1] ?? '';
+                const value = m[2] ?? '';
+                const masked = isSecret(key);
+                entries.push({ key, value: masked ? maskSecret(value) : value, masked });
+            }
+            return ok({ path, exists: true, entries });
+        }
+        catch (cause) {
+            return err(domainError('internal', 'ENV_READ_FAIL', 'env 文件读取失败', { cause }));
+        }
+    }
+    async readEnvRaw() {
+        const path = globalEnvFile();
+        if (!this.deps.fs.exists(path)) {
+            return ok({ path, exists: false, content: '', etag: '' });
+        }
+        try {
+            const content = this.deps.fs.readFile(path);
+            return ok({ path, exists: true, content, etag: hashEtag(content) });
+        }
+        catch (cause) {
+            return err(domainError('internal', 'ENV_READ_FAIL', 'env 文件读取失败', { cause }));
+        }
+    }
+    async writeEnv(content, etag) {
+        const path = globalEnvFile();
+        const exists = this.deps.fs.exists(path);
+        if (exists) {
+            if (!etag) {
+                return err(domainError('validation', 'ETAG_REQUIRED', 'etag 必填（已有文件）'));
+            }
+            const currentContent = this.deps.fs.readFile(path);
+            const currentEtag = hashEtag(currentContent);
+            if (etag !== currentEtag) {
+                return err(domainError('conflict', 'ENV_ETAG_MISMATCH', 'env 已被其它编辑修改，请重新加载', { details: { currentEtag } }));
+            }
+        }
+        try {
+            this.deps.fs.writeFileAtomic(path, content);
+            // 保持 0600 权限 —— env 常含 secret
+            try {
+                chmodSync(path, 0o600);
+            }
+            catch {
+                /* best effort */
+            }
+        }
+        catch (cause) {
+            return err(domainError('internal', 'ENV_WRITE_FAIL', 'env 写入失败', { cause }));
+        }
+        return ok({ etag: hashEtag(content) });
+    }
+    async latestVersion() {
+        // `spawner` is wired as ProcessSpawner for sps CLI; `npm view` is a different
+        // binary so we spawn it directly (still isolated to the service layer).
+        return new Promise((resolvePromise) => {
+            const child = spawn('npm', ['view', '@coralai/sps-cli', 'version'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            const timer = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* noop */
+                }
+                resolvePromise(err(domainError('external', 'NPM_VIEW_TIMEOUT', 'npm view 超时 (10s)', {
+                    details: { timeoutMs: 10_000 },
+                })));
+            }, 10_000);
+            child.stdout?.on('data', (d) => (stdout += d.toString()));
+            child.stderr?.on('data', (d) => (stderr += d.toString()));
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                if (code === 0) {
+                    const latest = stdout.trim();
+                    resolvePromise(ok({
+                        current: this.deps.version,
+                        latest,
+                        upToDate: this.deps.version === latest,
+                    }));
+                }
+                else {
+                    resolvePromise(err(domainError('external', 'NPM_VIEW_FAIL', 'npm view 失败', {
+                        details: { stderr: stderr.trim(), exitCode: code },
+                    })));
+                }
+            });
+            child.on('error', (e) => {
+                clearTimeout(timer);
+                resolvePromise(err(domainError('external', 'NPM_VIEW_ERROR', 'npm view 出错', {
+                    cause: e,
+                    details: { message: e.message },
+                })));
+            });
+        });
+    }
+    /** 执行 npm i -g —— pipeline 在跑时拒绝以保证原子性。 */
+    async upgrade() {
+        const running = this.listRunningPipelines();
+        if (running.length > 0) {
+            return err(domainError('conflict', 'PIPELINES_RUNNING', '有 pipeline 在跑，升级前请先停止', {
+                details: { projects: running },
+            }));
+        }
+        return new Promise((resolvePromise) => {
+            const child = spawn('npm', ['i', '-g', '@coralai/sps-cli@latest'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let output = '';
+            const timer = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* noop */
+                }
+                resolvePromise(ok({ ok: false, output: output + '\n[timeout 120s]' }));
+            }, 120_000);
+            child.stdout?.on('data', (d) => (output += d.toString()));
+            child.stderr?.on('data', (d) => (output += d.toString()));
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                resolvePromise(ok({ ok: code === 0, output }));
+            });
+            child.on('error', (e) => {
+                clearTimeout(timer);
+                resolvePromise(ok({ ok: false, output: output + `\n[spawn error: ${e.message}]` }));
+            });
+        });
+    }
+    async doctorAll() {
+        const root = projectsDir();
+        if (!this.deps.fs.exists(root)) {
+            return ok([]);
+        }
+        let names;
+        try {
+            names = this.deps.fs.readDir(root).filter((e) => e.isDirectory).map((e) => e.name);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'PROJECTS_READ_FAIL', 'projects 目录读取失败', { cause }));
+        }
+        const now = this.deps.clock.now();
+        const report = [];
+        for (const name of names) {
+            const issues = [];
+            if (!this.deps.fs.exists(projectConfFile(name)))
+                issues.push('missing conf');
+            const cardsDir = resolve(root, name, 'cards');
+            if (!this.deps.fs.exists(cardsDir))
+                issues.push('missing cards/');
+            const runtime = runtimeDir(name);
+            if (this.deps.fs.exists(runtime)) {
+                try {
+                    const markers = this.deps.fs
+                        .readDir(runtime)
+                        .filter((e) => e.isFile && WorkerMarkerFilenameRe.test(e.name));
+                    for (const mf of markers) {
+                        const stat = this.deps.fs.stat(resolve(runtime, mf.name));
+                        if (stat) {
+                            const ageMin = Math.floor((now - stat.mtimeMs) / 60000);
+                            if (ageMin > 60)
+                                issues.push(`stale marker ${mf.name} (${ageMin}m)`);
+                        }
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            report.push({ project: name, issues, ok: issues.length === 0 });
+        }
+        return ok(report);
+    }
+    /** 列出当前在跑 pipeline 的项目名 —— upgrade 前置检查用 */
+    listRunningPipelines() {
+        const root = projectsDir();
+        if (!this.deps.fs.exists(root))
+            return [];
+        const out = [];
+        try {
+            const names = this.deps.fs.readDir(root).filter((e) => e.isDirectory).map((e) => e.name);
+            for (const name of names) {
+                const pidFile = supervisorPidFile(name);
+                if (!this.deps.fs.exists(pidFile))
+                    continue;
+                try {
+                    const pid = Number.parseInt(this.deps.fs.readFile(pidFile).trim(), 10);
+                    if (pid > 0) {
+                        try {
+                            process.kill(pid, 0);
+                            out.push(name);
+                        }
+                        catch {
+                            /* dead pid */
+                        }
+                    }
+                }
+                catch {
+                    /* unreadable */
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return out;
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────
+function maskSecret(value) {
+    if (!value)
+        return '';
+    if (value.length <= 6)
+        return '****';
+    return value.slice(0, 4) + '****';
+}
+function isSecret(key) {
+    return SECRET_KEY_PATTERNS.some((p) => p.test(key));
+}
+function hashEtag(content) {
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=SystemService.js.map