Skip to content

feat(cli): make appa own Claude Code initialization - #111

Open
arsenyinfo wants to merge 9 commits into
mainfrom
feat/lean-appa-describe
Open

feat(cli): make appa own Claude Code initialization#111
arsenyinfo wants to merge 9 commits into
mainfrom
feat/lean-appa-describe

Conversation

@arsenyinfo

@arsenyinfo arsenyinfo commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Summary

  • ship one versioned appa package and executable; the daemon is now the internal appa runtime subcommand rather than a second appa-runtime binary
  • add appa init claude-code as the single owner of Claude Code setup: discover the matching adapter, replace existing APPA registrations, preserve policy and custom statusline state, install one user-scoped plugin, start the daemon, and verify its binary fingerprint
  • migrate a running legacy appa-runtime deployment by exact executable path, then remove the retired binary instead of stacking old and new runtimes
  • keep appa describe as the lean text view of the current configuration world and make appa-guide inspect it before proposing policy
  • give shipped APPA crates, the Python binding, and the Claude plugin the shared 0.5.0 release version; release automation now owns the Cargo workspace version and lockfile
  • render a compact, TTY-colored init receipt with current checkout, ~ paths, and clappa; statusline and daemon paths stay implementation details
  • package the Claude adapter, batteries, and contract guide with release artifacts so a checkout or archive can be tested end to end

End-to-end flow

cargo install --path appa-runtime --force
appa init claude-code
clappa

Then run /appa-guide init in Claude Code. Re-running appa init claude-code replaces the APPA deployment instead of stacking another plugin/runtime.

Validation

  • cargo test -p appa (full suite)
  • cargo check --workspace --locked
  • isolated cargo install --path appa-runtime --locked --offline proves Cargo installs appa v0.5.0 with exactly one executable, appa
  • appa --version and appa runtime --version both report 0.5.0
  • init integration tests cover idempotence, legacy-binary cleanup, custom statusline preservation, and wrong-runtime fingerprint refusal
  • isolated Claude plugin-manager add/install/uninstall/reinstall exercise, including same-version local source replacement
  • uv lock --check --directory appa-agent-python
  • cargo fmt --all -- --check
  • git diff --check
  • claude plugin validate integrations/claude-code
  • POSIX hook sh -n and shellcheck
  • release workflow actionlint
  • appa-guide behavioral review passed

@arsenyinfo arsenyinfo changed the title feat(cli): add lean appa describe command feat(cli): make appa own Claude Code initialization Aug 27, 2026
Comment thread appa-runtime/src/main.rs Fixed
Comment thread appa-runtime/src/main.rs Fixed
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.

2 participants