Work Done
At the user’s explicit request, changed only interface skeletons in
~/work/factory-framework: base.py, new backends.py, api.py, cli.py,
package exports and usage-example/main.py. All function bodies are docstrings
plus ellipsis, including the example service. No behavior is implemented.
The proposed surface retains BaseService.check/infer and FactoryDeployment. Deployment.infer dispatches; run_batch executes directly without submission. InMemoryBackend and ArgoWorkflowsBackend share an execute signature. API and worker commands load the same consumer registration from the same image. Constructors must not connect to Argo or load models. This skeleton names Argo Server URL/token settings; its transport is not implemented.
Validated Python 3.11 grammar, stub-only bodies, and imports through the existing project Pixi Python. Dependencies, CLI packaging and README remain unchanged.
Pitfalls
The user twice rejected broad architecture proposals as overengineering. Do not treat the earlier assessment’s job-management APIs, execution context, identity machinery or staged hardening program as approved scope. The stub methods are intentionally nonfunctional, not ready for execution.
Improvements
Continue from the minimal agreed classes and direct wiring. Shared-image API and worker roles need different commands, not different service implementations or mandatory separate images. Heavy imports belong inside inference; credentials are injected at runtime. Implement behavior only when the user requests it.