ios-agent-mcp 2.0.1 → 2.2.0

package/dist/analyzers/skill.js

@@ -0,0 +1,483 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { basename, join } from "node:path";
+/**
+ * Tools an agent definition may name.
+ *
+ * A typo here is invisible at runtime — an unknown tool name is not granted and
+ * not reported, so the agent silently lacks a capability its prompt assumes.
+ */
+const KNOWN_TOOLS = new Set([
+    "Agent",
+    "Bash",
+    "BashOutput",
+    "Edit",
+    "ExitPlanMode",
+    "Glob",
+    "Grep",
+    "KillShell",
+    "NotebookEdit",
+    "Read",
+    "Task",
+    "TodoWrite",
+    "WebFetch",
+    "WebSearch",
+    "Write",
+]);
+/** Tools that mutate the working tree. The whole point of a read-only agent. */
+const WRITE_TOOLS = new Set(["Edit", "Write", "NotebookEdit"]);
+/**
+ * Mirror targets. Kept in sync with scripts/sync-mirrors.sh.
+ *
+ * These are only compared when the repository demonstrably uses the mirror
+ * pattern — see `lintMirrors`. A project with an unrelated CLAUDE.md must not
+ * be told it has drifted from a SKILL.md it never mirrored.
+ */
+const MIRROR_CANDIDATES = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    "CONVENTIONS.md",
+    "GEMINI.md",
+    "replit.md",
+    ".clinerules",
+    ".continuerules",
+    ".cursorrules",
+    ".kilocoderules",
+    ".roorules",
+    ".rules",
+    ".windsurfrules",
+    ".aiassistant/rules/ios-skill.md",
+    ".amazonq/rules/ios-skill.md",
+    ".augment/rules/ios-skill.md",
+    ".continue/rules/ios-skill.md",
+    ".cursor/rules/ios-skill.md",
+    ".github/copilot-instructions.md",
+    ".junie/guidelines.md",
+    ".kilocode/rules/ios-skill.md",
+    ".roo/rules/ios-skill.md",
+    ".tabnine/guidelines/ios-skill.md",
+    ".trae/rules/ios-skill.md",
+    ".windsurf/rules/ios-skill.md",
+];
+const SEMVER = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+const KEBAB = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Agent Skills caps the trigger description; past this it is silently truncated. */
+const MAX_DESCRIPTION = 1024;
+/**
+ * Parse a leading YAML frontmatter block.
+ *
+ * Deliberately not a YAML parser: it reads top-level `key: value` pairs and
+ * ignores nested structure. That covers every key these checks care about
+ * without taking a dependency, and nested keys are simply not reported on.
+ */
+function parseFrontmatter(text) {
+    const lines = text.split("\n");
+    if (lines[0] !== "---")
+        return null;
+    const end = lines.indexOf("---", 1);
+    if (end === -1)
+        return null;
+    const entries = new Map();
+    for (let index = 1; index < end; index += 1) {
+        const match = /^([A-Za-z][A-Za-z0-9_-]*):[ \t]*(.*)$/.exec(lines[index]);
+        if (match) {
+            entries.set(match[1], { value: match[2].trim(), line: index + 1 });
+        }
+    }
+    return {
+        block: lines.slice(1, end).join("\n"),
+        entries,
+        bodyLine: end + 2,
+    };
+}
+/** Strip a leading frontmatter block and the blank lines after it. */
+function stripFrontmatter(text) {
+    const lines = text.split("\n");
+    if (lines[0] !== "---")
+        return text;
+    const end = lines.indexOf("---", 1);
+    if (end === -1)
+        return text;
+    let start = end + 1;
+    while (start < lines.length && lines[start].trim() === "")
+        start += 1;
+    return lines.slice(start).join("\n");
+}
+async function readIfPresent(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Split a `tools:` value, tolerating both `A, B` and `[A, B]` forms. */
+function parseToolList(value) {
+    return value
+        .replace(/^\[|\]$/g, "")
+        .split(",")
+        .map((entry) => entry.trim().replace(/^["']|["']$/g, ""))
+        .filter((entry) => entry.length > 0);
+}
+/**
+ * Does this description claim the agent cannot write?
+ *
+ * Matched against the description because that is the contract the main agent
+ * reads when it decides to delegate. If the prose promises read-only and the
+ * frontmatter grants Edit, the delegation decision was made on a false premise.
+ */
+function claimsReadOnly(description) {
+    return /read[- ]only|never edits?|does not (?:edit|change|modify)|no write tools/i.test(description);
+}
+function checkSkillFrontmatter(relativePath, text, findings) {
+    const frontmatter = parseFrontmatter(text);
+    if (!frontmatter) {
+        findings.push({
+            file: relativePath,
+            line: 1,
+            severity: "blocker",
+            rule: "skill-missing-frontmatter",
+            message: `${relativePath} has no YAML frontmatter block.`,
+            consequence: "Agent Skills loaders read `name` and `description` from frontmatter to decide when to load the skill. Without it the skill never triggers.",
+            fix: "Add a `---` fenced block at the very top of the file with at least `name`, `description`, `version`, and `license`.",
+            excerpt: text.split("\n")[0] ?? "",
+        });
+        return;
+    }
+    for (const key of ["name", "description", "version", "license"]) {
+        if (!frontmatter.entries.has(key)) {
+            findings.push({
+                file: relativePath,
+                line: 1,
+                severity: "blocker",
+                rule: "skill-frontmatter-missing-key",
+                message: `${relativePath} frontmatter is missing \`${key}\`.`,
+                consequence: key === "description"
+                    ? "The description is the trigger. With none, the skill is never selected for a task."
+                    : `Loaders that require \`${key}\` reject the skill outright.`,
+                fix: `Add \`${key}:\` to the frontmatter block.`,
+                excerpt: "",
+            });
+        }
+    }
+    const name = frontmatter.entries.get("name");
+    if (name && !KEBAB.test(name.value)) {
+        findings.push({
+            file: relativePath,
+            line: name.line,
+            severity: "serious",
+            rule: "skill-name-not-kebab-case",
+            message: `Skill name \`${name.value}\` is not lowercase-kebab-case.`,
+            consequence: "Skill names are used as invocation identifiers. Mixed case or spaces make the skill unaddressable by name.",
+            fix: "Rename to lowercase words separated by hyphens.",
+            excerpt: `name: ${name.value}`,
+        });
+    }
+    const version = frontmatter.entries.get("version");
+    if (version && !SEMVER.test(version.value.replace(/^["']|["']$/g, ""))) {
+        findings.push({
+            file: relativePath,
+            line: version.line,
+            severity: "serious",
+            rule: "skill-version-not-semver",
+            message: `Version \`${version.value}\` is not semantic versioning.`,
+            consequence: "Consumers cannot tell a breaking change from a patch, and release tooling that sorts versions misorders them.",
+            fix: "Use MAJOR.MINOR.PATCH, for example `2.0.0`.",
+            excerpt: `version: ${version.value}`,
+        });
+    }
+    const description = frontmatter.entries.get("description");
+    if (description) {
+        if (description.value.length > MAX_DESCRIPTION) {
+            findings.push({
+                file: relativePath,
+                line: description.line,
+                severity: "serious",
+                rule: "skill-description-too-long",
+                message: `Description is ${description.value.length} characters; the limit is ${MAX_DESCRIPTION}.`,
+                consequence: "Loaders truncate past the limit, so the trailing trigger conditions are silently dropped and the skill stops matching those tasks.",
+                fix: "Trim to the triggering conditions. Move detail into the body, which is not length-limited.",
+                excerpt: `${description.value.slice(0, 80)}…`,
+            });
+        }
+        else if (description.value.length < 40) {
+            findings.push({
+                file: relativePath,
+                line: description.line,
+                severity: "minor",
+                rule: "skill-description-too-short",
+                message: "Description is too short to trigger reliably.",
+                consequence: "The description is matched against the task. A few words give the loader almost nothing to match on, so the skill loads inconsistently.",
+                fix: "State what the skill does and the specific conditions under which it should load.",
+                excerpt: `description: ${description.value}`,
+            });
+        }
+    }
+    const allowed = frontmatter.entries.get("allowed-tools");
+    if (allowed) {
+        for (const tool of parseToolList(allowed.value)) {
+            if (!KNOWN_TOOLS.has(tool)) {
+                findings.push({
+                    file: relativePath,
+                    line: allowed.line,
+                    severity: "serious",
+                    rule: "skill-unknown-tool",
+                    message: `\`allowed-tools\` names an unknown tool \`${tool}\`.`,
+                    consequence: "An unrecognized tool name is not granted and not reported. The skill runs without a capability its instructions assume it has.",
+                    fix: `Correct the spelling, or remove \`${tool}\` if it is not a real tool.`,
+                    excerpt: `allowed-tools: ${allowed.value}`,
+                });
+            }
+        }
+    }
+}
+async function lintAgents(root, findings) {
+    const directory = join(root, ".claude", "agents");
+    let files;
+    try {
+        files = (await readdir(directory)).filter((name) => name.endsWith(".md")).sort();
+    }
+    catch {
+        return 0;
+    }
+    for (const file of files) {
+        const relativePath = join(".claude", "agents", file);
+        const text = await readFile(join(directory, file), "utf8");
+        const frontmatter = parseFrontmatter(text);
+        if (!frontmatter) {
+            findings.push({
+                file: relativePath,
+                line: 1,
+                severity: "blocker",
+                rule: "agent-missing-frontmatter",
+                message: `${file} has no YAML frontmatter.`,
+                consequence: "Without frontmatter the file is not registered as a subagent at all. It looks defined but can never be invoked.",
+                fix: "Add a `---` block with `name`, `description`, and `tools`.",
+                excerpt: text.split("\n")[0] ?? "",
+            });
+            continue;
+        }
+        const stem = basename(file, ".md");
+        const name = frontmatter.entries.get("name");
+        if (!name) {
+            findings.push({
+                file: relativePath,
+                line: 1,
+                severity: "serious",
+                rule: "agent-missing-name",
+                message: `${file} frontmatter has no \`name\`.`,
+                consequence: "The subagent cannot be addressed by name.",
+                fix: `Add \`name: ${stem}\`.`,
+                excerpt: "",
+            });
+        }
+        else {
+            if (!KEBAB.test(name.value)) {
+                findings.push({
+                    file: relativePath,
+                    line: name.line,
+                    severity: "serious",
+                    rule: "agent-name-not-kebab-case",
+                    message: `Agent name \`${name.value}\` is not lowercase-kebab-case.`,
+                    consequence: "Names outside this form are not reliably resolvable at invocation.",
+                    fix: "Rename to lowercase words separated by hyphens.",
+                    excerpt: `name: ${name.value}`,
+                });
+            }
+            if (name.value !== stem) {
+                findings.push({
+                    file: relativePath,
+                    line: name.line,
+                    severity: "serious",
+                    rule: "agent-name-filename-mismatch",
+                    message: `Agent is named \`${name.value}\` but the file is \`${file}\`.`,
+                    consequence: "Documentation and delegation prompts reference one identifier while the loader registers the other, so the delegation silently fails to resolve.",
+                    fix: `Rename the file to \`${name.value}.md\`, or change \`name\` to \`${stem}\`.`,
+                    excerpt: `name: ${name.value}`,
+                });
+            }
+        }
+        const description = frontmatter.entries.get("description");
+        if (!description || description.value === "") {
+            findings.push({
+                file: relativePath,
+                line: 1,
+                severity: "serious",
+                rule: "agent-missing-description",
+                message: `${file} has no \`description\`.`,
+                consequence: "The description is what the main agent reads to decide whether to delegate. With none, the subagent is never chosen.",
+                fix: "Add a description stating when to use this agent, not just what it is.",
+                excerpt: "",
+            });
+        }
+        else if (!/\b(use|when|after|before)\b/i.test(description.value)) {
+            findings.push({
+                file: relativePath,
+                line: description.line,
+                severity: "minor",
+                rule: "agent-description-lacks-trigger",
+                message: `${file} describes what the agent is, but not when to use it.`,
+                consequence: "Delegation is decided by matching the task against this text. A description with no triggering condition rarely matches.",
+                fix: 'Add an explicit trigger — "Use when …", "Use after …".',
+                excerpt: `description: ${description.value.slice(0, 80)}…`,
+            });
+        }
+        const tools = frontmatter.entries.get("tools");
+        if (!tools || tools.value === "") {
+            findings.push({
+                file: relativePath,
+                line: 1,
+                severity: "serious",
+                rule: "agent-missing-tools",
+                message: `${file} does not declare \`tools\`.`,
+                consequence: "An agent with no tool list inherits every tool the main agent has. A reviewer meant to be read-only silently gains Edit and Write.",
+                fix: "Declare the minimum tools this agent needs, for example `tools: Read, Grep, Glob`.",
+                excerpt: "",
+            });
+            continue;
+        }
+        const granted = parseToolList(tools.value);
+        for (const tool of granted) {
+            if (!KNOWN_TOOLS.has(tool)) {
+                findings.push({
+                    file: relativePath,
+                    line: tools.line,
+                    severity: "serious",
+                    rule: "agent-unknown-tool",
+                    message: `${file} grants an unknown tool \`${tool}\`.`,
+                    consequence: "An unrecognized name is not granted and not reported. The agent's prompt assumes a capability it does not have, and fails at the moment it tries to use it.",
+                    fix: `Correct the spelling, or drop \`${tool}\`.`,
+                    excerpt: `tools: ${tools.value}`,
+                });
+            }
+        }
+        if (description && claimsReadOnly(description.value)) {
+            const violations = granted.filter((tool) => WRITE_TOOLS.has(tool));
+            if (violations.length > 0) {
+                findings.push({
+                    file: relativePath,
+                    line: tools.line,
+                    severity: "blocker",
+                    rule: "agent-read-only-holds-write-tool",
+                    message: `${file} is described as read-only but is granted ${violations.join(", ")}.`,
+                    consequence: "The main agent delegates to it believing it cannot change code. A reviewer that can edit will fix what it was supposed to report, which destroys the separation of duties the review depends on.",
+                    fix: `Remove ${violations.join(", ")} from \`tools\`, or stop describing the agent as read-only.`,
+                    excerpt: `tools: ${tools.value}`,
+                });
+            }
+        }
+    }
+    return files.length;
+}
+/**
+ * Compare mirrors against SKILL.md's body.
+ *
+ * Only runs when at least one candidate already matches byte-for-byte. That
+ * proves the repository uses the generated-mirror pattern; without the check, a
+ * project with a hand-written CLAUDE.md would be told all 24 mirrors are stale.
+ */
+async function lintMirrors(root, skillText, findings) {
+    const body = stripFrontmatter(skillText).trimEnd();
+    const present = [];
+    for (const candidate of MIRROR_CANDIDATES) {
+        const text = await readIfPresent(join(root, candidate));
+        if (text === null)
+            continue;
+        present.push({ path: candidate, matches: text.trimEnd() === body });
+    }
+    if (present.length === 0 || !present.some((entry) => entry.matches)) {
+        return { compared: 0, skipped: true };
+    }
+    for (const entry of present) {
+        if (entry.matches)
+            continue;
+        findings.push({
+            file: entry.path,
+            line: 0,
+            severity: "serious",
+            rule: "mirror-out-of-sync",
+            message: `${entry.path} does not match the body of SKILL.md.`,
+            consequence: "Agents reading this file get different rules from agents reading SKILL.md. The divergence is invisible until two agents disagree about the same codebase.",
+            fix: "Regenerate with `./scripts/sync-mirrors.sh`, then commit the result.",
+            excerpt: "",
+        });
+    }
+    return { compared: present.length, skipped: false };
+}
+const REFERENCE = /`((?:docs|patterns|checklists|templates|scripts|samples)\/[^`\s]+)`/g;
+/** Flag backtick-quoted repository paths that do not resolve. */
+async function lintReferences(root, sources, findings) {
+    let count = 0;
+    for (const source of sources) {
+        const text = await readIfPresent(join(root, source));
+        if (text === null)
+            continue;
+        const lines = text.split("\n");
+        for (let index = 0; index < lines.length; index += 1) {
+            for (const match of lines[index].matchAll(REFERENCE)) {
+                const reference = match[1];
+                if (reference.includes("*"))
+                    continue;
+                count += 1;
+                if (!(await exists(join(root, reference.replace(/\/$/, ""))))) {
+                    findings.push({
+                        file: source,
+                        line: index + 1,
+                        severity: "serious",
+                        rule: "broken-doc-reference",
+                        message: `References \`${reference}\`, which does not exist.`,
+                        consequence: "An agent told to consult this path finds nothing and proceeds without the rules it was supposed to apply — silently, because a missing file is not an error it reports.",
+                        fix: `Create ${reference}, or correct the path.`,
+                        excerpt: lines[index].trim(),
+                    });
+                }
+            }
+        }
+    }
+    return count;
+}
+/** Lint a skill repository's metadata: frontmatter, agents, mirrors, references. */
+export async function lintSkill(root) {
+    const findings = [];
+    const skillPath = (await exists(join(root, "SKILL.md"))) ? "SKILL.md" : null;
+    const skillText = skillPath ? await readFile(join(root, skillPath), "utf8") : null;
+    if (skillText === null) {
+        findings.push({
+            file: "SKILL.md",
+            line: 0,
+            severity: "blocker",
+            rule: "skill-file-missing",
+            message: "No SKILL.md at the repository root.",
+            consequence: "SKILL.md is the entry point every Agent Skills loader looks for. Without it there is no skill to load, whatever else the repository contains.",
+            fix: "Create SKILL.md with YAML frontmatter (`name`, `description`, `version`, `license`) and the instruction body beneath it.",
+            excerpt: "",
+        });
+    }
+    else {
+        checkSkillFrontmatter("SKILL.md", skillText, findings);
+    }
+    const agentCount = await lintAgents(root, findings);
+    const mirrors = skillText
+        ? await lintMirrors(root, skillText, findings)
+        : { compared: 0, skipped: true };
+    const referencedPaths = await lintReferences(root, ["SKILL.md", "README.md"], findings);
+    return {
+        findings,
+        checked: {
+            skillFile: skillPath,
+            agentCount,
+            mirrorsCompared: mirrors.compared,
+            mirrorCheckSkipped: mirrors.skipped,
+            referencedPaths,
+        },
+    };
+}
+//# sourceMappingURL=skill.js.map

