Skeleton

.forgejo/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: https://github.com/dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: ${{ runner.os }}-cargo-
+
+      - name: Build
+        run: cargo build
+
+      - name: Format
+        run: cargo fmt --check
+
+      - name: Clippy
+        run: cargo clippy -- -D warnings

Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "skate"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+ratatui = "0.30"
+crossterm = "0.29"
+tokio = { version = "1", features = ["full"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+thiserror = "2"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+reqwest = { version = "0.13", features = ["stream"] }
+futures = "0.3"

src/app/mod.rs

@@ -0,0 +1 @@
+

src/core/mod.rs

@@ -0,0 +1 @@
+pub mod types;

src/core/types.rs

@@ -0,0 +1,56 @@
+// Types are scaffolding — used in later phases.
+#![allow(dead_code)]
+
+/// A streaming event emitted by the model provider.
+#[derive(Debug)]
+pub enum StreamEvent {
+    /// A text chunk from the assistant's response.
+    TextDelta(String),
+    /// Number of input tokens used in this request.
+    InputTokens(u32),
+    /// Number of output tokens generated so far.
+    OutputTokens(u32),
+    /// The stream has completed successfully.
+    Done,
+    /// An error occurred during streaming.
+    Error(String),
+}
+
+/// An action sent from the TUI to the core orchestrator.
+#[derive(Debug)]
+pub enum UserAction {
+    /// The user has submitted a message.
+    SendMessage(String),
+    /// The user has requested to quit.
+    Quit,
+}
+
+/// An event sent from the core orchestrator to the TUI.
+#[derive(Debug)]
+pub enum UIEvent {
+    /// A text chunk to append to the current assistant message.
+    StreamDelta(String),
+    /// The current assistant turn has completed.
+    TurnComplete,
+    /// An error to display to the user.
+    Error(String),
+}
+
+/// The role of a participant in a conversation.
+#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
+#[serde(rename_all = "lowercase")]
+pub enum Role {
+    /// A message from the human user.
+    User,
+    /// A message from the AI assistant.
+    Assistant,
+}
+
+/// A single message in the conversation history.
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
+pub struct ConversationMessage {
+    /// The role of the message author.
+    pub role: Role,
+    /// The text content of the message.
+    pub content: String,
+}

src/main.rs

@@ -0,0 +1,6 @@
+mod app;
+mod core;
+mod provider;
+mod tui;
+
+fn main() {}

src/provider/mod.rs

@@ -0,0 +1 @@
+

src/tui/mod.rs

@@ -0,0 +1 @@
+