Add dev infrastructure: observability, migrations CLI, and archive proposal

- Add Sentry observability module with init_sentry(), capture_exception(), breadcrumbs
- Add Alembic database migration CLI commands (jdo db status/upgrade/downgrade/revision)
- Add settings for sentry_dsn, sentry_traces_sample_rate, environment
- Archive add-dev-infrastructure change proposal after completion
- Update AGENTS.md with migration workflow documentation

Author: JRedeker

AGENTS.md

@@ -84,6 +84,56 @@ class MyWidget(Widget):
 
 When pyrefly reports errors on working code, verify at runtime then document here.
 
+## Pre-commit Hooks
+
+Pre-commit hooks are configured to run automatically before each commit:
+
+```bash
+# Install hooks (one-time setup)
+uv run pre-commit install
+
+# Run manually on all files
+uv run pre-commit run --all-files
+
+# Skip hooks if needed (not recommended)
+git commit --no-verify
+```
+
+Hooks configured:
+- `trailing-whitespace` - Remove trailing whitespace
+- `end-of-file-fixer` - Ensure files end with newline
+- `check-yaml` - Validate YAML syntax
+- `check-toml` - Validate TOML syntax
+- `check-added-large-files` - Block files > 500KB
+- `ruff` - Lint with auto-fix
+- `ruff-format` - Format code
+- `pyrefly` - Type checking on src/
+
+## Database Migrations
+
+Database migrations are managed with Alembic:
+
+```bash
+# Check current migration status
+jdo db status
+
+# Apply all pending migrations
+jdo db upgrade
+
+# Create a new migration (auto-detects model changes)
+jdo db revision -m "Add new field to model"
+
+# Rollback one migration
+jdo db downgrade
+```
+
+**Workflow for schema changes**:
+1. Modify SQLModel model in `src/jdo/models/`
+2. Create migration: `jdo db revision -m "Description"`
+3. Review generated migration in `migrations/versions/`
+4. Apply migration: `jdo db upgrade`
+5. Run tests: `uv run pytest`
+
 ## Context7 Docs (check before coding)
 
 | Tech | ID | Topics |

migrations/alembic.ini

@@ -0,0 +1,59 @@
+# Alembic configuration for JDO database migrations
+
+[alembic]
+# Path to migration scripts
+script_location = .
+
+# Template for migration file names
+file_template = %%(year)d%%(month).2d%%(day).2d_%%(rev)s_%%(slug)s
+
+# Truncate slug field to 40 characters
+truncate_slug_length = 40
+
+# Prepend sys.path with the project root
+prepend_sys_path = ..
+
+# Timezone to use when rendering dates
+# Leave blank for localtime
+timezone =
+
+# Max revision name length
+# truncate_slug_length = 40
+
+# SQLAlchemy URL - dynamically loaded from settings
+# sqlalchemy.url = driver://user:pass@localhost/dbname
+
+# Logging configuration
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

migrations/env.py

@@ -0,0 +1,104 @@
+"""Alembic migration environment configuration.
+
+This module configures Alembic for SQLModel migrations with SQLite support.
+"""
+
+import sys
+from logging.config import fileConfig
+from pathlib import Path
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+from sqlmodel import SQLModel
+
+# Add the project root to sys.path for model imports
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root / "src"))
+
+# Import all models to ensure they're registered with SQLModel.metadata
+# This is required for autogenerate to detect model changes
+from jdo.models import (  # noqa: E402, F401
+    Commitment,
+    Draft,
+    Goal,
+    Milestone,
+    RecurringCommitment,
+    Stakeholder,
+    Task,
+    Vision,
+)
+
+# Get settings for database path
+from jdo.config.settings import get_settings  # noqa: E402
+
+# Alembic Config object for access to .ini file values
+config = context.config
+
+# Configure Python logging from alembic.ini
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# Set target metadata for autogenerate support
+target_metadata = SQLModel.metadata
+
+
+def get_url() -> str:
+    """Get the database URL from settings.
+
+    Returns:
+        SQLite database URL.
+    """
+    settings = get_settings()
+    return f"sqlite:///{settings.database_path}"
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode.
+
+    This configures the context with just a URL and not an Engine,
+    useful for generating SQL scripts without connecting to a database.
+    """
+    url = get_url()
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        render_as_batch=True,  # Required for SQLite ALTER TABLE support
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode.
+
+    Creates an Engine and associates a connection with the context.
+    """
+    # Build configuration dictionary
+    configuration = {
+        "sqlalchemy.url": get_url(),
+    }
+
+    connectable = engine_from_config(
+        configuration,
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            render_as_batch=True,  # Required for SQLite ALTER TABLE support
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

migrations/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from collections.abc import Sequence
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: str | None = ${repr(down_revision)}
+branch_labels: str | Sequence[str] | None = ${repr(branch_labels)}
+depends_on: str | Sequence[str] | None = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Apply migration changes."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Revert migration changes."""
+    ${downgrades if downgrades else "pass"}