@kryptosai/mcp-observatory 1.33.0 → 1.34.0

package/dist/src/commands/demo.js

@@ -0,0 +1,247 @@
+import { runTarget } from "../index.js";
+import { scanForTargets } from "../discovery.js";
+import { buildEvent, generateSessionId, recordEvent, recordSessionEnd, recordSessionStart } from "../telemetry.js";
+import { maybePrintCloudCta } from "../commercial.js";
+import { ANSI, c, colorStatus, getBinName, isQuiet, LOGO, printCiConversionCta, } from "./helpers.js";
+const DEMO_SERVERS = [
+    {
+        name: "fetch",
+        targetId: "@modelcontextprotocol/server-fetch",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-fetch"],
+        desc: "Fetch and convert web pages — safe, always available",
+    },
+    {
+        name: "filesystem",
+        targetId: "@modelcontextprotocol/server-filesystem",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+        desc: "Read/write local files — shows capability discovery",
+    },
+    {
+        name: "memory",
+        targetId: "@modelcontextprotocol/server-memory",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-memory"],
+        desc: "Persistent knowledge graph — shows resource handling",
+    },
+    {
+        name: "github",
+        targetId: "@modelcontextprotocol/server-github",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-github"],
+        desc: "GitHub API — needs GITHUB_PERSONAL_ACCESS_TOKEN",
+    },
+];
+function gradeBar(score) {
+    const width = 20;
+    const filled = Math.round((score / 100) * width);
+    const empty = width - filled;
+    if (score >= 90)
+        return c(ANSI.green, "█".repeat(filled)) + c(ANSI.dim, "░".repeat(empty));
+    if (score >= 70)
+        return c(ANSI.yellow, "█".repeat(filled)) + c(ANSI.dim, "░".repeat(empty));
+    if (score >= 60)
+        return c(ANSI.yellow, "█".repeat(filled)) + c(ANSI.dim, "░".repeat(empty));
+    return c(ANSI.red, "█".repeat(filled)) + c(ANSI.dim, "░".repeat(empty));
+}
+function gradeColor(grade) {
+    if (grade === "A")
+        return c(ANSI.green, grade);
+    if (grade === "B")
+        return c(ANSI.green, grade);
+    if (grade === "C")
+        return c(ANSI.yellow, grade);
+    if (grade === "D")
+        return c(ANSI.yellow, grade);
+    return c(ANSI.red, grade);
+}
+function dimBar(score) {
+    const width = 20;
+    const filled = Math.round((score / 100) * width);
+    const empty = width - filled;
+    return c(ANSI.dim, "▐".repeat(filled)) + c(ANSI.dim, "░".repeat(empty));
+}
+export function registerDemoCommands(program) {
+    program
+        .command("demo")
+        .description("Quick interactive demo — scan your MCP servers and see your safety grade")
+        .option("--server <name>", `Demo with a built-in server: ${DEMO_SERVERS.map(s => s.name).join(", ")}`)
+        .option("--deep", "Run full tool invocation and security checks (takes longer)", false)
+        .option("--no-color", "Disable colored output")
+        .action(async (options) => {
+        const sessionId = generateSessionId();
+        recordSessionStart(sessionId);
+        const t0 = Date.now();
+        const bin = getBinName();
+        if (!isQuiet()) {
+            process.stdout.write(LOGO + "\n");
+        }
+        process.stdout.write(c(ANSI.bold, "  MCP Observatory — Interactive Demo\n"));
+        process.stdout.write(`  ${c(ANSI.dim, "Scan your MCP servers. Get a safety grade. Ship with confidence.")}\n\n`);
+        // ── Step 1: Select target ──────────────────────────────────────────
+        process.stdout.write(`  ${c(ANSI.dim, "⟳")} Discovering your MCP servers...`);
+        const targets = await scanForTargets();
+        let targetConfig;
+        let targetSource;
+        if (options.server) {
+            const serverName = options.server.toLowerCase();
+            const demo = DEMO_SERVERS.find(s => s.name === serverName);
+            if (!demo) {
+                process.stdout.write(`\r  ${c(ANSI.red, "✗")} Unknown demo server "${options.server}".\n`);
+                process.stdout.write(`    ${c(ANSI.dim, `Available: ${DEMO_SERVERS.map(s => s.name).join(", ")}`)}\n`);
+                process.exitCode = 1;
+                recordSessionEnd(sessionId);
+                return;
+            }
+            targetConfig = {
+                targetId: demo.targetId,
+                adapter: "local-process",
+                command: demo.command,
+                args: demo.args,
+                timeoutMs: 15_000,
+            };
+            targetSource = `built-in demo (${demo.desc})`;
+            process.stdout.write(`\r  ${c(ANSI.green, "✓")} Using ${c(ANSI.bold, demo.name)} ${c(ANSI.dim, `— ${demo.desc}`)}\n`);
+        }
+        else if (targets.length > 0) {
+            process.stdout.write(`\r  ${c(ANSI.green, "✓")} Found ${targets.length} server${targets.length > 1 ? "s" : ""}\n`);
+            for (const t of targets.slice(0, 5)) {
+                process.stdout.write(`    ${c(ANSI.cyan, "●")} ${c(ANSI.bold, t.config.targetId)} ${c(ANSI.dim, `← ${t.source}`)}\n`);
+            }
+            if (targets.length > 5) {
+                process.stdout.write(`    ${c(ANSI.dim, `... and ${targets.length - 5} more`)}\n`);
+            }
+            targetConfig = targets[0].config;
+            targetSource = targets[0].source;
+            process.stdout.write(`\n  ${c(ANSI.dim, "Scanning first server...")}\n`);
+        }
+        else {
+            const demo = DEMO_SERVERS[0];
+            targetConfig = {
+                targetId: demo.targetId,
+                adapter: "local-process",
+                command: demo.command,
+                args: demo.args,
+                timeoutMs: 15_000,
+            };
+            targetSource = `built-in demo (${demo.desc})`;
+            process.stdout.write(`\r  ${c(ANSI.yellow, "!")} No MCP servers configured.\n`);
+            process.stdout.write(`    ${c(ANSI.dim, "Running built-in demo with")} ${c(ANSI.bold, demo.targetId)}\n`);
+            process.stdout.write(`    ${c(ANSI.dim, `Tip: ${bin} suggest  → discover servers for your stack`)}\n`);
+        }
+        process.stdout.write("\n");
+        // ── Step 2: Run scan ───────────────────────────────────────────────
+        process.stdout.write(`  ${c(ANSI.dim, "⟳")} Scanning ${c(ANSI.bold, targetConfig.targetId)}...`);
+        let artifact;
+        try {
+            artifact = await runTarget(targetConfig, {
+                invokeTools: options.deep,
+                securityCheck: options.deep,
+            });
+        }
+        catch (err) {
+            process.stdout.write(`\r  ${c(ANSI.red, "✗")} Scan failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.exitCode = 1;
+            recordEvent(buildEvent("command_complete", "demo", "cli", {
+                fatalError: err instanceof Error ? err.message : String(err),
+                stageOverride: "scan",
+                executionMs: Date.now() - t0,
+            }));
+            recordSessionEnd(sessionId);
+            return;
+        }
+        const scanMs = Date.now() - t0;
+        if (artifact.fatalError) {
+            process.stdout.write(`\r  ${c(ANSI.red, "✗")} ${c(ANSI.bold, targetConfig.targetId)} could not be reached\n`);
+            process.stdout.write(`    ${c(ANSI.dim, artifact.fatalError.split("\n")[0])}\n`);
+            process.stdout.write("\n");
+            process.stdout.write(`  ${c(ANSI.dim, "Try another:")} ${bin} demo --server <name>\n`);
+            process.stdout.write(`  ${c(ANSI.dim, `Built-in demos: ${DEMO_SERVERS.map(s => s.name).join(", ")}`)}\n\n`);
+            process.exitCode = 1;
+            recordEvent(buildEvent("command_complete", "demo", "cli", {
+                targetServer: targetConfig.targetId,
+                fatalError: artifact.fatalError.split("\n")[0],
+                executionMs: scanMs,
+            }));
+            recordSessionEnd(sessionId);
+            return;
+        }
+        const gateIcon = artifact.gate === "pass"
+            ? c(ANSI.green, "✓")
+            : c(ANSI.red, "✗");
+        process.stdout.write(`\r  ${gateIcon} Scan complete ${c(ANSI.dim, `(${scanMs}ms)`)}\n\n`);
+        // ── Step 3: Summary card ───────────────────────────────────────────
+        const toolCount = artifact.checks.find(ch => ch.id === "tools")?.evidence[0]?.itemCount ?? 0;
+        const promptCount = artifact.checks.find(ch => ch.id === "prompts")?.evidence[0]?.itemCount ?? 0;
+        const resourceCount = artifact.checks.find(ch => ch.id === "resources")?.evidence[0]?.itemCount ?? 0;
+        process.stdout.write(`  ${c(ANSI.bold, "Server")}    ${targetConfig.targetId}\n`);
+        process.stdout.write(`  ${c(ANSI.dim, "Source")}    ${targetSource}\n`);
+        process.stdout.write(`  ${c(ANSI.dim, "Capabilities")} ${toolCount} tools, ${promptCount} prompts, ${resourceCount} resources\n`);
+        // ── Step 4: Health Score ───────────────────────────────────────────
+        const hs = artifact.healthScore;
+        if (hs) {
+            process.stdout.write(`\n  ${c(ANSI.bold, "Safety Grade")}\n`);
+            process.stdout.write(`  ${gradeColor(hs.grade)}  ${hs.overall}/100  ${gradeBar(hs.overall)}\n\n`);
+            process.stdout.write(`  ${c(ANSI.dim, "Dimension Breakdown")}\n`);
+            for (const dim of hs.dimensions) {
+                const pct = Math.round(dim.weight * 100);
+                const label = dim.name.padEnd(22);
+                const scoreLabel = String(dim.score).padStart(3);
+                process.stdout.write(`  ${c(ANSI.bold, label)} ${scoreLabel}/100  ${dimBar(dim.score)} ${c(ANSI.dim, `(${pct}%)`)}\n`);
+            }
+        }
+        // ── Step 5: Check results ──────────────────────────────────────────
+        process.stdout.write(`\n  ${c(ANSI.bold, "Check Results")}\n`);
+        for (const check of artifact.checks) {
+            const icon = check.status === "pass" ? c(ANSI.green, "✓") :
+                check.status === "fail" ? c(ANSI.red, "✗") :
+                    c(ANSI.yellow, "○");
+            const status = colorStatus(check.status);
+            process.stdout.write(`  ${icon} ${check.id.padEnd(18)} ${status.padEnd(12)} ${c(ANSI.dim, check.message)}\n`);
+        }
+        process.stdout.write("\n");
+        // ── Step 6: Next steps ─────────────────────────────────────────────
+        if (artifact.gate === "pass") {
+            process.stdout.write(`  ${c(ANSI.green, "✓")} ${c(ANSI.bold, "All checks passed!")}\n\n`);
+            process.stdout.write(`  ${c(ANSI.bold, "What's next?")}\n`);
+            const serverCount = targets.length > 1 ? targets.length : "";
+            if (serverCount) {
+                process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} scan`)}${serverCount ? "" : ""} ${c(ANSI.dim, `— scan all ${serverCount} servers`)}\n`);
+            }
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} diff`)} <run1> <run2>  ${c(ANSI.dim, "- compare before/after")}\n`);
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} badge`)} <server>      ${c(ANSI.dim, "- generate a safety badge")}\n`);
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} setup-ci`)}             ${c(ANSI.dim, "- add to CI pipeline")}\n`);
+            printCiConversionCta({ bin, context: "keep this safety grade visible in CI", target: targetConfig });
+        }
+        else {
+            process.stdout.write(`  ${c(ANSI.yellow, "!")} ${c(ANSI.bold, "Some checks need attention")}\n\n`);
+            process.stdout.write(`  ${c(ANSI.bold, "Quick fixes:")}\n`);
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} enforce`)} ${targetConfig.targetId}  ${c(ANSI.dim, "- generate runtime policy")}\n`);
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} audit`)} ${targetConfig.targetId}   ${c(ANSI.dim, "- deep security audit")}\n`);
+            process.stdout.write(`    ${c(ANSI.cyan, "$")} ${c(ANSI.bold, `${bin} test --deep`)} ${targetConfig.targetId}  ${c(ANSI.dim, "- full tool invocation")}\n`);
+        }
+        process.stdout.write("\n");
+        // ── Telemetry ──────────────────────────────────────────────────────
+        const checkStatuses = {};
+        for (const ch of artifact.checks)
+            checkStatuses[ch.id] = ch.status;
+        recordEvent(buildEvent("command_complete", "demo", "cli", {
+            targetIds: [targetConfig.targetId],
+            gateResult: artifact.gate,
+            healthScore: hs?.overall,
+            healthGrade: hs?.grade,
+            toolsFound: toolCount,
+            promptsFound: promptCount,
+            resourcesFound: resourceCount,
+            checkStatuses,
+            serversScanned: targets.length,
+            deepFlag: options.deep,
+            executionMs: scanMs,
+            stageOverride: "demo",
+        }));
+        maybePrintCloudCta("general");
+        recordSessionEnd(sessionId);
+    });
+}
+//# sourceMappingURL=demo.js.map

package/dist/src/commands/demo.js.map

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

package/dist/src/commands/helpers.d.ts

@@ -15,6 +15,17 @@ export declare function useColor(): boolean;
 export declare function setQuiet(value: boolean): void;
 export declare function isQuiet(): boolean;
 export declare function c(code: string, text: string): string;
+/**
+ * Suggests a one-line remediation for a raw error message, so scan/test
+ * failures tell the user how to fix the problem, not just state it.
+ *
+ * Note: connection failures during MCP session startup already get a much
+ * richer diagnosis (diagnosis/likely causes/next steps) from
+ * `formatConnectionFailureDiagnosis` via `RunArtifact.fatalError` — this
+ * covers the lighter-weight cases outside that path (thrown exceptions,
+ * config parsing errors) where no such diagnosis exists.
+ */
+export declare function suggestFix(message: string): string | undefined;
 export declare function colorStatus(status: string): string;
 export declare function readTargetConfig(filePath: string): Promise<TargetConfig>;
 export declare function targetFromCommand(args: string[]): TargetConfig;

package/dist/src/commands/helpers.js

@@ -44,6 +44,32 @@ export function isQuiet() {
 export function c(code, text) {
     return useColor() ? `${code}${text}${ANSI.reset}` : text;
 }
+/**
+ * Suggests a one-line remediation for a raw error message, so scan/test
+ * failures tell the user how to fix the problem, not just state it.
+ *
+ * Note: connection failures during MCP session startup already get a much
+ * richer diagnosis (diagnosis/likely causes/next steps) from
+ * `formatConnectionFailureDiagnosis` via `RunArtifact.fatalError` — this
+ * covers the lighter-weight cases outside that path (thrown exceptions,
+ * config parsing errors) where no such diagnosis exists.
+ */
+export function suggestFix(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("timed out") || lower.includes("timeout")) {
+        return "Try increasing timeout with --timeout 30000";
+    }
+    if (lower.includes("econnrefused") || lower.includes("connection refused")) {
+        return "Check that the server is running. Try: npx -y <server-package>";
+    }
+    if (lower.includes("enoent") || lower.includes("spawn")) {
+        return "Check that the command is installed and on PATH. Try: npx -y <server-package>";
+    }
+    if (lower.includes("unexpected token") || lower.includes("invalid config") || lower.includes("is not valid json")) {
+        return "Check target JSON format. Run: cat <config-file>";
+    }
+    return undefined;
+}
 export function colorStatus(status) {
     switch (status) {
         case "pass":

package/dist/src/commands/helpers.js.map

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

package/dist/src/commands/init-ci.d.ts

@@ -20,6 +20,7 @@ export interface InitCiOptions {
     fix?: boolean;
     fromLastRun?: boolean;
     campaign?: string;
+    ciProvider?: "github-actions" | "gitlab-ci" | "circleci" | "bitbucket-pipelines" | "azure-pipelines";
 }
 export interface InitCiResult {
     workflowStatus: string;

package/dist/src/commands/init-ci.js

@@ -1,9 +1,26 @@
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { buildEvent, normalizeCampaign, recordEvent } from "../telemetry.js";
+import { buildEvent, detectCiProvider, normalizeCampaign, recordEvent } from "../telemetry.js";
 import { defaultRunsDirectory, findLatestSuccessfulRunArtifact, readArtifact } from "../storage.js";
 import { TOOL_VERSION } from "../version.js";
 import { quoteShell } from "./helpers.js";
+const CI_FILE_PATHS = {
+    "github-actions": ".github/workflows/mcp-observatory.yml",
+    "gitlab-ci": ".gitlab-ci.yml",
+    "circleci": ".circleci/config.yml",
+    "bitbucket-pipelines": "bitbucket-pipelines.yml",
+    "azure-pipelines": "azure-pipelines.yml",
+};
+const PROVIDER_LABELS = {
+    "github-actions": "GitHub Action",
+    "gitlab-ci": "GitLab CI",
+    "circleci": "CircleCI",
+    "bitbucket-pipelines": "Bitbucket Pipelines",
+    "azure-pipelines": "Azure Pipelines",
+};
+function providerLabel(provider) {
+    return PROVIDER_LABELS[provider] ?? "CI Workflow";
+}
 const DEFAULT_WORKFLOW_PATH = ".github/workflows/mcp-observatory.yml";
 const DEFAULT_BADGE_PATH = "docs/mcp-observatory-badge.md";
 const DEFAULT_TARGET_CONFIG_PATH = "mcp-observatory.target.json";
@@ -31,7 +48,7 @@ function normalizeSchedule(schedule) {
     const value = schedule.trim();
     return value.length > 0 ? value : DEFAULT_WEEKLY_CRON;
 }
-function workflowYaml(options) {
+function githubActionsYaml(options) {
     const command = options.command?.trim();
     const target = options.target?.trim();
     const commentsEnabled = options.commentOnPr === true;
@@ -76,6 +93,129 @@ function workflowYaml(options) {
     lines.push("");
     return lines.join("\n");
 }
+function workflowYaml(options) {
+    const provider = options.ciProvider ?? "github-actions";
+    switch (provider) {
+        case "github-actions": return githubActionsYaml(options);
+        case "gitlab-ci": return gitlabCiYaml(options);
+        case "circleci": return circleCiYaml(options);
+        case "bitbucket-pipelines": return bitbucketYaml(options);
+        case "azure-pipelines": return azurePipelinesYaml(options);
+        default: return githubActionsYaml(options);
+    }
+}
+function gitlabCiYaml(options) {
+    const lines = [
+        "mcp-observatory:",
+        "  image: node:22",
+    ];
+    if (options.schedule) {
+        lines.push("  only:", "    - schedules");
+    }
+    else {
+        lines.push("  rules:", "    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'", "    - if: $CI_COMMIT_BRANCH == 'main'");
+    }
+    lines.push("  script:");
+    if (options.command) {
+        lines.push(`    - npx @kryptosai/mcp-observatory test ${options.command} --deep --security` + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else if (options.all) {
+        lines.push("    - npx @kryptosai/mcp-observatory scan --deep --security" + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else {
+        lines.push(`    - npx @kryptosai/mcp-observatory test --target mcp-observatory.target.json --deep --security`);
+    }
+    if (options.sarif !== false) {
+        lines.push("  artifacts:", "    reports:", "      sast: mcp-observatory.sarif");
+    }
+    return lines.join("\n");
+}
+function circleCiYaml(options) {
+    const lines = [
+        "version: 2.1",
+        "",
+        "jobs:",
+        "  mcp-observatory:",
+        "    docker:",
+        "      - image: cimg/node:22.0",
+        "    steps:",
+        "      - checkout",
+        `      - run:`,
+    ];
+    if (options.command) {
+        lines.push(`          command: npx @kryptosai/mcp-observatory test ${options.command} --deep --security` + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else if (options.all) {
+        lines.push("          command: npx @kryptosai/mcp-observatory scan --deep --security" + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else {
+        lines.push("          command: npx @kryptosai/mcp-observatory test --target mcp-observatory.target.json --deep --security");
+    }
+    if (options.sarif !== false) {
+        lines.push("      - store_artifacts:", "          path: mcp-observatory.sarif");
+    }
+    lines.push("", "workflows:", "  version: 2", "  mcp-observatory-workflow:", "    jobs:", "      - mcp-observatory" + (options.schedule ? ":\n          filters:\n            branches:\n              only: /scheduled-scan/" : ""));
+    return lines.join("\n");
+}
+function bitbucketYaml(options) {
+    const lines = [
+        "image: node:22",
+        "",
+        "pipelines:",
+    ];
+    if (options.schedule) {
+        lines.push("  custom:");
+        lines.push("    mcp-observatory-scheduled:");
+    }
+    else {
+        lines.push("  pull-requests:");
+        lines.push("    '**':");
+    }
+    lines.push("      - step:");
+    lines.push("          name: MCP Observatory Safety Check");
+    lines.push("          script:");
+    if (options.command) {
+        lines.push(`            - npx @kryptosai/mcp-observatory test ${options.command} --deep --security` + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else if (options.all) {
+        lines.push("            - npx @kryptosai/mcp-observatory scan --deep --security" + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else {
+        lines.push("            - npx @kryptosai/mcp-observatory test --target mcp-observatory.target.json --deep --security");
+    }
+    if (options.sarif !== false) {
+        lines.push("          artifacts:", "            - mcp-observatory.sarif");
+    }
+    if (!options.schedule && options.command) {
+        lines.push("", "  branches:", "    main:", "      - step:", "          name: MCP Observatory Safety Check", "          script:", `            - npx @kryptosai/mcp-observatory test ${options.command} --deep --security` + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    return lines.join("\n");
+}
+function azurePipelinesYaml(options) {
+    const lines = [
+        "trigger:",
+        "  - main",
+        "",
+    ];
+    if (!options.schedule) {
+        lines.push("pr:", "  - main", "");
+    }
+    else {
+        lines.push("schedules:", "  - cron: '0 6 * * *'", "    displayName: Daily MCP safety scan", "    branches:", "      include:", "        - main", "");
+    }
+    lines.push("pool:", "  vmImage: ubuntu-latest", "", "steps:", "  - task: NodeTool@0", "    inputs:", "      versionSpec: '22.x'", "    displayName: 'Install Node.js'", "", "  - script: |");
+    if (options.command) {
+        lines.push(`      npx @kryptosai/mcp-observatory test ${options.command} --deep --security` + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else if (options.all) {
+        lines.push("      npx @kryptosai/mcp-observatory scan --deep --security" + (options.sarif !== false ? " --sarif mcp-observatory.sarif" : ""));
+    }
+    else {
+        lines.push("      npx @kryptosai/mcp-observatory test --target mcp-observatory.target.json --deep --security");
+    }
+    lines.push("    displayName: 'MCP Observatory Safety Check'");
+    return lines.join("\n");
+}
 function badgeMarkdown() {
     return [
         "[![MCP Observatory](https://img.shields.io/badge/MCP%20Observatory-enabled-2563eb)](https://github.com/KryptosAI/mcp-observatory)",
@@ -258,18 +398,21 @@ function doctorFixOptions(options, workflow) {
     };
 }
 export async function doctorSetupCi(options = {}) {
-    const workflowPath = options.workflow ?? DEFAULT_WORKFLOW_PATH;
+    const detectedProvider = options.ciProvider ?? detectCiProvider() ?? "github-actions";
+    const defaultPath = CI_FILE_PATHS[detectedProvider] ?? DEFAULT_WORKFLOW_PATH;
+    const workflowPath = options.workflow ?? defaultPath;
     const badgePath = options.badgeFile ?? DEFAULT_BADGE_PATH;
     const targetConfigPath = optionPath(options.targetConfig, DEFAULT_TARGET_CONFIG_PATH);
     const prBodyPath = optionPath(options.prBody, DEFAULT_PR_BODY_PATH);
     const issueBodyPath = optionPath(options.issueBody, DEFAULT_ISSUE_BODY_PATH);
     const scoreBadgePath = optionPath(options.scoreBadge, DEFAULT_SCORE_BADGE_PATH);
+    const ciLabel = providerLabel(detectedProvider);
     const workflow = await readOptional(workflowPath);
     const checks = [];
     if (workflow === undefined) {
         checks.push({
             id: "workflow",
-            label: "GitHub Action",
+            label: ciLabel,
             status: "fail",
             message: `${workflowPath} is missing.`,
             fix: setupCommand(options),
@@ -278,7 +421,7 @@ export async function doctorSetupCi(options = {}) {
     else {
         checks.push({
             id: "workflow",
-            label: "GitHub Action",
+            label: ciLabel,
             status: "pass",
             message: `${workflowPath} exists.`,
         });
@@ -356,7 +499,9 @@ export async function initCi(options) {
     if (options.target && shouldWrite(options.targetConfig, options.all)) {
         throw new Error("Use either --target or --target-config, not both.");
     }
-    const workflowPath = options.workflow ?? DEFAULT_WORKFLOW_PATH;
+    const detectedProvider = options.ciProvider ?? detectCiProvider() ?? "github-actions";
+    const defaultPath = CI_FILE_PATHS[detectedProvider] ?? DEFAULT_WORKFLOW_PATH;
+    const workflowPath = options.workflow ?? defaultPath;
     const badgePath = options.badgeFile ?? DEFAULT_BADGE_PATH;
     const workflowStatus = await writeFileOnce(workflowPath, workflowYaml(options), options.force === true);
     const result = {
@@ -410,7 +555,8 @@ function addInitCiOptions(command) {
         .option("--doctor", "Inspect the current repository's MCP Observatory CI adoption state.", false)
         .option("--fix", "With --doctor, repair the adoption kit with deep, security, SARIF, and weekly scheduled checks.", false)
         .option("--from-last-run", "Generate the adoption kit from the latest successful local run artifact.", false)
-        .option("--campaign <slug>", "Attach a safe campaign/source slug to telemetry for attribution.");
+        .option("--campaign <slug>", "Attach a safe campaign/source slug to telemetry for attribution.")
+        .option("--identify <email>", "Opt-in: share your email to help us understand who uses Observatory. Never shared, never spammed.");
 }
 function initCiAction(commandName) {
     return async (options) => {
@@ -427,7 +573,8 @@ function initCiAction(commandName) {
             }
             process.stdout.write(`\nNext best action:\n  ${result.nextCommand}\n`);
             if (options.fix) {
-                const workflow = await readOptional(options.workflow ?? DEFAULT_WORKFLOW_PATH);
+                const defaultPath = CI_FILE_PATHS[options.ciProvider ?? detectCiProvider() ?? "github-actions"] ?? DEFAULT_WORKFLOW_PATH;
+                const workflow = await readOptional(options.workflow ?? defaultPath);
                 const fixed = await initCi(doctorFixOptions(options, workflow));
                 process.stdout.write("\nApplied repair:\n");
                 process.stdout.write(`${fixed.workflowStatus}: ${fixed.workflowPath}\n`);
@@ -447,7 +594,7 @@ function initCiAction(commandName) {
                 process.exitCode = 1;
             }
             recordEvent(buildEvent("command_complete", commandName, "cli", {
-                ciProvider: "github-actions",
+                ciProvider: options.ciProvider ?? detectCiProvider() ?? "github-actions",
                 setupCiDoctor: true,
                 setupCiReady: result.ready,
                 setupCiFailCount: result.checks.filter((check) => check.status === "fail").length,
@@ -503,7 +650,7 @@ function initCiAction(commandName) {
         }
         process.stdout.write("Next: commit the workflow, open a PR, and paste the generated PR body if present.\n");
         recordEvent(buildEvent("command_complete", commandName, "cli", {
-            ciProvider: "github-actions",
+            ciProvider: options.ciProvider ?? detectCiProvider() ?? "github-actions",
             commitStatusSet: !skipped,
             campaign: options.campaign,
         }));