• v0.2.1 8cf5cbde6d

    coreci-bot released this 2026-10-10 21:08:43 +00:00 | 2 commits to main since this release

    Summary

    coreci-broker v0.2.1: the broker packaged as a self-contained CLI zipapp artifact. coreci-broker-v0.2.1.pyz is built by scripts/build_cli.py with a deterministic normalization pass - the same sources rebuild byte-identical on the same environment, so the digest below is meaningful across rebuilds.

    Requirements

    REQ-22: from the first CLI-building release onward, every gitea release attaches the built coreci-broker artifact alongside the existing source archive. The upload resolves the forge token only via the sanctioned .env* files (never the process environment), asserted non-empty before the first API call.

    Verification

    The artifact sha256 in the CLI section below is computed from the attached file itself (G-017 - never an argument, never hand-pasted). Re-run the cumulative suite on the tagged commit:

    python3 -m unittest discover -s tests
    

    CLI install + usage

    1. Download coreci-broker-v0.2.1.pyz from this release's assets.
    2. Install: chmod +x coreci-broker-v0.2.1.pyz then ./coreci-broker-v0.2.1.pyz, or run it directly with python3 coreci-broker-v0.2.1.pyz (Python 3.11+).
    3. Check the build: ./coreci-broker-v0.2.1.pyz --version prints v0.2.1.
    4. The env contract (every BROKER_* variable) is documented in the README; state is anchored by BROKER_ENV_PATH - the .env file's directory is the state dir and relative paths stay CWD-relative.
    5. First boot prints BROKER_ADMIN_PASS=... exactly once and creates the .env, broker.db, and broker.audit.log state files with mode 0600; the printed admin pass is not shown again - store it.

    Artifact sha256 (computed from the attached file):

    sha256:401f0a4e673f0bf6eee6b6fee11442af52b5935121da867bd33e2109da9c18ab  coreci-broker-v0.2.1.pyz
    

    Docker usage

    docker pull git.coreci.dev/coreci/broker:v0.2.1

    docker run -p 8765:8765 -v broker-state:/state git.coreci.dev/coreci/broker:v0.2.1

    State lives on the /state volume (WORKDIR /state; the first boot generates the .env, broker.db, and broker.audit.log there) - mount a persistent volume or the admin pass and any registered apps are lost with the container.

    Downloads