From d8d7e9a30769be35c85ce57b6451ebdd078dcd96 Mon Sep 17 00:00:00 2001 From: Mathias Date: Mon, 27 Jul 2026 15:18:38 +0200 Subject: [PATCH] chore(context): re-sync derived adapters (Python fallback stack, error-handling note) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Canonical ~/dev/.context/AGENT.md drifted (Python fallback stack table row, Python error-handling convention) without a hyperguild commit re-running task context:sync since — task check's drift gate has been failing CI on every push since the sprint-1 commits landed, blocking CD entirely (unrelated to those commits' own content: lint/test/vet all pass clean, including -race). Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01Roq1ajWKR5f1hG5Df9wC6A --- .context/system-prompt.txt | 9 +++++++-- AGENTS.md | 9 +++++++-- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/.context/system-prompt.txt b/.context/system-prompt.txt index f41a623..0fc0d5a 100644 --- a/.context/system-prompt.txt +++ b/.context/system-prompt.txt @@ -88,7 +88,7 @@ These rules apply to every task across every project, regardless of harness. | Containers | Docker Compose (dev), k3s (prod) | — | — | | DB | PostgreSQL + sqlc | SQLite | — | | Search | pgvector (vector), BM25 | Qdrant (when >1M vectors or hybrid retrieval) | — | -| Logging | slog (structured) | — | — | +| Logging | slog (structured) | stdlib `logging` w/ structured `extra=` (or structlog) | — | | Testing | Table-driven, testify | — | — | | Agents (Go) | google.golang.org/adk + pkg/litellm adapter | — | — | @@ -97,7 +97,12 @@ Exploratory: Rust, Zig — I'll tell you when I want these. ## Code conventions - **Go style**: golines, gofumpt, golangci-lint -- **Errors**: `fmt.Errorf("operation: %w", err)` — never naked, never log-and-return +- **Python style** (fallback language): ruff (format+lint, one tool), mypy --strict (non-negotiable, + matches Go's static typing discipline), pytest + pytest-cov (table-driven via + `@pytest.mark.parametrize`), uv (venv+deps+lock, one tool), pydantic-settings (typed env-var config + — same principle as Go's typed structs), src-layout + `pyproject.toml` only (no `setup.py`) +- **Errors**: `fmt.Errorf("operation: %w", err)` — never naked, never log-and-return. + Python: `raise X from e` (exception chaining, same principle) — never bare `except`, never silent `pass` - **Naming**: stdlib conventions, no stuttering - **Architecture**: prefer stdlib over frameworks, constructor injection, env-var config parsed into typed structs - **Git**: conventional commits (`feat:`, `fix:`, `chore:`), commit directly to main, diff --git a/AGENTS.md b/AGENTS.md index 9e19619..92c97db 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -83,7 +83,7 @@ These rules apply to every task across every project, regardless of harness. | Containers | Docker Compose (dev), k3s (prod) | — | — | | DB | PostgreSQL + sqlc | SQLite | — | | Search | pgvector (vector), BM25 | Qdrant (when >1M vectors or hybrid retrieval) | — | -| Logging | slog (structured) | — | — | +| Logging | slog (structured) | stdlib `logging` w/ structured `extra=` (or structlog) | — | | Testing | Table-driven, testify | — | — | | Agents (Go) | google.golang.org/adk + pkg/litellm adapter | — | — | @@ -92,7 +92,12 @@ Exploratory: Rust, Zig — I'll tell you when I want these. ## Code conventions - **Go style**: golines, gofumpt, golangci-lint -- **Errors**: `fmt.Errorf("operation: %w", err)` — never naked, never log-and-return +- **Python style** (fallback language): ruff (format+lint, one tool), mypy --strict (non-negotiable, + matches Go's static typing discipline), pytest + pytest-cov (table-driven via + `@pytest.mark.parametrize`), uv (venv+deps+lock, one tool), pydantic-settings (typed env-var config + — same principle as Go's typed structs), src-layout + `pyproject.toml` only (no `setup.py`) +- **Errors**: `fmt.Errorf("operation: %w", err)` — never naked, never log-and-return. + Python: `raise X from e` (exception chaining, same principle) — never bare `except`, never silent `pass` - **Naming**: stdlib conventions, no stuttering - **Architecture**: prefer stdlib over frameworks, constructor injection, env-var config parsed into typed structs - **Git**: conventional commits (`feat:`, `fix:`, `chore:`), commit directly to main,