@coralai/sps-cli 0.49.15 → 0.50.0

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/WorkerService.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @module        services/WorkerService
+ * @description   Worker 查询 + 控制 service
+ *
+ * @layer         services
+ *
+ * 职责：
+ *   - 读 runtime/worker-worker-<N>-current.json marker → 结构化 WorkerInfo
+ *   - 列项目 workers / 跨项目聚合
+ *   - launch / kill —— Phase 2 暂不负责真 spawn，返 pending port（Phase 3 填）
+ *
+ * 不负责：
+ *   - marker 写入（worker-manager 的事）
+ *   - 日志 tail（LogService）
+ */
+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 type WorkerState = 'idle' | 'starting' | 'running' | 'stuck' | 'crashed';
+export interface WorkerInfo {
+    readonly slot: number;
+    readonly pid: number | null;
+    readonly state: WorkerState;
+    readonly card: {
+        seq: number;
+        title: string;
+    } | null;
+    readonly stage: string | null;
+    readonly startedAt: string | null;
+    readonly runtimeMs: number | null;
+    readonly markerUpdatedAt: string | null;
+}
+export interface AggregateResult {
+    readonly alerts: Array<WorkerInfo & {
+        project: string;
+    }>;
+    readonly active: Array<WorkerInfo & {
+        project: string;
+    }>;
+    readonly capacity: Array<{
+        project: string;
+        total: number;
+        running: number;
+        starting: number;
+        stuck: number;
+        crashed: number;
+        idle: number;
+    }>;
+}
+/** Service 让调用方注入 launch/kill 执行器（Phase 3 由 CLI 命令绑定） */
+export interface WorkerExecutor {
+    launch(project: string, seq: number): Promise<void>;
+    kill(project: string, slot: number): Promise<void>;
+}
+export interface WorkerServiceDeps {
+    readonly fs: FileSystem;
+    readonly clock: Clock;
+    readonly events: DomainEventBus;
+    /** 卡片 title 反查器（CardService 实例或类似），Phase 3 注入。不注入则 title 用 `#<seq>`。 */
+    readonly cardTitleLookup?: (project: string, seq: number) => Promise<string | null>;
+    readonly executor?: WorkerExecutor;
+}
+export declare class WorkerService {
+    private readonly deps;
+    constructor(deps: WorkerServiceDeps);
+    /** 列单项目的 worker slots（按 slot 数字升序）。 */
+    listByProject(project: string): Promise<Result<WorkerInfo[], DomainError>>;
+    /** 单 slot detail。 */
+    getBySlot(project: string, slot: number): Promise<Result<WorkerInfo, DomainError>>;
+    /** 跨项目聚合 —— Workers 页用。 */
+    aggregate(): Promise<Result<AggregateResult, DomainError>>;
+    /** launch 转发到注入的 executor。未注入返 internal。 */
+    launch(project: string, seq: number): Promise<Result<void>>;
+    kill(project: string, slot: number): Promise<Result<void>>;
+    /** 扫 runtime/ 下 marker 文件，匹配双前缀 + 单前缀，返 slot 数字 + 实际路径 */
+    private listMarkerSlots;
+    /** 优先双前缀，再试老单前缀 */
+    private resolveMarkerPath;
+    private buildInfo;
+}
+//# sourceMappingURL=WorkerService.d.ts.map

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

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

package/dist/services/WorkerService.js

