atomic-config

Design phase — no code yet. Package name: komirka (комірка — the Ukrainian word for a memory/spreadsheet cell: one small addressed slot holding one value). Chosen 2026-07-05; verified free on npm and github.com/komirka at that date — reserve both before first publish. The primitive is provisionally still called knob throughout the docs; renaming it is a separate open decision.

Atomic configuration: each config value is an inert, importable, documented, validated descriptor — bound explicitly per runtime (Node, Cloudflare Workers, browsers, tests), with secrets fail-closed by construction. BYO validation via Standard Schema; zero runtime dependencies; descriptors round-trip as JSON.

In this repo

• principles.md — the project constitution: every hard constraint, every pitfall identified through adversarial design review, and the full security model. Read this first; every future feature must pass it.

• site/ — the design presented as a documentation website (fumadocs). The fastest way to evaluate the design is to read it as if the library existed:

  cd site
  pnpm install
  pnpm dev        # http://localhost:3000

  Start at /docs (overview), then /docs/principles, then the guides (Node, Workers, browser, testing, live config on Kubernetes).

Status

• Design produced through two adversarial multi-agent review rounds (prior-art sweep, five design lenses, six attack passes) — the surviving decisions are recorded in principles.md and presented across the site.
• First planned consumer: StitchAPI, as a devDependency via the build-time bake step (zero runtime dependency).
• v0.1 proof gate: a demo repo where one knobs file is consumed unchanged by a Node server, a Cloudflare Worker, a Vite client (with bake failing the build on a planted secret leak), and a vitest suite with zero process.env mutation.