project-diagramming-archify: add publish-maps.sh — rsync docs/ to maps site behind Caddy on .35

- publish-maps.sh: incremental/atomic rsync of <project>/docs to maps.lab.audasmedia.com.au/<project>/docs (excludes visual-check sidecars)
- SKILL.md: document publish step after deliver + site URL
- maps.lab.audasmedia.com.au served by Caddy on .35 (file_server browse, no auth)
This commit is contained in:
2026-09-06 12:41:06 +10:00
parent 8e68df0830
commit 8223003515
2 changed files with 66 additions and 0 deletions

View File

@@ -47,6 +47,21 @@ Commands (from the vendored skill's fast authoring path):
Create `<project>/docs/` (+ `docs/archify/`) if missing. Never write artifacts outside the project directory.
## Publish to the central maps site (optional but recommended)
After a successful `deliver`, offer to **publish** the project's `docs/` to the LAN maps site:
```bash
~/.agents/skills/project-diagramming-archify/publish-maps.sh [<project-dir>]
```
- Uploads `docs/` to Caddy on `.35` → **`https://maps.lab.audasmedia.com.au/<project>/docs/`** (site index at `https://maps.lab.audasmedia.com.au/` — Caddy `file_server browse`, no auth, read-only static hosting).
- **Incremental + atomic** (rsync -az): only changed blocks transfer; no half-written files on failure.
- Excludes `*.visual-check.*` sidecars automatically (keeps the browse index clean).
- Works from any machine with ssh key access to `.35` (all three pi machines have it).
- `publish-maps.sh --list` shows what's already published.
- Wait for `visual-check` to pass first; `publish-maps.sh` does NOT re-run it.
## Authoring rules (subset of the vendored skill — read SKILL.md for full invariants)
- Omit `meta.visual_preset`, `meta.subtitle`, `meta.legend`, `meta.engineering_profile` by default.