Skip to content

refactor: rename npm scope @cacheplane → @ngaf; drop mcp from publishable group#145

Merged
blove merged 5 commits into
mainfrom
feat/ngaf-org-rename
May 1, 2026
Merged

refactor: rename npm scope @cacheplane → @ngaf; drop mcp from publishable group#145
blove merged 5 commits into
mainfrom
feat/ngaf-org-rename

Conversation

@blove
Copy link
Copy Markdown
Contributor

@blove blove commented Apr 30, 2026

Summary

  • Bulk rewrite of ~436 source files from `@cacheplane/X` to `@ngaf/X`. Affects every `package.json`, `tsconfig.base.json` paths, all TypeScript imports, READMEs. Excludes `apps/minting-service/` (proprietary) and `docs/superpowers/` (historical artifacts).
  • Drop `mcp` from the `publishable` release group; mark `packages/mcp` `private: true`. The MCP integration is deferred to a future release.
  • Update `nx.json`, `.github/workflows/publish.yml`, and `docs/RELEASE.md` to reflect the 7-package publishable set.

Motivation

`@ngaf` (Angular Agent Framework, abbreviated) is short (5 chars vs 24-char alternative), pronounceable, and identifies the project rather than the parent company. npm package names are sticky once published — better to rename now, before the first release. Pre-flight registry check confirmed `@ngaf/*` returns 404 (scope appears claimable; final verification at first-publish time).

Final publishable set

  1. `@ngaf/chat`
  2. `@ngaf/langgraph`
  3. `@ngaf/ag-ui`
  4. `@ngaf/render`
  5. `@ngaf/a2ui`
  6. `@ngaf/partial-json`
  7. `@ngaf/licensing`

Test Plan

  • Zero `@cacheplane/` references remain outside excluded paths (`apps/minting-service/`, `docs/superpowers/`)
  • All 7 publishable libs lint/test/build clean
  • `nx release publish --dry-run` produces exactly 7 tarballs (no langgraph-mcp)
  • Cross-platform native bindings preserved (`@next/swc-*` entries: 8)
  • `packages/mcp` marked `private: true` (won't accidentally publish)

Pre-existing failures (not caused by this PR)

`nx affected -t build` flags 3 builds as failing: `cockpit-docs`, `ui-react`, `minting-service`. Verified these fail identically on `origin/main`; they are NOT introduced here.

What this does NOT do

  • The actual first publish — manual; user runs locally per `docs/RELEASE.md` after this merges.
  • Trusted publishing setup — separate PR after the first publish (trusted publishing requires the packages to exist on npm first).

Design + plan

  • Spec: `docs/superpowers/specs/2026-04-30-ngaf-org-rename-design.md`
  • Plan: `docs/superpowers/plans/2026-04-30-ngaf-org-rename.md`

🤖 Generated with Claude Code

blove and others added 5 commits April 30, 2026 16:40
Bulk find/replace across 536 files (88 package.json, 15 tsconfig
paths, 448 source files). Drop packages/mcp from publishable group
(private:true) for first release; defer mcp to a future release.

After the rename merges, user manually publishes 0.0.1 of the 7
packages, then a separate PR switches the workflow to npm trusted
publishing (no token needed).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
5 tasks: pre-flight audit (verify @Ngaf is claimable on npm), bulk
find/replace across 536 files, drop mcp from publishable group with
private:true, lockfile reconciliation, final verify + PR. Plus
documented post-merge flow for first manual publish + trusted
publishing migration.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Bulk rewrite of 434 references (88 package.json, 15 tsconfig paths,
331 source files + READMEs). Excludes apps/minting-service/ and
docs/superpowers/ historical artifacts.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The MCP integration package isn't ready for first release. Mark
packages/mcp 'private: true' so it can't accidentally publish, and
remove from the synchronized publishable release group. Re-add when
the package matures.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cacheplane Ready Ready Preview, Comment Apr 30, 2026 11:54pm
cacheplane-minting-service Error Error Apr 30, 2026 11:54pm

Request Review

@blove blove merged commit cb3df6a into main May 1, 2026
14 of 15 checks passed
blove added a commit that referenced this pull request May 1, 2026
PR #145 (the @cacheplane@Ngaf scope rename) missed apps/minting-service.
Imports of @cacheplane/db and @cacheplane/licensing no longer resolve
because the path aliases were renamed to @ngaf/*; every Vercel preview
deploy of cacheplane-minting-service has been failing as a result.

This commit:
- renames the package itself from @cacheplane/minting-service to @ngaf/minting-service
- updates the 8 import sites in handlers, src/lib, scripts to @ngaf/db and @ngaf/licensing
- updates @cacheplane/* references in build.mjs comments
- mirrors the package rename in package-lock.json (surgical edit, not regenerated)

Verified: `npx nx build minting-service` succeeds; `npx vitest run` passes 42/42 in apps/minting-service.

Co-authored-by: Claude Opus 4 <noreply@anthropic.com>
@blove blove deleted the feat/ngaf-org-rename branch May 7, 2026 16:30
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