chore!: rename @btravstack/start to @btravstack/start-core - #32
Merged
Conversation
The kernel package sharing the repo's bare name was ambiguous next to its start-http/start-amqp/start-temporal siblings. Nothing is published yet, so the rename is free — after first publish it would be a deprecation dance. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Renames the kernel package from @btravstack/start (packages/start) to @btravstack/start-core (packages/start-core) so the package family reads consistently alongside start-http, start-amqp, and start-temporal, with mechanical reference rewrites across the monorepo.
Changes:
- Renamed the kernel workspace/package to
packages/start-core/@btravstack/start-coreand updated exports/build/test configs accordingly. - Rewrote imports, workspace deps/peers, docs/changesets, examples, and CI comments to reference
@btravstack/start-core. - Regenerated
pnpm-lock.yamlto reflect the workspace rename.
Reviewed changes
Copilot reviewed 63 out of 99 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| README.md | Updates root documentation and examples to import/install @btravstack/start-core. |
| pnpm-lock.yaml | Updates workspace links/dependency graph after the package rename. |
| packages/start-temporal/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| packages/start-temporal/src/temporal-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| packages/start-temporal/src/activity-units.ts | Updates kernel type imports to @btravstack/start-core. |
| packages/start-temporal/README.md | Updates docs to reference @btravstack/start-core. |
| packages/start-temporal/package.json | Updates dev/peer deps and description to @btravstack/start-core. |
| packages/start-temporal/CLAUDE.md | Updates peer dependency documentation to @btravstack/start-core. |
| packages/start-http/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| packages/start-http/src/http-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| packages/start-http/README.md | Updates docs to reference @btravstack/start-core. |
| packages/start-http/package.json | Updates dev/peer deps and description to @btravstack/start-core. |
| packages/start-http/CLAUDE.md | Updates peer dependency documentation to @btravstack/start-core. |
| packages/start-core/vitest.config.ts | Adds vitest config for the renamed kernel package. |
| packages/start-core/tsconfig.test-d.json | Adds type-test tsconfig for *.test-d.ts checks. |
| packages/start-core/tsconfig.json | Adds package tsconfig under the new workspace path. |
| packages/start-core/src/with-app.ts | Adds/relocates the withApp test harness under start-core. |
| packages/start-core/src/with-app.spec.ts | Adds/relocates tests covering withApp behavior. |
| packages/start-core/src/vitest.d.ts | Registers @unthrown/vitest matchers for the package. |
| packages/start-core/src/units.ts | Kernel unit ambient record + unit registry implementation under new package. |
| packages/start-core/src/units.spec.ts | Tests for unit ambient record and unit registry behavior. |
| packages/start-core/src/testing.ts | @btravstack/start-core/testing barrel exports for test utilities. |
| packages/start-core/src/test-runtime.ts | In-memory runtime fixture under start-core. |
| packages/start-core/src/test-runtime.spec.ts | Tests for the in-memory runtime fixture. |
| packages/start-core/src/start.ts | Kernel start/lifecycle implementation under renamed package. |
| packages/start-core/src/start.test-d.ts | Type-level gate tests for runtime needs checking. |
| packages/start-core/src/start.spec.ts | Kernel lifecycle behavior tests under start-core. |
| packages/start-core/src/runtime.ts | Runtime contract types and RuntimeStartFailed under start-core. |
| packages/start-core/src/run-main.ts | runMain process-exit-code mapping under start-core. |
| packages/start-core/src/run-main.spec.ts | Tests for runMain exit-code logic. |
| packages/start-core/src/process-handlers.ts | Signal + uncaught handler installation utilities. |
| packages/start-core/src/process-handlers.spec.ts | Tests for handler installation/removal semantics. |
| packages/start-core/src/probes.ts | Probe server implementation under renamed kernel package. |
| packages/start-core/src/probes.spec.ts | Tests for probe server behavior and error-listener contract. |
| packages/start-core/src/phase.ts | Phase tracker implementation under start-core. |
| packages/start-core/src/phase.spec.ts | Tests for phase tracker monotonicity behavior. |
| packages/start-core/src/invariants.spec.ts | End-to-end invariants suite for kernel lifecycle/probes/drain. |
| packages/start-core/src/index.ts | Public API surface for @btravstack/start-core. |
| packages/start-core/src/fake-clock.ts | Deterministic clock implementation for tests. |
| packages/start-core/src/fake-clock.spec.ts | Tests for fake clock timing + abort behavior. |
| packages/start-core/src/events.ts | Kernel event types + sinks under start-core. |
| packages/start-core/src/events.spec.ts | Tests for event rendering and sink safety. |
| packages/start-core/src/drain.ts | Drain algorithm implementation under start-core. |
| packages/start-core/src/drain.spec.ts | Tests for drain ordering, accounting, and defect propagation. |
| packages/start-core/src/docs-examples.test-d.ts | Compiles README examples for drift prevention under new path/name. |
| packages/start-core/src/deferred.ts | Deferred helper used by kernel/test fixtures. |
| packages/start-core/src/clock.ts | Clock contract + system clock implementation. |
| packages/start-core/src/clock.spec.ts | Tests for system clock timing/abort semantics. |
| packages/start-core/README.md | Package README updated for @btravstack/start-core. |
| packages/start-core/package.json | Package metadata/exports updated for @btravstack/start-core. |
| packages/start-core/LICENSE | License file under the renamed package. |
| packages/start-core/CLAUDE.md | Kernel-internals guidance updated for packages/start-core. |
| packages/start-amqp/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| packages/start-amqp/src/message-units.ts | Updates kernel type imports to @btravstack/start-core. |
| packages/start-amqp/src/amqp-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| packages/start-amqp/README.md | Updates docs to reference @btravstack/start-core. |
| packages/start-amqp/package.json | Updates dev/peer deps and description to @btravstack/start-core. |
| packages/start-amqp/CLAUDE.md | Updates peer dependency documentation to @btravstack/start-core. |
| examples/README.md | Updates examples index text to reference @btravstack/start-core. |
| examples/order-worker/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| examples/order-worker/src/queue-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| examples/order-worker/src/needs-gate.test-d.ts | Updates needs-gate type test to import start from @btravstack/start-core. |
| examples/order-worker/src/main.ts | Updates entrypoint imports to @btravstack/start-core. |
| examples/order-worker/README.md | Updates example README to @btravstack/start-core naming. |
| examples/order-worker/package.json | Updates workspace dependency to @btravstack/start-core. |
| examples/order-temporal/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| examples/order-temporal/src/temporal-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| examples/order-temporal/src/needs-gate.test-d.ts | Updates needs-gate type test to @btravstack/start-core. |
| examples/order-temporal/src/main.ts | Updates entrypoint imports to @btravstack/start-core. |
| examples/order-temporal/README.md | Updates example README to @btravstack/start-core naming. |
| examples/order-temporal/package.json | Updates workspace dependency to @btravstack/start-core. |
| examples/order-temporal-contract/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-infrastructure/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-domain/README.md | Updates example README heading and kernel references to @btravstack/start-core. |
| examples/order-config/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-application/src/logger.ts | Updates currentUnit import to @btravstack/start-core. |
| examples/order-application/README.md | Updates kernel touchpoint docs to @btravstack/start-core. |
| examples/order-application/package.json | Updates workspace dependency to @btravstack/start-core. |
| examples/order-api/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| examples/order-api/src/needs-gate.test-d.ts | Updates needs-gate type test to @btravstack/start-core. |
| examples/order-api/src/main.ts | Updates entrypoint imports to @btravstack/start-core. |
| examples/order-api/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-api/package.json | Updates workspace dependency to @btravstack/start-core. |
| examples/order-api-contract/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-amqp/src/test-fixtures.ts | Updates kernel imports to @btravstack/start-core. |
| examples/order-amqp/src/needs-gate.test-d.ts | Updates needs-gate type test to @btravstack/start-core. |
| examples/order-amqp/src/main.ts | Updates entrypoint imports to @btravstack/start-core. |
| examples/order-amqp/src/amqp-runtime.ts | Updates kernel type imports to @btravstack/start-core. |
| examples/order-amqp/README.md | Updates example README heading to @btravstack/start-core. |
| examples/order-amqp/package.json | Updates workspace dependency to @btravstack/start-core. |
| examples/order-amqp-contract/README.md | Updates example README heading to @btravstack/start-core. |
| CLAUDE.md | Updates authoritative spec references from start to start-core package naming/paths. |
| .github/workflows/ci.yml | Updates CI comment referencing the renamed package path. |
| .changeset/start-temporal.md | Updates changeset copy to reference @btravstack/start-core. |
| .changeset/start-http.md | Updates changeset copy to reference @btravstack/start-core. |
| .changeset/start-amqp.md | Updates changeset copy to reference @btravstack/start-core. |
| .changeset/initial-kernel.md | Renames kernel package in changeset frontmatter and copy to @btravstack/start-core. |
| .changeset/drop-version-const.md | Renames kernel package in changeset frontmatter to @btravstack/start-core. |
| .changeset/drain-and-shutdown-fixes.md | Renames kernel package in changeset frontmatter to @btravstack/start-core. |
Files not reviewed (1)
- pnpm-lock.yaml: Generated file
Suppressed comments (1)
packages/start-core/README.md:6
- The npm badge still uses the shields.io path for
@btravstack/start, so the version shown won’t correspond to this package name. Update it to@btravstack/start-core.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.
packages/start/@btravstack/startbecomespackages/start-core/@btravstack/start-core, so the family reads consistently: the kernel isstart-core, the runtime adapters arestart-http/start-amqp/start-temporal, and the bare namestartstays the repo, not a package.None of the four packages is published to npm yet, so the rename costs nothing — after first publish it would mean a deprecate-and-republish dance.
Mechanical:
git mvplus 109 reference rewrites (imports, workspace deps and peers, changesets, READMEs, CLAUDE.md files, CI comment), with a lookahead sostart-http/start-amqp/start-temporalare untouched. Lockfile regenerated.Verified locally: build, typecheck, lint, knip green; 99/100 start-core tests pass — the one failure ("binds 9000 when no probe port is given") also fails on untouched main on this machine because ZscalerTunnel squats on 127.0.0.1:9000, and is unrelated to this change.
🤖 Generated with Claude Code