@machina.ai/openapi-contract-tester 2.1.0

package/dist/analyzers/semantic-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-matcher.js","sourceRoot":"","sources":["../../src/analyzers/semantic-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAwG7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,gBAAkC,EAClC,aAA6B,EAC7B,GAAmB;IAEnB,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAE/C,MAAM,eAAe,GAA4B,EAAE,CAAC;IACpD,MAAM,kBAAkB,GAAuB,EAAE,CAAC;IAClD,MAAM,oBAAoB,GAIrB,EAAE,CAAC;IAER,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAC5D,0CAA0C;QAC1C,OAAO,CAAC,aAAa,CAAC,IAAI,CACxB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CACnG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QACxD,0CAA0C;QAC1C,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAC3B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CACvG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,kDAAkD,EAAE;YAC3D,gBAAgB,EAAE,gBAAgB,CAAC,MAAM;YACzC,aAAa,EAAE,aAAa,CAAC,MAAM;SACpC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;QACnF,eAAe,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAC5D,OAAO,aAAa,CAAC,IAAI,CACvB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CACnG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,yCAAyC,EAAE;YAClD,gBAAgB,EAAE,gBAAgB,CAAC,MAAM;SAC1C,CAAC,CAAC;QAEH,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CACrC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CACnG,CAAC;YAEF,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,eAAe,GAAG,MAAM,+BAA+B,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;gBACxF,kBAAkB,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,IAAI,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,0CAA0C,EAAE;YACnD,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM;SACxC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,gCAAgC,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC5E,oBAAoB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE;QACrC,eAAe,EAAE,eAAe,CAAC,MAAM;QACvC,kBAAkB,EAAE,kBAAkB,CAAC,MAAM;QAC7C,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,eAAe;QACf,kBAAkB;QAClB,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,2BAA2B,CACxC,gBAAkC,EAClC,aAA6B;IAE7B,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG;;;YAGP,UAAU,CAAC,MAAM;UACnB,UAAU,CAAC,IAAI;iBACR,UAAU,CAAC,SAAS,EAAE,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,WAAW,IAAI,MAAM;kBAC3E,UAAU,CAAC,SAAS,EAAE,WAAW,IAAI,MAAM;;;EAG3D,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;mDAmB3F,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAE3E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBACnD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;oBAExC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;wBAC/G,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;wBAE1D,OAAO,CAAC,IAAI,CAAC;4BACX,eAAe,EAAE,UAAU;4BAC3B,YAAY;4BACZ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;4BACpC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,+BAA+B;4BAClE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ;4BACzC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;yBAC9B,CAAC,CAAC;wBAEH,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE;4BAC/B,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE;4BAClD,IAAI,EAAE,GAAG,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,EAAE;4BACnD,UAAU,EAAE,MAAM,CAAC,UAAU;yBAC9B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE;gBAChD,QAAQ,EAAE,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE;gBACnD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,+BAA+B,CAC5C,eAA+B,EAC/B,YAA0B;IAE1B,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,4EAA4E;IAC5E,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC;QACrC,GAAG,CAAC,eAAe,CAAC,WAAW,IAAI,EAAE,CAAC;QACtC,GAAG,CAAC,eAAe,CAAC,YAAY,IAAI,EAAE,CAAC;KACxC,CAAC;IACF,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC;IAEjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,UAAU,CAAC,CAAC,2BAA2B;IAChD,CAAC;IAED,MAAM,MAAM,GAAG;;YAEL,eAAe,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI;;mBAEvC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;mBACrB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;wCAoBA,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAE3E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACnD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBAExC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,iBAAiB;wBACvB,QAAQ,EAAE;4BACR,MAAM,EAAE,eAAe,CAAC,MAAM;4BAC9B,IAAI,EAAE,eAAe,CAAC,IAAI;yBAC3B;wBACD,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,QAAQ,EAAE,IAAI,CAAC,SAAS;wBACxB,MAAM,EAAE,IAAI,CAAC,SAAS;wBACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;wBACpC,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,oCAAoC,EAAE;YAC7C,QAAQ,EAAE,GAAG,eAAe,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE;YAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gCAAgC,CAC7C,GAAkB,EAClB,aAA6B;IAE7B,MAAM,QAAQ,GAAoE,EAAE,CAAC;IAErF,gCAAgC;IAChC,MAAM,cAAc,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG;;kBAED,IAAI,CAAC,IAAI;aACd,IAAI,CAAC,SAAS,IAAI,MAAM;oBACjB,IAAI,CAAC,eAAe,IAAI,MAAM;;;EAGhD,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;EAS5I,CAAC;QAEC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAE3E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBACnD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;oBAExC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;yBAC5C,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC;yBAC/D,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAE3F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,QAAQ,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,QAAQ;4BACR,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;yBACrC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBACvC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/analyzers/source-comparator.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Source Comparator Module
+ *
+ * Compares endpoints from different sources:
+ * - OpenAPI specification
+ * - Code analysis (from external MCP Code Analyzer)
+ * - PRD requirements
+ *
+ * Identifies discrepancies between what's documented, what's implemented,
+ * and what's required.
+ *
+ * @module analyzers/source-comparator
+ */
+import type { ParsedEndpoint } from '../types/index.js';
+import type { NormalizedPrd } from '../prd/prd-storage.js';
+/**
+ * Endpoint from code analysis (received from MCP Code Analyzer)
+ */
+export interface CodeEndpoint {
+    /**
+     * HTTP method
+     */
+    method: string;
+    /**
+     * Path pattern (e.g., /users/:id or /users/{id})
+     */
+    path: string;
+    /**
+     * Source file where this endpoint is defined
+     */
+    sourceFile?: string;
+    /**
+     * Line number in source file
+     */
+    lineNumber?: number;
+    /**
+     * Function/handler name
+     */
+    handlerName?: string;
+    /**
+     * Detected parameters
+     */
+    parameters?: string[];
+    /**
+     * Whether authentication is required (detected from code)
+     */
+    requiresAuth?: boolean;
+}
+/**
+ * A discrepancy found between sources
+ */
+export interface Discrepancy {
+    /**
+     * Type of discrepancy
+     */
+    type: DiscrepancyType;
+    /**
+     * Severity level
+     */
+    severity: 'error' | 'warning' | 'info';
+    /**
+     * Business priority level (based on endpoint importance)
+     */
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    /**
+     * Human-readable description
+     */
+    description: string;
+    /**
+     * Endpoint involved
+     */
+    endpoint?: {
+        method: string;
+        path: string;
+    };
+    /**
+     * What the OpenAPI spec says (if applicable)
+     */
+    openapi?: unknown;
+    /**
+     * What the code shows (if applicable)
+     */
+    code?: unknown;
+    /**
+     * What the PRD requires (if applicable)
+     */
+    prd?: unknown;
+    /**
+     * Suggested action to resolve
+     */
+    suggestion?: string;
+}
+/**
+ * Types of discrepancies that can be found
+ */
+export type DiscrepancyType = 'endpoint_in_code_not_in_spec' | 'endpoint_in_spec_not_in_code' | 'endpoint_in_prd_not_in_spec' | 'endpoint_in_prd_not_in_code' | 'method_mismatch' | 'path_mismatch' | 'auth_mismatch' | 'parameter_mismatch' | 'business_rule_not_implemented' | 'response_code_not_documented';
+/**
+ * Result of comparing sources
+ */
+export interface ComparisonResult {
+    /**
+     * Timestamp of comparison
+     */
+    timestamp: string;
+    /**
+     * Summary statistics
+     */
+    summary: {
+        totalEndpointsInSpec: number;
+        totalEndpointsInCode: number;
+        totalRequirementsInPrd: number;
+        matchingEndpoints: number;
+        discrepanciesFound: number;
+        errors: number;
+        warnings: number;
+        info: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    /**
+     * All endpoints found (merged from all sources)
+     */
+    allEndpoints: MergedEndpoint[];
+    /**
+     * List of discrepancies found
+     */
+    discrepancies: Discrepancy[];
+}
+/**
+ * Endpoint merged from all sources
+ */
+export interface MergedEndpoint {
+    method: string;
+    path: string;
+    inOpenApi: boolean;
+    inCode: boolean;
+    inPrd: boolean;
+    openApiDetails?: ParsedEndpoint;
+    codeDetails?: CodeEndpoint;
+    prdRequirements?: string[];
+}
+/**
+ * Options for comparison
+ */
+export interface CompareOptions {
+    /**
+     * Ignore path parameter naming differences (e.g., :id vs {id})
+     */
+    normalizePathParams?: boolean;
+    /**
+     * Include info-level discrepancies
+     */
+    includeInfo?: boolean;
+}
+/**
+ * Compares endpoints from OpenAPI spec, code analysis, and PRD
+ *
+ * @param openApiEndpoints - Endpoints from OpenAPI spec
+ * @param codeEndpoints - Endpoints from code analysis (optional)
+ * @param prd - Normalized PRD (optional)
+ * @param options - Comparison options
+ * @returns Comparison result with discrepancies
+ *
+ * @example
+ * ```typescript
+ * const result = compareSources(
+ *   openApiEndpoints,
+ *   codeEndpoints,
+ *   normalizedPrd
+ * );
+ * console.log(`Found ${result.discrepancies.length} discrepancies`);
+ * ```
+ */
+export declare function compareSources(openApiEndpoints: ParsedEndpoint[], codeEndpoints?: CodeEndpoint[], prd?: NormalizedPrd, options?: CompareOptions): ComparisonResult;
+//# sourceMappingURL=source-comparator.d.ts.map

package/dist/analyzers/source-comparator.d.ts.map

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

package/dist/analyzers/source-comparator.js

@@ -0,0 +1,225 @@
+/**
+ * Source Comparator Module
+ *
+ * Compares endpoints from different sources:
+ * - OpenAPI specification
+ * - Code analysis (from external MCP Code Analyzer)
+ * - PRD requirements
+ *
+ * Identifies discrepancies between what's documented, what's implemented,
+ * and what's required.
+ *
+ * @module analyzers/source-comparator
+ */
+import { createLogger } from '../utils/logger.js';
+import { calculatePriority, createEndpointKey } from './comparison-utils.js';
+const log = createLogger('source-comparator');
+/**
+ * Compares endpoints from OpenAPI spec, code analysis, and PRD
+ *
+ * @param openApiEndpoints - Endpoints from OpenAPI spec
+ * @param codeEndpoints - Endpoints from code analysis (optional)
+ * @param prd - Normalized PRD (optional)
+ * @param options - Comparison options
+ * @returns Comparison result with discrepancies
+ *
+ * @example
+ * ```typescript
+ * const result = compareSources(
+ *   openApiEndpoints,
+ *   codeEndpoints,
+ *   normalizedPrd
+ * );
+ * console.log(`Found ${result.discrepancies.length} discrepancies`);
+ * ```
+ */
+export function compareSources(openApiEndpoints, codeEndpoints, prd, options = {}) {
+    // Validate critical parameters
+    if (!openApiEndpoints || !Array.isArray(openApiEndpoints)) {
+        log.error('Invalid openApiEndpoints parameter', {
+            type: typeof openApiEndpoints,
+            isArray: Array.isArray(openApiEndpoints)
+        });
+        throw new Error(`openApiEndpoints must be an array, got ${typeof openApiEndpoints}. ` +
+            `This usually indicates the OpenAPI spec was not parsed correctly.`);
+    }
+    if (codeEndpoints !== undefined && !Array.isArray(codeEndpoints)) {
+        log.error('Invalid codeEndpoints parameter', {
+            type: typeof codeEndpoints,
+            isArray: Array.isArray(codeEndpoints)
+        });
+        throw new Error(`codeEndpoints must be an array if provided, got ${typeof codeEndpoints}`);
+    }
+    const { normalizePathParams = true, includeInfo = true } = options;
+    log.debug('Comparing sources', {
+        openApiCount: openApiEndpoints.length,
+        codeCount: codeEndpoints?.length || 0,
+        hasPrd: !!prd,
+    });
+    const discrepancies = [];
+    const mergedEndpoints = new Map();
+    // Index OpenAPI endpoints
+    for (const endpoint of openApiEndpoints) {
+        const key = createEndpointKey(endpoint.method, endpoint.path, normalizePathParams);
+        mergedEndpoints.set(key, {
+            method: endpoint.method,
+            path: endpoint.path,
+            inOpenApi: true,
+            inCode: false,
+            inPrd: false,
+            openApiDetails: endpoint,
+        });
+    }
+    // Compare with code endpoints
+    if (codeEndpoints && codeEndpoints.length > 0) {
+        for (const codeEndpoint of codeEndpoints) {
+            const key = createEndpointKey(codeEndpoint.method, codeEndpoint.path, normalizePathParams);
+            const existing = mergedEndpoints.get(key);
+            if (existing) {
+                existing.inCode = true;
+                existing.codeDetails = codeEndpoint;
+                // Check for auth mismatch
+                if (codeEndpoint.requiresAuth !== undefined && existing.openApiDetails) {
+                    const specRequiresAuth = (existing.openApiDetails.security?.length || 0) > 0;
+                    if (codeEndpoint.requiresAuth !== specRequiresAuth) {
+                        const authMismatchPriority = calculatePriority(codeEndpoint.path, 'warning');
+                        discrepancies.push({
+                            type: 'auth_mismatch',
+                            severity: 'warning',
+                            priority: authMismatchPriority,
+                            description: `Auth requirement differs: code ${codeEndpoint.requiresAuth ? 'requires' : 'does not require'} auth, spec ${specRequiresAuth ? 'requires' : 'does not require'} auth`,
+                            endpoint: { method: codeEndpoint.method, path: codeEndpoint.path },
+                            code: { requiresAuth: codeEndpoint.requiresAuth },
+                            openapi: { requiresAuth: specRequiresAuth },
+                            suggestion: 'Update OpenAPI spec or code to match auth requirements',
+                        });
+                    }
+                }
+            }
+            else {
+                // Endpoint in code but not in spec
+                mergedEndpoints.set(key, {
+                    method: codeEndpoint.method,
+                    path: codeEndpoint.path,
+                    inOpenApi: false,
+                    inCode: true,
+                    inPrd: false,
+                    codeDetails: codeEndpoint,
+                });
+                const codeNotInSpecPriority = calculatePriority(codeEndpoint.path, 'warning');
+                discrepancies.push({
+                    type: 'endpoint_in_code_not_in_spec',
+                    severity: 'warning',
+                    priority: codeNotInSpecPriority,
+                    description: `Endpoint ${codeEndpoint.method} ${codeEndpoint.path} exists in code but not documented in OpenAPI spec`,
+                    endpoint: { method: codeEndpoint.method, path: codeEndpoint.path },
+                    code: {
+                        sourceFile: codeEndpoint.sourceFile,
+                        lineNumber: codeEndpoint.lineNumber,
+                        handlerName: codeEndpoint.handlerName,
+                    },
+                    suggestion: 'Add this endpoint to the OpenAPI specification',
+                });
+            }
+        }
+        // Find endpoints in spec but not in code
+        for (const [_key, merged] of mergedEndpoints) {
+            if (merged.inOpenApi && !merged.inCode) {
+                const specNotInCodePriority = calculatePriority(merged.path, 'error');
+                discrepancies.push({
+                    type: 'endpoint_in_spec_not_in_code',
+                    severity: 'error',
+                    priority: specNotInCodePriority,
+                    description: `Endpoint ${merged.method} ${merged.path} is documented but not implemented`,
+                    endpoint: { method: merged.method, path: merged.path },
+                    openapi: { operationId: merged.openApiDetails?.operation?.operationId },
+                    suggestion: 'Implement this endpoint or remove it from the specification',
+                });
+            }
+        }
+    }
+    // Compare with PRD requirements
+    if (prd) {
+        // Check API requirements from PRD
+        for (const req of prd.apiRequirements) {
+            if (req.endpoint && req.method) {
+                const key = createEndpointKey(req.method, req.endpoint, normalizePathParams);
+                const existing = mergedEndpoints.get(key);
+                if (existing) {
+                    existing.inPrd = true;
+                    existing.prdRequirements = existing.prdRequirements || [];
+                    existing.prdRequirements.push(req.description);
+                }
+                else {
+                    // PRD requires endpoint not in spec or code
+                    mergedEndpoints.set(key, {
+                        method: req.method,
+                        path: req.endpoint,
+                        inOpenApi: false,
+                        inCode: false,
+                        inPrd: true,
+                        prdRequirements: [req.description],
+                    });
+                    const prdNotInSpecPriority = calculatePriority(req.endpoint, 'error');
+                    discrepancies.push({
+                        type: 'endpoint_in_prd_not_in_spec',
+                        severity: 'error',
+                        priority: prdNotInSpecPriority,
+                        description: `PRD requires endpoint ${req.method} ${req.endpoint} but it's not in the spec`,
+                        endpoint: { method: req.method, path: req.endpoint },
+                        prd: { requirement: req.description },
+                        suggestion: 'Add this endpoint to the OpenAPI specification and implement it',
+                    });
+                }
+            }
+        }
+        // Check business rules from PRD
+        for (const rule of prd.businessRules) {
+            if (rule.relatedEndpoints && rule.relatedEndpoints.length > 0) {
+                for (const endpointPattern of rule.relatedEndpoints) {
+                    // Check if any endpoint matches this pattern
+                    const hasMatch = Array.from(mergedEndpoints.values()).some(e => e.path.includes(endpointPattern) || endpointPattern.includes(e.path));
+                    if (!hasMatch && includeInfo) {
+                        const businessRulePriority = calculatePriority(endpointPattern, 'info');
+                        discrepancies.push({
+                            type: 'business_rule_not_implemented',
+                            severity: 'info',
+                            priority: businessRulePriority,
+                            description: `Business rule "${rule.name}" references endpoint pattern "${endpointPattern}" which may not be implemented`,
+                            prd: { rule: rule.name, condition: rule.condition, expectedOutcome: rule.expectedOutcome },
+                            suggestion: 'Verify this business rule is properly implemented',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Build summary
+    const summary = {
+        totalEndpointsInSpec: openApiEndpoints.length,
+        totalEndpointsInCode: codeEndpoints?.length || 0,
+        totalRequirementsInPrd: prd?.apiRequirements.length || 0,
+        matchingEndpoints: Array.from(mergedEndpoints.values()).filter(e => e.inOpenApi && e.inCode).length,
+        discrepanciesFound: discrepancies.length,
+        errors: discrepancies.filter(d => d.severity === 'error').length,
+        warnings: discrepancies.filter(d => d.severity === 'warning').length,
+        info: discrepancies.filter(d => d.severity === 'info').length,
+        critical: discrepancies.filter(d => d.priority === 'critical').length,
+        high: discrepancies.filter(d => d.priority === 'high').length,
+        medium: discrepancies.filter(d => d.priority === 'medium').length,
+        low: discrepancies.filter(d => d.priority === 'low').length,
+    };
+    log.info('Source comparison complete', summary);
+    // Sort discrepancies by priority (critical first)
+    const priorityWeight = { critical: 4, high: 3, medium: 2, low: 1 };
+    const sortedDiscrepancies = (includeInfo ? discrepancies : discrepancies.filter(d => d.severity !== 'info'))
+        .sort((a, b) => priorityWeight[b.priority] - priorityWeight[a.priority]);
+    return {
+        timestamp: new Date().toISOString(),
+        summary,
+        allEndpoints: Array.from(mergedEndpoints.values()),
+        discrepancies: sortedDiscrepancies,
+    };
+}
+// calculatePriority and createEndpointKey are now in comparison-utils.ts
+//# sourceMappingURL=source-comparator.js.map

package/dist/analyzers/source-comparator.js.map

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

package/dist/business-rules/business-rules-analyzer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Business Rules Analyzer
+ *
+ * Analyzes documentation (User Stories, Gherkin, requirements) and extracts
+ * business rules automatically. Supports multiple formats including:
+ * - Markdown with acceptance criteria
+ * - Gherkin/BDD feature files
+ * - Free text requirements
+ *
+ * @module business-rules/business-rules-analyzer
+ */
+import type { BusinessRulesDocument, BusinessRulesAnalyzerOptions, BusinessRulesAnalysisResult } from '../types/index.js';
+/**
+ * Analyzes documentation files and extracts business rules
+ *
+ * @param docsPath - Directory containing documentation files
+ * @param outputPath - Where to write business-rules.yml
+ * @param options - Analysis options
+ * @returns Analysis result with extracted rules
+ *
+ * @example
+ * ```typescript
+ * const result = await analyzeBusinessRules('./docs', './business-rules.yml', {
+ *   generateIds: true,
+ *   includeExamples: true
+ * });
+ * console.log(`Extracted ${result.rulesExtracted} rules`);
+ * ```
+ */
+export declare function analyzeBusinessRules(docsPath: string, outputPath: string, options?: BusinessRulesAnalyzerOptions): Promise<BusinessRulesAnalysisResult>;
+/**
+ * Reads and parses a business-rules.yml file
+ *
+ * @param filePath - Path to business-rules.yml
+ * @returns Parsed business rules document
+ *
+ * @example
+ * ```typescript
+ * const document = await readBusinessRulesYAML('./business-rules.yml');
+ * console.log(`Loaded ${document.rules.length} rules`);
+ * ```
+ */
+export declare function readBusinessRulesYAML(filePath: string): Promise<BusinessRulesDocument>;
+//# sourceMappingURL=business-rules-analyzer.d.ts.map

package/dist/business-rules/business-rules-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-rules-analyzer.d.ts","sourceRoot":"","sources":["../../src/business-rules/business-rules-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAEV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAG5B,MAAM,mBAAmB,CAAC;AAe3B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAsFtC;AAyKD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CA4FhC"}