InKCre Core

Python backend implementation of InKCre, built with FastAPI, SQLModel, APScheduler, and PostgreSQL.

Local Start

pdm install -G dev --frozen-lockfile
svc dev ensure database --repo . --json

This starts the complete peer runtime: pgvector, deterministic database initialization, core-py, and PostgREST. Committed configuration uses local Docker; ignored svc.local.json may select a validated SSH Docker provider. For Python-only iteration, run pdm run check, then pdm run dev against an initialized database.

pdm run check is the hermetic repository contract used by CI: frozen dependency checks, migration containment, formatting, lint, and the complete unit-test suite.

Developer setup and shared-skill notes: CONTRIBUTING.md

Documentation Map

If docs/_shared/ is missing, run git submodule update --init --recursive before following shared-doc links.

• Agent operating guide: AGENTS.md
• Working protocol: run svc status . --json and query the installed SVC 10.0.1 corpus.
• Shared Hub/Spoke operations: docs/_shared/00-meta/
• Shared product truth: docs/_shared/10-prd/index.md
• Shared product glossary: docs/_shared/10-prd/glossary.md
• Shared cross-unit technical truth: docs/_shared/20-product-tdd/
• Local unit architecture: docs/30-unit-tdd/business-pipeline-and-authority.md
• Deployment and runtime truth: docs/40-deployment/README.md
• Agent-owned volatile task workspaces: tasks/

Generated Artifacts

• OpenAPI schema: docs/openapi.json
• Regenerate locally with pdm run python scripts/generate-openapi.py.
• The repository does not publish hosted API documentation automatically.