Syntology Docs

Ops & deploy

API image

  • Build: docker build -f Dockerfile.api -t syntology-api .
  • Deploy scripts under deploy/ (e.g. deploy_api_to_aws.sh) — ECR + App Runner; ONNX scorer staged from S3 before build (not in git).
  • Closure check: qc_serving_closure.py — Dockerfile COPY must cover main.py import graph (F-02 class of failures caused App Runner rollbacks).

Worker

wrangler deploy from repo root; secrets via wrangler secret put. KV token rotation helpers: rotate_kv_token.sh, deploy/push_kv_read_token.py.

Local ops

  • joblog.sh — R6 job sidecars in logs/*.status
  • ops_dashboard/ — localhost read-only monitor (AWS, Bedrock, Cloudflare, Neo4j, jobs, launchd collectors)
  • Backup: backup_corpus_to_s3.sh / run_backup_corpus.sh; Glacier archive scripts; PR volume retirement documented in PR_RETIREMENT.md on fresher trees
  • GROBID: ensure_grobid.sh, grobid_cloud.sh

QC

Session protocol: STANDARDS.md → USAGE.md → QC_PROCESS.md. On trees with the kernel: python -m syntology doctor and python -m syntology qc. Individual qc_*.py scripts remain runnable. Do not casually run graph-writing self-tests in groundwork/19.