@phmotad/fire-code 0.2.0

package/dist/vector/MemoryVectorStore.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryVectorStore = void 0;
+const logger_js_1 = require("../utils/logger.js");
+let pipelineCache = null;
+async function getEmbedding(text) {
+    try {
+        if (!pipelineCache) {
+            const { pipeline } = await import('@xenova/transformers');
+            pipelineCache = (await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2'));
+        }
+        const output = await pipelineCache([text], { pooling: 'mean', normalize: true });
+        return Array.from(output.data[0]);
+    }
+    catch {
+        // Fallback: zero vector of dim 384
+        return new Array(384).fill(0);
+    }
+}
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+// Text-only fallback using TF-IDF-like term overlap
+function textSimilarity(query, text) {
+    const queryTerms = new Set(query.toLowerCase().split(/\W+/).filter(Boolean));
+    const textTerms = text.toLowerCase().split(/\W+/).filter(Boolean);
+    if (queryTerms.size === 0 || textTerms.length === 0)
+        return 0;
+    const matches = textTerms.filter((t) => queryTerms.has(t)).length;
+    return matches / (queryTerms.size + textTerms.length - matches);
+}
+class MemoryVectorStore {
+    documents = new Map();
+    useEmbeddings = true;
+    constructor(opts) {
+        if (opts?.useEmbeddings === false)
+            this.useEmbeddings = false;
+    }
+    async add(documents) {
+        for (const doc of documents) {
+            this.documents.set(doc.id, doc);
+        }
+        logger_js_1.logger.debug({ count: documents.length }, 'Documents added to vector store');
+    }
+    async search(query, k = 5) {
+        const docs = Array.from(this.documents.values());
+        if (docs.length === 0)
+            return [];
+        const docsWithEmbeddings = docs.filter((d) => d.embedding && d.embedding.length > 0);
+        let scored;
+        if (this.useEmbeddings && docsWithEmbeddings.length > 0) {
+            const queryEmbedding = await getEmbedding(query);
+            scored = docsWithEmbeddings.map((doc) => ({
+                document: doc,
+                score: cosineSimilarity(queryEmbedding, doc.embedding),
+            }));
+        }
+        else {
+            scored = docs.map((doc) => ({
+                document: doc,
+                score: textSimilarity(query, doc.text),
+            }));
+        }
+        return scored.sort((a, b) => b.score - a.score).slice(0, k);
+    }
+    async delete(ids) {
+        for (const id of ids)
+            this.documents.delete(id);
+    }
+    async clear() {
+        this.documents.clear();
+    }
+    size() {
+        return this.documents.size;
+    }
+    serialize() {
+        return JSON.stringify(Array.from(this.documents.values()));
+    }
+    static deserialize(data) {
+        const store = new MemoryVectorStore();
+        const docs = JSON.parse(data);
+        for (const doc of docs)
+            store.documents.set(doc.id, doc);
+        return store;
+    }
+}
+exports.MemoryVectorStore = MemoryVectorStore;
+//# sourceMappingURL=MemoryVectorStore.js.map

package/dist/vector/MemoryVectorStore.js.map

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

package/dist/vector/VectorStore.d.ts

@@ -0,0 +1,19 @@
+export interface Document {
+    id: string;
+    text: string;
+    metadata: Record<string, unknown>;
+    embedding?: number[];
+}
+export interface ScoredDocument {
+    document: Document;
+    score: number;
+}
+export interface VectorStore {
+    add(documents: Document[]): Promise<void>;
+    search(query: string, k?: number): Promise<ScoredDocument[]>;
+    delete(ids: string[]): Promise<void>;
+    clear(): Promise<void>;
+    size(): number;
+    serialize(): string;
+}
+//# sourceMappingURL=VectorStore.d.ts.map

package/dist/vector/VectorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStore.d.ts","sourceRoot":"","sources":["../../src/vector/VectorStore.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,MAAM,CAAC;IACf,SAAS,IAAI,MAAM,CAAC;CACrB"}

package/dist/vector/VectorStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=VectorStore.js.map

package/dist/vector/VectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStore.js","sourceRoot":"","sources":["../../src/vector/VectorStore.ts"],"names":[],"mappings":""}

package/dist/vector/VectraVectorStore.d.ts

@@ -0,0 +1,23 @@
+import type { Document, ScoredDocument, VectorStore } from './VectorStore.js';
+type EmbedFn = (text: string) => Promise<number[]>;
+/**
+ * Vectra-backed vector store — uses HNSW for fast ANN search,
+ * persists to disk, survives restarts.
+ */
+export declare class VectraVectorStore implements VectorStore {
+    private dirPath;
+    private index;
+    private ready;
+    private embedFn;
+    constructor(dirPath: string, embedFn?: EmbedFn);
+    private ensureReady;
+    add(documents: Document[]): Promise<void>;
+    search(query: string, k?: number): Promise<ScoredDocument[]>;
+    delete(ids: string[]): Promise<void>;
+    clear(): Promise<void>;
+    size(): number;
+    serialize(): string;
+    static deserialize(_data: string): VectraVectorStore;
+}
+export {};
+//# sourceMappingURL=VectraVectorStore.d.ts.map

package/dist/vector/VectraVectorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectraVectorStore.d.ts","sourceRoot":"","sources":["../../src/vector/VectraVectorStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG9E,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAkBnD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IAKvC,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEL,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;YAIxC,WAAW;IAUnB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAazC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcvD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,IAAI,IAAI,MAAM;IAMd,SAAS,IAAI,MAAM;IACnB,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB;CAGrD"}

package/dist/vector/VectraVectorStore.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectraVectorStore = void 0;
+const vectra_1 = require("vectra");
+const fs_1 = require("fs");
+const logger_js_1 = require("../utils/logger.js");
+// Lazy embed function — same model as MemoryVectorStore
+let pipelineCache = null;
+async function embed(text) {
+    try {
+        if (!pipelineCache) {
+            const { pipeline } = await import('@xenova/transformers');
+            pipelineCache = (await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2'));
+        }
+        const output = await pipelineCache([text], { pooling: 'mean', normalize: true });
+        return Array.from(output.data[0]);
+    }
+    catch {
+        return new Array(384).fill(0);
+    }
+}
+/**
+ * Vectra-backed vector store — uses HNSW for fast ANN search,
+ * persists to disk, survives restarts.
+ */
+class VectraVectorStore {
+    dirPath;
+    index;
+    ready = false;
+    embedFn;
+    constructor(dirPath, embedFn) {
+        this.dirPath = dirPath;
+        this.embedFn = embedFn ?? embed;
+    }
+    async ensureReady() {
+        if (this.ready)
+            return;
+        if (!(0, fs_1.existsSync)(this.dirPath))
+            (0, fs_1.mkdirSync)(this.dirPath, { recursive: true });
+        this.index = new vectra_1.LocalIndex(this.dirPath);
+        if (!await this.index.isIndexCreated()) {
+            await this.index.createIndex();
+        }
+        this.ready = true;
+    }
+    async add(documents) {
+        await this.ensureReady();
+        for (const doc of documents) {
+            const vector = doc.embedding?.length ? doc.embedding : await this.embedFn(doc.text);
+            await this.index.upsertItem({
+                id: doc.id,
+                vector,
+                metadata: { text: doc.text, ...doc.metadata },
+            });
+        }
+        logger_js_1.logger.debug({ count: documents.length }, 'Vectra: documents upserted');
+    }
+    async search(query, k = 5) {
+        await this.ensureReady();
+        const queryVector = await this.embedFn(query);
+        const results = await this.index.queryItems(queryVector, query, k);
+        return results.map(r => ({
+            document: {
+                id: r.item.id,
+                text: r.item.metadata?.text ?? '',
+                metadata: r.item.metadata,
+            },
+            score: r.score,
+        }));
+    }
+    async delete(ids) {
+        await this.ensureReady();
+        for (const id of ids) {
+            await this.index.deleteItem(id);
+        }
+    }
+    async clear() {
+        await this.ensureReady();
+        await this.index.deleteIndex();
+        await this.index.createIndex();
+    }
+    size() {
+        // Vectra doesn't expose sync count — return 0 as safe default
+        return 0;
+    }
+    // Legacy compat (no-ops — vectra persists automatically)
+    serialize() { return '{}'; }
+    static deserialize(_data) {
+        throw new Error('Use VectraVectorStore constructor directly');
+    }
+}
+exports.VectraVectorStore = VectraVectorStore;
+//# sourceMappingURL=VectraVectorStore.js.map

package/dist/vector/VectraVectorStore.js.map

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

package/examples/firecode.config.example.ts

@@ -0,0 +1,87 @@
+import type { FireCodeConfig } from '@phmotad/fire-code';
+
+const config: FireCodeConfig = {
+  project: {
+    name: 'my-project',
+    // 'legacy' for existing messy projects, 'standard' for greenfield
+    mode: 'standard',
+  },
+
+  llm: {
+    // Providers: 'openrouter' | 'anthropic' | 'openai' | 'ollama'
+    provider: 'openrouter',
+    model: 'deepseek/deepseek-coder',
+    apiKey: process.env.OPENROUTER_API_KEY,
+    maxTokens: 4096,
+    temperature: 0.2,
+  },
+
+  embeddings: {
+    // 'local' uses @xenova/transformers (all-MiniLM-L6-v2, runs offline)
+    provider: 'local',
+    model: 'Xenova/all-MiniLM-L6-v2',
+  },
+
+  vectorStore: {
+    // 'memory' = in-process, 'qdrant' = external Qdrant server
+    provider: 'memory',
+    collection: 'fire-code',
+  },
+
+  graphStore: {
+    // 'memory' = in-process, 'neo4j' = external Neo4j
+    provider: 'memory',
+  },
+
+  memory: {
+    // 'auto'   = uses vector+graph if indexed, falls back to text search
+    // 'hybrid' = always uses both (requires index)
+    // 'vector' = vector-only
+    // 'graph'  = graph-only
+    strategy: 'auto',
+    maxResults: 10,
+  },
+
+  git: {
+    enabled: true,
+    autoBranch: true,
+    branchPrefix: 'firecode/',
+    // 'reuse'     = checkout existing branch
+    // 'increment' = create branch-2, branch-3...
+    // 'fail'      = error if branch exists
+    branchStrategy: 'reuse',
+    autoCommit: true,
+    commitFormat: 'conventional',
+    includeMetadata: true,
+    // 'stash'  = auto-stash dirty files (recommended)
+    // 'commit' = auto-commit dirty files
+    // 'fail'   = block if dirty
+    // 'ignore' = proceed anyway
+    workingTree: 'stash',
+    enforcePattern: false,
+  },
+
+  execution: {
+    // 'safe'       = validate before applying changes
+    // 'aggressive' = apply changes directly
+    mode: 'safe',
+    dryRun: false,
+    // 'fail'      = error on conflict (recommended)
+    // 'overwrite' = overwrite conflicting files
+    // 'merge'     = attempt merge
+    conflictStrategy: 'fail',
+    validateSyntax: true,
+    validateBuild: false,
+  },
+
+  indexing: {
+    // 'lazy' = index on-demand (recommended for large repos)
+    // 'full' = index everything upfront
+    mode: 'lazy',
+    include: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    exclude: ['node_modules/**', 'dist/**', '.firecode/**', '**/*.test.*'],
+    maxFileSize: 500_000,
+  },
+};
+
+export default config;

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@phmotad/fire-code",
+  "version": "0.2.0",
+  "description": "Intelligent MCP execution engine for AI coding agents — persistent memory, context-aware, Git-traceable",
+  "keywords": [
+    "mcp",
+    "ai",
+    "coding-agent",
+    "claude",
+    "claude-code",
+    "llm",
+    "typescript",
+    "memory",
+    "vector",
+    "graph",
+    "git",
+    "plugin"
+  ],
+  "author": "FireCode Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/phmotad/fire-code.git"
+  },
+  "homepage": "https://github.com/phmotad/fire-code#readme",
+  "bugs": {
+    "url": "https://github.com/phmotad/fire-code/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "fire-code": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "plugin/.claude-plugin",
+    "plugin/hooks",
+    "plugin/scripts",
+    "examples",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "dev": "tsx src/cli/index.ts dev",
+    "start": "node dist/cli/index.js",
+    "test": "jest",
+    "test:unit": "jest --testPathPattern=__tests__/unit",
+    "test:integration": "jest --testPathPattern=__tests__/integration",
+    "test:coverage": "jest --coverage",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test",
+    "benchmark": "cross-env LOG_LEVEL=silent npx tsx --tsconfig tsconfig.json scripts/benchmark.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.114",
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
+    "@xenova/transformers": "^2.17.2",
+    "axios": "^1.7.0",
+    "better-sqlite3": "^12.9.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "express": "^5.2.1",
+    "glob": "^11.0.0",
+    "graphology": "^0.26.0",
+    "graphology-pagerank": "^1.1.0",
+    "graphology-shortest-path": "^2.1.0",
+    "graphology-traversal": "^0.3.1",
+    "graphology-types": "^0.24.8",
+    "inquirer": "^9.3.0",
+    "openai": "^4.67.0",
+    "ora": "^8.1.0",
+    "pino": "^9.5.0",
+    "simple-git": "^3.27.0",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-go": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "ts-morph": "^23.0.0",
+    "vectra": "^0.14.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "cross-env": "^10.1.0",
+    "jest": "^29.7.0",
+    "pino-pretty": "^11.3.0",
+    "ts-jest": "^29.2.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "fire-code",
+  "version": "0.1.0",
+  "description": "Intelligent MCP execution engine for AI coding agents — persistent memory, context-aware, Git-traceable",
+  "author": {
+    "name": "FireCode Contributors",
+    "url": "https://github.com/YOUR_USERNAME/fire-code"
+  },
+  "license": "MIT",
+  "repository": "https://github.com/YOUR_USERNAME/fire-code",
+  "mcp": {
+    "command": "npx",
+    "args": ["fire-code", "dev"],
+    "description": "Fire Code MCP server (smart_search, smart_outline, get_context, search_code, get_graph, execute)"
+  },
+  "hooks": "./hooks/hooks.json"
+}

package/plugin/hooks/hooks.json

@@ -0,0 +1,86 @@
+{
+  "description": "Fire Code lifecycle hooks — auto-index on file writes, inject memory context on session start",
+  "hooks": {
+    "Setup": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/smart-install.js\"",
+            "timeout": 120
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" session-start",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" session-init",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" pre-read",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" post-tool",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" stop",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=$(ls -dt $HOME/.claude/plugins/cache/*/fire-code/[0-9]*/ 2>/dev/null | head -1); _R=\"${_R%/}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/fire-code/plugin\"; node \"$_R/scripts/context-inject.js\" session-end",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}