@decispher/mcp-server 0.1.0

package/dist/tools.js

@@ -0,0 +1,314 @@
+import { z } from 'zod';
+import { readFileForContext } from './lib/file-reader.js';
+const CAPTURE_TYPE_VALUES = [
+    'decision', 'convention', 'constraint', 'rationale',
+    'ownership', 'history', 'plan',
+];
+function buildResult(text, client, extraMeta) {
+    const notices = client.lastNotices;
+    const prefix = notices?.truncated
+        ? '⚠️ Result was truncated to fit the token budget. Refine the query or request a smaller scope.\n\n'
+        : '';
+    const meta = { ...extraMeta };
+    if (notices) {
+        meta['decispher'] = {
+            truncated: notices.truncated,
+            citationCount: notices.citationCount,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `${prefix}${text}` }],
+        ...(Object.keys(meta).length > 0 ? { _meta: meta } : {}),
+    };
+}
+const askToolHandler = async (args, client) => {
+    const { question } = args;
+    const result = await client.ask(question);
+    const freshnessNote = (tier, ageInDays) => {
+        if (!tier || tier === 'fresh')
+            return '';
+        if (tier === 'fossil')
+            return ` ⚠️ fossil (${ageInDays}d — last reviewed over a year ago; verify before relying on this)`;
+        if (tier === 'stale')
+            return ` ⚠️ stale (${ageInDays}d)`;
+        if (tier === 'aging')
+            return ` ⏳ aging (${ageInDays}d)`;
+        return '';
+    };
+    const sourceList = result.sources
+        .map((s) => `- ${s.title} (similarity: ${(s.similarity * 100).toFixed(0)}%)${freshnessNote(s.freshnessTier, s.ageInDays)}`)
+        .join('\n');
+    return buildResult(`${result.answer}${sourceList ? `\n\nSources:\n${sourceList}` : ''}`, client, {
+        contextUnits: result.contextUnits ?? result.sources.map((s) => ({
+            id: s.id,
+            title: s.title,
+            lastReviewedAt: s.lastReviewedAt,
+            ageInDays: s.ageInDays,
+            freshnessTier: s.freshnessTier,
+        })),
+    });
+};
+const checkIntentHandler = async (args, client) => {
+    const { description, files } = args;
+    const result = await client.checkIntent(description, files);
+    const lines = [`verdict: ${result.verdict}`];
+    if (result.conflicts.length > 0) {
+        lines.push('\nconflicts:', ...result.conflicts.map((c) => `  [${c.severity}] ${c.title}\n    ${c.explanation}`));
+    }
+    if (result.relevant.length > 0) {
+        lines.push('\nrelevant context:', ...result.relevant.map((r) => `  - [${r.type}] ${r.title}`));
+    }
+    return buildResult(lines.join('\n'), client);
+};
+/**
+ * Tool definitions — input schemas + handlers live here because the wire
+ * protocol with the MCP runtime is typed via Zod and the call body shapes
+ * are code-defined. Descriptions can be overridden at registration time by
+ * the server's /capabilities response (WS-E) so docs and gating live in
+ * one place server-side, but the executable bits stay client-side.
+ */
+export const TOOL_DEFINITIONS = [
+    {
+        name: 'search_decisions',
+        defaultDescription: 'Semantic search across the team\'s context units (decisions, conventions, constraints, rationale, ownership, history, plans). Returns the units most similar to the query.',
+        inputSchema: {
+            query: z.string().describe('Search query — can be a question, topic, file path, or code snippet'),
+            limit: z.number().int().min(1).max(10).optional().describe('Maximum number of results to return (1–10, default 5)'),
+            types: z.array(z.enum(CAPTURE_TYPE_VALUES))
+                .min(1).max(7).optional()
+                .describe('Filter to one or more of the 7 context unit types: decision, convention, constraint, rationale, ownership, history, plan. Omit to search all types.'),
+        },
+        handler: async (args, client) => {
+            const { query, limit, types } = args;
+            const matches = await client.searchDecisions(query, { limit, types });
+            return buildResult(JSON.stringify(matches, null, 2), client);
+        },
+    },
+    {
+        name: 'get_constraints',
+        defaultDescription: 'Get all active architectural constraints — rules the team has decided must not be violated (e.g. "Do not use Express.js", "All DB access via Repository pattern").',
+        inputSchema: {
+            maxTokens: z.number().int().min(100).max(32000).optional().describe('Token budget for the response body. When the full list exceeds this, items are summarised (body dropped) and a cursor is returned.'),
+            cursor: z.string().optional().describe('Opaque pagination cursor returned by a previous truncated call. Resumes from the next page.'),
+            expand: z.array(z.string()).optional().describe('List of constraint IDs whose full body should always be included even when summarising the rest.'),
+        },
+        handler: async (args, client) => {
+            const { maxTokens, cursor, expand } = args;
+            const constraints = await client.getConstraints({ maxTokens, cursor, expand });
+            return buildResult(JSON.stringify(constraints, null, 2), client);
+        },
+    },
+    {
+        name: 'check_conventions',
+        defaultDescription: 'Get all active coding conventions for this codebase. Use before writing new code to ensure you follow established patterns.',
+        inputSchema: {
+            maxTokens: z.number().int().min(100).max(32000).optional().describe('Token budget for the response body. When the full list exceeds this, items are summarised (body dropped) and a cursor is returned.'),
+            cursor: z.string().optional().describe('Opaque pagination cursor returned by a previous truncated call. Resumes from the next page.'),
+            expand: z.array(z.string()).optional().describe('List of convention IDs whose full body should always be included even when summarising the rest.'),
+        },
+        handler: async (args, client) => {
+            const { maxTokens, cursor, expand } = args;
+            const conventions = await client.getConventions({ maxTokens, cursor, expand });
+            return buildResult(JSON.stringify(conventions, null, 2), client);
+        },
+    },
+    {
+        name: 'ask_knowledge_base',
+        defaultDescription: 'Ask a natural language question about the codebase, architecture, or past decisions. Returns an AI-synthesized answer with cited sources from the knowledge base.',
+        inputSchema: {
+            question: z.string().describe('Your question about the codebase, architecture, or past decisions'),
+        },
+        handler: askToolHandler,
+    },
+    {
+        name: 'get_context_for_file',
+        defaultDescription: 'Get relevant context units for a file (or up to 10 files in one call). Use before editing — pass a single `filePath` for one file, or `filePaths` (array) when refactoring a feature that spans multiple files. The MCP client reads each file from disk (256 KB cap per file; over-cap files are sliced head + tail) and the server fuses results into one ranked list (max similarity per match across files).',
+        inputSchema: {
+            filePath: z.string().optional().describe('Relative file path from the repo root (e.g. "src/services/auth.ts"). Use this for a single file; otherwise use filePaths.'),
+            filePaths: z.array(z.string()).min(1).max(10).optional().describe('Array of 1–10 relative file paths. Use this when a task spans multiple files; the server returns one fused, deduplicated, ranked match list — saves the round-trips of calling the tool N times.'),
+            limit: z.number().int().min(1).max(10).optional().describe('Maximum number of context matches to return (1–10, default 5)'),
+        },
+        handler: async (args, client) => {
+            const { filePath, filePaths, limit } = args;
+            const paths = filePaths && filePaths.length > 0
+                ? filePaths
+                : filePath
+                    ? [filePath]
+                    : null;
+            if (!paths) {
+                throw new Error('get_context_for_file: provide either `filePath` (single) or `filePaths` (1–10).');
+            }
+            const reads = await Promise.all(paths.map(async (p) => ({ path: p, read: await readFileForContext(p) })));
+            const files = reads.map(({ path, read }) => ({
+                filePath: path,
+                ...(read ? { fileContent: read.content, ...(read.language ? { language: read.language } : {}) } : {}),
+            }));
+            // Build the single-file options object only if at least one field is
+            // present — otherwise pass `undefined` so the wire contract matches
+            // the legacy "path-only" call shape (the client treats undefined +
+            // {} identically, but tests + downstream observers can tell them
+            // apart).
+            const singleOpts = paths.length === 1
+                ? (() => {
+                    const opts = {};
+                    if (files[0].fileContent !== undefined)
+                        opts.fileContent = files[0].fileContent;
+                    if (files[0].language !== undefined)
+                        opts.language = files[0].language;
+                    if (limit !== undefined)
+                        opts.limit = limit;
+                    return Object.keys(opts).length > 0 ? opts : undefined;
+                })()
+                : undefined;
+            const matches = paths.length === 1
+                ? await client.getContextForFile(paths[0], singleOpts)
+                : await client.getContextForFiles(files, limit !== undefined ? { limit } : undefined);
+            // Preserve the legacy single-file `_meta.fileRead` shape when called
+            // with a single path so existing consumers don't break. Batch calls
+            // get the new `_meta.fileReads` array.
+            if (paths.length === 1) {
+                const r = reads[0].read;
+                return buildResult(JSON.stringify(matches, null, 2), client, {
+                    fileRead: r
+                        ? { truncated: r.truncated, bytesRead: r.bytesRead, language: r.language }
+                        : { truncated: false, bytesRead: 0, language: null, fallback: 'path-only' },
+                });
+            }
+            const fileReads = reads.map(({ path, read }) => ({
+                filePath: path,
+                ...(read
+                    ? { truncated: read.truncated, bytesRead: read.bytesRead, language: read.language }
+                    : { truncated: false, bytesRead: 0, language: null, fallback: 'path-only' }),
+            }));
+            return buildResult(JSON.stringify(matches, null, 2), client, { fileReads });
+        },
+    },
+    {
+        name: 'list_topics',
+        defaultDescription: 'List all topics available in this project — stable canonical slugs from the team\'s taxonomy. Free; the discovery primitive of the list_topics → get_context_for_topic → get_decision chain. Use this when overview.md predates a newly-added topic or when you need to confirm a topic id before calling get_context_for_topic.',
+        inputSchema: {},
+        handler: async (_args, client) => {
+            const topics = await client.listTopics();
+            return buildResult(JSON.stringify(topics, null, 2), client);
+        },
+    },
+    {
+        name: 'get_context_for_topic',
+        defaultDescription: 'Fetch the curated context cluster for a topic. Returns spine units inline (always-load CRITICAL rules) plus the IDs and titles of expansion units — call get_decision with any of those IDs for the full body. Use this when you are about to write code that touches a topic; it gives you everything the team has decided about that area without per-unit fetch churn. Pass `includeBodies: true` to inline expansion bodies in one shot (larger payload, higher cost).',
+        inputSchema: {
+            topic: z.string().min(1).max(128).describe('Topic ID — get from list_topics or from .decispher/overview.md'),
+            includeBodies: z.boolean().optional().describe('When true, includes full expansion bodies inline (more expensive). Default false.'),
+            maxTokens: z.number().int().min(500).max(32000).optional().describe('Token budget for the response. Default 8000.'),
+        },
+        handler: async (args, client) => {
+            const { topic, includeBodies, maxTokens } = args;
+            const result = await client.getContextForTopic(topic, {
+                ...(includeBodies !== undefined ? { includeBodies } : {}),
+                ...(maxTokens !== undefined ? { maxTokens } : {}),
+            });
+            return buildResult(JSON.stringify(result, null, 2), client);
+        },
+    },
+    {
+        name: 'get_decision',
+        defaultDescription: 'Fetch the full body of a specific context unit by ID. Every other MCP tool returns '
+            + 'IDs (search_decisions, get_constraints, check_conventions, ask_knowledge_base, '
+            + 'get_context_for_file, check_intent conflicts/relevant). Use this when you need '
+            + 'the complete rationale, alternatives, and affected files for any of those IDs.',
+        inputSchema: {
+            decisionId: z.string().min(1).describe('The ID of the context unit to fetch (from conflicts[].decisionId or search results)'),
+        },
+        handler: async (args, client) => {
+            const { decisionId } = args;
+            const detail = await client.getDecision(decisionId);
+            const lines = [
+                `[${detail.type}] ${detail.title}`,
+                `severity: ${detail.severity}  status: ${detail.status}`,
+            ];
+            if (detail.problem)
+                lines.push(`\nproblem:\n${detail.problem}`);
+            lines.push(`\ndecision:\n${detail.decision}`);
+            if (detail.rationale)
+                lines.push(`\nrationale:\n${detail.rationale}`);
+            if (detail.alternatives?.length) {
+                lines.push('\nalternatives considered:');
+                for (const alt of detail.alternatives) {
+                    lines.push(`  - ${alt.option} (rejected: ${alt.reasonRejected})`);
+                }
+            }
+            if (detail.affectedFiles.length)
+                lines.push(`\naffected files: ${detail.affectedFiles.join(', ')}`);
+            if (detail.tags.length)
+                lines.push(`tags: ${detail.tags.join(', ')}`);
+            if (detail.supersedes)
+                lines.push(`supersedes: ${detail.supersedes}`);
+            if (detail.supersededBy)
+                lines.push(`superseded by: ${detail.supersededBy}`);
+            return buildResult(lines.join('\n'), client);
+        },
+    },
+    {
+        name: 'check_intent',
+        defaultDescription: 'Check if a planned action conflicts with team constraints before proceeding. '
+            + 'Call this BEFORE generating code or making architectural changes. '
+            + 'Returns BLOCKED (hard conflict — stop), WARN (tension — proceed with caution), or CLEAR (no known conflicts).',
+        inputSchema: {
+            description: z.string().describe('What you are about to do — be specific (e.g. "Replace Redis cache with in-memory Map in src/cache/client.ts")'),
+            files: z.array(z.string()).optional().describe('Files you will touch — helps scope the conflict search'),
+        },
+        handler: checkIntentHandler,
+    },
+    {
+        name: 'capture_decision',
+        defaultDescription: 'Write a new context unit back into the team\'s knowledge base. Use ONLY for '
+            + 'durable, reusable knowledge worth recalling next session — never to dump scratch '
+            + 'notes or restate what is already in the repository.\n\n'
+            + 'Choose ONE `type`:\n'
+            + '  • decision   — "We chose X over Y because Z" (an architectural pick + rationale)\n'
+            + '  • convention — "We always do X this way" (a coding/process pattern the team follows)\n'
+            + '  • constraint — "We can\'t do X because Y" (a hard rule that must not be violated)\n'
+            + '  • rationale  — "X works this way because Y" (the reason behind existing behaviour)\n'
+            + '  • ownership  — "Person/team X owns Y" (who is responsible for what)\n'
+            + '  • history    — "We tried X, it failed because Y" (a past attempt and its outcome)\n'
+            + '  • plan       — "We\'re going to do X in the future" (a committed roadmap item)\n\n'
+            + 'If a near-duplicate already exists (cosine ≥ 0.95), the existing unit\'s id is '
+            + 'returned with `alreadyExists: true` and nothing is inserted. Captures are tagged '
+            + '`sourceType=agent_capture` and shown distinctly to humans in the dashboard.',
+        inputSchema: {
+            type: z.enum(CAPTURE_TYPE_VALUES)
+                .describe('Which of the 7 context unit types this capture is. Pick the most precise fit.'),
+            title: z.string().min(1).max(200).describe('Short, declarative summary (e.g. "Use Drizzle ORM, not Prisma")'),
+            decision: z.string().min(1).max(4000).describe('The substance of the knowledge — what was decided / observed / committed'),
+            rationale: z.string().min(1).max(4000).describe('WHY this is the case — the reasoning, evidence, or constraint that drove it'),
+            problem: z.string().max(4000).optional().describe('Optional — the problem this addresses, if framing as a decision'),
+            severity: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Impact if violated. Defaults to MEDIUM.'),
+            affectedFiles: z.array(z.string()).max(50).optional().describe('File paths this knowledge applies to (helps future retrieval target the right files)'),
+            tags: z.array(z.string()).max(20).optional().describe('Free-form tags for search/grouping (e.g. ["auth", "session"])'),
+            alternatives: z.array(z.object({
+                option: z.string().min(1).max(200),
+                reasonRejected: z.string().min(1).max(500),
+            })).max(10).optional().describe('Alternatives considered and why they were rejected — preserves the trade-off history'),
+            discoveryCostTokens: z.number().min(0).max(100000).optional().describe('How many tokens you spent to discover this. Capped at 100k; defaults to a type-based estimate.'),
+        },
+        handler: async (args, client) => {
+            const result = await client.captureDecision(args);
+            const line = result.alreadyExists
+                ? `already-known unit: ${result.id} (cosine ${(result.similarityToExisting ?? 0).toFixed(3)} ≥ 0.95). No new row created.`
+                : `captured: ${result.id} (status=active, fusionPending=${result.fusionPending})`;
+            return buildResult(line, client);
+        },
+    },
+];
+export function registerTools(server, client, options = {}) {
+    const { enabledTools, descriptions } = options;
+    for (const def of TOOL_DEFINITIONS) {
+        if (enabledTools && !enabledTools.has(def.name))
+            continue;
+        const description = descriptions?.[def.name] ?? def.defaultDescription;
+        server.registerTool(def.name, {
+            description,
+            inputSchema: z.object(def.inputSchema),
+        }, async (args) => def.handler(args, client));
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAC;AAMzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,mBAAmB,GAAsC;IAC3D,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW;IACnD,WAAW,EAAE,SAAS,EAAE,MAAM;CACjC,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY,EAAE,MAAuB,EAAE,SAAmC;IAC3F,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,EAAE,SAAS;QAC7B,CAAC,CAAC,mGAAmG;QACrG,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,IAAI,GAA4B,EAAE,GAAG,SAAS,EAAE,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACV,IAAI,CAAC,WAAW,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;SACvC,CAAC;IACN,CAAC;IACD,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACN,CAAC;AAWD,MAAM,cAAc,GAAgB,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IACvD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAA4B,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,SAAkB,EAAU,EAAE;QAChE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,eAAe,SAAS,mEAAmE,CAAC;QAC1H,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,cAAc,SAAS,IAAI,CAAC;QACzD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,aAAa,SAAS,IAAI,CAAC;QACxD,OAAO,EAAE,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;SAC1H,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhB,OAAO,WAAW,CACd,GAAG,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACpE,MAAM,EACN;QACI,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,aAAa,EAAE,CAAC,CAAC,aAAa;SACjC,CAAC,CAAC;KACN,CACJ,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAgB,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAC3D,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAiD,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAa,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CACN,cAAc,EACd,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,CACvF,CAAC;IACN,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACN,qBAAqB,EACrB,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAC9D,CAAC;IACN,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC3D;QACI,IAAI,EAAE,kBAAkB;QACxB,kBAAkB,EACd,4KAA4K;QAChL,WAAW,EAAE;YACT,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;YACjG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACnH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAuF,CAAC,CAAC;iBAC1G,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACxB,QAAQ,CAAC,qJAAqJ,CAAC;SACvK;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAA2D,CAAC;YAC5F,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;KACJ;IACD;QACI,IAAI,EAAE,iBAAiB;QACvB,kBAAkB,EACd,oKAAoK;QACxK,WAAW,EAAE;YACT,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oIAAoI,CAAC;YACzM,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6FAA6F,CAAC;YACrI,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kGAAkG,CAAC;SACtJ;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAkE,CAAC;YACzG,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;KACJ;IACD;QACI,IAAI,EAAE,mBAAmB;QACzB,kBAAkB,EACd,6HAA6H;QACjI,WAAW,EAAE;YACT,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oIAAoI,CAAC;YACzM,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6FAA6F,CAAC;YACrI,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kGAAkG,CAAC;SACtJ;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAkE,CAAC;YACzG,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;KACJ;IACD;QACI,IAAI,EAAE,oBAAoB;QAC1B,kBAAkB,EACd,mKAAmK;QACvK,WAAW,EAAE;YACT,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;SACrG;QACD,OAAO,EAAE,cAAc;KAC1B;IACD;QACI,IAAI,EAAE,sBAAsB;QAC5B,kBAAkB,EACd,kZAAkZ;QACtZ,WAAW,EAAE;YACT,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2HAA2H,CAAC;YACrK,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kMAAkM,CAAC;YACrQ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SAC9H;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAItC,CAAC;YAEF,MAAM,KAAK,GAAG,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAC3C,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,QAAQ;oBACN,CAAC,CAAC,CAAC,QAAQ,CAAC;oBACZ,CAAC,CAAC,IAAI,CAAC;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;YACvG,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1G,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACzC,QAAQ,EAAE,IAAI;gBACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxG,CAAC,CAAC,CAAC;YAEJ,qEAAqE;YACrE,oEAAoE;YACpE,mEAAmE;YACnE,iEAAiE;YACjE,UAAU;YACV,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC;gBACjC,CAAC,CAAC,CAAC,GAAG,EAAE;oBACJ,MAAM,IAAI,GAAgE,EAAE,CAAC;oBAC7E,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,KAAK,SAAS;wBAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC;oBAClF,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,KAAK,SAAS;wBAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC;oBACzE,IAAI,KAAK,KAAK,SAAS;wBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;oBAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC3D,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC;gBAC9B,CAAC,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,UAAU,CAAC;gBACvD,CAAC,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAE1F,qEAAqE;YACrE,oEAAoE;YACpE,uCAAuC;YACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;gBACzB,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE;oBACzD,QAAQ,EAAE,CAAC;wBACP,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;wBAC1E,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE;iBAClF,CAAC,CAAC;YACP,CAAC;YAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7C,QAAQ,EAAE,IAAI;gBACd,GAAG,CAAC,IAAI;oBACJ,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;oBACnF,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;aACnF,CAAC,CAAC,CAAC;YAEJ,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,CAAC;KACJ;IACD;QACI,IAAI,EAAE,aAAa;QACnB,kBAAkB,EACd,kUAAkU;QACtU,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;KACJ;IACD;QACI,IAAI,EAAE,uBAAuB;QAC7B,kBAAkB,EACd,4cAA4c;QAChd,WAAW,EAAE;YACT,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;YAC5G,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mFAAmF,CAAC;YACnI,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SACtH;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,IAI3C,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE;gBAClD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC,CAAC;YACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;KACJ;IACD;QACI,IAAI,EAAE,cAAc;QACpB,kBAAkB,EACd,qFAAqF;cACnF,iFAAiF;cACjF,iFAAiF;cACjF,gFAAgF;QACtF,WAAW,EAAE;YACT,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qFAAqF,CAAC;SAChI;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,IAA8B,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,KAAK,GAAa;gBACpB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE;gBAClC,aAAa,MAAM,CAAC,QAAQ,aAAa,MAAM,CAAC,MAAM,EAAE;aAC3D,CAAC;YACF,IAAI,MAAM,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;gBACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAkG,EAAE,CAAC;oBAC1H,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,eAAe,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;gBACtE,CAAC;YACL,CAAC;YACD,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7E,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;KACJ;IACD;QACI,IAAI,EAAE,cAAc;QACpB,kBAAkB,EACd,+EAA+E;cAC7E,oEAAoE;cACpE,+GAA+G;QACrH,WAAW,EAAE;YACT,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+GAA+G,CAAC;YACjJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SAC3G;QACD,OAAO,EAAE,kBAAkB;KAC9B;IACD;QACI,IAAI,EAAE,kBAAkB;QACxB,kBAAkB,EACd,8EAA8E;cAC5E,mFAAmF;cACnF,yDAAyD;cACzD,sBAAsB;cACtB,sFAAsF;cACtF,0FAA0F;cAC1F,uFAAuF;cACvF,wFAAwF;cACxF,yEAAyE;cACzE,uFAAuF;cACvF,sFAAsF;cACtF,iFAAiF;cACjF,mFAAmF;cACnF,6EAA6E;QACnF,WAAW,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAuF,CAAC;iBAChG,QAAQ,CAAC,+EAA+E,CAAC;YAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iEAAiE,CAAC;YAC7G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,0EAA0E,CAAC;YAC1H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6EAA6E,CAAC;YAC9H,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;YACpH,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACtH,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;YACtJ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;YACtH,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;aAC7C,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;YACvH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gGAAgG,CAAC;SAC3K;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,IAAuC,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa;gBAC7B,CAAC,CAAC,uBAAuB,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B;gBAC1H,CAAC,CAAC,aAAa,MAAM,CAAC,EAAE,kCAAkC,MAAM,CAAC,aAAa,GAAG,CAAC;YACtF,OAAO,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;KACJ;CACJ,CAAC;AAgBF,MAAM,UAAU,aAAa,CACzB,MAAiB,EACjB,MAAuB,EACvB,UAAgC,EAAE;IAElC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAE1D,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC;QAEvE,MAAM,CAAC,YAAY,CACf,GAAG,CAAC,IAAI,EACR;YACI,WAAW;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;SACzC,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CACrE,CAAC;IACN,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@decispher/mcp-server",
+    "version": "0.1.0",
+    "description": "Decispher MCP server — serves engineering decisions to AI coding agents",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "decispher-mcp": "./dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "start": "node dist/index.js",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "clean": "rimraf dist"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.29.0",
+        "zod": "^3.22.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "rimraf": "^6.0.0",
+        "typescript": "^5.7.0",
+        "vitest": "^3.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "keywords": [
+        "mcp",
+        "decispher",
+        "decisions",
+        "context",
+        "engineering",
+        "knowledge"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/gr8-alizaidi/decispher-platform"
+    }
+}

package/src/__tests__/file-reader.test.ts

@@ -0,0 +1,136 @@
+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: string;
+
+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');
+    });
+});