code-auditor-mcp 2.6.1 → 3.0.0

package/dist/native-bootstrap.js

@@ -0,0 +1,75 @@
+/**
+ * native-bootstrap.ts
+ *
+ * Sets NAPI_RS_NATIVE_LIBRARY_PATH before any module imports @ast-grep/napi.
+ *
+ * npm cli#4828 prevents platform-specific optionalDependencies from installing
+ * on stock npm. Our mitigation: we ship bundled .node files for all supported
+ * platforms in dist/native/. This module detects the current platform and points
+ * the @ast-grep/napi loader at the correct bundled binary.
+ *
+ * This file MUST be the FIRST import in every entry point (cli.ts, mcp.ts).
+ * It imports only Node.js built-ins — nothing that could pull in @ast-grep/napi.
+ */
+import { platform, arch } from 'node:process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+// ── Musl detection (same logic as @ast-grep/napi's isMusl) ──────────────────
+function isMusl() {
+    if (platform !== 'linux')
+        return false;
+    // Approach 1: check /usr/bin/ldd
+    try {
+        if (readFileSync('/usr/bin/ldd', 'utf-8').includes('musl'))
+            return true;
+    }
+    catch { /* not found */ }
+    // Approach 2: spawn ldd --version
+    try {
+        const out = execSync('ldd --version', { encoding: 'utf8', timeout: 2000 });
+        if (out.includes('musl'))
+            return true;
+    }
+    catch { /* not found or timed out */ }
+    return false;
+}
+// ── Platform → binding name mapping ────────────────────────────────────────
+function getBindingFileName() {
+    if (platform === 'darwin') {
+        if (arch === 'arm64')
+            return 'ast-grep-napi.darwin-arm64.node';
+        if (arch === 'x64')
+            return 'ast-grep-napi.darwin-x64.node';
+    }
+    if (platform === 'win32') {
+        if (arch === 'x64')
+            return 'ast-grep-napi.win32-x64-msvc.node';
+    }
+    if (platform === 'linux') {
+        const musl = isMusl();
+        if (arch === 'x64')
+            return musl ? 'ast-grep-napi.linux-x64-musl.node' : 'ast-grep-napi.linux-x64-gnu.node';
+        if (arch === 'arm64')
+            return musl ? 'ast-grep-napi.linux-arm64-musl.node' : 'ast-grep-napi.linux-arm64-gnu.node';
+    }
+    return null;
+}
+// ── Bootstrap ──────────────────────────────────────────────────────────────
+function bootstrapNativeBinding() {
+    // User override always wins — if they set it, don't touch
+    if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH)
+        return;
+    const bindingName = getBindingFileName();
+    if (!bindingName)
+        return;
+    // Resolve relative to this module's directory (dist/)
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const bundledPath = join(__dirname, 'native', bindingName);
+    if (existsSync(bundledPath)) {
+        process.env.NAPI_RS_NATIVE_LIBRARY_PATH = bundledPath;
+    }
+}
+bootstrapNativeBinding();
+//# sourceMappingURL=native-bootstrap.js.map

package/dist/native-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-bootstrap.js","sourceRoot":"","sources":["../src/native-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,+EAA+E;AAE/E,SAAS,MAAM;IACb,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAEvC,iCAAiC;IACjC,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;IAExC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAE9E,SAAS,kBAAkB;IACzB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,iCAAiC,CAAC;QAC/D,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,+BAA+B,CAAC;IAC7D,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,mCAAmC,CAAC;IACjE,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;QACtB,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,kCAAkC,CAAC;QAC3G,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,oCAAoC,CAAC;IACnH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAE9E,SAAS,sBAAsB;IAC7B,0DAA0D;IAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B;QAAE,OAAO;IAEpD,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,sDAAsD;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE3D,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,2BAA2B,GAAG,WAAW,CAAC;IACxD,CAAC;AACH,CAAC;AAED,sBAAsB,EAAE,CAAC"}

package/dist/reporting/csvReportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csvReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/csvReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,CAAC;CACzF;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAiCR;AAmGD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsBlE;AAGD,eAAO,MAAM,kBAAkB;;CAE9B,CAAC"}
+{"version":3,"file":"csvReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/csvReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,CAAC;CACzF;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAiCR;AAmGD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsBlE;AAGD,eAAO,MAAM,kBAAkB;IAC7B,QAAQ;CACT,CAAC"}

