Files

Sharang Parnerkar 512b7a0f6c phase0: add architecture guardrails, CI gates, per-language AGENTS.md

Non-negotiable structural rules that apply to every Claude Code session in
this repo and to every commit, enforced via three defense-in-depth layers:

  1. PreToolUse hook in .claude/settings.json blocks any Write/Edit that
     would push a file past the 500-line hard cap. Auto-loads for any
     Claude session in this repo regardless of who launched it.
  2. scripts/githooks/pre-commit (installed via scripts/install-hooks.sh)
     enforces the LOC cap, freezes migrations/ unless [migration-approved],
     and protects guardrail files unless [guardrail-change] is present.
  3. .gitea/workflows/ci.yaml gets loc-budget + guardrail-integrity jobs,
     plus mypy --strict on new Python packages, tsc --noEmit on Node
     services, and a syft+grype SBOM scan.

Per-language conventions are documented in AGENTS.python.md / AGENTS.go.md /
AGENTS.typescript.md at the repo root — layering (router->service->repo for
Python, hexagonal for Go, colocation for Next.js), tooling baseline, and
explicit "what you may NOT do" lists.

Adds scripts/check-loc.sh (soft 300 / hard 500, reports 205 hard and 161
soft violations in the current codebase) plus .claude/rules/loc-exceptions.txt
(initially empty — the list is designed to shrink over time).

Per-service READMEs for all 10 services + PHASE1_RUNBOOK.md for the
backend-compliance refactor. Skeleton packages (compliance/{domain,
repositories,schemas}) are the landing zone for the clean-arch rewrite that
begins in Phase 1.

CLAUDE.md is prepended with the six non-negotiable rules.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-07 13:09:26 +02:00

Dockerfile

fix(training): resolve Gin route conflicts and fix TTS Dockerfile

2026-02-16 22:04:47 +01:00

main.py

Switch MinIO from local to Hetzner Object Storage

2026-03-06 14:07:28 +01:00

README.md

phase0: add architecture guardrails, CI gates, per-language AGENTS.md

2026-04-07 13:09:26 +02:00

requirements.txt

fix(training): resolve Gin route conflicts and fix TTS Dockerfile

2026-02-16 22:04:47 +01:00

slide_renderer.py

feat(training): add Media Pipeline — TTS Audio, Presentation Video, Bulk Generation

2026-02-16 21:45:05 +01:00

storage.py

feat(training): add Media Pipeline — TTS Audio, Presentation Video, Bulk Generation

2026-02-16 21:45:05 +01:00

tts_engine.py

feat(training): add Media Pipeline — TTS Audio, Presentation Video, Bulk Generation

2026-02-16 21:45:05 +01:00

video_generator.py

feat(training): add Media Pipeline — TTS Audio, Presentation Video, Bulk Generation

2026-02-16 21:45:05 +01:00

README.md

compliance-tts-service

Python service generating German-language audio/video training materials using Piper TTS + FFmpeg. Outputs are stored in Hetzner Object Storage (S3-compatible).

Port: 8095 (container: bp-compliance-tts) Stack: Python 3.12, Piper TTS (de_DE-thorsten-high.onnx), FFmpeg, boto3.

Files

main.py — FastAPI entrypoint
tts_engine.py — Piper wrapper
video_generator.py — FFmpeg pipeline
storage.py — S3 client

Run locally

cd compliance-tts-service
pip install -r requirements.txt
# Piper model + ffmpeg must be available on PATH
uvicorn main:app --reload --port 8095

Tests

0 test files today. Phase 4 adds unit tests for the synthesis pipeline (mocked Piper + FFmpeg) and the S3 client.

Architecture

Follow ../AGENTS.python.md. Keep the Piper model loading behind a single service instance — not loaded per request.