docs: update stale comments and prompts referencing old storage formats
CI / check (pull_request) Failing after 10m12s

- architecture-reference.ts: threads.yaml/history.jsonl/registry.yaml → variable store, storage layout updated (~/.ocas/ + ~/.uwf/)
- protocol types.ts: JSDoc comments updated
- thread-index.ts: serialization comment updated
- util-agent context.ts: buildContext JSDoc updated

Only migration code in store.ts retains old file references (needed to read legacy files).
This commit is contained in:
2026-06-02 23:59:07 +08:00
parent dea6ed629e
commit e2098e7371
4 changed files with 12 additions and 10 deletions
+8 -6
View File
@@ -15,7 +15,7 @@ Stored artifacts include:
### Thread
A Thread is a single execution of a Workflow, identified by a ULID (26-char Crockford Base32: 10 timestamp + 16 random). Thread state is an immutable CAS chain — each step points to its predecessor via a \`prev\` hash, forming a linked list.
Active threads are indexed in \`threads.yaml\`; completed threads move to \`history.jsonl\`.
Active threads are indexed as \`@uwf/thread/*\` variables; completed threads move to \`@uwf/history/*\` variables in the ocas variable store.
A thread progresses by running \`uwf thread exec\`, which performs one moderator→agent→extract cycle per step.
@@ -51,10 +51,12 @@ uwf thread exec <thread-id>
## Storage Layout
All data lives under \`~/.uwf/\`:
- \`cas/\` — content-addressed store (XXH64-keyed)
- \`threads.yaml\`active thread index
- \`history.jsonl\` — completed thread archive
- \`registry.yaml\` — workflow name → CAS hash mapping
CAS data lives under \`~/.ocas/\`:
- \`objects/\` — content-addressed store (XXH64-keyed)
- \`variables.db\`variable store (\`@uwf/registry/*\`, \`@uwf/thread/*\`, \`@uwf/history/*\`)
Config lives under \`~/.uwf/\`:
- \`config.yaml\` — provider, model, agent settings
- \`.env\` — API keys
`;
}