contextgit 0.0.2 → 0.0.3

package/packages/api/src/store-router.ts

@@ -1,241 +0,0 @@
-// store-router.ts — Express router providing direct ContextStore access over HTTP.
-//
-// Mounted at a path prefix (e.g. /v1/store). Used by RemoteStore clients.
-//
-// Routes:
-//   POST   /projects                              → createProject
-//   GET    /projects/:id                          → getProject
-//   POST   /branches                              → createBranch
-//   GET    /branches/:id                          → getBranch
-//   GET    /projects/:projectId/branches?git=     → getBranchByGitName
-//   GET    /projects/:projectId/branches          → listBranches
-//   PUT    /branches/:id/head                     → updateBranchHead
-//   POST   /branches/:id/merge                    → mergeBranch
-//   POST   /commits                               → createCommit
-//   GET    /commits/:id                           → getCommit
-//   GET    /branches/:branchId/commits            → listCommits
-//   GET    /projects/:id/snapshot                 → getFormattedSnapshot
-//   GET    /projects/:id/session-snapshot         → getSessionSnapshot
-//   GET    /projects/:id/threads                  → listOpenThreads
-//   GET    /branches/:branchId/threads            → listOpenThreadsByBranch
-//   POST   /commits/:id/embedding                 → indexEmbedding
-//   POST   /projects/:id/search/semantic          → semanticSearch
-//   GET    /projects/:id/search                   → fullTextSearch
-//   POST   /agents                                → upsertAgent
-//   GET    /projects/:id/agents                   → listAgents
-
-import { Router, Request, Response } from 'express'
-import type { ContextStore } from '@contextgit/store'
-import type {
-  AgentInput,
-  BranchInput,
-  CommitInput,
-  Pagination,
-  ProjectInput,
-  SnapshotFormat,
-  Thread,
-} from '@contextgit/core'
-
-function err(res: Response, e: unknown): void {
-  const msg = e instanceof Error ? e.message : String(e)
-  res.status(500).json({ error: msg })
-}
-
-export function createStoreRouter(store: ContextStore): Router {
-  const r = Router()
-
-  // ── Projects ──────────────────────────────────────────────────────────────
-
-  r.post('/projects', async (req: Request, res: Response) => {
-    try {
-      const result = await store.createProject(req.body as ProjectInput)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/projects/:id', async (req: Request, res: Response) => {
-    try {
-      const result = await store.getProject(req.params['id']!)
-      if (!result) { res.status(404).json({ error: 'Not found' }); return }
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Branches ──────────────────────────────────────────────────────────────
-
-  r.post('/branches', async (req: Request, res: Response) => {
-    try {
-      const result = await store.createBranch(req.body as BranchInput)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/branches/:id', async (req: Request, res: Response) => {
-    try {
-      const result = await store.getBranch(req.params['id']!)
-      if (!result) { res.status(404).json({ error: 'Not found' }); return }
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // GET /projects/:projectId/branches?git=<name>  → getBranchByGitName
-  // GET /projects/:projectId/branches             → listBranches
-  r.get('/projects/:projectId/branches', async (req: Request, res: Response) => {
-    try {
-      const { projectId } = req.params as { projectId: string }
-      const git = req.query['git'] as string | undefined
-      if (git) {
-        const result = await store.getBranchByGitName(projectId, git)
-        if (!result) { res.status(404).json({ error: 'Not found' }); return }
-        res.json(result)
-      } else {
-        const result = await store.listBranches(projectId)
-        res.json(result)
-      }
-    } catch (e) { err(res, e) }
-  })
-
-  r.put('/branches/:id/head', async (req: Request, res: Response) => {
-    try {
-      const { commitId } = req.body as { commitId: string }
-      await store.updateBranchHead(req.params['id']!, commitId)
-      res.status(204).end()
-    } catch (e) { err(res, e) }
-  })
-
-  r.post('/branches/:id/merge', async (req: Request, res: Response) => {
-    try {
-      const { targetBranchId, summary } = req.body as { targetBranchId: string; summary: string }
-      const result = await store.mergeBranch(req.params['id']!, targetBranchId, summary)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Commits ───────────────────────────────────────────────────────────────
-
-  r.post('/commits', async (req: Request, res: Response) => {
-    try {
-      const result = await store.createCommit(req.body as CommitInput)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/commits/:id', async (req: Request, res: Response) => {
-    try {
-      const result = await store.getCommit(req.params['id']!)
-      if (!result) { res.status(404).json({ error: 'Not found' }); return }
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/branches/:branchId/commits', async (req: Request, res: Response) => {
-    try {
-      const pagination: Pagination = {
-        limit: parseInt(String(req.query['limit'] ?? '10'), 10),
-        offset: parseInt(String(req.query['offset'] ?? '0'), 10),
-      }
-      const result = await store.listCommits(req.params['branchId']!, pagination)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Snapshots ─────────────────────────────────────────────────────────────
-
-  // GET /projects/:id/snapshot?branchId=&format=  → getFormattedSnapshot
-  r.get('/projects/:id/snapshot', async (req: Request, res: Response) => {
-    try {
-      const projectId = req.params['id']!
-      const branchId = String(req.query['branchId'] ?? '')
-      const format = String(req.query['format'] ?? 'text') as SnapshotFormat
-      if (!branchId) { res.status(400).json({ error: "'branchId' query param required" }); return }
-      const result = await store.getFormattedSnapshot(projectId, branchId, format)
-      const ct = format === 'json' ? 'application/json' : 'text/plain; charset=utf-8'
-      res.setHeader('Content-Type', ct).send(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // GET /projects/:id/session-snapshot?branchId=  → getSessionSnapshot
-  r.get('/projects/:id/session-snapshot', async (req: Request, res: Response) => {
-    try {
-      const projectId = req.params['id']!
-      const branchId = String(req.query['branchId'] ?? '')
-      if (!branchId) { res.status(400).json({ error: "'branchId' query param required" }); return }
-      const agentRole = req.query['agentRole'] ? String(req.query['agentRole']) : undefined
-      const result = await store.getSessionSnapshot(projectId, branchId, agentRole ? { agentRole: agentRole as import('@contextgit/core').AgentRole } : undefined)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Threads ───────────────────────────────────────────────────────────────
-
-  r.post('/threads', async (req: Request, res: Response) => {
-    try {
-      const body = req.body as Thread
-      // Parse createdAt from ISO string to Date
-      const thread: Thread = { ...body, createdAt: new Date(body.createdAt) }
-      const result = await store.syncThread(thread)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/projects/:id/threads', async (req: Request, res: Response) => {
-    try {
-      const result = await store.listOpenThreads(req.params['id']!)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/branches/:branchId/threads', async (req: Request, res: Response) => {
-    try {
-      const result = await store.listOpenThreadsByBranch(req.params['branchId']!)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Embeddings & Search ───────────────────────────────────────────────────
-
-  r.post('/commits/:id/embedding', async (req: Request, res: Response) => {
-    try {
-      const { vector } = req.body as { vector: number[] }
-      await store.indexEmbedding(req.params['id']!, new Float32Array(vector))
-      res.status(204).end()
-    } catch (e) { err(res, e) }
-  })
-
-  r.post('/projects/:id/search/semantic', async (req: Request, res: Response) => {
-    try {
-      const { vector, limit } = req.body as { vector: number[]; limit?: number }
-      const result = await store.semanticSearch(new Float32Array(vector), req.params['id']!, limit ?? 5)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/projects/:id/search', async (req: Request, res: Response) => {
-    try {
-      const q = req.query['q']
-      if (typeof q !== 'string' || !q.trim()) {
-        res.status(400).json({ error: "'q' query param required" }); return
-      }
-      const result = await store.fullTextSearch(q, req.params['id']!)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  // ── Agents ────────────────────────────────────────────────────────────────
-
-  r.post('/agents', async (req: Request, res: Response) => {
-    try {
-      const result = await store.upsertAgent(req.body as AgentInput)
-      res.status(201).json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  r.get('/projects/:id/agents', async (req: Request, res: Response) => {
-    try {
-      const result = await store.listAgents(req.params['id']!)
-      res.json(result)
-    } catch (e) { err(res, e) }
-  })
-
-  return r
-}

package/packages/api/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "rootDir": "./src",
-    "outDir": "./dist"
-  },
-  "include": ["src"]
-}

package/packages/cli/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "@contextgit/cli",
-  "version": "0.0.1",
-  "type": "module",
-  "bin": {
-    "contextgit": "./bin/run.js"
-  },
-  "oclif": {
-    "bin": "contextgit",
-    "dirname": "contextgit",
-    "commands": "./dist/commands"
-  },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@contextgit/api": "workspace:*",
-    "@contextgit/core": "workspace:*",
-    "@contextgit/store": "workspace:*",
-    "@oclif/core": "^3.27.0",
-    "nanoid": "^5.0.0",
-    "simple-git": "^3.27.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0"
-  }
-}

package/packages/cli/src/bootstrap.ts

@@ -1,68 +0,0 @@
-// bootstrap.ts — shared setup for commit/context commands.
-// Loads config, opens LocalStore, detects git branch, initializes ContextEngine.
-
-import os from 'os'
-import { simpleGit } from 'simple-git'
-import { ContextEngine } from '@contextgit/core'
-import { LocalStore, RemoteStore } from '@contextgit/store'
-import type { ContextStore } from '@contextgit/store'
-import { loadConfig } from './config.js'
-
-export interface CliContext {
-  engine: ContextEngine
-  store: ContextStore
-  projectId: string
-  branchId: string
-}
-
-async function detectGitBranch(): Promise<string> {
-  try {
-    const git = simpleGit(process.cwd())
-    const result = await git.revparse(['--abbrev-ref', 'HEAD'])
-    return result.trim()
-  } catch {
-    return 'main'
-  }
-}
-
-async function resolveContextBranch(
-  store: ContextStore,
-  projectId: string,
-  gitBranch: string,
-): Promise<string> {
-  const existing = await store.getBranchByGitName(projectId, gitBranch)
-  if (existing) return existing.id
-
-  const created = await store.createBranch({
-    projectId,
-    name: `Context: ${gitBranch}`,
-    gitBranch,
-  })
-  return created.id
-}
-
-export async function bootstrap(): Promise<CliContext> {
-  const config = loadConfig()
-  const { projectId } = config
-
-  const store: ContextStore =
-    config.store && config.store !== 'local'
-      ? new RemoteStore(config.store)
-      : new LocalStore(projectId)
-  const gitBranch = await detectGitBranch()
-  const branchId = await resolveContextBranch(store, projectId, gitBranch)
-
-  const hostname = os.hostname()
-  const agentId = `${hostname}-cli-interactive`
-
-  const engine = new ContextEngine(
-    store,
-    agentId,
-    config.agentRole ?? 'solo',
-    'contextgit-cli',
-    config.workflowType ?? 'interactive',
-  )
-  await engine.init(projectId, branchId)
-
-  return { engine, store, projectId, branchId }
-}

package/packages/cli/src/commands/branch.ts

@@ -1,58 +0,0 @@
-// branch — create a new context branch.
-
-import { Command, Args, Flags } from '@oclif/core'
-import { simpleGit } from 'simple-git'
-import { LocalStore } from '@contextgit/store'
-import { loadConfig } from '../config.js'
-
-async function currentGitBranch(cwd: string): Promise<string> {
-  try {
-    return (await simpleGit(cwd).revparse(['--abbrev-ref', 'HEAD'])).trim()
-  } catch {
-    return 'main'
-  }
-}
-
-export default class BranchCmd extends Command {
-  static description = 'Create a new context branch'
-
-  static args = {
-    name: Args.string({
-      description: 'Branch name (human-readable label)',
-      required: true,
-    }),
-  }
-
-  static flags = {
-    git: Flags.string({
-      description: 'Git branch name to associate (defaults to current git branch)',
-      required: false,
-    }),
-    parent: Flags.string({
-      description: 'Parent branch ID',
-      required: false,
-    }),
-  }
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(BranchCmd)
-    const config = loadConfig()
-    const store = new LocalStore(config.projectId)
-    const cwd = process.cwd()
-
-    const gitBranch = flags.git ?? (await currentGitBranch(cwd))
-
-    const branch = await store.createBranch({
-      projectId: config.projectId,
-      name: args.name,
-      gitBranch,
-      parentBranchId: flags.parent,
-    })
-
-    this.log(`Branch created.`)
-    this.log(`ID:      ${branch.id}`)
-    this.log(`Name:    ${branch.name}`)
-    this.log(`Git:     ${branch.gitBranch}`)
-    if (branch.parentBranchId) this.log(`Parent:  ${branch.parentBranchId}`)
-  }
-}

package/packages/cli/src/commands/claim.ts

@@ -1,58 +0,0 @@
-// claim — create a task claim to prevent concurrent agent work.
-
-import { Command, Args, Flags } from '@oclif/core'
-import { LocalStore } from '@contextgit/store'
-import { loadConfig } from '../config.js'
-
-export default class ClaimCmd extends Command {
-  static description = 'Claim a task to prevent other agents from picking it up simultaneously'
-
-  static args = {
-    task: Args.string({
-      description: 'Short description of the task being claimed',
-      required: true,
-    }),
-  }
-
-  static flags = {
-    ttl: Flags.integer({
-      description: 'Time-to-live in hours before the claim auto-expires',
-      default: 2,
-    }),
-    status: Flags.string({
-      description: "Claim status: 'proposed' (plan mode) or 'active' (approved, work in progress)",
-      default: 'proposed',
-      options: ['proposed', 'active'],
-    }),
-  }
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(ClaimCmd)
-    const config = loadConfig()
-    const store = new LocalStore(config.projectId)
-
-    // Resolve current branch
-    const branch = await store.getBranchByGitName(config.projectId, 'main')
-    const branches = await store.listBranches(config.projectId)
-    const activeBranch = branches.find((b) => b.status === 'active') ?? branches[0]
-    if (!activeBranch) {
-      this.error('No branch found. Run contextgit init first.')
-    }
-
-    const claim = await store.claimTask(config.projectId, activeBranch.id, {
-      task: args.task,
-      agentId: `cli-${process.env.USER ?? 'unknown'}`,
-      role: config.agentRole ?? 'solo',
-      status: flags.status as 'proposed' | 'active',
-      ttl: flags.ttl * 3_600_000,
-    })
-
-    this.log(`Claimed.`)
-    this.log(`ID:     ${claim.id}`)
-    this.log(`Task:   ${claim.task}`)
-    this.log(`Status: ${claim.status}`)
-    this.log(`TTL:    ${flags.ttl}h`)
-
-    store.close()
-  }
-}

package/packages/cli/src/commands/commit.ts

@@ -1,79 +0,0 @@
-// commit — record a context commit via engine.commit().
-
-import { Command, Flags } from '@oclif/core'
-import { simpleGit } from 'simple-git'
-import { bootstrap } from '../bootstrap.js'
-
-async function captureGitSha(cwd: string): Promise<string | undefined> {
-  try {
-    return (await simpleGit(cwd).revparse(['HEAD'])).trim()
-  } catch {
-    return undefined
-  }
-}
-
-export default class CommitCmd extends Command {
-  static description = 'Record a context commit'
-
-  static flags = {
-    message: Flags.string({
-      char: 'm',
-      description: 'Short commit message (what was accomplished)',
-      required: true,
-    }),
-    content: Flags.string({
-      char: 'c',
-      description: 'Detailed commit content. Defaults to the message if omitted.',
-      required: false,
-    }),
-    thread: Flags.string({
-      char: 't',
-      description: 'Open a new thread (can be repeated)',
-      multiple: true,
-      required: false,
-    }),
-    close: Flags.string({
-      description: 'Close a thread by ID (can be repeated)',
-      multiple: true,
-      required: false,
-    }),
-    'ci-run-id': Flags.string({
-      description: 'CI run ID (e.g. GitHub Actions run ID)',
-      required: false,
-      env: 'GITHUB_RUN_ID',
-    }),
-    pipeline: Flags.string({
-      description: 'CI pipeline / workflow name',
-      required: false,
-      env: 'GITHUB_WORKFLOW',
-    }),
-  }
-
-  async run(): Promise<void> {
-    const { flags } = await this.parse(CommitCmd)
-    const ctx = await bootstrap()
-
-    const threads: {
-      open?: string[]
-      close?: Array<{ id: string; note: string }>
-    } = {}
-    if (flags.thread?.length) threads.open = flags.thread
-    if (flags.close?.length) {
-      threads.close = flags.close.map(id => ({ id, note: 'Closed via CLI' }))
-    }
-
-    const gitCommitSha = await captureGitSha(process.cwd())
-    const commit = await ctx.engine.commit({
-      message: flags.message,
-      content: flags.content ?? flags.message,
-      gitCommitSha,
-      ciRunId: flags['ci-run-id'],
-      pipelineName: flags.pipeline,
-      ...(Object.keys(threads).length > 0 ? { threads } : {}),
-    })
-
-    this.log(`Commit recorded.`)
-    this.log(`ID:      ${commit.id}`)
-    this.log(`Message: ${commit.message}`)
-  }
-}

package/packages/cli/src/commands/context.ts

@@ -1,46 +0,0 @@
-// context — print the current project snapshot to stdout.
-
-import { Command, Flags } from '@oclif/core'
-import { simpleGit } from 'simple-git'
-import { LocalStore } from '@contextgit/store'
-import type { SnapshotFormat } from '@contextgit/core'
-import { loadConfig } from '../config.js'
-
-export default class ContextCmd extends Command {
-  static description = 'Print the current project context snapshot'
-
-  static flags = {
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['agents-md', 'json', 'text'],
-      default: 'text',
-    }),
-  }
-
-  async run(): Promise<void> {
-    const { flags } = await this.parse(ContextCmd)
-    const config = loadConfig()
-    const store = new LocalStore(config.projectId)
-
-    // Detect current git branch
-    let gitBranch = 'main'
-    try {
-      const git = simpleGit(process.cwd())
-      gitBranch = (await git.revparse(['--abbrev-ref', 'HEAD'])).trim()
-    } catch {
-      // fallback to 'main'
-    }
-
-    const branch = await store.getBranchByGitName(config.projectId, gitBranch)
-    if (!branch) {
-      this.error(
-        `No context branch found for git branch '${gitBranch}'. Run 'contextgit init' first.`,
-      )
-    }
-
-    const format = (flags.format ?? 'text') as SnapshotFormat
-    const snapshot = await store.getFormattedSnapshot(config.projectId, branch.id, format)
-    this.log(snapshot)
-  }
-}