The package is published as framework, at 0.7.0 (#1635) - #1639
Merged
Conversation
The name is ours already — npm lists `brillout` and `suleimansh` as the maintainers of `framework`, whose `latest` is still Mikeal Rogers' `0.6.0` from 2022. So this is a rename, not an acquisition, and `0.7.0` takes `latest` cleanly on the first publish. `version` stops being `0.0.0`. The CLI reads its own `package.json` at runtime (`cli.ts:116`), so the repo was shipping a build that reported `0.0.0` and then asked the registry about `@gemstack/the-framework`, whose `latest` is `1.5.0` — every run of the version footer claimed an update was available. `0.7.0` against `framework`'s `0.6.0` reports up to date. `update-check.ts` and `layout.ts` are the two places where the package name is not decoration: one is the registry key the check GETs, the other is an install command printed to a user whose build predates a repo-side rename. The `pnpm --filter` lines in the dashboard README resolve by package name too. The three `node_modules/@gemstack/the-framework/prompts/*.md` mentions in `system-prompt.ts`, `tickets.ts` and `system-prompt.test.ts` are left alone. They describe the path a fixed bug (#1163) actually used; rewriting them would name a path that never existed. The package README showed `framework` as the command to type while the `bin` has always been `the-framework`. That is a pre-existing docs bug, not this rename: it now says what the `bin` installs. Whether the two should be made to match is the open question on #1635. The eleven `.changeset/*.md` files go. `a745e2e3` removed the tooling — no `config.json`, no `@changesets/cli`, no release workflow — but agents kept writing them from training and nothing has read one since. No `fix #1635`: the publish has to happen before this merges, or the README sends people to the 2022 package.
suleimansh
marked this pull request as ready for review
August 22, 2026 16:00
This was referenced Aug 22, 2026
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.
🤖 automated
Draft on purpose — this must not merge until
0.7.0is on npm.The moment
README.mdsaysnpm i -g framework, that command resolves. Today it resolves to Mikeal Rogers' 2011 package at0.6.0, which is not us. So: publish first, merge this whenever after. I've leftfix #1635out of the commit for the same reason, and because thebinquestion below is still open.The rename
name@gemstack/the-frameworkframeworkversion0.0.00.7.0homepage/bugs/repositorygemstack-land/the-frameworkframework/the-frameworkConfirmed against the registry rather than from the issue:
framework's maintainers arebrilloutandsuleimansh, and itslatestis0.6.0.0.7.0publishes cleanly and takeslatest.The version was doing real damage
versionwas0.0.0while the CLI reads its ownpackage.jsonat runtime (cli.ts:116) and then asks the registry about@gemstack/the-framework, whoselatestis1.5.0. So every run of the version footer told the user an update was available, for a package they were not running. Verified on the built binary:0.7.0againstframework's0.6.0now reports up to date.Where the name was load-bearing, not decorative
The issue's checklist covers
package.jsonand the READMEs. Three more places would have broken quietly:src/update-check.ts:9—PACKAGE_NAMEis the registry key the check GETs, and the string in thenpm i -g …line it prints.src/layout.ts:71— an error telling a user to update the package when their build predates a repo-side rename. It named the old package.dashboard/README.md:41,53—pnpm --filter @gemstack/the-frameworkresolves by package name; both lines would have stopped working for contributors.Plus the website, which the checklist didn't mention and which is a user-facing install surface:
Hero.tsx(all eight npm/pnpm/bun/yarn commands),ui.tsx(NPM_URL,GITHUB_URL— the latter still pointed atgemstack-land), and the press page's package chip.Two things I deliberately did not do
Three comments still say
node_modules/@gemstack/the-framework/prompts/*.md— insystem-prompt.ts:80,tickets.ts:20,system-prompt.test.ts:140. They describe the path that a fixed bug (#1163) actually used. Renaming it there would name a path that never existed, so the history stays accurate.The
gemstack-landstrings in test fixtures stay.github.test.ts,queue-entry.test.ts,agent-driver.test.tsandclosing-keywords.test.tsuse it as an arbitrary owner/repo. That's the repo rename, not the package rename, and it's a separate sweep if you want one.A pre-existing docs bug this turned up — and it bears on the open question
packages/the-framework/README.mdtold users to runframework, in both the quickstart and the CLI options block. Thebinis and always has beenthe-framework. So the package README has been documenting a command that does not exist.I fixed it to match the
bin. That is a docs-match-reality fix, not an answer to the A/B — but it is evidence: someone writing that README reached forframeworktwice without noticing, which is the argument for Option B.Still your call on #1635:
the-framework. What the CLI,FEATURES-SPEC.md, the root README and the website all say today.npx frameworkwould not work.frameworkso package and command match.If B, it is a one-line
binchange plus a docs pass; say so and I'll add it here rather than opening a second PR.Changesets
The eleven
.changeset/*.mdfiles are deleted.a745e2e3removed the tooling — there is noconfig.json, no@changesets/clidependency, no release workflow — but agents kept writing them from training and nothing has read one since. Confirmed no consumer before deleting.Verification
pnpm build,pnpm typecheck(both packages),pnpm test— 1536 node tests + 792 vitest, all passing.dist-testcleared before the run so it wasn't the other branch's compiled tests.The
update-checktests referencePACKAGE_NAMEas a constant, so they'd have passed either way — which is why I checked the built output and the live registry instead.Also here
One line in the root
MEMORY.md, recording your0.7.0answer where human decisions live (the #1334 convention):The number itself isn't in there —
package.jsonrecords that now.