PRJ: domus-cli :: Domus Digitalis

Project Summary

Project

domus-cli - Infrastructure Orchestration CLI

Priority

P1 - High

Status

Active

Owner

Evan

Language

Python 3.11+

License

MIT

Repository

_projects/personal/domus-cli

Proposals from ecosystem audit — 2026-04-04. For team review and prioritization.

Priority	Proposal	Rationale	Effort
P1	Add usage examples with real commands	SSH orchestration CLI needs concrete examples: multi-host execution, config deployment, health checks. Users cannot adopt without runnable examples.	M
P2	SSH connection flow diagram	Document the connection lifecycle: key selection, jump host routing, multiplexing, session reuse. A sequence diagram clarifies the architecture.	S
P2	Error handling and edge case documentation	SSH failures (timeout, key mismatch, host unreachable) need documented resolution paths. Common in heterogeneous environments.	M
P3	Integration guide with other domus tools	Document how domus-cli interacts with netapi (network device SSH), gopass (credential retrieval), and Vault (certificate-based auth).	S

Priority

Proposal

Rationale

Effort

P1

Add usage examples with real commands

SSH orchestration CLI needs concrete examples: multi-host execution, config deployment, health checks. Users cannot adopt without runnable examples.

M

P2

SSH connection flow diagram

Document the connection lifecycle: key selection, jump host routing, multiplexing, session reuse. A sequence diagram clarifies the architecture.

S

P2

Error handling and edge case documentation

SSH failures (timeout, key mismatch, host unreachable) need documented resolution paths. Common in heterogeneous environments.

M

P3

Integration guide with other domus tools

Document how domus-cli interacts with netapi (network device SSH), gopass (credential retrieval), and Vault (certificate-based auth).

S