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:
shumeiko.it
2026-11-04 01:15:20 +01:00
parent a92136cd69
commit 187364dedf
2 changed files with 35 additions and 1 deletions

View 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).

View File

@@ -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 | | [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 | | [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 | | [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 ## Pending decisions
@@ -23,7 +24,7 @@ work packages wait for the answer.
| Topic | Temporary choice | Blocks | | 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 | | 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 | | 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 | | Supported platforms for v1 | Windows x64, macOS arm64 and x64, Linux x64 (glibc) | P1.3b, P1.3d |