contextgit 0.0.2 → 0.0.3

package/.claude/settings.local.json

@@ -1,41 +0,0 @@
-{
-  "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

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

package/.contextgit/system-prompt.md

@@ -1,4 +0,0 @@
-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

@@ -1,40 +0,0 @@
-# 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

@@ -1,123 +0,0 @@
-# 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

@@ -1,65 +0,0 @@
-# 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