cv-deploy

Deterministic application-deploy pipeline for CV-Hub-hosted repos, running on fleet machines. Two binaries build from one codebase and link the same deploy-core library:

• cv-deployd - the daemon: long-polls the orchestrate deploy queue (verifying a task token before anything runs) and optionally polls a repo head for continuous deployment, then drives the pipeline.
• cv-deploy - the operator CLI: init, plan, run, migrate, rollback, status, daemon.

A healthy production deploy is boring and code-only:

fetch -> migrate -> build -> switch -> restart -> health -> report

No LLM is in that path. The optional cv-deploy agent (a cv-agent profile) supervises only the edges: halted states, diagnosis, and human-facing reporting.

Status

P1 scaffold. This repo currently ships the toolchain, the config schemas and their merge, the journal format with a deterministic resume decision table, the exit-code registry, and CLI/daemon skeletons with real argument parsing. The pipeline engine (P3), migration tracker (P2), and daemon loop (P4) are interfaces with stubs; see docs/WORKPLAN.md and docs/PROMPT_PACK.md for the full plan.

Develop

npm install
npm run build        # tsc -> dist/
npm test             # vitest
npm run verify-pack  # assert the publishable dist is complete and clean

Layout

src/core/     deploy-core library: steps, journal + resume, ulid, pipeline stage
              contracts (fetch, migrate, build, release, health, adapters)
src/config/   repo descriptor + target config schemas (zod) and their merge
src/cli/      cv-deploy operator CLI
src/daemon/   cv-deployd daemon binary
test/         vitest suites (exhaustive: config merge, journal resume, schemas, cli)
systemd/      hardened cv-deployd.service unit
docs/         WORKPLAN.md (architecture), PROMPT_PACK.md (build prompts)

See SPEC.md for the condensed contract and CLAUDE.md for conventions.

License

Apache-2.0. Copyright 2026 Control Vector LLC.