The FAIDD CLI is the central orchestration engine for the Sovereign Security Framework. It provides the necessary tools to initialize, manage, and audit the development perimeter.

FAIDD addresses the critical challenge of AI Agency Security. By establishing a robust barrier between autonomous agents and the host system, the CLI ensures that agent interactions remain within a defined governance scope through schema-first permissions and immutable audit trails.

• Perimeter Initialization: Automated setup of the Sovereign workspace.
• Onboarding Journey: Interactive configuration of developer identity and technical context.
• Rule Enforcement: Real-time evaluation of agent actions against governance laws.
• Audit Logging: Generation of cryptographic trails for post-action verification.

The CLI follows a modular, layer-based architecture designed for high maintainability and security:

• UI Layer (src/ui/): Pure terminal rendering (ASCII branding, themes, table formatting).
• Action Layer (src/actions/): Coordination of complex business flows and internal services.
• Service Layer (src/services/): Stateless modules for configuration management and rule processing.
• Onboarding Layer (src/onboarding/): Interactive setup rituals for new environments.
• Types & Schemas (src/types/): Shared definitions and runtime validation rules.

To establish Sovereign guardrails in a new project:

npx faidd init

For status reporting and perimeter auditing:

npx faidd status

After initialization, the project is structured into two distinct poles:

• _faidd/ (System Core): Read-Only for AI agents. Contains rules, sessions, and daemon binaries.
• faidd/ (Operational Brain): Writeable for agents to store mission registers, analysis, and implementation plans.

This package is a core component of the FAIDD Sovereign Security Framework.