Vapora/reflection/modes/deploy_vapora_service.ncl
Jesús Pérez 75e5ebd9a2
Some checks failed
Documentation Lint & Validation / Markdown Linting (push) Has been cancelled
Documentation Lint & Validation / Validate mdBook Configuration (push) Has been cancelled
Documentation Lint & Validation / Content & Structure Validation (push) Has been cancelled
mdBook Build & Deploy / Build mdBook (push) Has been cancelled
Nickel Type Check / Nickel Type Checking (push) Has been cancelled
Rust CI / Security Audit (push) Has been cancelled
Rust CI / Check + Test + Lint (nightly) (push) Has been cancelled
Rust CI / Check + Test + Lint (stable) (push) Has been cancelled
Documentation Lint & Validation / Lint & Validation Summary (push) Has been cancelled
mdBook Build & Deploy / Documentation Quality Check (push) Has been cancelled
mdBook Build & Deploy / Deploy to GitHub Pages (push) Has been cancelled
mdBook Build & Deploy / Notification (push) Has been cancelled
chore: ontology sync + 4 NCL ADRs + landing page update
on+re:
  - core.ncl: 5 new Practice nodes (notification-channels,
    vapora-capabilities, agent-hot-reload-stable-identity,
    merkle-audit-trail, notification-channels) + 5 new edges;
    knowledge-graph-execution-history updated with HNSW+BM25+RRF
  - state.ncl: production-readiness blocker/catalyst updated (hot-reload
    complete, BudgetManager/LLMRouter still require restart);
    ontoref-integration catalyst updated (vapora-ontology/reflection
    crates, api-catalog.json, nickel contracts)

  ADRs (NCL):
  - adr-013: KG hybrid search — HNSW+BM25+RRF, rejected in-process scan
  - adr-014: capability packages — AgentDefinition→vapora-shared,
    DashMap shard-before-await constraint
  - adr-015: Merkle audit trail — SHA-256 hash chain, rejected HMAC
  - adr-016: agent hot-reload — stable_id=role, learning_profiles survive
    drain, BudgetManager excluded from reload scope

  landing page:
  - 2 new feature boxes: VCS-Agnostic Worktree (jj/git), Ontology Protocol
  - KG box: 20→28 tests, HNSW+BM25+RRF description
  - Agents box: 71→82 tests, hot-reload + stable_id
  - tech stack: Rust 21→23 crates, added jj, Radicle, ontoref badges
  - status badge: 620→691 tests
2026-04-07 21:06:48 +01:00

92 lines
3.3 KiB
Text

let s = import "reflection/schema.ncl" in
{
id = "deploy_vapora_service",
trigger = "manual | NATS:ecosystem.provisioning.ready",
preconditions = [
"Provisioning scaffold complete (provisioning.ready event received)",
"async-first: no blocking calls in deployment scripts",
"budget-boundary: deployment cost within approved limits",
],
steps = [
{
id = "validate_ontology",
action = "Validate vapora ontology coherence before deployment",
cmd = "nu {stratumiops_dir}/scripts/ontology-validate.nu {vapora_dir}/.ontology",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [],
},
{
id = "build_release",
action = "Build vapora-backend in release mode",
cmd = "cargo build --release -p vapora-backend 2>&1",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [{ step = "validate_ontology", kind = 'OnSuccess }],
},
{
id = "run_tests",
action = "Run workspace tests before deploy",
cmd = "cargo test --workspace --all-features 2>&1",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [{ step = "build_release", kind = 'OnSuccess }],
},
{
id = "build_docker",
action = "Build and tag the Docker image for this service version",
cmd = "docker build -f {vapora_dir}/docker/{service_name}.Dockerfile -t vapora/{service_name}:{version} {vapora_dir}",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [{ step = "run_tests", kind = 'OnSuccess }],
},
{
id = "push_image",
action = "Push Docker image to registry",
cmd = "docker push vapora/{service_name}:{version}",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [{ step = "build_docker", kind = 'OnSuccess }],
},
{
id = "apply_kubernetes",
action = "Apply Kubernetes manifests for the service",
cmd = "kubectl apply -f {vapora_dir}/kubernetes/{service_name}/ --context {k8s_context}",
actor = 'Agent,
on_error = { strategy = 'Stop },
depends_on = [{ step = "push_image", kind = 'OnSuccess }],
},
{
id = "verify_rollout",
action = "Wait for rollout to complete and verify pod health",
cmd = "kubectl rollout status deployment/{service_name} --context {k8s_context} --timeout=300s",
actor = 'Agent,
on_error = { strategy = 'Retry },
depends_on = [{ step = "apply_kubernetes", kind = 'OnSuccess }],
},
{
id = "notify_ecosystem",
action = "Publish project-state-changed event to ecosystem NATS",
cmd = "nu {stratumiops_dir}/scripts/nats-publish.nu project-created --project_name {service_name} --project_dir {vapora_dir} --stack rust-tokio --type service",
actor = 'Agent,
on_error = { strategy = 'Continue },
depends_on = [{ step = "verify_rollout", kind = 'OnSuccess }],
},
],
postconditions = [
"Service pods are Running in the target Kubernetes cluster",
"Deployment visible in ecosystem NATS as project.created event",
"Budget ledger updated with deployment compute cost",
],
} | (s.Mode String)