veritas-kanban/docs/cli-agent-pull.md
Brad Groux 64998b0757 feat: Multiple bug fixes and enhancements
- fix(REL-001): Add withFileLock to 5 unguarded services
- fix(REL-002): Replace plain objects with useRef in useFeatureSettings
- fix(REL-003): Only clear dirty state on mutation success in useDebouncedSave
- fix(REL-004): Fix ActivityFeed knownIdsRef stale reference
- fix(REL-005): Fix ArchiveSidebar useMemo used as useEffect
- fix(REL-006): Fix ConflictResolver render-time setState
- fix(REL-007): Fix useSortableList stale rollback + array mutation
- feat(A11Y-001): Add aria-labels to icon-only buttons
- feat(A11Y-002): Add keyboard support to clickable divs
- feat(#41): Lessons Learned Field - UI component + API endpoint

Co-authored-by: Veritas <veritas@digitalmeld.io>
2026-02-04 20:37:18 -06:00

81 lines
1.9 KiB
Markdown

# CLI Command: `vk agent pull`
**Status:** Design Spec (not yet implemented)
## Purpose
Fetch and format results from a sub-agent run into a concise summary for the main session.
## Usage
```bash
# Pull results by session key
vk agent pull agent:main:subagent:UUID
# Pull results by label
vk agent pull --label rel-001-filelocks
# Pull all pending results
vk agent pull --all
# Output as JSON
vk agent pull agent:main:subagent:UUID --json
```
## Output Format (Default)
```
✅ Sub-Agent Complete: rel-001-filelocks
Summary:
• Added withFileLock() to 5 services
• All typechecks pass
• No logic changes, only locking added
Artifacts:
• server/src/services/activity-service.ts (modified)
• server/src/services/status-history-service.ts (modified)
• server/src/services/notification-service.ts (modified)
• server/src/services/managed-list-service.ts (modified)
• server/src/services/chat-service.ts (modified)
Metrics:
Duration: 2m 34s
Tokens: ~15k
Cost: $0.03
Blockers: None
```
## Output Format (JSON)
```json
{
"id": "result_20260205_abc123",
"label": "rel-001-filelocks",
"status": "completed",
"summary": {
"bullets": ["Added withFileLock() to 5 services", "All typechecks pass"],
"artifacts": [{ "path": "server/src/services/activity-service.ts", "description": "modified" }],
"blockers": []
},
"metrics": {
"durationMs": 154000,
"tokensUsed": 15000,
"cost": 0.03
}
}
```
## Implementation Notes
1. **Data Source:** Read from OpenClaw's session transcript via `sessions_history`
2. **Parsing:** Extract structured summary from agent's final message
3. **Registry:** Update `.veritas-kanban/agent-results.json` with result
4. **Linking:** If `--task` flag provided, link result to VK task
## Related
- Spawn template: `~/clawd/templates/subagent-task.md`
- Result schema: `.veritas-kanban/agent-results.schema.json`
- VK task: `task_20260205_WNvH6j`