Full Headless Mode: daemon + thin clients

.claude/skills/duplicate-detection/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: duplicate-detection
+description: Detect duplicated code and choose safe deduplication targets in Rust or general codebases. Use when the user asks to find code clones, dedupe a PR or branch, run duplicate-code tools, reduce repeated logic, identify dangerous duplication that may drift, or continue incremental refactors driven by duplicate-detection reports.
+---
+
+# Duplicate Detection
+
+Use this skill to turn clone reports into small, safe refactors. Prefer removing duplication that can cause behavior drift over reducing a metric for its own sake.
+
+## Workflow
+
+1. Establish scope.
+   - Inspect the current branch, worktree state, language mix, and test commands.
+   - For PR work, determine the correct merge base before judging whether duplication is new.
+   - Check whether CI already runs linting such as `cargo clippy`; clippy is useful but is not a duplicate-code detector.
+
+2. Generate duplicate reports.
+   - Use at least one structural or token-based detector.
+   - Exclude generated output, vendored dependencies, build artifacts, lockfiles, snapshots, and large fixtures unless the user explicitly wants them included.
+   - Save reports under `/tmp` or another disposable path; do not commit report output unless asked.
+
+3. Triage the reports before editing.
+   - Prioritize logic that can drift: policy checks, wire protocol construction, persistence, filesystem/process/network behavior, lifecycle transitions, cache invalidation, notifications, and cross-entrypoint behavior.
+   - Treat tests as lower priority unless duplicated setup hides product behavior, makes assertions diverge, or blocks future maintenance.
+   - Ignore harmless symmetry when abstraction would obscure intent: simple DTO conversions, repeated enum arms, tiny wrappers, trivial UI layout, or generated-looking glue.
+
+4. Refactor in small slices.
+   - Extract the smallest shared helper that matches an existing module boundary.
+   - Preserve public APIs, FFI boundaries, serialized formats, and observable error text unless the user asked to change them.
+   - Avoid macro layers, broad architecture moves, or generic frameworks unless the payoff is obvious; ask first when unsure.
+   - Commit each coherent refactor separately when the user asks for incremental commits.
+
+5. Verify and report.
+   - Run targeted tests or checks for touched code; run broader checks when shared behavior moved.
+   - Re-run the duplicate detector after meaningful refactors and report before/after counts.
+   - Explain which duplicate classes remain and why they are lower priority.
+
+## Rust Commands
+
+Use `cargo-dupes` for Rust-focused clone reports when available:
+
+```bash
+cargo dupes --path . \
+  --exclude target \
+  --exclude node_modules \
+  --exclude-tests \
+  --min-lines 8 \
+  --min-nodes 20 \
+  --threshold 0.85 \
+  --format json report > /tmp/duplicate-detection-cargo-dupes.json
+```
+
+If it is missing and installing tools is acceptable in the environment:
+
+```bash
+cargo install cargo-dupes --locked
+```
+
+`cargo-dupes` may emit multiple JSON values. Read the first report object with `jq -s`:
+
+```bash
+jq -s '.[0] | {
+  exact_groups: .exact_duplicate_groups,
+  exact_lines: .exact_duplicate_lines,
+  near_groups: .near_duplicate_groups,
+  near_lines: .near_duplicate_lines
+}' /tmp/duplicate-detection-cargo-dupes.json
+```
+
+Run normal Rust quality gates for changed behavior:
+
+```bash
+cargo test
+cargo clippy --all-targets --all-features -- -D warnings
+```
+
+Adjust those commands to match the repo's documented CI.
+
+## General Commands
+
+Use `jscpd` for broad token/text clone detection across mixed-language repos:
+
+```bash
+npx --yes jscpd@5 . \
+  --min-lines 8 \
+  --min-tokens 80 \
+  --ignore "**/target/**,**/.git/**,**/node_modules/**,**/dist/**,**/build/**,**/coverage/**,**/Cargo.lock,**/package-lock.json,**/pnpm-lock.yaml,**/yarn.lock" \
+  --reporters json,silent \
+  --output /tmp/duplicate-detection-jscpd
+```
+
+When the repo is mostly Rust, add `--format rust` to reduce noise. For mixed repos, let `jscpd` auto-detect formats or pass a comma-separated format list.
+
+Summarize the JSON report:
+
+```bash
+jq '.statistics.total | {
+  clones: .clones,
+  duplicated_lines: .duplicatedLines,
+  duplicated_percentage: .percentage
+}' /tmp/duplicate-detection-jscpd/jscpd-report.json
+```
+
+## Review Heuristics
+
+Ask these questions for each candidate:
+
+- Would a future change likely need to update both places?
+- Is one copy already subtly different in a way that looks accidental?
+- Does the duplication cross a boundary where behavior should stay aligned, such as local versus remote, daemon versus client, or API versus UI?
+- Can the shared helper be named after a real domain concept rather than after the duplicated syntax?
+- Will the refactor reduce branching and tests, or just hide two readable blocks behind indirection?
+
+Proceed when the answers point to drift risk and the extraction is local. Leave the duplication alone when a shared abstraction would be more fragile than the repeated code.