package/dist/analyzers/skill.js.map

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

package/dist/analyzers/testing.d.ts

@@ -0,0 +1,16 @@
+import { Finding, SourceFile } from "./types.js";
+/**
+ * Test-suite quality.
+ *
+ * This is the one analyzer that runs ONLY on test files — the inverse of every
+ * other rule here, which skips them. A flaky or vacuous test is worse than a
+ * missing one: it costs the same to run, and it reports success either way.
+ */
+export declare function analyzeTesting(file: SourceFile): Finding[];
+/**
+ * Project-level: is anything tested at all?
+ *
+ * Reported once per scan rather than per file, because "no tests" is a property
+ * of the project and repeating it would drown the file-level findings.
+ */
+export declare function analyzeTestCoverage(files: SourceFile[]): Finding[];

package/dist/analyzers/testing.js

@@ -0,0 +1,135 @@
+import { eachLine, withoutStringLiterals } from "./types.js";
+const TESTING_DOC = "checklists/testing.md";
+const MOCKING_DOC = "docs/testing/mocking-strategy.md";
+const TEST_FILE = /Tests?\.swift$|Tests?\/|Spec\.swift$/i;
+/**
+ * Test-suite quality.
+ *
+ * This is the one analyzer that runs ONLY on test files — the inverse of every
+ * other rule here, which skips them. A flaky or vacuous test is worse than a
+ * missing one: it costs the same to run, and it reports success either way.
+ */
+export function analyzeTesting(file) {
+    const findings = [];
+    if (!TEST_FILE.test(file.path))
+        return findings;
+    const push = (line, excerpt, rule, severity, message, consequence, fix, doc = TESTING_DOC) => findings.push({
+        file: file.path,
+        line,
+        severity,
+        rule,
+        message,
+        consequence,
+        fix,
+        doc,
+        excerpt: excerpt.trim(),
+    });
+    const lines = file.content.split("\n");
+    eachLine(file, (line, number) => {
+        const index = number - 1;
+        // Sleeping to wait for async work.
+        if (/Thread\.sleep|usleep\s*\(|sleep\s*\(\s*\d/.test(line) ||
+            /Task\.sleep\s*\(/.test(line)) {
+            push(number, line, "test-sleeps", "serious", "Test waits by sleeping.", "The duration is guesswork. It passes on a fast machine, fails under CI load, and the fix people reach for is a longer sleep — so the suite gets slower and stays flaky. A flaky test teaches the team to re-run until green, which is worse than no test.", "Await the work directly, or gate it: an actor with a continuation, `XCTestExpectation` with `await fulfillment(of:)`, or a controllable clock.");
+        }
+        // waitForExpectations with a long timeout is the same problem.
+        if (/waitForExpectations\s*\(\s*timeout:\s*(\d+)/.test(line)) {
+            const timeout = Number(/timeout:\s*(\d+)/.exec(line)?.[1] ?? 0);
+            if (timeout >= 5) {
+                push(number, line, "long-test-timeout", "minor", `Expectation timeout of ${timeout}s.`, "A timeout this long is usually covering for a race rather than a slow operation. It turns a deterministic failure into a slow, intermittent one.", "Reduce it and make the wait deterministic. If the work genuinely takes seconds, it belongs behind a protocol seam with a fake.");
+            }
+        }
+        // A test with no assertion cannot fail for the reason it claims.
+        if (/^\s*func\s+test\w*\s*\(/.test(line)) {
+            let depth = 0;
+            let started = false;
+            let body = "";
+            for (let cursor = index; cursor < Math.min(index + 60, lines.length); cursor += 1) {
+                const current = lines[cursor];
+                depth += (current.match(/\{/g) ?? []).length;
+                depth -= (current.match(/\}/g) ?? []).length;
+                if (!started && depth > 0)
+                    started = true;
+                body += `${current}\n`;
+                if (started && depth <= 0)
+                    break;
+            }
+            if (!/XCTAssert|XCTFail|XCTUnwrap|#expect|#require|\.expect\(/.test(body) &&
+                !/throws/.test(line)) {
+                push(number, line, "test-without-assertion", "serious", "Test contains no assertion.", "It passes as long as nothing throws, so it reports success whether the behaviour is right or wrong. It costs CI time and buys a false sense of coverage.", "Assert the outcome, or delete the test. A test that cannot fail is not a test.");
+            }
+        }
+        // XCTAssert with an await inside — does not compile, but people write it.
+        //
+        // String literals are blanked first: the assertion MESSAGE regularly
+        // contains the word "await" ("set before the await, not after it"), and
+        // matching that reports a defect in correct code.
+        if (/XCTAssert\w*\s*\([^)]*\bawait\b/.test(withoutStringLiterals(line))) {
+            push(number, line, "await-inside-xctassert", "blocker", "`await` inside an XCTAssert autoclosure.", "XCTAssert takes an autoclosure, which cannot contain an await — this does not compile.", "Hoist it: `let value = try await subject.run()` then assert on `value`.");
+        }
+        // Real network in a test.
+        if (/URLSession\.shared|URLSession\(configuration:\s*\.default\)/.test(line) &&
+            !/mock|stub|fake/i.test(file.path)) {
+            push(number, line, "network-in-test", "serious", "Test uses a live URLSession.", "The suite now depends on the network, a server, and its data. It fails offline, fails in CI sandboxes, and fails when someone else changes a fixture — none of which are bugs in the code under test.", "Inject the dependency behind a protocol and pass a fake. If a screen cannot be tested without the network, the seam is missing.", MOCKING_DOC);
+        }
+        // Force-unwrap in a test turns a failed assertion into a crashed run.
+        if (/\btry!\s/.test(line)) {
+            push(number, line, "force-try-in-test", "minor", "`try!` in a test.", "A throw crashes the whole test run instead of failing one test, so you lose every other result in the suite and the report says nothing about which case broke.", "Mark the test `throws` and use `try`, or `XCTUnwrap`.");
+        }
+        // Order-dependent state.
+        if (/^\s*(static\s+var|static\s+let)\s+\w+/.test(line) && !/\blet\b.*=\s*"/.test(line)) {
+            push(number, line, "shared-mutable-test-state", "minor", "Static mutable state in a test case.", "XCTest does not guarantee test order and may run classes in parallel. State that survives between tests makes results depend on execution order, which is the hardest kind of flake to reproduce.", "Move it into `setUp()` as instance state, so each test gets a fresh value.");
+        }
+        // Asserting on a bare Bool loses the values on failure.
+        if (/XCTAssertTrue\s*\(\s*\w+\s*==\s*/.test(line)) {
+            push(number, line, "assert-true-on-equality", "minor", "`XCTAssertTrue(a == b)` hides the values.", "On failure the report says only 'expected true'. `XCTAssertEqual` prints both sides, which is usually the whole diagnosis.", "Use `XCTAssertEqual(a, b)`.");
+        }
+    });
+    return findings;
+}
+/**
+ * Project-level: is anything tested at all?
+ *
+ * Reported once per scan rather than per file, because "no tests" is a property
+ * of the project and repeating it would drown the file-level findings.
+ */
+export function analyzeTestCoverage(files) {
+    const testFiles = files.filter((file) => TEST_FILE.test(file.path));
+    const sourceFiles = files.filter((file) => !TEST_FILE.test(file.path));
+    if (sourceFiles.length === 0)
+        return [];
+    if (testFiles.length === 0) {
+        return [
+            {
+                file: "(project)",
+                line: 0,
+                severity: "serious",
+                rule: "no-tests",
+                message: `No test files found alongside ${sourceFiles.length} source files.`,
+                consequence: "Every change is verified by hand or not at all, and no refactor can be proven behaviour-preserving.",
+                fix: "Add a test target. Start with the view models — they are pure logic once dependencies cross a protocol boundary.",
+                doc: TESTING_DOC,
+                excerpt: "",
+            },
+        ];
+    }
+    // A ratio, not a coverage percentage — this counts files, not lines.
+    const ratio = testFiles.length / sourceFiles.length;
+    if (ratio < 0.1) {
+        return [
+            {
+                file: "(project)",
+                line: 0,
+                severity: "minor",
+                rule: "sparse-tests",
+                message: `${testFiles.length} test file(s) for ${sourceFiles.length} source files.`,
+                consequence: "Most of the codebase has no automated check, so regressions surface in review or in production rather than in CI.",
+                fix: "Prioritize view models and pure functions — the parts that are cheapest to test and most likely to hold a bug.",
+                doc: TESTING_DOC,
+                excerpt: "",
+            },
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=testing.js.map