release: merge 0.1.0 into master

.coderabbit.yaml

@@ -8,11 +8,19 @@ reviews:
   review_status: false
   review_details: false
   poem: false
-  request_changes_workflow: false
+  request_changes_workflow: true
 
+
+
   auto_review:
-    enabled: true
-    drafts: false
+    enabled: true               # Disables automatic reviews on push
+    drafts: true
+    base_branches:
+      - ".*"
+    auto_incremental_review: true
+
+  # Never pause after repeated pushes.
+  auto_pause_after_reviewed_commits: 0
 
   path_instructions:
     - path: "**/*.rs"
@@ -26,11 +34,9 @@ reviews:
 
         For Rust workspace code:
         - Prioritize ownership, borrowing, lifetimes, unsafe usage, panic paths, concurrency, and API contract correctness.
-        - Do not comment on minor style preferences, formatting, naming bikeshedding, speculative refactors, or micro-optimizations.
         - Do not suggest changes unless the issue is concrete and actionable.
 
     - path: "{**/*.md,**/*.rs}"
       instructions: |
         Check docs and rustdoc for factual consistency with the code.
         Flag only real mismatches, broken examples, stale comments, or important omissions.
-        Ignore wording nits unless they are genuine typos or change meaning.

.gitattributes

@@ -0,0 +1,3 @@
+*.rs linguist-language=Rust
+Cargo.toml linguist-language=Rust
+Cargo.lock linguist-language=Rust

.github/ISSUE_TEMPLATE/bug_report.md

@@ -6,6 +6,12 @@ type: Bug
 labels: ["bug"]
 ---
 
+<!--
+Title: describe the observable failure or regression in sentence case, without a
+category prefix or terminal punctuation. Example: `Duplicate submissions can
+strand callers until deadline`
+-->
+
 ## Problem
 <!-- What happened? Include the relevant error or diagnostic evidence. -->
 

.github/ISSUE_TEMPLATE/change_request.md

@@ -6,6 +6,12 @@ type: Feature
 labels: ["enhancement"]
 ---
 
+<!--
+Title: start with an imperative verb and describe the requested outcome in
+sentence case, without a category prefix or terminal punctuation. Example: `Add
+durable engine state replication`
+-->
+
 ## Goal
 <!-- What outcome should this change produce? -->
 

.github/ISSUE_TEMPLATE/question.md

@@ -2,9 +2,15 @@
 name: Spike / question
 about: Ask a design question or request an investigation
 title: ""
-labels: question
+labels: ["question"]
 ---
 
+<!--
+Title: state the decision or unknown concisely in sentence case, without a
+category prefix or terminal punctuation. Example: `Determine whether snapshots
+require versioned manifests`
+-->
+
 ## Question
 <!-- What needs to be decided or understood? -->
 

.github/ISSUE_TEMPLATE/task.md

@@ -6,6 +6,12 @@ type: Task
 labels: []
 ---
 
+<!--
+Title: start with an imperative verb and describe the completed outcome in
+sentence case, without a category prefix or terminal punctuation. Example:
+`Configure full Rust CI workflow`
+-->
+
 ## Outcome
 <!-- What should be true when this task is complete? -->
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,3 +1,9 @@
+<!--
+Title: use `<type>: <description>`, with a Conventional Commit type and a
+concise lowercase imperative description, without terminal punctuation.
+Example: `feat: add state replicator crate`
+-->
+
 ## What changed
 <!-- Summarize the change at the immediate-parent diff boundary. -->
 
@@ -7,8 +13,5 @@ Closes #ISSUE
 ## Impact
 <!-- Note behavior, API, storage, compatibility, security, or performance effects. -->
 
-## Validation
-<!-- List the exact checks run and their outcomes. If none were run, say why. -->
-
 ## Reviewer notes
 <!-- Point reviewers to invariants, sharp edges, or the highest-risk part of the diff. -->

.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: Run CI
+
+on:
+  push:
+    branches: [master, dev]
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+permissions:
+  contents: read
+
+env:
+  AGAVE_VERSION: v4.2.0
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    name: ${{ matrix.name }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: Format
+            command: cargo fmt --check
+            cache: false
+            sbf: false
+            nextest: false
+          - name: Clippy
+            command: cargo clippy --quiet --all-features --all-targets -- -D warnings
+            cache: true
+            sbf: true
+            nextest: false
+          - name: Tests
+            command: cargo nextest run --cargo-quiet --nff
+            cache: true
+            sbf: true
+            nextest: true
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Install Rust toolchain
+        run: rustup toolchain install
+
+      - name: Cache Rust build artifacts
+        if: matrix.cache
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: ${{ matrix.name }}
+          cache-on-failure: true
+
+      - name: Cache Solana SBF tools
+        if: matrix.sbf
+        id: cache-solana
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.local/share/solana
+            ~/.cache/solana
+          key: solana-sbf-${{ runner.os }}-${{ runner.arch }}-${{ env.AGAVE_VERSION }}
+
+      - name: Install Solana CLI
+        if: matrix.sbf && steps.cache-solana.outputs.cache-hit != 'true'
+        run: sh -c "$(curl -sSfL https://release.anza.xyz/$AGAVE_VERSION/install)"
+
+      - name: Add Solana CLI to PATH
+        if: matrix.sbf
+        run: echo "$HOME/.local/share/solana/install/active_release/bin" >> "$GITHUB_PATH"
+
+      - name: Install cargo-nextest
+        if: matrix.nextest
+        uses: taiki-e/install-action@nextest
+
+      - name: Run ${{ matrix.name }}
+        run: ${{ matrix.command }}

.gitignore

@@ -1,3 +1,3 @@
 /target
-Cargo.lock
 AGENTS.md
+CLAUDE.md