CLI Command Matrix

The fluffy-chainsaw command-line tool is the primary interface for topology resolution, SDK compilation, local emulation, and deployment lifecycle.

#Core Workflow Commands

#`fluffy-chainsaw init`

Initializes a new workspace and generates a cryptographically secure deployment.identity.

1fluffy-chainsaw init

#`fluffy-chainsaw experimental resolve`

Resolves and validates application topologies against environment provider definitions.

1fluffy-chainsaw experimental resolve \ 
2  --application <app-name> \ 
3  --environment <local|dev|prod>

#Local Emulation

#`fluffy-chainsaw local`

Starts or plans deterministic local containers mirroring your production cloud environment.

Flag	Type	Description
`--print`	boolean	Prints the Docker Compose plan without starting containers
`--ephemeral`	boolean	Runs without persisting data across runs
`--application`	string	Specifies which application stack to spin up

1fluffy-chainsaw local --application storefront --ephemeral

#Deployment Pipeline

Fluffy separates infrastructure changes into distinct, auditable approval stages:

1# 1. Foundation Bootstrap
2fluffy-chainsaw deploy bootstrap --environment dev --approve sha256:<digest> 
3 
4# 2. Stage 1: Discovery
5fluffy-chainsaw deploy --application storefront --environment dev --stage discovery --approve sha256:<digest> 
6 
7# 3. Stage 2: Activation
8fluffy-chainsaw deploy --application storefront --environment dev --stage activation --approve sha256:<digest>

#Validation and Check Flags

Run non-destructive checks across your entire repository:

1# Validate SDK drift
2fluffy-chainsaw generate --all --check 
3 
4# Validate source code usage against manifest capabilities
5fluffy-chainsaw validate source --application storefront --runtime api --source-root runtimes/api