Release 0.22.0

.github/workflows/lint.yml

@@ -0,0 +1,34 @@
+name: Lint
+
+on:
+  push:
+    branches: [main, development]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: ruff check
+        run: ruff check .
+
+      - name: ruff format check
+        run: ruff format --check .
+
+      # Pin to match the pre-commit mirrors-mypy rev and the pyproject dev
+      # group so CI, local commits, and `uv sync` never run different mypys.
+      - name: Install mypy
+        run: pip install mypy==2.1.0
+
+      - name: mypy
+        run: mypy .

.gitignore

@@ -145,3 +145,6 @@ electron/
 /stage_definitions_for_review.txt
 gently/ui/tui/node_modules/
 gently/ui/tui/dist/
+
+# Runtime storage accidentally created on Linux when GENTLY_STORAGE_PATH="D:/" resolves literally
+D:/

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.17  # run `pre-commit autoupdate` to pin to latest
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    # Keep in sync with the mypy pin in pyproject.toml dev group and
+    # .github/workflows/lint.yml. Run `pre-commit autoupdate` to bump.
+    rev: v2.1.0
+    hooks:
+      - id: mypy
+        pass_filenames: false
+        args: ["."]

.python-version

@@ -0,0 +1 @@
+3.11

CHANGELOG.md

@@ -394,6 +394,52 @@ Net: ~3,500 lines removed across P6–P7.
 
 ---
 
+## v0.22.0
+
+File-based storage, a redesigned web UI, new hardware, and the tooling to
+keep it all honest.
+
+**File-based storage (Gently3)**
+Retired the SQLite databases. All state now lives as human-browsable files
+under `D:\Gently3\` — sessions, embryos, volumes, projections, traces,
+campaigns, learnings, agent memory, all YAML/JSONL/TIFF.
+- `FileStore` replaces `GentlyStore`; `FileContextStore` replaces the
+  `agent_mind.db` `ContextStore`. Drop-in API replacements.
+- A root `gently.yaml` manifest documents the layout for humans and agents.
+- YAML parses are cached in `FileContextStore` — fixes slow Plans/campaign
+  loading.
+
+**Web UI redesign**
+- Agent chat became a docked, sliding side panel (overlay + pin-to-dock)
+  instead of owning the screen.
+- Added a Home landing tab; the chat no longer auto-runs the startup wizard.
+- Login is non-blocking — a "Continue in view-only" escape hatch.
+- Recent images aggregate across previous sessions.
+
+**Hardware**
+- Integrated the ACUITYnano temperature controller (config, web control,
+  SDKs) with a live HiveMQ cloud SIM for hardware-free testing.
+- Added the SPIM-head F-drive device, hard limits, and focus/align plans.
+- Room-light toggle and a device-layer terminal UI.
+
+**Agent + perception**
+- Integrated the agent with perception: pull tool, prompt context, event
+  bridge, wake-router.
+- Live acquisition control with observable, permissioned autonomy and a
+  refreshed prompt.
+- Retired napari from the agent; added web-chat autocomplete and pruned
+  dead tools.
+
+**Tooling and environment**
+- Added ruff lint/format tooling and fixed all violations.
+- Adopted incremental mypy typing — config, CI, pre-commit wiring, and a
+  documented policy in `CONTRIBUTING.md`; pinned mypy to 2.1.0.
+- Switched environment setup to uv with an offline/UI-only launch path;
+  pinned pymmcore to device-interface 70.
+- Relicensed and updated the author list.
+
+---
+
 ## Notes on how we think about this
 
 Things we've learned building this, roughly in order:

CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing to Gently
+
+## Code quality toolchain
+
+This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and
+[mypy](https://mypy-lang.org/) for type checking, enforced automatically before every
+commit via [pre-commit](https://pre-commit.com/).
+
+### First-time setup
+
+Install the dev dependencies (includes ruff, mypy, and pre-commit):
+
+```bash
+uv sync
+```
+
+Then install the pre-commit hooks:
+
+```bash
+pre-commit install
+```
+
+From this point on, ruff runs on staged files and mypy runs across the whole
+project whenever you `git commit`.
+
+### Running manually
+
+To check all files at once (useful before opening a PR):
+
+```bash
+pre-commit run --all-files
+```
+
+Or run the tools directly:
+
+```bash
+ruff check .          # lint
+ruff format .         # format in-place
+```
+
+### Keeping hooks up to date
+
+To update hook versions to their latest releases:
+
+```bash
+pre-commit autoupdate
+```
+
+### Type checking
+
+Run mypy the same way pre-commit and CI do:
+
+```bash
+mypy .
+```
+
+The codebase is being typed incrementally (see issue #46). Modules with
+pre-existing errors are listed in the `[[tool.mypy.overrides]]` block in
+`pyproject.toml` with `ignore_errors = true`, so `mypy .` passes today even
+though not every module is fully typed yet.
+
+Policy for working with this list:
+
+- **New modules** must pass `mypy .` cleanly — do not add them to the
+  overrides list.
+- **PRs that substantively touch a module on the overrides list** should fix
+  that module's type errors and remove it from the list as part of the
+  change.
+
+### CI
+
+Every pull request runs the lint job (`.github/workflows/lint.yml`), which checks ruff lint and formatting and runs mypy across the entire project. Fix any failures locally with `pre-commit run --all-files` before pushing.