@phantomind/core 0.1.0

package/dist/index.js

@@ -0,0 +1,285 @@
+/**
+ * PhantomMindAI — Main Entry Point
+ * Universal AI Development Enhancement Layer
+ *
+ * @example
+ * ```ts
+ * import { phantom } from '@phantomind/core';
+ *
+ * // Initialize
+ * await phantom.init();
+ *
+ * // Get context
+ * const ctx = await phantom.ctx();
+ *
+ * // Complete with auto-routing
+ * const response = await phantom.complete('Explain this code');
+ *
+ * // Run agent
+ * const result = await phantom.agent('refactor auth module');
+ *
+ * // Orchestrate multi-agent
+ * const orchestrated = await phantom.orchestrate(
+ *   'build user dashboard',
+ *   ['architect', 'implementer', 'testWriter'],
+ * );
+ * ```
+ */
+import { loadConfig } from './config/loader.js';
+import { ContextEngine } from './context/engine.js';
+import { CodebaseEmbedder } from './context/embedder.js';
+import { ContextLearner } from './context/learner.js';
+import { ProviderRouter } from './providers/router.js';
+import { AgentExecutor } from './agent/executor.js';
+import { AgentOrchestrator } from './agent/orchestrator.js';
+import { TaskDecomposer } from './agent/decomposer.js';
+import { RetryIntelligence } from './agent/retry.js';
+import { TaskQueue } from './agent/queue.js';
+import { AgentMemory } from './agent/memory.js';
+import { SchemaRegistry } from './schemas/registry.js';
+import { AuditTrail } from './observability/audit.js';
+import { CostTracker } from './observability/cost-tracker.js';
+import { AnalyticsDashboard } from './observability/dashboard.js';
+import { SecretScanner } from './quality/secret-scanner.js';
+import { HallucinationGuard } from './quality/hallucination-guard.js';
+import { ConsistencyEnforcer } from './quality/consistency.js';
+import { syncAllAdapters } from './adapters/index.js';
+export class PhantomMind {
+    projectRoot;
+    config;
+    router;
+    contextEngine;
+    embedder;
+    learner;
+    schemaRegistry;
+    auditTrail;
+    costTracker;
+    memory;
+    queue;
+    initialized = false;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot ?? process.cwd();
+    }
+    /**
+     * Initialize PhantomMindAI
+     */
+    async init(configOverride) {
+        this.config = await loadConfig(this.projectRoot);
+        if (configOverride) {
+            Object.assign(this.config, configOverride);
+        }
+        this.router = new ProviderRouter(this.config.providers, this.config.budget ? {
+            maxCostPerDay: this.config.budget.maxCostPerDay,
+            warningAt: this.config.budget.warningAt,
+            fallbackOnBudget: this.config.budget.fallbackOnBudget,
+        } : undefined);
+        this.contextEngine = new ContextEngine(this.config, this.projectRoot);
+        this.embedder = new CodebaseEmbedder(this.projectRoot);
+        this.learner = new ContextLearner(this.projectRoot);
+        this.schemaRegistry = new SchemaRegistry(this.projectRoot);
+        this.auditTrail = new AuditTrail(this.projectRoot);
+        this.costTracker = new CostTracker(this.projectRoot, {
+            daily: this.config.budget?.maxCostPerDay,
+        });
+        this.memory = new AgentMemory(this.projectRoot);
+        this.queue = new TaskQueue({ maxConcurrent: 3 });
+        await this.schemaRegistry.loadCustomSchemas();
+        await this.auditTrail.init();
+        await this.costTracker.load();
+        await this.memory.load();
+        // Wire up audit logging for provider requests
+        this.router.on('provider:response', ({ provider, model, usage, duration }) => {
+            this.auditTrail.logProviderRequest(provider, model, usage.inputTokens, usage.outputTokens, usage.estimatedCost, duration, true);
+            this.costTracker.record(provider, model, usage);
+        });
+        this.initialized = true;
+    }
+    ensureInit() {
+        if (!this.initialized) {
+            throw new Error('PhantomMindAI not initialized. Call phantom.init() first.');
+        }
+    }
+    /**
+     * Get project context
+     */
+    async ctx(options) {
+        this.ensureInit();
+        return this.contextEngine.getProjectContext(options);
+    }
+    /**
+     * Complete a prompt with auto-routing
+     */
+    async complete(prompt, options) {
+        this.ensureInit();
+        const context = await this.contextEngine.getProjectContext({ maxTokens: 2000 });
+        const contextText = context.layers.map(l => l.content).join('\n\n');
+        return this.router.complete({
+            systemPrompt: `You are an AI assistant with deep knowledge of this project.\n\n${contextText}`,
+            prompt,
+            temperature: 0.7,
+            maxTokens: 2000,
+            ...options,
+        });
+    }
+    /**
+     * Complete with intelligent retry
+     */
+    async completeWithRetry(prompt, options) {
+        this.ensureInit();
+        const retry = new RetryIntelligence(this.router, this.contextEngine);
+        const result = await retry.execute({
+            prompt,
+            temperature: 0.7,
+            maxTokens: 2000,
+            ...options,
+        });
+        if (!result.success || !result.response) {
+            throw new Error(`Failed after ${result.attempts} attempts: ${result.error}`);
+        }
+        return result.response;
+    }
+    /**
+     * Run an agent task
+     */
+    async agent(task, options) {
+        this.ensureInit();
+        const executor = new AgentExecutor(this.router, this.contextEngine, this.projectRoot, {
+            role: options?.role ?? 'implementer',
+            maxSteps: options?.maxSteps ?? 30,
+        });
+        return executor.run(task);
+    }
+    /**
+     * Orchestrate multi-agent task
+     */
+    async orchestrate(task, roles) {
+        this.ensureInit();
+        const orchestrator = new AgentOrchestrator(this.router, this.contextEngine, this.projectRoot);
+        return orchestrator.orchestrate(task, roles);
+    }
+    /**
+     * Decompose a task
+     */
+    async decompose(task) {
+        this.ensureInit();
+        const decomposer = new TaskDecomposer(this.router, this.contextEngine);
+        return decomposer.decompose(task);
+    }
+    /**
+     * Queue a task
+     */
+    enqueue(task, options) {
+        this.ensureInit();
+        return this.queue.enqueue(task, options);
+    }
+    /**
+     * Semantic search across codebase
+     */
+    async search(query, limit = 10) {
+        this.ensureInit();
+        await this.embedder.build();
+        return this.embedder.search(query, limit);
+    }
+    /**
+     * Sync adapter configurations
+     */
+    async sync(targets, dryRun = false) {
+        this.ensureInit();
+        let syncConfig = this.config;
+        if (targets && targets.length > 0) {
+            syncConfig = { ...this.config, adapters: targets };
+        }
+        return syncAllAdapters(this.projectRoot, syncConfig, dryRun);
+    }
+    /**
+     * Validate code
+     */
+    async validate(content, filename) {
+        this.ensureInit();
+        const scanner = new SecretScanner();
+        const guard = new HallucinationGuard(this.projectRoot);
+        const secrets = scanner.scan(content, filename);
+        const hallucinations = await guard.check(content, filename);
+        return { secrets, hallucinations };
+    }
+    /**
+     * Check code consistency
+     */
+    async checkConsistency() {
+        this.ensureInit();
+        const enforcer = new ConsistencyEnforcer(this.projectRoot);
+        return enforcer.scan();
+    }
+    /**
+     * Get schema
+     */
+    schema(name) {
+        this.ensureInit();
+        return this.schemaRegistry.get(name);
+    }
+    /**
+     * Get cost report
+     */
+    costs(period) {
+        this.ensureInit();
+        return this.costTracker.getReport(period);
+    }
+    /**
+     * Get dashboard
+     */
+    dashboard() {
+        this.ensureInit();
+        return new AnalyticsDashboard(this.costTracker, this.auditTrail);
+    }
+    /**
+     * Learn project patterns
+     */
+    async learn() {
+        this.ensureInit();
+        await this.learner.learn();
+        return this.learner.generateSkillsContent();
+    }
+    /**
+     * Save state (costs, memory, etc.)
+     */
+    async save() {
+        this.ensureInit();
+        await this.costTracker.save();
+        await this.memory.save();
+    }
+    /**
+     * Access internals
+     */
+    get internals() {
+        this.ensureInit();
+        return {
+            router: this.router,
+            contextEngine: this.contextEngine,
+            embedder: this.embedder,
+            learner: this.learner,
+            schemaRegistry: this.schemaRegistry,
+            auditTrail: this.auditTrail,
+            costTracker: this.costTracker,
+            memory: this.memory,
+            queue: this.queue,
+            config: this.config,
+        };
+    }
+}
+/**
+ * Default phantom instance
+ */
+export const phantom = new PhantomMind();
+// Re-export everything
+export * from './types.js';
+export * from './config/index.js';
+export * from './providers/index.js';
+export * from './context/index.js';
+export * from './adapters/index.js';
+export * from './mcp/index.js';
+export * from './agent/index.js';
+export * from './quality/index.js';
+export * from './schemas/index.js';
+export * from './observability/index.js';
+export * from './templates/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+export { PhantomMCPServer, startMCPServer } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,2 @@
+export { PhantomMCPServer, startMCPServer } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PhantomMindAI — MCP Server
+ * Model Context Protocol server with all project-aware tools.
+ */
+export declare class PhantomMCPServer {
+    private server;
+    private contextEngine;
+    private embedder;
+    private projectRoot;
+    private config;
+    constructor();
+    private setupHandlers;
+    private handleGetProjectContext;
+    private handleGetRelevantContext;
+    private handleGetSchema;
+    private handleSearchCodebase;
+    private handleValidateOutput;
+    private handleGetExamples;
+    private handleGetPrd;
+    private handleGetDecisionLog;
+    private handleCheckConsistency;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+}
+/**
+ * Start MCP server (entry point)
+ */
+export declare function startMCPServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,MAAM,CAAiB;;IAkB/B,OAAO,CAAC,aAAa;YAiJP,uBAAuB;YAevB,wBAAwB;YAkBxB,eAAe;YAyBf,oBAAoB;YAcpB,oBAAoB;YAyBpB,iBAAiB;YA0BjB,YAAY;YAUZ,oBAAoB;YA8BpB,sBAAsB;IAepC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD"}

