ios-agent-mcp 2.0.1 → 2.2.0

package/dist/knowledge.js

@@ -0,0 +1,69 @@
+import { readFileSync } from 'node:fs';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { VERSION } from './version.js';
+const bundle = JSON.parse(readFileSync(new URL('../data/knowledge.json', import.meta.url), 'utf8'));
+const hints = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+const result = (value) => ({ content: [{ type: 'text', text: JSON.stringify(value) }] });
+const normalize = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, '');
+export function searchTechnologies(query, limit) {
+    const q = query.toLowerCase();
+    return bundle.catalog.technologies.map(t => ({ t, score: normalize(t.name) === normalize(query) ? 100 :
+            t.name.toLowerCase().includes(q) ? 50 : (t.summary + ' ' + t.categories.join(' ')).toLowerCase().includes(q) ? 10 : 0 }))
+        .filter(r => r.score > 0).sort((a, b) => b.score - a.score || a.t.name.localeCompare(b.t.name))
+        .slice(0, limit).map(({ t }) => ({ name: t.name, id: t.slug, url: t.url, summary: t.summary, categories: t.categories }));
+}
+export function lookupTechnology(id) {
+    const t = bundle.catalog.technologies.find(t => t.slug === id || normalize(t.name) === normalize(id));
+    if (!t)
+        return { error: 'Technology not found. Use search_apple_technologies first.' };
+    return { ...t, checkedAt: bundle.catalog.checkedAt, guideText: bundle.guides[t.guide],
+        evidence: 'Source snapshot and authored/reference guidance; not proof of runtime or compilation.' };
+}
+export function lookupUpdates(query, limit) {
+    const q = query.toLowerCase();
+    return { checkedAt: bundle.updates.checkedAt, results: bundle.updates.entries.filter(r => !q || r.title.toLowerCase().includes(q) || r.topics.some(t => t.title.toLowerCase().includes(q))).slice(0, limit),
+        evidence: 'Dated landing-page topic maps. Open version-specific Apple links for exact changes and current known issues.' };
+}
+export function validAppName(name) {
+    return /^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) && !/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(name);
+}
+export function appPlan(name, brief) {
+    if (!validAppName(name))
+        throw new Error('Use a Swift-safe app name.');
+    return { name, brief, status: 'Implementation brief, not an app already built',
+        scaffold: { executable: 'npx', args: ['-y', '@nagarjuna2002/ios-agent@0.2.0', 'new', name, '--brief', brief, '--xcodegen'] },
+        phases: ['Turn the brief into screens, user flows, data models, and acceptance criteria.',
+            'Use scaffold executable/args as an argument array; never interpolate the brief into a shell command.',
+            'Implement the app with injected services, preview data, persistent state and explicit errors.',
+            'Create separate Icon Composer SVG layers and import them as groups.',
+            'Generate the Xcode project from App/project.yml, then build and test with the installed SDK.',
+            'Inspect simulator screens and accessibility; iterate until the requested flows pass.'],
+        workflow: bundle.appWorkflow };
+}
+export function iconPlan(appName, concept) {
+    return { appName, concept, status: 'Layer specification; import and verify in Icon Composer',
+        background: { kind: 'native fill', note: 'Choose a solid color or gradient in Icon Composer; keep imported backgrounds full-bleed and opaque.' },
+        groups: [{ order: 1, name: '01-base', purpose: 'Large supporting silhouette', file: '01-base.svg' },
+            { order: 2, name: '02-symbol', purpose: 'Recognizable primary app symbol', file: '02-symbol.svg' },
+            { order: 3, name: '03-accent', purpose: 'Small distinguishing detail', file: '03-accent.svg' }],
+        checks: ['Separate editable SVG/PNG layers on a shared canvas', 'Maximum four foreground groups',
+            'No baked-in system highlights, shadows, or icon corner mask', 'Preview Default, Dark, and Mono appearances',
+            'Save and reopen the .icon document in Icon Composer; verify Xcode target assignment'],
+        guidance: bundle.iconGuide };
+}
+export function createKnowledgeServer() {
+    const server = new McpServer({ name: 'ios-agent-knowledge', version: VERSION }, { instructions: 'Look up Apple technologies and updates before implementation. This server reads only bundled public reference data; it cannot access local projects, write files, build, or publish apps. Use a local coding agent and CLI for implementation.' });
+    server.registerTool('search_apple_technologies', { title: 'Search Apple technologies', description: 'Find Apple frameworks, tools, services and legacy technologies in the bundled 405-entry source snapshot.',
+        inputSchema: { query: z.string().min(1).max(200), limit: z.number().int().min(1).max(30).default(10) }, annotations: hints }, async ({ query, limit }) => result({ checkedAt: bundle.catalog.checkedAt, results: searchTechnologies(query, limit) }));
+    server.registerTool('get_apple_technology', { title: 'Read Apple technology guide', description: 'Read a catalog technology, its local engineering guide, availability metadata and API topic links by exact name or returned id.',
+        inputSchema: { id: z.string().min(1).max(200) }, annotations: hints }, async ({ id }) => result(lookupTechnology(id)));
+    server.registerTool('get_apple_updates', { title: 'Find Apple updates and release notes', description: 'Search dated Apple update and release-note landing pages with version-specific source links. Does not claim live results.',
+        inputSchema: { query: z.string().max(200).default(''), limit: z.number().int().min(1).max(30).default(10) }, annotations: hints }, async ({ query, limit }) => result(lookupUpdates(query, limit)));
+    server.registerTool('plan_ios_app', { title: 'Plan an iOS app from a brief', description: 'Return an implementation workflow and safe CLI argument array for a named app. No files are created and no build is claimed.',
+        inputSchema: { name: z.string().max(64).refine(validAppName, 'Use a non-reserved Swift-safe app name'), brief: z.string().min(5).max(8000) }, annotations: hints }, async ({ name, brief }) => result(appPlan(name, brief)));
+    server.registerTool('plan_app_icon', { title: 'Plan layered Icon Composer artwork', description: 'Return a separate-layer icon specification, Apple workflow and appearance checks. Does not fabricate a native .icon document.',
+        inputSchema: { appName: z.string().min(1).max(100), concept: z.string().min(3).max(2000) }, annotations: hints }, async ({ appName, concept }) => result(iconPlan(appName, concept)));
+    return server;
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

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

package/dist/report.d.ts

@@ -1,4 +1,5 @@
 import { Finding } from "./analyzers/types.js";
+import { SkillLintResult } from "./analyzers/skill.js";
 /**
  * Render findings as readable markdown.
  *
@@ -9,3 +10,12 @@ import { Finding } from "./analyzers/types.js";
 export declare function renderFindings(title: string, findings: Finding[], scanned: number, options?: {
     limit?: number;
 }): string;
+/**
+ * Render a skill-repository lint as markdown.
+ *
+ * Separate from `renderFindings` because the locations are markdown and YAML
+ * files — rendering a `tools:` line inside a `swift` fence would be a lie about
+ * what was inspected. The "Checked" section is not decoration: an empty report
+ * with no statement of scope is indistinguishable from a check that never ran.
+ */
+export declare function renderSkillLint(result: SkillLintResult): string;

package/dist/report.js

@@ -38,4 +38,44 @@ export function renderFindings(title, findings, scanned, options = {}) {
         "run `swift build` and `swift test` for that._");
     return lines.join("\n");
 }
