Sam & Claude faf060e0ce docs: introduce Layered Memory Fabric terminology (Sam & Codex)

Replaces public split-brain wording with Layered Memory Fabric, documents the skills/brain/ops planes, and sketches the shared FreeBSD/Linux install contract around PostgreSQL, ZFS/OpenZFS, and platform isolation adapters.\n\nChecks: npx --yes prettier@3 --check touched docs/html; git diff --check

---
Build: pass | Tests: FAIL — 1 failed

2026-06-13 21:32:50 +02:00

2.2 KiB

Raw Blame History

docs.clawdie.si Deployment

Status: Transitional static bridge deploy Date: 14.mar.2026

Purpose

This folder holds the versioned source set for the docs.clawdie.si subdomain.

The site explains:

Clawdie on FreeBSD
the Layered Memory Fabric model
Skills built-in local knowledge
Brain memory for user and future-agent memory
Ops runtime state
the relationship to NanoClaw upstream

Layout

html/docs-clawdie-si/
├── index.html
├── css/
│   └── shared.css
├── docs/
│   ├── index.html
│   └── split-brain.html
└── nginx/
    └── docs.clawdie.si.conf

Design direction

This checked-in HTML deploy path is a bridge pattern, not the long-term target architecture.

The target deployment model is:

Astro + Strapi live in the cms jail
nginx also lives in the cms jail
Clawdie does not require host nginx ownership
public exposure can happen through host PF, an existing reverse proxy, or a direct public jail IP

Current bridge deployment shape

Suggested host paths:

webroot: /usr/local/www/docs.clawdie.si
nginx vhost: /usr/local/etc/nginx/vhosts/docs.clawdie.si.conf
cert dir: /usr/local/etc/nginx/ssl/docs/

Host prerequisite:

rsync installed (pkg install rsync)

Preferred bridge deploy path

Run:

./deploy.sh

The script:

stages only the public site files (index.html, changelog.html, license.html, css/, docs/, guides/, .well-known/)
syncs them into /usr/local/www/docs.clawdie.si with rsync --delete
installs nginx/docs.clawdie.si.conf into /usr/local/etc/nginx/vhosts/
runs nginx -t
reloads nginx

Manual bridge deploy steps

Copy only public site files to /usr/local/www/docs.clawdie.si
Install nginx/docs.clawdie.si.conf into /usr/local/etc/nginx/vhosts/
Obtain TLS cert for docs.clawdie.si
Run nginx -t
Run service nginx reload

Notes

This is a static site, not a reverse proxy app.
It is intended to keep the docs live while the Astro + cms jail refactor is completed.
It complements the main html/clawdie/ site rather than replacing it.
The homepage badge shows latest repository activity from Codeberg, not the live deploy timestamp.

2.2 KiB Raw Blame History