@coralai/sps-cli 0.57.9 โ†’ 0.57.11

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 (141) hide show
  1. package/dist/commands/projectInit.d.ts.map +1 -1
  2. package/dist/commands/projectInit.js +6 -1
  3. package/dist/commands/projectInit.js.map +1 -1
  4. package/dist/commands/setup.d.ts +9 -4
  5. package/dist/commands/setup.d.ts.map +1 -1
  6. package/dist/commands/setup.js +35 -67
  7. package/dist/commands/setup.js.map +1 -1
  8. package/dist/commands/skillCommand.js +17 -14
  9. package/dist/commands/skillCommand.js.map +1 -1
  10. package/dist/commands/tick.d.ts.map +1 -1
  11. package/dist/commands/tick.js +28 -7
  12. package/dist/commands/tick.js.map +1 -1
  13. package/dist/console/index.d.ts.map +1 -1
  14. package/dist/console/index.js +4 -0
  15. package/dist/console/index.js.map +1 -1
  16. package/dist/console/routes/chat.d.ts.map +1 -1
  17. package/dist/console/routes/chat.js +12 -3
  18. package/dist/console/routes/chat.js.map +1 -1
  19. package/dist/console/routes/prompts.d.ts +9 -0
  20. package/dist/console/routes/prompts.d.ts.map +1 -0
  21. package/dist/console/routes/prompts.js +47 -0
  22. package/dist/console/routes/prompts.js.map +1 -0
  23. package/dist/console/routes/rules.d.ts +10 -0
  24. package/dist/console/routes/rules.d.ts.map +1 -0
  25. package/dist/console/routes/rules.js +20 -0
  26. package/dist/console/routes/rules.js.map +1 -0
  27. package/dist/console/routes/skills.d.ts.map +1 -1
  28. package/dist/console/routes/skills.js +36 -0
  29. package/dist/console/routes/skills.js.map +1 -1
  30. package/dist/console-assets/assets/index-Bre7v6yj.js +636 -0
  31. package/dist/console-assets/assets/index-dZyXNg_s.css +10 -0
  32. package/dist/console-assets/index.html +2 -2
  33. package/dist/core/agents/AcpBackend.d.ts +15 -2
  34. package/dist/core/agents/AcpBackend.d.ts.map +1 -1
  35. package/dist/core/agents/AcpBackend.js +59 -6
  36. package/dist/core/agents/AcpBackend.js.map +1 -1
  37. package/dist/core/agents/AgentBackend.d.ts +20 -4
  38. package/dist/core/agents/AgentBackend.d.ts.map +1 -1
  39. package/dist/core/agents/ClaudeSdkBackend.d.ts +3 -1
  40. package/dist/core/agents/ClaudeSdkBackend.d.ts.map +1 -1
  41. package/dist/core/agents/ClaudeSdkBackend.js +7 -3
  42. package/dist/core/agents/ClaudeSdkBackend.js.map +1 -1
  43. package/dist/core/agents/resolveBackend.d.ts +2 -0
  44. package/dist/core/agents/resolveBackend.d.ts.map +1 -1
  45. package/dist/core/agents/resolveBackend.js +1 -1
  46. package/dist/core/agents/resolveBackend.js.map +1 -1
  47. package/dist/core/flatfile/frontmatter.d.ts +15 -0
  48. package/dist/core/flatfile/frontmatter.d.ts.map +1 -0
  49. package/dist/core/flatfile/frontmatter.js +38 -0
  50. package/dist/core/flatfile/frontmatter.js.map +1 -0
  51. package/dist/core/prompts/PromptStore.d.ts +44 -0
  52. package/dist/core/prompts/PromptStore.d.ts.map +1 -0
  53. package/dist/core/prompts/PromptStore.js +164 -0
  54. package/dist/core/prompts/PromptStore.js.map +1 -0
  55. package/dist/core/skills/SkillsManager.d.ts +6 -1
  56. package/dist/core/skills/SkillsManager.d.ts.map +1 -1
  57. package/dist/core/skills/SkillsManager.js +7 -3
  58. package/dist/core/skills/SkillsManager.js.map +1 -1
  59. package/dist/core/skills/distribution.d.ts +17 -2
  60. package/dist/core/skills/distribution.d.ts.map +1 -1
  61. package/dist/core/skills/distribution.js +42 -4
  62. package/dist/core/skills/distribution.js.map +1 -1
  63. package/dist/core/skills/index.d.ts +2 -1
  64. package/dist/core/skills/index.d.ts.map +1 -1
  65. package/dist/core/skills/index.js +2 -1
  66. package/dist/core/skills/index.js.map +1 -1
  67. package/dist/core/skills/policy.d.ts +24 -0
  68. package/dist/core/skills/policy.d.ts.map +1 -0
  69. package/dist/core/skills/policy.js +91 -0
  70. package/dist/core/skills/policy.js.map +1 -0
  71. package/dist/core/skills/skillPackage.d.ts +37 -0
  72. package/dist/core/skills/skillPackage.d.ts.map +1 -0
  73. package/dist/core/skills/skillPackage.js +137 -0
  74. package/dist/core/skills/skillPackage.js.map +1 -0
  75. package/dist/core/skills/types.d.ts +2 -0
  76. package/dist/core/skills/types.d.ts.map +1 -1
  77. package/dist/daemon/daemonClient.d.ts +5 -0
  78. package/dist/daemon/daemonClient.d.ts.map +1 -1
  79. package/dist/daemon/daemonClient.js.map +1 -1
  80. package/dist/daemon/sessionDaemon.d.ts.map +1 -1
  81. package/dist/daemon/sessionDaemon.js.map +1 -1
  82. package/dist/engines/MonitorEngine.d.ts.map +1 -1
  83. package/dist/engines/MonitorEngine.js +7 -0
  84. package/dist/engines/MonitorEngine.js.map +1 -1
  85. package/dist/engines/smartarrange/PipelineWorkerExec.d.ts +1 -1
  86. package/dist/engines/smartarrange/runner.d.ts +0 -3
  87. package/dist/engines/smartarrange/runner.d.ts.map +1 -1
  88. package/dist/engines/smartarrange/runner.js +9 -72
  89. package/dist/engines/smartarrange/runner.js.map +1 -1
  90. package/dist/manager/worker-manager-impl.d.ts +21 -1
  91. package/dist/manager/worker-manager-impl.d.ts.map +1 -1
  92. package/dist/manager/worker-manager-impl.js +153 -17
  93. package/dist/manager/worker-manager-impl.js.map +1 -1
  94. package/dist/manager/worker-manager.d.ts +22 -0
  95. package/dist/manager/worker-manager.d.ts.map +1 -1
  96. package/dist/services/PromptService.d.ts +28 -0
  97. package/dist/services/PromptService.d.ts.map +1 -0
  98. package/dist/services/PromptService.js +64 -0
  99. package/dist/services/PromptService.js.map +1 -0
  100. package/dist/services/RulesService.d.ts +16 -0
  101. package/dist/services/RulesService.d.ts.map +1 -0
  102. package/dist/services/RulesService.js +42 -0
  103. package/dist/services/RulesService.js.map +1 -0
  104. package/dist/services/SkillService.d.ts +39 -0
  105. package/dist/services/SkillService.d.ts.map +1 -1
  106. package/dist/services/SkillService.js +73 -42
  107. package/dist/services/SkillService.js.map +1 -1
  108. package/dist/services/container.d.ts +4 -0
  109. package/dist/services/container.d.ts.map +1 -1
  110. package/dist/services/container.js +4 -0
  111. package/dist/services/container.js.map +1 -1
  112. package/dist/shared/domainEvents.d.ts +25 -1
  113. package/dist/shared/domainEvents.d.ts.map +1 -1
  114. package/dist/shared/domainEvents.js.map +1 -1
  115. package/dist/shared/projectRepo.d.ts +3 -0
  116. package/dist/shared/projectRepo.d.ts.map +1 -0
  117. package/dist/shared/projectRepo.js +23 -0
  118. package/dist/shared/projectRepo.js.map +1 -0
  119. package/dist/shared/runtimePaths.d.ts +2 -0
  120. package/dist/shared/runtimePaths.d.ts.map +1 -1
  121. package/dist/shared/runtimePaths.js +4 -0
  122. package/dist/shared/runtimePaths.js.map +1 -1
  123. package/package.json +1 -1
  124. package/dist/console-assets/assets/index-BOpxRNe1.css +0 -10
  125. package/dist/console-assets/assets/index-l-4ti4ol.js +0 -605
  126. package/dist/engines/smartarrange/AcpWorkerExec.d.ts +0 -35
  127. package/dist/engines/smartarrange/AcpWorkerExec.d.ts.map +0 -1
  128. package/dist/engines/smartarrange/AcpWorkerExec.js +0 -71
  129. package/dist/engines/smartarrange/AcpWorkerExec.js.map +0 -1
  130. package/project-template/.claude/CLAUDE.md +0 -66
  131. package/project-template/.claude/hooks/start.sh +0 -44
  132. package/project-template/.claude/hooks/stop.sh +0 -54
  133. package/project-template/.claude/rules/.gitkeep +0 -0
  134. package/project-template/.claude/settings.json +0 -32
  135. package/project-template/.claude/settings.local.json.template +0 -3
  136. package/project-template/.claude/skills/.gitkeep +0 -0
  137. package/project-template/README.md +0 -10
  138. package/project-template/batch_scheduler.sh +0 -8
  139. package/project-template/conf.template +0 -61
  140. package/project-template/deploy.sh +0 -3
  141. package/project-template/pm_meta/.gitkeep +0 -0
