Home

Altinity SQL Browser knowledge base

This wiki is the fast orientation layer and shared durable memory for maintainers and coding agents. It distills repository documentation, source layout, and historical agent learnings available on 2026-07-12. Follow the linked source documents when exact details matter.

It is the project's primary knowledge base: read Home first, and record durable learnings here — see Maintaining-This-Wiki.

Start here

• Architecture — dependency direction, seams, state, query execution, build.
• Product-and-Features — the user-facing surface and where each feature lives.
• Development-Workflow — tests, coverage, build, review, and release discipline.
• Decisions-and-Roadmap — settled architecture and current forward-work model.
• Deployment-and-Security — artifact, OAuth modes, cluster installation, secrets.
• Operations-Memory — shared durable operational lessons.
• Project-Skills — local /ship workflows and Codex compatibility links.
• Source-Map — high-value entry points and documentation.
• Maintaining-This-Wiki — how to use and update this knowledge base.

Non-negotiable invariants

1. Read CLAUDE.md before substantive changes; it is the primary contributor guide.
2. Preserve layer direction: UI → net/state/core, net → core, core → nothing.
3. Inject environment side effects and third-party imperative adapters.
4. Run npm test and npm run build; coverage is per file, not aggregate.
5. Keep the shipped browser a single esbuild-generated dist/sql.html artifact.
6. Never commit rendered deploy/config.json or other credentials.

Current checkout context

At wiki creation the checkout was feat/panels-166, ahead of origin/main, with pre-existing uncommitted work in CHANGELOG.md, src/main.js, src/ui/app.js, src/ui/chart-render.js, src/ui/saved-history.js, and src/core/panel-cfg.js, plus .mcp.json. Treat those changes as user-owned.

Source: AGENTS.md, CLAUDE.md, repository tree, and historical agent memory.