colibri/docs/PLAN-WIKI-CLAWDIE-SI.md
Sam & Claude 968534d528
Some checks are pending
CI / agent-jail-pkgs (pull_request) Waiting to run
CI / rust (pull_request) Waiting to run
CI / markdown (pull_request) Waiting to run
CI / port (pull_request) Waiting to run
refactor: kill→stop across API surface, CLI, TUI, and docs
Clean sweep — no kill on the Colibri wire protocol, CLI surface,
TUI keybinding, or documentation. Backward-compat aliases removed;
daemon and client deploy together so no transitional period needed.

  Wire: KillAgent→StopAgent, "kill-agent"→"stop-agent" (no alias)
  CLI:  colibri kill→stop, Command::KillAgent→StopAgent
  Lib:  client.kill_agent()→stop_agent()
  TUI:  kill_selected()→stop_selected(), "kill"→"stop" label
  Docs: spawn/kill→spawn/stop, kill-agent→stop-agent (40+ instances)

  Retained kill only where it belongs:
  - child.kill() / handle.kill() (OS SIGKILL)
  - Unix kill(1) in sigterm tests
  - OOM kill, process-group kill comments (kernel mechanism)
2026-06-26 14:40:10 +02:00

1.8 KiB

wiki.clawdie.si — separate domain for decision pages

Status: planned · Created: 26.jun.2026 · Blocks: nothing in 0.12

Goal

Split the current docs.clawdie.si (single site) into two domains during the Astro migration from clawdie-ai → colibri:

docs.clawdie.si  →  guide (procedural: install, operate, reference)
wiki.clawdie.si  →  wiki  (decisions: architecture rationale, LLM-wiki)
clawdie.si       →  landing (unchanged)

Why

  • Wiki stays pure Karpathy LLM-wiki pattern — one decision per page, flat list
  • Guide stays procedural — structured sidebar with install/operate/architecture
  • Different audiences: wiki for agents/architects, guide for operators
  • ISO can toggle each surface independently (FEATURE_DOCS, FEATURE_WIKI)

What needs building

Layer Task
DNS wiki.clawdie.si A/AAAA → same host
TLS New Let's Encrypt cert (acme.sh auto-renew)
Nginx New vhost for wiki.clawdie.si
Astro Two Starlight configs from one colibri source tree
Build build-docs.sh → dist-guide/ + dist-wiki/
ISO FEATURE_DOCS / FEATURE_WIKI toggle knobs

Two Starlight configs

colibri/astro/
  guide.config.mjs   → full sidebar: Install, Operate, Architecture...
  wiki.config.mjs    → minimal sidebar: autogenerate flat article list

Same toolchain, two configs, two output dirs. Wiki uses autogenerate — no manual sidebar to maintain as pages are added.

Prerequisite

The Astro build pipeline must be migrated from clawdie-ai to colibri first. The content already lives in colibri (docs/guide/ + docs/wiki/). The build scripts and Astro config don't yet.