KB-5344

S145-M4 DOT Task Tools Report

3 min read Revision 1
reports145dot-toolstask-createtask-updatetask-listtask-close

S145-M4: 4 DOT Task Tools — Report

Date: 2026-03-29 | OR: v7.2 | §0-AZ: Điều hành tay, CRUD bằng DOT


Step 0: Checkpoint

  • OR v7.2 confirmed. AP-09 (DOT 100%), AP-11 (no Nuxt) read.
  • Assembly Gate: 6/6 ✅.

Targets: 6/6

# Target Status
1 dot-task-create DONE ✅ — DOT-148
2 dot-task-update DONE ✅ — DOT-149
3 dot-task-list DONE ✅ — DOT-150
4 dot-task-close DONE ✅ — DOT-151
5 4 DOT registered, scanner 0 orphans DONE ✅
6 0 Nuxt files changed DONE ✅

Tools Created

DOT-148: dot-task-create v1.0.0

  • Usage: dot-task-create --cloud --name="Task" [--priority=normal] [--assigned=CLI] [--type=task] [--description="..."]
  • Behavior: POST /items/tasks → PG birth trigger → TSK-NNN auto-generated + birth_registry

DOT-149: dot-task-update v1.0.0

  • Usage: dot-task-update --cloud --code=TSK-NNN --field=content_prompt --value="..."
  • Shorthand: dot-task-update --cloud --code=TSK-NNN --status=active
  • Allowed fields: status, priority, assigned_to, description, content_targets/rules/checklist/plan/prompt/reports/verify/test

DOT-150: dot-task-list v1.0.1

  • Usage: dot-task-list --cloud [--status=active] [--priority=high] [--limit=20]
  • Output: table format (code | name | status | priority | assigned)

DOT-151: dot-task-close v1.0.0

  • Usage: dot-task-close --cloud --code=TSK-NNN [--note="Done reason"]
  • Behavior: PATCH status=done. --note appends to content_verify.

E2E Test Results

1. CREATE: TSK-010 created ✅ (birth_registry: species=task, governed)
2. LIST draft: 2 tasks shown ✅
3. UPDATE status→active + content_prompt: ✅
4. LIST active: 8 tasks shown, TSK-010 present ✅
5. CLOSE: status=done, verify=[CLOSED] note ✅
6. PG verify: prompt + verify fields populated ✅
7. Cleanup: DELETE ✅

Bug Fix: curl --globoff

  • Issue: curl interprets [] in filter URLs as glob patterns → exit code 3
  • Fix: Added --globoff to all curl calls in dot-task-list, dot-task-update, dot-task-close

Verify

  • 4 DOT scripts executable: CÓ ✅
  • dot-task-create → TSK-NNN + birth: PASS ✅
  • dot-task-update → field changed: PASS ✅
  • dot-task-list → shows tasks: PASS ✅
  • dot-task-close → status=done: PASS ✅
  • Scanner: 0 orphans ✅
  • Nuxt: 0 files changed ✅

§0-AW AUTOMATION CHECK

  1. 4 DOT tools on-demand: CÓ ✅
  2. Dual-trigger: DOT = on-demand. Birth = event. Scanner = cron + ODM. CÓ ✅
  3. End-to-end: DOT → Directus API → PG (birth trigger) → Nuxt tự hiện. CÓ ✅

Quy trình giao việc hoàn chỉnh

dot-task-create --name="Mission X" --priority=high
dot-task-update --code=TSK-NNN --field=content_prompt --value="..."
→ Copy prompt → giao CLI
→ CLI xong: dot-task-update --code=TSK-NNN --field=content_reports --value="..."
→ Review: dot-task-update --code=TSK-NNN --field=content_verify --value="..."
dot-task-close --code=TSK-NNN --note="Done"

S145-M4 DONE | 4 DOT tools | E2E PASS | 0 Nuxt | Scanner CLEAN