API

GET  /api/state            Authorization: Bearer <HQ_TOKEN>
     → { version, updated, state }
PUT  /api/state  { version, state }
     → { version, updated }   or 409 with the current document

state = {
  tasks:     { id: {id, title, tree, area, status, source, notes,
                    updated, parent, order} },
  notes:     { id: {id, text, tree|null, created} },
  decisions: { id: {id, title, status, summary, options[],
                    decision, updated} },
  focus:     [taskId, taskId, taskId],
  areas:     { tree: [areaName, ...] },    // optional
  seq:       N                             // highest task number ever issued; never lower it
}

Outline. Tasks form a tree per project and area. parent is the id of another task or null/absent for a top-level item. A child always has the same tree and area as its parent; when a parent moves, move its descendants with it, and never create a cycle. order is an integer sort key among siblings (same parent, tree and area); items without one sort after ordered items, by id. Deleting a task re-parents its children to the deleted task's parent. area "" is the General bucket; areas[tree] holds the display order of a project's areas and may list areas with no tasks yet.

Status. next · doing · parked · done. inbox is legacy: read it as next, never write it. Trees: roadmap · platform · firestrike · vector-drift · stone-power · slime-raiser · nft · lore · physical · biz · hq. Ids are t-NNN, max+1, never reused. Storage is KV: read-after-write can lag a few seconds on a different edge, so send the version you read.

Repo

Local: C:\Users\Whitc\Documents\CProjects\ACT. Start at CLAUDE.md. Sync with node tools/hq-sync.mjs pull / push (token from HQ_TOKEN or ~/.act-hq-token). The sync round-trips whole task objects, so parent and order survive.

Rules (short)

• Shared systems are specified once, in platform/. Games depend on platform only.
• Disagreements become decision records, never silent picks.
• Engineering truth is cutty92/act-babylon docs. Read them before touching platform.