Files
waggle-os/docs/oss/adr/0010-marketplace-catalog-in-repo.md
shumeiko.it 187364dedf 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.
2026-11-04 01:15:20 +01:00

1.4 KiB

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