@decispher/mcp-server 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @decispher/mcp-server@0.1.0 build D:\Ali Zaidi\Startup\Contextual\DecispherWorld\phase-2\packages\mcp-server
+> tsc
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @decispher/mcp-server@0.1.0 typecheck D:\Ali Zaidi\Startup\Contextual\DecispherWorld\phase-2\packages\mcp-server
+> tsc --noEmit
+

package/dist/__tests__/file-reader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-reader.test.d.ts.map

package/dist/__tests__/file-reader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/file-reader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/file-reader.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { readFileForContext, detectLanguage, DEFAULT_FILE_READ_MAX_BYTES, } from '../lib/file-reader.js';
+let workDir;
+beforeEach(async () => {
+    workDir = join(tmpdir(), `decispher-file-reader-${randomUUID()}`);
+    await fs.mkdir(workDir, { recursive: true });
+});
+afterEach(async () => {
+    await fs.rm(workDir, { recursive: true, force: true });
+});
+describe('detectLanguage', () => {
+    it.each([
+        ['src/auth.ts', 'typescript'],
+        ['component.tsx', 'tsx'],
+        ['legacy.cjs', 'javascript'],
+        ['main.py', 'python'],
+        ['cmd.go', 'go'],
+        ['lib.rs', 'rust'],
+        ['App.java', 'java'],
+    ])('maps %s → %s', (path, lang) => {
+        expect(detectLanguage(path)).toBe(lang);
+    });
+    it('returns null for unknown extensions', () => {
+        expect(detectLanguage('README')).toBeNull();
+        expect(detectLanguage('config.yaml')).toBeNull();
+    });
+});
+describe('readFileForContext', () => {
+    it('reads small UTF-8 text files in full', async () => {
+        const path = join(workDir, 'a.ts');
+        await fs.writeFile(path, 'export const x = 1;\n', 'utf8');
+        const result = await readFileForContext(path);
+        expect(result).not.toBeNull();
+        expect(result.content).toBe('export const x = 1;\n');
+        expect(result.language).toBe('typescript');
+        expect(result.truncated).toBe(false);
+        expect(result.bytesRead).toBe(20);
+    });
+    it('strips a UTF-8 BOM if present', async () => {
+        const path = join(workDir, 'bom.ts');
+        await fs.writeFile(path, 'export const x = 1;', 'utf8');
+        const result = await readFileForContext(path);
+        expect(result.content.startsWith('')).toBe(false);
+        expect(result.content).toBe('export const x = 1;');
+    });
+    it('returns null when the path does not exist', async () => {
+        const result = await readFileForContext(join(workDir, 'missing.ts'));
+        expect(result).toBeNull();
+    });
+    it('returns null when the path points to a directory', async () => {
+        const result = await readFileForContext(workDir);
+        expect(result).toBeNull();
+    });
+    it('refuses files that look binary (NUL byte in head)', async () => {
+        const path = join(workDir, 'image.bin');
+        const buf = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x00, 0x01, 0x02, 0x03]);
+        await fs.writeFile(path, buf);
+        const result = await readFileForContext(path);
+        expect(result).toBeNull();
+    });
+    it('truncates oversize files head + tail and flags truncated=true', async () => {
+        const path = join(workDir, 'big.ts');
+        const head = 'HEAD_MARKER\n' + 'a'.repeat(10_000) + '\n';
+        const tail = 'b'.repeat(10_000) + '\nTAIL_MARKER\n';
+        await fs.writeFile(path, head + 'x'.repeat(2_000) + tail);
+        const result = await readFileForContext(path, { maxBytes: 1024 });
+        expect(result).not.toBeNull();
+        expect(result.truncated).toBe(true);
+        expect(result.bytesRead).toBe(1024);
+        expect(result.content.startsWith('HEAD_MARKER')).toBe(true);
+        expect(result.content.endsWith('TAIL_MARKER\n')).toBe(true);
+        expect(result.content).toContain('truncated by MCP file-reader');
+    });
+    it('honors the default 256 KB cap when no override is provided', async () => {
+        const path = join(workDir, 'huge.ts');
+        // Just over the cap so we know it triggers truncation.
+        await fs.writeFile(path, 'x'.repeat(DEFAULT_FILE_READ_MAX_BYTES + 1024));
+        const result = await readFileForContext(path);
+        expect(result.truncated).toBe(true);
+        expect(result.bytesRead).toBe(DEFAULT_FILE_READ_MAX_BYTES);
+    });
+    it('emitted content (head + marker + tail) never exceeds maxBytes', async () => {
+        // Guards against the marker pushing payload past the server-side
+        // fileContent maxLength (262144 bytes). Regression test for the
+        // off-by-marker-length bug.
+        const path = join(workDir, 'cap.ts');
+        await fs.writeFile(path, 'x'.repeat(DEFAULT_FILE_READ_MAX_BYTES * 2));
+        const result = await readFileForContext(path);
+        expect(result.truncated).toBe(true);
+        expect(Buffer.byteLength(result.content, 'utf8')).toBeLessThanOrEqual(DEFAULT_FILE_READ_MAX_BYTES);
+    });
+    it('resolves relative paths against the supplied cwd', async () => {
+        await fs.writeFile(join(workDir, 'rel.ts'), 'export const y = 2;');
+        const result = await readFileForContext('rel.ts', { cwd: workDir });
+        expect(result.content).toBe('export const y = 2;');
+    });
+    it('returns language=null for unknown extensions but still reads content', async () => {
+        const path = join(workDir, 'notes.md');
+        await fs.writeFile(path, '# heading\nbody');
+        const result = await readFileForContext(path);
+        expect(result.language).toBeNull();
+        expect(result.content).toBe('# heading\nbody');
+    });
+});
+//# sourceMappingURL=file-reader.test.js.map