package/dist/reporting/htmlReportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"htmlReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/htmlReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAyBR;AA8UD,eAAO,MAAM,mBAAmB;;CAE/B,CAAC"}
+{"version":3,"file":"htmlReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/htmlReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAyBR;AA8UD,eAAO,MAAM,mBAAmB;IAC9B,QAAQ;CACT,CAAC"}

package/dist/reporting/jsonReportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/jsonReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAYR;AA4ED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqBrE;AAGD,eAAO,MAAM,mBAAmB;;CAE/B,CAAC"}
+{"version":3,"file":"jsonReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/jsonReportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAYR;AA4ED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqBrE;AAGD,eAAO,MAAM,mBAAmB;IAC9B,QAAQ;CACT,CAAC"}

package/dist/reporting/reportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/reportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKxD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAWhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC;qBASnF,WAAW,UAAU,MAAM,GAAG,MAAM;8BAQ3B,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM;2BAIrD,MAAM,EAAE;EAIlC;AAGD,eAAO,MAAM,eAAe;;CAE3B,CAAC"}
+{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/reportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMxD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAahF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC;IAUpG,QAAQ,SAAS,WAAW,UAAU,MAAM,GAAG,MAAM;IAQrD,iBAAiB,SAAS,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM;IAI5E,mBAAmB,IAAI,MAAM,EAAE;EAIlC;AAGD,eAAO,MAAM,eAAe;IAC1B,QAAQ;CACT,CAAC"}

package/dist/reporting/reportGenerator.js

@@ -5,6 +5,7 @@
 import { generateHTMLReport } from './htmlReportGenerator.js';
 import { generateJSONReport } from './jsonReportGenerator.js';
 import { generateCSVReport } from './csvReportGenerator.js';
+import { generateSARIFReport } from './sarifReportGenerator.js';
 /**
  * Generate a report in the specified format
  */
@@ -16,6 +17,8 @@ export function generateReport(result, format) {
             return generateJSONReport(result);
         case 'csv':
             return generateCSVReport(result);
+        case 'sarif':
+            return generateSARIFReport(result);
         default:
             throw new Error(`Unknown report format: ${format}`);
     }
@@ -28,6 +31,7 @@ export function createReportGenerator(customFormatters) {
         html: generateHTMLReport,
         json: generateJSONReport,
         csv: generateCSVReport,
+        sarif: generateSARIFReport,
         ...customFormatters
     };
     return {

package/dist/reporting/reportGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"reportGenerator.js","sourceRoot":"","sources":["../../src/reporting/reportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,MAAoB;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,gBAAkE;IACtG,MAAM,UAAU,GAAG;QACjB,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,iBAAiB;QACtB,GAAG,gBAAgB;KACpB,CAAC;IAEF,OAAO;QACL,QAAQ,CAAC,MAAmB,EAAE,MAAc;YAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAED,iBAAiB,CAAC,MAAc,EAAE,SAA0C;YAC1E,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,mBAAmB;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,cAAc;CACzB,CAAC"}
+{"version":3,"file":"reportGenerator.js","sourceRoot":"","sources":["../../src/reporting/reportGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,MAAoB;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,gBAAkE;IACtG,MAAM,UAAU,GAAoD;QAClE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,GAAG,gBAAgB;KACpB,CAAC;IAEF,OAAO;QACL,QAAQ,CAAC,MAAmB,EAAE,MAAc;YAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAED,iBAAiB,CAAC,MAAc,EAAE,SAA0C;YAC1E,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,mBAAmB;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,cAAc;CACzB,CAAC"}

package/dist/reporting/sarifReportGenerator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SARIF 2.1.0 Report Generator
+ *
+ * Produces valid SARIF output consumable by GitHub Code Scanning
+ * (via github/codeql-action/upload-sarif).
+ *
+ * Spec 06 — R1: SARIF 2.1.0 emitter for code-auditor-mcp.
+ */
+import type { AuditResult, Violation } from '../types.js';
+/**
+ * Resolves the stable rule identifier for a violation.
+ * The format is `{analyzerName}/{ruleId}`.
+ *
+ * Precedence for the rule-id portion:
+ *   1. `violation.rule`      (React, Universal Schema, Invariants)
+ *   2. `violation.principle`  (SOLID)
+ *   3. `violation.details.rule` (React — nested)
+ *   4. `violation.type`       (DRY, Data Access, Dependency Graph)
+ *   5. `violation.schemaType`  (Schema)
+ *   6. `violation.violationType` (general fallback)
+ *   7. `'unknown'`
+ */
+export declare function resolveRuleId(violation: Violation): string;
+/**
+ * Builds the full SARIF rule ID: `{analyzerName}/{localRuleId}`.
+ */
+export declare function buildFullRuleId(analyzerName: string, violation: Violation): string;
+export interface SARIFReportConfig {
+    /** Base path for making artifact URIs relative (default: process.cwd()) */
+    rootDir?: string;
+}
+/**
+ * Generates a SARIF 2.1.0 log string from an AuditResult.
+ */
+export declare function generateSARIFReport(result: AuditResult, config?: SARIFReportConfig): string;
+export declare const SARIFReportGenerator: {
+    generate: typeof generateSARIFReport;
+};
+//# sourceMappingURL=sarifReportGenerator.d.ts.map

package/dist/reporting/sarifReportGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarifReportGenerator.d.ts","sourceRoot":"","sources":["../../src/reporting/sarifReportGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsB1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA0B1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAGlF;AAiCD,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA8F3F;AAkFD,eAAO,MAAM,oBAAoB;IAC/B,QAAQ;CACT,CAAC"}

package/dist/reporting/sarifReportGenerator.js

@@ -0,0 +1,229 @@
+/**
+ * SARIF 2.1.0 Report Generator
+ *
+ * Produces valid SARIF output consumable by GitHub Code Scanning
+ * (via github/codeql-action/upload-sarif).
+ *
+ * Spec 06 — R1: SARIF 2.1.0 emitter for code-auditor-mcp.
+ */
+import { PACKAGE_VERSION } from '../constants.js';
+import { fingerprint } from '../fingerprint.js';
+// ── Constants ───────────────────────────────────────────────────────────────
+const SARIF_SCHEMA = 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json';
+const SARIF_VERSION = '2.1.0';
+const TOOL_NAME = 'code-auditor-mcp';
+const INFORMATION_URI = 'https://github.com/BenAHammond/code-auditor-mcp';
+// ── Severity mapping (Spec 06 R1.4) ────────────────────────────────────────
+const SEVERITY_TO_LEVEL = {
+    critical: 'error',
+    warning: 'warning',
+    suggestion: 'note',
+};
+// ── Rule ID resolution ──────────────────────────────────────────────────────
+/**
+ * Resolves the stable rule identifier for a violation.
+ * The format is `{analyzerName}/{ruleId}`.
+ *
+ * Precedence for the rule-id portion:
+ *   1. `violation.rule`      (React, Universal Schema, Invariants)
+ *   2. `violation.principle`  (SOLID)
+ *   3. `violation.details.rule` (React — nested)
+ *   4. `violation.type`       (DRY, Data Access, Dependency Graph)
+ *   5. `violation.schemaType`  (Schema)
+ *   6. `violation.violationType` (general fallback)
+ *   7. `'unknown'`
+ */
+export function resolveRuleId(violation) {
+    if (violation.rule && typeof violation.rule === 'string') {
+        return violation.rule;
+    }
+    if (violation.principle && typeof violation.principle === 'string') {
+        return violation.principle;
+    }
+    if (violation.details &&
+        typeof violation.details === 'object' &&
+        !Array.isArray(violation.details) &&
+        violation.details.rule &&
+        typeof violation.details.rule === 'string') {
+        return violation.details.rule;
+    }
+    if (violation.type && typeof violation.type === 'string') {
+        return violation.type;
+    }
+    if (violation.schemaType && typeof violation.schemaType === 'string') {
+        return violation.schemaType;
+    }
+    if (violation.violationType && typeof violation.violationType === 'string') {
+        return violation.violationType;
+    }
+    return 'unknown';
+}
+/**
+ * Builds the full SARIF rule ID: `{analyzerName}/{localRuleId}`.
+ */
+export function buildFullRuleId(analyzerName, violation) {
+    const localId = resolveRuleId(violation);
+    return `${normalizeAnalyzerName(analyzerName)}/${localId}`;
+}
+/**
+ * Normalizes analyzer names to short kebab-case identifiers.
+ */
+function normalizeAnalyzerName(name) {
+    const mapping = {
+        'solid-analyzer': 'solid',
+        'dry-analyzer': 'dry',
+        'react-analyzer': 'react',
+        'data-access-analyzer': 'data-access',
+        'documentation-analyzer': 'documentation',
+        'schema-analyzer': 'schema',
+        'universal-schema-analyzer': 'universal-schema',
+        'invariants-analyzer': 'invariants',
+        'dependency-graph-analyzer': 'dependency-graph',
+        'cross-language-solid-analyzer': 'solid',
+        'solid': 'solid',
+        'dry': 'dry',
+        'react': 'react',
+        'data-access': 'data-access',
+        'documentation': 'documentation',
+        'schema': 'schema',
+        'universal-schema': 'universal-schema',
+        'invariants': 'invariants',
+        'dependency-graph': 'dependency-graph',
+        'cross-language-solid': 'solid',
+    };
+    return mapping[name] ?? name.replace(/[^a-z0-9-]/g, '-').toLowerCase();
+}
+/**
+ * Generates a SARIF 2.1.0 log string from an AuditResult.
+ */
+export function generateSARIFReport(result, config) {
+    const rootDir = config?.rootDir ?? process.cwd();
+    const driverRules = [];
+    const seenRuleIds = new Set();
+    const results = [];
+    // Walk all analyzer results and build rules + results
+    for (const [analyzerName, analyzerResult] of Object.entries(result.analyzerResults)) {
+        const normName = normalizeAnalyzerName(analyzerName);
+        for (const violation of analyzerResult.violations) {
+            const fullRuleId = buildFullRuleId(analyzerName, violation);
+            // Collect unique rules
+            if (!seenRuleIds.has(fullRuleId)) {
+                seenRuleIds.add(fullRuleId);
+                driverRules.push({
+                    id: fullRuleId,
+                    shortDescription: {
+                        text: buildShortDescription(normName, resolveRuleId(violation)),
+                    },
+                    fullDescription: {
+                        text: violation.message,
+                    },
+                    helpUri: buildHelpUri(fullRuleId),
+                });
+            }
+            // Build result
+            const region = {};
+            if (violation.line != null) {
+                region.startLine = violation.line;
+                region.endLine = violation.line;
+            }
+            if (violation.column != null) {
+                region.startColumn = violation.column;
+            }
+            const artifactUri = makeRelativeUri(violation.file, rootDir);
+            const sarifResult = {
+                ruleId: fullRuleId,
+                level: mapSeverity(violation.severity),
+                message: {
+                    text: violation.message,
+                },
+                locations: [
+                    {
+                        physicalLocation: {
+                            artifactLocation: {
+                                uri: artifactUri,
+                            },
+                            region: Object.keys(region).length > 0 ? region : undefined,
+                        },
+                    },
+                ],
+                partialFingerprints: buildPartialFingerprints(analyzerName, violation),
+            };
+            // Add suggestion as a fix if present
+            if (violation.suggestion) {
+                sarifResult.fixes = [
+                    {
+                        description: {
+                            text: `Suggestion: ${violation.suggestion}`,
+                        },
+                    },
+                ];
+            }
+            results.push(sarifResult);
+        }
+    }
+    // Build the SARIF log
+    const sarifLog = {
+        $schema: SARIF_SCHEMA,
+        version: SARIF_VERSION,
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: TOOL_NAME,
+                        version: PACKAGE_VERSION,
+                        informationUri: INFORMATION_URI,
+                        rules: driverRules,
+                    },
+                },
+                results,
+            },
+        ],
+    };
+    return JSON.stringify(sarifLog, null, 2);
+}
+function mapSeverity(severity) {
+    return SEVERITY_TO_LEVEL[severity] ?? 'warning';
+}
+function makeRelativeUri(filePath, rootDir) {
+    // Normalize and make relative to root directory
+    const normalized = filePath.replace(/\\/g, '/');
+    if (rootDir && normalized.startsWith(rootDir.replace(/\\/g, '/'))) {
+        let relative = normalized.slice(rootDir.replace(/\\/g, '/').length);
+        if (relative.startsWith('/')) {
+            relative = relative.slice(1);
+        }
+        return relative || '.';
+    }
+    return normalized;
+}
+function buildShortDescription(analyzerName, ruleId) {
+    return `${analyzerName}: ${ruleId}`;
+}
+function buildHelpUri(fullRuleId) {
+    return `${INFORMATION_URI}#${fullRuleId.replace(/\//g, '-')}`;
+}
+function buildPartialFingerprints(analyzerName, violation) {
+    const normName = normalizeAnalyzerName(analyzerName);
+    const localRule = resolveRuleId(violation);
+    const symbol = violation.className ??
+        violation.functionName ??
+        violation.componentName ??
+        violation.symbol ??
+        violation.methodName ??
+        violation.name ??
+        'unknown';
+    const fp = fingerprint({
+        analyzer: normName,
+        rule: localRule,
+        file: violation.file,
+        symbol,
+    });
+    return {
+        'primary': fp,
+    };
+}
+// ── Backward-compatible object export ────────────────────────────────────────
+export const SARIFReportGenerator = {
+    generate: generateSARIFReport,
+};
+//# sourceMappingURL=sarifReportGenerator.js.map

