This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00

3.5 KiB

AITM Engines

AITM merges seven vendored repos in as first-party engines — built, imported, and managed as part of the product. There are no "assumed external service" seams (GITNEXUS_URL, CONTEXT7_URL, PAL_MCP_URL are gone).

Build everything with:

bash aitimemachine/scripts/build-engines.sh

This produces bundled binaries under aitimemachine/bin/ and a Python venv under aitimemachine/engines/pal/, and builds the TS engine libraries. Both directories are git-ignored.

The three layers

Memory — beads + context7

Engine What How it's wired
beads (beads/, Go) Task/issue DAG memory (Dolt-backed). Built to bin/bd; api-server/src/routes/beads.ts spawns it. Task creates write through to AITM memory.
context7 (context7/, TS) Up-to-date library/framework docs. In-process @upstash/context7-sdk (Context7 client). Configured by CONTEXT7_API_KEY.

Both feed AITM's unified memory: services/memoryService.ts ingests beads tasks (source='task') and context7 docs (source='library') into saved_contexts with embeddings, so /v1/contexts/search/* returns them alongside conversation memory. Schema change: saved_contexts.source (migration 0005_add_saved_context_source.sql).

Git — vendored C git + gitnexus

Engine What How it's wired
git (git/, C) The real Git (upstream C source). The Rust gitcore crate is a non-functional stub and is not used. Built to bin/git; src/core/git-engine.ts shells out (falls back to system git). Checkpoints mirror to a real git commit (AITM_GIT_MIRROR). aitm git … passthrough.
gitnexus (gitnexus/ + gitnexus-shared/, TS) Code-intelligence graph (Tree-sitter + LadybugDB). In-process via the new gitnexus library entry (gitnexus/src/index.ts → LocalBackend.callTool). gitNexusService.ts calls it directly; gn_* MCP tools unchanged.

Agentic comms — pal + a2a

Engine What How it's wired
a2a (a2a/, TS) Agent-to-agent protocol. Consolidated onto @a2a-js/sdk (DefaultRequestHandler, InMemoryTaskStore, A2AClient). The hand-rolled a2aService is replaced; registry backed by the SDK TaskStore.
pal (pal-mcp-server/, Python) Agent Python execution / multi-model orchestration (MCP, stdio). AITM-managed subprocess: api-server/src/engines/palEngine.ts spawns the bundled venv and speaks MCP over stdio. pal_* tools route through it.

Path resolution & health

  • api-server/src/services/engineManager.ts resolves bundled engine paths (bin/bd, bin/git, engines/pal) with first-party defaults — no external URLs.
  • GET /v1/health/providers reports each engine in-process/bundled: GitNexus → gitNexusService.isAvailable(); Context7 → CONTEXT7_API_KEY; PAL → palEngine.health(); beads → bin/bd --version; git → bundled/system.

Environment

Var Purpose Default
CONTEXT7_API_KEY Enable Context7 (replaces CONTEXT7_URL). —
AITM_MEMORY_USER_ID / AITM_MEMORY_PROJECT_ID Target for memory write-through when a request has no user/project. write-through skipped if unset
AITM_GIT_BIN Override git binary. bin/git → system git
AITM_GIT_MIRROR 0 disables mirroring checkpoints to git. enabled
PAL_VENV_DIR / PAL_PYTHON PAL venv / interpreter. engines/pal
BEADS_BINARY Override beads binary. bin/bd

Removed: GITNEXUS_URL, CONTEXT7_URL, PAL_URL, PAL_MCP_URL, AITM_A2A_AGENTS.