+const SEVERITY_RANK = { blocker: 0, serious: 1, minor: 2 };
+/**
+ * Render a skill-repository lint as markdown.
+ *
+ * Separate from `renderFindings` because the locations are markdown and YAML
+ * files — rendering a `tools:` line inside a `swift` fence would be a lie about
+ * what was inspected. The "Checked" section is not decoration: an empty report
+ * with no statement of scope is indistinguishable from a check that never ran.
+ */
+export function renderSkillLint(result) {
+    const { findings, checked } = result;
+    const sorted = [...findings].sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity] ||
+        a.file.localeCompare(b.file) ||
+        a.line - b.line);
+    const lines = ["# Skill Repository Lint", "", "## Checked", ""];
+    lines.push(`- **SKILL.md:** ${checked.skillFile ? "found" : "**not found**"}`, `- **Subagent definitions:** ${checked.agentCount}`, checked.mirrorCheckSkipped
+        ? "- **Mirrors:** skipped — no file matches SKILL.md's body, so this repository does not use the generated-mirror pattern"
+        : `- **Mirrors compared:** ${checked.mirrorsCompared}`, `- **Referenced paths resolved:** ${checked.referencedPaths}`, "");
+    if (sorted.length === 0) {
+        lines.push("**No findings.** Frontmatter, agent tool permissions, mirror sync, and doc references all pass.", "", "_Metadata only. This does not check that the instructions are correct, only that they are well-formed and internally consistent._");
+        return lines.join("\n");
+    }
+    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,
+    };
+    lines.push(`## ${sorted.length} finding${sorted.length === 1 ? "" : "s"}`, "", `🔴 ${counts.blocker} blocker · 🟠 ${counts.serious} serious · 🟡 ${counts.minor} minor`, "");
+    for (const finding of sorted) {
+        const location = finding.line > 0 ? `${finding.file}:${finding.line}` : finding.file;
+        lines.push(`### ${ICON[finding.severity]} ${location} — ${finding.message}`, "");
+        if (finding.excerpt) {
+            lines.push("```", finding.excerpt, "```", "");
+        }
+        lines.push(`**Why it matters:** ${finding.consequence}`, "", `**Fix:** ${finding.fix}`, "", `_Rule \`${finding.rule}\`_`, "");
+    }
+    lines.push("---", "", "_Metadata only. This does not check that the instructions are correct, only " +
+        "that they are well-formed and internally consistent._");
+    return lines.join("\n");
+}
 //# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,IAAI,GAAwC;IAChD,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,QAAmB,EACnB,OAAe,EACf,UAA8B,EAAE;IAEhC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,KAAK,GAAa,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAE3C,KAAK,CAAC,IAAI,CACR,aAAa,OAAO,gBAAgB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAC/D,EAAE,CACH,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,sDAAsD,EACtD,EAAE,EACF,kGAAkG,CACnG,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QAC9D,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;KAC3D,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,KAAK,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO;QAChE,MAAM,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,KAAK,QAAQ,EAC1F,EAAE,CACH,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CACR,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,OAAO,EAAE,EACpF,EAAE,EACF,UAAU,EACV,OAAO,CAAC,OAAO,EACf,KAAK,EACL,EAAE,EACF,uBAAuB,OAAO,CAAC,WAAW,EAAE,EAC5C,EAAE,EACF,YAAY,OAAO,CAAC,GAAG,EAAE,EACzB,EAAE,EACF,WAAW,OAAO,CAAC,IAAI,cAAc,OAAO,CAAC,GAAG,KAAK,EACrD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CACR,UAAU,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,oDAAoD,EAC1F,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,KAAK,EACL,EAAE,EACF,+EAA+E;QAC7E,+CAA+C,CAClD,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Resource-backed project state.
