AGENTS.md

1# src/features/claude-tasks/ — Task Schema + Storage
2 
3**Generated:** 2026-05-15
4 
5## OVERVIEW
6 
73 non-test files. File-based task persistence with atomic writes, locking, and OpenCode todo API sync.
8 
9## TASK SCHEMA
10 
11```typescript
12interface Task {
13  id: string              // T-{uuid} auto-generated
14  subject: string         // Short title
15  description?: string    // Detailed description
16  status: "pending" | "in_progress" | "completed" | "deleted"
17  activeForm?: string     // Current form/template
18  blocks?: string[]       // Tasks this blocks
19  blockedBy?: string[]    // Tasks blocking this
20  owner?: string          // Agent/session
21  metadata?: Record<string, unknown>
22  repoURL?: string        // Associated repository
23  parentID?: string       // Parent task ID
24  threadID?: string       // Session ID (auto-recorded)
25}
26```
27 
28## FILES
29 
30| File | Purpose |
31|------|---------|
32| `types.ts` | Task interface + status types |
33| `storage.ts` | `readJsonSafe()`, `writeJsonAtomic()`, `acquireLock()`, `generateTaskId()` |
34| `index.ts` | Barrel exports |
35 
36## STORAGE
37 
38- Location: `.omo/tasks/` directory
39- Format: JSON files, one per task
40- Atomic writes: temp file → rename
41- Locking: file-based lock for concurrent access
42- Sync: Changes pushed to OpenCode Todo API after each update
43