@phmotad/fire-code 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FireCode 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/README.md

@@ -0,0 +1,379 @@
+<h1 align="center">
+  🔥 Fire Code
+</h1>
+
+<h4 align="center">Intelligent MCP execution engine for AI coding agents — persistent memory, context-aware, Git-traceable.</h4>
+
+<p align="center">
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
+  </a>
+  <img src="https://img.shields.io/badge/version-0.2.0-green.svg" alt="Version">
+  <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
+  <img src="https://img.shields.io/badge/MCP-compatible-red.svg" alt="MCP">
+  <img src="https://img.shields.io/badge/Claude%20Code-plugin-orange.svg" alt="Claude Code Plugin">
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#how-it-works">How It Works</a> •
+  <a href="#mcp-tools">MCP Tools</a> •
+  <a href="#knowledge-corpus">Knowledge Corpus</a> •
+  <a href="#privacy">Privacy</a> •
+  <a href="#daemon">Daemon</a> •
+  <a href="#configuration">Configuration</a> •
+  <a href="#contributing">Contributing</a>
+</p>
+
+---
+
+## What is Fire Code?
+
+Fire Code is an open-source **Claude Code plugin** and **MCP server** that gives AI coding agents:
+
+- 🧠 **Hybrid Memory** — vector search (semantic, HNSW via Vectra) + dependency graph (SQLite + graphology)
+- 🔍 **Smart Code Search** — find symbols, functions, and patterns without reading every file
+- 📚 **Knowledge Corpus** — feed architecture docs, ADRs, and decisions directly into agent context
+- 🌿 **Git Traceability** — every AI-generated change gets its own branch and conventional commit
+- 📊 **Structural Outline** — understand any file without loading it fully (token-efficient)
+- 👁️ **Session Observations** — persistent log of what was built, fixed, and decided
+- 🔒 **Privacy Tags** — mark sections of code/docs as private; they never reach the LLM
+- ⚡ **Context-Aware Execution** — CodeAgent retrieves relevant context before writing code
+- 🔁 **Auto Re-index** — hooks re-index changed files after every `Write`/`Edit` tool call
+- 🖥️ **Web Daemon** — local HTTP server with dashboard, auto-started by hooks
+
+---
+
+## Quick Start
+
+**Install as a Claude Code plugin (one command):**
+
+```bash
+npx fire-code install
+```
+
+Or for Cursor / Windsurf:
+
+```bash
+npx fire-code install --ide cursor
+npx fire-code install --ide windsurf
+```
+
+**Index your project:**
+
+```bash
+cd your-project
+npx fire-code index
+```
+
+**Build the knowledge corpus** (optional but recommended):
+
+```bash
+npx fire-code corpus build   # indexes docs/, README.md, ADRs, etc.
+```
+
+**Restart Claude Code.** The MCP tools are now available in every session.
+
+---
+
+## How It Works
+
+### Architecture
+
+```
+Claude Code (host)
+  ├── Lifecycle Hooks
+  │     ├── SessionStart  → start daemon, inject .firecode/bootstrap.log context
+  │     ├── PostToolUse   → re-index changed files (Write/Edit)
+  │     └── Stop          → reserved for summarization
+  │
+  ├── Worker Daemon (port 37778)
+  │     ├── GET /health   → liveness check
+  │     ├── GET /         → web dashboard (dark theme)
+  │     ├── POST /index   → trigger re-index
+  │     ├── GET /context  → hybrid context retrieval
+  │     └── GET /observations → recent session log
+  │
+  └── MCP Server (stdio)
+        ├── Tier 1 — Fast
+        │     ├── firecode.smart_search   — symbol/content search (~50 tokens/result)
+        │     └── firecode.smart_outline  — file structure (folded view)
+        ├── Tier 2 — Memory
+        │     ├── firecode.get_context    — hybrid vector + graph retrieval
+        │     ├── firecode.search_code    — semantic similarity over embeddings
+        │     ├── firecode.get_graph      — dependency relationships (BFS, dependants)
+        │     ├── firecode.observations   — session history (what was built/fixed)
+        │     └── firecode.corpus_search  — search architecture docs and decisions
+        └── Tier 3 — Execute
+              └── firecode.execute        — full task execution with Git
+```
+
+### Storage (`.firecode/`)
+
+```
+.firecode/
+  firecode.db     — SQLite: graph nodes/edges, observations, corpus, sessions
+  vectors.db      — Vectra HNSW index (all-MiniLM-L6-v2 embeddings)
+  bootstrap.log   — indexing stats, injected on SessionStart
+  daemon.pid      — worker daemon PID (auto-managed)
+```
+
+### Recommended Workflow (token-efficient)
+
+```
+1. smart_search(query)        → find files/symbols (~50 tokens/result)
+2. smart_outline(file_path)   → see all symbols folded (~20 tokens/symbol)
+3. corpus_search(query)       → check architecture decisions and docs
+4. get_context(query)         → semantic + graph context for the task
+5. execute(task)              → make changes with Git traceability
+```
+
+---
+
+## MCP Tools
+
+| Tool | Tier | Description |
+|------|------|-------------|
+| `firecode.smart_search` | 1 — Fast | Search symbols, file names, content across codebase |
+| `firecode.smart_outline` | 1 — Fast | Structural outline of a file (functions, classes, types) |
+| `firecode.get_context` | 2 — Memory | Hybrid retrieval: vector semantic + graph traversal |
+| `firecode.search_code` | 2 — Memory | Semantic similarity search over indexed embeddings |
+| `firecode.get_graph` | 2 — Memory | Query dependency graph: nodes, edges, BFS, dependants |
+| `firecode.observations` | 2 — Memory | Session history: what was built, fixed, and decided |
+| `firecode.corpus_search` | 2 — Memory | Full-text search over architecture docs and ADRs |
+| `firecode.execute` | 3 — Execute | Full task: branch → context → CodeAgent → commit |
+
+### `get_graph` — advanced queries
+
+```typescript
+// Find all transitive dependencies of auth.ts
+get_graph({ neighbors: "src/auth.ts", depth: 3 })
+
+// Find everything that depends on crypto.ts
+get_graph({ dependants: "src/crypto.ts" })
+
+// List all nodes of a type
+get_graph({ type: "function" })
+```
+
+### Example session
+
+```typescript
+// Step 1: Find what exists
+smart_search({ query: "validateEmail", path: "src" })
+// → L5  export [function]  validateEmail(email: string): boolean
+
+// Step 2: Check architecture decisions
+corpus_search({ query: "password hashing policy" })
+// → architecture.md: "Passwords are hashed with SHA-256 + salt. Do not use MD5."
+
+// Step 3: Get semantic context
+get_context({ query: "add forgot password feature" })
+// → Returns relevant functions + dependency chain
+
+// Step 4: Execute with full traceability
+execute({ task: "add forgot password feature", type: "feature" })
+// → Creates branch firecode/feat/forgot-password
+// → Runs CodeAgent with context
+// → Commits: feat(auth): add forgot password feature
+```
+
+---
+
+## Knowledge Corpus
+
+The corpus lets you feed project knowledge (architecture notes, ADRs, onboarding docs) directly into agent context via `firecode.corpus_search`.
+
+```bash
+# Build from docs/ directory automatically
+npx fire-code corpus build
+
+# Add a single entry manually
+npx fire-code corpus prime --title "Auth Policy" --content "Never store raw passwords..."
+
+# Search the corpus
+npx fire-code corpus query "password hashing"
+```
+
+**Supported file types:** `.md`, `.txt`, `.rst`, `.mdx`
+
+**Chunking:** documents are split by heading and paragraph (max 1500 chars/chunk) for accurate retrieval.
+
+---
+
+## Privacy
+
+Mark any content as private — it will never be indexed, embedded, or sent to an LLM.
+
+### Inline tags
+
+```typescript
+// @private
+const SECRET_KEY = process.env.SECRET_KEY;
+
+// This is public context
+export function validateEmail(email: string): boolean { ... }
+
+<private>
+Internal implementation note: we use a vendor-specific workaround here.
+</private>
+```
+
+```markdown
+# public heading
+
+# private: internal architecture note that should not be in agent context
+```
+
+### File-level privacy
+
+Files matching these patterns are **never indexed:**
+
+```
+.env, .env.*, *.pem, *.key, *.cert, secrets.*, credentials.*
+```
+
+---
+
+## Daemon
+
+The Fire Code daemon is a local HTTP server (port 37778) that stays alive between sessions for instant context access. It is automatically started by the `SessionStart` hook.
+
+```bash
+npx fire-code daemon start   # start in background
+npx fire-code daemon stop    # stop
+npx fire-code daemon status  # show PID + health
+
+# The web dashboard is available at:
+open http://localhost:37778
+```
+
+The dashboard shows real-time project stats, recent observations, and allows triggering a re-index.
+
+---
+
+## Configuration
+
+Create `firecode.config.ts` in your project root (or run `fire-code init`):
+
+```typescript
+import type { FireCodeConfig } from '@phmotad/fire-code';
+
+export default {
+  project: {
+    name: 'my-project',
+  },
+  llm: {
+    provider: 'anthropic',       // anthropic | openai | openrouter | ollama
+    model: 'claude-sonnet-4-6',
+    apiKey: process.env.ANTHROPIC_API_KEY,
+  },
+  git: {
+    branchStrategy: 'increment', // reuse | increment | fail
+    workingTree: 'stash',        // stash | commit | fail | ignore
+    autoCommit: true,
+  },
+  indexing: {
+    mode: 'lazy',
+    include: ['**/*.ts', '**/*.tsx', '**/*.js'],
+    exclude: ['node_modules', 'dist', '.git'],
+  },
+} satisfies FireCodeConfig;
+```
+
+### LLM Providers
+
+| Provider | env var | Default model |
+|----------|---------|---------------|
+| `anthropic` | `ANTHROPIC_API_KEY` | `claude-sonnet-4-6` |
+| `openai` | `OPENAI_API_KEY` | `gpt-4o` |
+| `openrouter` | `OPENROUTER_API_KEY` | `deepseek/deepseek-coder` |
+| `ollama` | _(none)_ | `codellama` |
+
+---
+
+## CLI Commands
+
+```bash
+# Setup
+npx fire-code install          # Install plugin (Claude Code, Cursor, Windsurf)
+npx fire-code install --ide cursor
+npx fire-code uninstall        # Remove plugin from IDE configs
+npx fire-code init             # Interactive setup wizard
+npx fire-code update           # Update to latest version
+
+# Indexing
+npx fire-code index            # Index project (lazy mode)
+npx fire-code index --mode full  # Full re-index
+
+# Corpus
+npx fire-code corpus build     # Build corpus from docs/
+npx fire-code corpus prime     # Add a single entry manually
+npx fire-code corpus query <q> # Search the corpus
+
+# Daemon
+npx fire-code daemon start     # Start background daemon
+npx fire-code daemon stop      # Stop daemon
+npx fire-code daemon status    # Check daemon status
+
+# MCP Server
+npx fire-code dev              # Start MCP server (stdio)
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Fire Code is MIT-licensed and fully open source.
+
+```bash
+git clone https://github.com/phmotad/fire-code
+cd fire-code
+npm install
+npm run build
+npm test
+```
+
+### Project Structure
+
+```
+src/
+  cli/          — CLI commands (init, dev, index, install, daemon, corpus, update)
+  mcp/          — MCP server + tools
+  core/         — ExecutionEngine, TaskRouter
+  agents/       — CodeAgent
+  memory/       — HybridMemory, FallbackMemory
+  vector/       — VectraVectorStore (HNSW, all-MiniLM-L6-v2)
+  graph/        — SQLiteGraphStore (graphology traversal + SQLite persistence)
+  indexing/     — FileScanner, ASTParser, EmbeddingGenerator
+  git/          — GitManager, CommitFormatter
+  providers/    — LLM providers (Anthropic, OpenAI, Ollama, OpenRouter)
+  config/       — Zod schema, loader, defaults
+  daemon/       — DaemonServer (Express, port 37778), DaemonClient
+  services/     — CorpusService, ObservationService
+  utils/        — privacy.ts, logger.ts, errors.ts, paths.ts
+  db/           — DatabaseManager (SQLite), schema
+plugin/
+  hooks/        — hooks.json (lifecycle hooks)
+  scripts/      — hook runner scripts
+```
+
+### Running Tests
+
+```bash
+npm test              # all tests (84 passing)
+npm run test:unit     # unit tests only
+npm run test:coverage # with coverage report
+```
+
+---
+
+## License
+
+MIT © FireCode Contributors
+
+---
+
+<p align="center">
+  Built with ❤️ for the AI coding agent community.
+</p>

package/dist/agents/BaseAgent.d.ts

@@ -0,0 +1,32 @@
+import type { LLMProvider } from '../providers/LLMProvider.js';
+import type { HybridMemory } from '../memory/HybridMemory.js';
+import type { FireCodeConfig } from '../config/types.js';
+export interface AgentTask {
+    id: string;
+    description: string;
+    type: 'feature' | 'fix' | 'refactor' | 'docs';
+    mode?: 'safe' | 'aggressive';
+    context?: string;
+}
+export interface FileChange {
+    path: string;
+    content: string;
+    operation: 'create' | 'modify' | 'delete';
+}
+export interface AgentResult {
+    taskId: string;
+    success: boolean;
+    changes: FileChange[];
+    explanation: string;
+    durationMs: number;
+    error?: string;
+}
+export declare abstract class BaseAgent {
+    protected readonly provider: LLMProvider;
+    protected readonly memory: HybridMemory;
+    protected readonly config: FireCodeConfig;
+    constructor(provider: LLMProvider, memory: HybridMemory, config: FireCodeConfig);
+    abstract execute(task: AgentTask): Promise<AgentResult>;
+    protected log(msg: string, data?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=BaseAgent.d.ts.map

package/dist/agents/BaseAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8BAAsB,SAAS;IAE3B,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW;IACxC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IACvC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;gBAFtB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,cAAc;IAG3C,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAEvD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGjE"}

package/dist/agents/BaseAgent.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAgent = void 0;
+const logger_js_1 = require("../utils/logger.js");
+class BaseAgent {
+    provider;
+    memory;
+    config;
+    constructor(provider, memory, config) {
+        this.provider = provider;
+        this.memory = memory;
+        this.config = config;
+    }
+    log(msg, data) {
+        logger_js_1.logger.debug({ agent: this.constructor.name, ...data }, msg);
+    }
+}
+exports.BaseAgent = BaseAgent;
+//# sourceMappingURL=BaseAgent.js.map

package/dist/agents/BaseAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAgent.js","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":";;;AAGA,kDAA4C;AAyB5C,MAAsB,SAAS;IAER;IACA;IACA;IAHrB,YACqB,QAAqB,EACrB,MAAoB,EACpB,MAAsB;QAFtB,aAAQ,GAAR,QAAQ,CAAa;QACrB,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAgB;IACxC,CAAC;IAIM,GAAG,CAAC,GAAW,EAAE,IAA8B;QACvD,kBAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF;AAZD,8BAYC"}

package/dist/agents/CodeAgent.d.ts

@@ -0,0 +1,7 @@
+import { BaseAgent, type AgentTask, type AgentResult } from './BaseAgent.js';
+export declare class CodeAgent extends BaseAgent {
+    execute(task: AgentTask): Promise<AgentResult>;
+    private buildPrompt;
+    private applyChanges;
+}
+//# sourceMappingURL=CodeAgent.d.ts.map

package/dist/agents/CodeAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeAgent.d.ts","sourceRoot":"","sources":["../../src/agents/CodeAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AA4C9F,qBAAa,SAAU,SAAQ,SAAS;IAChC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IA8CpD,OAAO,CAAC,WAAW;YAcL,YAAY;CA8B3B"}

package/dist/agents/CodeAgent.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeAgent = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const BaseAgent_js_1 = require("./BaseAgent.js");
+const errors_js_1 = require("../utils/errors.js");
+const SYSTEM_PROMPT = `You are Fire Code, a deterministic code execution agent.
+
+Your job is to implement the given task by modifying source files.
+
+RULES:
+- Always respond with ONLY a JSON object (no markdown, no explanation outside JSON)
+- The JSON must have this exact shape:
+  {
+    "explanation": "brief description of what you did",
+    "changes": [
+      {
+        "path": "relative/path/to/file.ts",
+        "operation": "create" | "modify" | "delete",
+        "content": "full file content (empty string for delete)"
+      }
+    ]
+  }
+- For "modify": include the ENTIRE new file content
+- For "create": include the full content of the new file
+- For "delete": set content to ""
+- Paths must be relative to the project root
+- Follow existing code style and patterns from the context
+- Never break existing functionality
+- Be minimal: only change what's necessary`;
+function parseAgentResponse(raw) {
+    const cleaned = raw.trim().replace(/^```json\s*/i, '').replace(/```\s*$/i, '').trim();
+    try {
+        const parsed = JSON.parse(cleaned);
+        if (!parsed.explanation || !Array.isArray(parsed.changes)) {
+            throw new errors_js_1.ExecutionError('Invalid agent response structure');
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof errors_js_1.ExecutionError)
+            throw err;
+        throw new errors_js_1.ExecutionError(`Failed to parse agent response as JSON: ${String(err)}`, {
+            raw: raw.slice(0, 500),
+        });
+    }
+}
+class CodeAgent extends BaseAgent_js_1.BaseAgent {
+    async execute(task) {
+        const start = Date.now();
+        this.log('Starting task execution', { taskId: task.id, type: task.type });
+        try {
+            // 1. Retrieve context from memory
+            const ctx = await this.memory.retrieve(task.description, { k: 6 });
+            this.log('Context retrieved', { vectorResults: ctx.vectorResults.length, graphNodes: ctx.graphResults.length });
+            // 2. Build prompt
+            const prompt = this.buildPrompt(task, ctx.combined);
+            // 3. Call LLM
+            const raw = await this.provider.complete(prompt, {
+                systemPrompt: SYSTEM_PROMPT,
+                maxTokens: this.config.llm.maxTokens,
+                temperature: this.config.llm.temperature,
+            });
+            // 4. Parse response
+            const { explanation, changes } = parseAgentResponse(raw);
+            // 5. Apply changes (if not dry-run)
+            if (!this.config.execution.dryRun) {
+                await this.applyChanges(changes);
+            }
+            return {
+                taskId: task.id,
+                success: true,
+                changes,
+                explanation,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                taskId: task.id,
+                success: false,
+                changes: [],
+                explanation: '',
+                durationMs: Date.now() - start,
+                error: String(err),
+            };
+        }
+    }
+    buildPrompt(task, context) {
+        return `## Task
+Type: ${task.type}
+Description: ${task.description}
+Mode: ${task.mode ?? this.config.execution.mode}
+
+## Project Context
+${context}
+
+## Instructions
+Implement the task described above. Follow the existing patterns from the context.
+Return ONLY the JSON response as specified in your instructions.`;
+    }
+    async applyChanges(changes) {
+        const cwd = process.cwd();
+        for (const change of changes) {
+            const absPath = (0, path_1.join)(cwd, change.path);
+            if (change.operation === 'delete') {
+                // Don't actually delete — just log (safety: user can delete manually)
+                this.log('Skipping delete operation (safe mode)', { path: change.path });
+                continue;
+            }
+            const dir = (0, path_1.dirname)(absPath);
+            if (!(0, fs_1.existsSync)(dir)) {
+                (0, fs_1.mkdirSync)(dir, { recursive: true });
+            }
+            if (change.operation === 'modify' && this.config.execution.conflictStrategy === 'fail') {
+                if ((0, fs_1.existsSync)(absPath)) {
+                    const existing = (0, fs_1.readFileSync)(absPath, 'utf8');
+                    if (existing !== change.content) {
+                        this.log('Applying modify', { path: change.path });
+                    }
+                }
+            }
+            (0, fs_1.writeFileSync)(absPath, change.content, 'utf8');
+            this.log('Applied change', { path: change.path, operation: change.operation });
+        }
+    }
+}
+exports.CodeAgent = CodeAgent;
+//# sourceMappingURL=CodeAgent.js.map

package/dist/agents/CodeAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeAgent.js","sourceRoot":"","sources":["../../src/agents/CodeAgent.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/corpus.d.ts

@@ -0,0 +1,20 @@
+interface CorpusBuildOptions {
+    cwd: string;
+    includeCode?: boolean;
+}
+interface CorpusQueryOptions {
+    cwd: string;
+    limit?: number;
+}
+interface CorpusPrimeOptions {
+    cwd: string;
+    title: string;
+    content: string;
+    tags?: string[];
+    private?: boolean;
+}
+export declare function corpusBuildCommand(opts: CorpusBuildOptions): Promise<void>;
+export declare function corpusQueryCommand(query: string, opts: CorpusQueryOptions): Promise<void>;
+export declare function corpusPrimeCommand(opts: CorpusPrimeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=corpus.d.ts.map

package/dist/cli/commands/corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/corpus.ts"],"names":[],"mappings":"AAMA,UAAU,kBAAkB;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;AACnE,UAAU,kBAAkB;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,UAAU,kBAAkB;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AAEhH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhF"}