Current default: one-field project config and routing diagrams. Docker Compose group: mstack. Migration evidence.
2026-10-16: Start with mstack. Each project edits only
.mstack/stack.json; generated records live in .mstack/state.json. The old
configuration and example projects are retired. Cleanup status.
Use ./mstack; ./stack remains compatible. The directory/project identity stays
mcp-stack; Docker Compose uses mstack. The everyday workflow is Codex/Claude,
Anytype, and Windmill. Retained shared infrastructure stays available.
Graphify, Anytype MCP and Headroom run from each project's own .mcp.json (tool delivery); there are no shared tool containers.
New projects require their own qualified grants. CodeGraph remains ignored.
WhoDB is resumed and healthy. How the harness connects
explains project MCP bindings and why ai-memory/agentgateway remain optional.
The dated entries below are engineering history, not a required startup sequence or a current service-health report.
2026-10-15: the approved Ubuntu mise migration is active. New shells use repo-owned pinned profiles; {{mstack:CLIENT_REPO_CAMEL}} keeps its project Node selection. Twelve duplicate apt CLIs and unused standalone Bun files were retired with rollback copies. The later authorized helper drain also migrated 146 Python environments and DeepSeek profile dependencies, reconnected MCPs and retired old fnm/uv Python paths. Application data and private rollback copies remain preserved. Migration details.
2026-10-08: unified project config is implemented. Start with ./stack init,
then plan/apply/doctor --project <directory>. Edit project .mstack/stack.json and
shared infra/stack/connections.json; the gateway registry is generated.
Config contract. Owner UI remains editable; apply detects
drift and preserves unrelated projects/keys. Historical inventory below is not
current runtime evidence; use the canonical handover.
Local proof of concept and long-running personal MCP stack. Provider/service provisioning remains separate from project config reconciliation.
Canonical handover: status, operating steps, data flow and message flow. Keep returning to that same file as integrations progress. It reconciles the 2026-10-05 side-chat results; older status and next-step statements below are historical.
2026-10-06: Anytype is sole PKM, initially local-only; Basic Memory secondary. ai-memory 2.5.2 installed as an optional working-memory candidate, with no capture hooks/model keys/registrations. All 26 pre-existing containers are stopped and were preserved. Model routing and llama.cpp remain pending/later. Current architecture and credentials are documented in the handover.
Start working: small-by-default guide. Updated
2026-10-05: Codex primary; Windmill primary workflows; agentgateway selected/current proxy;
Graphify and Basic Memory retained. Other harnesses, n8n, CodeGraph and OpenWiki
are optional; PKM integrations are later. Preserve infra/ and engineering history.
Component catalog separates desired roles from actual
runtime. Windmill shared-PG replacement is
completed; Activepieces test runtime/data also removed. Use the
Windmill runbook. Older status/next-step statements below are historical
and do not override this decision or authorize follow-on setup.
The repository is /home/developer/workspace/mstack inside the OrbStack Ubuntu machine (devbox). It is a real directory. From macOS, use /Users/{{mstack:MAC_USER}}/OrbStack/devbox/home/developer/workspace/mstack.
- Root
compose.yamlincludesinfra/postgres/compose.yamlto run isolated PostgreSQL 18.6 + pgvector 0.8.6, with the image pinned by digest, a named volume, separate administrator/application passwords, and macOS127.0.0.1:55322publication. - First startup, health, authenticated application writes, vector distance queries, correct PG18 persistence mount, and unchanged
{{mstack:CLIENT_REPO}}inventory are verified. See the database runbook. - Supabase is a disabled future option. Its previously installed CLI remains on macOS, but this project's
infra/mise.tomldoes not select it. - macOS global
ghandxcbeautifyremain selected. Global tmux was removed as requested, with config/cache recovery material kept locally. Node is project-specific. Docker/Compose remain OrbStack-provided. The separately approved Ubuntu mise migration is documented above; no duplicate Docker installation was added. - Basic Memory 0.23.2 is running against PostgreSQL, with 21 MCP tools verified at macOS
http://127.0.0.1:58000/mcp. Read/write/text search and note persistence across container re-creation passed. Its opt-in overlay isinfra/basic-memory/compose.yaml; see the runbook. Semantic search is not yet enabled. Basic Memory gateway/harness integration, n8n, semantic search and PKM connections remain deferred or later steps. - Accepted: task-profile memory routing, with tools used only when relevant. Basic Memory text-search harness integration is now a requested final step, still awaiting concrete connection/test approval. Models/semantic search/unrelated tests stay deferred; PKM can wait. The installed service/database stay unchanged.
- CodeGraph 1.6.1 and Graphify 0.9.72 are installed in separate project-only images and their narrow source-projection/direct MCP tests passed. Graphify's graph has 3 files, 37 nodes, 48 edges and 6 communities, with seven permitted query tools and no model/API use. Config/state are under
infra/codegraph/andinfra/graphify/; no host/global install, backend ports, persistent watcher or harness registration. See the CodeGraph runbook and Graphify runbook. {{mstack:CLIENT_REPO_TITLE}}'s pre-existing Graphify remains untouched. Gateway foundation, synthetic qualification and both separately approved graph gateway connections are complete, including CodeGraph session qualification. - Gateway: agentgateway v1.5.0, official pinned ARM64 image, installed/running at macOS
127.0.0.1:58080. Strict API-key authentication and HTTP foundation tests passed after the separately approved network correction. Configuration underinfra/agentgateway/; dedicated normal bridge plus two separate internal graph networks./mcp/graphifyexposes seven authenticated query tools;/mcp/codegraphexposes onecodegraph_codegraph_exploretool; bare/mcpremains 503. Current Compose recipe is base gateway + CodeGraph overlay only, not both integration overlays. No model provider or harness registration. See the operating notes. MetaMCP was never installed; its patch/fork plan is superseded. - Harnesses: Codex + official DeepSeek Harness (
deepseek-ai/deepseek-harness). Existing DeepSeek CLI updated to0.2.0-rc.2; retained-home Web3080 and forwarder58081/native graph registration/discovery passed. No model/tool-job acceptance implied. Codex stack registration is pending; OpenCode optional, Xiaomi MiMo excluded. Current runbook. - n8n: official 2.41.6 installed and healthy on macOS OrbStack at127.0.0.1:5678, isolated PG18.6 DB/login, private named secret volume, read-only non-root app and bounded cache tmpfs. No paid license, Assistant/sandbox, models or starter kit. Foundation outcome. Built-in-node router passed25 tests,90 policy cases and4 bundled examples; approved manual import handoff, no Code runner required. Future connections/add-ons are deferred, not a mandatory installation chain.
- Latest final steps: use existing Codex IDE and Ubuntu global DeepSeek CLI; qualify Basic Memory text-search integration separately, leave models deferred and PKM optional. The start-work/operations runbook includes major n8n workflows, docs/notes locations and proposed manual bidirectional PKM sync. No connections/schedules enabled by documenting them.
- Synthetic gateway qualification completed: all eight checks passed after the separately approved fixture Host correction, including aggregation, discovery/direct-call enforcement, missing-claim denial, concurrent session/replay checks and fail-closed outage/recovery. Both temporary containers removed; live services/config/key/protected files unchanged. No real MCP server connected. Subsequent Graphify direct transport qualification is recorded below; gateway integration B is now separately completed below. CodeGraph follows independently and Basic Memory stays deferred.
- Restricted Graphify HTTP direct qualification completed: authenticated wrapper reuses installed image/unchanged seven-tool gate/read-only three-file index; all tool/resource/scope/auth/Host/Origin/reconnect/concurrency checks passed. Temporary container removed; private backend credential/hash config/source and empty internal network retained. No downloads, persistent service or gateway/harness registration. Subsequent persistent service A and gateway connection B are completed below; CodeGraph follows independently, Basic Memory deferred.
- Persistent Graphify HTTP setup A completed:
mcp-stack-graphify-httpis running, internal-only with no host port, reusing the pinned image/adapter/index/key. All direct tests passed; 19 pre-existing containers/267 protected hashes and checked macOS configs unchanged. HTTP is a local transport adapter, not an external provider. Gateway connection B is now approved/completed: seven tools, authentication separation, strict valid-request denials and concurrent sessions verified. Known limitation: malformed unprefixed resource URI returns HTTP 500 before dispatch, not an authorization pass.
Tool/service definitions and application configuration belong under infra/. Reusable harness integration source, tests and portable workflow definitions live under integrations/. Root Compose is an entry point only; project mise config is infra/mise.toml, with a root discovery symlink. Linux shared/CLI/Python profiles are under infra/toolchains/; macOS selections remain separate and unchanged. Home shell/command links are discovery plumbing, not independent tool declarations. Markdown lives at knowledge/main; Basic Memory's ignored config/log state is infra/basic-memory/state.
CodeGraph session qualification correction/retry is approved/completed: both graph endpoints now live, all connected suites and eight in-memory/cold route-replay denials passed. CodeGraph DELETE/reuse 404 and full native 32-session cleanup passed. Stateless Graphify permits authenticated same-route resumption after DELETE; this is not permanent token revocation. Only the gateway was recreated; all 20 other containers, data/indexes, keys, host configs and deliberate caffeinate unchanged. Earlier failed attempts remain in the history. Next: separately scoped project-local harness integration; Basic Memory stays deferred.
- Start-work and operations runbook
- Remaining functional phase: n8n + harness integration
- Setup status
- Database start, verification, and rollback
- Basic Memory setup, verification, and rollback
- Accepted memory routing and Basic Memory deferral
- CodeGraph setup, verified scope and repeatable tests
- CodeGraph HTTP direct qualification and next backend approval
- Graphify setup, verified scope and repeatable tests
- Agentgateway assessment and staged plan — foundation installed, integration pending
- Agentgateway foundation — installed, HTTP checks passed
- Gateway correction and completion report
- Historical MetaMCP source assessment — superseded
- Sharing setup and team knowledge without publishing private memory
- Database sharing and future AppFlowy/Supabase storage
- Deferred work and final standalone-skill TODO
- Agent instructions
- Project setup guard
Existing {{mstack:CLIENT_REPO}} Supabase resources are out of scope. Never run broad Docker cleanup or remove data volumes without explicit direction.