codeflash-admin/codeflash-internal
1
0
Fork 0
mirror of https://github.com/codeflash-ai/codeflash-internal.git synced 2026-05-04 18:25:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
codeflash-internal/tiles/codeflash-internal-rules/rules/architecture.md
Kevin Turcios dfc56f19a0 feat: add Tessl tiles for codeflash-internal (rules, docs, skills) 
Three private tiles published to the codeflash workspace:
- codeflash-internal-rules: 6 eager rules (code-style, architecture,
  optimization-patterns, git-conventions, testing-rules, multi-language-handlers)
- codeflash-internal-docs: 8 lazy doc pages (domain-types, optimization-pipeline,
  test-generation-pipeline, context-extraction, aiservice/cf-api endpoints,
  configuration-thresholds, llm-provider-abstraction)
- codeflash-internal-skills: 4 on-demand skills (debug-optimization-failure,
  add-language-support, add-api-endpoint, debug-test-generation)
2026-02-14 22:16:33 -05:00

2.5 KiB
Raw Blame History

Architecture

Service Flow

VSC-Extension / CLI → cf-api (Express, :3001) → aiservice (Django-Ninja, :8000)
cf-webapp (:3000) reads from the same PostgreSQL DB via Prisma

Monorepo Layout

codeflash-internal/
├── django/aiservice/          # Python backend (Django-Ninja, ASGI)
│   ├── aiservice/             # Django project: settings, urls.py, llm.py
│   ├── authapp/               # Authentication (HttpBearer + django_auth)
│   ├── core/                  # Business logic
│   │   ├── shared/            # Cross-language routers (optimizer_router, testgen_router, ranker)
│   │   ├── languages/         # Per-language handlers (python/, js_ts/, java/)
│   │   ├── protocols/         # Handler protocols (LanguageHandler, OptimizerProtocol, etc.)
│   │   ├── registry.py        # Language handler registration
│   │   ├── dispatcher.py      # Handler lookup by language + feature
│   │   └── log_features/      # Domain models (OptimizationFeatures, OptimizationEvents)
│   └── tests/                 # pytest tests by feature: optimizer/, testgen/, integration/
├── js/
│   ├── cf-api/                # Express middleware layer (:3001)
│   ├── cf-webapp/             # Next.js dashboard (:3000)
│   ├── common/                # Shared Prisma schema + utilities (CommonJS)
│   └── VSC-Extension/         # VS Code extension
├── cli/                       # CLI tools
└── deployment/                # Infrastructure configs

Glossary

  • Optimization Candidate — LLM-generated code that may be faster
  • Read-Write Context — code the LLM can modify
  • Read-Only Context — code provided as info only (not modified)
  • Tracer — collects input args for a Python function at runtime
  • Replay Test — reruns traced inputs to verify behavior
  • Comparator — compares two Python objects for equality

Key Entry Points

Task Start here
Optimization dispatch core/shared/optimizer_router.py
Testgen dispatch core/shared/testgen_router.py
Python optimization core/languages/python/optimizer/optimizer.py
LLM provider abstraction aiservice/llm.py
Endpoint registration aiservice/urls.py
Domain models core/log_features/models.py
Request/response schemas core/shared/optimizer_models.py
Handler registration core/registry.py + core/dispatcher.py
cf-api route registration js/cf-api/routes/index.ts