catalogsync

command
v0.25.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 30, 2026 License: GPL-3.0 Imports: 14 Imported by: 0

Documentation

Overview

Command catalogsync vendors the CashPilot web catalog (services/**.yml) into this repository and, in -check mode, reports when the vendored copy has drifted from it.

The web repository is the single source of truth for the catalog. Desktop used to keep its own hand-edited copy, which went stale silently: entries kept a status the web catalog had already retired, capabilities the container needs to earn were missing, and new entries never arrived at all.

Everything Desktop keeps that the web catalog does not is declared in catalog-overlay/ and applied on top of the copied file. See catalog-overlay/README.md for the mechanism and for every delta we currently declare.

Usage:

go run ./cmd/catalogsync                 # fetch GeiserX/CashPilot@main, rewrite services/
go run ./cmd/catalogsync -check          # same, but only report drift
go run ./cmd/catalogsync -src ../CashPilot   # use a local checkout instead of fetching
go run ./cmd/catalogsync -ref v1.37.0    # any branch, tag or commit SHA

-check exits 0 when the two agree, 1 when they have really drifted, and 2 when the comparison could not be made at all (no network, a ref that does not exist, an overlay that does not parse). The weekly workflow relies on that difference: a codeload outage must not be announced as a catalog that changed.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL