@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/dashboard/routes/static-handler.js

@@ -0,0 +1,123 @@
+import { readFile, stat } from 'node:fs/promises';
+import { extname, join, resolve, sep } from 'node:path';
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.map': 'application/json; charset=utf-8',
+    '.wasm': 'application/wasm',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.txt': 'text/plain; charset=utf-8',
+};
+async function serveIndexFallback(root, res) {
+    try {
+        const indexPath = join(root, 'index.html');
+        const data = await readFile(indexPath);
+        res.writeHead(200, {
+            'content-type': 'text/html; charset=utf-8',
+            'content-length': String(data.length),
+            // index.html must always be revalidated so a fresh build is picked
+            // up immediately. The hashed assets it references can be cached
+            // aggressively.
+            'cache-control': 'no-cache',
+        });
+        res.end(data);
+    }
+    catch {
+        res.writeHead(404);
+        res.end();
+    }
+}
+export function createStaticHandler(rootDir) {
+    const root = resolve(rootDir);
+    return async (req, res) => {
+        const url = req.url ?? '/';
+        const reqPath = url.split('?')[0] ?? '/';
+        const filename = reqPath === '/' ? 'index.html' : reqPath.replace(/^\/+/, '');
+        // Reject null bytes and explicit traversal components before path resolution.
+        // resolve() would eliminate these too, but the explicit check here makes the
+        // sanitization visible to static analysis (CodeQL js/path-injection).
+        if (filename.includes('\0') || filename.split('/').some((c) => c === '..')) {
+            res.writeHead(403);
+            res.end();
+            return;
+        }
+        const target = resolve(join(root, filename));
+        // Use a literal '/' so static analysis tools (CodeQL js/path-injection)
+        // can recognise this as the standard path-containment sanitizer pattern.
+        // The runtime sep from node:path would be equivalent on POSIX, but CodeQL
+        // cannot statically prove that sep === '/' and therefore misses the guard.
+        if (!target.startsWith(root + '/')) {
+            res.writeHead(403);
+            res.end();
+            return;
+        }
+        const ext = extname(target).toLowerCase();
+        const hasFileExtension = ext.length > 0;
+        // Only serve files whose extension appears in the explicit MIME allow-list.
+        // This limits what readFile() can reach to known web-asset types even if a
+        // future change inadvertently widens the path-containment check above.
+        if (hasFileExtension && !(ext in MIME)) {
+            res.writeHead(403);
+            res.end();
+            return;
+        }
+        try {
+            const st = await stat(target);
+            if (!st.isFile()) {
+                // An on-disk path that exists but is not a regular file
+                // (typically a directory like /assets/) is not a valid SPA route —
+                // returning index.html here masks misconfigured asset paths in
+                // dev. The SPA fallback is reserved for genuinely missing paths
+                // (the ENOENT path below).
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            const type = MIME[ext] ?? 'application/octet-stream';
+            const data = await readFile(target);
+            // Vite-built assets live under /assets/ with content-hash
+            // filenames (main-abc123.js), so they can be cached forever. The
+            // shell index.html must revalidate every time so a fresh build's
+            // new asset hashes are picked up. Other static files (the rare
+            // unhashed asset, robots.txt, favicons that aren't in /assets/)
+            // get a short cache for sane DevTools behaviour.
+            // Check against path relative to root, not the full absolute path, to
+            // avoid false positives when rootDir itself contains an 'assets' component.
+            const relPath = target.slice(root.length);
+            const isAsset = relPath.includes(`${sep}assets${sep}`);
+            const isIndexHtml = filename === 'index.html';
+            const cacheControl = isIndexHtml
+                ? 'no-cache'
+                : isAsset
+                    ? 'public, max-age=31536000, immutable'
+                    : 'public, max-age=300';
+            res.writeHead(200, {
+                'content-type': type,
+                'content-length': String(data.length),
+                'cache-control': cacheControl,
+            });
+            res.end(data);
+        }
+        catch {
+            if (hasFileExtension) {
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            return await serveIndexFallback(root, res);
+        }
+    };
+}
+//# sourceMappingURL=static-handler.js.map

package/dist/dashboard/routes/static-handler.js.map

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

package/dist/data/alerts/conditions/01-daily-cost-spike.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Hourly Cost Spike",
+  "description": "Fires when AI coding cost exceeds $10 in any 1-hour window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT sum(estimated_cost_usd) FROM AiCodingTask",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 3600,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": 10,
+    "duration": 3600,
+    "occurrences": "ALL"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions/02-low-efficiency-score.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Low Efficiency Score",
+  "description": "Fires when the rolling efficiency score drops below 40 for 30+ minutes.",
+  "enabled": true,
+  "nrqlQuery": "SELECT average(ai.efficiency.score) FROM Metric",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "BELOW",
+  "thresholdCritical": {
+    "value": 40,
+    "duration": 1800,
+    "occurrences": "ALL"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions/03-stuck-loop-rate.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Stuck Loop Spike",
+  "description": "Fires when stuck loop anti-patterns exceed 3 occurrences in a 5-minute window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT count(*) FROM AiAntiPattern WHERE type = 'stuck_loop'",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": 3,
+    "duration": 300,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 43200
+}

package/dist/data/alerts/conditions/04-anti-pattern-rate.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Anti-Pattern Rate Elevated",
+  "description": "Fires when total anti-patterns exceed 10 in any 10-minute window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT count(*) FROM AiAntiPattern",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 600,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": 10,
+    "duration": 600,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 43200
+}

package/dist/data/alerts/conditions/05-session-cost-budget.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Session Cost Over Budget",
+  "description": "Fires when a single session's cost exceeds $5. Adjust threshold to match your budget.",
+  "enabled": false,
+  "nrqlQuery": "SELECT max(ai.cost.session_total_usd) FROM Metric FACET session_id",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": 5,
+    "duration": 300,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions-personal/01-personal-daily-cost.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Personal Daily Cost — {{developer}}",
+  "description": "Fires when {{developer}}'s AI coding cost exceeds the personal threshold in any 1-hour window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT sum(estimated_cost_usd) FROM AiCodingTask WHERE developer = '{{developer}}'",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 3600,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": "__dailyCostUsd__",
+    "duration": 3600,
+    "occurrences": "ALL"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions-personal/02-personal-session-cost.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Personal Session Cost — {{developer}}",
+  "description": "Fires when a single session by {{developer}} exceeds the personal session cost threshold.",
+  "enabled": true,
+  "nrqlQuery": "SELECT max(ai.cost.session_total_usd) FROM Metric WHERE developer = '{{developer}}' FACET session_id",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": "__sessionCostUsd__",
+    "duration": 300,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions-personal/03-personal-low-efficiency.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Personal Low Efficiency — {{developer}}",
+  "description": "Fires when {{developer}}'s efficiency score stays below personal threshold for 30 minutes.",
+  "enabled": true,
+  "nrqlQuery": "SELECT average(ai.efficiency.score) FROM Metric WHERE developer = '{{developer}}'",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "BELOW",
+  "thresholdCritical": {
+    "value": "__efficiencyScoreMin__",
+    "duration": 1800,
+    "occurrences": "ALL"
+  },
+  "violationTimeLimitSeconds": 86400
+}