package/dist/__tests__/file-reader.test.js.map

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

package/dist/__tests__/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/__tests__/tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tools.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tools.test.js

@@ -0,0 +1,198 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTools, TOOL_DEFINITIONS } from '../tools.js';
+function makeClient(overrides = {}) {
+    return {
+        searchDecisions: vi.fn().mockResolvedValue([
+            { id: 'd-1', title: 'Use Drizzle ORM', type: 'decision', decision: 'Use Drizzle', rationale: null, similarity: 0.92 },
+        ]),
+        getConstraints: vi.fn().mockResolvedValue([
+            { id: 'c-1', title: 'No raw SQL in business logic', decision: 'Always use the repository pattern', rationale: null, severity: 'HIGH' },
+        ]),
+        getConventions: vi.fn().mockResolvedValue([
+            { id: 'v-1', title: 'Pino for logging', decision: 'Use pino structured logging', rationale: null },
+        ]),
+        ask: vi.fn().mockResolvedValue({
+            answer: 'We use Drizzle ORM for type safety.',
+            sources: [{ id: 's-1', title: 'ORM Decision', similarity: 0.88 }],
+            hadContext: true,
+        }),
+        getContextForFile: vi.fn().mockResolvedValue([
+            { id: 'd-2', title: 'Auth middleware', type: 'convention', decision: 'Use jwt-auth', rationale: null, similarity: 0.75 },
+        ]),
+        checkIntent: vi.fn().mockResolvedValue({
+            verdict: 'CLEAR', conflicts: [], relevant: [], latencyMs: 0, creditsConsumed: 0,
+        }),
+        getDecision: vi.fn().mockResolvedValue({
+            id: 'd-1', type: 'decision', title: 'Use Drizzle ORM', problem: null,
+            decision: 'We chose Drizzle over Prisma for type safety.',
+            rationale: 'Drizzle generates typed SQL at compile time.',
+            severity: 'HIGH', status: 'active',
+            alternatives: [{ option: 'Prisma', reasonRejected: 'Runtime schema overhead' }],
+            affectedFiles: ['src/db/index.ts'], tags: ['orm', 'database'],
+            sourceType: null, supersedes: null, supersededBy: null,
+            createdAt: '2024-01-01T00:00:00Z', updatedAt: '2024-01-01T00:00:00Z', lastReviewedAt: null,
+        }),
+        captureDecision: vi.fn().mockResolvedValue({
+            id: 'cap-1', alreadyExists: false, similarityToExisting: null,
+            fusionPending: false, status: 'active', latencyMs: 12,
+        }),
+        ...overrides,
+    };
+}
+function getTools(server) {
+    return server._registeredTools;
+}
+describe('MCP tools registration', () => {
+    let server;
+    let client;
+    beforeEach(() => {
+        server = new McpServer({ name: 'test', version: '0.0.0' });
+        client = makeClient();
+        registerTools(server, client);
+    });
+    it('registers exactly 8 tools', () => {
+        const names = Object.keys(getTools(server)).sort();
+        expect(names).toEqual([
+            'ask_knowledge_base',
+            'capture_decision',
+            'check_conventions',
+            'check_intent',
+            'get_constraints',
+            'get_context_for_file',
+            'get_decision',
+            'search_decisions',
+        ]);
+    });
+    it('search_decisions calls client.searchDecisions with query and options', async () => {
+        await getTools(server)['search_decisions'].handler({ query: 'which ORM do we use?' });
+        expect(client.searchDecisions).toHaveBeenCalledWith('which ORM do we use?', { limit: undefined, types: undefined });
+    });
+    it('search_decisions passes limit and types to client', async () => {
+        await getTools(server)['search_decisions'].handler({ query: 'auth', limit: 3, types: ['constraint'] });
+        expect(client.searchDecisions).toHaveBeenCalledWith('auth', { limit: 3, types: ['constraint'] });
+    });
+    it('ask_knowledge_base formats answer with sources', async () => {
+        const result = await getTools(server)['ask_knowledge_base'].handler({ question: 'which ORM?' });
+        expect(result.content[0].text).toContain('We use Drizzle ORM');
+        expect(result.content[0].text).toContain('ORM Decision');
+    });
+    it('get_constraints calls client.getConstraints', async () => {
+        await getTools(server)['get_constraints'].handler({});
+        expect(client.getConstraints).toHaveBeenCalled();
+    });
+    it('check_conventions calls client.getConventions', async () => {
+        await getTools(server)['check_conventions'].handler({});
+        expect(client.getConventions).toHaveBeenCalled();
+    });
+    it('get_decision formats the full decision body', async () => {
+        const result = await getTools(server)['get_decision'].handler({ decisionId: 'd-1' });
+        expect(client.getDecision).toHaveBeenCalledWith('d-1');
+        expect(result.content[0].text).toContain('Use Drizzle ORM');
+        expect(result.content[0].text).toContain('Prisma');
+    });
+    it('get_context_for_file reads the file and forwards content + language to client', async () => {
+        const dir = join(tmpdir(), `decispher-tool-${randomUUID()}`);
+        await fs.mkdir(dir, { recursive: true });
+        const path = join(dir, 'auth.ts');
+        try {
+            await fs.writeFile(path, 'export const handler = () => {};');
+            await getTools(server)['get_context_for_file'].handler({ filePath: path });
+            expect(client.getContextForFile).toHaveBeenCalledWith(path, {
+                fileContent: 'export const handler = () => {};',
+                language: 'typescript',
+            });
+        }
+        finally {
+            await fs.rm(dir, { recursive: true, force: true });
+        }
+    });
+    it('get_context_for_file falls back to path-only when the file cannot be read', async () => {
+        const missing = join(tmpdir(), `decispher-missing-${randomUUID()}.ts`);
+        await getTools(server)['get_context_for_file'].handler({ filePath: missing });
+        expect(client.getContextForFile).toHaveBeenCalledWith(missing, undefined);
+    });
+    it('capture_decision forwards the input and reports a captured id', async () => {
+        const result = await getTools(server)['capture_decision'].handler({
+            type: 'convention',
+            title: 'Pino for logging',
+            decision: 'Use pino structured logging.',
+            rationale: 'Structured JSON gives us queryable logs.',
+        });
+        expect(client.captureDecision).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'convention',
+            title: 'Pino for logging',
+        }));
+        expect(result.content[0].text).toContain('captured: cap-1');
+    });
+    it('capture_decision reports already-existing units distinctly', async () => {
+        client = makeClient({
+            captureDecision: vi.fn().mockResolvedValue({
+                id: 'cap-existing', alreadyExists: true, similarityToExisting: 0.973,
+                fusionPending: false, status: 'active', latencyMs: 7,
+            }),
+        });
+        const localServer = new McpServer({ name: 'test', version: '0.0.0' });
+        registerTools(localServer, client);
+        const result = await getTools(localServer)['capture_decision'].handler({
+            type: 'decision',
+            title: 'duplicate',
+            decision: 'body',
+            rationale: 'why',
+        });
+        expect(result.content[0].text).toContain('already-known unit: cap-existing');
+        expect(result.content[0].text).toContain('0.973');
+    });
+});
+describe('WS-E — capabilities-driven registration', () => {
+    let client;
+    beforeEach(() => {
+        client = makeClient();
+    });
+    it('only registers tools the server advertised in enabledTools', () => {
+        const server = new McpServer({ name: 'test', version: '0.0.0' });
+        registerTools(server, client, {
+            enabledTools: new Set(['search_decisions', 'check_intent']),
+        });
+        expect(Object.keys(getTools(server)).sort()).toEqual(['check_intent', 'search_decisions']);
+    });
+    it('uses server-provided descriptions when supplied', () => {
+        const server = new McpServer({ name: 'test', version: '0.0.0' });
+        registerTools(server, client, {
+            descriptions: { search_decisions: 'OVERRIDDEN by server /capabilities' },
+        });
+        expect(getTools(server)['search_decisions'].description).toBe('OVERRIDDEN by server /capabilities');
+    });
+    it('falls back to embedded description when server omits it', () => {
+        const server = new McpServer({ name: 'test', version: '0.0.0' });
+        registerTools(server, client, { descriptions: {} });
+        const embedded = TOOL_DEFINITIONS.find((d) => d.name === 'get_constraints').defaultDescription;
+        expect(getTools(server)['get_constraints'].description).toBe(embedded);
+    });
+    it('TOOL_DEFINITIONS includes capture_decision', () => {
+        const def = TOOL_DEFINITIONS.find((d) => d.name === 'capture_decision');
+        expect(def).toBeDefined();
+        expect(def.defaultDescription).toContain('Write a new context unit');
+        expect(def.defaultDescription).toContain('decision');
+        expect(def.defaultDescription).toContain('convention');
+        expect(def.defaultDescription).toContain('constraint');
+    });
+    it('TOOL_DEFINITIONS covers every wire tool name', () => {
+        const definedNames = TOOL_DEFINITIONS.map((d) => d.name).sort();
+        expect(definedNames).toEqual([
+            'ask_knowledge_base',
+            'capture_decision',
+            'check_conventions',
+            'check_intent',
+            'get_constraints',
+            'get_context_for_file',
+            'get_decision',
+            'search_decisions',
+        ]);
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/__tests__/tools.test.js.map

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

package/dist/decispher-client.d.ts

@@ -0,0 +1,231 @@
+export type FreshnessTier = 'fresh' | 'aging' | 'stale' | 'fossil';
+export interface ConstraintSummary {
+    id: string;
+    title: string;
+    decision: string;
+    rationale: string | null;
+    severity: string;
+}
+export interface ConventionSummary {
+    id: string;
+    title: string;
+    decision: string;
+    rationale: string | null;
+}
+export interface AskResponse {
+    answer: string;
+    sources: Array<{
+        id: string;
+        title: string;
+        similarity: number;
+        lastReviewedAt?: string | null;
+        ageInDays?: number;
+        freshnessTier?: FreshnessTier;
+    }>;
+    hadContext: boolean;
+    contextUnits?: Array<{
+        id: string;
+        title: string;
+        type: string;
+        lastReviewedAt?: string | null;
+        ageInDays?: number;
+        freshnessTier?: FreshnessTier;
+    }>;
+}
+export interface ContextMatch {
+    id: string;
+    title: string;
+    type: string;
+    decision: string;
+    rationale: string | null;
+    similarity: number;
+}
+export type IntentVerdict = 'BLOCKED' | 'WARN' | 'CLEAR';
+export interface ConflictSummary {
+    severity: string;
+    decisionId: string;
+    title: string;
+    explanation: string;
+}
+export interface RelevantSummary {
+    decisionId: string;
+    title: string;
+    type: string;
+    linkScore: number;
+}
+export interface IntentCheckResult {
+    verdict: IntentVerdict;
+    conflicts: ConflictSummary[];
+    relevant: RelevantSummary[];
+    latencyMs: number;
+    creditsConsumed: number;
+}
+export interface EnvelopeNotices {
+    truncated: boolean;
+    citationCount: number;
+}
+export interface DecisionDetail {
+    id: string;
+    type: string;
+    title: string;
+    problem: string | null;
+    decision: string;
+    rationale: string;
+    severity: string;
+    status: string;
+    alternatives: Array<{
+        option: string;
+        reasonRejected: string;
+    }> | null;
+    affectedFiles: string[];
+    tags: string[];
+    sourceType: string | null;
+    supersedes: string | null;
+    supersededBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastReviewedAt: string | null;
+}
+export type CaptureContextUnitType = 'decision' | 'convention' | 'constraint' | 'rationale' | 'ownership' | 'history' | 'plan';
+export interface CaptureDecisionInput {
+    type: CaptureContextUnitType;
+    title: string;
+    decision: string;
+    rationale: string;
+    problem?: string;
+    severity?: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    affectedFiles?: string[];
+    tags?: string[];
+    alternatives?: Array<{
+        option: string;
+        reasonRejected: string;
+    }>;
+    /** Agent-reported tokens spent discovering this knowledge. Capped server-side at 100k. */
+    discoveryCostTokens?: number;
+}
+export interface CaptureDecisionResult {
+    id: string;
+    alreadyExists: boolean;
+    similarityToExisting: number | null;
+    fusionPending: boolean;
+    status: 'active';
+    latencyMs: number;
+}
+export interface TopicSummary {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string | null;
+    readonly unitCount: number;
+}
+export interface TopicSpineUnit {
+    readonly id: string;
+    readonly type: string;
+    readonly title: string;
+    readonly severity: string;
+    readonly decision: string;
+    readonly rationale: string | null;
+}
+export interface TopicExpansionUnit {
+    readonly id: string;
+    readonly type: string;
+    readonly title: string;
+    readonly severity: string;
+    readonly decision?: string;
+    readonly rationale?: string | null;
+}
+export interface TopicContextResult {
+    readonly topicId: string;
+    readonly label: string;
+    readonly description: string | null;
+    readonly spine: readonly TopicSpineUnit[];
+    readonly expansion: readonly TopicExpansionUnit[];
+    readonly projectId: string | null;
+    readonly includeBodies: boolean;
+    readonly spineRequest: boolean;
+}
+export interface CapabilityTool {
+    name: string;
+    description: string;
+    costCredits?: number;
+    scopes?: string[];
+    defaultMaxTokens?: number;
+    projectScopedAware?: boolean;
+    status?: string;
+}
+export interface CapabilitiesResponse {
+    tools: CapabilityTool[];
+    apiKey: {
+        hasProjectScope: boolean;
+        projectId: string | null;
+        allowedScopes: string[];
+    };
+    apiVersion: string;
+}
+export interface HealthResponse {
+    status: string;
+    apiVersion: string;
+    commit: string;
+}
+export declare class DecispherClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly companyId;
+    private readonly sessionId;
+    /** Notices from the most recent envelope, surfaced by tools.ts in `_meta`. */
+    lastNotices: EnvelopeNotices | null;
+    constructor();
+    searchDecisions(query: string, options?: {
+        limit?: number;
+        types?: string[];
+    }): Promise<ContextMatch[]>;
+    getConstraints(options?: {
+        maxTokens?: number;
+        cursor?: string;
+        expand?: string[];
+    }): Promise<ConstraintSummary[]>;
+    getConventions(options?: {
+        maxTokens?: number;
+        cursor?: string;
+        expand?: string[];
+    }): Promise<ConventionSummary[]>;
+    ask(query: string): Promise<AskResponse>;
+    getDecision(decisionId: string): Promise<DecisionDetail>;
+    checkIntent(description: string, files?: string[]): Promise<IntentCheckResult>;
+    getContextForFiles(files: Array<{
+        filePath: string;
+        fileContent?: string;
+        language?: string;
+    }>, options?: {
+        limit?: number;
+    }): Promise<ContextMatch[]>;
+    getContextForFile(filePath: string, options?: {
+        fileContent?: string;
+        language?: string;
+        limit?: number;
+    }): Promise<ContextMatch[]>;
+    listTopics(): Promise<TopicSummary[]>;
+    getContextForTopic(topic: string, options?: {
+        includeBodies?: boolean;
+        maxTokens?: number;
+    }): Promise<TopicContextResult>;
+    captureDecision(input: CaptureDecisionInput): Promise<CaptureDecisionResult>;
+    /**
+     * Probe `/api/mcp/health` before the first tool call — no auth required.
+     * Returns null on any network/parse failure so the caller can fall through
+     * to the static tool list instead of crashing the MCP server at startup.
+     */
+    fetchHealth(): Promise<HealthResponse | null>;
+    /**
+     * Pull the tool registry from the server. Returns null if the request fails
+     * or the response shape is unrecognised — caller falls back to the embedded
+     * static tool list so the MCP server still works offline / against an older
+     * API that does not yet expose `/capabilities`.
+     */
+    fetchCapabilities(): Promise<CapabilitiesResponse | null>;
+    /** Parse an MCP envelope; transparently passes through legacy un-wrapped responses. */
+    private unwrap;
+    private isEnvelope;
+    private post;
+    private headers;
+}
+//# sourceMappingURL=decispher-client.d.ts.map

package/dist/decispher-client.d.ts.map

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