mnehmos.trace.mcp 1.0.0

package/dist/trace/index.js

@@ -0,0 +1,45 @@
+/**
+ * Trace MCP - Consumer Tracer
+ * Thin wrapper that delegates to language-specific parsers
+ */
+import { getParser, hasParser } from '../languages/index.js';
+/**
+ * Trace MCP tool usage in consumer code
+ * Defaults to TypeScript parser for backward compatibility
+ */
+export async function traceConsumerUsage(options) {
+    // For backward compatibility, default to TypeScript
+    const language = options.language || 'typescript';
+    // Get parser from registry
+    if (!hasParser(language)) {
+        throw new Error(`No parser available for language: ${language}. Make sure to call bootstrapLanguageParsers() at startup.`);
+    }
+    const parser = getParser(language);
+    return parser.traceUsage({
+        rootDir: options.rootDir,
+        callPatterns: options.callPatterns,
+        include: options.include,
+        exclude: options.exclude,
+    });
+}
+/**
+ * Trace usage from a single file
+ * Defaults to TypeScript parser for backward compatibility
+ */
+export async function traceFromFile(filePath, language) {
+    // For backward compatibility, default to TypeScript
+    const lang = language || 'typescript';
+    if (!hasParser(lang)) {
+        throw new Error(`No parser available for language: ${lang}. Make sure to call bootstrapLanguageParsers() at startup.`);
+    }
+    const parser = getParser(lang);
+    // Extract from the directory containing the file
+    const rootDir = filePath.substring(0, filePath.lastIndexOf('/') || filePath.lastIndexOf('\\'));
+    const fileName = filePath.substring((filePath.lastIndexOf('/') || filePath.lastIndexOf('\\')) + 1);
+    const allSchemas = await parser.traceUsage({
+        rootDir: rootDir || '.',
+        include: [fileName],
+    });
+    return allSchemas.filter(s => s.callSite.file === filePath);
+}
+//# sourceMappingURL=index.js.map

