How scaibu/policy-orchestrator works
Policy Orchestrator is a FastAPI/CLI product for repository architecture operations: it searches local files and code, scaffolds package/feature layouts, and performs zero-clone remote Git inspection, mutation, verification, and submodule management. The main user flow is an HTTP or CLI request routed to a feature service, which performs domain work and, where needed, uses remote Git providers or persistence. README documentation establishes several capabilities whose internal implementations were not sampled, so those links are shown as unverified rather than inferred call chains.
Main entry points: app.py REST API · main.py CLI · git_submodule_manager_service.py Submodule Manager · file_search_service.py File Search
Components 17
User Interfaces
- REST API
src/api/rest/app.py - CLI
src/api/cli/main.py - Task Lifecycle
src/features/task_lifecycle
Repository Intelligence
- File Search
src/features/file_search/service/file_search_service.py - Code Search
src/features/code_search/service/code_search_service.py - Scaffolding
src/features/folder_scaffold - Module Resolver
src/features/module_resolver
Remote Git Operations
- Remote Inspector
src/features/git_remote_inspector - Remote Mutator
src/features/git_remote_mutator - Submodule Manager
src/features/git_submodule_manager/service/git_submodule_manager_service.py - Git Verifier
src/features/git_verifier - Branch Lifecycle
src/features/git_branch_lifecycle
Shared Platform
- API Contracts
src/shared/types/envelope_types.py - Git Providers
- Graph Lineage
src/infra/adapters/graph/neo4j_adapter.py - Configuration
src/infra/config/config_loader.py
Other components
- Engineer
Connections 26
- Engineer → REST API: sends request
README.md - Engineer → CLI: runs command
README.md - REST API → File Search: routes search
- REST API → Code Search: routes search
- REST API → Scaffolding: routes scaffold
- REST API → Module Resolver: routes resolution
- REST API → Remote Inspector: routes inspection
- REST API → Remote Mutator: routes mutation
- REST API → Submodule Manager: routes operations
- REST API → Git Verifier: routes verification
- REST API → Branch Lifecycle: routes lifecycle
- CLI → File Search: invokes search
src/api/cli/main.py - CLI → Code Search: invokes search
- CLI → Scaffolding: invokes scaffold
README.md - CLI → Task Lifecycle: dispatches tasks
src/api/cli/main.py - CLI → Remote Inspector: invokes inspection
src/api/cli/main.py - CLI → Remote Mutator: invokes mutation
src/api/cli/main.py - CLI → Submodule Manager: invokes operations
- CLI → Git Verifier: invokes verification
src/api/cli/main.py - File Search → API Contracts: returns envelope
src/api/rest/v1/handlers/file_search_handler.py - Submodule Manager → Git Providers: mutates and inspects
src/features/git_submodule_manager/service/git_submodule_manager_service.py - Submodule Manager → Graph Lineage: syncs lineage
- Remote Inspector → Git Providers: reads remote Git
README.md - Remote Mutator → Git Providers: writes remote Git
README.md - Branch Lifecycle → Graph Lineage: tracks branches
README.md - REST API → Configuration: loads settings