Repository navigation
Description
The project still has no npm identity of its own. This issue is the single place to decide it, because the decision blocks the first real npm release and touches more than a package.json field.
The facts
agent-bundle is taken. agent-bundle@0.1.2 exists on npm and belongs to an unrelated project (yujiachen-y/agent-bundle), described as a "CLI tool and framework for defining, developing, and shipping AI agent skills". The collision is not theoretical: the old root README literally told people to npm i agent-bundle, which installed that other package. That instruction was removed in #54, and the README now documents pkg.pr.new preview installs instead.
create-agent-bundle is unclaimed. Verified against the registry (404) while landing the scaffolder in #62. So the create-* half of the name is available today; the framework half is not.
Publishing is deferred, not blocked. pkg.pr.new is the interim release channel until a name lands (see docs/preview-packages.md), and every CI run publishes installable tarballs of agent-bundle, @agent-bundle/rsc-runtime, and create-agent-bundle. Nothing about the release pipeline is waiting on code.
Provenance is already pre-wired. #40 made pkg.pr.new the interim channel and pre-wired npm provenance, so the first real publish should not need release-plumbing work — only a name.
What a rename touches
- Package names —
agent-bundle, the@agent-bundle/*scope (@agent-bundle/rsc-runtime), andcreate-agent-bundle. The scope is the load-bearing part: a scope rename is wider than the root package rename. - The scaffolder's derived preview URLs —
packages/create-agent-bundle/src/framework.tsderives the framework version fromhttps://pkg.pr.new/ScriptedAlchemy/agent-bundle/agent-bundle@<sha>, which embeds both the package name and the repo slug.options.tsandindex.tscarry the same assumption. - Docs —
README.md,packages/agent-bundle/README.md,packages/rsc-runtime/README.md, anddocs/preview-packages.mdall hardcode install commands built from the name and slug. - The GitHub repo slug — every pkg.pr.new URL is
pkg.pr.new/<owner>/<repo>/<package>@<sha>, so renaming the repo invalidates published preview URLs and the scaffolder's derivation at the same time.
Options worth weighing
- Keep the repo slug, publish everything under a new scope (e.g.
@<scope>/agent-bundle+create-<name>). Smallest blast radius; the unscoped name stays lost. - Pick a wholly new name and rename the repo too. Cleanest end state; invalidates existing preview URLs and needs a docs sweep.
- Negotiate/claim the existing
agent-bundlename. Cheapest if it works, unlikely, and not something to plan around.
Definition of done
A chosen name, plus a follow-up issue or PR that lands it across the four surfaces above and cuts the first provenance-signed npm release.
Related: #50 (the RFC arc whose phases are complete), #53 (README unslop, where the wrong-package instruction was found), #62 (scaffolder, where create-agent-bundle availability was verified).
Activity
ScriptedAlchemy commentedon Aug 31, 2026
Closing per maintainer direction. The eventual public package-name choice is obvious release housekeeping and does not need a standalone tracking issue.
ScriptedAlchemy commentedon Sep 3, 2026
Closed-issue re-audit (G3) — state is consistent and documented; no rename performed (owner-only decision, also #81). On
origin/main:docs/preview-packages.md:3-11,README.md:96,packages/agent-bundle/README.md:637,packages/rsc-runtime/README.md:4, andpackages/create-agent-bundle/README.md:13-18all say the names are placeholders, nothing is on npm, and pkg.pr.new is the channel; no doc instructsnpm i agent-bundleagainst the unrelated registry package. One metadata inconsistency for the release owner:packages/rsc-runtime/package.jsonandpackages/create-agent-bundle/package.jsondeclare"license": "MIT"whilepackages/agent-bundle/package.jsonhas nolicensefield and the root README says the license "is not yet chosen". Left untouched here.