netweft 0.2.0

Deterministic network planning and configuration generation for portable infrastructure.
Documentation
# Netweft

Deterministic network planning and configuration generation for portable infrastructure.

Netweft validates stable infrastructure intent, resolves provider-neutral plans, and renders deterministic artifacts. Deployment remains explicit and reviewable.

## Documentation

- [Documentation index]docs/README.md
- [Architecture]docs/ARCHITECTURE.md
- [Configuration]docs/CONFIGURATION.md
- [Adapters]docs/adapters/README.md
- [Deployment]docs/deployment/README.md
- [Operations]docs/operations/README.md
- [Development]docs/development/README.md

## Built-in adapters

```text
bind
cloudflare
docker
env
netplan
proxmox
proxmox-guests
proxmox-sdn
proxmox-storage
ssh
synology-nfs-permissions
systemd-mounts
```

List the adapters compiled into the current binary:

```bash
netweft adapters list
```

## Common inspection workflow

```bash
netweft validate
netweft show dns
netweft show proxy
netweft show cloudflare
netweft show ssh --client quasar
netweft show docker --host nexus
netweft show host-network --host zion
netweft show os-network --host quasar
netweft show guests
netweft show proxmox-sdn --host zion
netweft show proxmox-storage --host zion
netweft show network-mounts --host vortex
netweft show nas-permissions
```

Render only after the resolved plan looks correct, then use the matching deployment guide.

## Boundaries

Netweft does not directly:

- copy files over SSH;
- configure routers;
- store secrets;
- issue certificates;
- approve Tailscale routes;
- apply generated artifacts automatically.

Some adapters render guarded `apply.sh`, `verify.sh`, and `rollback.sh` scripts. Running those scripts remains an explicit operator action.

## Development verification

```bash
cargo fmt --all -- --check
cargo check --all-targets
cargo clippy --all-targets -- -D warnings
cargo test --all-targets
git diff --check
```