docs(oss): keep the marketplace catalog in the repository (ADR-0010)
Records the decision not to generate marketplace.db at build time or ship it as a release artifact (P1.6), and adds the catalog's third-party descriptions to the pending licensing review.
This commit is contained in:
33
docs/oss/adr/0010-marketplace-catalog-in-repo.md
Normal file
33
docs/oss/adr/0010-marketplace-catalog-in-repo.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# ADR-0010: The marketplace catalog stays in the repository
|
||||
|
||||
- Status: Accepted
|
||||
- Date: 2026-11-04
|
||||
|
||||
## Context
|
||||
|
||||
`packages/marketplace/marketplace.db` is the seed catalog of the Marketplace: a 14 MB SQLite
|
||||
file with 8,129 packages (3,953 skills, 3,271 MCP servers, 905 plugins) gathered from 61 public
|
||||
source repositories, plus 18 packs, tags, a full-text index and the security-scan settings. It
|
||||
holds no user data. `scripts/build-sidecar.mjs` ships it next to `service.js`; on first start
|
||||
the sidecar copies it into the data directory and later syncs new packages from the sources.
|
||||
|
||||
The plan (P1.6) suggested generating it at build time or publishing it as a release artifact,
|
||||
so that a data file does not grow the git history.
|
||||
|
||||
## Decision
|
||||
|
||||
The catalog stays in the repository for v1. The project owner's representative chose this on
|
||||
2026-11-04 over the two alternatives:
|
||||
|
||||
- generating it at build time would need network access during every build, and two builds
|
||||
could ship different catalogs;
|
||||
- downloading it as a release artifact would leave the Marketplace empty without a network on
|
||||
first start.
|
||||
|
||||
## Consequences
|
||||
|
||||
- The Marketplace works on first start without a network.
|
||||
- Each catalog refresh adds about 14 MB to the history; refreshes stay rare. The public release is
|
||||
one commit (P2.6), so it starts with a single copy.
|
||||
- The catalog carries names, descriptions and links of third-party packages. It is added to the
|
||||
licensing review (Q6).
|
||||
Reference in New Issue
Block a user