Cheap-by-default healthcare benefits RAG proof of concept with a static public demo, local fixture/API proof, and an explicit AWS smoke path.
This is a no-PHI demo. It uses public/fixture benefits text and fake PII examples only. It is HIPAA-hygienic in design but is not a compliance certification.
- Open the hosted fixture demo. Visit
https://jibbscript.github.io/healthcare-rag-poc/. The GitHub Pages dashboard runs from bundled fixture playback. It shows cited answers, refusal states, trace labels, and redaction evidence without calling/chator exposing smoke API keys. - Run the local API proof.
pnpm demo-localandpnpm api-localexercise the core RAG pipeline against deterministic fixture providers. - Inspect dry-run smoke evidence.
DRY_RUN=true scripts/aws-smoke-run.shproves smoke template synthesis, cost-shape checks, index artifact build, and summary-only evidence generation without deploying AWS resources. - Run real AWS smoke only when needed. Real smoke proof is an explicit, credentialed, paid-resource workflow with typed confirmation and teardown.
Current status and evidence:
docs/architecture/current-status.mdexplains the current architecture truthfulness decisions, including sanitizedMODEL_ERROR, fixture-vs-real smoke adapters, demo modes, and historical handoff boundaries.docs/runbooks/current-verification.mdrecords fresh verification results and explicit not-run gaps.docs/runbooks/aws-smoke.mdis the operator workflow for dry-run and real AWS smoke proof.
pnpm install --frozen-lockfile
pnpm lint && pnpm typecheck && pnpm test
pnpm eval:local
pnpm demo-local
pnpm api-local
pnpm web:dev
GITHUB_PAGES=true pnpm web:build
pnpm cdk:synth:smoke && pnpm cdk:naglocal: OSS/self-hosted analogs (MinIO, DynamoDB Local, Postgres + pgvector, Qdrant, Ollama, Presidio) plus deterministic fixture providers for CI/offline runs.aws-smoke(default): private, cheap AWS shape with S3, DynamoDB, Lambda, HTTP API, gateway endpoints, and exactly one Bedrock Runtime interface endpoint. It intentionally excludes NAT Gateway, OpenSearch, Aurora, Fargate, Bedrock Knowledge Bases, and multi-AZ endpoint expansion.aws-full: explicit production extension matrix. Expensive constructs are disabled unless their feature flags are deliberately enabled.
pnpm demo-local
pnpm api-local
curl -s http://127.0.0.1:8787/chat \
-H 'content-type: application/json' \
-d '{"sessionId":"demo","message":"What is the urgent care copay?","profile":"local"}' | jqLocal web demo:
pnpm api-local
pnpm web:devThe Svelte demo console defaults to fixture playback when no API base URL is configured. Hosted GitHub Pages builds use the static fixture path and do not call /chat or expose smoke API keys. Select Local API from Demo target when running pnpm api-local plus pnpm web:dev.
Static Pages preview:
GITHUB_PAGES=true pnpm web:build
pnpm --filter @healthcare-rag/web exec vite preview --host 127.0.0.1 --port 4173 --base /healthcare-rag-poc/
pnpm demo:capture -- --mode fixture-demo --base-url http://127.0.0.1:4173/healthcare-rag-poc/ --out demo-artifacts/fixture-demoOptional Docker stack:
make demo-local-up
pnpm tsx scripts/wait-local.ts
make demo-local-down
# Destructive local cleanup only:
make demo-local-resetpnpm cdk:synth:smoke
pnpm cdk:nag
DRY_RUN=true scripts/aws-smoke-run.shReal smoke proof is run by scripts/aws-smoke-run.sh or the manual Demo capture GitHub Actions workflow, not from the hosted browser. Real smoke deploys require a pre-existing artifact bucket, a demo API key, region, and typed paid-resource confirmation:
export AWS_REGION=us-east-1
export AWS_SMOKE_ARTIFACT_BUCKET=<existing-artifact-bucket>
export SMOKE_API_KEY=<shared-demo-key-at-least-16-chars>
export CONFIRM_AWS_SMOKE_RUN=I_UNDERSTAND_THIS_CREATES_PAID_SMOKE_RESOURCES
export DRY_RUN=falseDestroy after any real smoke demo to avoid endpoint-hour charges:
export AWS_REGION=us-east-1
CONFIRM_AWS_SMOKE_DESTROY=destroy-smoke scripts/destroy-smoke.sh- Core ports and schemas:
packages/core/src - Local adapters:
packages/adapters-local/src - AWS adapters:
packages/adapters-aws/src - API handlers:
apps/api/src - CDK smoke/full constructs:
infra/cdk/lib - Evaluation cases and reports:
evals/ - Architecture dossier and runbooks:
docs/
See docs/architecture/current-status.md, docs/runbooks/current-verification.md, docs/runbooks/final-verification.md, and docs/key-tech-decisions.md for the current status, verification checklist, and defense notes. Historical implementation handoff notes remain in docs/handoff/atomic-work-units-implementation.md.