+ *
+ * Tools are verbs the model chooses to call. Resources are nouns a client can
+ * read without being asked — so `ios://project/info` lets a client attach the
+ * project's shape to context up front, instead of the model having to think to
+ * run an analysis first.
+ *
+ * WHY THERE IS A CONFIGURED ROOT
+ *
+ * Resources are addressed by a fixed URI with no arguments, so `ios://project/…`
+ * only means something if the server knows which project it is. MCP clients
+ * already configure servers per project — `.cursor/mcp.json` lives in the
+ * repository, `claude mcp add` is run from it — so a root passed at launch fits
+ * how the server is actually deployed.
+ *
+ * WHY THERE IS NO ios://project/build-status
+ *
+ * It would have to run `xcodebuild`. That needs macOS and Xcode, and it breaks
+ * the `filesystem: read, network: none` contract that lets this package install
+ * anywhere in ~26 KB. Build and simulator state belong in the separate package
+ * that already requires a full toolchain — see ROADMAP.md.
+ */
+/**
+ * The directory `ios-agent` keeps its internal files in.
+ *
+ * Read-only here: this server never creates it. Its presence is used purely as
+ * a project-root marker, the same way git treats `.git` — which is what lets
+ * the CLI and this server agree on a root without either configuring the other.
+ */
+export declare const INTERNAL_DIR = ".ios-agent";
+/**
+ * Walk up from `start` looking for a directory containing `.ios-agent/`.
+ *
+ * Returns `undefined` rather than a fallback, so the caller decides what an
+ * absent marker means. Guessing here is how a server ends up analyzing a user's
+ * home directory because it was launched from the wrong place.
+ */
+export declare function findProjectRootUpwards(start: string): string | undefined;
+export type RootSource = "flag" | "environment" | "marker" | "cwd";
+export interface ResolvedRoot {
+    readonly root: string;
+    readonly source: RootSource;
+}
+/**
+ * Resolve the project root, and say how.
+ *
+ * Order: `--project`, then `IOS_AGENT_PROJECT`, then the nearest ancestor with
+ * a `.ios-agent/` marker, then cwd. The marker step is what makes the server
+ * work when a client spawns it from a nested directory — previously that
+ * silently analyzed whatever subtree it happened to land in.
+ *
+ * The `source` travels with the root because an implicit root is unfalsifiable:
+ * an empty result looks identical whether the project has no Swift or the
+ * server is pointed somewhere else entirely.
+ */
+export declare function resolveRootFrom(argv: string[], env: NodeJS.ProcessEnv): ResolvedRoot;
+/** Resolve the project root from an explicit flag, the environment, a marker, or cwd. */
+export declare function projectRootFrom(argv: string[], env: NodeJS.ProcessEnv): string;
+export interface ResourcePayload {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function projectInfoResource(uri: string, root: string, source?: RootSource): Promise<ResourcePayload>;
+export declare function projectDependenciesResource(uri: string, root: string): Promise<ResourcePayload>;
+export declare function projectIssuesResource(uri: string, root: string): Promise<ResourcePayload>;

package/dist/resources.js

@@ -0,0 +1,222 @@
+import { realpathSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { analyzeConcurrency } from "./analyzers/concurrency.js";
+import { analyzeArchitecture } from "./analyzers/architecture.js";
+import { analyzeSwiftUI } from "./analyzers/swiftui.js";
+import { analyzeAvailability } from "./analyzers/availability.js";
+import { analyzeAppStore, analyzeProjectLevelAppStore } from "./analyzers/appstore.js";
+import { analyzeMemory } from "./analyzers/memory.js";
+import { analyzeSecurity } from "./analyzers/security.js";
+import { analyzeTesting, analyzeTestCoverage } from "./analyzers/testing.js";
+import { analyzePerformance } from "./analyzers/performance.js";
+import { sortFindings } from "./analyzers/types.js";
+import { readProjectContext, readSwiftFiles, resolveProjectRoot, summarizeProject, } from "./scan.js";
+/**
+ * Resource-backed project state.
+ *
+ * Tools are verbs the model chooses to call. Resources are nouns a client can
+ * read without being asked — so `ios://project/info` lets a client attach the
+ * project's shape to context up front, instead of the model having to think to
+ * run an analysis first.
+ *
+ * WHY THERE IS A CONFIGURED ROOT
+ *
+ * Resources are addressed by a fixed URI with no arguments, so `ios://project/…`
+ * only means something if the server knows which project it is. MCP clients
+ * already configure servers per project — `.cursor/mcp.json` lives in the
+ * repository, `claude mcp add` is run from it — so a root passed at launch fits
+ * how the server is actually deployed.
+ *
+ * WHY THERE IS NO ios://project/build-status
+ *
+ * It would have to run `xcodebuild`. That needs macOS and Xcode, and it breaks
+ * the `filesystem: read, network: none` contract that lets this package install
+ * anywhere in ~26 KB. Build and simulator state belong in the separate package
+ * that already requires a full toolchain — see ROADMAP.md.
+ */
+/**
+ * The directory `ios-agent` keeps its internal files in.
+ *
+ * Read-only here: this server never creates it. Its presence is used purely as
+ * a project-root marker, the same way git treats `.git` — which is what lets
+ * the CLI and this server agree on a root without either configuring the other.
+ */
+export const INTERNAL_DIR = ".ios-agent";
+/** How far up the tree to look. Guards against a symlink loop. */
+const MAX_ASCENT = 64;
+/**
+ * Walk up from `start` looking for a directory containing `.ios-agent/`.
+ *
+ * Returns `undefined` rather than a fallback, so the caller decides what an
+ * absent marker means. Guessing here is how a server ends up analyzing a user's
+ * home directory because it was launched from the wrong place.
+ */
+export function findProjectRootUpwards(start) {
+    let current = resolve(start);
+    for (let step = 0; step < MAX_ASCENT; step += 1) {
+        try {
+            if (statSync(join(current, INTERNAL_DIR)).isDirectory())
+                return realpathSync(current);
+        }
+        catch {
+            // Not here; keep walking.
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Resolve the project root, and say how.
+ *
+ * Order: `--project`, then `IOS_AGENT_PROJECT`, then the nearest ancestor with
+ * a `.ios-agent/` marker, then cwd. The marker step is what makes the server
+ * work when a client spawns it from a nested directory — previously that
+ * silently analyzed whatever subtree it happened to land in.
+ *
+ * The `source` travels with the root because an implicit root is unfalsifiable:
+ * an empty result looks identical whether the project has no Swift or the
+ * server is pointed somewhere else entirely.
+ */
+export function resolveRootFrom(argv, env) {
+    const flagIndex = argv.indexOf("--project");
+    if (flagIndex !== -1 && argv[flagIndex + 1]) {
+        return { root: resolve(argv[flagIndex + 1]), source: "flag" };
+    }
+    if (env.IOS_AGENT_PROJECT) {
+        return { root: resolve(env.IOS_AGENT_PROJECT), source: "environment" };
+    }
+    const cwd = resolve(env.PWD ?? process.cwd());
+    const marker = findProjectRootUpwards(cwd);
+    if (marker)
+        return { root: marker, source: "marker" };
+    return { root: cwd, source: "cwd" };
+}
+/** Resolve the project root from an explicit flag, the environment, a marker, or cwd. */
+export function projectRootFrom(argv, env) {
+    return resolveRootFrom(argv, env).root;
+}
+/**
+ * Every resource states the root it used.
+ *
+ * The root is implicit — it comes from a flag, the environment, or the working
+ * directory the client happened to spawn the server in. A reader who cannot see
+ * which of those won has no way to tell an empty project from a wrong path.
+ */
+function payload(uri, body) {
+    return {
+        uri,
+        mimeType: "application/json",
+        text: `${JSON.stringify(body, null, 2)}\n`,
+    };
+}
+function unavailable(uri, root, reason) {
+    return payload(uri, {
+        project_root: root,
+        available: false,
+        reason,
+        fix: "Launch the server with `--project /path/to/project`, set IOS_AGENT_PROJECT, or run it from a directory under one holding a `.ios-agent/` marker. MCP clients usually set this in the per-project config file.",
+    });
+}
+/** Scan once; every resource in a read is served from the same snapshot. */
+async function snapshot(root) {
+    const resolved = await resolveProjectRoot(root);
+    const [files, context] = await Promise.all([
+        readSwiftFiles(resolved),
+        readProjectContext(resolved),
+    ]);
+    return { resolved, files, context };
+}
+export async function projectInfoResource(uri, root, source) {
+    try {
+        const { resolved, files } = await snapshot(root);
+        if (files.length === 0) {
+            return unavailable(uri, resolved, "No Swift files found under this path.");
+        }
+        const summary = await summarizeProject(resolved, files);
+        return payload(uri, {
+            project_root: resolved,
+            resolved_from: source ?? "cwd",
+            available: true,
+            swift_files: summary.swiftFileCount,
+            lines: summary.lineCount,
+            deployment_target: summary.deploymentTarget,
+            swift_tools_version: summary.swiftToolsVersion,
+            ui_framework: summary.uiFramework,
+            architecture: summary.architecture,
+            // The evidence ships with the verdict. "MVVM" alone is a guess presented
+            // as a fact; the reader must be able to check it.
+            architecture_evidence: summary.architectureEvidence,
+            uses_dependency_injection: summary.usesDependencyInjection,
+            has_tests: summary.hasTests,
+            has_package_swift: summary.hasPackageSwift,
+            has_xcode_project: summary.hasXcodeProject,
+            frameworks: summary.frameworks,
+        });
+    }
+    catch (error) {
+        return unavailable(uri, root, error instanceof Error ? error.message : String(error));
+    }
+}
+export async function projectDependenciesResource(uri, root) {
+    try {
+        const { resolved, files } = await snapshot(root);
+        const summary = await summarizeProject(resolved, files);
+        return payload(uri, {
+            project_root: resolved,
+            available: true,
+            third_party: summary.dependencies,
+            // Apple frameworks are not dependencies you manage, but they are the
+            // best available signal for what the app actually does.
+            apple_frameworks: summary.frameworks,
+        });
+    }
+    catch (error) {
+        return unavailable(uri, root, error instanceof Error ? error.message : String(error));
+    }
+}
+export async function projectIssuesResource(uri, root) {
+    try {
+        const { resolved, files, context } = await snapshot(root);
+        if (files.length === 0) {
+            return unavailable(uri, resolved, "No Swift files found under this path.");
+        }
+        const categories = {
+            concurrency: files.flatMap(analyzeConcurrency),
+            architecture: files.flatMap(analyzeArchitecture),
+            swiftui: files.flatMap(analyzeSwiftUI),
+            availability: files.flatMap(analyzeAvailability),
+            memory: files.flatMap(analyzeMemory),
+            security: files.flatMap(analyzeSecurity),
+            performance: files.flatMap(analyzePerformance),
+            testing: [...analyzeTestCoverage(files), ...files.flatMap(analyzeTesting)],
+            app_store: [
+                ...analyzeProjectLevelAppStore(context),
+                ...files.flatMap((file) => analyzeAppStore(file, context)),
+            ],
+        };
+        const all = sortFindings(Object.values(categories).flat());
+        return payload(uri, {
+            project_root: resolved,
+            available: true,
+            files_checked: files.length,
+            counts: {
+                blocker: all.filter((f) => f.severity === "blocker").length,
+                serious: all.filter((f) => f.severity === "serious").length,
+                minor: all.filter((f) => f.severity === "minor").length,
+                total: all.length,
+            },
+            by_category: Object.fromEntries(Object.entries(categories).map(([name, found]) => [name, found.length])),
+            // Capped: a resource is attached to context wholesale, so an unbounded
+            // list would crowd out the conversation it is meant to inform.
+            issues: all.slice(0, 100),
+            truncated: all.length > 100 ? all.length - 100 : 0,
+        });
+    }
+    catch (error) {
+        return unavailable(uri, root, error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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