@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.
- package/dist/commands/projectInit.d.ts.map +1 -1
- package/dist/commands/projectInit.js +6 -1
- package/dist/commands/projectInit.js.map +1 -1
- package/dist/commands/setup.d.ts +9 -4
- package/dist/commands/setup.d.ts.map +1 -1
- package/dist/commands/setup.js +35 -67
- package/dist/commands/setup.js.map +1 -1
- package/dist/commands/skillCommand.js +17 -14
- package/dist/commands/skillCommand.js.map +1 -1
- package/dist/commands/tick.d.ts.map +1 -1
- package/dist/commands/tick.js +28 -7
- package/dist/commands/tick.js.map +1 -1
- package/dist/console/index.d.ts.map +1 -1
- package/dist/console/index.js +4 -0
- package/dist/console/index.js.map +1 -1
- package/dist/console/routes/chat.d.ts.map +1 -1
- package/dist/console/routes/chat.js +12 -3
- package/dist/console/routes/chat.js.map +1 -1
- package/dist/console/routes/prompts.d.ts +9 -0
- package/dist/console/routes/prompts.d.ts.map +1 -0
- package/dist/console/routes/prompts.js +47 -0
- package/dist/console/routes/prompts.js.map +1 -0
- package/dist/console/routes/rules.d.ts +10 -0
- package/dist/console/routes/rules.d.ts.map +1 -0
- package/dist/console/routes/rules.js +20 -0
- package/dist/console/routes/rules.js.map +1 -0
- package/dist/console/routes/skills.d.ts.map +1 -1
- package/dist/console/routes/skills.js +36 -0
- package/dist/console/routes/skills.js.map +1 -1
- package/dist/console-assets/assets/index-Bre7v6yj.js +636 -0
- package/dist/console-assets/assets/index-dZyXNg_s.css +10 -0
- package/dist/console-assets/index.html +2 -2
- package/dist/core/agents/AcpBackend.d.ts +15 -2
- package/dist/core/agents/AcpBackend.d.ts.map +1 -1
- package/dist/core/agents/AcpBackend.js +59 -6
- package/dist/core/agents/AcpBackend.js.map +1 -1
- package/dist/core/agents/AgentBackend.d.ts +20 -4
- package/dist/core/agents/AgentBackend.d.ts.map +1 -1
- package/dist/core/agents/ClaudeSdkBackend.d.ts +3 -1
- package/dist/core/agents/ClaudeSdkBackend.d.ts.map +1 -1
- package/dist/core/agents/ClaudeSdkBackend.js +7 -3
- package/dist/core/agents/ClaudeSdkBackend.js.map +1 -1
- package/dist/core/agents/resolveBackend.d.ts +2 -0
- package/dist/core/agents/resolveBackend.d.ts.map +1 -1
- package/dist/core/agents/resolveBackend.js +1 -1
- package/dist/core/agents/resolveBackend.js.map +1 -1
- package/dist/core/flatfile/frontmatter.d.ts +15 -0
- package/dist/core/flatfile/frontmatter.d.ts.map +1 -0
- package/dist/core/flatfile/frontmatter.js +38 -0
- package/dist/core/flatfile/frontmatter.js.map +1 -0
- package/dist/core/prompts/PromptStore.d.ts +44 -0
- package/dist/core/prompts/PromptStore.d.ts.map +1 -0
- package/dist/core/prompts/PromptStore.js +164 -0
- package/dist/core/prompts/PromptStore.js.map +1 -0
- package/dist/core/skills/SkillsManager.d.ts +6 -1
- package/dist/core/skills/SkillsManager.d.ts.map +1 -1
- package/dist/core/skills/SkillsManager.js +7 -3
- package/dist/core/skills/SkillsManager.js.map +1 -1
- package/dist/core/skills/distribution.d.ts +17 -2
- package/dist/core/skills/distribution.d.ts.map +1 -1
- package/dist/core/skills/distribution.js +42 -4
- package/dist/core/skills/distribution.js.map +1 -1
- package/dist/core/skills/index.d.ts +2 -1
- package/dist/core/skills/index.d.ts.map +1 -1
- package/dist/core/skills/index.js +2 -1
- package/dist/core/skills/index.js.map +1 -1
- package/dist/core/skills/policy.d.ts +24 -0
- package/dist/core/skills/policy.d.ts.map +1 -0
- package/dist/core/skills/policy.js +91 -0
- package/dist/core/skills/policy.js.map +1 -0
- package/dist/core/skills/skillPackage.d.ts +37 -0
- package/dist/core/skills/skillPackage.d.ts.map +1 -0
- package/dist/core/skills/skillPackage.js +137 -0
- package/dist/core/skills/skillPackage.js.map +1 -0
- package/dist/core/skills/types.d.ts +2 -0
- package/dist/core/skills/types.d.ts.map +1 -1
- package/dist/daemon/daemonClient.d.ts +5 -0
- package/dist/daemon/daemonClient.d.ts.map +1 -1
- package/dist/daemon/daemonClient.js.map +1 -1
- package/dist/daemon/sessionDaemon.d.ts.map +1 -1
- package/dist/daemon/sessionDaemon.js.map +1 -1
- package/dist/engines/MonitorEngine.d.ts.map +1 -1
- package/dist/engines/MonitorEngine.js +7 -0
- package/dist/engines/MonitorEngine.js.map +1 -1
- package/dist/engines/smartarrange/PipelineWorkerExec.d.ts +1 -1
- package/dist/engines/smartarrange/runner.d.ts +0 -3
- package/dist/engines/smartarrange/runner.d.ts.map +1 -1
- package/dist/engines/smartarrange/runner.js +9 -72
- package/dist/engines/smartarrange/runner.js.map +1 -1
- package/dist/manager/worker-manager-impl.d.ts +21 -1
- package/dist/manager/worker-manager-impl.d.ts.map +1 -1
- package/dist/manager/worker-manager-impl.js +153 -17
- package/dist/manager/worker-manager-impl.js.map +1 -1
- package/dist/manager/worker-manager.d.ts +22 -0
- package/dist/manager/worker-manager.d.ts.map +1 -1
- package/dist/services/PromptService.d.ts +28 -0
- package/dist/services/PromptService.d.ts.map +1 -0
- package/dist/services/PromptService.js +64 -0
- package/dist/services/PromptService.js.map +1 -0
- package/dist/services/RulesService.d.ts +16 -0
- package/dist/services/RulesService.d.ts.map +1 -0
- package/dist/services/RulesService.js +42 -0
- package/dist/services/RulesService.js.map +1 -0
- package/dist/services/SkillService.d.ts +39 -0
- package/dist/services/SkillService.d.ts.map +1 -1
- package/dist/services/SkillService.js +73 -42
- package/dist/services/SkillService.js.map +1 -1
- package/dist/services/container.d.ts +4 -0
- package/dist/services/container.d.ts.map +1 -1
- package/dist/services/container.js +4 -0
- package/dist/services/container.js.map +1 -1
- package/dist/shared/domainEvents.d.ts +25 -1
- package/dist/shared/domainEvents.d.ts.map +1 -1
- package/dist/shared/domainEvents.js.map +1 -1
- package/dist/shared/projectRepo.d.ts +3 -0
- package/dist/shared/projectRepo.d.ts.map +1 -0
- package/dist/shared/projectRepo.js +23 -0
- package/dist/shared/projectRepo.js.map +1 -0
- package/dist/shared/runtimePaths.d.ts +2 -0
- package/dist/shared/runtimePaths.d.ts.map +1 -1
- package/dist/shared/runtimePaths.js +4 -0
- package/dist/shared/runtimePaths.js.map +1 -1
- package/package.json +1 -1
- package/dist/console-assets/assets/index-BOpxRNe1.css +0 -10
- package/dist/console-assets/assets/index-l-4ti4ol.js +0 -605
- package/dist/engines/smartarrange/AcpWorkerExec.d.ts +0 -35
- package/dist/engines/smartarrange/AcpWorkerExec.d.ts.map +0 -1
- package/dist/engines/smartarrange/AcpWorkerExec.js +0 -71
- package/dist/engines/smartarrange/AcpWorkerExec.js.map +0 -1
- package/project-template/.claude/CLAUDE.md +0 -66
- package/project-template/.claude/hooks/start.sh +0 -44
- package/project-template/.claude/hooks/stop.sh +0 -54
- package/project-template/.claude/rules/.gitkeep +0 -0
- package/project-template/.claude/settings.json +0 -32
- package/project-template/.claude/settings.local.json.template +0 -3
- package/project-template/.claude/skills/.gitkeep +0 -0
- package/project-template/README.md +0 -10
- package/project-template/batch_scheduler.sh +0 -8
- package/project-template/conf.template +0 -61
- package/project-template/deploy.sh +0 -3
- 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
|
-
}
|
|
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,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=""
|
|
File without changes
|