@coralai/sps-cli 0.49.16 → 0.50.1

package/dist/services/executors.js

@@ -0,0 +1,157 @@
+// ─── WorkerExecutor —— 直接调 StageEngine 启卡 / RuntimeStore kill ─────
+export class DefaultWorkerExecutor {
+    async launch(project, seq) {
+        const { ProjectContext } = await import('../core/context.js');
+        const { ProjectPipelineAdapter } = await import('../core/projectPipelineAdapter.js');
+        const { RuntimeStore } = await import('../core/runtimeStore.js');
+        const { SPSEventHandler } = await import('../engines/EventHandler.js');
+        const { StageEngine } = await import('../engines/StageEngine.js');
+        const { CompletionJudge } = await import('../manager/completion-judge.js');
+        const { ProcessSupervisor } = await import('../manager/supervisor.js');
+        const { WorkerManagerImpl } = await import('../manager/worker-manager-impl.js');
+        const { createAgentRuntime, createNotifier, createRepoBackend, createTaskBackend } = await import('../providers/registry.js');
+        const ctx = ProjectContext.load(project);
+        const pipelineAdapter = new ProjectPipelineAdapter(ctx.config, ctx.paths.repoDir);
+        const allStateNames = [
+            ...new Set([
+                pipelineAdapter.states.planning,
+                pipelineAdapter.states.backlog,
+                pipelineAdapter.states.ready,
+                pipelineAdapter.states.done,
+                ...pipelineAdapter.stages.flatMap((s) => [s.triggerState, s.activeState, s.onCompleteState]),
+            ].filter(Boolean)),
+        ];
+        const taskBackend = createTaskBackend(ctx.config, allStateNames);
+        const repoBackend = createRepoBackend(ctx.config);
+        const notifier = createNotifier(ctx.config);
+        const supervisor = new ProcessSupervisor();
+        const completionJudge = new CompletionJudge();
+        const agentRuntime = createAgentRuntime(ctx);
+        const workerManager = new WorkerManagerImpl({
+            supervisor,
+            completionJudge,
+            agentRuntime: agentRuntime ?? null,
+            stateFile: ctx.paths.stateFile,
+            maxWorkers: ctx.maxWorkers,
+        });
+        const runtimeStore = new RuntimeStore({
+            paths: { stateFile: ctx.paths.stateFile },
+            maxWorkers: ctx.maxWorkers,
+        });
+        const eventHandler = new SPSEventHandler({
+            taskBackend,
+            notifier,
+            runtimeStore,
+            project,
+            pipelineAdapter,
+        });
+        workerManager.onEvent((event) => eventHandler.handle(event));
+        const firstStage = pipelineAdapter.stages[0];
+        if (!firstStage) {
+            throw new Error(`Project ${project} has no pipeline stages`);
+        }
+        const engine = new StageEngine(ctx, firstStage, 0, pipelineAdapter.stages.length, taskBackend, repoBackend, workerManager, pipelineAdapter, notifier);
+        const result = await engine.launchSingle(String(seq), { dryRun: false });
+        if (result.status !== 'ok') {
+            const detail = typeof result.details === 'object' && result.details
+                ? JSON.stringify(result.details)
+                : String(result.details ?? 'unknown');
+            throw new Error(detail);
+        }
+    }
+    async kill(project, slot) {
+        const { ProjectContext } = await import('../core/context.js');
+        const { RuntimeStore } = await import('../core/runtimeStore.js');
+        const ctx = ProjectContext.load(project);
+        const store = new RuntimeStore({
+            paths: { stateFile: ctx.paths.stateFile },
+            maxWorkers: ctx.maxWorkers,
+        });
+        const slotName = `worker-${slot}`;
+        const state = store.readState();
+        const worker = state.workers[slotName];
+        if (worker?.pid && worker.pid > 0) {
+            try {
+                process.kill(worker.pid, 'SIGTERM');
+            }
+            catch {
+                /* pid 已死 */
+            }
+        }
+        // 清 slot 状态 —— mutator 重置为 idle
+        store.updateState(`console-worker-kill-${slot}`, (s) => {
+            const w = s.workers[slotName];
+            if (!w)
+                return;
+            w.status = 'idle';
+            w.seq = null;
+            w.branch = null;
+            w.worktree = null;
+            w.claimedAt = null;
+            w.lastHeartbeat = null;
+            if ('pid' in w)
+                w.pid = null;
+            if ('sessionId' in w)
+                w.sessionId = null;
+        });
+    }
+}
+// ─── PipelineExecutor —— 通过 ProcessSpawner 走子进程（避开 process.exit 污染）─────
+//
+// 细节：executeStop / executeReset 都直接调 process.exit() 做错误退出，不能在 Console
+// server 内联调——会把服务器也杀了。用子进程隔离最干净。这是 Delivery 层不允许 spawn
+// 但 executor glue 层允许的典型场景。
+export class DefaultPipelineExecutor {
+    spawner;
+    constructor(spawner) {
+        this.spawner = spawner;
+    }
+    async stop(project) {
+        const result = await this.spawner.runCliSync({
+            args: ['stop', project],
+            timeoutMs: 20_000,
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(result.stderr || `sps stop exited ${result.exitCode}`);
+        }
+    }
+    async reset(project, opts) {
+        const args = ['reset', project];
+        if (opts.all)
+            args.push('--all');
+        else if (Array.isArray(opts.cards) && opts.cards.length > 0) {
+            args.push('--card', opts.cards.join(','));
+        }
+        const result = await this.spawner.runCliSync({ args, timeoutMs: 60_000 });
+        if (result.exitCode !== 0) {
+            throw new Error(result.stderr || `sps reset exited ${result.exitCode}`);
+        }
+    }
+}
+// ─── ChatExecutor —— 直接用 DaemonClient ─────────────────────────────
+const CHAT_SLOT_PREFIX = 'chat-';
+export class DefaultChatExecutor {
+    async stopSession(sessionId) {
+        const { DaemonClient } = await import('../daemon/daemonClient.js');
+        const client = new DaemonClient();
+        if (!(await client.isRunning()))
+            return;
+        await client.stopSession(`${CHAT_SLOT_PREFIX}${sessionId}`).catch(() => undefined);
+    }
+    async cancelRun(sessionId) {
+        const { DaemonClient } = await import('../daemon/daemonClient.js');
+        const client = new DaemonClient();
+        if (!(await client.isRunning())) {
+            throw new Error('daemon not running');
+        }
+        await client.cancelRun(`${CHAT_SLOT_PREFIX}${sessionId}`);
+    }
+}
+// ─── ProjectInitExecutor —— 直接调 executeProjectInit ─────────────────
+export class DefaultProjectInitExecutor {
+    async init(project, opts) {
+        const { executeProjectInit } = await import('../commands/projectInit.js');
+        await executeProjectInit(project, {}, opts);
+    }
+}
+//# sourceMappingURL=executors.js.map

package/dist/services/executors.js.map

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

package/dist/services/ports.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module        services/ports
+ * @description   Service 层抽象依赖端口 —— concrete 实现在 services/defaults.ts
+ *
+ * @layer         services
+ *
+ * 为什么不直接 import Domain 具体类：
+ *   - 单测能用 fake 替换
+ *   - delivery 层不会被迫加载整个 Domain 图
+ *   - 将来想换 TaskBackend 实现（gitlab/github backend）只改 factory
+ */
+import type { TaskBackend } from '../interfaces/TaskBackend.js';
+/** 按 project 名拿 TaskBackend 实例 */
+export interface TaskBackendFactory {
+    for(project: string): Promise<TaskBackend>;
+}
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/services/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC5C"}

package/dist/services/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/services/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/services/ports.ts"],"names":[],"mappings":""}

package/dist/shared/domainEvents.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @module        shared/domainEvents
+ * @description   领域事件类型 + DomainEventBus port（抽象）
+ *
+ * @layer         shared
+ *
+ * Service 层发布事件，Delivery 层订阅并推给客户端：
+ *   - Console 侧订阅推到 SSE /stream/projects/*
+ *   - CLI 侧可注入 NoOp 实现（或 journal）
+ *
+ * 事件类型是 **领域事件**（过去时，已经发生的事实），不是 UI 事件也不是命令。
+ */
+import type { Card } from './types.js';
+export interface CardCreatedEvent {
+    readonly type: 'card.created';
+    readonly project: string;
+    readonly seq: number;
+    readonly card: Card;
+    readonly ts: number;
+}
+export interface CardUpdatedEvent {
+    readonly type: 'card.updated';
+    readonly project: string;
+    readonly seq: number;
+    readonly patch: Readonly<Partial<Card>>;
+    readonly ts: number;
+}
+export interface CardMovedEvent {
+    readonly type: 'card.moved';
+    readonly project: string;
+    readonly seq: number;
+    readonly from: string;
+    readonly to: string;
+    readonly ts: number;
+}
+export interface CardDeletedEvent {
+    readonly type: 'card.deleted';
+    readonly project: string;
+    readonly seq: number;
+    readonly ts: number;
+}
+export interface WorkerDispatchedEvent {
+    readonly type: 'worker.dispatched';
+    readonly project: string;
+    readonly slot: string;
+    readonly seq: number;
+    readonly stage: string;
+    readonly ts: number;
+}
+export interface WorkerUpdatedEvent {
+    readonly type: 'worker.updated';
+    readonly project: string;
+    readonly slot: string;
+    readonly ts: number;
+}
+export interface WorkerDeletedEvent {
+    readonly type: 'worker.deleted';
+    readonly project: string;
+    readonly slot: string;
+    readonly ts: number;
+}
+export interface PipelineStartedEvent {
+    readonly type: 'pipeline.started';
+    readonly project: string;
+    readonly pid: number;
+    readonly ts: number;
+}
+export interface PipelineStoppedEvent {
+    readonly type: 'pipeline.stopped';
+    readonly project: string;
+    readonly ts: number;
+}
+export interface SkillLinkedEvent {
+    readonly type: 'skill.linked';
+    readonly project: string;
+    readonly skill: string;
+    readonly ts: number;
+}
+export interface SkillUnlinkedEvent {
+    readonly type: 'skill.unlinked';
+    readonly project: string;
+    readonly skill: string;
+    readonly ts: number;
+}
+/** Union of all领域 events. */
+export type DomainEvent = CardCreatedEvent | CardUpdatedEvent | CardMovedEvent | CardDeletedEvent | WorkerDispatchedEvent | WorkerUpdatedEvent | WorkerDeletedEvent | PipelineStartedEvent | PipelineStoppedEvent | SkillLinkedEvent | SkillUnlinkedEvent;
+export type DomainEventType = DomainEvent['type'];
+/**
+ * DomainEventBus —— 事件总线抽象。
+ * Service 层只依赖这个接口，不知道底层是 SSE / noop / journal。
+ */
+export interface DomainEventBus {
+    /** 发布一个事件（同步返回） */
+    emit(event: DomainEvent): void;
+    /**
+     * 订阅所有事件。返回取消订阅函数。
+     * 订阅者里抛出的异常不会影响 publisher。
+     */
+    subscribe(handler: (event: DomainEvent) => void): () => void;
+}
+/**
+ * 什么都不做的实现 —— 用于 CLI / 单元测试。
+ * 保证 Service 层即使没接 real bus 也能跑。
+ */
+export declare class NoopEventBus implements DomainEventBus {
+    emit(_event: DomainEvent): void;
+    subscribe(_handler: (event: DomainEvent) => void): () => void;
+}
+/**
+ * 进程内同步广播 —— 用于测试和 CLI 的 journal 用途。
+ * 订阅者顺序执行，handler 内抛错被吞只记 console.warn（不阻塞 publisher）。
+ */
+export declare class InMemoryEventBus implements DomainEventBus {
+    private handlers;
+    emit(event: DomainEvent): void;
+    subscribe(handler: (event: DomainEvent) => void): () => void;
+}
+//# sourceMappingURL=domainEvents.d.ts.map

package/dist/shared/domainEvents.d.ts.map

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

package/dist/shared/domainEvents.js

@@ -0,0 +1,40 @@
+// ─── NoopEventBus ─────────────────────────────────────────────────
+/**
+ * 什么都不做的实现 —— 用于 CLI / 单元测试。
+ * 保证 Service 层即使没接 real bus 也能跑。
+ */
+export class NoopEventBus {
+    emit(_event) {
+        /* swallow */
+    }
+    subscribe(_handler) {
+        return () => {
+            /* no-op */
+        };
+    }
+}
+// ─── InMemoryEventBus ─────────────────────────────────────────────
+/**
+ * 进程内同步广播 —— 用于测试和 CLI 的 journal 用途。
+ * 订阅者顺序执行，handler 内抛错被吞只记 console.warn（不阻塞 publisher）。
+ */
+export class InMemoryEventBus {
+    handlers = new Set();
+    emit(event) {
+        for (const h of this.handlers) {
+            try {
+                h(event);
+            }
+            catch (err) {
+                console.warn('[DomainEventBus] handler threw:', err);
+            }
+        }
+    }
+    subscribe(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+}
+//# sourceMappingURL=domainEvents.js.map

package/dist/shared/domainEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainEvents.js","sourceRoot":"","sources":["../../src/shared/domainEvents.ts"],"names":[],"mappings":"AAmIA,qEAAqE;AAErE;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,IAAI,CAAC,MAAmB;QACtB,aAAa;IACf,CAAC;IACD,SAAS,CAAC,QAAsC;QAC9C,OAAO,GAAG,EAAE;YACV,WAAW;QACb,CAAC,CAAC;IACJ,CAAC;CACF;AAED,qEAAqE;AAErE;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEhE,IAAI,CAAC,KAAkB;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,CAAC,CAAC,KAAK,CAAC,CAAC;YACX,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAAqC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/shared/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @module        shared/errors
+ * @description   DomainError —— 所有 Service 层错误的统一结构
+ *
+ * @layer         shared
+ *
+ * Delivery 层（CLI / HTTP）负责翻译 DomainError 到各自输出格式：
+ *   - HTTP：toHttpStatus + problem+json body
+ *   - CLI：toExitCode + stderr 渲染
+ *
+ * Domain 层允许正常抛 Error；Service 层捕获后转 DomainError。
+ */
+export type DomainErrorKind = 
+/** 资源不存在 —— HTTP 404 / CLI exit 1 */
+'not-found'
+/** etag 冲突 / 状态冲突 / 并发竞争 —— HTTP 409 / CLI exit 1 */
+ | 'conflict'
+/** 入参非法（格式、schema 违反）—— HTTP 422 / CLI exit 2 */
+ | 'validation'
+/** 前置条件不满足（业务规则阻挡）—— HTTP 409 / CLI exit 2 */
+ | 'precondition'
+/** 外部系统错误（Git 失败 / npm registry 不通）—— HTTP 502 / CLI exit 3 */
+ | 'external'
+/** 未知内部错误 —— HTTP 500 / CLI exit 1 */
+ | 'internal';
+export interface DomainError {
+    readonly kind: DomainErrorKind;
+    /** 机读码（全大写 + 下划线），便于 i18n / 客户端分支。 */
+    readonly code: string;
+    /** 人读消息（默认中文），展示给终端用户。 */
+    readonly message: string;
+    /** 结构化上下文 —— 不含大对象 / 不含敏感数据。 */
+    readonly details?: Readonly<Record<string, unknown>>;
+    /** 原始异常 —— 仅日志 / debug 用，不暴露给客户端。 */
+    readonly cause?: unknown;
+}
+/** 构造 DomainError 的 factory（避免到处写 `{ kind, code, message }` 字面量）。 */
+export declare function domainError(kind: DomainErrorKind, code: string, message: string, extra?: {
+    details?: Record<string, unknown>;
+    cause?: unknown;
+}): DomainError;
+/** HTTP status code 映射 —— Console route 层用。 */
+export declare function toHttpStatus(e: DomainError): number;
+/** CLI exit code 映射 —— CLI command 层用。 */
+export declare function toExitCode(e: DomainError): number;
+/**
+ * 翻译为 application/problem+json（RFC 7807 兼容 shape）。
+ * Delivery 层的 HTTP 响应体用。
+ */
+export interface ProblemJson {
+    type: string;
+    title: string;
+    status: number;
+    detail: string;
+    code: string;
+    [k: string]: unknown;
+}
+export declare function toProblemJson(e: DomainError): ProblemJson;
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,eAAe;AACzB,qCAAqC;AACnC,WAAW;AACb,qDAAqD;GACnD,UAAU;AACZ,iDAAiD;GAC/C,YAAY;AACd,8CAA8C;GAC5C,cAAc;AAChB,+DAA+D;GAC7D,UAAU;AACZ,sCAAsC;GACpC,UAAU,CAAC;AAEf,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACjE,WAAW,CAQb;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAcnD;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAYjD;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CASzD"}

package/dist/shared/errors.js

@@ -0,0 +1,79 @@
+/**
+ * @module        shared/errors
+ * @description   DomainError —— 所有 Service 层错误的统一结构
+ *
+ * @layer         shared
+ *
+ * Delivery 层（CLI / HTTP）负责翻译 DomainError 到各自输出格式：
+ *   - HTTP：toHttpStatus + problem+json body
+ *   - CLI：toExitCode + stderr 渲染
+ *
+ * Domain 层允许正常抛 Error；Service 层捕获后转 DomainError。
+ */
+/** 构造 DomainError 的 factory（避免到处写 `{ kind, code, message }` 字面量）。 */
+export function domainError(kind, code, message, extra = {}) {
+    return {
+        kind,
+        code,
+        message,
+        ...(extra.details ? { details: extra.details } : {}),
+        ...(extra.cause !== undefined ? { cause: extra.cause } : {}),
+    };
+}
+/** HTTP status code 映射 —— Console route 层用。 */
+export function toHttpStatus(e) {
+    switch (e.kind) {
+        case 'not-found':
+            return 404;
+        case 'conflict':
+        case 'precondition':
+            return 409;
+        case 'validation':
+            return 422;
+        case 'external':
+            return 502;
+        case 'internal':
+            return 500;
+    }
+}
+/** CLI exit code 映射 —— CLI command 层用。 */
+export function toExitCode(e) {
+    switch (e.kind) {
+        case 'validation':
+        case 'precondition':
+            return 2;
+        case 'external':
+            return 3;
+        case 'not-found':
+        case 'conflict':
+        case 'internal':
+            return 1;
+    }
+}
+export function toProblemJson(e) {
+    return {
+        type: e.kind,
+        title: titleFor(e.kind),
+        status: toHttpStatus(e),
+        detail: e.message,
+        code: e.code,
+        ...(e.details ? { details: e.details } : {}),
+    };
+}
+function titleFor(kind) {
+    switch (kind) {
+        case 'not-found':
+            return 'Not Found';
+        case 'conflict':
+            return 'Conflict';
+        case 'precondition':
+            return 'Precondition Failed';
+        case 'validation':
+            return 'Validation Error';
+        case 'external':
+            return 'External Service Error';
+        case 'internal':
+            return 'Internal Error';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4BH,qEAAqE;AACrE,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,IAAY,EACZ,OAAe,EACf,QAAgE,EAAE;IAElE,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,CAAc;IACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,cAAc;YACjB,OAAO,GAAG,CAAC;QACb,KAAK,YAAY;YACf,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,CAAc;IACvC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAeD,MAAM,UAAU,aAAa,CAAC,CAAc;IAC1C,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAqB;IACrC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,cAAc;YACjB,OAAO,qBAAqB,CAAC;QAC/B,KAAK,YAAY;YACf,OAAO,kBAAkB,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,wBAAwB,CAAC;QAClC,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/shared/result.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module        shared/result
+ * @description   Result<T, E> —— Service 层约定返回的容器类型
+ *
+ * @layer         shared
+ *
+ * Service 方法不抛业务异常 —— 用 Result 表达"成功 + 值"或"失败 + 结构化错误"。
+ * `throw` 保留给真正的系统问题（OOM / 断言违反 / 库 panic）。
+ */
+import type { DomainError } from './errors.js';
+export type Result<T, E = DomainError> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+/** 包装成功结果。 */
+export declare function ok<T>(value: T): Result<T, never>;
+/** 包装失败结果。 */
+export declare function err<E>(error: E): Result<never, E>;
+/** 类型守卫：Result 是 Ok？ */
+export declare function isOk<T, E>(r: Result<T, E>): r is {
+    ok: true;
+    value: T;
+};
+/** 类型守卫：Result 是 Err？ */
+export declare function isErr<T, E>(r: Result<T, E>): r is {
+    ok: false;
+    error: E;
+};
+/**
+ * 成功时 map 值；失败时原样传递。
+ * 不改变 error 类型。
+ */
+export declare function mapOk<T, U, E>(r: Result<T, E>, f: (t: T) => U): Result<U, E>;
+/**
+ * 失败时 map 错误；成功时原样传递。
+ */
+export declare function mapErr<T, E, F>(r: Result<T, E>, f: (e: E) => F): Result<T, F>;
+/**
+ * 对 Ok 执行会返回 Result 的下一步（链式）。
+ * 任一步失败短路。
+ */
+export declare function andThen<T, U, E>(r: Result<T, E>, f: (t: T) => Promise<Result<U, E>>): Promise<Result<U, E>>;
+/**
+ * 取 Ok 值，不是 Ok 就抛 —— 仅用于测试 / 边界场景。
+ * 生产代码应该用 isOk + 分支处理。
+ */
+export declare function unwrap<T, E>(r: Result<T, E>, ctx?: string): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/shared/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/shared/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,IACjC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE9C,cAAc;AACd,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,cAAc;AACd,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED,wBAAwB;AACxB,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEvE;AAED,yBAAyB;AACzB,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACf,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAEvB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAM7D"}

package/dist/shared/result.js

@@ -0,0 +1,48 @@
+/** 包装成功结果。 */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** 包装失败结果。 */
+export function err(error) {
+    return { ok: false, error };
+}
+/** 类型守卫：Result 是 Ok？ */
+export function isOk(r) {
+    return r.ok;
+}
+/** 类型守卫：Result 是 Err？ */
+export function isErr(r) {
+    return !r.ok;
+}
+/**
+ * 成功时 map 值；失败时原样传递。
+ * 不改变 error 类型。
+ */
+export function mapOk(r, f) {
+    return r.ok ? ok(f(r.value)) : r;
+}
+/**
+ * 失败时 map 错误；成功时原样传递。
+ */
+export function mapErr(r, f) {
+    return r.ok ? r : err(f(r.error));
+}
+/**
+ * 对 Ok 执行会返回 Result 的下一步（链式）。
+ * 任一步失败短路。
+ */
+export async function andThen(r, f) {
+    return r.ok ? await f(r.value) : r;
+}
+/**
+ * 取 Ok 值，不是 Ok 就抛 —— 仅用于测试 / 边界场景。
+ * 生产代码应该用 isOk + 分支处理。
+ */
+export function unwrap(r, ctx) {
+    if (!r.ok) {
+        const prefix = ctx ? `${ctx}: ` : '';
+        throw new Error(`${prefix}unwrap on Err: ${JSON.stringify(r.error)}`);
+    }
+    return r.value;
+}
+//# sourceMappingURL=result.js.map

package/dist/shared/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/shared/result.ts"],"names":[],"mappings":"AAeA,cAAc;AACd,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,cAAc;AACd,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,IAAI,CAAO,CAAe;IACxC,OAAO,CAAC,CAAC,EAAE,CAAC;AACd,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,KAAK,CAAO,CAAe;IACzC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAU,CAAe,EAAE,CAAc;IAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAU,CAAe,EAAE,CAAc;IAC7D,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,CAAe,EACf,CAAkC;IAElC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAO,CAAe,EAAE,GAAY;IACxD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,kBAAkB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC"}