Files
headquarter/apps/api/alembic/.pi-map.md
T
Developer 4c14966ae3 fix: write valid multi-line tmux config in Pi Agent images
The Pi Agent dockerfile templates created ~/.tmux.conf with a literal
\n because the RUN command used single-quoted echo. Tmux never parsed
the malformed line, so mouse mode stayed off. Without tmux mouse mode,
mouse-wheel events in xterm.js fell back to Up/Down arrow keys and
cycled shell command history instead of scrolling the terminal buffer.

- Use printf '%s\n' to write real newlines in .tmux.conf.
- Apply the same fix to the ranger rc.conf where the same bug existed.
- Update tool-images/pi-agent.dockerfile and both affected alembic
  migration dockerfile strings.

Quality gates: npm run typecheck, npm run lint, npm test -- --run (87 passed),
py_compile on changed migrations.

Refs: openspec/changes/fix-tmux-mouse-config
2026-06-14 08:48:39 +00:00

1.8 KiB

apps/api/alembic

dir: apps/api/alembic

index: apps/api/alembic/.pi-map.index.md

role

Database migration infrastructure for the API application, providing version-controlled schema evolution with async SQLAlchemy support.

files

  • env.py | Configures Alembic database migration environment with async SQLAlchemy support for a project. | exp: func:run_migrations_offline() → None, call:context.configure, call:context.begin_transaction, call:context.run_migrations, func:do_run_migrations(connection: Connection) → None, call:context.configure, call:context.begin_transaction, call:context.run_migrations, func:run_async_migrations() → None, call:async_engine_from_config, call:config.get_section, call:connectable.connect, call:connection.run_sync, call:connectable.dispose, func:run_migrations_online() → None, call:asyncio.run, call:run_async_migrations | dep: logging.config, alembic, sqlalchemy, sqlalchemy.engine, sqlalchemy.ext.asyncio, src.config, src.models, asyncio
  • script.py.mako | Alembic database migration script template that generates upgrade/downgrade functions for SQLAlchemy schema migrations | dep: alembic, sqlalchemy

arch

Standard Alembic migration framework with async SQLAlchemy integration, using Mako templating for migration script generation and environment-based configuration for database connection management.

tags

migrations, run, sqlalchemy, async, alembic, call:context.configure, call:context.begin, transaction

symbols

  • run_migrations_offline
  • do_run_migrations
  • run_async_migrations
  • run_migrations_online
  • call:context.configure
  • call:context.begin_transaction
  • call:context.run_migrations
  • call:async_engine_from_config

workflows

  • change alembic behavior read: env.py, script.py.mako
  • explore alembic subdirectories index: apps/api/alembic/versions/.pi-map.index.md

dirty