@e0ipso/ai-task-manager 1.29.0 → 1.30.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.
package/dist/exec.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA+FxC;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAuH1E"}
|
package/dist/exec.js
CHANGED
package/dist/exec.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -49,22 +49,22 @@ if [ -z "$root" ]; then
|
|
|
49
49
|
fi
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
Use your internal Todo task tool to track the execution of all parts of the task
|
|
52
|
+
Use your internal Todo task tool to track the execution of all parts of the task. Example:
|
|
53
53
|
|
|
54
|
-
- [ ] Validate task: file, status, and dependencies.
|
|
55
|
-
- [ ] Select the most appropriate sub-agent.
|
|
54
|
+
- [ ] Validate task: file, status (including needs-clarification), and dependencies.
|
|
56
55
|
- [ ] Set task status to in-progress.
|
|
57
|
-
- [ ]
|
|
56
|
+
- [ ] Execute the task.
|
|
58
57
|
- [ ] Update task status to completed or failed.
|
|
59
|
-
- [ ]
|
|
58
|
+
- [ ] Document noteworthy events (if any).
|
|
59
|
+
- [ ] Emit structured output for orchestrator.
|
|
60
60
|
|
|
61
61
|
## Critical Rules
|
|
62
62
|
|
|
63
63
|
1. **Never skip dependency validation** - Task execution requires all dependencies to be completed
|
|
64
|
-
2. **Validate task status** - Never execute tasks that are already completed or
|
|
64
|
+
2. **Validate task status** - Never execute tasks that are already completed, in-progress, or needs-clarification
|
|
65
65
|
3. **Maintain status integrity** - Update task status throughout the execution lifecycle
|
|
66
|
-
4. **
|
|
67
|
-
5. **
|
|
66
|
+
4. **Document execution** - Record all outcomes and issues encountered
|
|
67
|
+
5. **Provide structured output** - Always emit the structured result block for orchestrator parsing
|
|
68
68
|
|
|
69
69
|
## Input Requirements
|
|
70
70
|
- Plan ID: $1 (required)
|
|
@@ -162,6 +162,11 @@ case "$current_status" in
|
|
|
162
162
|
echo "Wait for current execution to complete or check for stale processes"
|
|
163
163
|
exit 1
|
|
164
164
|
;;
|
|
165
|
+
"needs-clarification")
|
|
166
|
+
echo "Error: Task ${task_id} is marked as 'needs-clarification'"
|
|
167
|
+
echo "Resolve clarification questions in the task file before execution"
|
|
168
|
+
exit 1
|
|
169
|
+
;;
|
|
165
170
|
"pending"|"failed"|"")
|
|
166
171
|
echo "Task status allows execution - proceeding..."
|
|
167
172
|
;;
|
|
@@ -171,6 +176,17 @@ case "$current_status" in
|
|
|
171
176
|
esac
|
|
172
177
|
```
|
|
173
178
|
|
|
179
|
+
#### Valid Status Transitions
|
|
180
|
+
|
|
181
|
+
Reference for orchestrators and execution flow:
|
|
182
|
+
|
|
183
|
+
- `pending` → `in-progress` (execution starts)
|
|
184
|
+
- `in-progress` → `completed` (successful execution)
|
|
185
|
+
- `in-progress` → `failed` (execution error)
|
|
186
|
+
- `failed` → `in-progress` (retry attempt)
|
|
187
|
+
- `pending` → `needs-clarification` (set externally by orchestrator or reviewer)
|
|
188
|
+
- `needs-clarification` → `pending` (clarification resolved, set externally)
|
|
189
|
+
|
|
174
190
|
### 4. Dependency Validation
|
|
175
191
|
|
|
176
192
|
Use the dependency checking script to validate all dependencies:
|
|
@@ -268,15 +284,44 @@ awk '
|
|
|
268
284
|
|
|
269
285
|
mv "$temp_file" "$task_file"
|
|
270
286
|
|
|
271
|
-
echo "✓ Task ${task_id} completed
|
|
272
|
-
|
|
273
|
-
|
|
287
|
+
echo "✓ Task ${task_id} status updated to completed"
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
### 9. Noteworthy Events Documentation
|
|
291
|
+
|
|
292
|
+
After task execution (whether successful or failed), append a "Noteworthy Events" section to the task file body if anything noteworthy occurred during execution.
|
|
293
|
+
|
|
294
|
+
Append to the end of the task file:
|
|
295
|
+
|
|
296
|
+
```markdown
|
|
297
|
+
## Noteworthy Events
|
|
298
|
+
- [YYYY-MM-DD] [Event description with sufficient context for the orchestrator]
|
|
274
299
|
```
|
|
275
300
|
|
|
301
|
+
If no noteworthy events occurred, do not add the section.
|
|
302
|
+
|
|
276
303
|
## Error Handling
|
|
277
304
|
|
|
278
305
|
Read and execute $root/.ai/task-manager/config/hooks/POST_ERROR_DETECTION.md
|
|
279
306
|
|
|
307
|
+
On any error, ensure you still emit the structured output block (see Output Requirements) with `Exit Code: 1`.
|
|
308
|
+
|
|
309
|
+
## Output Requirements
|
|
310
|
+
|
|
311
|
+
**CRITICAL - Structured Output for Orchestrator Coordination:**
|
|
312
|
+
|
|
313
|
+
Always end your output with a standardized summary in this exact format:
|
|
314
|
+
|
|
315
|
+
```
|
|
316
|
+
---
|
|
317
|
+
Task Execution Result:
|
|
318
|
+
- Plan ID: [plan-id]
|
|
319
|
+
- Task ID: [task-id]
|
|
320
|
+
- Exit Code: [0 for success, 1 for failure]
|
|
321
|
+
```
|
|
322
|
+
|
|
323
|
+
This structured output enables automated orchestration pipelines to parse results and determine next steps. It MUST be included regardless of success or failure.
|
|
324
|
+
|
|
280
325
|
## Usage Examples
|
|
281
326
|
|
|
282
327
|
```bash
|
|
@@ -292,11 +337,12 @@ Read and execute $root/.ai/task-manager/config/hooks/POST_ERROR_DETECTION.md
|
|
|
292
337
|
|
|
293
338
|
## Integration Notes
|
|
294
339
|
|
|
295
|
-
This command integrates with the
|
|
340
|
+
This command is designed for scripting contexts where an external orchestrator manages task sequencing, commits, feature branches, linting, test execution, and plan archival. It integrates with the task management system by:
|
|
296
341
|
- Using established plan and task location patterns
|
|
297
342
|
- Leveraging the dependency checking script for validation
|
|
298
|
-
- Following status management conventions
|
|
343
|
+
- Following status management conventions (see Valid Status Transitions)
|
|
344
|
+
- Providing structured machine-parseable output for orchestrator pipelines
|
|
299
345
|
- Maintaining compatibility with execute-blueprint workflows
|
|
300
346
|
- Preserving task isolation and dependency order
|
|
301
347
|
|
|
302
|
-
The command complements execute-blueprint by providing granular task control while maintaining the same validation
|
|
348
|
+
The command complements execute-blueprint by providing granular single-task control while maintaining the same validation standards.
|