Skip to content

#1156 Rename packages to publishable names - #1157

Merged
williamthorsen merged 8 commits into
mainfrom
1156
Aug 3, 2026
Merged

#1156 Rename packages to publishable names#1157
williamthorsen merged 8 commits into
mainfrom
1156

Conversation

@williamthorsen

@williamthorsen williamthorsen commented Aug 3, 2026

Copy link
Copy Markdown
Owner

What

Renames CodeAssembly packages in preparation for their initial publication. The package responsible for deploying and syncing agent guidance is now called codeassembly.

Why

Packages were initially created under working titles. The new names are those chosen for publication.

Details

♻️ Refactoring

Five packages take new names:

Directory Name Bin
agents codeassembly codeassembly
fleet codeassembly-fleet none
foreman codeassembly-foreman none
kb @williamthorsen/kb kb
lifecycle codeassembly-lifecycle none
mcp codeassembly-mcp codeassembly-mcp
run-core codeassembly-run-core none

run-core drops its codeassembly-runs bin along with the 200-line src/cli.ts behind it: the package is consumed only as a library, and the entry point had no imports, no export subpath, and no tests.

🧪 Tests

HOOK_SENTINEL gains a test asserting its literal value. Every other assertion in that file compares against the imported constant and would pass for any value, so pinning the literal is what makes the freeze enforceable. The constant's description records why the value cannot track the CLI's name: it is matched against hook entries already written into users' harness configs, and a new value would leave configure-hooks adding a parallel set alongside them, firing every session-lifecycle event twice.

⚙️ Tooling

agents, mcp, and run-core declare legacyIdentities in .config/release-kit.config.ts, so baseline-tag lookup and changelog attribution still resolve their history under the agents-v, mcp-v, and run-core-v prefixes.

📚 Documentation

Package READMEs, .agents/PROJECT.md, and nine shipped SKILL.md files name the new packages and the codeassembly install and codeassembly sync commands. The bin-wrapper convention, previously documented in run-core's README alongside the bin it retires, moves to packages/agents/README.md; the kb and mcp wrappers point there.

Closes #1156

Renames the workspace packages off the unreachable `@codeassembly` scope. The CLI package is now `codeassembly` and the knowledge-base library is `@williamthorsen/kb`, which declares public publish access; `codeassembly-fleet`, `codeassembly-foreman`, `codeassembly-lifecycle`, `codeassembly-mcp`, and `codeassembly-run-core` take unscoped names.
Removes the `codeassembly-runs` binary and its command module; `codeassembly-run-core` is consumed as a library only.
The CLI is invoked as `codeassembly` rather than `codeassembly-agents`, in its binary name, its usage text, and the commands its messages tell you to run.
The hook sentinel's value is pinned by a test and documented as frozen, so a later rename cannot silently strand the hook entries already written into users' harness configs.
Release tooling resolves each renamed workspace's baseline tag and keeps its changelog history attributed to it, so `codeassembly`, `codeassembly-mcp`, and `codeassembly-run-core` release from the versions they already reached rather than starting over. `codeassembly-fleet` and `codeassembly-foreman` are excluded from release processing.
Documentation and shipped guidance name the renamed packages and tell readers to run `codeassembly` rather than `codeassembly-agents`.
Import statements and `package.json` keys are reordered to match where the renamed package names sort.
The constant's doc comment states why the sentinel value is frozen; the pinning test's comment states why it asserts a literal rather than the constant.
@williamthorsen williamthorsen added the refactoring Improvement to code without change in functionality label Aug 3, 2026
@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

Dependency audit

Production dependency audit passed.

@williamthorsen williamthorsen self-assigned this Aug 3, 2026
@williamthorsen
williamthorsen marked this pull request as ready for review August 3, 2026 12:18
@williamthorsen
williamthorsen merged commit f508636 into main Aug 3, 2026
3 checks passed
@williamthorsen
williamthorsen deleted the 1156 branch August 3, 2026 12:27
williamthorsen added a commit that referenced this pull request Aug 4, 2026
…e-v0.2.2 codeassembly-v0.4.0 factory-v0.2.2 codeassembly-mcp-v0.2.2

