ios-agent-mcp 2.0.1 → 2.2.0

package/dist/result.d.ts

@@ -0,0 +1,203 @@
+import { z } from "zod";
+import { Finding } from "./analyzers/types.js";
+/**
+ * A 0–100 defect-density score.
+ *
+ *   penalty  = 10·blockers + 3·serious + 1·minor
+ *   capacity = filesChecked × 10
+ *   score    = clamp(0, 100, round(100 × (1 − penalty / capacity)))
+ *
+ * 100 means no findings. The denominator is file count, so the score is a
+ * *density*: adding clean files raises it, which is the intended behaviour for
+ * tracking one project over time.
+ *
+ * It is deliberately NOT comparable between projects — a UI-heavy target and a
+ * networking library have different rule surfaces. Use it as a direction of
+ * travel, and use the counts for anything that matters.
+ */
+export declare function scoreFor(findings: Finding[], filesChecked: number): number;
+export declare const issueSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    severity: z.ZodEnum<["blocker", "serious", "minor"]>;
+    rule: z.ZodString;
+    message: z.ZodString;
+    consequence: z.ZodString;
+    fix: z.ZodString;
+    doc: z.ZodString;
+    excerpt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    severity: "blocker" | "serious" | "minor";
+    file: string;
+    line: number;
+    message: string;
+    rule: string;
+    consequence: string;
+    fix: string;
+    doc: string;
+    excerpt: string;
+}, {
+    severity: "blocker" | "serious" | "minor";
+    file: string;
+    line: number;
+    message: string;
+    rule: string;
+    consequence: string;
+    fix: string;
+    doc: string;
+    excerpt: string;
+}>;
+/** The shape every review tool declares as its `outputSchema`. */
+export declare const reviewOutputShape: {
+    summary: z.ZodString;
+    score: z.ZodNumber;
+    counts: z.ZodObject<{
+        blocker: z.ZodNumber;
+        serious: z.ZodNumber;
+        minor: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    }, {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    }>;
+    files_checked: z.ZodNumber;
+    issues: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        severity: z.ZodEnum<["blocker", "serious", "minor"]>;
+        rule: z.ZodString;
+        message: z.ZodString;
+        consequence: z.ZodString;
+        fix: z.ZodString;
+        doc: z.ZodString;
+        excerpt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }, {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }>, "many">;
+    suggestions: z.ZodArray<z.ZodString, "many">;
+};
+export declare const reviewOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    score: z.ZodNumber;
+    counts: z.ZodObject<{
+        blocker: z.ZodNumber;
+        serious: z.ZodNumber;
+        minor: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    }, {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    }>;
+    files_checked: z.ZodNumber;
+    issues: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        severity: z.ZodEnum<["blocker", "serious", "minor"]>;
+        rule: z.ZodString;
+        message: z.ZodString;
+        consequence: z.ZodString;
+        fix: z.ZodString;
+        doc: z.ZodString;
+        excerpt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }, {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }>, "many">;
+    suggestions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    issues: {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }[];
+    summary: string;
+    score: number;
+    counts: {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    };
+    files_checked: number;
+    suggestions: string[];
+}, {
+    issues: {
+        severity: "blocker" | "serious" | "minor";
+        file: string;
+        line: number;
+        message: string;
+        rule: string;
+        consequence: string;
+        fix: string;
+        doc: string;
+        excerpt: string;
+    }[];
+    summary: string;
+    score: number;
+    counts: {
+        blocker: number;
+        serious: number;
+        minor: number;
+        total: number;
+    };
+    files_checked: number;
+    suggestions: string[];
+}>;
+export type ReviewOutput = z.infer<typeof reviewOutputSchema>;
+/** Build the structured half of a tool result. */
+export declare function buildReviewOutput(title: string, findings: Finding[], filesChecked: number): ReviewOutput;

