Sam & Claude c47cd44251 Add .prettierrc + reformat all active markdown to match

Codifies the markdown format Sam applied in bd94b87 / 30cf590 as a
project rule rather than per-file judgment. Prettier 3 defaults with
proseWrap=preserve (no prose reflow), printWidth=80, embedded code
formatting off so we don't touch fenced shell/JSON blocks.

.prettierignore scopes Prettier to active docs:
  - excludes tmp/, cache/, node_modules/, build artifacts
  - excludes CHANGELOG.md + RELEASE-NOTES-*.md (hand-formatted, rigid)
  - excludes .archive/ and .opencode/ (historical / tooling internal)
  - excludes bundled bootstrap.html

Reformatted 16 active .md files: padded markdown tables, blank line
before lists (CommonMark-strict), `*emph*` -> `_emph_`. No content
changes — diffs are all whitespace/alignment/emphasis style.

Verified: `npx prettier@3 --check '**/*.md'` reports all clean.

Build: not run — docs + tooling config only.
Tests: pass — prettier --check is green; git diff confirms no content
deletions, only formatting.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-20 11:16:42 +02:00

2.4 KiB

Raw Blame History

VPS / Cloud Deployment Notes

Status: experimental / legacy path. The primary validation target is the unified ISO live installer. VPS/cloud deployment remains supported as a design goal, but the scripts under vps/ have not yet been brought fully in line with the current post-install /setup flow.

Use this page as orientation, not as a release checklist.

Current Direction

The target VPS flow should match the ISO contract:

install FreeBSD 15.x on the VPS,
copy the Clawdie firstboot payload,
boot into clawdie-firstboot,
run just install,
start the loopback-bound controlplane,
rotate a one-time setup token,
finish provider/model, Telegram, and operator account setup at /setup.

Provider keys and Telegram credentials are not install-time requirements. They can be pre-baked only for controlled images, but the preferred path is post-install setup.

Existing Files

vps/
├── setup.txt.tpl       # current preferred config template shape
├── firstboot-vps.sh    # legacy/experimental headless firstboot entrypoint
├── clawdie.conf.tpl    # deprecated compatibility template
└── clawdie-vps-migrate.sh

setup.txt.tpl now reflects the identity/substrate-first contract. The older clawdie.conf.tpl path is deprecated.

Provider Notes

Provider	Likely path	Status
Vultr	Custom ISO or mfsBSD rescue	experimental
Hetzner / OVH	Rescue shell then FreeBSD bootstrap	experimental
DigitalOcean	Recovery console / custom image	hard
Generic baremetal	Unified ISO live installer	primary

Security Notes

Prefer Tailscale for remote SSH access when possible.
If no Tailscale auth key is available, SSH on port 22 remains public and must be secured by the operator.
Do not expose http://127.0.0.1:3100/setup directly to the public internet. Use console access or SSH tunneling:

ssh -L 3100:127.0.0.1:3100 clawdie@<host>

Cleanup Needed Before Release

Reconcile firstboot-vps.sh with the current ISO live firstboot contract.
Remove the deprecated clawdie.conf.tpl path after migration is complete.
Add a real VPS validation run to TESTING.md once the path is exercised.

Last updated: 12.maj.2026

2.4 KiB Raw Blame History