docs(dev): cluster-based start-dev contributor onramp (#447)
Add a dedicated "Local Development Cluster" wiki page documenting the new
cluster-based dev workflow delivered by #442, and update the stale
host-process descriptions across the contributor onramp pages.
New page covers: prereqs (kubectl/docker + kind or k3s, optional tilt);
kind vs k3s cluster setup incl. the k3s registries.yaml mirror snippet and
the prod-context guard; database config as the developer's responsibility
(localhost -> host.docker.internal/node-IP gotcha, cloud Postgres, and
OCI ADB via DB=oracle + TMI_ORACLE_WALLET_ZIP); the command reference
(dev-cluster-up/down, start-dev [DB=oracle], restart-dev, stop-dev,
tilt-up/down); the optional Postgres-only Tilt fast loop; and a breaking-
change callout that the host-process dev path is retired.
Updated Getting-Started-with-Development, Configuring-Local-Development,
and Contributing to replace the old "start-dev brings up containers +
host server" descriptions with the cluster model and cross-links; added
the new page to the sidebar.
Closes #447
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(config): revamp configuration documentation for the two-category model
Rewrites the configuration docs around the post-#415 model (Bootstrap vs
Operational categories, plus the still-live env > file > db precedence):
- Configuration-Model (new): the concept hub — the two categories, how values
are resolved (categories decide WHERE a value may live; precedence decides
WHICH wins), vault://env://file:// secret references, the secret-vs-bootstrap
orthogonality with Timmy as the worked example, hot vs static, visibility,
the three bootstrap-only config files, required settings.
- Configuring-Local-Development (new): dev setup, config-example -> -development,
TMI_* overrides, the OAuth stub + login_hint, operational settings in dev.
- Bootstrapping-Production (new): the bootstrap-only skeleton, secret wiring +
three-phase resolution, first-run DB seeding, --import-legacy migration,
platform notes (OCI/ADB, Heroku, Kubernetes), worker bootstrap, a checklist.
- Managing-Operational-Settings (new, replaces Configuration-Management):
/admin/settings CRUD + reencrypt, the source field + 409-on-config-controlled,
runtime reconfiguration of Timmy/content sources, dbtool import flags.
- Configuration-Reference (rewritten): generated from the classification
registry via 'make generate-config-docs' — drift-guarded, never hand-edited.
- Configuration-Management and Config-Migration-Guide retired to redirect stubs.
- Sidebar updated; Content-Extractors page cross-linked.
Pairs with the dev/1.4.0 generator (EnvVar field + cmd/genconfigdocs).