package/dist/reporting/sarifReportGenerator.js.map

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

package/dist/search/QueryParser.d.ts

@@ -59,4 +59,45 @@ export declare class QueryParser {
     expandQuery(query: string): string;
 }
 export declare const queryParser: QueryParser;
+/** Compiled SQL query fragments for use with the SQLite-backed CodeIndexDB. */
+export interface SqlQuery {
+    /** FTS5 MATCH expression, or null if no free-text terms */
+    ftsMatch: string | null;
+    /** WHERE clause fragments (ANDed together) */
+    whereClauses: string[];
+    /** JOIN clauses for call/dependency graph traversal */
+    joinClauses: string[];
+    /** Named parameters for the prepared statement */
+    params: Record<string, any>;
+    /** ORDER BY clause */
+    orderBy: string;
+    /** LIMIT value */
+    limit: number;
+    /** OFFSET value */
+    offset: number;
+}
+/**
+ * Compile a parsed query into SQL fragments for the SQLite-backed CodeIndexDB.
+ *
+ * The caller assembles the final SQL from the returned fragments:
+ * ```sql
+ * SELECT f.* [, bm25(functions_fts) as score]
+ * FROM functions f
+ *   [JOIN functions_fts ON functions_fts.rowid = f.id]  -- when ftsMatch is set
+ *   {joinClauses...}
+ * WHERE 1=1
+ *   [AND functions_fts MATCH @ftsMatch]                -- when ftsMatch is set
+ *   {whereClauses...}
+ * ORDER BY {orderBy}
+ * LIMIT {limit} OFFSET {offset}
+ * ```
+ *
+ * @param parsedQuery  The parsed query from {@link QueryParser.parse}.
+ * @param options      Optional overrides for limit/offset.
+ * @returns Compiled SQL fragments.
+ */
+export declare function compileToSQL(parsedQuery: ParsedQuery, options?: {
+    defaultLimit?: number;
+    offset?: number;
+}): SqlQuery;
 //# sourceMappingURL=QueryParser.d.ts.map

package/dist/search/QueryParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryParser.d.ts","sourceRoot":"","sources":["../../src/search/QueryParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CA6D9B;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAmCtB;IAEX;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAgFxC;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA0DtB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAuFxB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAoJ5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IA8BhB;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAqB1C;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAK1C;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}
+{"version":3,"file":"QueryParser.d.ts","sourceRoot":"","sources":["../../src/search/QueryParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CA6D9B;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAoCtB;IAEX;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA8EvC;IAED;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA0DtB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAqFxB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IA+K5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IA8BhB;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBzC;IAED;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxC;CACF;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC;AAI7C,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,QAAQ,CAiKV"}