package/dist/trace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAe7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAsB;IAEtB,oDAAoD;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC;IAElD,2BAA2B;IAC3B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,4DAA4D,CAC1G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC,UAAU,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAiB;IACrE,oDAAoD;IACpD,MAAM,IAAI,GAAG,QAAQ,IAAI,YAAY,CAAC;IAEtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,4DAA4D,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/B,iDAAiD;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEnG,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACzC,OAAO,EAAE,OAAO,IAAI,GAAG;QACvB,OAAO,EAAE,CAAC,QAAQ,CAAC;KACpB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC9D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Trace MCP - Core Domain Types
+ * Based on DESIGN.md specifications
+ */
+import { z } from 'zod';
+export type JSONSchema = {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    additionalProperties?: boolean | JSONSchema;
+    description?: string;
+    [key: string]: unknown;
+};
+export interface SourceLocation {
+    file: string;
+    line: number;
+    column?: number;
+}
+export interface ProducerSchema {
+    toolName: string;
+    description?: string;
+    inputSchema: JSONSchema;
+    outputSchema: JSONSchema;
+    location: SourceLocation;
+}
+export interface ConsumerSchema {
+    toolName: string;
+    callSite: SourceLocation;
+    argumentsProvided: Record<string, unknown>;
+    expectedProperties: string[];
+}
+export type MismatchType = 'MISSING_PROPERTY' | 'TYPE_MISMATCH' | 'ARGUMENT_ERROR' | 'UNKNOWN_TOOL';
+export interface Mismatch {
+    toolName: string;
+    issueType: MismatchType;
+    description: string;
+    producerLocation?: SourceLocation;
+    consumerLocation: SourceLocation;
+    details?: Record<string, unknown>;
+}
+export interface Match {
+    toolName: string;
+    producerLocation: SourceLocation;
+    consumerLocation: SourceLocation;
+}
+export interface TraceResult {
+    timestamp: string;
+    producerSource: string;
+    consumerSource: string;
+    matches: Match[];
+    mismatches: Mismatch[];
+    summary: {
+        totalTools: number;
+        totalCalls: number;
+        matchCount: number;
+        mismatchCount: number;
+    };
+}
+export declare const SourceLocationSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    line: number;
+    column?: number | undefined;
+}, {
+    file: string;
+    line: number;
+    column?: number | undefined;
+}>;
+export declare const MismatchSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    issueType: z.ZodEnum<["MISSING_PROPERTY", "TYPE_MISMATCH", "ARGUMENT_ERROR", "UNKNOWN_TOOL"]>;
+    description: z.ZodString;
+    producerLocation: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    }, {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    }>>;
+    consumerLocation: z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    }, {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    }>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    toolName: string;
+    issueType: "MISSING_PROPERTY" | "TYPE_MISMATCH" | "ARGUMENT_ERROR" | "UNKNOWN_TOOL";
+    consumerLocation: {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    };
+    producerLocation?: {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    } | undefined;
+    details?: Record<string, unknown> | undefined;
+}, {
+    description: string;
+    toolName: string;
+    issueType: "MISSING_PROPERTY" | "TYPE_MISMATCH" | "ARGUMENT_ERROR" | "UNKNOWN_TOOL";
+    consumerLocation: {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    };
+    producerLocation?: {
+        file: string;
+        line: number;
+        column?: number | undefined;
+    } | undefined;
+    details?: Record<string, unknown> | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAKF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAKD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAKD,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,cAAc,CAAC;IAClC,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,cAAc,CAAC;IACjC,gBAAgB,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAKD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC"}

package/dist/types.js

@@ -0,0 +1,22 @@
+/**
+ * Trace MCP - Core Domain Types
+ * Based on DESIGN.md specifications
+ */
+import { z } from 'zod';
+// ============================================================================
+// Zod Validators (for runtime safety)
+// ============================================================================
+export const SourceLocationSchema = z.object({
+    file: z.string(),
+    line: z.number(),
+    column: z.number().optional(),
+});
+export const MismatchSchema = z.object({
+    toolName: z.string(),
+    issueType: z.enum(['MISSING_PROPERTY', 'TYPE_MISMATCH', 'ARGUMENT_ERROR', 'UNKNOWN_TOOL']),
+    description: z.string(),
+    producerLocation: SourceLocationSchema.optional(),
+    consumerLocation: SourceLocationSchema,
+    details: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmFxB,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,gBAAgB,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACjD,gBAAgB,EAAE,oBAAoB;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/watch/cache.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Schema Caching
+ * Checksum-based caching for extracted schemas and traced usage
+ */
+import type { ProducerSchema, ConsumerSchema } from '../types.js';
+import type { TraceProject } from './project.js';
+export declare class SchemaCache {
+    private project;
+    constructor(project: TraceProject);
+    /**
+     * Get cached producer schemas if still valid
+     */
+    getProducerSchemas(files: string[]): ProducerSchema[] | null;
+    /**
+     * Save producer schemas to cache
+     */
+    saveProducerSchemas(schemas: ProducerSchema[], files: string[]): void;
+    /**
+     * Get cached consumer usage if still valid
+     */
+    getConsumerUsage(files: string[]): ConsumerSchema[] | null;
+    /**
+     * Save consumer usage to cache
+     */
+    saveConsumerUsage(usage: ConsumerSchema[], files: string[]): void;
+    /**
+     * Check which files have changed since last cache
+     */
+    getChangedFiles(files: string[], side: 'producer' | 'consumer'): string[];
+    /**
+     * Invalidate cache for specific files
+     */
+    invalidateFiles(files: string[]): void;
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+    private computeChecksum;
+    private isFileValid;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/watch/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/watch/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAyCjD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAQjC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI;IA+B5D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IA2BrE;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI;IA6B1D;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IA2BjE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,EAAE;IA6BzE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IA+CtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;CAepB"}

package/dist/watch/cache.js

@@ -0,0 +1,230 @@
+/**
+ * Schema Caching
+ * Checksum-based caching for extracted schemas and traced usage
+ */
+import { existsSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { createHash } from 'crypto';
+import { join, relative } from 'path';
+// ============================================================================
+// Cache File Names
+// ============================================================================
+const PRODUCER_CACHE = 'producer-schemas.json';
+const CONSUMER_CACHE = 'consumer-usage.json';
+const CACHE_VERSION = '1.0.0';
+// ============================================================================
+// SchemaCache Class
+// ============================================================================
+export class SchemaCache {
+    project;
+    constructor(project) {
+        this.project = project;
+    }
+    // --------------------------------------------------------------------------
+    // Producer Cache
+    // --------------------------------------------------------------------------
+    /**
+     * Get cached producer schemas if still valid
+     */
+    getProducerSchemas(files) {
+        const cachePath = join(this.project.cachePath, PRODUCER_CACHE);
+        if (!existsSync(cachePath)) {
+            return null;
+        }
+        try {
+            const cache = JSON.parse(readFileSync(cachePath, 'utf-8'));
+            // Check version
+            if (cache.metadata.version !== CACHE_VERSION) {
+                return null;
+            }
+            // Check all files are still valid
+            for (const file of files) {
+                const relPath = relative(this.project.rootDir, file);
+                const cached = cache.metadata.checksums[relPath];
+                if (!cached || !this.isFileValid(file, cached)) {
+                    return null; // Cache invalidated
+                }
+            }
+            return cache.schemas;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save producer schemas to cache
+     */
+    saveProducerSchemas(schemas, files) {
+        const checksums = {};
+        for (const file of files) {
+            const relPath = relative(this.project.rootDir, file);
+            checksums[relPath] = this.computeChecksum(file);
+        }
+        const cache = {
+            metadata: {
+                version: CACHE_VERSION,
+                timestamp: new Date().toISOString(),
+                checksums,
+            },
+            schemas,
+        };
+        writeFileSync(join(this.project.cachePath, PRODUCER_CACHE), JSON.stringify(cache, null, 2));
+    }
+    // --------------------------------------------------------------------------
+    // Consumer Cache
+    // --------------------------------------------------------------------------
+    /**
+     * Get cached consumer usage if still valid
+     */
+    getConsumerUsage(files) {
+        const cachePath = join(this.project.cachePath, CONSUMER_CACHE);
+        if (!existsSync(cachePath)) {
+            return null;
+        }
+        try {
+            const cache = JSON.parse(readFileSync(cachePath, 'utf-8'));
+            if (cache.metadata.version !== CACHE_VERSION) {
+                return null;
+            }
+            for (const file of files) {
+                const relPath = relative(this.project.rootDir, file);
+                const cached = cache.metadata.checksums[relPath];
+                if (!cached || !this.isFileValid(file, cached)) {
+                    return null;
+                }
+            }
+            return cache.usage;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save consumer usage to cache
+     */
+    saveConsumerUsage(usage, files) {
+        const checksums = {};
+        for (const file of files) {
+            const relPath = relative(this.project.rootDir, file);
+            checksums[relPath] = this.computeChecksum(file);
+        }
+        const cache = {
+            metadata: {
+                version: CACHE_VERSION,
+                timestamp: new Date().toISOString(),
+                checksums,
+            },
+            usage,
+        };
+        writeFileSync(join(this.project.cachePath, CONSUMER_CACHE), JSON.stringify(cache, null, 2));
+    }
+    // --------------------------------------------------------------------------
+    // Incremental Updates
+    // --------------------------------------------------------------------------
+    /**
+     * Check which files have changed since last cache
+     */
+    getChangedFiles(files, side) {
+        const cachePath = join(this.project.cachePath, side === 'producer' ? PRODUCER_CACHE : CONSUMER_CACHE);
+        if (!existsSync(cachePath)) {
+            return files; // All files are "changed" (no cache)
+        }
+        try {
+            const cache = JSON.parse(readFileSync(cachePath, 'utf-8'));
+            const changed = [];
+            for (const file of files) {
+                const relPath = relative(this.project.rootDir, file);
+                const cached = cache.metadata?.checksums?.[relPath];
+                if (!cached || !this.isFileValid(file, cached)) {
+                    changed.push(file);
+                }
+            }
+            return changed;
+        }
+        catch {
+            return files;
+        }
+    }
+    /**
+     * Invalidate cache for specific files
+     */
+    invalidateFiles(files) {
+        // For now, just delete the entire cache
+        // Future: Could do incremental invalidation
+        const producerPath = join(this.project.cachePath, PRODUCER_CACHE);
+        const consumerPath = join(this.project.cachePath, CONSUMER_CACHE);
+        // We could be smarter here and just remove the affected checksums
+        // but full invalidation is safer for now
+        if (existsSync(producerPath)) {
+            const cache = JSON.parse(readFileSync(producerPath, 'utf-8'));
+            let invalidated = false;
+            for (const file of files) {
+                const relPath = relative(this.project.rootDir, file);
+                if (cache.metadata.checksums[relPath]) {
+                    delete cache.metadata.checksums[relPath];
+                    invalidated = true;
+                }
+            }
+            if (invalidated) {
+                // Mark cache as partially invalid
+                cache.metadata.timestamp = new Date().toISOString();
+                writeFileSync(producerPath, JSON.stringify(cache, null, 2));
+            }
+        }
+        // Same for consumer
+        if (existsSync(consumerPath)) {
+            const cache = JSON.parse(readFileSync(consumerPath, 'utf-8'));
+            let invalidated = false;
+            for (const file of files) {
+                const relPath = relative(this.project.rootDir, file);
+                if (cache.metadata.checksums[relPath]) {
+                    delete cache.metadata.checksums[relPath];
+                    invalidated = true;
+                }
+            }
+            if (invalidated) {
+                cache.metadata.timestamp = new Date().toISOString();
+                writeFileSync(consumerPath, JSON.stringify(cache, null, 2));
+            }
+        }
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        const producerPath = join(this.project.cachePath, PRODUCER_CACHE);
+        const consumerPath = join(this.project.cachePath, CONSUMER_CACHE);
+        if (existsSync(producerPath)) {
+            writeFileSync(producerPath, JSON.stringify({ schemas: [], metadata: { checksums: {} } }));
+        }
+        if (existsSync(consumerPath)) {
+            writeFileSync(consumerPath, JSON.stringify({ usage: [], metadata: { checksums: {} } }));
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Checksum Utilities
+    // --------------------------------------------------------------------------
+    computeChecksum(filePath) {
+        const stat = statSync(filePath);
+        const content = readFileSync(filePath);
+        const hash = createHash('sha256').update(content).digest('hex');
+        return {
+            path: relative(this.project.rootDir, filePath),
+            mtime: stat.mtimeMs,
+            size: stat.size,
+            hash,
+        };
+    }
+    isFileValid(filePath, cached) {
+        if (!existsSync(filePath)) {
+            return false;
+        }
+        const stat = statSync(filePath);
+        // Quick check: mtime and size
+        if (stat.mtimeMs !== cached.mtime || stat.size !== cached.size) {
+            return false;
+        }
+        // If mtime/size match, trust the cache (avoid expensive hash)
+        return true;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/watch/cache.js.map

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

package/dist/watch/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Watch Module Exports
+ */
+export { TraceProject, ProjectConfigSchema, findProject, loadProject } from './project.js';
+export type { ProjectConfig } from './project.js';
+export { SchemaCache } from './cache.js';
+export { TraceWatcher, getWatcher, stopWatcher, listActiveWatchers } from './watcher.js';
+export type { WatchEvent, WatchEventType, FileChangeData, ResultData } from './watcher.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,kBAAkB,EACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,cAAc,CAAC"}

package/dist/watch/index.js

@@ -0,0 +1,7 @@
+/**
+ * Watch Module Exports
+ */
+export { TraceProject, ProjectConfigSchema, findProject, loadProject } from './project.js';
+export { SchemaCache } from './cache.js';
+export { TraceWatcher, getWatcher, stopWatcher, listActiveWatchers } from './watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,kBAAkB,EACnB,MAAM,cAAc,CAAC"}

package/dist/watch/project.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Project Configuration Management
+ * Handles .trace-mcp directory and config files
+ */
+import { z } from 'zod';
+export declare const ProjectConfigSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    producer: z.ZodObject<{
+        path: z.ZodString;
+        language: z.ZodDefault<z.ZodEnum<["typescript", "python", "go", "rust", "json_schema"]>>;
+        include: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        exclude: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        language: "json_schema" | "typescript" | "python" | "go" | "rust";
+        include: string[];
+        exclude: string[];
+    }, {
+        path: string;
+        language?: "json_schema" | "typescript" | "python" | "go" | "rust" | undefined;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+    }>;
+    consumer: z.ZodObject<{
+        path: z.ZodString;
+        language: z.ZodDefault<z.ZodEnum<["typescript", "python", "go", "rust", "json_schema"]>>;
+        include: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        exclude: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        language: "json_schema" | "typescript" | "python" | "go" | "rust";
+        include: string[];
+        exclude: string[];
+    }, {
+        path: string;
+        language?: "json_schema" | "typescript" | "python" | "go" | "rust" | undefined;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+    }>;
+    options: z.ZodDefault<z.ZodObject<{
+        strict: z.ZodDefault<z.ZodBoolean>;
+        direction: z.ZodDefault<z.ZodEnum<["producer_to_consumer", "consumer_to_producer", "bidirectional"]>>;
+        debounceMs: z.ZodDefault<z.ZodNumber>;
+        autoWatch: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        strict: boolean;
+        direction: "producer_to_consumer" | "consumer_to_producer" | "bidirectional";
+        debounceMs: number;
+        autoWatch: boolean;
+    }, {
+        strict?: boolean | undefined;
+        direction?: "producer_to_consumer" | "consumer_to_producer" | "bidirectional" | undefined;
+        debounceMs?: number | undefined;
+        autoWatch?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        strict: boolean;
+        direction: "producer_to_consumer" | "consumer_to_producer" | "bidirectional";
+        debounceMs: number;
+        autoWatch: boolean;
+    };
+    producer: {
+        path: string;
+        language: "json_schema" | "typescript" | "python" | "go" | "rust";
+        include: string[];
+        exclude: string[];
+    };
+    consumer: {
+        path: string;
+        language: "json_schema" | "typescript" | "python" | "go" | "rust";
+        include: string[];
+        exclude: string[];
+    };
+    version: string;
+}, {
+    producer: {
+        path: string;
+        language?: "json_schema" | "typescript" | "python" | "go" | "rust" | undefined;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+    };
+    consumer: {
+        path: string;
+        language?: "json_schema" | "typescript" | "python" | "go" | "rust" | undefined;
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+    };
+    options?: {
+        strict?: boolean | undefined;
+        direction?: "producer_to_consumer" | "consumer_to_producer" | "bidirectional" | undefined;
+        debounceMs?: number | undefined;
+        autoWatch?: boolean | undefined;
+    } | undefined;
+    version?: string | undefined;
+}>;
+export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
+export declare class TraceProject {
+    readonly rootDir: string;
+    readonly traceDir: string;
+    private _config;
+    constructor(projectRoot: string);
+    /**
+     * Check if a .trace-mcp directory exists
+     */
+    exists(): boolean;
+    /**
+     * Initialize a new trace project
+     */
+    init(config: Partial<ProjectConfig>): ProjectConfig;
+    get config(): ProjectConfig;
+    get configPath(): string;
+    get cachePath(): string;
+    get contractsPath(): string;
+    get reportsPath(): string;
+    get producerPath(): string;
+    get consumerPath(): string;
+    updateConfig(updates: Partial<ProjectConfig>): ProjectConfig;
+}
+/**
+ * Find the nearest trace project by walking up directories
+ */
+export declare function findProject(startDir: string): TraceProject | null;
+/**
+ * Create or load a trace project
+ */
+export declare function loadProject(projectRoot: string): TraceProject;
+//# sourceMappingURL=project.d.ts.map

package/dist/watch/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/watch/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgBhE,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,CAA8B;gBAEjC,WAAW,EAAE,MAAM;IAS/B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IA2BnD,IAAI,MAAM,IAAI,aAAa,CAS1B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAMD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAMD,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;CAe7D;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAYjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAE7D"}