contextgit 0.0.1 → 0.0.2

package/.claude/settings.local.json

@@ -0,0 +1,41 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Skill(claude-api)",
+      "Skill(claude-api:*)",
+      "Bash(pnpm typecheck:*)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm build:*)",
+      "Bash(git push:*)",
+      "Read(//private/tmp/**)",
+      "Bash(node /Users/mendetrajovski/contextgit/packages/cli/bin/run.js --help)",
+      "Bash(node /Users/mendetrajovski/contextgit/packages/cli/bin/run.js commit -m \"First commit\" -c \"Set up the project structure\")",
+      "Bash(node /Users/mendetrajovski/contextgit/packages/cli/bin/run.js context)",
+      "Bash(pnpm install:*)",
+      "Bash(node packages/cli/bin/run.js init)",
+      "Bash(node packages/cli/bin/run.js context)",
+      "Bash(chmod +x /Users/mendetrajovski/contextgit/scripts/build.sh)",
+      "Bash(node packages/cli/bin/run.js context -f agents-md)",
+      "Bash(node packages/cli/bin/run.js commit -m \"Gate 2 ralph-loop: iteration 1\" -c \"Running ralph-loop validation gate. Wired RemoteStore into CLI+MCP bootstrap. Added scripts/build.sh. All 32 tests pass.\")",
+      "Bash(sed -e 's/@contextgit\\\\//@contextgit\\\\//g' -e 's/ContextGit/ContextGit/g' -e 's/contextgit/contextgit/g' CLAUDE.md)",
+      "Bash(mv CLAUDE.md.tmp CLAUDE.md)",
+      "Bash(node packages/cli/bin/run.js --help)",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: Days 14-15 oclif CLI Skeleton \\(2026-03-10\\) #6\" -c \"Built: packages/cli scaffolded \\(package.json, tsconfig.json, bin/run.js\\). config.ts: loadConfig/findConfigPath \\(duplicated from mcp to preserve dep graph\\). bootstrap.ts: shared setup for commit/context commands. commands/init.ts: generates nanoid projectId, creates project+branch, writes .contextgit/config.json, guards against double-init. commands/commit.ts: -m msg -c content -t threads --close ids. commands/context.ts: -f format prints store.getFormattedSnapshot\\(\\). core/types.ts: id? added to ProjectInput. LocalStore.createProject uses input.id ?? nanoid\\(\\). E2E validated in fresh tmp dir. Decided: config.ts duplicated in CLI \\(mcp→cli dep not allowed\\), ProjectInput.id? for init to match DB path key to entity ID, bootstrap\\(\\) shared helper, context command reads directly from store, commit --content defaults to --message. Unresolved: semanticSearch [], context scopes, server.tool\\(\\) deprecated, CLI not installable globally \\(chmod +x\\). Next: Days 16-17 Express REST API \\(POST /commits, GET /snapshot, GET /search\\).\")",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: Days 18-19 System-Prompt Fragment + AutoSnapshotManager \\(2026-03-10\\) #8\" -c \"Built: CLI init.ts self-heal: when config.json exists but DB empty, reads config, detects git branch, recreates project+branch instead of bailing. CLI init.ts: system-prompt fragment written to .contextgit/system-prompt.md and printed to stdout. AutoSnapshotManager: counts tool calls, fires engine.commit\\({commitType:''auto''}\\) every N=10 non-commit calls, resets on context_commit, swallows failures. mcp/server.ts: AutoSnapshotManager wired, autoSnapshot.onToolCall\\(toolName\\) in each tool handler. Dogfooded: contextgit init on this repo \\(self-heal triggered\\), contextgit commit and context confirmed. Decided: getBranchByGitName as DB health check for self-heal, AutoSnapshotManager counts context_get and context_search toward interval, loadConfig\\(\\) called twice in createServer\\(\\) \\(acceptable\\), commitType:''auto'' for observability. Unresolved: MCP not yet live-validated, server.tool\\(\\) deprecated, loadConfig\\(\\) called twice. Next: Days 20-21 configure Claude Code MCP, EmbeddingService with @xenova/transformers all-MiniLM-L6-v2.\")",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: Days 22-23 RemoteStore + FTS5 Fix \\(2026-03-11\\) #10\" -c \"Built: packages/api/src/store-router.ts: Express router exposing all 20 ContextStore methods as HTTP at /v1/store/... Float32Array serialized as number[]. packages/store/src/remote/index.ts: RemoteStore implementing ContextStore via fetch against store router, date-parsing helpers, Float32Array serialization. barrel exports updated. 7 integration tests \\(project/branch CRUD, commit retrieval, formatted snapshot identical to LocalStore, open thread round-trip, FTS search, mergeBranch\\). schema.ts: CREATE_FTS_TRIGGER AFTER INSERT ON commits, SCHEMA_V3_DDL. migrations.ts: v3 fts_trigger + FTS rebuild. queries.ts: fullTextSearch JOIN fixed from commits_fts.commit_id to c.rowid = commits_fts.rowid \\(content table rowid join\\). MCP confirmed live: context_get/context_commit/context_search visible in Claude Code — Gate 1 MCP validation PASS. All 32 tests pass. Decided: createStoreRouter separate from createApp \\(project-agnostic\\), integration test in api package, afterAll Promise-based cleanup, FTS5 content table bug fixed \\(rowid join\\), migration v3 trigger covers all INSERT paths. Unresolved: RemoteStore not wired in CLI/MCP bootstrap, server.tool\\(\\) deprecated, loadConfig\\(\\) twice, Gate 2/3 not yet validated. Next: Day 24 wire RemoteStore into CLI/MCP, Gate 2 ralph-loop CLI, Gate 3 REST curl, npx packaging.\")",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: Day 24 RemoteStore wiring + npx packaging + Phase 1 gates \\(2026-03-11\\) #11\" -c \"Built: packages/cli/src/bootstrap.ts: checks config.store !== ''local'', creates RemoteStore\\(config.store\\) when URL configured. mcp/server.ts: same RemoteStore/LocalStore switch. scripts/build.sh: builds all 5 packages in dep order via pnpm --filter. Root package.json: bin contextgit -> packages/cli/bin/run.js for npx. Gate 2 PASS \\(ralph-loop CLI\\): 3 iterations contextgit context -f agents-md -> contextgit commit, all 4 sections present \\(Project State, Current Branch, Recent Activity, Open Threads\\). Gate 3 PASS \\(REST API\\): GET /snapshot returns Project State, POST /commits returns {id,message,createdAt} 201. All 32 tests pass. Decided: config.store && !== ''local'' guard \\(handles missing field and explicit local\\), root package.json bin entry for npx, scripts/build.sh uses pnpm --filter for explicit ordering, Gate 3 uses flat routes not versioned URLs. Unresolved: server.tool\\(\\) deprecated, loadConfig\\(\\) twice, npx not tested in clean temp dir, Gate 1 formal cold-start not re-run. Next: Days 25-26 npx clean-install validation, Gate 1 formal cold-start.\")",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: Phase 1 Complete \\(2026-03-11\\)\" -c \"Full Phase 1 complete. Gate 1 MCP PASS, Gate 2 ralph-loop CLI PASS, Gate 3 REST API PASS, npx clean-install PASS. Renamed contexthub -> contextgit, npm name claimed. Slipped to Phase 2: git hooks integration, semantic search e2e validation. Next: Plan Phase 2 — RemoteStore, multi-agent, team support.\")",
+      "Bash(node packages/cli/bin/run.js commit -m \"Session: 2026-03-11 Phase 2 Kickoff\" -c \"Planning session only — nothing built. Phase 2 plan written and reviewed. Three updates added: busy_timeout mitigation, atomic pull transaction, doctor check, localhost hosting note. CLAUDE.md updated to point at Phase 2 plan. Remote hosting deferred to Phase 3 \\(Railway/fly.io\\) — localhost sufficient for Phase 2 validation. Plan is locked and ready to build. Next: Start Week 5. Build packages/mcp/src/git-sync.ts \\(captureGitMetadata + installGitHooks\\). Wire gitCommitSha and gitBranch into engine.commit\\(\\) via MCP and CLI. Fix double loadConfig\\(\\) bug in mcp/src/server.ts. Add context_branch and context_merge MCP tools.\")",
+      "mcp__contextgit__context_get",
+      "mcp__contextgit__context_commit",
+      "Bash(pnpm --filter @contextgit/core build)",
+      "Bash(git reset:*)",
+      "Bash(node packages/cli/dist/commands/remote-show.js --help)",
+      "Bash(node packages/cli/bin/run.js serve --help)",
+      "Bash(node packages/cli/bin/run.js doctor --help)",
+      "Bash(node packages/cli/bin/run.js commit --help)"
+    ]
+  }
+}

