Skip to content

refactor: rename packages/framework directory to packages/the-framework - #1092

Merged
suleimansh merged 1 commit into
mainfrom
refactor/rename-framework-dir
Jul 23, 2026
Merged

refactor: rename packages/framework directory to packages/the-framework#1092
suleimansh merged 1 commit into
mainfrom
refactor/rename-framework-dir

Conversation

@suleimansh

Copy link
Copy Markdown
Contributor

Final consistency pass on the rename: the directory now matches the package name (@gemstack/the-framework) and CLI (the-framework).

Internal only, no published behavior change. Package files resolve relative to the package dir, and the build scripts (bundle-dashboard, gen-prompts, check-prompt-drift, run-tests) locate themselves and siblings via import.meta.url, so nothing depended on the literal packages/framework path.

Changes

  • git mv packages/framework packages/the-framework (all files detected as pure renames)
  • Updated the path references that did hardcode it:
    • package.json: repository.directory + homepage
    • .github/workflows/prompt-drift.yml: path filters + the run step
    • .gitignore: the generated-file path
    • root README.md: package table link + label (framework -> the-framework)
    • one illustrative test path in daemon.test.ts
  • Regenerated pnpm-lock.yaml (workspace glob is packages/*, so no workspace-file change)

Left alone

  • A historical terminal-example path in tickets/460-Vike_error.md
  • @gemstack/framework-dashboard (boundary-safe replace never touched it)

Verification

  • pnpm build 12/12, pnpm typecheck 22/22
  • framework tests 1172 pass / 0 fail / 1 skip
  • check-prompt-drift in sync (now resolving from the new path)

Note: the move carried along a pre-existing tracked .the-framework/control.jsonl runtime artifact that was already committed under the old dir. Happy to drop it from git in this PR if you'd like it untracked.

Align the directory name with the package (@gemstack/the-framework) and CLI
(the-framework). Internal only, no published behavior change: package files
resolve relative to the package dir, and the build scripts locate siblings via
import.meta.url, so nothing depended on the old directory name.

Updated the path references that did: repository.directory + homepage in
package.json, the prompt-drift workflow's path filters and run step, .gitignore's
generated-file path, the README package table, and an illustrative test path.
Regenerated pnpm-lock.yaml.
@suleimansh suleimansh self-assigned this Jul 23, 2026
@suleimansh
suleimansh marked this pull request as ready for review July 23, 2026 19:56
@suleimansh
suleimansh merged commit 63573ba into main Jul 23, 2026
3 checks passed
@suleimansh
suleimansh deleted the refactor/rename-framework-dir branch July 23, 2026 19:58
suleimansh added a commit that referenced this pull request Jul 28, 2026
…1337)

#1311 untracked `.the-framework/control.jsonl` and added nothing to hold
the line, so eighteen hours later a run's own branch committed an empty
one straight back onto main (#1309). Tracking it is what #1298 is about:
the daemon rewrites the control channel on every steer, so a tracked copy
dirties every checkout and turns into delete-vs-modify conflicts between
machines.

Untracks it again, plus the copy under `packages/the-framework/` that a
run executing inside the package directory left behind at the #1092
rename and that nothing has touched since.

The guard is the point. The invariant is wider than one filename:
`.the-framework/` is transient except the committed DB (#313/#857), so a
tracked `run.json` or `events.jsonl` would churn a checkout exactly the
same way. The new test asserts that every tracked path under a
`.the-framework/` directory is one of the four committed kinds: the
ignore file, LOGS.md, a conversation, or a user's session history. It
skips itself outside a git checkout, so an installed package still tests.

No changeset: nothing here ships in `dist`, so the published package is
byte-identical.
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