diff --git a/docs/oss/adr/0010-marketplace-catalog-in-repo.md b/docs/oss/adr/0010-marketplace-catalog-in-repo.md new file mode 100644 index 0000000..d7e720b --- /dev/null +++ b/docs/oss/adr/0010-marketplace-catalog-in-repo.md @@ -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). diff --git a/docs/oss/adr/README.md b/docs/oss/adr/README.md index a0f2292..b422508 100644 --- a/docs/oss/adr/README.md +++ b/docs/oss/adr/README.md @@ -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 |