package/dist/result.js

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import { sortFindings } from "./analyzers/types.js";
+/**
+ * Structured tool output.
+ *
+ * Every review tool returns BOTH a markdown `content` block and this object as
+ * `structuredContent`. The markdown is for a human reading the transcript; the
+ * object is for a workflow that needs to branch on the result without parsing
+ * prose. Returning only JSON would make the transcript unreadable; returning
+ * only prose forces every consumer to regex it.
+ *
+ * Field names are snake_case because this is a wire contract, not internal API.
+ */
+/** Weights behind `score`. Stated here because a score nobody can reproduce is a vibe. */
+const SEVERITY_WEIGHT = {
+    blocker: 10,
+    serious: 3,
+    minor: 1,
+};
+/** One blocker per file scanned is the notional floor. */
+const CAPACITY_PER_FILE = 10;
+/**
+ * A 0–100 defect-density score.
+ *
+ *   penalty  = 10·blockers + 3·serious + 1·minor
+ *   capacity = filesChecked × 10
+ *   score    = clamp(0, 100, round(100 × (1 − penalty / capacity)))
+ *
+ * 100 means no findings. The denominator is file count, so the score is a
+ * *density*: adding clean files raises it, which is the intended behaviour for
+ * tracking one project over time.
+ *
+ * It is deliberately NOT comparable between projects — a UI-heavy target and a
+ * networking library have different rule surfaces. Use it as a direction of
+ * travel, and use the counts for anything that matters.
+ */
+export function scoreFor(findings, filesChecked) {
+    if (filesChecked <= 0)
+        return 100;
+    const penalty = findings.reduce((total, finding) => total + SEVERITY_WEIGHT[finding.severity], 0);
+    const capacity = filesChecked * CAPACITY_PER_FILE;
+    const score = Math.round(100 * (1 - penalty / capacity));
+    return Math.max(0, Math.min(100, score));
+}
+export const issueSchema = z.object({
+    file: z.string(),
+    line: z.number().int(),
+    severity: z.enum(["blocker", "serious", "minor"]),
+    rule: z.string(),
+    message: z.string(),
+    consequence: z.string(),
+    fix: z.string(),
+    doc: z.string(),
+    excerpt: z.string(),
+});
+/** The shape every review tool declares as its `outputSchema`. */
+export const reviewOutputShape = {
+    summary: z.string().describe("One-line plain-language result."),
+    score: z
+        .number()
+        .int()
+        .describe("0-100 defect density. 100 = no findings. penalty = 10*blockers + 3*serious + 1*minor; capacity = files*10. Comparable across runs on ONE project, not between projects."),
+    counts: z.object({
+        blocker: z.number().int(),
+        serious: z.number().int(),
+        minor: z.number().int(),
+        total: z.number().int(),
+    }),
+    files_checked: z.number().int().describe("Swift files actually scanned."),
+    issues: z.array(issueSchema).describe("Every finding, most severe first."),
+    suggestions: z
+        .array(z.string())
+        .describe("Prioritized next actions, deduplicated by rule — not a restatement of every issue's fix."),
+};
+export const reviewOutputSchema = z.object(reviewOutputShape);
+/**
+ * Collapse findings into a handful of actions.
+ *
+ * A `suggestions` array that simply repeats every issue's `fix` is noise — the
+ * issues already carry those. This groups by rule so a file with forty
+ * literal-spacing findings produces one instruction, ordered by total weight.
+ */
+function suggestionsFor(findings) {
+    if (findings.length === 0)
+        return [];
+    const byRule = new Map();
+    for (const finding of findings) {
+        const entry = byRule.get(finding.rule) ?? {
+            count: 0,
+            weight: 0,
+            fix: finding.fix,
+        };
+        entry.count += 1;
+        entry.weight += SEVERITY_WEIGHT[finding.severity];
+        byRule.set(finding.rule, entry);
+    }
+    return [...byRule.entries()]
+        .sort((a, b) => b[1].weight - a[1].weight)
+        .slice(0, 5)
+        .map(([rule, entry]) => entry.count === 1
+        ? `${rule}: ${entry.fix}`
+        : `${rule} (${entry.count} occurrences): ${entry.fix}`);
+}
+function summarize(title, counts, files) {
+    if (counts.total === 0) {
+        return `${title}: no findings across ${files} file${files === 1 ? "" : "s"}.`;
+    }
+    const parts = [];
+    if (counts.blocker > 0)
+        parts.push(`${counts.blocker} blocker`);
+    if (counts.serious > 0)
+        parts.push(`${counts.serious} serious`);
+    if (counts.minor > 0)
+        parts.push(`${counts.minor} minor`);
+    return `${title}: ${parts.join(", ")} across ${files} file${files === 1 ? "" : "s"}.`;
+}
+/** Build the structured half of a tool result. */
+export function buildReviewOutput(title, findings, filesChecked) {
+    const sorted = sortFindings(findings);
+    const counts = {
+        blocker: sorted.filter((f) => f.severity === "blocker").length,
+        serious: sorted.filter((f) => f.severity === "serious").length,
+        minor: sorted.filter((f) => f.severity === "minor").length,
+        total: sorted.length,
+    };
+    return {
+        summary: summarize(title, counts, filesChecked),
+        score: scoreFor(sorted, filesChecked),
+        counts,
+        files_checked: filesChecked,
+        issues: sorted,
+        suggestions: suggestionsFor(sorted),
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

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

package/dist/scan.d.ts

@@ -20,6 +20,15 @@ export interface ProjectSummary {
     hasTests: boolean;
     hasPackageSwift: boolean;
     hasXcodeProject: boolean;
+    /** SwiftUI, UIKit, both, or neither — inferred from imports. */
+    uiFramework: "SwiftUI" | "UIKit" | "SwiftUI + UIKit" | "unknown";
+    /** Best-effort architecture read. Evidence is reported alongside it. */
+    architecture: string;
+    architectureEvidence: string[];
+    /** Third-party packages, from Package.swift / Podfile / project.pbxproj. */
+    dependencies: string[];
+    /** True when at least one dependency crosses an injected protocol boundary. */
+    usesDependencyInjection: boolean;
 }
 /** A structural overview of the project, independent of rule violations. */
 export declare function summarizeProject(root: string, files: SourceFile[]): Promise<ProjectSummary>;

package/dist/scan.js

@@ -103,6 +103,97 @@ export async function readProjectContext(root) {
     const isApp = plists.length > 0 || xcodeprojs.length > 0;
     return { infoPlist, hasPrivacyManifest: manifests.length > 0, isApp };
 }
+/**
+ * Infer the architecture from file naming and type shape.
+ *
+ * Deliberately reports EVIDENCE rather than a bare verdict. "MVVM" with nothing
+ * behind it is a guess presented as a fact; "MVVM — 12 *ViewModel/*Model types,
+ * Views/ and ViewModels/ directories" is a claim the reader can check. When the
+ * signals are weak it says so instead of picking the most popular answer.
+ */
+function inferArchitecture(files) {
+    const paths = files.map((f) => f.path);
+    const evidence = [];
+    const count = (test) => paths.filter((p) => test.test(p)).length;
+    const typeCount = (test) => files.filter((f) => test.test(f.content)).length;
+    const viewModels = typeCount(/\b(?:final\s+)?class\s+\w*(?:ViewModel|Model)\b/);
+    const useCases = count(/UseCases?\//i) + typeCount(/protocol\s+\w*UseCase\b/);
+    const repositories = typeCount(/protocol\s+\w*Repository\b/);
+    const coordinators = typeCount(/\bclass\s+\w*Coordinator\b/);
+    const stores = typeCount(/\b(?:struct|enum)\s+\w*(?:Reducer|Feature)\b/) +
+        typeCount(/import\s+ComposableArchitecture/);
+    const hasLayerDirs = count(/(^|\/)(Domain|Data|Presentation)\//i) >= 2;
+    const hasMVVMDirs = count(/(^|\/)ViewModels?\//i) > 0 && count(/(^|\/)Views?\//i) > 0;
+    if (stores > 0) {
+        evidence.push(`${stores} Reducer/Feature type(s) or a ComposableArchitecture import`);
+        return { architecture: "The Composable Architecture", evidence };
+    }
+    if (hasLayerDirs || (useCases > 0 && repositories > 0)) {
+        if (hasLayerDirs)
+            evidence.push("Domain/, Data/, and Presentation/ directories");
+        if (useCases > 0)
+            evidence.push(`${useCases} use-case protocol(s) or a UseCases/ directory`);
+        if (repositories > 0)
+            evidence.push(`${repositories} repository protocol(s)`);
+        return { architecture: "Clean Architecture", evidence };
+    }
+    if (coordinators > 0) {
+        evidence.push(`${coordinators} Coordinator type(s)`);
+        if (viewModels > 0)
+            evidence.push(`${viewModels} view-model type(s)`);
+        return { architecture: "MVVM + Coordinator", evidence };
+    }
+    if (viewModels > 0 || hasMVVMDirs) {
+        if (viewModels > 0)
+            evidence.push(`${viewModels} ViewModel/Model type(s)`);
+        if (hasMVVMDirs)
+            evidence.push("Views/ and ViewModels/ directories");
+        return { architecture: "MVVM", evidence };
+    }
+    return {
+        architecture: "not determined",
+        evidence: ["no view-model, use-case, repository, or coordinator types found"],
+    };
+}
+/** Third-party package names from whichever manifest the project uses. */
+async function readDependencies(root) {
+    const found = new Set();
+    for (const path of await walk(root, (p) => p.endsWith("Package.swift"), 5)) {
+        try {
+            const content = await readFile(path, "utf8");
+            for (const match of content.matchAll(/url:\s*"https?:\/\/[^"]*\/([\w.-]+?)(?:\.git)?"/g)) {
+                found.add(match[1]);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    // SwiftPM through Xcode records resolved packages here.
+    for (const path of await walk(root, (p) => p.endsWith("Package.resolved"), 5)) {
+        try {
+            const content = await readFile(path, "utf8");
+            for (const match of content.matchAll(/"(?:identity|package)"\s*:\s*"([^"]+)"/g)) {
+                found.add(match[1]);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    for (const path of await walk(root, (p) => /(^|\/)Podfile$/.test(p), 3)) {
+        try {
+            const content = await readFile(path, "utf8");
+            for (const match of content.matchAll(/^\s*pod\s+['"]([^'"\/]+)/gm)) {
+                found.add(match[1]);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [...found].sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+}
 /** A structural overview of the project, independent of rule violations. */
 export async function summarizeProject(root, files) {
     const frameworks = new Set();
@@ -139,6 +230,20 @@ export async function summarizeProject(root, files) {
         }
     }
     const xcodeprojs = await walk(root, (p) => p.endsWith(".pbxproj"), 3);
+    const { architecture, evidence } = inferArchitecture(files);
+    const dependencies = await readDependencies(root);
+    const usesSwiftUI = frameworks.has("SwiftUI");
+    const usesUIKit = frameworks.has("UIKit");
+    const uiFramework = usesSwiftUI && usesUIKit
+        ? "SwiftUI + UIKit"
+        : usesSwiftUI
+            ? "SwiftUI"
+            : usesUIKit
+                ? "UIKit"
+                : "unknown";
+    // An injected protocol existential in an initializer is the signal. A project
+    // that only ever constructs concrete types has no seam, whatever it is called.
+    const usesDependencyInjection = files.some((file) => /init\s*\([^)]*:\s*any\s+\w+/.test(file.content));
     return {
         swiftFileCount: files.length,
         lineCount,
@@ -148,6 +253,11 @@ export async function summarizeProject(root, files) {
         hasTests: files.some((f) => /Tests?\.swift$/.test(f.path)),
         hasPackageSwift: packages.length > 0,
         hasXcodeProject: xcodeprojs.length > 0,
+        uiFramework,
+        architecture,
+        architectureEvidence: evidence,
+        dependencies,
+        usesDependencyInjection,
     };
 }
 //# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "2.2.0";

package/dist/version.js

@@ -0,0 +1,4 @@
+// GENERATED by scripts/sync-version.mjs — do not edit.
+// The version lives in package.json. Run `npm run sync-version` after changing it.
+export const VERSION = "2.2.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,mFAAmF;AACnF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/mcp.json

@@ -1,8 +1,8 @@
 {
   "name": "ios-agent-mcp",
   "displayName": "iOS Agent",
-  "version": "1.0.0",
-  "description": "Static analysis for modern iOS/Swift projects — Swift 6 actor isolation, architecture boundaries, SwiftUI, availability guards, and App Store readiness.",
+  "version": "2.2.0",
+  "description": "Static analysis for modern iOS/Swift projects — Swift 6 actor isolation, architecture boundaries, SwiftUI, availability guards, and App Store readiness — plus a linter for Agent Skill repositories.",
   "author": "Nagarjuna Reddy",
   "license": "MIT",
   "homepage": "https://github.com/Nagarjuna2997/ios-agent-skill",
@@ -11,13 +11,25 @@
     "url": "https://github.com/Nagarjuna2997/ios-agent-skill.git",
     "directory": "mcp-server"
   },
-  "keywords": ["ios", "swift", "swiftui", "xcode", "apple", "static-analysis", "code-review"],
+  "keywords": [
+    "ios",
+    "swift",
+    "swiftui",
+    "xcode",
+    "apple",
+    "static-analysis",
+    "code-review",
+    "agent-skills"
+  ],
   "runtime": {
     "type": "node",
     "minimumVersion": "18",
     "transport": "stdio",
     "command": "npx",
-    "args": ["-y", "ios-agent-mcp"]
+    "args": [
+      "-y",
+      "ios-agent-mcp"
+    ]
   },
   "permissions": {
     "filesystem": "read",
@@ -25,11 +37,64 @@
     "notes": "Reads .swift, Info.plist, Package.swift, and project.pbxproj files under the path you pass to a tool. Makes no network requests and writes nothing."
   },
   "tools": [
-    { "name": "analyze_swift_project", "summary": "Project overview plus a finding count for every rule category." },
-    { "name": "review_swift_concurrency", "summary": "Swift 6 actor isolation and concurrency defects." },
-    { "name": "review_swift_architecture", "summary": "Architecture boundaries, dependency injection, testability." },
-    { "name": "review_swiftui", "summary": "SwiftUI view and state defects, Dynamic Type, design tokens." },
-    { "name": "check_availability_guards", "summary": "Missing and over-restrictive @available guards." },
-    { "name": "audit_app_store_readiness", "summary": "Purpose strings, privacy manifest, accessibility, localization." }
-  ]
+    {
+      "name": "analyze_swift_project",
+      "summary": "Project overview plus a finding count for every rule category."
+    },
+    {
+      "name": "review_swift_concurrency",
+      "summary": "Swift 6 actor isolation and concurrency defects."
+    },
+    {
+      "name": "review_swift_architecture",
+      "summary": "Architecture boundaries, dependency injection, testability."
+    },
+    {
+      "name": "review_swiftui",
+      "summary": "SwiftUI view and state defects, Dynamic Type, design tokens."
+    },
+    {
+      "name": "check_availability_guards",
+      "summary": "Missing and over-restrictive @available guards."
+    },
+    {
+      "name": "audit_app_store_readiness",
+      "summary": "Purpose strings, privacy manifest, accessibility, localization."
+    },
+    {
+      "name": "review_swift_memory",
+      "summary": "Retain cycles, weak/unowned usage, closure and Task lifetime."
+    },
+    {
+      "name": "review_swift_security",
+      "summary": "Hardcoded secrets, insecure storage, ATS, TLS, weak crypto, Keychain accessibility."
+    },
+    {
+      "name": "review_swift_testing",
+      "summary": "Flaky patterns, vacuous tests, live network in tests, missing coverage."
+    },
+    {
+      "name": "review_swift_performance",
+      "summary": "Work inside body, eager stacks, unstable ForEach identity, blocking I/O."
+    },
+    {
+      "name": "lint_skill",
+      "summary": "Agent Skill metadata: frontmatter, subagent tool grants, mirror sync, doc references."
+    }
+  ],
+  "resources": [
+    {
+      "uri": "ios://project/info",
+      "summary": "Structure, architecture with evidence, DI, frameworks."
+    },
+    {
+      "uri": "ios://project/dependencies",
+      "summary": "Third-party packages and Apple frameworks."
+    },
+    {
+      "uri": "ios://project/issues",
+      "summary": "Every finding across all nine categories."
+    }
+  ],
+  "notes": "Resources require a project root: pass --project PATH or set IOS_AGENT_PROJECT. Tools take an explicit path argument and need no configuration."
 }