Initial commit: codebrain v0.1.0

Persistent context index for AI coding agents.

Packages:
- core: Configuration, storage, and type definitions
- cli: Command-line interface
- extraction: AI-powered knowledge extraction
- parsers: Source parsers (Claude Code, meetings)
- mcp-server: Model Context Protocol server

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: TerminalGravity

.gitignore

@@ -0,0 +1,38 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+*.tsbuildinfo
+
+# Codebrain data (user's local index)
+.codebrain/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Test coverage
+coverage/
+
+# Package manager locks (use one)
+# package-lock.json
+# yarn.lock
+# pnpm-lock.yaml

CONTRIBUTING.md

@@ -0,0 +1,119 @@
+# Contributing to Codebrain
+
+Thanks for your interest in contributing to Codebrain!
+
+## Development Setup
+
+1. Clone the repo:
+```bash
+git clone https://github.com/YOUR_USERNAME/codebrain.git
+cd codebrain
+```
+
+2. Install dependencies:
+```bash
+npm install
+```
+
+3. Build all packages:
+```bash
+npm run build
+```
+
+4. Run in development mode:
+```bash
+npm run dev
+```
+
+## Project Structure
+
+```
+packages/
+├── core/           # Types, config, storage interface
+├── parsers/        # Source parsers (Claude Code, meetings, git)
+├── extraction/     # LLM signal extraction
+├── mcp-server/     # MCP server for Claude Code integration
+└── cli/            # Command line interface
+```
+
+## Making Changes
+
+1. Create a branch for your feature:
+```bash
+git checkout -b feature/your-feature
+```
+
+2. Make your changes
+
+3. Run type checking:
+```bash
+npm run typecheck
+```
+
+4. Run linting:
+```bash
+npm run lint
+```
+
+5. Test your changes locally
+
+6. Commit with a descriptive message:
+```bash
+git commit -m "feat: add support for X"
+```
+
+## Commit Convention
+
+We use conventional commits:
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation
+- `refactor:` Code refactoring
+- `test:` Tests
+- `chore:` Maintenance
+
+## Pull Requests
+
+1. Push your branch
+2. Open a PR against `main`
+3. Fill out the PR template
+4. Wait for review
+
+## Adding a New Parser
+
+1. Create a new file in `packages/parsers/src/`
+2. Export a parse function that returns `RawDocument`
+3. Add to `packages/parsers/src/index.ts`
+4. Add tests
+
+Example:
+```typescript
+import type { RawDocument } from '@codebrain/core';
+
+export async function parseMySource(filePath: string): Promise<RawDocument> {
+  // Parse the file
+  return {
+    id: '...',
+    type: 'my_source',
+    path: filePath,
+    content: '...',
+    metadata: {},
+    indexedAt: new Date(),
+    hash: '...',
+  };
+}
+```
+
+## Adding a Custom Signal Type
+
+1. Update `packages/core/src/types.ts` if it's a built-in type
+2. Add extraction prompt in `packages/extraction/src/prompts.ts`
+3. Document in README
+
+## Questions?
+
+Open an issue or start a discussion.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.