Developers guide

Quick navigation

• Architecture
• CLI reference
• CLI examples
• Variant C manifests
• Overrides
• Conventions
• Registry
• DAG debugging
• Import rules
• Quality metrics
• Developer workflow
• CI/CD
• Developer CI/CD guide
• Runbook
• Release
• Compatibility
• ADR index

Repository layout

This repository uses src-layout:

• Python package code is under src/dpone/
• Documentation is under docs/

Target refactoring structure

We are moving from a monolithic CLI module to a layered structure:

• dpone/cli/ – thin entrypoint
• dpone/commands/ – argparse wiring + command dispatch
• dpone/services/ – application services (use cases)
• dpone/app/ – DI / settings / logging
• dpone/ports/ – Protocols
• dpone/adapters/ – concrete implementations

Quality gates and metrics

Code quality metrics are maintained in Quality metrics. That page is the single source of truth for current LOC/SLOC, coupling, clustering, layer metrics, thresholds, and CI update commands.

Use the developer guide for workflow and architecture orientation; use the quality dashboard when deciding whether a refactor is required before adding new behavior.