package/dist/data/alerts/conditions-personal/04-personal-anti-pattern-rate.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Personal Anti-Pattern Rate — {{developer}}",
+  "description": "Fires when {{developer}}'s anti-pattern rate exceeds personal threshold in a 5-minute window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT count(*) FROM AiAntiPattern WHERE developer = '{{developer}}'",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": "__antiPatternCountMax__",
+    "duration": 300,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 43200
+}

package/dist/data/alerts/conditions-personal/05-personal-stuck-loop.json

@@ -0,0 +1,16 @@
+{
+  "name": "AI Personal Stuck Loop — {{developer}}",
+  "description": "Fires when {{developer}} triggers more than the personal stuck loop threshold in a 5-minute window.",
+  "enabled": true,
+  "nrqlQuery": "SELECT count(*) FROM AiAntiPattern WHERE developer = '{{developer}}' AND type = 'stuck_loop'",
+  "aggregationMethod": "EVENT_FLOW",
+  "aggregationWindow": 300,
+  "aggregationDelay": 120,
+  "thresholdOperator": "ABOVE",
+  "thresholdCritical": {
+    "value": "__stuckLoopCountMax__",
+    "duration": 300,
+    "occurrences": "AT_LEAST_ONCE"
+  },
+  "violationTimeLimitSeconds": 43200
+}

