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).
|
||||
@@ -15,6 +15,7 @@ decision, add a new record that supersedes the old one.
|
||||
| [0007](0007-memory-contract.md) | The memory contract and how it maps onto mem0 | Accepted |
|
||||
| [0008](0008-native-modules.md) | Native modules ship with a pinned Node runtime | Accepted |
|
||||
| [0009](0009-installer-server-archive.md) | The installer delivers a prebuilt server archive | Accepted |
|
||||
| [0010](0010-marketplace-catalog-in-repo.md) | The marketplace catalog stays in the repository | Accepted |
|
||||
|
||||
## Pending decisions
|
||||
|
||||
@@ -23,7 +24,7 @@ work packages wait for the answer.
|
||||
|
||||
| Topic | Temporary choice | Blocks |
|
||||
|---|---|---|
|
||||
| Licensing review (includes code copied from the Apache-2.0 `hive-mind-core` into MIT `core`, ADR-0007) | Technical license checks continue | P2.3, P2.6 |
|
||||
| Licensing review (includes code copied from the Apache-2.0 `hive-mind-core` into MIT `core`, ADR-0007, and the third-party descriptions in the marketplace catalog, ADR-0010) | Technical license checks continue | P2.3, P2.6 |
|
||||
| Product name and system identifiers | Temporary names | P1.3d, P2.6 |
|
||||
| Location of the public repository | `release.yml` is ready but has not run; the installer has no default download location (`--from`) | P2.6, P2.7 |
|
||||
| Supported platforms for v1 | Windows x64, macOS arm64 and x64, Linux x64 (glibc) | P1.3b, P1.3d |
|
||||
|
||||
Reference in New Issue
Block a user