agent-control-plane 0.1.13 → 0.1.16
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/README.md +250 -355
- package/SKILL.md +1 -1
- package/hooks/heartbeat-hooks.sh +16 -9
- package/npm/bin/agent-control-plane.js +117 -8
- package/package.json +3 -1
- package/references/commands.md +2 -2
- package/references/control-plane-map.md +1 -1
- package/tools/bin/agent-project-reconcile-issue-session +23 -0
- package/tools/bin/agent-project-reconcile-pr-session +191 -22
- package/tools/bin/agent-project-run-codex-resilient +57 -2
- package/tools/bin/agent-project-run-openclaw-session +46 -0
- package/tools/bin/agent-project-worker-status +37 -0
- package/tools/bin/flow-config-lib.sh +7 -0
- package/tools/bin/flow-shell-lib.sh +2 -0
- package/tools/bin/heartbeat-safe-auto.sh +20 -10
- package/tools/bin/project-runtimectl.sh +1 -1
- package/tools/bin/provider-cooldown-state.sh +39 -1
- package/tools/bin/start-issue-worker.sh +35 -0
- package/tools/bin/start-pr-fix-worker.sh +3 -0
- package/tools/bin/start-pr-review-worker.sh +3 -0
- package/tools/bin/start-resident-issue-loop.sh +1 -0
- package/tools/dashboard/app.js +136 -0
- package/tools/dashboard/dashboard_snapshot.py +253 -3
- package/tools/dashboard/index.html +5 -1
- package/tools/dashboard/styles.css +97 -20
- package/tools/templates/pr-fix-template.md +6 -6
- package/tools/templates/pr-merge-repair-template.md +6 -6
- package/tools/vendor/codex-quota-manager/scripts/auto-switch.sh +8 -6
- package/tools/bin/render-dashboard-snapshot.py +0 -16
- package/tools/templates/legacy/issue-prompt-template-pre-slim.md +0 -109
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
# Task
|
|
2
|
-
|
|
3
|
-
Implement issue #{ISSUE_ID} in `{REPO_SLUG}`.
|
|
4
|
-
|
|
5
|
-
# Issue Context
|
|
6
|
-
|
|
7
|
-
- Title: {ISSUE_TITLE}
|
|
8
|
-
- URL: {ISSUE_URL}
|
|
9
|
-
- Auto-merge requested: {ISSUE_AUTOMERGE}
|
|
10
|
-
|
|
11
|
-
{ISSUE_BODY}
|
|
12
|
-
{ISSUE_RECURRING_CONTEXT}
|
|
13
|
-
{ISSUE_BLOCKER_CONTEXT}
|
|
14
|
-
|
|
15
|
-
# MANDATORY WORKFLOW (follow in order, no skipping)
|
|
16
|
-
|
|
17
|
-
You MUST complete ALL 5 phases in order. Do not skip any phase. Do not commit until Phase 4 passes.
|
|
18
|
-
|
|
19
|
-
## Phase 1: READ & SCOPE
|
|
20
|
-
|
|
21
|
-
- Read the repo instructions: `AGENTS.md`, relevant spec or design docs, and any repo conventions tied to this issue.
|
|
22
|
-
- Identify the single primary product surface you will touch.
|
|
23
|
-
- If the issue spans multiple surfaces, pick ONE and create follow-up issues for the rest using:
|
|
24
|
-
```bash
|
|
25
|
-
bash "$ACP_FLOW_TOOLS_DIR/create-follow-up-issue.sh" --parent {ISSUE_ID} --title "..." --body-file /tmp/follow-up.md
|
|
26
|
-
```
|
|
27
|
-
- Treat a broad umbrella issue as a coordination brief rather than permission to ship every slice in one PR.
|
|
28
|
-
- Write down your scope decision before coding.
|
|
29
|
-
|
|
30
|
-
## Phase 2: IMPLEMENT
|
|
31
|
-
|
|
32
|
-
- Make the smallest root-cause fix that satisfies the issue.
|
|
33
|
-
- Work only inside the dedicated worktree.
|
|
34
|
-
- Add or update tests when feasible.
|
|
35
|
-
- STOP after implementation. Do not commit yet.
|
|
36
|
-
|
|
37
|
-
## Phase 3: VERIFY (MANDATORY)
|
|
38
|
-
|
|
39
|
-
After implementing, you MUST run verification commands and record each one.
|
|
40
|
-
Every successful command must be recorded or the host publish will fail.
|
|
41
|
-
After each successful verification command, record it with `record-verification.sh`.
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
{ISSUE_VERIFICATION_COMMAND_SNIPPET}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
Required verification coverage:
|
|
48
|
-
- Run the narrowest repo-supported `typecheck`, `build`, `test`, or `lint` command that proves the touched surface is safe.
|
|
49
|
-
- If you changed tests only, run the most relevant targeted test command and record it.
|
|
50
|
-
- If you changed localization resources or user-facing copy, run repo locale validation or hardcoded-copy scans if the repo provides them.
|
|
51
|
-
- If a verification command fails, fix the issue and rerun until it passes.
|
|
52
|
-
|
|
53
|
-
CRITICAL: `verification.jsonl` must exist in `$ACP_RUN_DIR` with at least one `pass` entry before you can write `OUTCOME=implemented`.
|
|
54
|
-
|
|
55
|
-
## Phase 4: SELF-REVIEW (MANDATORY)
|
|
56
|
-
|
|
57
|
-
Before committing, perform this checklist:
|
|
58
|
-
|
|
59
|
-
- [ ] Run `git diff --check`.
|
|
60
|
-
- [ ] Count non-test product files: if the change is broad, stop and split scope instead of publishing one large PR.
|
|
61
|
-
- [ ] If you touched auth, login, session, or reset flows, verify existing users and legacy data still behave correctly.
|
|
62
|
-
- [ ] If you touched public endpoints, public routes, or operator workflows, search downstream consumers in `scripts/`, `docs/`, and specs.
|
|
63
|
-
- [ ] If you changed localization resources or user-facing copy, confirm localization coverage and scanning are still valid.
|
|
64
|
-
- [ ] If you touched mobile routes or screens, keep route scope narrow and verify loading, empty, and error states.
|
|
65
|
-
|
|
66
|
-
Before committing, verify the journal exists:
|
|
67
|
-
```bash
|
|
68
|
-
test -s "$ACP_RUN_DIR/verification.jsonl" && echo "OK: verification.jsonl exists" || echo "BLOCKED: missing verification.jsonl"
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
## Phase 5: COMMIT & REPORT
|
|
72
|
-
|
|
73
|
-
- Commit with a conventional commit message.
|
|
74
|
-
- Do NOT push or open a PR; the host handles that.
|
|
75
|
-
- Write `$ACP_RESULT_FILE`:
|
|
76
|
-
```bash
|
|
77
|
-
cat > "$ACP_RESULT_FILE" <<'OUTER_EOF'
|
|
78
|
-
OUTCOME=implemented
|
|
79
|
-
ACTION=host-publish-issue-pr
|
|
80
|
-
ISSUE_ID={ISSUE_ID}
|
|
81
|
-
OUTER_EOF
|
|
82
|
-
```
|
|
83
|
-
- In your final output, include the changed files, verification commands actually run, and one short self-review note naming the main regression risk you checked.
|
|
84
|
-
|
|
85
|
-
# STOP CONDITIONS
|
|
86
|
-
|
|
87
|
-
Stop and report blocked if:
|
|
88
|
-
- The issue is ambiguous, blocked by missing credentials, or expands into high-risk scope.
|
|
89
|
-
- You cannot complete verification successfully.
|
|
90
|
-
- The issue needs full decomposition into focused follow-up issues.
|
|
91
|
-
|
|
92
|
-
If stopped blocked, write `$ACP_RUN_DIR/issue-comment.md` with a blocker summary, then:
|
|
93
|
-
```bash
|
|
94
|
-
cat > "$ACP_RESULT_FILE" <<'OUTER_EOF'
|
|
95
|
-
OUTCOME=blocked
|
|
96
|
-
ACTION=host-comment-blocker
|
|
97
|
-
ISSUE_ID={ISSUE_ID}
|
|
98
|
-
OUTER_EOF
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
If fully decomposed into follow-up issues, start the first line of `issue-comment.md` with exactly:
|
|
102
|
-
`Superseded by focused follow-up issues: #...`
|
|
103
|
-
|
|
104
|
-
# Git Rules
|
|
105
|
-
|
|
106
|
-
- Do NOT push the branch from inside the worker.
|
|
107
|
-
- Do NOT open a PR from inside the worker.
|
|
108
|
-
- Do NOT comment on the source issue with a PR URL from inside the worker.
|
|
109
|
-
- Exit successfully after writing the result file.
|