charles/peon
1
0
Fork 0
Code Issues 12 Pull requests Projects Releases Packages Wiki Activity Actions

Contracts crate — shared domain types #2

New issue
Closed
opened 2026-04-16 11:27:53 +00:00 by claude-desktop · 0 comments
claude-desktop commented 2026-04-16 11:27:53 +00:00
Collaborator
Copy link

User story

As a backend or frontend developer, I want a contracts crate containing all shared domain types (Project, Thread, Turn, Message, Checkpoint, enums, read model, git types, terminal types, keybinding types), so that both sides of the application use a single source of truth for data structures.

Acceptance criteria

Orchestration types (orchestration.rs)

  • Project struct with fields: id: Uuid, name: String, path: String, created_at: DateTime<Utc>
  • Thread struct with fields: id, project_id, title: Option<String>, provider: Provider, model: String, runtime_mode: RuntimeMode, status: ThreadStatus, created_at, updated_at
  • Provider enum: Claude, Codex
  • RuntimeMode enum: FullAccess, Supervised
  • ThreadStatus enum: Idle, Running, AwaitingApproval, Error(String), Completed
  • Turn struct with all fields from spec §4.1
  • TurnStatus enum: Running, Completed, Interrupted, Failed(String)
  • Message struct with id, turn_id, role: MessageRole, content: MessageContent, created_at
  • MessageRole enum: User, Assistant, Tool, System
  • MessageContent enum: Text, ToolCall, ToolResult, ThinkingBlock
  • Checkpoint struct with all fields from spec §4.1
  • OrchestrationReadModel struct with projects, threads, turns_by_thread, checkpoints_by_thread, active_thread_id, active_project_id

Git types (git.rs)

  • GitStatus, FileChange, FileChangeStatus, FileDiff, DiffHunk, DiffLine, CommitInfo, BranchInfo — all as per spec §8.3

Terminal types (terminal.rs)

  • TerminalStatus enum: Starting, Running, Stopped

Keybinding types (keybindings.rs)

  • Keybinding, KeySpec, KeyScope structs/enums as per spec §11.1

Quality

  • All types derive Debug, Clone, Serialize, Deserialize
  • Crate compiles with only serde, uuid, chrono, serde_json as dependencies (no heavy deps)
  • Unit tests for serde round-trip on key types

Out of scope

  • IPC types (AppCommand, AppEvent) — those live in backend::ipc (see issue for IPC/bootstrap)
  • Event types (OrchestrationEvent) — see event sourcing story

References

  • Spec §4 (Modèle de données)
  • Spec §8.3 (Types contrats Git)
  • Spec §11.1 (Keybindings définition)
## User story As a **backend or frontend developer**, I want a `contracts` crate containing all shared domain types (Project, Thread, Turn, Message, Checkpoint, enums, read model, git types, terminal types, keybinding types), so that both sides of the application use a single source of truth for data structures. ## Acceptance criteria ### Orchestration types (`orchestration.rs`) - [ ] `Project` struct with fields: `id: Uuid`, `name: String`, `path: String`, `created_at: DateTime<Utc>` - [ ] `Thread` struct with fields: `id`, `project_id`, `title: Option<String>`, `provider: Provider`, `model: String`, `runtime_mode: RuntimeMode`, `status: ThreadStatus`, `created_at`, `updated_at` - [ ] `Provider` enum: `Claude`, `Codex` - [ ] `RuntimeMode` enum: `FullAccess`, `Supervised` - [ ] `ThreadStatus` enum: `Idle`, `Running`, `AwaitingApproval`, `Error(String)`, `Completed` - [ ] `Turn` struct with all fields from spec §4.1 - [ ] `TurnStatus` enum: `Running`, `Completed`, `Interrupted`, `Failed(String)` - [ ] `Message` struct with `id`, `turn_id`, `role: MessageRole`, `content: MessageContent`, `created_at` - [ ] `MessageRole` enum: `User`, `Assistant`, `Tool`, `System` - [ ] `MessageContent` enum: `Text`, `ToolCall`, `ToolResult`, `ThinkingBlock` - [ ] `Checkpoint` struct with all fields from spec §4.1 - [ ] `OrchestrationReadModel` struct with `projects`, `threads`, `turns_by_thread`, `checkpoints_by_thread`, `active_thread_id`, `active_project_id` ### Git types (`git.rs`) - [ ] `GitStatus`, `FileChange`, `FileChangeStatus`, `FileDiff`, `DiffHunk`, `DiffLine`, `CommitInfo`, `BranchInfo` — all as per spec §8.3 ### Terminal types (`terminal.rs`) - [ ] `TerminalStatus` enum: `Starting`, `Running`, `Stopped` ### Keybinding types (`keybindings.rs`) - [ ] `Keybinding`, `KeySpec`, `KeyScope` structs/enums as per spec §11.1 ### Quality - [ ] All types derive `Debug, Clone, Serialize, Deserialize` - [ ] Crate compiles with only `serde`, `uuid`, `chrono`, `serde_json` as dependencies (no heavy deps) - [ ] Unit tests for serde round-trip on key types ## Out of scope - IPC types (`AppCommand`, `AppEvent`) — those live in `backend::ipc` (see issue for IPC/bootstrap) - Event types (`OrchestrationEvent`) — see event sourcing story ## References - Spec §4 (Modèle de données) - Spec §8.3 (Types contrats Git) - Spec §11.1 (Keybindings définition)
claude-desktop added this to the v0.1.0 milestone 2026-04-16 11:27:53 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
area:config
Configuration loading, TOML, settings

  
area:contracts
Shared types crate (contracts)

  
area:engine
OrchestrationEngine, reactors, dispatch loop

  
area:eventsourcing
Event sourcing core — decider, projector, commands, events

  
area:frontend
GTK4/RELM4 frontend components

  
area:git
Git integration — GitCore, checkpoints, branches

  
area:ipc
IPC channels, AppCommand/AppEvent, GTK↔tokio bridge

  
area:persistence
SQLite persistence, EventStore, migrations

  
area:provider
Provider adapters (Claude, Codex), JSON-RPC stdio

  
area:scaffold
Project scaffolding, workspace setup, CI

  
area:terminal
Terminal manager, PTY, VTE4, Kitty/Foot

  
type:user-story
User story for v0.1.0 implementation

No labels
area:config
area:contracts
area:engine
area:eventsourcing
area:frontend
area:git
area:ipc
area:persistence
area:provider
area:scaffold
area:terminal
type:user-story
Milestone
Clear milestone
No items
No milestone
v0.1.0
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/peon#2
No description provided.