@coralai/sps-cli 0.49.16 → 0.50.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/dist/commands/cardAdd.d.ts.map +1 -1
  2. package/dist/commands/cardAdd.js +47 -67
  3. package/dist/commands/cardAdd.js.map +1 -1
  4. package/dist/commands/cardMarkComplete.js +1 -1
  5. package/dist/commands/cardMarkComplete.js.map +1 -1
  6. package/dist/commands/cardMarkStarted.js +1 -1
  7. package/dist/commands/cardMarkStarted.js.map +1 -1
  8. package/dist/commands/consoleCommand.js +3 -3
  9. package/dist/commands/consoleCommand.js.map +1 -1
  10. package/dist/commands/hookCommand.d.ts +25 -0
  11. package/dist/commands/hookCommand.d.ts.map +1 -1
  12. package/dist/commands/hookCommand.js +2 -2
  13. package/dist/commands/hookCommand.js.map +1 -1
  14. package/dist/console/index.d.ts +15 -0
  15. package/dist/console/index.d.ts.map +1 -0
  16. package/dist/console/index.js +180 -0
  17. package/dist/console/index.js.map +1 -0
  18. package/dist/console/lib/lockFile.d.ts +17 -0
  19. package/dist/console/lib/lockFile.d.ts.map +1 -0
  20. package/dist/console/lib/lockFile.js +61 -0
  21. package/dist/console/lib/lockFile.js.map +1 -0
  22. package/dist/console/lib/portPicker.d.ts +3 -0
  23. package/dist/console/lib/portPicker.d.ts.map +1 -0
  24. package/dist/console/lib/portPicker.js +25 -0
  25. package/dist/console/lib/portPicker.js.map +1 -0
  26. package/dist/console/lib/resultToJson.d.ts +18 -0
  27. package/dist/console/lib/resultToJson.d.ts.map +1 -0
  28. package/dist/console/lib/resultToJson.js +19 -0
  29. package/dist/console/lib/resultToJson.js.map +1 -0
  30. package/dist/console/routes/cards.d.ts +26 -0
  31. package/dist/console/routes/cards.d.ts.map +1 -0
  32. package/dist/console/routes/cards.js +85 -0
  33. package/dist/console/routes/cards.js.map +1 -0
  34. package/dist/console/routes/chat.d.ts +37 -0
  35. package/dist/console/routes/chat.d.ts.map +1 -0
  36. package/dist/console/routes/chat.js +378 -0
  37. package/dist/console/routes/chat.js.map +1 -0
  38. package/dist/console/routes/logs.d.ts +17 -0
  39. package/dist/console/routes/logs.d.ts.map +1 -0
  40. package/dist/console/routes/logs.js +159 -0
  41. package/dist/console/routes/logs.js.map +1 -0
  42. package/dist/console/routes/pipeline.d.ts +10 -0
  43. package/dist/console/routes/pipeline.d.ts.map +1 -0
  44. package/dist/console/routes/pipeline.js +39 -0
  45. package/dist/console/routes/pipeline.js.map +1 -0
  46. package/dist/console/routes/projects.d.ts +15 -0
  47. package/dist/console/routes/projects.d.ts.map +1 -0
  48. package/dist/console/routes/projects.js +132 -0
  49. package/dist/console/routes/projects.js.map +1 -0
  50. package/dist/console/routes/skills.d.ts +4 -0
  51. package/dist/console/routes/skills.d.ts.map +1 -0
  52. package/dist/console/routes/skills.js +91 -0
  53. package/dist/console/routes/skills.js.map +1 -0
  54. package/dist/console/routes/system.d.ts +10 -0
  55. package/dist/console/routes/system.d.ts.map +1 -0
  56. package/dist/console/routes/system.js +84 -0
  57. package/dist/console/routes/system.js.map +1 -0
  58. package/dist/console/routes/workers.d.ts +5 -0
  59. package/dist/console/routes/workers.d.ts.map +1 -0
  60. package/dist/console/routes/workers.js +149 -0
  61. package/dist/console/routes/workers.js.map +1 -0
  62. package/dist/console/sse/eventBus.d.ts +25 -0
  63. package/dist/console/sse/eventBus.d.ts.map +1 -0
  64. package/dist/console/sse/eventBus.js +32 -0
  65. package/dist/console/sse/eventBus.js.map +1 -0
  66. package/dist/console/sse/projectStream.d.ts +13 -0
  67. package/dist/console/sse/projectStream.d.ts.map +1 -0
  68. package/dist/console/sse/projectStream.js +84 -0
  69. package/dist/console/sse/projectStream.js.map +1 -0
  70. package/dist/core/checklist.d.ts +1 -1
  71. package/dist/core/state.d.ts +1 -1
  72. package/dist/engines/MonitorEngine.d.ts +1 -1
  73. package/dist/engines/SchedulerEngine.d.ts +1 -1
  74. package/dist/engines/StageEngine.d.ts +1 -1
  75. package/dist/infra/chokidarWatchers.d.ts +38 -0
  76. package/dist/infra/chokidarWatchers.d.ts.map +1 -0
  77. package/dist/infra/chokidarWatchers.js +213 -0
  78. package/dist/infra/chokidarWatchers.js.map +1 -0
  79. package/dist/infra/clock.d.ts +35 -0
  80. package/dist/infra/clock.d.ts.map +1 -0
  81. package/dist/infra/clock.js +45 -0
  82. package/dist/infra/clock.js.map +1 -0
  83. package/dist/infra/filesystem.d.ts +89 -0
  84. package/dist/infra/filesystem.d.ts.map +1 -0
  85. package/dist/infra/filesystem.js +247 -0
  86. package/dist/infra/filesystem.js.map +1 -0
  87. package/dist/infra/spawn.d.ts +67 -0
  88. package/dist/infra/spawn.d.ts.map +1 -0
  89. package/dist/infra/spawn.js +116 -0
  90. package/dist/infra/spawn.js.map +1 -0
  91. package/dist/infra/sseBus.d.ts +36 -0
  92. package/dist/infra/sseBus.d.ts.map +1 -0
  93. package/dist/infra/sseBus.js +72 -0
  94. package/dist/infra/sseBus.js.map +1 -0
  95. package/dist/interfaces/ACPClient.d.ts +1 -1
  96. package/dist/interfaces/ACPClient.d.ts.map +1 -1
  97. package/dist/interfaces/RepoBackend.d.ts +1 -1
  98. package/dist/interfaces/TaskBackend.d.ts +1 -1
  99. package/dist/main.js +1 -1
  100. package/dist/main.js.map +1 -1
  101. package/dist/providers/GitLabRepoBackend.d.ts +1 -1
  102. package/dist/providers/LocalACPClient.d.ts +1 -1
  103. package/dist/providers/LocalACPClient.d.ts.map +1 -1
  104. package/dist/providers/MarkdownTaskBackend.d.ts +1 -1
  105. package/dist/services/CardService.d.ts +86 -0
  106. package/dist/services/CardService.d.ts.map +1 -0
  107. package/dist/services/CardService.js +313 -0
  108. package/dist/services/CardService.js.map +1 -0
  109. package/dist/services/ChatService.d.ts +62 -0
  110. package/dist/services/ChatService.d.ts.map +1 -0
  111. package/dist/services/ChatService.js +157 -0
  112. package/dist/services/ChatService.js.map +1 -0
  113. package/dist/services/LogService.d.ts +46 -0
  114. package/dist/services/LogService.d.ts.map +1 -0
  115. package/dist/services/LogService.js +185 -0
  116. package/dist/services/LogService.js.map +1 -0
  117. package/dist/services/PipelineService.d.ts +71 -0
  118. package/dist/services/PipelineService.d.ts.map +1 -0
  119. package/dist/services/PipelineService.js +349 -0
  120. package/dist/services/PipelineService.js.map +1 -0
  121. package/dist/services/ProjectService.d.ts +105 -0
  122. package/dist/services/ProjectService.d.ts.map +1 -0
  123. package/dist/services/ProjectService.js +346 -0
  124. package/dist/services/ProjectService.js.map +1 -0
  125. package/dist/services/SkillService.d.ts +38 -0
  126. package/dist/services/SkillService.d.ts.map +1 -0
  127. package/dist/services/SkillService.js +301 -0
  128. package/dist/services/SkillService.js.map +1 -0
  129. package/dist/services/SystemService.d.ts +67 -0
  130. package/dist/services/SystemService.d.ts.map +1 -0
  131. package/dist/services/SystemService.js +278 -0
  132. package/dist/services/SystemService.js.map +1 -0
  133. package/dist/services/WorkerService.d.ts +83 -0
  134. package/dist/services/WorkerService.d.ts.map +1 -0
  135. package/dist/services/WorkerService.js +262 -0
  136. package/dist/services/WorkerService.js.map +1 -0
  137. package/dist/services/container.d.ts +44 -0
  138. package/dist/services/container.d.ts.map +1 -0
  139. package/dist/services/container.js +104 -0
  140. package/dist/services/container.js.map +1 -0
  141. package/dist/services/defaults.d.ts +15 -0
  142. package/dist/services/defaults.d.ts.map +1 -0
  143. package/dist/services/defaults.js +11 -0
  144. package/dist/services/defaults.js.map +1 -0
  145. package/dist/services/executors.d.ts +38 -0
  146. package/dist/services/executors.d.ts.map +1 -0
  147. package/dist/services/executors.js +157 -0
  148. package/dist/services/executors.js.map +1 -0
  149. package/dist/services/ports.d.ts +17 -0
  150. package/dist/services/ports.d.ts.map +1 -0
  151. package/dist/services/ports.js +2 -0
  152. package/dist/services/ports.js.map +1 -0
  153. package/dist/shared/domainEvents.d.ts +118 -0
  154. package/dist/shared/domainEvents.d.ts.map +1 -0
  155. package/dist/shared/domainEvents.js +40 -0
  156. package/dist/shared/domainEvents.js.map +1 -0
  157. package/dist/shared/errors.d.ts +59 -0
  158. package/dist/shared/errors.d.ts.map +1 -0
  159. package/dist/shared/errors.js +79 -0
  160. package/dist/shared/errors.js.map +1 -0
  161. package/dist/shared/result.d.ts +51 -0
  162. package/dist/shared/result.d.ts.map +1 -0
  163. package/dist/shared/result.js +48 -0
  164. package/dist/shared/result.js.map +1 -0
  165. package/dist/shared/runtimePaths.d.ts +78 -0
  166. package/dist/shared/runtimePaths.d.ts.map +1 -0
  167. package/dist/shared/runtimePaths.js +179 -0
  168. package/dist/shared/runtimePaths.js.map +1 -0
  169. package/dist/shared/runtimeSchemas.d.ts +324 -0
  170. package/dist/shared/runtimeSchemas.d.ts.map +1 -0
  171. package/dist/shared/runtimeSchemas.js +124 -0
  172. package/dist/shared/runtimeSchemas.js.map +1 -0
  173. package/dist/shared/types.d.ts +97 -0
  174. package/dist/shared/types.d.ts.map +1 -0
  175. package/dist/shared/types.js +11 -0
  176. package/dist/shared/types.js.map +1 -0
  177. package/package.json +1 -1
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @module console/sse/projectStream
3
+ * @description /stream/projects/:name —— 单项目的 card / worker / pipeline 事件流
4
+ *
5
+ * @layer console
6
+ *
7
+ * 订阅 SseEventBus,过滤 project 匹配的 DomainEvent,以 SSE 格式写给客户端。
8
+ * 支持 Last-Event-ID 断线补偿。
9
+ */
10
+ import { Hono } from 'hono';
11
+ import type { SseEventBus } from '../../infra/sseBus.js';
12
+ export declare function createProjectStreamRoute(bus: SseEventBus): Hono;
13
+ //# sourceMappingURL=projectStream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projectStream.d.ts","sourceRoot":"","sources":["../../../src/console/sse/projectStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAatE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAqE/D"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * @module console/sse/projectStream
3
+ * @description /stream/projects/:name —— 单项目的 card / worker / pipeline 事件流
4
+ *
5
+ * @layer console
6
+ *
7
+ * 订阅 SseEventBus,过滤 project 匹配的 DomainEvent,以 SSE 格式写给客户端。
8
+ * 支持 Last-Event-ID 断线补偿。
9
+ */
10
+ import { Hono } from 'hono';
11
+ const HEARTBEAT_MS = 15_000;
12
+ function formatSse(id, event, data) {
13
+ return `id: ${id}\nevent: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
14
+ }
15
+ function isProjectEvent(record, project) {
16
+ const d = record.data;
17
+ return d?.project === project;
18
+ }
19
+ export function createProjectStreamRoute(bus) {
20
+ const app = new Hono();
21
+ app.get('/:project', (c) => {
22
+ const project = c.req.param('project');
23
+ const lastEventId = Number.parseInt(c.req.header('last-event-id') ?? '0', 10) || 0;
24
+ c.header('Content-Type', 'text/event-stream');
25
+ c.header('Cache-Control', 'no-cache, no-transform');
26
+ c.header('Connection', 'keep-alive');
27
+ c.header('X-Accel-Buffering', 'no');
28
+ const stream = new ReadableStream({
29
+ start(controller) {
30
+ const enc = new TextEncoder();
31
+ let closed = false;
32
+ const safeWrite = (chunk) => {
33
+ if (closed)
34
+ return;
35
+ try {
36
+ controller.enqueue(enc.encode(chunk));
37
+ }
38
+ catch {
39
+ closed = true;
40
+ }
41
+ };
42
+ // 1. 补发断线期间的历史事件
43
+ if (lastEventId > 0) {
44
+ const history = bus.since(lastEventId).filter((r) => isProjectEvent(r, project));
45
+ for (const r of history) {
46
+ safeWrite(formatSse(r.id, r.event, r.data));
47
+ }
48
+ }
49
+ // 2. 订阅实时
50
+ const cancel = bus.subscribeRaw((record) => {
51
+ if (!isProjectEvent(record, project))
52
+ return;
53
+ safeWrite(formatSse(record.id, record.event, record.data));
54
+ });
55
+ // 3. 心跳保活
56
+ const heartbeat = setInterval(() => {
57
+ safeWrite(`: heartbeat ${Date.now()}\n\n`);
58
+ }, HEARTBEAT_MS);
59
+ // 4. 客户端断开 → 清理
60
+ c.req.raw.signal?.addEventListener('abort', () => {
61
+ closed = true;
62
+ cancel();
63
+ clearInterval(heartbeat);
64
+ try {
65
+ controller.close();
66
+ }
67
+ catch {
68
+ /* ignore */
69
+ }
70
+ });
71
+ },
72
+ });
73
+ return new Response(stream, {
74
+ headers: {
75
+ 'Content-Type': 'text/event-stream',
76
+ 'Cache-Control': 'no-cache, no-transform',
77
+ Connection: 'keep-alive',
78
+ 'X-Accel-Buffering': 'no',
79
+ },
80
+ });
81
+ });
82
+ return app;
83
+ }
84
+ //# sourceMappingURL=projectStream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projectStream.js","sourceRoot":"","sources":["../../../src/console/sse/projectStream.ts"],"names":[],"mappings":"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"}
@@ -12,7 +12,7 @@
12
12
  * - parseChecklist 每次读卡时调用(毫秒级成本),不缓存
13
13
  * - 只统计顶级项目,嵌套子项不递归(见 v0.42 设计决策 #6)
14
14
  */
15
- import type { ChecklistStats } from '../models/types.js';
15
+ import type { ChecklistStats } from '../shared/types.js';
16
16
  /**
17
17
  * Parse a markdown body for the "## 检查清单" section and return progress stats.
18
18
  * Returns `undefined` when the section is missing entirely (so callers can
@@ -1,5 +1,5 @@
1
1
  import type { ACPSessionRecord } from '../models/acp.js';
2
- import type { CardState } from '../models/types.js';
2
+ import type { CardState } from '../shared/types.js';
3
3
  export interface WorkerSlotState {
4
4
  status: 'idle' | 'active' | 'merging' | 'resolving' | 'releasing';
5
5
  seq: number | null;
@@ -22,7 +22,7 @@ import type { RepoBackend } from '../interfaces/RepoBackend.js';
22
22
  import type { TaskBackend } from '../interfaces/TaskBackend.js';
23
23
  import type { ProcessSupervisor } from '../manager/supervisor.js';
24
24
  import type { WorkerManager } from '../manager/worker-manager.js';
25
- import type { CommandResult } from '../models/types.js';
25
+ import type { CommandResult } from '../shared/types.js';
26
26
  /**
27
27
  * MonitorEngine performs anomaly detection and health checks.
28
28
  *
@@ -20,7 +20,7 @@ import type { ProjectContext } from '../core/context.js';
20
20
  import type { ProjectPipelineAdapter } from '../core/projectPipelineAdapter.js';
21
21
  import type { Notifier } from '../interfaces/Notifier.js';
22
22
  import type { TaskBackend } from '../interfaces/TaskBackend.js';
23
- import type { CommandResult } from '../models/types.js';
23
+ import type { CommandResult } from '../shared/types.js';
24
24
  export declare class SchedulerEngine {
25
25
  private ctx;
26
26
  private taskBackend;
@@ -22,7 +22,7 @@ import type { Notifier } from '../interfaces/Notifier.js';
22
22
  import type { RepoBackend } from '../interfaces/RepoBackend.js';
23
23
  import type { TaskBackend } from '../interfaces/TaskBackend.js';
24
24
  import type { WorkerManager } from '../manager/worker-manager.js';
25
- import type { CommandResult } from '../models/types.js';
25
+ import type { CommandResult } from '../shared/types.js';
26
26
  /**
27
27
  * StageEngine — generic engine that handles any pipeline stage.
28
28
  *
@@ -0,0 +1,38 @@
1
+ /**
2
+ * @module infra/chokidarWatchers
3
+ * @description chokidar FS 监听 → DomainEventBus 事件翻译
4
+ *
5
+ * @layer infra
6
+ *
7
+ * v0.50 重构:把原 console-server/watchers/* 三个分散模块统一成 port 驱动。
8
+ * 输出不再是具体 eventBus 单例,而是注入的 DomainEventBus —— 测试可以用 FakeBus
9
+ * 验证"FS 事件 → DomainEvent"翻译规则。
10
+ *
11
+ * 职责:
12
+ * - 卡片 md 文件变化 → card.created / updated / deleted
13
+ * - marker 文件变化 → worker.dispatched / updated / deleted
14
+ * - supervisor.pid 出现或消失(轮询,chokidar 对 pid 不敏感)→ pipeline.started / stopped
15
+ */
16
+ import type { DomainEventBus } from '../shared/domainEvents.js';
17
+ import type { Clock } from './clock.js';
18
+ import type { FileSystem } from './filesystem.js';
19
+ export interface WatcherHandles {
20
+ close(): Promise<void>;
21
+ }
22
+ export interface StartWatchersOptions {
23
+ /** SPS coral root(通常 $HOME/.coral) */
24
+ coralRoot: string;
25
+ /** 订阅 port */
26
+ bus: DomainEventBus;
27
+ /** 轮询 supervisor.pid 的间隔(ms),默认 2000 */
28
+ pipelinePollMs?: number;
29
+ /** 可选时钟(注 ts 用) */
30
+ clock?: Clock;
31
+ /** 可选 FS(测试注入) */
32
+ fs?: FileSystem;
33
+ }
34
+ /**
35
+ * 启动全部 watchers。返回一个 close() —— 调用后异步关闭 chokidar + clear interval。
36
+ */
37
+ export declare function startChokidarWatchers(opts: StartWatchersOptions): WatcherHandles;
38
+ //# sourceMappingURL=chokidarWatchers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chokidarWatchers.d.ts","sourceRoot":"","sources":["../../src/infra/chokidarWatchers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA0BD,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,GAAG,EAAE,cAAc,CAAC;IACpB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kBAAkB;IAClB,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CA2FhF"}
@@ -0,0 +1,213 @@
1
+ /**
2
+ * @module infra/chokidarWatchers
3
+ * @description chokidar FS 监听 → DomainEventBus 事件翻译
4
+ *
5
+ * @layer infra
6
+ *
7
+ * v0.50 重构:把原 console-server/watchers/* 三个分散模块统一成 port 驱动。
8
+ * 输出不再是具体 eventBus 单例,而是注入的 DomainEventBus —— 测试可以用 FakeBus
9
+ * 验证"FS 事件 → DomainEvent"翻译规则。
10
+ *
11
+ * 职责:
12
+ * - 卡片 md 文件变化 → card.created / updated / deleted
13
+ * - marker 文件变化 → worker.dispatched / updated / deleted
14
+ * - supervisor.pid 出现或消失(轮询,chokidar 对 pid 不敏感)→ pipeline.started / stopped
15
+ */
16
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
17
+ import chokidar from 'chokidar';
18
+ import { projectsDir, supervisorPidFile, WorkerMarkerFilenameRe, } from '../shared/runtimePaths.js';
19
+ // ─── Card watcher ──────────────────────────────────────────────────
20
+ /** 从绝对路径抽 project + seq —— 容忍顶层 cards/N.md 和 cards/<state>/N-slug.md */
21
+ function extractCardInfo(path) {
22
+ const m = path.match(/projects\/([^/]+)\/cards\/(?:[^/]+\/)?(\d+)(?:-[^/]*)?\.md$/);
23
+ if (!m)
24
+ return null;
25
+ const seq = Number.parseInt(m[2] ?? '', 10);
26
+ return Number.isFinite(seq) && seq >= 0 ? { project: m[1] ?? '', seq } : null;
27
+ }
28
+ /** 从 marker 文件路径抽 project + slot 字符串名 */
29
+ function extractMarkerInfo(path) {
30
+ const m = path.match(/projects\/([^/]+)\/runtime\/([^/]+)$/);
31
+ if (!m)
32
+ return null;
33
+ const filename = m[2];
34
+ if (!WorkerMarkerFilenameRe.test(filename))
35
+ return null;
36
+ // 从文件名抽 slotName(保持原字符串,可能是 "worker-1" 或 "1")
37
+ const slotMatch = filename.match(/^worker-(.+)-current\.json$/);
38
+ if (!slotMatch)
39
+ return null;
40
+ return { project: m[1] ?? '', slot: slotMatch[1] };
41
+ }
42
+ /**
43
+ * 启动全部 watchers。返回一个 close() —— 调用后异步关闭 chokidar + clear interval。
44
+ */
45
+ export function startChokidarWatchers(opts) {
46
+ const now = () => opts.clock?.now() ?? Date.now();
47
+ const watchers = [];
48
+ const cleanups = [];
49
+ // 1. cards watcher
50
+ watchers.push(chokidar
51
+ .watch(`${opts.coralRoot}/projects`, {
52
+ persistent: true,
53
+ ignoreInitial: true,
54
+ awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
55
+ depth: 4,
56
+ ignored: (p) => /\/(node_modules|\.git|\.DS_Store)(\/|$)/.test(p),
57
+ })
58
+ .on('add', (path) => {
59
+ if (!path.endsWith('.md'))
60
+ return;
61
+ const info = extractCardInfo(path);
62
+ if (!info)
63
+ return;
64
+ // 注意:这里不反查 card 详情 —— 事件只携带 seq,订阅者需要时自己读。
65
+ // 这样可以避免 watcher 层依赖 Service 层,保持层依赖干净。
66
+ opts.bus.emit({
67
+ type: 'card.created',
68
+ project: info.project,
69
+ seq: info.seq,
70
+ // watcher 不反查;fallback 一个最小 Card shape
71
+ card: minimalCard(info.seq),
72
+ ts: now(),
73
+ });
74
+ })
75
+ .on('change', (path) => {
76
+ if (!path.endsWith('.md'))
77
+ return;
78
+ const info = extractCardInfo(path);
79
+ if (!info)
80
+ return;
81
+ opts.bus.emit({
82
+ type: 'card.updated',
83
+ project: info.project,
84
+ seq: info.seq,
85
+ patch: {},
86
+ ts: now(),
87
+ });
88
+ })
89
+ .on('unlink', (path) => {
90
+ if (!path.endsWith('.md'))
91
+ return;
92
+ const info = extractCardInfo(path);
93
+ if (!info)
94
+ return;
95
+ opts.bus.emit({
96
+ type: 'card.deleted',
97
+ project: info.project,
98
+ seq: info.seq,
99
+ ts: now(),
100
+ });
101
+ }));
102
+ // 2. marker watcher
103
+ watchers.push(chokidar
104
+ .watch(`${opts.coralRoot}/projects`, {
105
+ persistent: true,
106
+ ignoreInitial: true,
107
+ awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 40 },
108
+ depth: 3,
109
+ ignored: (p) => /\/(node_modules|\.git|\.DS_Store)(\/|$)/.test(p),
110
+ })
111
+ .on('add', (path) => {
112
+ const info = extractMarkerInfo(path);
113
+ if (!info)
114
+ return;
115
+ opts.bus.emit({ type: 'worker.updated', project: info.project, slot: info.slot, ts: now() });
116
+ })
117
+ .on('change', (path) => {
118
+ const info = extractMarkerInfo(path);
119
+ if (!info)
120
+ return;
121
+ opts.bus.emit({ type: 'worker.updated', project: info.project, slot: info.slot, ts: now() });
122
+ })
123
+ .on('unlink', (path) => {
124
+ const info = extractMarkerInfo(path);
125
+ if (!info)
126
+ return;
127
+ opts.bus.emit({ type: 'worker.deleted', project: info.project, slot: info.slot, ts: now() });
128
+ }));
129
+ // 3. pipeline poller
130
+ cleanups.push(startPipelinePoller(opts));
131
+ return {
132
+ async close() {
133
+ for (const c of cleanups)
134
+ c();
135
+ await Promise.all(watchers.map((w) => w.close().catch(() => undefined)));
136
+ },
137
+ };
138
+ }
139
+ function minimalCard(seq) {
140
+ return {
141
+ id: `md-${seq}`,
142
+ seq: String(seq),
143
+ title: `#${seq}`,
144
+ desc: '',
145
+ state: '',
146
+ labels: [],
147
+ meta: {},
148
+ };
149
+ }
150
+ function readSupervisorState(fs, pidPath) {
151
+ const exists = fs ? fs.exists(pidPath) : existsSync(pidPath);
152
+ if (!exists)
153
+ return { pid: null, running: false };
154
+ try {
155
+ const raw = fs ? fs.readFile(pidPath) : readFileSync(pidPath, 'utf-8');
156
+ const pid = Number.parseInt(raw.trim(), 10);
157
+ if (!Number.isFinite(pid) || pid <= 0)
158
+ return { pid: null, running: false };
159
+ try {
160
+ process.kill(pid, 0);
161
+ return { pid, running: true };
162
+ }
163
+ catch {
164
+ return { pid: null, running: false };
165
+ }
166
+ }
167
+ catch {
168
+ return { pid: null, running: false };
169
+ }
170
+ }
171
+ function startPipelinePoller(opts) {
172
+ const intervalMs = opts.pipelinePollMs ?? 2000;
173
+ const previous = new Map();
174
+ const tick = () => {
175
+ const projDir = projectsDir();
176
+ // 读目录需要 real fs —— pipelinePoller 总是对真实磁盘扫
177
+ let names = [];
178
+ try {
179
+ names = readdirSync(projDir, { withFileTypes: true })
180
+ .filter((e) => e.isDirectory())
181
+ .map((e) => e.name);
182
+ }
183
+ catch {
184
+ return;
185
+ }
186
+ for (const name of names) {
187
+ const state = readSupervisorState(opts.fs, supervisorPidFile(name));
188
+ const prev = previous.get(name);
189
+ if (!prev || prev.running !== state.running || prev.pid !== state.pid) {
190
+ if (state.running && state.pid !== null) {
191
+ opts.bus.emit({
192
+ type: 'pipeline.started',
193
+ project: name,
194
+ pid: state.pid,
195
+ ts: opts.clock?.now() ?? Date.now(),
196
+ });
197
+ }
198
+ else {
199
+ opts.bus.emit({
200
+ type: 'pipeline.stopped',
201
+ project: name,
202
+ ts: opts.clock?.now() ?? Date.now(),
203
+ });
204
+ }
205
+ previous.set(name, state);
206
+ }
207
+ }
208
+ };
209
+ const id = setInterval(tick, intervalMs);
210
+ tick();
211
+ return () => clearInterval(id);
212
+ }
213
+ //# sourceMappingURL=chokidarWatchers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chokidarWatchers.js","sourceRoot":"","sources":["../../src/infra/chokidarWatchers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * @module infra/clock
3
+ * @description Clock port —— 时间来源抽象
4
+ *
5
+ * @layer infra
6
+ *
7
+ * Service 层不直接 new Date() / Date.now();注入 Clock 让时间可控,便于测试。
8
+ */
9
+ export interface Clock {
10
+ /** ms 精度的时间戳 */
11
+ now(): number;
12
+ /** Date 对象 */
13
+ nowDate(): Date;
14
+ /** ISO 8601 字符串 */
15
+ nowIso(): string;
16
+ }
17
+ /** 默认系统时钟。 */
18
+ export declare class SystemClock implements Clock {
19
+ now(): number;
20
+ nowDate(): Date;
21
+ nowIso(): string;
22
+ }
23
+ /** 测试用 —— 可设置 / 步进时间。 */
24
+ export declare class FakeClock implements Clock {
25
+ private t;
26
+ constructor(initial?: number | string | Date);
27
+ now(): number;
28
+ nowDate(): Date;
29
+ nowIso(): string;
30
+ /** 跳到指定时刻 */
31
+ setTime(t: number | string | Date): void;
32
+ /** 前进 ms */
33
+ advance(ms: number): void;
34
+ }
35
+ //# sourceMappingURL=clock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/infra/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,KAAK;IACpB,gBAAgB;IAChB,GAAG,IAAI,MAAM,CAAC;IACd,cAAc;IACd,OAAO,IAAI,IAAI,CAAC;IAChB,mBAAmB;IACnB,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,cAAc;AACd,qBAAa,WAAY,YAAW,KAAK;IACvC,GAAG,IAAI,MAAM;IAGb,OAAO,IAAI,IAAI;IAGf,MAAM,IAAI,MAAM;CAGjB;AAED,yBAAyB;AACzB,qBAAa,SAAU,YAAW,KAAK;IACrC,OAAO,CAAC,CAAC,CAAS;gBAEN,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAQ;IAI/C,GAAG,IAAI,MAAM;IAGb,OAAO,IAAI,IAAI;IAGf,MAAM,IAAI,MAAM;IAIhB,aAAa;IACb,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;IAIxC,YAAY;IACZ,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG1B"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @module infra/clock
3
+ * @description Clock port —— 时间来源抽象
4
+ *
5
+ * @layer infra
6
+ *
7
+ * Service 层不直接 new Date() / Date.now();注入 Clock 让时间可控,便于测试。
8
+ */
9
+ /** 默认系统时钟。 */
10
+ export class SystemClock {
11
+ now() {
12
+ return Date.now();
13
+ }
14
+ nowDate() {
15
+ return new Date();
16
+ }
17
+ nowIso() {
18
+ return new Date().toISOString();
19
+ }
20
+ }
21
+ /** 测试用 —— 可设置 / 步进时间。 */
22
+ export class FakeClock {
23
+ t;
24
+ constructor(initial = 0) {
25
+ this.t = typeof initial === 'number' ? initial : new Date(initial).getTime();
26
+ }
27
+ now() {
28
+ return this.t;
29
+ }
30
+ nowDate() {
31
+ return new Date(this.t);
32
+ }
33
+ nowIso() {
34
+ return new Date(this.t).toISOString();
35
+ }
36
+ /** 跳到指定时刻 */
37
+ setTime(t) {
38
+ this.t = typeof t === 'number' ? t : new Date(t).getTime();
39
+ }
40
+ /** 前进 ms */
41
+ advance(ms) {
42
+ this.t += ms;
43
+ }
44
+ }
45
+ //# sourceMappingURL=clock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/infra/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,cAAc;AACd,MAAM,OAAO,WAAW;IACtB,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IACD,OAAO;QACL,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IACD,MAAM;QACJ,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;CACF;AAED,yBAAyB;AACzB,MAAM,OAAO,SAAS;IACZ,CAAC,CAAS;IAElB,YAAY,UAAkC,CAAC;QAC7C,IAAI,CAAC,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO;QACL,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM;QACJ,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,aAAa;IACb,OAAO,CAAC,CAAyB;QAC/B,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC;IAED,YAAY;IACZ,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,CAAC;CACF"}
@@ -0,0 +1,89 @@
1
+ export interface FileStat {
2
+ size: number;
3
+ mtimeMs: number;
4
+ isDirectory: boolean;
5
+ isFile: boolean;
6
+ }
7
+ export interface DirEntry {
8
+ name: string;
9
+ isDirectory: boolean;
10
+ isFile: boolean;
11
+ }
12
+ export interface FileSystem {
13
+ exists(path: string): boolean;
14
+ stat(path: string): FileStat | null;
15
+ readFile(path: string): string;
16
+ /** 原子写 —— 先写 .tmp 再 rename,避免 reader 看到半截内容 */
17
+ writeFileAtomic(path: string, content: string): void;
18
+ /** 非原子写,少数场景用(如 append log) */
19
+ writeFile(path: string, content: string): void;
20
+ readDir(path: string): DirEntry[];
21
+ mkdir(path: string, opts?: {
22
+ recursive?: boolean;
23
+ }): void;
24
+ unlink(path: string): void;
25
+ /** 递归删除目录或文件 */
26
+ rm(path: string, opts?: {
27
+ recursive?: boolean;
28
+ force?: boolean;
29
+ }): void;
30
+ rename(from: string, to: string): void;
31
+ }
32
+ export declare class NodeFileSystem implements FileSystem {
33
+ exists(path: string): boolean;
34
+ stat(path: string): FileStat | null;
35
+ readFile(path: string): string;
36
+ writeFileAtomic(path: string, content: string): void;
37
+ writeFile(path: string, content: string): void;
38
+ readDir(path: string): DirEntry[];
39
+ mkdir(path: string, opts?: {
40
+ recursive?: boolean;
41
+ }): void;
42
+ unlink(path: string): void;
43
+ rm(path: string, opts?: {
44
+ recursive?: boolean;
45
+ force?: boolean;
46
+ }): void;
47
+ rename(from: string, to: string): void;
48
+ }
49
+ /**
50
+ * 简版内存 FS —— 支持 absolute path 的读写/扫描/删除。
51
+ * 用于 Service 层单测:构造场景快、清理干净、不依赖 tmp 目录。
52
+ * 不追求和 POSIX 100% 语义一致,够测试用即可。
53
+ */
54
+ export declare class InMemoryFileSystem implements FileSystem {
55
+ private root;
56
+ private counter;
57
+ private readonly nowFn;
58
+ /**
59
+ * @param opts.nowFn 自定义"写入时的 mtime 生成器"。默认用 Date.now()(和 Node FS 语义一致)。
60
+ * 测试想要精确控制 mtime 可以传 FakeClock 的 now 方法。
61
+ */
62
+ constructor(opts?: {
63
+ nowFn?: () => number;
64
+ });
65
+ private tick;
66
+ private walk;
67
+ /**
68
+ * 找到 path 的父目录节点 + basename;父不存在时按 createDirs 决定是否补齐。
69
+ * 返回 null 仅当 path 为空。
70
+ */
71
+ private walkParent;
72
+ exists(path: string): boolean;
73
+ stat(path: string): FileStat | null;
74
+ readFile(path: string): string;
75
+ writeFileAtomic(path: string, content: string): void;
76
+ writeFile(path: string, content: string): void;
77
+ readDir(path: string): DirEntry[];
78
+ mkdir(path: string, opts?: {
79
+ recursive?: boolean;
80
+ }): void;
81
+ unlink(path: string): void;
82
+ rm(path: string, opts?: {
83
+ recursive?: boolean;
84
+ force?: boolean;
85
+ }): void;
86
+ rename(from: string, to: string): void;
87
+ private writeEntryAt;
88
+ }
89
+ //# sourceMappingURL=filesystem.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/infra/filesystem.ts"],"names":[],"mappings":"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"}