@@ -0,0 +1,262 @@
+/**
+ * @module        services/WorkerService
+ * @description   Worker 查询 + 控制 service
+ *
+ * @layer         services
+ *
+ * 职责：
+ *   - 读 runtime/worker-worker-<N>-current.json marker → 结构化 WorkerInfo
+ *   - 列项目 workers / 跨项目聚合
+ *   - launch / kill —— Phase 2 暂不负责真 spawn，返 pending port（Phase 3 填）
+ *
+ * 不负责：
+ *   - marker 写入（worker-manager 的事）
+ *   - 日志 tail（LogService）
+ */
+import { resolve } from 'node:path';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { projectDir, projectsDir, runtimeDir, slotFromMarkerFilename, WorkerMarkerFilenameRe, workerMarkerFile, } from '../shared/runtimePaths.js';
+import { WorkerMarkerSchema } from '../shared/runtimeSchemas.js';
+const STUCK_THRESHOLD_MS = 5 * 60 * 1000;
+const ACK_TIMEOUT_MS = 60 * 1000;
+export class WorkerService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 列单项目的 worker slots（按 slot 数字升序）。 */
+    async listByProject(project) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const dir = runtimeDir(project);
+        if (!this.deps.fs.exists(dir))
+            return ok([]);
+        const slots = this.listMarkerSlots(project);
+        const infos = [];
+        for (const { slot, file } of slots) {
+            infos.push(await this.buildInfo(project, slot, file));
+        }
+        return ok(infos.sort((a, b) => a.slot - b.slot));
+    }
+    /** 单 slot detail。 */
+    async getBySlot(project, slot) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(slot) || slot <= 0) {
+            return err(domainError('validation', 'INVALID_SLOT', 'slot 必须是正整数'));
+        }
+        const candidates = this.resolveMarkerPath(project, slot);
+        if (!candidates) {
+            return err(domainError('not-found', 'WORKER_MARKER_NOT_FOUND', `worker-${slot} marker 不存在`));
+        }
+        return ok(await this.buildInfo(project, slot, candidates));
+    }
+    /** 跨项目聚合 —— Workers 页用。 */
+    async aggregate() {
+        const root = projectsDir();
+        if (!this.deps.fs.exists(root)) {
+            return ok({ alerts: [], active: [], capacity: [] });
+        }
+        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 }));
+        }
+        projects.sort();
+        const result = { alerts: [], active: [], capacity: [] };
+        for (const project of projects) {
+            const slots = this.listMarkerSlots(project);
+            const stats = {
+                project,
+                total: slots.length,
+                running: 0,
+                starting: 0,
+                stuck: 0,
+                crashed: 0,
+                idle: 0,
+            };
+            for (const { slot, file } of slots) {
+                const info = await this.buildInfo(project, slot, file);
+                stats[info.state]++;
+                if (info.state === 'stuck' || info.state === 'crashed') {
+                    result.alerts.push({ ...info, project });
+                }
+                else if (info.state === 'running' || info.state === 'starting') {
+                    result.active.push({ ...info, project });
+                }
+            }
+            result.capacity.push(stats);
+        }
+        result.alerts.sort((a, b) => {
+            if (a.state !== b.state)
+                return a.state === 'stuck' ? -1 : 1;
+            return (b.runtimeMs ?? 0) - (a.runtimeMs ?? 0);
+        });
+        result.active.sort((a, b) => (b.runtimeMs ?? 0) - (a.runtimeMs ?? 0));
+        return ok(result);
+    }
+    /** launch 转发到注入的 executor。未注入返 internal。 */
+    async launch(project, seq) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(seq) || seq <= 0) {
+            return err(domainError('validation', 'INVALID_SEQ', 'seq 必须是正整数'));
+        }
+        if (!this.deps.executor) {
+            return err(domainError('internal', 'WORKER_EXECUTOR_MISSING', '需要注入 WorkerExecutor（Phase 3 task）'));
+        }
+        if (!this.deps.fs.exists(projectDir(project))) {
+            return err(domainError('not-found', 'PROJECT_NOT_FOUND', `项目 ${project} 不存在`));
+        }
+        try {
+            await this.deps.executor.launch(project, seq);
+        }
+        catch (cause) {
+            return err(domainError('external', 'WORKER_LAUNCH_FAIL', 'worker launch 失败', {
+                cause,
+                details: { message: cause instanceof Error ? cause.message : String(cause) },
+            }));
+        }
+        return ok(undefined);
+    }
+    async kill(project, slot) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(slot) || slot <= 0) {
+            return err(domainError('validation', 'INVALID_SLOT', 'slot 必须是正整数'));
+        }
+        if (!this.deps.executor) {
+            return err(domainError('internal', 'WORKER_EXECUTOR_MISSING', '需要注入 WorkerExecutor'));
+        }
+        try {
+            await this.deps.executor.kill(project, slot);
+        }
+        catch (cause) {
+            return err(domainError('external', 'WORKER_KILL_FAIL', 'worker kill 失败', {
+                cause,
+                details: { message: cause instanceof Error ? cause.message : String(cause) },
+            }));
+        }
+        return ok(undefined);
+    }
+    // ─── 内部 ─────────────────────────────────────────────────────────
+    /** 扫 runtime/ 下 marker 文件，匹配双前缀 + 单前缀，返 slot 数字 + 实际路径 */
+    listMarkerSlots(project) {
+        const dir = runtimeDir(project);
+        if (!this.deps.fs.exists(dir))
+            return [];
+        try {
+            return this.deps.fs
+                .readDir(dir)
+                .filter((e) => e.isFile && WorkerMarkerFilenameRe.test(e.name))
+                .map((e) => {
+                const slot = slotFromMarkerFilename(e.name);
+                return { slot: slot ?? 0, file: resolve(dir, e.name) };
+            })
+                .filter((x) => x.slot > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** 优先双前缀，再试老单前缀 */
+    resolveMarkerPath(project, slot) {
+        const doublePrefix = workerMarkerFile(project, `worker-${slot}`);
+        if (this.deps.fs.exists(doublePrefix))
+            return doublePrefix;
+        // 老兼容：worker-<N>-current.json（单前缀）
+        const single = resolve(runtimeDir(project), `worker-${slot}-current.json`);
+        if (this.deps.fs.exists(single))
+            return single;
+        return null;
+    }
+    async buildInfo(project, slot, markerPath) {
+        const now = this.deps.clock.now();
+        let pid = null;
+        let card = null;
+        let stage = null;
+        let startedAt = null;
+        let markerUpdatedAt = null;
+        try {
+            const raw = this.deps.fs.readFile(markerPath);
+            const parsed = WorkerMarkerSchema.safeParse(JSON.parse(raw));
+            if (parsed.success) {
+                const d = parsed.data;
+                pid = d.pid ?? null;
+                stage = d.stage;
+                startedAt = d.dispatchedAt;
+                const seq = parseSeqFromCardId(d.cardId);
+                if (seq !== null) {
+                    let title = `#${seq}`;
+                    if (this.deps.cardTitleLookup) {
+                        try {
+                            const t = await this.deps.cardTitleLookup(project, seq);
+                            if (t)
+                                title = t;
+                        }
+                        catch {
+                            /* lookup 失败用 fallback */
+                        }
+                    }
+                    card = { seq, title };
+                }
+            }
+        }
+        catch {
+            /* marker 读不了就按最小信息返 */
+        }
+        const stat = this.deps.fs.stat(markerPath);
+        if (stat)
+            markerUpdatedAt = new Date(stat.mtimeMs).toISOString();
+        const alive = isPidAlive(pid);
+        const fresh = markerUpdatedAt ? now - new Date(markerUpdatedAt).getTime() < STUCK_THRESHOLD_MS : false;
+        const ageMs = markerUpdatedAt ? now - new Date(markerUpdatedAt).getTime() : null;
+        let state;
+        if (!alive) {
+            state = card !== null ? 'crashed' : 'idle';
+        }
+        else if (card === null) {
+            state = 'idle';
+        }
+        else {
+            const starting = ageMs !== null && ageMs <= ACK_TIMEOUT_MS;
+            if (starting)
+                state = 'starting';
+            else if (!fresh)
+                state = 'stuck';
+            else
+                state = 'running';
+        }
+        const runtimeMs = startedAt ? now - new Date(startedAt).getTime() : null;
+        return { slot, pid, state, card, stage, startedAt, runtimeMs, markerUpdatedAt };
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────
+function parseSeqFromCardId(cardId) {
+    const m = cardId.match(/^(?:md-)?(\d+)$/);
+    if (!m)
+        return null;
+    const n = Number.parseInt(m[1] ?? '', 10);
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+function isPidAlive(pid) {
+    if (!pid)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isValidProject(project) {
+    return typeof project === 'string' && /^[a-zA-Z0-9_-]+$/.test(project);
+}
+function invalidProject() {
+    return domainError('validation', 'INVALID_PROJECT_NAME', '项目名非法');
+}
+//# sourceMappingURL=WorkerService.js.map