feat!: one-sentence onboarding through b10x setup; release 0.12.0 - #14
Merged
Merged
Conversation
- New crate crates/b10x (clap): `b10x setup plan` reads both hosts (claude/codex plugin and marketplace lists as JSON, ~/.codex/config.toml), every catalog binary on PATH and the plugin entries in known projects' settings, and prints findings and exact argv actions; `setup apply` refuses a stale plan, snapshots every file it changes, runs the actions and re-plans to prove convergence; `setup undo` restores the snapshot; `check` is the offline session-start drift check; `install` installs a catalog binary from its checksummed archive or `cargo install --tag`. - Planning is a pure function of recorded host output; 21 tests on fixtures recorded from a clean HOME with a legacy install on both hosts (home paths replaced with /opt/b10x-home). - End to end in a clean HOME seeded with agentplugins 0.10.0 under the old marketplace name on both hosts, a local-scope legacy install, an orphan project entry and ess 0.29.0: plan listed 32 actions, apply ran 32/32, the second plan changed nothing, and undo restored all 8 files. - catalog.json lists products, plugins, binaries, how each binary's version is bound (to its plugin, or the newest release) and retired names; it names no version. Versions resolve at run time. - Front door `beyond10x` becomes `b10x`: skills setup (new), guide (was beyond10x:beyond10x), plugin-creator, and a SessionStart hook running `b10x check`; in a live session it reported this machine's worktree 0.4.1 under plugin 0.6.0 and a leftover legacy install. - Remote entries are version-free: ess and worktree are git-subdir with repository and path only, in both marketplace files (Codex accepts git-subdir; 0.11.0's statement otherwise was wrong). The checker refuses ref/sha/version on them and a catalog that disagrees with the marketplaces; `agentplugins-check remote` refuses a default branch that serves an unreleased plugin version. - SETUP.md and b10x-<target>.tar.gz archives for four targets become release assets; README, AGENTS.md invariants and the website describe the one-sentence route. - The planning story (story:one-sentence-onboarding) is not in this commit: any journal write trips the whole-file personal-paths scan on three journal lines from 2026-09-07/09. Its patch is kept for replay once Gates ships the appended-tail scan.
- Workspace, Cargo.lock (agentplugins-check, b10x), every plugin manifest this repository carries, and the three version-stamped skills move from 0.11.0 to 0.12.0. - Changelog: close the Unreleased section as 0.12.0. The minor bump marks the breaking rename of the front door to b10x and the version-free remote entries. - task check passes: 37 + 2 + 21 tests, 8 eval cases, marketplace b10x with 4 carried and 2 remote plugins.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
b10xbinary (crates/b10x):setup planreads both hosts,PATHand project settings and prints exact actions;setup applysnapshots, runs, re-plans;setup undo;check(session-start drift line);install.beyond10x→b10x:setup(new),guide,plugin-creator, SessionStart hook.essandworktreearegit-subdirentries with repo + path only in both marketplace files;catalog.jsonnames no version; checker refuses pins;remotecheck refuses an unreleased default-branch plugin version.SETUP.md+b10x-<target>.tar.gz×4 +SHA256SUMSpublished by the release workflow.Validation:
task checkexit 0 (37 + 2 + 21 tests, 8 eval cases);task site-buildexit 0;claude plugin validatepassed for the marketplace andplugins/b10x;agentplugins-check remote: worktree 0.6.0, ess 0.30.0.undorestored 8 files.Not in this PR: the planning story (journal write blocked by the whole-file personal-paths scan on three 2026-09-07/09 journal lines); an eval case for
b10x:setup.