package/.contextgit/config.json

@@ -0,0 +1,10 @@
+{
+  "project": "contextgit",
+  "projectId": "contextgit-001",
+  "store": "local",
+  "agentRole": "solo",
+  "workflowType": "interactive",
+  "autoSnapshot": true,
+  "snapshotInterval": 10,
+  "embeddingModel": "local"
+}

package/.contextgit/system-prompt.md

@@ -0,0 +1,4 @@
+You have access to ContextGit memory tools. At the start of every session, call
+context_get with scope=global to load project state. After completing significant
+work, call context_commit with a message describing what was done and any open
+threads. Use context_branch before exploring risky changes.

package/.github/workflows/contextgit-ci.yml

@@ -0,0 +1,40 @@
+# contextgit-ci.yml — template for capturing CI context into ContextGit.
+#
+# Copy this into your project's .github/workflows/ directory and set the
+# required secrets (see below). Commits are written with agentRole=ci so
+# they can be filtered from agent snapshots using:
+#   context_get agent_role=ci    (MCP)
+#   contextgit log --all         (CLI)
+
+name: ContextGit CI
+
+on: [push, pull_request]
+
+jobs:
+  capture-context:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install contextgit
+        run: npm install -g contextgit
+
+      - name: Capture CI context
+        run: |
+          contextgit commit \
+            -m "CI run ${{ github.run_number }}: ${{ github.event.head_commit.message }}" \
+            --ci-run-id "${{ github.run_id }}" \
+            --pipeline "${{ github.workflow }}"
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          CONTEXTGIT_REMOTE: ${{ secrets.CONTEXTGIT_REMOTE_URL }}
+          CONTEXTGIT_API_KEY: ${{ secrets.CONTEXTGIT_API_KEY }}
+
+# Required secrets:
+#   ANTHROPIC_API_KEY      — for the rolling summarizer (Claude Haiku)
+#   CONTEXTGIT_REMOTE_URL  — URL of your ContextGit API server (from: contextgit serve)
+#   CONTEXTGIT_API_KEY     — API key (from: contextgit keygen --save)

