Glossary: Task Artifacts
Mirrored from
docs/design/task-artifacts/references/glossary.md. Edit the source document in the repository, not this generated page.
This glossary covers Orbit-specific task artifact terms. Generic issue-tracker or version-control vocabulary is excluded unless Orbit gives the term a narrower meaning.
| Term | Meaning |
|---|---|
| Acceptance document | acceptance.md, the Markdown source of truth for validation expectations. See 2_design.md §2.3. |
| Artifact manifest | artifacts/manifest.yaml, the structured index of files stored under a task’s artifacts/ directory. See 2_design.md §2.5. |
| Authority-scoped task ID | The canonical ORB-00000 identity allocated by one configured authority. Bare IDs are not guaranteed unique across unrelated authorities. See 2_design.md §3. |
| Bundle | The directory and files that together represent one task. See 1_overview.md §2.1. |
| Envelope | task.yaml, the small structured metadata file in a task bundle. See 1_overview.md §2.2. |
| Canonical task bundle | The active local task copy under ~/.orbit/tasks/workspaces/<workspace-id>/<task-id>/. See 2_design.md §2.1. |
| Local task registry | ~/.orbit/tasks/index.sqlite, the mandatory local allocator, workspace-binding registry, and generated-index store. See 2_design.md §2.6. |
| Prose sidecar | A Markdown file that stores long-form task content outside task.yaml. See 1_overview.md §2.3. |
| Projection link | A symlink under .orbit/tasks/<task-id> that points to the canonical task bundle in ~/.orbit/tasks/workspaces/<workspace-id>/. See 4_decisions.md ADR-007. |
| Status-neutral directory | The v2 layout where .orbit/tasks/<task-id>/ does not encode lifecycle state in the path. See 4_decisions.md ADR-003. |
| Task event stream | Append-only lifecycle and metadata rows stored in events.jsonl. See 1_overview.md §2.5. |
| Typed relation | A structured task-to-task link with an explicit relation type such as blocked_by or supersedes. See 1_overview.md §2.6. |
| Workspace ID | A stable <slug>-<6char> identifier stored in .orbit/config.yaml and used to bind a checkout to canonical bundles under ~/.orbit/tasks/workspaces/. See 2_design.md §2.6. |