Skip to content

feat: add Compose self-host quickstart - #129

Merged
fazpu merged 1 commit into
mainfrom
impl/wp-0.4c-compose-selfhost
Jul 22, 2026
Merged

feat: add Compose self-host quickstart#129
fazpu merged 1 commit into
mainfrom
impl/wp-0.4c-compose-selfhost

Conversation

@fazpu

@fazpu fazpu commented Jul 22, 2026

Copy link
Copy Markdown
Member

Summary

  • add the typed MinIO object-store adapter and executable profiles/selfhost composition
  • add a pinned, non-root Python 3.14 image plus a fresh-deployment Compose stack for PostgreSQL, MinIO, setup, API, and separate convert/structure workers
  • add a parallel CI acceptance that proves real MinIO immutability, ingest state (convert/structure succeeded, chunk pending), and zero provider cost
  • document the bounded pre-release workflow and record WP-0.4c completion

Scope boundary

This is deliberately a fresh single-deployment infrastructure skeleton. Authentication, later workers, full D74 restore readiness, published GHCR images, HA, backups, and hosted operations remain deferred to their owning release/cloud work.

Verification

  • real local Compose build and fresh-volume bring-up
  • /healthz and /recipes
  • Markdown ingest through MinIO: 1|1|1 expected work-state proof and cost_ledger=0
  • pinned MinIO rejects replacement at an existing key
  • uv run pytest src/tests/adapters/test_minio_store.py -q --tb=short (4 passed)
  • uv run ruff check src/
  • uv run ruff format --check src/
  • uv run pyright src/ --pythonversion 3.14
  • uv run lint-imports (5 contracts kept)
  • docs npm run typecheck && npm run build
  • Grok 4.5 independent review: PASS; focused post-fix review: PASS

@github-actions

Copy link
Copy Markdown

Coverage report

Click to see where and how coverage changed

FileStatementsMissingCoverageCoverage
(new stmts)
Lines missing
  src/ultimate_memory/adapters
  __init__.py 35-39, 44
  src/ultimate_memory/adapters/selfhost
  __init__.py 54
  minio.py 123, 125, 136, 139-144, 177, 207, 219, 223, 245-247, 254
  src/ultimate_memory/profiles
  __init__.py 14-22
  selfhost.py 3-32, 39-322
  src/ultimate_memory/spine
  forget.py
Project Total  

This report was generated by python-coverage-comment-action

@fazpu
fazpu merged commit 0735431 into main Jul 22, 2026
7 checks passed
@fazpu
fazpu deleted the impl/wp-0.4c-compose-selfhost branch July 22, 2026 13:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant