contextgit 0.1.1 → 0.1.3

package/node_modules/@contextgit/mcp/src/config.ts

@@ -0,0 +1,53 @@
+// config.ts — load and validate .contextgit/config.json
+// Searches from CWD upwards until it finds the config file.
+
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import type { ContextGitConfig } from '@contextgit/core'
+
+export class ConfigNotFoundError extends Error {
+  constructor(startDir: string) {
+    super(`No .contextgit/config.json found searching upward from: ${startDir}`)
+    this.name = 'ConfigNotFoundError'
+  }
+}
+
+/**
+ * Search upward from `startDir` for `.contextgit/config.json`.
+ * Returns the first match found, or throws ConfigNotFoundError.
+ */
+export function findConfigPath(startDir: string = process.cwd()): string {
+  let current = startDir
+  while (true) {
+    const candidate = join(current, '.contextgit', 'config.json')
+    try {
+      readFileSync(candidate)
+      return candidate
+    } catch {
+      const parent = dirname(current)
+      if (parent === current) {
+        throw new ConfigNotFoundError(startDir)
+      }
+      current = parent
+    }
+  }
+}
+
+/**
+ * Load and parse `.contextgit/config.json`.
+ * Throws ConfigNotFoundError if not found, or Error if JSON is invalid.
+ */
+export function loadConfig(startDir?: string): ContextGitConfig & { configDir: string } {
+  const configPath = findConfigPath(startDir)
+  const raw = readFileSync(configPath, 'utf-8')
+  const config = JSON.parse(raw) as ContextGitConfig
+
+  if (!config.projectId) {
+    throw new Error(`Invalid config at ${configPath}: missing required field 'projectId'`)
+  }
+  if (!config.project) {
+    throw new Error(`Invalid config at ${configPath}: missing required field 'project'`)
+  }
+
+  return { ...config, configDir: dirname(configPath) }
+}

package/node_modules/@contextgit/mcp/src/git-sync.ts

@@ -0,0 +1,94 @@
+// git-sync.ts — git metadata capture and hook installation.
+//
+// captureGitMetadata: used by context_commit (MCP) and commit CLI command to
+//   auto-populate gitCommitSha on every context commit.
+//
+// installGitHooks: idempotent hook installer — writes post-commit,
+//   post-checkout, post-merge scripts into .git/hooks/.
+
+import { writeFileSync, readFileSync, mkdirSync, existsSync, appendFileSync } from 'fs'
+import { join, resolve } from 'path'
+import { homedir } from 'os'
+import { simpleGit } from 'simple-git'
+
+const SENTINEL = '# contextgit'
+const HOOKS_LOG = join(homedir(), '.contextgit', 'hooks.log')
+
+// ─── captureGitMetadata ────────────────────────────────────────────────────────
+
+/**
+ * Capture the current git commit SHA and branch name.
+ * Returns null on any error — must never block a context commit.
+ */
+export async function captureGitMetadata(
+  cwd: string,
+): Promise<{ sha: string; branch: string } | null> {
+  try {
+    const git = simpleGit(cwd)
+    const [sha, branch] = await Promise.all([
+      git.revparse(['HEAD']),
+      git.revparse(['--abbrev-ref', 'HEAD']),
+    ])
+    return { sha: sha.trim(), branch: branch.trim() }
+  } catch {
+    return null
+  }
+}
+
+// ─── installGitHooks ──────────────────────────────────────────────────────────
+
+const HOOK_SCRIPTS: Record<string, string> = {
+  'post-commit': `#!/bin/sh
+${SENTINEL}
+contextgit commit -m "git: $(git log -1 --pretty=%s)" 2>>"${HOOKS_LOG}" || true
+`,
+  'post-checkout': `#!/bin/sh
+${SENTINEL}
+contextgit context --quiet 2>>"${HOOKS_LOG}" || true
+`,
+  'post-merge': `#!/bin/sh
+${SENTINEL}
+contextgit commit -m "Merged into $(git rev-parse --abbrev-ref HEAD)" 2>>"${HOOKS_LOG}" || true
+`,
+}
+
+/**
+ * Install contextgit git hooks into <projectRoot>/.git/hooks/.
+ * Idempotent: checks for the sentinel comment before appending.
+ * Hook failures are logged to ~/.contextgit/hooks.log — never to stderr.
+ */
+export async function installGitHooks(projectRoot: string): Promise<void> {
+  const hooksDir = join(resolve(projectRoot), '.git', 'hooks')
+  mkdirSync(hooksDir, { recursive: true })
+
+  for (const [hookName, script] of Object.entries(HOOK_SCRIPTS)) {
+    const hookPath = join(hooksDir, hookName)
+
+    if (existsSync(hookPath)) {
+      const existing = readFileSync(hookPath, 'utf-8')
+      if (existing.includes(SENTINEL)) continue  // already installed
+      // Append to existing hook
+      writeFileSync(hookPath, existing.trimEnd() + '\n\n' + script)
+    } else {
+      writeFileSync(hookPath, script)
+    }
+
+    // Make executable (chmod +x)
+    try {
+      const { chmodSync } = await import('fs')
+      chmodSync(hookPath, 0o755)
+    } catch {
+      logHookError(`chmod failed for ${hookPath}`)
+    }
+  }
+}
+
+function logHookError(msg: string): void {
+  try {
+    const dir = join(homedir(), '.contextgit')
+    mkdirSync(dir, { recursive: true })
+    appendFileSync(HOOKS_LOG, `[${new Date().toISOString()}] ${msg}\n`)
+  } catch {
+    // truly silent
+  }
+}

package/node_modules/@contextgit/mcp/src/index.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+// index.ts — entry point for the ContextGit MCP server process.
+// Started by the MCP host (Claude Desktop / Claude Code) via stdio.
+
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { createServer } from './server.js'
+
+async function main(): Promise<void> {
+  const server = await createServer()
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+  // Server is now listening on stdin/stdout — process stays alive until the
+  // host closes the connection.
+}
+
+main().catch(err => {
+  console.error('[contextgit-mcp] Fatal error:', err)
+  process.exit(1)
+})