Skip to content

packages/core: publish as @superinstance/quilt-core, and ship dist/ - #40

Merged
SuperInstance merged 2 commits into
mainfrom
feat/publish-quilt-core-under-our-scope
Oct 18, 2026
Merged

SuperInstance merged 2 commits into
mainfrom
feat/publish-quilt-core-under-our-scope

Conversation

@SuperInstance

@SuperInstance SuperInstance commented Oct 18, 2026 •

Copy link
Copy Markdown
Owner

The scope, and why

@quilt/* is not a scope this fleet owns. npm view @quilt/core is a 404 for every package in the family, so any repo depending on it cannot install:

npm error 404  '@quilt/core@*' is not in this registry.

The root package has been republished as @superinstance/quilt-core (0.3.3 is the first publish that is clean in registry metadata: no promoted devDependencies, no dead-scope peer). This PR completes the rename across the whole monorepo.

What changed

All six manifests move to the scope the fleet holds, and every @quilt/* dependency spec becomes a real version range instead of * or file::

package before after
core @quilt/core 0.3.0 @superinstance/quilt-core 0.3.4
sdk @quilt/sdk 0.2.0 @superinstance/quilt-sdk 0.2.7
cli / mcp / tui / docs @quilt/{cli,mcp,tui,docs} @superinstance/quilt-{cli,mcp,tui,docs}

The root build script selects workspaces by name (-w @quilt/core -w @quilt/sdk ...). Renaming the packages without touching it leaves npm run build building nothing, so it moves too. This was not in the brief and would have broken CI silently.

core's peerDependencies on @quilt/ai is dropped, not repointed: core only documents an AIEngine subset in comments and never imports it, so the peer was a claim on a package we cannot install.

The schema import (TS2307 / ERR_MODULE_NOT_FOUND)

packages/sdk/src/index.ts reached the schema with ../../../schemas/manifest.schema.json — outside rootDir. It resolved in-tree, so the monorepo built green, and the emitted dist/index.js kept the same specifier. After publish the tarball has no schemas/ dir, so the import resolved to node_modules/schemas/ — outside the package — and threw:

FAILED: ERR_MODULE_NOT_FOUND | Cannot find module
'.../node_modules/schemas/manifest.schema.json' imported from
'.../@superinstance/quilt-sdk/dist/index.js'

The schema now ships inside the SDK (src/schemas/ -> dist/schemas/), covered by the existing files: ["dist"].

Verified on this branch

npm install                -> exit 0   (228 packages)
npm run build              -> exit 0   (all 5 workspaces)
npm test                   -> exit 0   core 8 files / sdk 79 pass 0 fail / tui 15 pass 0 fail

published-tarball simulation (dist + README.md only, per files):
  import() OK, 23 exports, manifestSchema resolves (draft-07)

sdk@0.2.7 in a publish-shaped copy OUTSIDE the monorepo
(no devDependencies in the manifest, deps only), installed against the
PUBLISHED @superinstance/quilt-core@0.3.3 from the registry:
  npm test -> # tests 79 / # pass 79 / # fail 0

Deliberately out of scope

docs/ guides, landing/ marketing pages, RELEASE-*.md and quilt_worker/quilt_core/* still say @quilt/*. They are prose and vendored build output, not a package boundary; folding them in would bury the rename. Flagged as follow-up doc debt.

Not merged. Left for review.

SuperInstance and others added 2 commits October 17, 2026 23:56
The @quilt npm scope belongs to quiltdata, so @quilt/core could never be
published by us -- and every package in the family that depends on it
fails to install with:  npm error 404  @quilt/core@* is not in this registry.

Also adds a files field. There was none, so npm fell back to .gitignore,
which lists dist/ -- the tarball shipped src/ without the build, and main
named a file that was not in the package. That is the same defect as the
one fixed in Motifcode4quilt today, and it is why 0.3.0 was published
broken and deprecated in the same hour.
…import

PR #40 renamed packages/core only. That leaves the monorepo internally
inconsistent and the SDK broken once published, so this completes the
scope across every package that names it.

Manifests:
- core  -> @superinstance/quilt-core 0.3.4
- sdk   -> @superinstance/quilt-sdk  0.2.7
- cli/mcp/tui/docs follow
- every @quilt/* dependency spec repointed at @superinstance/* with real
  ranges (^0.3.3 etc), replacing '*' and file: links

The root build script selects workspaces BY NAME
(-w @quilt/core -w @quilt/sdk ...). Renaming the packages without
touching it leaves npm run build building nothing, so it moves too.

Schema import (TS2307 / ERR_MODULE_NOT_FOUND):
src/index.ts reached the schema with '../../../schemas/manifest.schema.json'
-- outside rootDir. It resolved in-tree, so the monorepo built green, and
the emitted dist/index.js kept the same specifier. After publish, the
tarball has no schemas/ dir, so the import resolved to
node_modules/schemas/ -- outside the package -- and import() threw
ERR_MODULE_NOT_FOUND. The schema now ships inside the SDK
(src/schemas -> dist/schemas) and is covered by the existing files:[dist].

core's peerDependencies on @quilt/ai is dropped rather than repointed:
core only documents an AIEngine subset in comments and never imports it,
so the peer was a claim on a package we cannot install.

Verified on this branch:
  npm install                 -> exit 0
  npm run build               -> exit 0 (all 5 workspaces)
  npm test                    -> exit 0 (core 8 files, sdk 79/79, tui 15/15)
  published-tarball sim       -> import() OK, 23 exports, manifestSchema resolves
  sdk@0.2.7 in a publish-shaped copy outside the monorepo, installed
  against PUBLISHED @superinstance/quilt-core@0.3.3 -> npm test 79/79 pass

Remaining, deliberately out of this rename PR: docs/ guides, landing/
marketing pages and RELEASE-*.md still say @quilt/*. Tracked in the PR body.
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