d8383a788e
- Switch conversation agent to xiaomi/mimo-v2.5 (multimodal: text + image) - Render native reasoning parts as live 'Thinking trace' (streaming open, collapsed after completion); inline <think> extraction for streaming models - Image attachments: picker (up to 4, 10MB each), base64 to Flue AgentPromptImage, authenticated blob-URL replay for historical images - Mobile keyboard viewport fix: visual-viewport hook, fixed shell, interactive-widget=resizes-content, header pinned, composer follows keyboard - Conversation to Signal to proposed Work: Convex persistence, Effect validation in @code/work-os, Work cards with exact source provenance - Streamdown markdown + Mermaid chart rendering in chat messages - Flue tool turns hidden, reasoning-containing turns remain visible - Frontend regression tests: keyboard viewport, responsive shell, attachment overflow, authenticated images, reasoning traces, transforms - .env.example updated to xiaomi/mimo-v2.5 config
45 lines
3.7 KiB
Markdown
45 lines
3.7 KiB
Markdown
# Zopu Work OS — Canonical Glossary
|
|
|
|
> **Purpose:** prevent agents and humans from using overlapping terms inconsistently.
|
|
|
|
| Term | Definition | Not the same as |
|
|
|---|---|---|
|
|
| Project | Durable product/repository/context boundary. | Work or chat thread |
|
|
| Message | Exact conversational input/output. | Signal |
|
|
| Signal | Provenanced evidence that may require attention. | Work |
|
|
| Work | Durable desired outcome linking all evidence and lifecycle. | Issue, task, session, PR |
|
|
| Work Definition | Versioned product-level contract: problem, outcome, criteria, scope, risk. | Implementation plan |
|
|
| Impact Map | Systems/contracts/data/operations potentially affected. | File list only |
|
|
| Architecture | Component interaction, ownership, contracts, trust/data flow. | Program design |
|
|
| Design Packet | Versioned implementation intent: file/call-flow deltas, types, invariants, slices. | Generated code |
|
|
| Vertical Slice | Bounded increment exposing observable behavior across necessary layers. | Horizontal backend/frontend phase |
|
|
| Step | Executable graph node; a slice may contain implementation/verify/publish steps. | Work |
|
|
| Kit | Versioned executable policy/configuration for resolving Work. | Agent or runtime |
|
|
| Kit Builder | Compiler selecting/composing a Kit from approved intent and policy. | Unbounded prompt generator |
|
|
| Resolver | Durable engine deciding what must happen next until terminal outcome. | Coding harness |
|
|
| Run | Coordination record for resolving a Work/step using one Kit version. | Attempt |
|
|
| Attempt | One bounded execution in one runtime/harness context. | Whole Work |
|
|
| Actor | Rivet durable identity owning serialized state/lifecycle. | Agent/model |
|
|
| Agent | Program/model-directed reasoning role producing proposals or actions. | Actor |
|
|
| Harness | Coding/tool-loop implementation such as OMP/OpenCode/Codex/Pi. | Sandbox |
|
|
| Runtime | Capability provider executing processes/files/network. | Harness |
|
|
| Sandbox | Isolated runtime instance for untrusted/project execution. | Worktree |
|
|
| Orb | Product-level execution envelope: runtime, workspace, harness, context, credentials, artifacts. | Agent |
|
|
| Worktree | Git checkout isolated for a candidate branch/Work. | Sandbox |
|
|
| Candidate | Unverified implementation revision/output. | Verified result |
|
|
| Verification Plan | Predeclared checks and evidence required for completion. | Test command only |
|
|
| Verification Result | Evidence-bound verdict for an exact revision/environment. | Agent statement |
|
|
| Artifact | Durable output/reference: diff, report, screenshot, commit, PR, preview. | Evidence automatically |
|
|
| Evidence | Artifact/data supporting a specific claim/check. | Summary prose |
|
|
| Question | Structured human input request blocking or affecting Work. | Chat thread |
|
|
| Decision | Durable answer/approval bound to exact Work/design/version. | Informal message |
|
|
| Review Package | Human-oriented narrative of intent, design, changes, evidence, risks. | Raw Git diff |
|
|
| Integration | Composition and verification of multiple slice/candidate changes. | Merge without checks |
|
|
| Delivery | Publication/release artifacts and transitions. | Outcome |
|
|
| Result | Actual effect compared with desired outcome. | PR merged |
|
|
| Learning | Post-work observation proposing future knowledge/process improvement. | Automatic memory mutation |
|
|
| Knowledge | Reviewed durable project/product facts, decisions, and conventions. | Harness session memory |
|
|
| Policy | Deterministic constraints for risk, tools, permissions, gates, budgets. | Model preference |
|
|
| Provenance | Exact origin and chain linking Signal, decision, code, evidence, result. | Generated summary |
|
|
| Terminal state | Explicit successful/failed/blocked/cancelled outcome requiring no hidden work. | “Agent stopped” |
|