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

1.9 KiB

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

# 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)

{
  "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
  • Spawn template: ~/clawd/templates/subagent-task.md
  • Result schema: .veritas-kanban/agent-results.schema.json
  • VK task: task_20260205_WNvH6j