Skip to content

fix: build dashboard SPA in CI/publish and lead install with npm proof path#46

Closed
WellDunDun wants to merge 1 commit intodevfrom
WellDunDun/tighten-release-path
Closed

fix: build dashboard SPA in CI/publish and lead install with npm proof path#46
WellDunDun wants to merge 1 commit intodevfrom
WellDunDun/tighten-release-path

Conversation

@WellDunDun
Copy link
Collaborator

Tightens the release/install path to prove the published package behaves like the branch code.

Changes:

  • Publish workflow now builds dashboard SPA (bun run build:dashboard) before npm publish, so the React SPA ships in the published package instead of relying on legacy fallback
  • CI now verifies dashboard SPA builds on every PR (build-dashboard job), catching build failures before merge
  • README install section leads with npx selftune@latest doctor as the primary proof command (directly tests the published npm package), with skill-based install as secondary

Proof flow: After merge, users can verify the published package works: (1) npx selftune@latest doctor, (2) npx selftune@latest status, (3) npx selftune@latest dashboard.

…f 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>
@coderabbitai
Copy link

coderabbitai bot commented Mar 14, 2026

📝 Walkthrough

Summary by CodeRabbit

  • New Features

    • Dashboard build step added to CI/CD pipeline for automated compilation during publish workflow.
  • Documentation

    • Installation instructions simplified to one-command setup with verification.
    • Reordered installation flow to recommend skill-based approach for Claude Code users.
    • Updated install commands to reflect recommended usage pattern.

Walkthrough

Adds a new CI job to build a dashboard and integrates dashboard building into the publish workflow. Updates README installation instructions to recommend skill-based installation instead of CLI-only approach.

Changes

Cohort / File(s) Summary
CI/CD Workflow Updates
.github/workflows/ci.yml, .github/workflows/publish.yml
Adds build-dashboard job in CI (runs on ubuntu-latest with read permissions) and inserts bun run build:dashboard step in publish workflow before npm version verification.
Documentation
README.md
Reorders installation instructions to prioritize skill-based installation (npx skills add selftune-dev/selftune) over CLI-only approach; updates framing and messaging accordingly.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • PR#2: Modifies .github/workflows/publish.yml to add dashboard build step—directly overlaps with the same workflow file changes in this PR.
  • PR#3: Alters the publish CI workflow that this PR also updates with the dashboard build integration step.
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed Title follows conventional commits format (fix) and accurately summarizes the main changes: building dashboard SPA in CI/publish and updating README install guidance.
Description check ✅ Passed Description is directly related to the changeset, detailing the workflow additions, CI verification job, and README updates with clear explanation of the proof flow.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch WellDunDun/tighten-release-path
📝 Coding Plan
  • Generate coding plan for human review comments

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 33-36: The phrase "One command to install and verify" is
misleading because `npx selftune@latest doctor` runs the package temporarily;
update the README sentence that follows the `npx selftune@latest doctor` example
to indicate this is a verification/test run rather than a permanent install
(e.g., change to "One command to verify your setup" or add "runs via npx without
persisting install"), and optionally add a short pointer mentioning the actual
installation method referenced later (the skill-based approach) so readers know
where to go for a persistent install.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 0e180578-50c8-4b50-b673-2effe2b32d3e

📥 Commits

Reviewing files that changed from the base of the PR and between aec5f4f and ec95677.

📒 Files selected for processing (3)
  • .github/workflows/ci.yml
  • .github/workflows/publish.yml
  • README.md

Comment on lines +33 to +36
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"**
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Wording may mislead users about installation.

Line 36 says "One command to install and verify" but npx selftune@latest doctor runs the package temporarily via npx without persisting it. The actual installation for Claude Code users is the skill-based approach on line 43. Consider rewording to something like "One command to verify your setup" or clarifying that this tests the npm package without permanent installation.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 33 - 36, The phrase "One command to install and
verify" is misleading because `npx selftune@latest doctor` runs the package
temporarily; update the README sentence that follows the `npx selftune@latest
doctor` example to indicate this is a verification/test run rather than a
permanent install (e.g., change to "One command to verify your setup" or add
"runs via npx without persisting install"), and optionally add a short pointer
mentioning the actual installation method referenced later (the skill-based
approach) so readers know where to go for a persistent install.

@WellDunDun
Copy link
Collaborator Author

Closing as superseded — all three changes in this PR are already on dev:

  • ci.yml build-dashboard job — landed via Prepare SPA dashboard release path #44 (identical job already on dev)
  • publish.yml Build dashboard SPA step — landed via Prepare SPA dashboard release path #44 (identical step already on dev)
  • README install reorder — dev's README has been restructured with a dedicated proof path block (doctor, sync, status, dashboard) already documented; the PR's diff no longer applies cleanly

No replacement PR needed. Thanks for the contribution — the intent shipped.

@WellDunDun WellDunDun closed this Mar 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant