memory-gateway/docs/superpowers/plans/2026-06-12-upstream-brand-neutralization.md

Upstream Brand Neutralization Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Remove the upstream product identity from the current Memory Gateway files without changing the upstream memory HTTP protocol.

Architecture: Replace product-specific names with backend terminology at configuration, client, service, API, test, and documentation boundaries. Enforce the result with a repository-level regression test that scans both file names and text content.

Tech Stack: Python 3, FastAPI, pytest, Markdown, environment configuration.

---

Task 1: Add the neutral-brand regression test

Files:

• Create: tests/test_branding.py

• Add a test that constructs the forbidden token from separate string fragments.

• Scan non-generated project file names and UTF-8 text contents.

• Run the test and verify it fails against the existing product-specific names.

Task 2: Rename runtime boundaries

Files:

• Rename: core/backend_client.py to core/backend_client.py

• Modify: core/api.py

• Modify: core/config.py

• Modify: core/service.py

• Modify: core/__init__.py

• Modify: .env.example

• Modify: .gitignore

• Delete: backend.env.example

• Rename the client class, dependency attributes, retry helpers, and configuration fields to backend terminology.

• Rename environment variables to MEMORY_GATEWAY_BACKEND_*.

• Rename health and direct add/flush response fields to backend.

• Preserve all /api/v1/memory/* paths.

Task 3: Rename tests and public documentation

Files:

• Rename: tests/test_backend_integration.py to tests/test_backend_integration.py

• Modify: tests/test_gateway.py

• Modify: tests/test_command.md

• Modify: README.md

• Modify: pyproject.toml

• Modify: skill/memory-gateway-agent/SKILL.md

• Modify: skill/memory-gateway-agent/references/api.md

• Rename fixtures, tests, environment flags, examples, and expected JSON fields.

• Describe the dependency only as an upstream memory service.

• Update integration commands and package metadata.

Task 4: Verify the current working tree

Files:

• Modify: docs/superpowers/plans/2026-06-12-upstream-brand-neutralization.md

• Remove generated bytecode caches.

• Run the branding regression test.

• Run the full test suite and Python compilation.

• Run a final case-insensitive content and file-name scan, excluding .git history.