From ec956771345d9fb3441178028714481be00865ec Mon Sep 17 00:00:00 2001
From: WellDunDun <45949032+WellDunDun@users.noreply.github.com>
Date: Sat, 14 Mar 2026 16:45:03 +0300
Subject: [PATCH] fix: build dashboard SPA in CI/publish and lead install with
 npm proof path

The publish workflow was missing the dashboard SPA build step, so the
published package never included apps/local-dashboard/dist/. CI now
also verifies the SPA builds on every PR. README install section leads
with `npx selftune@latest doctor` as the primary proof command.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/workflows/ci.yml      | 10 ++++++++++
 .github/workflows/publish.yml |  3 +++
 README.md                     |  8 ++++----
 3 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 5084e7b..4a7ed14 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -20,6 +20,16 @@ jobs:
       - run: bunx @biomejs/biome check .
       - run: bun run lint-architecture.ts
 
+  build-dashboard:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: oven-sh/setup-bun@ecf28ddc73e819eb6fa29df6b34ef8921c743461 # v2
+      - run: bun install
+      - run: bun run build:dashboard
+
   test:
     runs-on: ubuntu-latest
     permissions:
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 2d06499..f4f7139 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -60,6 +60,9 @@ jobs:
       - name: Install dependencies
         run: bun install
 
+      - name: Build dashboard SPA
+        run: bun run build:dashboard
+
       - name: Verify npm version for trusted publishing
         run: npm --version
 
diff --git a/README.md b/README.md
index 56de090..07cd43a 100644
--- a/README.md
+++ b/README.md
@@ -30,17 +30,17 @@ Built for **Claude Code**. Also works with Codex, OpenCode, and OpenClaw. Zero r
 ## Install
 
 ```bash
-npx skills add selftune-dev/selftune
+npx selftune@latest doctor
 ```
 
-Then tell your agent: **"initialize selftune"**
+That's it. One command to install and verify. Then tell your agent: **"initialize selftune"**
 
 Two minutes. No API keys. No external services. No configuration ceremony. Uses your existing agent subscription. Within minutes you'll see which skills are undertriggering.
 
-**CLI only** (no skill, just the CLI):
+**As a skill** (recommended for Claude Code users):
 
 ```bash
-npx selftune@latest doctor
+npx skills add selftune-dev/selftune
 ```
 
 ## Before / After