Skip to content

docs+test: refresh README to v0.1 status + fix stale smoke test#3

Merged
arwenizEr merged 2 commits into
mainfrom
docs/refresh-readmes
May 21, 2026
Merged

docs+test: refresh README to v0.1 status + fix stale smoke test#3
arwenizEr merged 2 commits into
mainfrom
docs/refresh-readmes

Conversation

@arwenizEr
Copy link
Copy Markdown
Collaborator

Summary

Two threads, bundled because they both touch repo hygiene:

  1. README refresh — replace "scaffold only" with a table of working subcommands (init/add/install/list/doctor/search) plus a Phase A→E SaaS roadmap; add Contributing section codifying the feature branch + PR + squash auto-merge workflow.
  2. Smoke test fixinstall_subcommand_runs was a stub-era test asserting that `pakx install` exits 0 with no manifest. Replaced with install_help_runs (matches the existing init_help_runs pattern). End-to-end install coverage stays in tests/install.rs.

The smoke test failure was the root cause of red CI on PR #1 and PR #2 (auto-merge fired before checks completed because no branch protection rules required them — separate followup).

GitHub repo description + visibility for pakxdev/pakx updated out-of-band via gh repo edit (now public, with a one-liner about MCP/skills/prompts across Claude Code/Cursor/Codex/Copilot/Windsurf).

Test plan

  • cargo fmt --check
  • cargo clippy --workspace --all-targets -- -D warnings
  • Smoke test now matches the actual install behaviour
  • CI test matrix green
  • Branch protection rule added (followup, separate PR)

🤖 Generated with Claude Code

arwenizEr and others added 2 commits May 21, 2026 15:42
- Replace "scaffold only" status with a table of working subcommands
  (init/add/install/list/doctor/search) and an in-progress list for
  Phase A (Smithery + GitHub-raw skill source), Phase B (pakx-registry
  backend), Phase C (login/pack/publish), Phase D (dashboard at
  pakx.dev), Phase E (Stripe Connect billing).
- Update Quick start with real commands and the .mcp.json hand-off
  note for Claude Code.
- Add Contributing section codifying the feature branch + PR +
  squash auto-merge workflow now in effect.
- Crate table description for pakx-core updated to mention install
  payloads + integrity hashing.

Repo also flipped from private to public + GitHub description set
("Universal package manager for AI agent context — install MCP
servers, skills, prompts, hooks across Claude Code, Cursor, Codex,
Copilot, Windsurf from one agents.yml") via `gh repo edit` separately.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The smoke test asserted that `pakx install` exits 0 with no manifest
in cwd — true when install was a stub, no longer true now that the
real install loop reads agents.yml.

Mirror the init_help_runs pattern: smoke covers `install --help` only
(asserts the description and a flag); end-to-end install coverage
lives in tests/install.rs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@arwenizEr arwenizEr merged commit 6e29e8e into main May 21, 2026
5 checks passed
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