@matthugh1/conductor-cli 0.2.0 → 0.2.3
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/agent-spawner-BNOGEYDK.js +232 -0
- package/dist/agent.js +227 -89
- package/dist/{chunk-IHARLSA6.js → branch-overview-RRHX3XGY.js} +116 -10
- package/dist/chunk-6AA726KG.js +238 -0
- package/dist/{chunk-FAZ7FCZQ.js → chunk-N2KKNG4C.js} +15 -3
- package/dist/{chunk-MJKFQIYA.js → cli-config-LEERSU5N.js} +23 -25
- package/dist/daemon-ZJDZIP3R.js +607 -0
- package/dist/daemon-client-CTYOJMJP.js +435 -0
- package/dist/{git-hooks-UZJ6AER4.js → git-hooks-RQ6WJQS4.js} +1 -2
- package/dist/{git-wrapper-DVJ46TMA.js → git-wrapper-QRZYTYCZ.js} +1 -2
- package/dist/runner-prompt-MOOPKA5P.js +9 -0
- package/package.json +1 -1
- package/dist/branch-overview-XVHTGFCJ.js +0 -18
- package/dist/chunk-4YEHSYVN.js +0 -17
- package/dist/chunk-JZT526HU.js +0 -536
- package/dist/chunk-PANC6BTV.js +0 -151
- package/dist/chunk-VYINBHPQ.js +0 -22
- package/dist/cli-config-TDSTAXIA.js +0 -17
- package/dist/cli-tasks-NW3BONXC.js +0 -179
- package/dist/db-U6Y3QJDD.js +0 -16
- package/dist/git-snapshots-N3FBS7T3.js +0 -90
- package/dist/health-CTND2ANA.js +0 -147
- package/dist/health-snapshots-6MUVHE3G.js +0 -39
- package/dist/runner-prompt-2B6EXGN6.js +0 -139
- package/dist/work-queue-YE5P4S7R.js +0 -764
- package/dist/worktree-manager-QKRBTPVC.js +0 -30
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// ../../src/core/runner-prompt.ts
|
|
4
|
+
var AUTONOMOUS_WORKFLOW = `
|
|
5
|
+
## Identity
|
|
6
|
+
|
|
7
|
+
You are an autonomous implementation engineer spawned by Conductor's runner.
|
|
8
|
+
When you need human input, use conductor_log_decision followed by
|
|
9
|
+
conductor_await_decision \u2014 this blocks until the human responds in the
|
|
10
|
+
Conductor panel. Work carefully and methodically.
|
|
11
|
+
|
|
12
|
+
## Workflow (follow in order)
|
|
13
|
+
|
|
14
|
+
### 1. Start your session
|
|
15
|
+
|
|
16
|
+
Call conductor_session_brief with:
|
|
17
|
+
- projectRoot: the project name given in your assignment below
|
|
18
|
+
- deliverableId: the deliverable ID given in your assignment below
|
|
19
|
+
- agentRole: "implementation-engineer"
|
|
20
|
+
- agentType: "claude-code"
|
|
21
|
+
|
|
22
|
+
Save the returned sessionId \u2014 pass it to every subsequent Conductor call.
|
|
23
|
+
|
|
24
|
+
### 2. Read the brief and understand your assignment
|
|
25
|
+
|
|
26
|
+
The session brief contains your deliverable title, description, and
|
|
27
|
+
acceptance criteria. Read them carefully before writing any code.
|
|
28
|
+
|
|
29
|
+
### 3. Branch from dev
|
|
30
|
+
|
|
31
|
+
Run: git fetch origin && git checkout -b <branch-name> origin/dev
|
|
32
|
+
|
|
33
|
+
Name the branch after the deliverable (e.g., feat/prompt-template).
|
|
34
|
+
Branch from origin/dev (not main) so you pick up any prior autonomous
|
|
35
|
+
work that has been merged to dev but not yet reviewed into main.
|
|
36
|
+
Never use git checkout dev \u2014 use origin/dev directly to avoid worktree conflicts.
|
|
37
|
+
Never branch from another feature branch.
|
|
38
|
+
|
|
39
|
+
### 4. Mark your deliverable in-progress
|
|
40
|
+
|
|
41
|
+
Call conductor_update_deliverable with status "in_progress".
|
|
42
|
+
|
|
43
|
+
### 5. Do the work
|
|
44
|
+
|
|
45
|
+
Implement the deliverable according to its acceptance criteria.
|
|
46
|
+
After each meaningful chunk of work, call conductor_log_built with
|
|
47
|
+
a plain English summary and the sessionId.
|
|
48
|
+
|
|
49
|
+
### 6. Self-check before submitting
|
|
50
|
+
|
|
51
|
+
Before creating a PR, run ALL of these checks:
|
|
52
|
+
|
|
53
|
+
1. npx tsc --noEmit (type check)
|
|
54
|
+
2. npm run build (build)
|
|
55
|
+
3. npm test (tests)
|
|
56
|
+
4. git status (working tree clean?)
|
|
57
|
+
5. Review your own code for:
|
|
58
|
+
- No \`any\` type assertions
|
|
59
|
+
- No console.log in production code
|
|
60
|
+
- No large files (>200 lines of code)
|
|
61
|
+
- No large functions (>50 lines)
|
|
62
|
+
- No unused imports
|
|
63
|
+
- No secrets or .env files staged
|
|
64
|
+
|
|
65
|
+
### 7. Retry on failure (up to 3 attempts)
|
|
66
|
+
|
|
67
|
+
If any check fails:
|
|
68
|
+
- Read the error output carefully
|
|
69
|
+
- Fix the issue
|
|
70
|
+
- Re-run the failing check
|
|
71
|
+
- Repeat up to 3 total attempts per check
|
|
72
|
+
|
|
73
|
+
If a check still fails after 3 attempts, go to the parking procedure (step 10).
|
|
74
|
+
|
|
75
|
+
### 8. Create a PR and merge to dev
|
|
76
|
+
|
|
77
|
+
When all checks pass:
|
|
78
|
+
- git add the relevant files (never use git add -A)
|
|
79
|
+
- git commit with a descriptive message
|
|
80
|
+
- git push -u origin <branch-name>
|
|
81
|
+
- gh pr create --title "<deliverable title>" --body "<summary>"
|
|
82
|
+
- Save the PR URL \u2014 you need it for the completion report
|
|
83
|
+
|
|
84
|
+
After the PR is created, merge your branch to dev so the next agent
|
|
85
|
+
in the chain can build on your work without waiting for human review.
|
|
86
|
+
Use a temporary local branch to avoid worktree checkout conflicts:
|
|
87
|
+
|
|
88
|
+
git fetch origin
|
|
89
|
+
git checkout -b _dev-merge origin/dev
|
|
90
|
+
git merge --no-ff <your-branch-name> -m "chore: merge <branch-name> to dev"
|
|
91
|
+
git push origin HEAD:dev
|
|
92
|
+
git checkout <your-branch-name>
|
|
93
|
+
git branch -D _dev-merge
|
|
94
|
+
|
|
95
|
+
Never merge your own PR to main. Always merge to dev after creating the PR.
|
|
96
|
+
|
|
97
|
+
### 9. Submit for review
|
|
98
|
+
|
|
99
|
+
Call conductor_update_deliverable with:
|
|
100
|
+
- status: "review"
|
|
101
|
+
- completionReport with all check results and the prUrl
|
|
102
|
+
|
|
103
|
+
Then call conductor_end_session with the sessionId.
|
|
104
|
+
|
|
105
|
+
### 10. When you need a human decision
|
|
106
|
+
|
|
107
|
+
If you hit a judgment call, ambiguous requirement, or blocker that needs human input:
|
|
108
|
+
1. Call conductor_log_decision with the options and your reasoning.
|
|
109
|
+
This returns a decisionId.
|
|
110
|
+
2. Call conductor_await_decision with that decisionId.
|
|
111
|
+
This blocks until the human approves in the Conductor panel (polls every
|
|
112
|
+
3 seconds, up to 5 minutes per call).
|
|
113
|
+
3. If it returns "pending" (timeout), call conductor_await_decision again.
|
|
114
|
+
Keep calling until you get a resolution.
|
|
115
|
+
4. Once resolved, read the chosenOption and continue your work accordingly.
|
|
116
|
+
|
|
117
|
+
CRITICAL: You MUST call conductor_log_decision to create the decision.
|
|
118
|
+
Do not just say "I need a decision" in text \u2014 the human cannot see your
|
|
119
|
+
text output. The only way they know you need input is through the
|
|
120
|
+
Conductor decision panel.
|
|
121
|
+
|
|
122
|
+
### 11. Parking procedure (when truly stuck)
|
|
123
|
+
|
|
124
|
+
If you cannot complete the work and waiting for a decision won't help:
|
|
125
|
+
- Call conductor_update_deliverable with status "parked".
|
|
126
|
+
- Call conductor_log_next describing what remains and why you stopped.
|
|
127
|
+
- Call conductor_end_session with the sessionId.
|
|
128
|
+
- Exit cleanly.
|
|
129
|
+
|
|
130
|
+
## Rules
|
|
131
|
+
|
|
132
|
+
- Follow all rules in CLAUDE.md (included above if present).
|
|
133
|
+
- Never merge your own PR to main \u2014 only create it.
|
|
134
|
+
- Always merge your branch to dev after creating the PR (see step 8).
|
|
135
|
+
- Never make silent decisions \u2014 log every judgment call via conductor_log_decision.
|
|
136
|
+
- If a subsequent deliverable exists in the same outcome, create a handoff
|
|
137
|
+
prompt via conductor_create_prompt before submitting for review.
|
|
138
|
+
- Keep commits atomic and messages descriptive.
|
|
139
|
+
- Do not install new dependencies without logging a decision.
|
|
140
|
+
- Do not modify files outside the scope of your deliverable.
|
|
141
|
+
- If you encounter merge conflicts, resolve them yourself.
|
|
142
|
+
- Work within the existing code style and patterns.
|
|
143
|
+
`.trim();
|
|
144
|
+
var FREEFORM_TASK_WORKFLOW = `
|
|
145
|
+
## Identity
|
|
146
|
+
|
|
147
|
+
You are an agent spawned by Conductor's daemon to execute a task.
|
|
148
|
+
When you need human input, use conductor_log_decision followed by
|
|
149
|
+
conductor_await_decision \u2014 this blocks until the human responds in the
|
|
150
|
+
Conductor panel. Work carefully and methodically.
|
|
151
|
+
|
|
152
|
+
## Workflow
|
|
153
|
+
|
|
154
|
+
1. Read the task description below carefully.
|
|
155
|
+
2. Execute the task as described.
|
|
156
|
+
3. If you hit a judgment call or blocker, log a decision via conductor_log_decision
|
|
157
|
+
and wait via conductor_await_decision. Do not proceed without resolution.
|
|
158
|
+
4. When finished, report what you accomplished clearly.
|
|
159
|
+
|
|
160
|
+
## Rules
|
|
161
|
+
|
|
162
|
+
- Follow all rules in CLAUDE.md (included above if present).
|
|
163
|
+
- Never make silent decisions \u2014 log every judgment call.
|
|
164
|
+
- Work within the existing code style and patterns.
|
|
165
|
+
- Do not install new dependencies without logging a decision.
|
|
166
|
+
`.trim();
|
|
167
|
+
function assembleAutonomousPrompt(ctx) {
|
|
168
|
+
const parts = [];
|
|
169
|
+
if (ctx.claudeMd.length > 0) {
|
|
170
|
+
parts.push("# Project Rules (CLAUDE.md)\n\n" + ctx.claudeMd);
|
|
171
|
+
}
|
|
172
|
+
parts.push("# Autonomous Runner Instructions\n\n" + AUTONOMOUS_WORKFLOW);
|
|
173
|
+
parts.push(
|
|
174
|
+
`# Your Assignment
|
|
175
|
+
|
|
176
|
+
Project: ${ctx.projectName}
|
|
177
|
+
Deliverable: ${ctx.item.title}
|
|
178
|
+
Deliverable ID: ${ctx.item.entityId}
|
|
179
|
+
Initiative: ${ctx.item.initiativeTitle ?? "unknown"}
|
|
180
|
+
Priority: P${ctx.item.priority}
|
|
181
|
+
Action: ${ctx.item.action}
|
|
182
|
+
|
|
183
|
+
Start by calling conductor_session_brief with:
|
|
184
|
+
- projectRoot: "${ctx.projectName}"
|
|
185
|
+
- deliverableId: "${ctx.item.entityId}"
|
|
186
|
+
- agentRole: "implementation-engineer"
|
|
187
|
+
- agentType: "claude-code"`
|
|
188
|
+
);
|
|
189
|
+
return parts.join("\n\n---\n\n");
|
|
190
|
+
}
|
|
191
|
+
function assembleTaskPrompt(agent, task, claudeMd) {
|
|
192
|
+
const parts = [];
|
|
193
|
+
if (claudeMd.length > 0) {
|
|
194
|
+
parts.push("# Project Rules (CLAUDE.md)\n\n" + claudeMd);
|
|
195
|
+
}
|
|
196
|
+
if (agent.systemPrompt.length > 0) {
|
|
197
|
+
parts.push(
|
|
198
|
+
`# Agent: ${agent.name}
|
|
199
|
+
|
|
200
|
+
## System Prompt
|
|
201
|
+
|
|
202
|
+
` + agent.systemPrompt
|
|
203
|
+
);
|
|
204
|
+
}
|
|
205
|
+
if (task.deliverableId) {
|
|
206
|
+
parts.push("# Autonomous Runner Instructions\n\n" + AUTONOMOUS_WORKFLOW);
|
|
207
|
+
} else {
|
|
208
|
+
parts.push("# Task Instructions\n\n" + FREEFORM_TASK_WORKFLOW);
|
|
209
|
+
}
|
|
210
|
+
const assignmentLines = [
|
|
211
|
+
`# Your Assignment`,
|
|
212
|
+
``,
|
|
213
|
+
`Task: ${task.title}`,
|
|
214
|
+
`Project: ${task.projectName}`
|
|
215
|
+
];
|
|
216
|
+
if (task.deliverableId) {
|
|
217
|
+
assignmentLines.push(`Deliverable ID: ${task.deliverableId}`);
|
|
218
|
+
assignmentLines.push(``);
|
|
219
|
+
assignmentLines.push(`Start by calling conductor_session_brief with:`);
|
|
220
|
+
assignmentLines.push(`- projectRoot: "${task.projectName}"`);
|
|
221
|
+
assignmentLines.push(`- deliverableId: "${task.deliverableId}"`);
|
|
222
|
+
assignmentLines.push(`- agentRole: "implementation-engineer"`);
|
|
223
|
+
assignmentLines.push(`- agentType: "claude-code"`);
|
|
224
|
+
}
|
|
225
|
+
if (task.prompt.length > 0) {
|
|
226
|
+
assignmentLines.push(``);
|
|
227
|
+
assignmentLines.push(`## Task Details`);
|
|
228
|
+
assignmentLines.push(``);
|
|
229
|
+
assignmentLines.push(task.prompt);
|
|
230
|
+
}
|
|
231
|
+
parts.push(assignmentLines.join("\n"));
|
|
232
|
+
return parts.join("\n\n---\n\n");
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
export {
|
|
236
|
+
assembleAutonomousPrompt,
|
|
237
|
+
assembleTaskPrompt
|
|
238
|
+
};
|
|
@@ -1,12 +1,23 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import {
|
|
3
|
-
ConductorError
|
|
4
|
-
} from "./chunk-4YEHSYVN.js";
|
|
5
2
|
|
|
6
3
|
// ../../src/core/git-wrapper.ts
|
|
7
4
|
import { execFile } from "child_process";
|
|
8
5
|
import { randomBytes } from "crypto";
|
|
9
6
|
import { promisify } from "util";
|
|
7
|
+
|
|
8
|
+
// ../../src/core/errors.ts
|
|
9
|
+
var ConductorError = class extends Error {
|
|
10
|
+
code;
|
|
11
|
+
retryable;
|
|
12
|
+
constructor(code, message, retryable = false) {
|
|
13
|
+
super(message);
|
|
14
|
+
this.name = "ConductorError";
|
|
15
|
+
this.code = code;
|
|
16
|
+
this.retryable = retryable;
|
|
17
|
+
}
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
// ../../src/core/git-wrapper.ts
|
|
10
21
|
var execFileAsync = promisify(execFile);
|
|
11
22
|
var MAX_BUFFER = 10 * 1024 * 1024;
|
|
12
23
|
var READ_TIMEOUT_MS = 3e4;
|
|
@@ -520,6 +531,7 @@ async function executeNarrated(projectRoot, gitArgs) {
|
|
|
520
531
|
}
|
|
521
532
|
|
|
522
533
|
export {
|
|
534
|
+
ConductorError,
|
|
523
535
|
runGit,
|
|
524
536
|
getGitBranchInfo,
|
|
525
537
|
formatGitBranchLine,
|
|
@@ -4,18 +4,16 @@
|
|
|
4
4
|
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
|
|
5
5
|
import { dirname, join } from "path";
|
|
6
6
|
import { fileURLToPath } from "url";
|
|
7
|
-
import { homedir } from "os";
|
|
8
7
|
var __filename = fileURLToPath(import.meta.url);
|
|
9
8
|
var __dirname = dirname(__filename);
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
if (!existsSync(CONFIG_FILE)) {
|
|
9
|
+
function readConfig(projectRoot) {
|
|
10
|
+
const root = projectRoot ?? process.cwd();
|
|
11
|
+
const configFile = join(root, ".conductor", "config.json");
|
|
12
|
+
if (!existsSync(configFile)) {
|
|
15
13
|
return {};
|
|
16
14
|
}
|
|
17
15
|
try {
|
|
18
|
-
const raw = readFileSync(
|
|
16
|
+
const raw = readFileSync(configFile, "utf8");
|
|
19
17
|
const parsed = JSON.parse(raw);
|
|
20
18
|
if (parsed !== null && typeof parsed === "object") {
|
|
21
19
|
return parsed;
|
|
@@ -25,22 +23,21 @@ function readConfig() {
|
|
|
25
23
|
return {};
|
|
26
24
|
}
|
|
27
25
|
}
|
|
28
|
-
function writeConfig(config) {
|
|
29
|
-
|
|
30
|
-
|
|
26
|
+
function writeConfig(config, projectRoot) {
|
|
27
|
+
const root = projectRoot ?? process.cwd();
|
|
28
|
+
const dir = join(root, ".conductor");
|
|
29
|
+
mkdirSync(dir, { recursive: true });
|
|
30
|
+
writeFileSync(join(dir, "config.json"), JSON.stringify(config, null, 2) + "\n", {
|
|
31
31
|
mode: 384
|
|
32
32
|
});
|
|
33
33
|
}
|
|
34
|
-
function readApiKey() {
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
} catch {
|
|
42
|
-
return void 0;
|
|
43
|
-
}
|
|
34
|
+
function readApiKey(projectRoot) {
|
|
35
|
+
const config = readConfig(projectRoot);
|
|
36
|
+
return config.apiKey;
|
|
37
|
+
}
|
|
38
|
+
function readProjectId(projectRoot) {
|
|
39
|
+
const config = readConfig(projectRoot);
|
|
40
|
+
return config.projectId;
|
|
44
41
|
}
|
|
45
42
|
function getConfigEndpoint() {
|
|
46
43
|
const candidates = [
|
|
@@ -126,12 +123,13 @@ async function ensureDatabaseUrl() {
|
|
|
126
123
|
}
|
|
127
124
|
return false;
|
|
128
125
|
}
|
|
129
|
-
|
|
130
126
|
export {
|
|
131
|
-
|
|
132
|
-
writeConfig,
|
|
133
|
-
getServerBaseUrl,
|
|
127
|
+
ensureDatabaseUrl,
|
|
134
128
|
fetchConfigFromServer,
|
|
129
|
+
getServerBaseUrl,
|
|
135
130
|
postToServer,
|
|
136
|
-
|
|
131
|
+
readApiKey,
|
|
132
|
+
readConfig,
|
|
133
|
+
readProjectId,
|
|
134
|
+
writeConfig
|
|
137
135
|
};
|