@skaleagents/swarm 0.6.9 → 0.6.10

package/dist/iac/parse.d.ts

@@ -1,4 +1,4 @@
-export type IacFormat = "terraform" | "cloudformation" | "kubernetes" | "pulumi" | "compose" | "dockerfile" | "github";
+export type IacFormat = "terraform" | "cloudformation" | "kubernetes" | "pulumi" | "compose" | "dockerfile" | "github" | "helm" | "ansible";
 export type Path = (string | number)[];
 export type Location = {
     line: number;
@@ -25,6 +25,8 @@ export declare function looksLikeIac(content: string): boolean;
 export declare function looksLikePulumiProgram(content: string): boolean;
 export declare function looksLikeCompose(content: string): boolean;
 export declare function looksLikeDockerfile(content: string): boolean;
+export declare function looksLikeAnsible(content: string): boolean;
+export declare function looksLikeHelm(content: string): boolean;
 export declare function looksLikeGithubWorkflow(content: string): boolean;
 export declare function looksLikePulumiYaml(content: string): boolean;
 export declare function parseIac(content: string, requested?: IacFormat | "auto"): ParsedIac;

package/dist/iac/parse.js

@@ -42,7 +42,9 @@ export function looksLikeIac(content) {
         looksLikePulumiProgram(content) ||
         looksLikeCompose(content) ||
         looksLikeDockerfile(content) ||
-        looksLikeGithubWorkflow(content));
+        looksLikeGithubWorkflow(content) ||
+        looksLikeHelm(content) ||
+        looksLikeAnsible(content));
 }
 export function looksLikePulumiProgram(content) {
     return /(?:^|\n)\s*(?:import\s+\*\s+as\s+pulumi\b|import\s+pulumi\b|from\s+["']@pulumi\/)/.test(content);
@@ -56,6 +58,26 @@ export function looksLikeDockerfile(content) {
 function topLevelKey(content, name) {
     return new RegExp(`^(?:"${name}"|'${name}'|${name})\\s*:`, "m").test(content);
 }
+function playbookShape(content) {
+    if (topLevelKey(content, "hosts") && topLevelKey(content, "tasks"))
+        return true;
+    return /^\s*-\s+hosts\s*:/m.test(content) && /^\s*tasks\s*:/m.test(content);
+}
+export function looksLikeAnsible(content) {
+    if (looksLikeGithubWorkflow(content))
+        return false;
+    if (topLevelKey(content, "apiVersion") && topLevelKey(content, "kind"))
+        return false;
+    return playbookShape(content);
+}
+export function looksLikeHelm(content) {
+    if (looksLikeGithubWorkflow(content) || looksLikeAnsible(content))
+        return false;
+    const visible = maskNonCode(content);
+    if (!visible.includes("{{"))
+        return false;
+    return /^\s*(?:apiVersion|kind)\s*:/m.test(visible);
+}
 export function looksLikeGithubWorkflow(content) {
     if (topLevelKey(content, "apiVersion") || topLevelKey(content, "kind"))
         return false;
@@ -84,6 +106,14 @@ export function parseIac(content, requested = "auto") {
         (requested === "auto" && looksLikeGithubWorkflow(content))) {
         return parseGithubWorkflow(content);
     }
+    if (requested === "ansible" ||
+        (requested === "auto" && looksLikeAnsible(content))) {
+        return parseAnsible(content);
+    }
+    if (requested === "helm" ||
+        (requested === "auto" && looksLikeHelm(content))) {
+        return parseHelm(content);
+    }
     if (requested !== "terraform" &&
         requested !== "compose" &&
         looksLikePulumiProgram(content) &&
@@ -300,7 +330,7 @@ export function parseIac(content, requested = "auto") {
         }
     }
     if (!format)
-        throw new ScanInputError("No IaC document found. Choose Terraform, CloudFormation, Kubernetes, Pulumi, Docker Compose, a Dockerfile, or a GitHub Actions workflow.");
+        throw new ScanInputError("No IaC document found. Choose Terraform, CloudFormation, Kubernetes, Pulumi, Docker Compose, a Dockerfile, a GitHub Actions workflow, a Helm template, or an Ansible playbook.");
     if (!resources.length)
         warnings.push("No resources found in the submitted document.");
     if (/(?:!(?:Ref|Sub|GetAtt|If)\b|"(?:Ref|Fn::\w+)"\s*:|\$\{)/.test(content))
@@ -452,6 +482,41 @@ function runPipesToShell(text) {
         /\b(?:curl|wget)\b/i.test(text) &&
         /\|\s*(?:sudo\s+)?(?:\S*\/)?(?:ba)?sh\b/i.test(text));
 }
+function copySources(text) {
+    if (!/^(?:COPY|ADD)\b/i.test(text))
+        return undefined;
+    const rest = text.replace(/^(?:COPY|ADD)\b/i, "").trim();
+    if (rest.startsWith("[")) {
+        try {
+            const parsed = JSON.parse(rest);
+            if (!Array.isArray(parsed) || parsed.length < 2)
+                return [];
+            return parsed.slice(0, -1).map((item) => String(item));
+        }
+        catch {
+            return [];
+        }
+    }
+    const tokens = [];
+    for (const match of rest.matchAll(/"([^"]*)"|'([^']*)'|(\S+)/g)) {
+        const token = match[1] ?? match[2] ?? match[3];
+        if (token.startsWith("--"))
+            continue;
+        tokens.push(token);
+    }
+    if (tokens.length < 2)
+        return [];
+    return tokens.slice(0, -1);
+}
+function sourceIsSecret(source) {
+    const path = source.replace(/\\/g, "/").replace(/\/+$/, "");
+    const base = path.split("/").filter(Boolean).at(-1) ?? path;
+    if (base === ".env" || base === "id_rsa" || base === "id_ed25519")
+        return true;
+    if (base.endsWith(".pem"))
+        return true;
+    return base === "credentials";
+}
 function lineLocation(line, path) {
     return { line, column: 1, path };
 }
@@ -500,6 +565,17 @@ function parseDockerfile(content) {
             locate: () => lineLocation(instruction.line, "run"),
         });
     });
+    instructions.forEach((instruction, index) => {
+        const sources = copySources(instruction.text);
+        if (!sources)
+            return;
+        resources.push({
+            id: `dockerfile.copy.${index + 1}`,
+            type: "dockerfile:copy",
+            value: { secret: sources.some(sourceIsSecret) },
+            locate: () => lineLocation(instruction.line, "copy"),
+        });
+    });
     return {
         format: "dockerfile",
         resources,
@@ -526,6 +602,14 @@ function workflowChecksOutHead(jobs) {
     }
     return false;
 }
+function runPrintsSecret(script) {
+    const logical = script.replace(/\\\r?\n\s*/g, " ");
+    return logical.split(/\n/).some((line) => {
+        const code = line.replace(/(^|\s)#[^\n]*$/, "");
+        return (/\b(?:echo|printf|print)\b/i.test(code) &&
+            /\$\{\{\s*secrets\./.test(code));
+    });
+}
 function permissionsAreBroad(top, jobs, pullRequestTarget) {
     const values = [
         top,
@@ -609,6 +693,17 @@ function parseGithubWorkflow(content) {
                     locate: () => position(["jobs", jobName, "steps", index, "uses"]),
                 });
             });
+            array(object(job).steps).forEach((step, index) => {
+                const run = object(step).run;
+                if (typeof run !== "string")
+                    return;
+                resources.push({
+                    id: `jobs.${jobName}.steps.${index}.run`,
+                    type: "github:run",
+                    value: { printsSecret: runPrintsSecret(run) },
+                    locate: () => position(["jobs", jobName, "steps", index, "run"]),
+                });
+            });
         }
     }
     if (!found)
@@ -649,3 +744,95 @@ function pulumiResourceMap(root) {
 function escapeRegex(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function maskNonCode(content) {
+    const withoutBlockComments = content
+        .replace(/\{\{-?\s*\/\*[\s\S]*?\*\/\s*-?\}\}/g, (match) => match.replace(/[^\n]/g, " "))
+        .replace(/\{#[\s\S]*?#\}/g, (match) => match.replace(/[^\n]/g, " "));
+    return withoutBlockComments
+        .split("\n")
+        .map((line) => {
+        let out = "";
+        let templates = 0;
+        let quote;
+        for (let index = 0; index < line.length; index++) {
+            const char = line[index];
+            const next = line[index + 1];
+            if (quote) {
+                out += char;
+                if (char === quote && line[index - 1] !== "\\")
+                    quote = undefined;
+                continue;
+            }
+            if (templates === 0 && (char === '"' || char === "'")) {
+                quote = char;
+                out += char;
+                continue;
+            }
+            if (char === "{" && next === "{") {
+                templates += 1;
+                out += char;
+                continue;
+            }
+            if (char === "}" && next === "}" && templates > 0) {
+                templates -= 1;
+                out += char;
+                continue;
+            }
+            if (templates === 0 && char === "#") {
+                return out + " ".repeat(line.length - out.length);
+            }
+            out += char;
+        }
+        return out;
+    })
+        .join("\n");
+}
+function lineAt(content, index) {
+    return content.slice(0, index).split("\n").length;
+}
+function firstLiteral(content, pattern) {
+    const match = pattern.exec(content);
+    if (!match || match.index === undefined)
+        return { present: false, line: 1 };
+    return { present: true, line: lineAt(content, match.index) };
+}
+function literalResource(id, type, match, path) {
+    return {
+        id,
+        type,
+        value: { present: match.present },
+        locate: () => lineLocation(match.line, path),
+    };
+}
+const helmTemplateWarning = "Helm templates are not executed. Only literal text outside comments is checked.";
+const ansibleFactsWarning = "Ansible facts are not executed. Only literal text outside comments is checked.";
+function parseHelm(content) {
+    const visible = maskNonCode(content);
+    const privileged = firstLiteral(visible, /privileged\s*:\s*["']?true["']?\b/);
+    const hostNetwork = firstLiteral(visible, /hostNetwork\s*:\s*["']?true["']?\b/);
+    const latest = firstLiteral(visible, /:latest\b/);
+    const socket = firstLiteral(visible, /(?:hostPath|volumes?)\b[\s\S]{0,500}docker\.sock|docker\.sock[\s\S]{0,200}\b(?:hostPath|volumes?)\b/);
+    return {
+        format: "helm",
+        resources: [
+            literalResource("helm.privileged", "helm:privileged", privileged, "privileged"),
+            literalResource("helm.hostNetwork", "helm:hostNetwork", hostNetwork, "hostNetwork"),
+            literalResource("helm.image", "helm:image", latest, "image"),
+            literalResource("helm.socket", "helm:socket", socket, "volume"),
+        ],
+        warnings: [helmTemplateWarning],
+    };
+}
+function parseAnsible(content) {
+    const visible = maskNonCode(content);
+    const become = firstLiteral(visible, /(?:^|\n)\s*(?:-\s+)?become\s*:\s*["']?(?:true|yes)["']?(?=\s|$)/);
+    const cidr = firstLiteral(visible, /(?:cidr|source)\s*:\s*(?:\|\s*)?(?:\n\s*-\s*)?["']?0\.0\.0\.0\/0\b/);
+    return {
+        format: "ansible",
+        resources: [
+            literalResource("ansible.become", "ansible:become", become, "become"),
+            literalResource("ansible.cidr", "ansible:cidr", cidr, "cidr"),
+        ],
+        warnings: [ansibleFactsWarning],
+    };
+}

package/dist/iac/rules.js

@@ -239,6 +239,62 @@ export const rules = {
         detail: "A uses value is pinned to @main or @master.",
         remediation: "Pin the action to a release tag or a full commit SHA.",
     },
+    DF004: {
+        category: "security",
+        severity: "high",
+        title: "Secret file copied into the image",
+        detail: "A COPY or ADD instruction uses a secret file as a source.",
+        remediation: "Keep secret files out of the image. Mount them at runtime from a secret store.",
+    },
+    GH004: {
+        category: "security",
+        severity: "high",
+        title: "Workflow prints a secret",
+        detail: "A run script echoes or prints a secrets expression.",
+        remediation: "Remove the printed secret from the script. Pass secrets through an environment variable that the step does not print.",
+    },
+    HELM001: {
+        category: "security",
+        severity: "critical",
+        title: "Privileged container in a Helm template",
+        detail: "The template sets privileged to true.",
+        remediation: "Set privileged to false. Isolate workloads that genuinely require elevated privileges.",
+    },
+    HELM002: {
+        category: "security",
+        severity: "high",
+        title: "Host network in a Helm template",
+        detail: "The template sets hostNetwork to true.",
+        remediation: "Disable hostNetwork unless a reviewed node-level component requires it.",
+    },
+    HELM003: {
+        category: "reliability",
+        severity: "medium",
+        title: "Unpinned image in a Helm template",
+        detail: "An image tag uses latest.",
+        remediation: "Pin an immutable digest or a release tag.",
+    },
+    HELM004: {
+        category: "security",
+        severity: "high",
+        title: "Docker socket mounted in a Helm template",
+        detail: "A hostPath or volume contains docker.sock.",
+        remediation: "Remove the Docker socket mount. Use a scoped volume or a reviewed runtime API instead.",
+    },
+    ANS001: {
+        category: "security",
+        severity: "high",
+        title: "Ansible task runs as root",
+        detail: "A play or task sets become to true or yes.",
+        remediation: "Set become to false unless the task has a reviewed need to run as root.",
+    },
+    ANS002: {
+        category: "security",
+        severity: "high",
+        title: "Broad network exposure",
+        detail: "A cidr or source allows 0.0.0.0/0.",
+        remediation: "Restrict the cidr or source to approved addresses.",
+    },
 };
 export function resourceFindings(resources, format) {
     const findings = [];
@@ -262,6 +318,14 @@ export function resourceFindings(resources, format) {
             checkGithub(resource, check);
             continue;
         }
+        if (format === "helm") {
+            checkHelm(resource, check);
+            continue;
+        }
+        if (format === "ansible") {
+            checkAnsible(resource, check);
+            continue;
+        }
         walk(resource.value, (key, value, path, parent) => {
             if (typeof value !== "string")
                 return;
@@ -289,6 +353,8 @@ function checkDockerfile(resource, check) {
         check("DF002", resource.value.unpinned === true, ["image"]);
     else if (resource.type === "dockerfile:run")
         check("DF003", resource.value.piped === true, ["run"]);
+    else if (resource.type === "dockerfile:copy")
+        check("DF004", resource.value.secret === true, ["copy"]);
 }
 function checkGithub(resource, check) {
     if (resource.type === "github:trigger")
@@ -298,6 +364,24 @@ function checkGithub(resource, check) {
         check("GH002", resource.value.broad === true, ["permissions"]);
     else if (resource.type === "github:action")
         check("GH003", resource.value.floating === true, ["uses"]);
+    else if (resource.type === "github:run")
+        check("GH004", resource.value.printsSecret === true, ["run"]);
+}
+function checkHelm(resource, check) {
+    if (resource.type === "helm:privileged")
+        check("HELM001", resource.value.present === true, ["privileged"]);
+    else if (resource.type === "helm:hostNetwork")
+        check("HELM002", resource.value.present === true, ["hostNetwork"]);
+    else if (resource.type === "helm:image")
+        check("HELM003", resource.value.present === true, ["image"]);
+    else if (resource.type === "helm:socket")
+        check("HELM004", resource.value.present === true, ["volume"]);
+}
+function checkAnsible(resource, check) {
+    if (resource.type === "ansible:become")
+        check("ANS001", resource.value.present === true, ["become"]);
+    else if (resource.type === "ansible:cidr")
+        check("ANS002", resource.value.present === true, ["cidr"]);
 }
 function walk(value, visit, path = []) {
     if (Array.isArray(value))

package/dist/server.js

@@ -75,12 +75,14 @@ export function createServer(remote = false) {
                 "compose",
                 "dockerfile",
                 "github",
+                "helm",
+                "ansible",
                 "application",
                 "auto",
             ])
                 .optional()
                 .default("auto")
-                .describe("Content format: terraform, cloudformation, kubernetes, pulumi, compose, application, auto. Includes Dockerfile and GitHub Actions."),
+                .describe("Content format: terraform, cloudformation, kubernetes, pulumi, compose, dockerfile, github, helm, ansible, application, auto."),
         },
     }, async ({ content, focus, format, minSeverity, maxFindings }) => {
         const botHints = fetchPublicBotHints();
@@ -128,7 +130,7 @@ export function createServer(remote = false) {
             description: (name === "scan_iac_stub"
                 ? "Compatibility alias for scan_iac; runs the full scanner. "
                 : "") +
-                "Parse Terraform HCL/JSON, CloudFormation YAML/JSON, Kubernetes manifests, Pulumi YAML, Pulumi programs, or Docker Compose. Includes Dockerfile and GitHub Actions. Check security, reliability and cost rules with resource locations and remediation. Pulumi programs are scanned as text.",
+                "Parse Terraform HCL/JSON, CloudFormation YAML/JSON, Kubernetes manifests, Pulumi YAML, Pulumi programs, or Docker Compose. Includes Dockerfile, GitHub Actions, Helm templates, and Ansible playbooks. Helm templates and Ansible facts are not executed. Check security, reliability and cost rules with resource locations and remediation. Pulumi programs are scanned as text.",
             annotations: {
                 readOnlyHint: true,
                 destructiveHint: false,
@@ -136,7 +138,7 @@ export function createServer(remote = false) {
             },
             _meta: { securitySchemes: [{ type: "oauth2", scopes: ["mcp"] }] },
             inputSchema: {
-                content: contentSchema.describe("Terraform HCL/JSON, CloudFormation YAML/JSON, Kubernetes YAML/JSON, Pulumi YAML or program text, or Docker Compose. Includes Dockerfile and GitHub Actions."),
+                content: contentSchema.describe("Terraform HCL/JSON, CloudFormation YAML/JSON, Kubernetes YAML/JSON, Pulumi YAML or program text, or Docker Compose. Includes Dockerfile, GitHub Actions, Helm templates, and Ansible playbooks."),
                 format: z
                     .enum([
                     "terraform",
@@ -146,6 +148,8 @@ export function createServer(remote = false) {
                     "compose",
                     "dockerfile",
                     "github",
+                    "helm",
+                    "ansible",
                     "auto",
                 ])
                     .default("auto"),

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.6.9";
+export declare const VERSION = "0.6.10";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.6.9";
+export const VERSION = "0.6.10";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skaleagents/swarm",
-  "version": "0.6.9",
+  "version": "0.6.10",
   "private": false,
   "publishConfig": {
     "access": "public"