codeassembly-v0.4.0
- #1153 feat: Make codeassembly and kb CLI tools publishable (#1164)
- #1091 fix: Anchor a project-deployed link where its target deploys (#1159)
- #1156 refactor: Rename packages to publishable names (#1157)
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- refactor: Refine typescript-preferences
- #1150 fix: State doc-description form and make comment mood opt-in (#1151)
- deps: Upgrade first-party linting deps to latest version
- #1137 feat: Establish personal rulebooks for code layout and TypeScript preferences (#1144)
- #1126 feat: Check a package's own guidance content before it ships (#1138)
- refactor: Fix lint
- tooling: Remove redundant lint rules
- #1133 fix: Reject an anchor link that names no heading (#1135)
- #1122 feat: Capture lede decisions as an accumulating corpus (#1132)
- #1125 feat: Honor invocation tokens in rulebook bodies (#1129)
- #1107 feat: Render rulebook links and path tokens per harness (#1124)
- #1115 feat: Sync guidance at build and install so an upgrade cannot leave it stale (#1123)
- #1114 feat: Adopt a dependency's guidance by naming the package (#1121)
- #1088 feat: Deliver project ambient rulebooks per harness (#1113)
- #1087 refactor: Rename the authoring rulebook and mark its enforced rules (#1092)
- #1095 tooling: Move compilation out of the install lifecycle into a bootstrap step (#1102)
- #1094 refactor: Remove the ambient ripgrep dependency from the test suite (#1097)
- deps: Upgrade all deps to latest version
- tooling: Upgrade all deps to latest version & modernize configs
- refactor: Fix lint
- #1077 feat: Show the proposed edit above post-review menu options (#1078)
- #1068 feat: Deliver ambient rulebooks mechanically, retiring GLOBAL.md (#1075)
- #1069 feat: Add a no-second-person rule to the lede-voice doctrine (#1070)
- #1050 feat: Add a redundancy rule to the lede-voice doctrine (#1058)
- #1035 internal: Add lifecycle workspace with the canonical envelope, vocabulary & lane fold (#1049)
- #1006 internal: Extend lifecycle-event instrumentation to five high-traffic skills (#1034)
- #1028 feat: Rule out absence-of-removed-code tests (#1032)
- #114 feat: Let reviewers emit gated insights into review artifacts (#1031)
- #1027 internal: Retire input.received and redundant skill.progress emits (#1030)
- #1026 fix: Name the side effects an approval ask authorizes (#1029)
- #1022 fix: Normalize action and question label identifiers across asks blocks (#1025)

factory-v0.2.2
- #1156 refactor: Rename packages to publishable names (#1157)
- deps: Upgrade all deps to latest version
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- tooling: Remove redundant lint rules
- deps: Upgrade deps to latest version
- deps: Upgrade all deps to latest version
- deps: Upgrade all deps to latest version
- tooling: Upgrade all deps to latest version & modernize configs
- refactor: Fix lint
- deps: Upgrade all deps to latest version

kb-v0.3.0
- #1153 feat: Make codeassembly and kb CLI tools publishable (#1164)
- #1156 refactor: Rename packages to publishable names (#1157)
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- tooling: Remove redundant lint rules
- #1095 tooling: Move compilation out of the install lifecycle into a bootstrap step (#1102)
- tooling: Upgrade all deps to latest version & modernize configs
- refactor: Fix lint

codeassembly-lifecycle-v0.2.0
- #1153 feat: Make codeassembly and kb CLI tools publishable (#1164)
- #1156 refactor: Rename packages to publishable names (#1157)
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- tooling: Remove redundant lint rules
- #1095 tooling: Move compilation out of the install lifecycle into a bootstrap step (#1102)
- tooling: Upgrade all deps to latest version & modernize configs
- #1038 feat: Add the read-only git adapter for worktree and base-branch ground truth (#1059)
- #1051 feat: Bound fold memory and rescan cost with a retention window (#1057)
- #1035 internal: Add lifecycle workspace with the canonical envelope, vocabulary & lane fold (#1049)

codeassembly-mcp-v0.2.2
- deps: Upgrade all deps to latest version
- #1156 refactor: Rename packages to publishable names (#1157)
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- #1095 tooling: Move compilation out of the install lifecycle into a bootstrap step (#1102)
- tooling: Upgrade all deps to latest version & modernize configs
- refactor: Fix lint

codeassembly-run-core-v0.2.2
- #1156 refactor: Rename packages to publishable names (#1157)
- #1152 tooling: Run every test in the default gate, classified by what it reaches (#1155)
- #1110 tooling: Migrate Vitest to nmr's centralized model (#1154)
- #1095 tooling: Move compilation out of the install lifecycle into a bootstrap step (#1102)
- tooling: Upgrade all deps to latest version & modernize configs
- refactor: Fix lint
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

refactoring Improvement to code without change in functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename packages off the unavailable @codeassembly scope to publishable names

1 participant