Junjo

Junjo Platform

Junjo is a platform for building observable AI applications whose deterministic workflows, autonomous behavior, and diagnostic tooling evolve through explicit contracts.

This repository contains independently built and independently versioned components:

• `sdks/python` — the junjo Python SDK, examples, source-owned guides, and Griffe API export contract.
• `apps/studio` — Junjo AI Studio's backend, frontend, ingestion service, canonical deployment distributions, and service documentation.
• `apps/website` — the Junjo product and documentation website.
• `apps/studio/deployments` — canonical source for the minimal and VM/Caddy Studio distributions. Their standalone GitHub repositories are generated one-way release mirrors, not separate sources of truth.
• `contracts/telemetry` — language-independent telemetry schemas and conformance fixtures shared by SDK emitters and Studio consumers.
• `docs/roadmaps` — cross-platform product and implementation roadmaps.
• `docs/adr` — architectural decisions that cross component or language boundaries.

The monorepo is an integration boundary, not a runtime dependency. The Python SDK does not depend on Studio, Studio does not import an SDK implementation, and every component retains its own dependency lock, build, version, and release artifact.

Development entrypoints

Run commands from the component that owns them:

# Python SDK
cd sdks/python
uv sync --frozen --package junjo --extra dev
uv run ruff check .
uv run pytest -q
uv run ty check --error-on-warning src
uv run python docs/export_api.py validate
cd ../..

# Studio
cd apps/studio
./run-all-tests.sh
cd ../..

# Shared telemetry contract
python3 contracts/telemetry/compatibility/generate_v2_fixtures.py
python3 contracts/telemetry/compatibility/validate_contract.py
git diff --exit-code -- contracts/tele