Setup project infrastructure and fix build issues

- Add MIT LICENSE file
- Add GitHub topics (ai, mcp, knowledge-base, claude, context-memory, coding-assistant)
- Configure pnpm workspace (pnpm-workspace.yaml, update scripts)
- Add ESLint configuration (.eslintrc.json)
- Create GitHub Actions CI workflow (Node 18.x and 20.x matrix)
- Fix TypeScript errors (type casting through unknown)
- Fix ESLint issues (unused variables, const declarations)
- Update .gitignore for build artifacts and lock files

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

Author: TerminalGravity

.eslintrc.json

@@ -0,0 +1,22 @@
+{
+  "root": true,
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "ignorePatterns": ["dist", "node_modules", "examples"],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Type check
+        run: pnpm run typecheck
+
+      - name: Lint
+        run: pnpm run lint
+
+      - name: Test
+        run: pnpm run test
+        continue-on-error: true  # Tests not implemented yet

.gitignore

@@ -5,9 +5,18 @@ node_modules/
 dist/
 *.tsbuildinfo
 
+# Example build outputs
+examples/**/*.js
+examples/**/*.d.ts
+examples/**/*.d.ts.map
+examples/**/*.js.map
+
 # Codebrain data (user's local index)
 .codebrain/
 
+# Claude Code plugin state
+.claude/
+
 # Environment
 .env
 .env.local
@@ -32,7 +41,6 @@ yarn-error.log*
 # Test coverage
 coverage/
 
-# Package manager locks (use one)
-# package-lock.json
-# yarn.lock
-# pnpm-lock.yaml
+# Package manager locks (keep pnpm-lock.yaml for reproducible builds)
+package-lock.json
+yarn.lock

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 codebrain contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package.json

@@ -3,14 +3,11 @@
   "version": "0.1.0",
   "description": "Persistent context index for AI coding agents",
   "private": true,
-  "workspaces": [
-    "packages/*"
-  ],
   "scripts": {
-    "build": "npm run build --workspaces",
-    "dev": "npm run dev --workspaces --if-present",
-    "test": "npm run test --workspaces --if-present",
-    "lint": "eslint packages/*/src",
+    "build": "pnpm -r run build",
+    "dev": "pnpm -r run dev --if-present",
+    "test": "pnpm -r run test --if-present",
+    "lint": "eslint 'packages/*/src/**/*.ts'",
     "typecheck": "tsc --build",
     "clean": "rm -rf packages/*/dist"
   },

packages/cli/src/cli.ts

@@ -24,7 +24,7 @@ program
   .command('init')
   .description('Initialize codebrain in the current project')
   .option('-n, --name <name>', 'Project name')
-  .action(async (options) => {
+  .action(async (_options) => {
     console.log(chalk.cyan('🧠 Initializing Codebrain...\n'));
 
     // TODO: Implement init
@@ -49,7 +49,7 @@ program
   .description('Index all configured sources')
   .option('-s, --source <source>', 'Index only this source')
   .option('--force', 'Re-index everything, ignoring cache')
-  .action(async (options) => {
+  .action(async (_options) => {
     console.log(chalk.cyan('🧠 Indexing sources...\n'));
 
     // TODO: Implement indexing
@@ -71,7 +71,7 @@ program
   .option('--scope <scope>', 'Filter by scope')
   .option('--type <type>', 'Filter by signal type')
   .option('--limit <n>', 'Max results', '10')
-  .action(async (query, options) => {
+  .action(async (query, _options) => {
     console.log(chalk.cyan(`🔍 Searching for: ${query}\n`));
 
     // TODO: Implement search
@@ -87,7 +87,7 @@ program
   .command('context <scope>')
   .description('Get formatted context for a scope')
   .option('--depth <depth>', 'Context depth: shallow, normal, deep', 'normal')
-  .action(async (scope, options) => {
+  .action(async (scope, _options) => {
     console.log(chalk.cyan(`📋 Getting context for: ${scope}\n`));
 
     // TODO: Implement context retrieval
@@ -118,7 +118,7 @@ program
   .command('serve')
   .description('Start the MCP server')
   .option('-p, --port <port>', 'Port for HTTP mode')
-  .action(async (options) => {
+  .action(async (_options) => {
     console.log(chalk.cyan('🚀 Starting Codebrain MCP server...\n'));
 
     // Import and start the MCP server
@@ -134,7 +134,7 @@ program
   .command('validate')
   .description('Validate signals and check freshness')
   .option('--fix', 'Automatically fix issues where possible')
-  .action(async (options) => {
+  .action(async (_options) => {
     console.log(chalk.cyan('✅ Validating signals...\n'));
 
     // TODO: Implement validation

packages/core/src/config.ts

@@ -5,12 +5,11 @@
  * to configure sources, signals, scopes, and behavior.
  */
 
-import type { 
-  BuiltInSignalType, 
-  CustomSignalType, 
+import type {
+  BuiltInSignalType,
+  CustomSignalType,
   Scope,
-  SourceType,
-  RawDocument 
+  RawDocument
 } from './types';
 
 // ═══════════════════════════════════════════════════════════════════

packages/extraction/src/extractor.ts

@@ -12,12 +12,11 @@ import type {
   SignalSource,
   CodeRef 
 } from '@codebrain/core';
-import { 
-  SYSTEM_PROMPT, 
+import {
+  SYSTEM_PROMPT,
   EXTRACTION_PROMPT,
   MEETING_EXTRACTION_PROMPT,
-  CLAUDE_CODE_EXTRACTION_PROMPT,
-  SIGNAL_TYPE_PROMPTS 
+  CLAUDE_CODE_EXTRACTION_PROMPT
 } from './prompts';
 import { randomUUID } from 'crypto';
 

packages/mcp-server/src/index.ts

@@ -11,12 +11,7 @@ import {
   ListToolsRequestSchema,
   Tool,
 } from '@modelcontextprotocol/sdk/types.js';
-import type { 
-  RetrievalQuery, 
-  RetrievalResult,
-  Signal,
-  FormattedContext 
-} from '@codebrain/core';
+import type { FormattedContext } from '@codebrain/core';
 
 // ═══════════════════════════════════════════════════════════════════
 // TYPES
@@ -218,9 +213,9 @@ This ensures the knowledge persists for future sessions.`,
 // SERVER
 // ═══════════════════════════════════════════════════════════════════
 
-export async function createServer(config: CodebrainMCPConfig): Promise<Server> {
+export async function createServer(_config: CodebrainMCPConfig): Promise<Server> {
   // TODO: Initialize storage and retrieval from config
-  // const storage = await initializeStorage(config.dataDir);
+  // const storage = await initializeStorage(_config.dataDir);
 
   const server = new Server(
     {
@@ -245,16 +240,16 @@ export async function createServer(config: CodebrainMCPConfig): Promise<Server>
 
     switch (name) {
       case 'codebrain_search':
-        return handleSearch(args as SearchArgs);
+        return handleSearch(args as unknown as SearchArgs);
 
       case 'codebrain_context':
-        return handleContext(args as ContextArgs);
+        return handleContext(args as unknown as ContextArgs);
 
       case 'codebrain_validate':
-        return handleValidate(args as ValidateArgs);
+        return handleValidate(args as unknown as ValidateArgs);
 
       case 'codebrain_record':
-        return handleRecord(args as RecordArgs);
+        return handleRecord(args as unknown as RecordArgs);
 
       case 'codebrain_status':
         return handleStatus();
@@ -310,12 +305,9 @@ async function handleContext(args: ContextArgs) {
   // TODO: Implement context retrieval and formatting
   // const signals = await storage.signals.getByScope(args.scope);
   // const formatted = formatContext(signals, args.depth);
-  
-  const depthLimits = {
-    shallow: 10,
-    normal: 30,
-    deep: 100,
-  };
+
+  // Depth limits for future implementation
+  // shallow: 10, normal: 30, deep: 100
 
   // Placeholder response showing expected format
   const placeholder: FormattedContext = {
@@ -363,7 +355,7 @@ interface ValidateArgs {
   filesAffected?: string[];
 }
 
-async function handleValidate(args: ValidateArgs) {
+async function handleValidate(_args: ValidateArgs) {
   // TODO: Implement validation logic
   // 1. Get all constraints and edge cases for scope
   // 2. Check if planned changes might violate any

packages/parsers/src/claude-code.ts

@@ -121,7 +121,7 @@ export async function parseConversationsDirectory(
   const files = await readdir(dirPath);
   const jsonlFiles = files.filter(f => f.endsWith('.jsonl'));
 
-  let conversations: ParsedConversation[] = [];
+  const conversations: ParsedConversation[] = [];
 
   for (const file of jsonlFiles) {
     const filePath = join(dirPath, file);