package/dist/mcp/server.js

@@ -0,0 +1,334 @@
+/**
+ * PhantomMindAI — MCP Server
+ * Model Context Protocol server with all project-aware tools.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ContextEngine } from '../context/engine.js';
+import { CodebaseEmbedder } from '../context/embedder.js';
+import { loadConfig, findProjectRoot } from '../config/index.js';
+export class PhantomMCPServer {
+    server;
+    contextEngine;
+    embedder;
+    projectRoot;
+    config;
+    constructor() {
+        this.server = new Server({
+            name: 'phantomind',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'get_project_context',
+                    description: 'Get the full project context including architecture, conventions, and rules from PhantomMindAI. Returns SKILLS.md + RULES.md content, semantically ranked for the current file.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string', description: 'Current file path for relevance ranking' },
+                            maxTokens: { type: 'number', description: 'Maximum tokens to return (default: 4000)' },
+                        },
+                    },
+                },
+                {
+                    name: 'get_relevant_context',
+                    description: 'Get semantically-ranked context relevant to the current file being edited. Prevents context overflow by only returning highly relevant sections.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string', description: 'Current file path' },
+                            maxTokens: { type: 'number', description: 'Maximum tokens (default: 2000)' },
+                        },
+                        required: ['file'],
+                    },
+                },
+                {
+                    name: 'get_schema',
+                    description: 'Get the output contract/schema for a specific task type from the project schema registry.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'Schema name from registry' },
+                        },
+                        required: ['name'],
+                    },
+                },
+                {
+                    name: 'search_codebase',
+                    description: 'Semantic search across project source files. Uses TF-IDF embeddings to find relevant code.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: { type: 'string', description: 'Search query' },
+                            limit: { type: 'number', description: 'Maximum results (default: 5)' },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'validate_output',
+                    description: 'Validate generated code or content against project schema and conventions.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            content: { type: 'string', description: 'Content to validate' },
+                            schema: { type: 'string', description: 'Schema name from registry' },
+                        },
+                        required: ['content', 'schema'],
+                    },
+                },
+                {
+                    name: 'get_examples',
+                    description: 'Find relevant existing code examples from the project codebase.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: { type: 'string', description: 'What kind of code examples to find' },
+                            limit: { type: 'number', description: 'Maximum examples (default: 3)' },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'get_prd',
+                    description: 'Return a relevant PRD (Product Requirements Document) section.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'PRD name or feature name' },
+                        },
+                        required: ['name'],
+                    },
+                },
+                {
+                    name: 'get_decision_log',
+                    description: 'Get past architectural decisions made by agents.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string', description: 'Filter by affected file' },
+                            limit: { type: 'number', description: 'Maximum entries (default: 10)' },
+                        },
+                    },
+                },
+                {
+                    name: 'check_consistency',
+                    description: 'Find naming and pattern inconsistencies across the codebase.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            scope: { type: 'string', description: 'Scope of check: naming, pattern, architecture, all (default: all)' },
+                        },
+                    },
+                },
+            ],
+        }));
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'get_project_context':
+                        return await this.handleGetProjectContext(args);
+                    case 'get_relevant_context':
+                        return await this.handleGetRelevantContext(args);
+                    case 'get_schema':
+                        return await this.handleGetSchema(args);
+                    case 'search_codebase':
+                        return await this.handleSearchCodebase(args);
+                    case 'validate_output':
+                        return await this.handleValidateOutput(args);
+                    case 'get_examples':
+                        return await this.handleGetExamples(args);
+                    case 'get_prd':
+                        return await this.handleGetPrd(args);
+                    case 'get_decision_log':
+                        return await this.handleGetDecisionLog(args);
+                    case 'check_consistency':
+                        return await this.handleCheckConsistency(args);
+                    default:
+                        return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+                }
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `Error: ${error.message}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async handleGetProjectContext(args) {
+        const result = await this.contextEngine.getProjectContext({
+            file: args?.file,
+            maxTokens: args?.maxTokens ?? 4000,
+        });
+        const content = result.layers.map(l => l.content).join('\n\n---\n\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: content || 'No project context found. Run `phantomind init` to set up.',
+                }],
+        };
+    }
+    async handleGetRelevantContext(args) {
+        const result = await this.contextEngine.getFileContext(args.file, args?.maxTokens ?? 2000);
+        const content = result.layers
+            .map(l => `[relevance: ${(l.relevanceScore * 100).toFixed(0)}%] ${l.type}\n${l.content}`)
+            .join('\n\n---\n\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: content || 'No relevant context found for this file.',
+                }],
+        };
+    }
+    async handleGetSchema(args) {
+        const { readFile } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        try {
+            const schemaContent = await readFile(join(this.projectRoot, this.config.context.schema), 'utf-8');
+            const schemas = JSON.parse(schemaContent);
+            const schema = schemas[args.name] ?? schemas;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(schema, null, 2),
+                    }],
+            };
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: `Schema '${args.name}' not found.` }],
+            };
+        }
+    }
+    async handleSearchCodebase(args) {
+        const results = await this.embedder.search(args.query, args?.limit ?? 5);
+        if (results.length === 0) {
+            return { content: [{ type: 'text', text: 'No results found.' }] };
+        }
+        const text = results
+            .map((r, i) => `### Result ${i + 1}: ${r.path} (score: ${r.score.toFixed(3)})\n\`\`\`\n${r.snippet}\n\`\`\``)
+            .join('\n\n');
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleValidateOutput(args) {
+        // Basic validation against project conventions
+        const context = await this.contextEngine.getProjectContext({ includeRules: true, maxTokens: 2000 });
+        const rulesLayer = context.layers.find(l => l.type === 'rules');
+        const issues = [];
+        // Check for common issues
+        if (args.content.includes('any')) {
+            issues.push('⚠️ Usage of `any` type detected — consider using specific types.');
+        }
+        if (args.content.match(/console\.(log|debug|warn)/)) {
+            issues.push('⚠️ Console statements detected — consider using proper logging.');
+        }
+        if (args.content.includes('TODO') || args.content.includes('FIXME')) {
+            issues.push('⚠️ TODO/FIXME comments detected — consider resolving before committing.');
+        }
+        const text = issues.length > 0
+            ? `Validation Report:\n${issues.join('\n')}`
+            : '✅ No issues detected.';
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleGetExamples(args) {
+        const results = await this.embedder.search(args.query, args?.limit ?? 3);
+        if (results.length === 0) {
+            return { content: [{ type: 'text', text: 'No matching examples found.' }] };
+        }
+        const { readFile } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        const examples = await Promise.all(results.map(async (r) => {
+            try {
+                const content = await readFile(join(this.projectRoot, r.path), 'utf-8');
+                // Return first 100 lines
+                const lines = content.split('\n').slice(0, 100).join('\n');
+                return `### ${r.path}\n\`\`\`\n${lines}\n\`\`\``;
+            }
+            catch {
+                return `### ${r.path}\n(could not read file)`;
+            }
+        }));
+        return { content: [{ type: 'text', text: examples.join('\n\n') }] };
+    }
+    async handleGetPrd(args) {
+        const prd = await this.contextEngine.getPrdContext(args.name);
+        if (!prd) {
+            return { content: [{ type: 'text', text: `PRD '${args.name}' not found.` }] };
+        }
+        return { content: [{ type: 'text', text: prd.content }] };
+    }
+    async handleGetDecisionLog(args) {
+        const { readFile, readdir } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        try {
+            const decisionDir = join(this.projectRoot, this.config.context.decisions);
+            const files = await readdir(decisionDir);
+            const mdFiles = files.filter(f => f.endsWith('.md')).sort().reverse();
+            const limit = args?.limit ?? 10;
+            const entries = [];
+            for (const file of mdFiles.slice(0, limit)) {
+                const content = await readFile(join(decisionDir, file), 'utf-8');
+                if (args?.file && !content.includes(args.file))
+                    continue;
+                entries.push(content);
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: entries.length > 0 ? entries.join('\n\n---\n\n') : 'No decision log entries found.',
+                    }],
+            };
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: 'No decision log directory found.' }],
+            };
+        }
+    }
+    async handleCheckConsistency(args) {
+        const sections = await this.contextEngine.searchContext('naming convention pattern', 10);
+        const scope = args?.scope ?? 'all';
+        const report = [
+            '# Consistency Check Report',
+            `Scope: ${scope}`,
+            `Timestamp: ${new Date().toISOString()}`,
+            '',
+            'Run `phantomind check consistency` for a full detailed report.',
+        ];
+        return { content: [{ type: 'text', text: report.join('\n') }] };
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        this.projectRoot = await findProjectRoot();
+        this.config = await loadConfig(this.projectRoot);
+        this.contextEngine = new ContextEngine(this.config, this.projectRoot);
+        this.embedder = new CodebaseEmbedder(this.projectRoot);
+        // Build embeddings in background
+        this.embedder.build().catch(() => { });
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+}
+/**
+ * Start MCP server (entry point)
+ */
+export async function startMCPServer() {
+    const server = new PhantomMCPServer();
+    await server.start();
+}
+//# sourceMappingURL=server.js.map