package/CLAUDE.md

@@ -0,0 +1,123 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+ContextGit is a persistent memory layer for AI agent workflows — solving the 
+"amnesia problem" where agents lose context between sessions.
+
+## Repository
+GitHub: https://github.com/MendeTr/contextgit
+Branch: main
+Clone: git clone https://github.com/MendeTr/contextgit
+
+
+
+## Session Start (do this every time)
+Call context_get with scope=global immediately.
+Do not read decisions.md. Do not ask questions first.
+Read the snapshot. Then start working.
+Do not ask what to work on. Start the highest priority item from the snapshot.
+If unclear, follow the Phase 2 plan: docs/ContextGit_PHASE2_PLAN.md
+
+
+## After EVERY completed task
+git add .
+git commit -m "feat/fix: <what was done>"
+git push
+context_commit "what was built | key decisions | next task"
+
+Do not wait to be asked. Every completed task = immediate commit.
+This applies to bug fixes, feature additions, and refactors alike.
+
+## Session End (do this every time)
+Call context_commit with:
+- what was built
+- key decisions and why
+- open threads
+- the first concrete task for the next session
+Then: git add . && git commit -m "..." && git push
+```
+
+Then commit everything:
+```bash
+git add .
+git commit -m ": "
+git push
+```
+
+## Commit Convention
+- `feat:` new functionality
+- `feat(package):` scoped to a package e.g. `feat(core):`
+- `fix:` bug fix
+- `chore:` config, tooling, deps
+- `docs:` documentation only
+- `test:` tests only
+
+## Commands
+```bash
+pnpm install          # install dependencies
+pnpm build            # build all packages
+pnpm test             # run all tests
+pnpm test:watch       # watch mode
+pnpm typecheck        # type check all packages
+
+# Single package
+cd packages/store && pnpm test
+```
+
+Node.js >=20 and pnpm >=9 required.
+
+## Architecture
+
+Strict dependency graph — no circular deps:
+```
+core → @anthropic-ai/sdk, @xenova/transformers, nanoid
+store → core (types only), better-sqlite3, sqlite-vec
+mcp → core, store, @modelcontextprotocol/sdk, simple-git
+cli → core, store, @oclif/core
+api → core, store, express
+```
+
+### Packages
+- **`@contextgit/core`** — types, engine, summarizer, snapshot formatter, embeddings
+- **`@contextgit/store`** — ContextStore interface + LocalStore (SQLite)
+- **`packages/mcp`** — MCP server (Week 3)
+- **`packages/cli`** — oclif CLI (Week 3)
+- **`packages/api`** — Express REST API (Week 4)
+
+### Storage layer (`packages/store/src/local/`)
+| File | Role |
+|------|------|
+| `schema.ts` | DDL — tables, sqlite-vec, FTS5, indexes |
+| `migrations.ts` | Versioned migration runner |
+| `queries.ts` | All prepared statements + row→domain converters |
+| `index.ts` | LocalStore implementing ContextStore |
+
+### Key Rules (never break these)
+- TEXT primary keys via `nanoid()` — never auto-increment integers
+- `better-sqlite3` sync API wrapped in `Promise.resolve()` at interface boundary
+- Open threads **never** passed to summarizer — immune to compression guarantee
+- Never fail a COMMIT due to summarizer — graceful fallback always
+- DB path: `~/.contextgit/projects/<projectId>.db` — tests use `:memory:`
+- sqlite-vec loaded via `createRequire` shim — load failure degrades gracefully
+
+### Domain Model
+`Project → Branch → Commit` core hierarchy.
+`Thread` tracks open questions scoped to a project.
+`Agent` records active agents per project.
+All types in `packages/core/src/types.ts`.
+
+## TypeScript
+All packages extend `tsconfig.base.json`. Target: ES2022, module: NodeNext, 
+strict mode, declaration maps, source maps. Output: `./dist` per package.
+
+## Tests
+Vitest, in-memory SQLite. Each test file closes DB in `afterEach`.
+Root vitest config collects `packages/*/src/**/*.test.ts`.
+
+## Key Docs
+- `docs/decisions.md` — session history (read this first)
+- `docs/ContextGit_PHASE1_PLAN.md` — current build plan
+- `docs/ContextGit_ARCHITECTURE_v3.md` — full architecture
+- `docs/ContextGit_PRD_v4.md` — product requirements

package/CLAUDE.md.next

@@ -0,0 +1,65 @@
+# CLAUDE.md — ContextGit Agent Instructions
+
+## Session Start (do this every time)
+Call context_get with scope=global immediately.
+Do not read decisions.md. Do not ask questions first.
+Read the snapshot. Then start working.
+Do not ask what to work on. Start the highest priority item from the snapshot.
+If unclear, follow the phase plan: docs/ContextGit_PHASE2_PLAN.md
+If phase plan is complete, check docs/ContextGit_DELTA.md for open deltas.
+
+## After EVERY completed task
+git add .
+git commit -m "feat/fix: <what was done>"
+git push
+context_commit "what was built | key decisions | next task"
+
+Do not wait to be asked. Every completed task = immediate commit.
+This applies to bug fixes, feature additions, and refactors alike.
+
+## When scope changes mid-session
+1. Write a context_commit with replan: prefix immediately:
+   `context_commit "replan: <what changed and why. what is new scope. what is no longer in scope>"`
+2. Then build the new scope
+3. Write a normal context_commit when done
+
+Do not build first and replan after. Replan commit must come first.
+Other agents are reading the snapshot in real time.
+
+## When starting a task
+Before building anything, call:
+contextgit claim "<task name>"
+
+This prevents other agents from picking up the same task simultaneously.
+Claims auto-release on your next commit. You do not need to manually unclaim.
+If you abandon a task without committing, call: contextgit unclaim "<task name>"
+
+## Claim lifecycle
+proposed → active → released
+
+In plan mode: claim is written as proposed.
+On user approval: claim flips to active.
+On commit: claim is auto-released.
+On crash or abandon: claim expires after 2 hours (TTL).
+
+## Session End (do this every time)
+Call context_commit with:
+- what was built
+- key decisions and why
+- open threads
+- the first concrete task for the next session
+
+Then: git add . && git commit -m "..." && git push
+
+## Commit message conventions
+feat:   new functionality
+fix:    bug fix
+chore:  config, tooling, deps
+docs:   documentation only
+test:   tests only
+replan: scope change (use contextgit replan, not just a commit message)
+
+## Key files
+docs/ContextGit_PHASE2_PLAN.md   — current phase plan and status
+docs/ContextGit_DELTA.md         — scope changes discovered during development
+docs/IDEAS.md                    — future vision, do not build yet