@@ -1,35 +0,0 @@
1
- /**
2
- * @module engines/smartarrange/AcpWorkerExec
3
- * @description WorkerExec ๅฎž็Žฐ:ๅœจไธ€ไธช**ไฟๆดป AgentBackend ไผš่ฏ**ไธŠ่ทจ tick ๅผ‚ๆญฅ่ท‘ orchestrator
4
- * ๅŠจๆ€ไบง็š„ๅกใ€‚ๆœฌ็ฑปๅช็ฎก็ผ–ๆŽ’้ข(busy ่ทŸ่ธชใ€็ป“ๆžœๆถˆ่ดนใ€prompt ๆ‹ผ่ฃ…);ๅ…ทไฝ“ agent
5
- * ็š„ๅฏๅŠจ/ๆดพๆดป/ๆŸฅ็Šถๆ€/ๆ”ถๅฐพ่ตฐๆณจๅ…ฅ็š„ AgentBackend(้ป˜่ฎค claude-ACP,ๅฏๆข openai)ใ€‚
6
- * @layer engine
7
- * @boundedContext smartarrange
8
- */
9
- import type { AgentBackend } from '../../core/agents/AgentBackend.js';
10
- import type { WorkerExec } from '../SmartArrangeEngine.js';
11
- export declare class AcpWorkerExec implements WorkerExec {
12
- private readonly backend;
13
- private readonly promptSuffix;
14
- private readonly recall?;
15
- private busy;
16
- private dispatched;
17
- private lastResult;
18
- constructor(backend: AgentBackend, promptSuffix?: string, // ่ฟฝๅŠ ๅˆฐๆฏๅผ ๅก prompt(ๅฆ‚่ฎฐๅฟ†ๅผ•ๅฏผ)
19
- recall?: ((query: string) => Promise<string>) | undefined);
20
- sync(): Promise<void>;
21
- isBusy(): boolean;
22
- takeLastResult(): {
23
- seq: number;
24
- title: string;
25
- execStatus: 'completed' | 'failed';
26
- } | null;
27
- dispatch(card: {
28
- seq: number;
29
- title: string;
30
- prompt: string;
31
- skills: string[];
32
- }): void;
33
- stop(): Promise<void>;
34
- }
35
- //# sourceMappingURL=AcpWorkerExec.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AcpWorkerExec.d.ts","sourceRoot":"","sources":["../../../src/engines/smartarrange/AcpWorkerExec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,qBAAa,aAAc,YAAW,UAAU;IAM5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,UAAU,CAAmF;gBAGlF,OAAO,EAAE,YAAY,EACrB,YAAY,SAAK,EAAE,uBAAuB;IAE1C,MAAM,CAAC,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,aAAA;IAGxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,MAAM,IAAI,OAAO;IAIjB,cAAc,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAA;KAAE,GAAG,IAAI;IAM3F,QAAQ,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAkBhF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
@@ -1,71 +0,0 @@
1
- import { TERMINAL_RUN_STATES } from '../../core/agents/AgentBackend.js';
2
- export class AcpWorkerExec {
3
- backend;
4
- promptSuffix;
5
- recall;
6
- busy = false;
7
- dispatched = null;
8
- lastResult = null;
9
- constructor(backend, promptSuffix = '', // ่ฟฝๅŠ ๅˆฐๆฏๅผ ๅก prompt(ๅฆ‚่ฎฐๅฟ†ๅผ•ๅฏผ)
10
- // ่ฏปยทpush:dispatch ๅ‰็”จๅก็‰‡ๅ†…ๅฎนๆŸฅ่ทจ้กน็›ฎ่ฎฐๅฟ†ๅบ“,่ฟ”ๅ›žๅทฒๆ ผๅผๅŒ–็š„ <recalled-memory> ๅ—(ๆ— ๅˆ™ '')
11
- recall) {
12
- this.backend = backend;
13
- this.promptSuffix = promptSuffix;
14
- this.recall = recall;
15
- }
16
- async sync() {
17
- if (!this.dispatched)
18
- return;
19
- try {
20
- const st = await this.backend.runState();
21
- if (TERMINAL_RUN_STATES.has(st)) {
22
- this.lastResult = { seq: this.dispatched.seq, title: this.dispatched.title, execStatus: st === 'completed' ? 'completed' : 'failed' };
23
- this.busy = false;
24
- this.dispatched = null;
25
- }
26
- else {
27
- this.busy = true;
28
- }
29
- }
30
- catch {
31
- /* ๆŸฅไธๅˆฐ run(ๅฏ่ƒฝ startRun ่ฟ˜ๅœจๅปบ)โ†’ ไฟๆŒ busy,ไธ‹ไธ€ tick ๅ†ๆŸฅ */
32
- }
33
- }
34
- isBusy() {
35
- return this.busy;
36
- }
37
- takeLastResult() {
38
- const r = this.lastResult;
39
- this.lastResult = null;
40
- return r;
41
- }
42
- dispatch(card) {
43
- this.busy = true;
44
- this.dispatched = { seq: card.seq, title: card.title };
45
- void (async () => {
46
- try {
47
- // ่ฏปยทpush:ๅผ€ๅทฅๅ‰็œŸๅฌๅ›ž็›ธๅ…ณ่ฎฐๅฟ†,prepend ่ฟ› prompt(ๅคฑ่ดฅไธ้˜ปๅกžๆดพๆดป)ใ€‚
48
- const recalled = this.recall
49
- ? await this.recall(`${card.title}\n${card.prompt}`).catch(() => '')
50
- : '';
51
- await this.backend.dispatch(recalled + buildCardPrompt(card) + this.promptSuffix); // backend ๅ†…้ƒจ lazy ensure
52
- }
53
- catch {
54
- this.lastResult = { seq: card.seq, title: card.title, execStatus: 'failed' };
55
- this.busy = false;
56
- this.dispatched = null;
57
- }
58
- })();
59
- }
60
- async stop() {
61
- await this.backend.stop();
62
- }
63
- }
64
- /** ๆŠŠ orchestrator ็š„ๅก prompt + skills ๆ‹ผๆˆๅ–‚ worker ็š„ๅฎŒๆ•ดๆ็คบใ€‚ */
65
- function buildCardPrompt(card) {
66
- const skills = card.skills?.length
67
- ? `\n\n# ้œ€ๅŠ ่ฝฝ็š„ Skills\nๆœฌๅก้œ€่ฆ: ${card.skills.join(', ')}ใ€‚็”จ Skill ๅทฅๅ…ทๅŠ ่ฝฝๅนถ้ตๅฎˆๅฎƒไปฌใ€‚`
68
- : '';
69
- return `${card.prompt}${skills}`;
70
- }
71
- //# sourceMappingURL=AcpWorkerExec.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AcpWorkerExec.js","sourceRoot":"","sources":["../../../src/engines/smartarrange/AcpWorkerExec.ts"],"names":[],"mappings":"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"}
@@ -1,66 +0,0 @@
1
- # Project Rules (Claude Code Worker)
2
-
3
- <!--
4
- This file is auto-generated by `sps project init` / `sps doctor --fix`.
5
- Edit it to add project-specific rules. SPS will not overwrite it once it exists.
6
- -->
7
-
8
- ## Scope
9
-
10
- - Work only in the current project directory.
11
- - Do NOT read or modify files outside this directory.
12
- - Do NOT explore `~/.coral/projects/...` or other system paths.
13
-
14
- ## SPS Pipeline Context
15
-
16
- This project is driven by SPS (Smart Pipeline System). Each card is a task.
17
- When you are launched as a worker, two env vars identify your stable context:
18
-
19
- - `$SPS_PROJECT` โ€” project name (stable across card reuse)
20
- - `$SPS_WORKER_SLOT` โ€” worker slot name (stable across card reuse)
21
-
22
- Per-card information (card id, stage name, title) is **not** in env. POSIX
23
- freezes env at spawn, so any per-card value would go stale once the claude
24
- process is reused for the next card. If you need the current card info,
25
- read the marker file or use the `sps` CLI:
26
-
27
- - Marker file: `~/.coral/projects/$SPS_PROJECT/runtime/worker-$SPS_WORKER_SLOT-current.json`
28
- - CLI: `sps card dashboard $SPS_PROJECT` (or the command your task prompt already passed to you)
29
-
30
- ## Card lifecycle labels (for reference โ€” all managed automatically)
31
-
32
- Each card moves through these labels during its pipeline run:
33
-
34
- - `AI-PIPELINE` โ€” added at `sps card add`; the pipeline admission mark
35
- - `CLAIMED` โ€” added when SPS claims a worker slot for this card
36
- - `STARTED-<stage>` โ€” added automatically on each prompt submit via the
37
- **UserPromptSubmit** hook. This is the "ACK signal" that proves Claude
38
- received the prompt. If this label doesn't appear within
39
- `WORKER_ACK_TIMEOUT_S` seconds after dispatch, SPS's MonitorEngine flags
40
- `ACK-TIMEOUT` and StageEngine kills the worker + retries.
41
- - `COMPLETED-<stage>` โ€” added on turn end via the **Stop hook**. Tells SPS
42
- to advance the card to the next stage (or Done).
43
-
44
- You do NOT need to manually update card state, move the card between
45
- columns, or commit on behalf of the pipeline. The hooks do it all.
46
-
47
- **Honesty note**: If you declare "done" without actually implementing the
48
- work, the pipeline will still advance (the Stop hook fires regardless). The
49
- user relies on your honesty here.
50
-
51
- ## Memory
52
-
53
- - Claude's **auto memory** is enabled and stored under
54
- `~/.coral/projects/$SPS_PROJECT/memory/`. You write to `MEMORY.md` there
55
- to persist knowledge across sessions.
56
- - Use `sps memory add $SPS_PROJECT --type ...` to write structured SPS memories
57
- (conventions, decisions, lessons) for the human to curate.
58
-
59
- ## Git (if the project uses git)
60
-
61
- - Claude handles all git operations itself (commit, push, etc.).
62
- - SPS does NOT intervene in git workflows or conflict resolution.
63
-
64
- ## Project-specific rules
65
-
66
- <!-- Add your own conventions, architecture notes, and constraints below. -->
@@ -1,44 +0,0 @@
1
- #!/bin/bash
2
- # SPS Pipeline Worker โ€” UserPromptSubmit hook (v0.42.0+)
3
- #
4
- # Triggered synchronously before Claude processes each prompt. Used by SPS
5
- # to label the card with STARTED-<stage> โ€” this is the "ACK signal" that
6
- # proves Claude received the prompt. Also injects skill hints based on the
7
- # card's `skills` field (or legacy skill:* labels).
8
- #
9
- # Phase 2 is user-customizable: add audit logging, request rate limiting,
10
- # prompt enrichment, etc. without touching Phase 1.
11
- #
12
- # Env vars (stable across claude process reuse):
13
- # SPS_PROJECT Project name
14
- # SPS_WORKER_SLOT Worker slot name
15
- #
16
- # Per-card info (card id, stage, title) is NOT in env โ€” POSIX env freezes at
17
- # spawn. Hook scripts must read the marker file instead. Phase 1 does this
18
- # automatically via `sps hook user-prompt-submit`.
19
-
20
- set -e
21
-
22
- # โ”€โ”€โ”€ Phase 1: SPS official action (do NOT remove) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
23
- # Reads marker file โ†’ addLabel STARTED-<stage> + emit skill hints.
24
- sps hook user-prompt-submit
25
-
26
- # โ”€โ”€โ”€ Phase 2: User-customizable actions (edit as needed) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
27
-
28
- # Example: audit log of every prompt submission.
29
- # if [ -n "$SPS_PROJECT" ] && [ -n "$SPS_WORKER_SLOT" ]; then
30
- # echo "$(date): prompt submitted to $SPS_PROJECT/$SPS_WORKER_SLOT" \
31
- # >> "$CLAUDE_PROJECT_DIR/.sps/user-prompts.log"
32
- # fi
33
-
34
- # Example: rate limiting (block if too many prompts in a window).
35
- # count=$(find "$CLAUDE_PROJECT_DIR/.sps" -name 'last-prompt-*' -mmin -1 | wc -l)
36
- # if [ "$count" -gt 30 ]; then
37
- # echo '{"decision":"block","reason":"rate limit exceeded (>30 prompts/min)"}'
38
- # exit 0
39
- # fi
40
-
41
- # Example: prompt-to-Slack mirror for team visibility.
42
- # curl -sfX POST "$SLACK_WEBHOOK" -d "{\"text\":\"[$SPS_PROJECT] new prompt\"}"
43
-
44
- exit 0
@@ -1,54 +0,0 @@
1
- #!/bin/bash
2
- # SPS Pipeline Worker โ€” Stop hook
3
- #
4
- # Triggered when Claude finishes its current turn. The pipeline depends on
5
- # Phase 1 to advance card state. Phase 2+ is user-customizable.
6
- #
7
- # Env vars (set by SPS worker at spawn time, frozen for the process lifetime):
8
- # SPS_PROJECT Project name (stable across card reuse)
9
- # SPS_WORKER_SLOT Worker slot name (stable across card reuse)
10
- #
11
- # These two env vars form the index to locate the per-slot marker file:
12
- # ~/.coral/projects/$SPS_PROJECT/runtime/worker-$SPS_WORKER_SLOT-current.json
13
- #
14
- # Per-card info (card id, stage name, card title) is intentionally NOT in env.
15
- # POSIX freezes env at spawn; when the claude process is reused for the next
16
- # card, any per-card env would go stale. Always read the marker file (or use
17
- # `sps` CLI) to get current card information.
18
- #
19
- # Claude-native env also available:
20
- # CLAUDE_PROJECT_DIR, CLAUDE_SESSION_ID
21
-
22
- set -e
23
-
24
- # โ”€โ”€โ”€ Phase 1: SPS official action (do NOT remove) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
25
- # Mark the card complete so pipeline can advance state.
26
- # We call mark-complete WITHOUT a seq โ€” the command reads the per-slot
27
- # current-card marker file (written by the worker manager on each dispatch)
28
- # to get the authoritative current card. This is the only way to be correct
29
- # when the same claude process handles multiple cards in sequence.
30
- if [ -n "$SPS_PROJECT" ] && [ -n "$SPS_WORKER_SLOT" ]; then
31
- # ็ปไธ่ฎฉ mark-complete ๅคฑ่ดฅ้˜ปๅกž stop:Stop hook ้ž้›ถ้€€ๅ‡บไผš่ขซ claude ๅฝ“ๆˆ"ๅˆซๅœใ€็ปง็ปญ",
32
- # ๅฏผ่‡ด worker ่ขซๆ— ้™้‡ๆˆณ("Acknowledged." ๆญปๅพช็Žฏ)ใ€‚ๅคฑ่ดฅไป…่ฎฐ stderr(MonitorEngine ๆœ‰่ถ…ๆ—ถๅ…œๅบ•)ใ€‚
33
- sps card mark-complete "$SPS_PROJECT" || echo "[stop.sh] mark-complete non-fatal failure โ€” allowing stop" >&2
34
- fi
35
-
36
- # โ”€โ”€โ”€ Phase 2: User-customizable actions (edit as needed) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
37
-
38
- # Example: record the session transcript location for later audit.
39
- # if [ -n "$CLAUDE_SESSION_ID" ] && [ -n "$SPS_CARD_ID" ]; then
40
- # echo "$CLAUDE_SESSION_ID" >> "$CLAUDE_PROJECT_DIR/.sps/session-log.txt"
41
- # fi
42
-
43
- # Example: third-party knowledge base capture.
44
- # if command -v your-kb-cli &>/dev/null; then
45
- # your-kb-cli capture --project "$SPS_PROJECT" --session "$CLAUDE_SESSION_ID"
46
- # fi
47
-
48
- # Example: notify on completion.
49
- # sps notify matrix "[$SPS_PROJECT] seq $SPS_CARD_ID ($SPS_STAGE) done"
50
-
51
- # Example: post-task CI trigger.
52
- # curl -sfX POST "$CI_WEBHOOK" -d "{\"project\":\"$SPS_PROJECT\",\"card\":\"$SPS_CARD_ID\"}"
53
-
54
- exit 0
File without changes
@@ -1,32 +0,0 @@
1
- {
2
- "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
- "hooks": {
4
- "Stop": [
5
- {
6
- "hooks": [
7
- {
8
- "type": "command",
9
- "command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop.sh"
10
- }
11
- ]
12
- }
13
- ],
14
- "UserPromptSubmit": [
15
- {
16
- "hooks": [
17
- {
18
- "type": "command",
19
- "command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/start.sh"
20
- }
21
- ]
22
- }
23
- ]
24
- },
25
- "attribution": {
26
- "commit": "",
27
- "pr": ""
28
- },
29
- "companyAnnouncements": [
30
- "๐Ÿ”ง SPS Pipeline Worker โ€” completion is declared via Stop hook \u2192 COMPLETED-<stage> label"
31
- ]
32
- }
@@ -1,3 +0,0 @@
1
- {
2
- "autoMemoryDirectory": "~/.coral/projects/__PROJECT__/memory"
3
- }
File without changes
@@ -1,10 +0,0 @@
1
- # Project Template
2
-
3
- This folder is copied into `~/.coral/projects/<project-name>/` for each new pipeline-managed project.
4
-
5
- Contents:
6
- - `conf` โ€” project-specific configuration
7
- - `deploy.sh` โ€” optional project-local deploy entrypoint
8
- - `batch_scheduler.sh` โ€” project-local Planning โ†’ Backlog scheduler
9
- - `logs/` โ€” runtime logs
10
- - `pm_meta/` โ€” local PM metadata store (used especially for Plane)
@@ -1,8 +0,0 @@
1
- #!/usr/bin/env bash
2
- # batch_scheduler.sh โ€” project-local cron entry point
3
- # Delegates to the SPS CLI tick command.
4
- set -euo pipefail
5
-
6
- PROJECT_NAME="$(basename "$(cd "$(dirname "$0")" && pwd)")"
7
-
8
- exec sps tick "$PROJECT_NAME" "$@"
@@ -1,61 +0,0 @@
1
- # โ”€โ”€ ้กน็›ฎๅŸบ็ก€ไฟกๆฏ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
2
- export PROJECT_NAME="__PROJECT_NAME__"
3
-
4
- # โ”€โ”€ ่ทฏๅพ„้…็ฝฎ๏ผˆๅฏ้€‰๏ผŒไธ่ฎพ็ฝฎๅˆ™ไฝฟ็”จ้ป˜่ฎคๅ€ผ๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
5
- # ไธšๅŠกไปฃ็ ไป“ๅบ“็›ฎๅฝ•๏ผˆ้ป˜่ฎค: ~/projects/<project>๏ผ‰
6
- # export PROJECT_DIR="$HOME/projects/__PROJECT_NAME__"
7
- # Worker worktree ๆ น็›ฎๅฝ•๏ผˆ้ป˜่ฎค: ~/.coral/worktrees/๏ผ‰
8
- # export WORKTREE_DIR="$HOME/.coral/worktrees"
9
-
10
- # โ”€โ”€ GitLab๏ผˆ้กน็›ฎ็‰นๆœ‰๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
11
- # GITLAB_URL / GITLAB_TOKEN ไปŽๅ…จๅฑ€ ~/.coral/env ็ปงๆ‰ฟ๏ผŒๆญคๅค„ไธ้‡ๅค
12
- export GITLAB_PROJECT="__GITLAB_PROJECT__"
13
- # GITLAB_PROJECT_ID ๅฏ้€‰ โ€” ็•™็ฉบๅˆ™้€š่ฟ‡ GITLAB_PROJECT ่ทฏๅพ„่‡ชๅŠจๆŸฅ่ฏข
14
- # export GITLAB_PROJECT_ID=""
15
- export GITLAB_MERGE_BRANCH="develop"
16
-
17
- # โ”€โ”€ PM Backend โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
18
- export PM_TOOL="plane"
19
-
20
- # โ”€โ”€ Trello๏ผˆPM_TOOL=trello ๆ—ถๅกซๅ†™๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
21
- # TRELLO_API_KEY / TRELLO_TOKEN ไปŽๅ…จๅฑ€ ~/.coral/env ็ปงๆ‰ฟ
22
- # export TRELLO_BOARD_ID=""
23
- # export TRELLO_LIST_PLANNING=""
24
- # export TRELLO_LIST_BACKLOG=""
25
- # export TRELLO_LIST_TODO=""
26
- # export TRELLO_LIST_INPROGRESS=""
27
- # export TRELLO_LIST_QA=""
28
- # export TRELLO_LIST_DONE=""
29
- # export TRELLO_ACCOUNT=""
30
-
31
- # โ”€โ”€ Plane๏ผˆPM_TOOL=plane ๆ—ถๅกซๅ†™๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
32
- # PLANE_URL / PLANE_API_KEY / PLANE_WORKSPACE_SLUG ไปŽๅ…จๅฑ€ ~/.coral/env ็ปงๆ‰ฟ
33
- export PLANE_PROJECT_ID="__PLANE_PROJECT_ID__"
34
- export PLANE_STATE_PLANNING="__PLANE_STATE_PLANNING__"
35
- export PLANE_STATE_BACKLOG="__PLANE_STATE_BACKLOG__"
36
- export PLANE_STATE_TODO="__PLANE_STATE_TODO__"
37
- export PLANE_STATE_INPROGRESS="__PLANE_STATE_INPROGRESS__"
38
- export PLANE_STATE_QA="__PLANE_STATE_QA__"
39
- export PLANE_STATE_DONE="__PLANE_STATE_DONE__"
40
-
41
- # โ”€โ”€ Pipeline โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
42
- export PIPELINE_LABEL="AI-PIPELINE"
43
- export MR_MODE="none"
44
-
45
- # โ”€โ”€ Worker / Agent โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
46
- # claude is the only supported CLI; no selector exposed.
47
- export MAX_CONCURRENT_WORKERS=3
48
- # export MAX_ACTIONS_PER_TICK=1
49
- # export WORKER_RESTART_LIMIT=2
50
- # export DEFAULT_WORKER_SKILLS="senior"
51
-
52
- # โ”€โ”€ ่ถ…ๆ—ถไธŽ็ญ–็•ฅ๏ผˆๅฏ้€‰๏ผŒไปฅไธ‹ไธบ้ป˜่ฎคๅ€ผ๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
53
- # export INPROGRESS_TIMEOUT_HOURS=8
54
- # export MONITOR_AUTO_QA=false
55
- # export CONFLICT_DEFAULT=serial
56
- # export TICK_LOCK_TIMEOUT_MINUTES=30
57
-
58
- # โ”€โ”€ ้€š็Ÿฅ๏ผˆ้กน็›ฎ็‰นๆœ‰ โ€” ไธๅŒ้กน็›ฎๅฏๅ‘ไธๅŒๆˆฟ้—ด๏ผ‰โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
59
- # MATRIX_HOMESERVER / MATRIX_ACCESS_TOKEN ไปŽๅ…จๅฑ€ ~/.coral/env ็ปงๆ‰ฟ
60
- # ๅฆ‚ๆžœ้กน็›ฎ้œ€่ฆๅ‘ๅˆฐ็‰นๅฎšๆˆฟ้—ด๏ผŒ่ฎพ็ฝฎ MATRIX_ROOM_ID๏ผš
61
- # export MATRIX_ROOM_ID=""
@@ -1,3 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
- echo "Deployment not configured for ${PROJECT_NAME:-unknown-project}"
File without changes