.github/workflows/build.yml

@@ -64,6 +64,14 @@ jobs:
       - name: Clippy
         run: cargo clippy --workspace --all-targets -- -D warnings
 
+      - name: Daemon/client split gates
+        run: |
+          scripts/audit-daemon-client-gaps.sh
+          if cargo tree -p okena-daemon --edges no-dev | grep -E 'gpui|gpui-component'; then
+            echo "okena-daemon must stay GPUI-free"
+            exit 1
+          fi
+
       - name: Run tests
         run: cargo test
 
@@ -163,14 +171,18 @@ jobs:
         run: cd web && bun install --frozen-lockfile && bun run build
 
       - name: Build
-        run: cargo build --release --target ${{ matrix.target }}
+        run: cargo build --release --target ${{ matrix.target }} -p okena -p okena-daemon
 
       - name: Prepare artifact (Linux)
         if: runner.os == 'Linux'
         run: |
           mkdir -p dist/icons
           cp target/${{ matrix.target }}/release/okena dist/
           chmod +x dist/okena
+          # Ship the GPUI-free daemon sibling so the app runs the real daemon
+          # binary instead of falling back to `okena --headless`.
+          cp target/${{ matrix.target }}/release/okena-daemon dist/
+          chmod +x dist/okena-daemon
           # Bundle icons for Linux installation
           cp assets/app-icon-16.png assets/app-icon-32.png assets/app-icon-48.png \
              assets/app-icon-64.png assets/app-icon-128.png assets/app-icon-256.png \
@@ -188,6 +200,8 @@ jobs:
         run: |
           mkdir dist
           copy target\${{ matrix.target }}\release\okena.exe dist\
+          rem Ship the GPUI-free daemon sibling (see Linux step).
+          copy target\${{ matrix.target }}\release\okena-daemon.exe dist\
 
       - name: Upload artifact
         uses: actions/upload-artifact@v4

Cargo.toml

@@ -1,10 +1,13 @@
 [workspace]
-members = [".", "crates/okena-mobile-ffi", "crates/okena-core", "crates/okena-transport", "crates/okena-git", "crates/okena-views-git", "crates/okena-views-services", "crates/okena-views-sidebar", "crates/okena-views-terminal", "crates/okena-terminal", "crates/okena-layout", "crates/okena-state", "crates/okena-hooks", "crates/okena-workspace", "crates/okena-ui", "crates/okena-usage", "crates/okena-files", "crates/okena-markdown", "crates/okena-extensions", "crates/okena-ext-claude", "crates/okena-ext-codex", "crates/okena-ext-github", "crates/okena-ext-updater", "crates/okena-services", "crates/okena-remote-client", "crates/okena-remote-server", "crates/okena-views-remote", "crates/okena-theme", "crates/okena-cli", "crates/okena-app-core", "crates/okena-app"]
+members = [".", "crates/okena-mobile-ffi", "crates/okena-core", "crates/okena-transport", "crates/okena-git", "crates/okena-views-git", "crates/okena-views-services", "crates/okena-views-sidebar", "crates/okena-views-terminal", "crates/okena-terminal", "crates/okena-layout", "crates/okena-state", "crates/okena-hooks", "crates/okena-workspace", "crates/okena-ui", "crates/okena-usage", "crates/okena-files", "crates/okena-markdown", "crates/okena-extensions", "crates/okena-ext-claude", "crates/okena-ext-codex", "crates/okena-ext-github", "crates/okena-ext-updater", "crates/okena-services", "crates/okena-remote-client", "crates/okena-remote-server", "crates/okena-views-remote", "crates/okena-theme", "crates/okena-cli", "crates/okena-app-core", "crates/okena-app", "crates/okena-daemon-core", "crates/okena-daemon", "crates/okena-tui"]
 resolver = "2"
 
+[workspace.package]
+version = "0.27.0"
+
 [package]
 name = "okena"
-version = "0.27.0"
+version.workspace = true
 edition = "2024"
 license = "MIT"
 
@@ -26,6 +29,11 @@ okena-views-terminal = { path = "crates/okena-views-terminal" }
 okena-views-git = { path = "crates/okena-views-git" }
 okena-ui = { path = "crates/okena-ui" }
 
+# `--daemon-client` startup: ensure_local_daemon() (discover-or-spawn the local
+# headless daemon + mint a loopback token). Already a transitive dep via
+# okena-app, so this adds no new linkage — only a direct path to the `local` API.
+okena-remote-server = { path = "crates/okena-remote-server" }
+
 # Extension system — registered at startup in main.rs.
 okena-extensions = { path = "crates/okena-extensions" }
 okena-ext-claude = { path = "crates/okena-ext-claude" }