package/dist/data/alerts/policy.json

@@ -0,0 +1,4 @@
+{
+  "name": "AI Coding Assistant Alerts",
+  "incidentPreference": "PER_CONDITION"
+}

package/dist/data/dashboards/ai-coding-assistant-manager-view.json

@@ -0,0 +1,103 @@
+{
+  "name": "AI Coding Assistant — Manager View",
+  "description": "Team-level AI coding cost and efficiency. No session content.",
+  "permissions": "PUBLIC_READ_ONLY",
+  "pages": [
+    {
+      "name": "Team Overview",
+      "widgets": [
+        {
+          "title": "Total AI Cost (7 days)",
+          "layout": { "column": 1, "row": 1, "width": 3, "height": 3 },
+          "visualization": { "id": "viz.billboard" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM AiCodingTask SELECT sum(estimated_cost_usd) AS 'Total Cost (USD)' SINCE 7 DAYS AGO"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Cost by Developer (7 days)",
+          "layout": { "column": 4, "row": 1, "width": 5, "height": 3 },
+          "visualization": { "id": "viz.bar" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM AiCodingTask SELECT sum(estimated_cost_usd) FACET developer SINCE 7 DAYS AGO"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Efficiency Score by Developer (0–1, ≥0.75 healthy)",
+          "layout": { "column": 9, "row": 1, "width": 4, "height": 3 },
+          "visualization": { "id": "viz.bar" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM Metric SELECT average(ai.efficiency.score) AS 'Score' FACET developer SINCE 7 DAYS AGO"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Daily AI Cost Trend",
+          "layout": { "column": 1, "row": 4, "width": 6, "height": 3 },
+          "visualization": { "id": "viz.line" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM AiCodingTask SELECT sum(estimated_cost_usd) FACET developer SINCE 30 DAYS AGO TIMESERIES 1 DAY"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Efficiency Score Trend",
+          "layout": { "column": 7, "row": 4, "width": 6, "height": 3 },
+          "visualization": { "id": "viz.line" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM Metric SELECT average(ai.efficiency.score) FACET developer SINCE 30 DAYS AGO TIMESERIES 1 DAY"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Anti-patterns by Developer",
+          "layout": { "column": 1, "row": 7, "width": 6, "height": 3 },
+          "visualization": { "id": "viz.bar" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT count(*) FROM AiAntiPattern SINCE 7 days ago FACET developer"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Cost by Project",
+          "layout": { "column": 7, "row": 7, "width": 6, "height": 3 },
+          "visualization": { "id": "viz.bar" },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM AiCodingTask SELECT sum(estimated_cost_usd) FACET project_id SINCE 7 DAYS AGO"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/data/dashboards/ai-coding-assistant-overview.json

@@ -0,0 +1,239 @@
+{
+  "name": "AI Coding Assistant \u2014 Overview",
+  "description": "Pre-built dashboard for Preflight observability. Requires AiToolCall custom events and ai.* metrics sent by the MCP server hook collector. Widgets will show 'No data' until the server is actively sending telemetry.",
+  "permissions": "PUBLIC_READ_WRITE",
+  "pages": [
+    {
+      "name": "AI Coding Assistant \u2014 Overview",
+      "description": "Session metrics, tool usage, code changes, and timeline for AI coding assistant sessions",
+      "widgets": [
+        {
+          "title": "Session Duration",
+          "layout": {
+            "column": 1,
+            "row": 1,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.billboard"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "FROM Metric SELECT latest(ai.session.duration_ms[sum]) / 60000 AS 'Minutes' WHERE session_id = {{session_id}} SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Total Tool Calls",
+          "layout": {
+            "column": 5,
+            "row": 1,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.billboard"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT count(*) AS 'Tool Calls' FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Success Rate",
+          "layout": {
+            "column": 9,
+            "row": 1,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.billboard"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT percentage(count(*), WHERE success = true) AS 'Success %' FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} SINCE 1 hour ago"
+              }
+            ],
+            "thresholds": [
+              {
+                "alertSeverity": "WARNING",
+                "value": 80
+              },
+              {
+                "alertSeverity": "CRITICAL",
+                "value": 50
+              }
+            ]
+          }
+        },
+        {
+          "title": "Tool Call Distribution",
+          "layout": {
+            "column": 1,
+            "row": 4,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.pie"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT count(*) FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} FACET tool SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Success Rate by Tool",
+          "layout": {
+            "column": 5,
+            "row": 4,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.bar"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT percentage(count(*), WHERE success = true) FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} FACET tool SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Average Latency by Tool",
+          "layout": {
+            "column": 9,
+            "row": 4,
+            "width": 4,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.bar"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT average(duration_ms) FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} FACET tool SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Files Read vs Modified",
+          "layout": {
+            "column": 1,
+            "row": 7,
+            "width": 6,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.bar"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT uniqueCount(filePath) AS 'Files Read' FROM AiToolCall WHERE tool = 'Read' AND developer = {{developer}} AND session_id = {{session_id}} SINCE 1 hour ago"
+              },
+              {
+                "accountIds": [],
+                "query": "SELECT uniqueCount(filePath) AS 'Files Modified' FROM AiToolCall WHERE tool IN ('Write', 'Edit') AND developer = {{developer}} AND session_id = {{session_id}} SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Test Results Timeline",
+          "layout": {
+            "column": 7,
+            "row": 7,
+            "width": 6,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.line"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT count(*) FROM AiToolCall WHERE tool = 'Bash' AND isTestCommand = true AND developer = {{developer}} AND session_id = {{session_id}} FACET CASES(WHERE success = true AS 'Pass', WHERE success = false AS 'Fail') TIMESERIES SINCE 1 hour ago"
+              }
+            ]
+          }
+        },
+        {
+          "title": "Tool Calls Over Time",
+          "layout": {
+            "column": 1,
+            "row": 10,
+            "width": 12,
+            "height": 3
+          },
+          "visualization": {
+            "id": "viz.line"
+          },
+          "rawConfiguration": {
+            "nrqlQueries": [
+              {
+                "accountIds": [],
+                "query": "SELECT count(*) FROM AiToolCall WHERE developer = {{developer}} AND session_id = {{session_id}} FACET tool TIMESERIES 1 minute SINCE 1 hour ago"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "variables": [
+    {
+      "name": "developer",
+      "title": "Developer",
+      "type": "NRQL",
+      "nrqlQuery": {
+        "query": "SELECT uniques(developer) FROM AiToolCall SINCE 7 days ago",
+        "accountIds": [0]
+      },
+      "isMultiSelection": false,
+      "defaultValues": [],
+      "replacementStrategy": "STRING",
+      "options": {
+        "excluded": true
+      }
+    },
+    {
+      "name": "session_id",
+      "title": "Session ID",
+      "type": "NRQL",
+      "nrqlQuery": {
+        "query": "SELECT uniques(session_id) FROM AiToolCall SINCE 7 days ago LIMIT 100",
+        "accountIds": []
+      },
+      "isMultiSelection": false,
+      "defaultValues": [],
+      "replacementStrategy": "STRING",
+      "options": {
+        "excluded": true
+      }
+    }
+  ]
+}