@rankcli/cli 0.0.31 → 0.0.32

package/README.md

@@ -157,7 +157,11 @@ The gates are opt-in: without them, a completed audit exits `0` however many iss
 
 #### AI analysis (`--ai`)
 
-AI analysis runs on your own provider - nothing goes through RankCLI. With no `--ai-provider`, the first key found wins, in this order (OpenRouter first):
+AI analysis runs on your own provider - nothing goes through RankCLI.
+
+**On a Mac with Apple Intelligence, it's the default.** On macOS 26 or later on Apple silicon with Apple Intelligence turned on, `--ai` uses Apple's on-device model: free, private, no key and no network round trip. The first run builds a small Swift helper with the Xcode command-line tools (a few seconds, cached in `~/Library/Caches/rankcli`). The on-device model has a small context window, so it sees the 25 most severe issues. To use another provider, pass `--ai-provider`, or set it once with `RANKCLI_AI_PROVIDER=openrouter` (any provider id below).
+
+Otherwise, with no `--ai-provider`, the first key found wins, in this order (OpenRouter first):
 
 | Provider | Env var | Base URL | Default model |
 |----------|---------|----------|---------------|

package/dist/index.js

@@ -1453,6 +1453,177 @@ var TOGETHER_DEFAULT = "openai/gpt-oss-120b";
 var FIREWORKS_DEFAULT = "accounts/fireworks/models/gpt-oss-120b";
 var CEREBRAS_DEFAULT = "gpt-oss-120b";
 
+// src/lib/apple-ai.ts
+var import_node_child_process = require("child_process");
+var import_node_crypto2 = require("crypto");
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+
+// src/lib/apple-ai-source.ts
+var APPLE_AI_SWIFT_SOURCE = String.raw`import Foundation
+import FoundationModels
+
+func reply(_ object: [String: Any], code: Int32 = 0) -> Never {
+    let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data("{\"error\":\"could not encode the reply\"}".utf8)
+    FileHandle.standardOutput.write(data)
+    exit(code)
+}
+
+let model = SystemLanguageModel.default
+
+if CommandLine.arguments.contains("--check") {
+    switch model.availability {
+    case .available:
+        reply(["available": true])
+    case .unavailable(let reason):
+        switch reason {
+        case .deviceNotEligible: reply(["available": false, "reason": "deviceNotEligible"])
+        case .appleIntelligenceNotEnabled: reply(["available": false, "reason": "appleIntelligenceNotEnabled"])
+        case .modelNotReady: reply(["available": false, "reason": "modelNotReady"])
+        @unknown default: reply(["available": false, "reason": "unavailable"])
+        }
+    @unknown default:
+        reply(["available": false, "reason": "unavailable"])
+    }
+}
+
+struct Request: Decodable {
+    let system: String?
+    let prompt: String
+    let maxTokens: Int?
+}
+
+let input = FileHandle.standardInput.readDataToEndOfFile()
+guard let request = try? JSONDecoder().decode(Request.self, from: input) else {
+    reply(["error": "expected a JSON request on stdin"], code: 2)
+}
+
+let session: LanguageModelSession
+if let system = request.system {
+    session = LanguageModelSession(instructions: system)
+} else {
+    session = LanguageModelSession()
+}
+
+do {
+    let response = try await session.respond(
+        to: request.prompt,
+        options: GenerationOptions(maximumResponseTokens: request.maxTokens)
+    )
+    reply(["text": response.content])
+} catch let error as LanguageModelSession.GenerationError {
+    switch error {
+    case .exceededContextWindowSize:
+        reply(["error": "the prompt is too long for the on-device model"], code: 1)
+    case .guardrailViolation:
+        reply(["error": "the on-device model's guardrails declined the request"], code: 1)
+    case .assetsUnavailable:
+        reply(["error": "the on-device model isn't downloaded yet"], code: 1)
+    default:
+        reply(["error": String(describing: error)], code: 1)
+    }
+} catch {
+    reply(["error": String(describing: error)], code: 1)
+}
+`;
+
+// src/lib/apple-ai.ts
+function isAppleIntelligenceCapable(platform = process.platform, arch = process.arch, darwinRelease = (0, import_node_os.release)()) {
+  return platform === "darwin" && arch === "arm64" && Number(darwinRelease.split(".")[0]) >= 25;
+}
+var REASONS = {
+  deviceNotEligible: "this Mac doesn't support Apple Intelligence",
+  appleIntelligenceNotEnabled: "Apple Intelligence is turned off (System Settings > Apple Intelligence & Siri)",
+  modelNotReady: "the on-device model is still downloading"
+};
+function run(file, args, opts) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process.spawn)(file, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGKILL");
+    }, opts.timeoutMs);
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.on("data", (d) => stderr += d);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      resolve({ code: null, stdout, stderr: stderr || error.message, timedOut });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve({ code, stdout, stderr, timedOut });
+    });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end(opts.input ?? "");
+  });
+}
+function hasDeveloperTools() {
+  return new Promise((resolve) => (0, import_node_child_process.execFile)("xcode-select", ["-p"], (error) => resolve(!error)));
+}
+var helperPromise = null;
+function ensureHelper(env) {
+  if (env.RANKCLI_APPLE_AI_HELPER) return Promise.resolve({ helper: env.RANKCLI_APPLE_AI_HELPER });
+  helperPromise ??= (async () => {
+    const hash = (0, import_node_crypto2.createHash)("sha256").update(APPLE_AI_SWIFT_SOURCE).digest("hex").slice(0, 12);
+    const dir = (0, import_node_path.join)((0, import_node_os.homedir)(), "Library", "Caches", "rankcli", `apple-ai-${hash}`);
+    const helper = (0, import_node_path.join)(dir, "rankcli-apple-ai");
+    if ((0, import_node_fs.existsSync)(helper)) return { helper };
+    const failed = (0, import_node_path.join)(dir, "build-failed");
+    if ((0, import_node_fs.existsSync)(failed) && Date.now() - (0, import_node_fs.statSync)(failed).mtimeMs < 7 * 24 * 60 * 60 * 1e3) {
+      return { error: (0, import_node_fs.readFileSync)(failed, "utf8") };
+    }
+    if (!await hasDeveloperTools()) {
+      return { error: "using it needs the Xcode command-line tools (xcode-select --install)" };
+    }
+    (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+    const source = (0, import_node_path.join)(dir, "main.swift");
+    (0, import_node_fs.writeFileSync)(source, APPLE_AI_SWIFT_SOURCE);
+    process.stderr.write("Preparing Apple Intelligence for RankCLI (one-time build of a small helper)...\n");
+    const tmp = `${helper}.${process.pid}`;
+    const build = await run("xcrun", ["swiftc", "-O", "-target", "arm64-apple-macos26.0", source, "-o", tmp], { timeoutMs: 18e4 });
+    if (build.code !== 0 || !(0, import_node_fs.existsSync)(tmp)) {
+      const firstError = build.stderr.split("\n").find((line) => /error:/.test(line))?.trim();
+      const error = `the helper didn't build${firstError ? ` (${firstError})` : ""} - it needs the macOS 26 SDK (update Xcode or its command-line tools)`;
+      (0, import_node_fs.writeFileSync)(failed, error);
+      return { error };
+    }
+    (0, import_node_fs.renameSync)(tmp, helper);
+    return { helper };
+  })();
+  return helperPromise;
+}
+async function checkAppleAI(env = process.env) {
+  if (!env.RANKCLI_APPLE_AI_HELPER && !isAppleIntelligenceCapable()) {
+    return { available: false, reason: "it needs macOS 26 or later on Apple silicon" };
+  }
+  const ensured = await ensureHelper(env);
+  if ("error" in ensured) return { available: false, reason: ensured.error };
+  const check = await run(ensured.helper, ["--check"], { timeoutMs: 15e3 });
+  try {
+    const status = JSON.parse(check.stdout);
+    if (status.available) return { available: true, helper: ensured.helper };
+    return { available: false, reason: REASONS[status.reason ?? ""] ?? "Apple Intelligence is unavailable" };
+  } catch {
+    return { available: false, reason: `the helper failed (${(check.stderr || check.stdout).trim().slice(0, 120) || `exit ${check.code}`})` };
+  }
+}
+async function generateWithAppleAI(helper, request, timeoutMs = 12e4) {
+  const result = await run(helper, [], { input: JSON.stringify(request), timeoutMs });
+  if (result.timedOut) return { error: `timed out after ${Math.round(timeoutMs / 1e3)}s` };
+  try {
+    const reply = JSON.parse(result.stdout);
+    if (typeof reply.text === "string") return { text: reply.text };
+    return { error: reply.error || "no reply" };
+  } catch {
+    return { error: (result.stderr || result.stdout).trim().slice(0, 200) || `exit ${result.code}` };
+  }
+}
+
 // src/lib/ai.ts
 var AI_PROVIDERS = {
   // Hosted
@@ -1467,6 +1638,7 @@ var AI_PROVIDERS = {
   together: { label: "Together", baseUrl: "https://api.together.xyz/v1", model: TOGETHER_DEFAULT, envKeys: ["TOGETHER_API_KEY"] },
   fireworks: { label: "Fireworks", baseUrl: "https://api.fireworks.ai/inference/v1", model: FIREWORKS_DEFAULT, envKeys: ["FIREWORKS_API_KEY"] },
   // Local / self-hosted
+  apple: { label: "Apple Intelligence", model: "on-device", envKeys: [], local: true },
   ollama: { label: "Ollama", baseUrl: "http://localhost:11434/v1", envKeys: [], local: true },
   lmstudio: { label: "LM Studio", baseUrl: "http://localhost:1234/v1", envKeys: [], local: true },
   llamacpp: { label: "llama.cpp", baseUrl: "http://localhost:8080/v1", envKeys: [], local: true },
@@ -1531,28 +1703,62 @@ async function firstServerModel(baseUrl, apiKey) {
 }
 function noProviderHints() {
   return [
+    "On a Mac with Apple Intelligence (macOS 26+), the on-device model is used automatically",
     `Set one of ${AI_ENV_KEYS.join(", ")}, or pass --ai-key`,
     "Or run a local model: start Ollama (https://ollama.com) and `ollama pull llama3.2` - it is picked up automatically",
     "Or point at any OpenAI-compatible server: --ai-base-url http://localhost:8080/v1 --ai-model <name>"
   ];
 }
-async function resolveAIProvider(opts, env = process.env, probe = probeOllama) {
-  let provider = opts.aiProvider?.trim().toLowerCase();
+function appleResolution(status, notice) {
+  const preset = AI_PROVIDERS.apple;
+  return {
+    ok: true,
+    ai: {
+      provider: "apple",
+      label: preset.label,
+      baseUrl: "",
+      model: preset.model,
+      jsonMode: false,
+      anthropic: false,
+      local: true,
+      helper: status.helper,
+      notice
+    }
+  };
+}
+async function resolveAIProvider(opts, env = process.env, probe = probeOllama, probeApple = checkAppleAI) {
+  const requested = opts.aiProvider?.trim() || (!opts.aiKey && !opts.aiBaseUrl ? env.RANKCLI_AI_PROVIDER?.trim() : void 0);
+  let provider = requested?.toLowerCase();
   let notice;
   let ollamaModels = null;
   if (provider && !AI_PROVIDERS[provider]) {
     return {
       ok: false,
-      error: `Unknown AI provider "${opts.aiProvider}"`,
+      error: `Unknown AI provider "${requested}"`,
       hints: [`Choose one of: ${AI_PROVIDER_IDS.join(", ")}`]
     };
   }
+  if (provider === "apple") {
+    const apple = await probeApple(env);
+    if (!apple.available) {
+      return {
+        ok: false,
+        error: `Apple Intelligence isn't available: ${apple.reason}`,
+        hints: ["Choose another provider with --ai-provider (e.g. openrouter, ollama)"]
+      };
+    }
+    return appleResolution(apple);
+  }
   if (!provider) {
     if (opts.aiBaseUrl) {
       provider = "custom";
     } else if (opts.aiKey) {
       provider = providerFromKey(opts.aiKey) ?? "openai";
     } else {
+      const apple = await probeApple(env);
+      if (apple.available) {
+        return appleResolution(apple, "Using Apple Intelligence on this Mac (on-device, free) - pass --ai-provider to use another");
+      }
       provider = DETECT_ORDER.find((id) => AI_PROVIDERS[id].envKeys.some((k) => env[k]));
     }
   }
@@ -1692,9 +1898,11 @@ function normalizeAnalysis(raw) {
 }
 var SEVERITY_ORDER = { critical: 0, error: 1, warning: 2, notice: 3, info: 3 };
 var MAX_ISSUES_IN_PROMPT = 60;
-function buildPrompt(url, issues) {
+var APPLE_MAX_ISSUES = 25;
+var APPLE_MAX_TOKENS = 1200;
+function buildPrompt(url, issues, maxIssues = MAX_ISSUES_IN_PROMPT) {
   const ranked = [...issues].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4));
-  const shown = ranked.slice(0, MAX_ISSUES_IN_PROMPT);
+  const shown = ranked.slice(0, maxIssues);
   const more = ranked.length > shown.length ? `
 (${ranked.length - shown.length} lower-severity issues omitted)` : "";
   return `Analyze these SEO audit results and provide prioritized recommendations:
@@ -1714,8 +1922,17 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const prompt = buildPrompt(url, issues);
   const system = "You are an SEO expert. Respond with valid JSON only.";
+  if (ai.provider === "apple" && ai.helper) {
+    const reply = await generateWithAppleAI(ai.helper, {
+      system,
+      prompt: buildPrompt(url, issues, APPLE_MAX_ISSUES),
+      maxTokens: APPLE_MAX_TOKENS
+    });
+    if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
+    return parseAnalysis(reply.text, ai);
+  }
+  const prompt = buildPrompt(url, issues);
   const timeoutMs = ai.local ? 3e5 : 9e4;
   const maxTokens = 4096;
   const headers = { "Content-Type": "application/json" };
@@ -1765,6 +1982,9 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
+  return parseAnalysis(content, ai);
+}
+function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
   const analysis = parsed ? normalizeAnalysis(parsed) : null;
   if (!analysis) {
@@ -4002,7 +4222,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.31";
+var VERSION = "0.0.32";
 
 // src/index.ts
 var program = new import_commander.Command();
@@ -4014,7 +4234,7 @@ program.command("logout").description("Log out of your RankCLI account").action(
 program.command("whoami").description("Show current logged in user").action(whoami);
 program.command("init").description("Set up RankCLI in your project (detects framework, git/GitHub, AI keys)").option("-y, --yes", "Skip prompts and use defaults").action(init);
 program.command("analyze").description("AI analyzes your codebase for SEO opportunities").option("-v, --verbose", "Show detailed output").action(analyze);
-program.command("audit").description("Run a comprehensive SEO audit (200+ checks, Ahrefs-level)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted): openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
+program.command("audit").description("Run an SEO + GEO audit (280+ checks)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted; Apple Intelligence on a Mac that has it, or set RANKCLI_AI_PROVIDER): apple, openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
   process.exitCode = await audit(options);
 });
 program.command("apply").description("Analyze a live URL and apply SEO fixes to your codebase").option("-u, --url <url>", "URL to analyze").option("--auto", "Auto-apply fixes without confirmation").option("--dry-run", "Preview changes without applying").action(apply);

package/dist/index.mjs

@@ -1274,6 +1274,177 @@ var TOGETHER_DEFAULT = "openai/gpt-oss-120b";
 var FIREWORKS_DEFAULT = "accounts/fireworks/models/gpt-oss-120b";
 var CEREBRAS_DEFAULT = "gpt-oss-120b";
 
+// src/lib/apple-ai.ts
+import { execFile, spawn } from "child_process";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync4, renameSync, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { homedir, release } from "os";
+import { join as join4 } from "path";
+
+// src/lib/apple-ai-source.ts
+var APPLE_AI_SWIFT_SOURCE = String.raw`import Foundation
+import FoundationModels
+
+func reply(_ object: [String: Any], code: Int32 = 0) -> Never {
+    let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data("{\"error\":\"could not encode the reply\"}".utf8)
+    FileHandle.standardOutput.write(data)
+    exit(code)
+}
+
+let model = SystemLanguageModel.default
+
+if CommandLine.arguments.contains("--check") {
+    switch model.availability {
+    case .available:
+        reply(["available": true])
+    case .unavailable(let reason):
+        switch reason {
+        case .deviceNotEligible: reply(["available": false, "reason": "deviceNotEligible"])
+        case .appleIntelligenceNotEnabled: reply(["available": false, "reason": "appleIntelligenceNotEnabled"])
+        case .modelNotReady: reply(["available": false, "reason": "modelNotReady"])
+        @unknown default: reply(["available": false, "reason": "unavailable"])
+        }
+    @unknown default:
+        reply(["available": false, "reason": "unavailable"])
+    }
+}
+
+struct Request: Decodable {
+    let system: String?
+    let prompt: String
+    let maxTokens: Int?
+}
+
+let input = FileHandle.standardInput.readDataToEndOfFile()
+guard let request = try? JSONDecoder().decode(Request.self, from: input) else {
+    reply(["error": "expected a JSON request on stdin"], code: 2)
+}
+
+let session: LanguageModelSession
+if let system = request.system {
+    session = LanguageModelSession(instructions: system)
+} else {
+    session = LanguageModelSession()
+}
+
+do {
+    let response = try await session.respond(
+        to: request.prompt,
+        options: GenerationOptions(maximumResponseTokens: request.maxTokens)
+    )
+    reply(["text": response.content])
+} catch let error as LanguageModelSession.GenerationError {
+    switch error {
+    case .exceededContextWindowSize:
+        reply(["error": "the prompt is too long for the on-device model"], code: 1)
+    case .guardrailViolation:
+        reply(["error": "the on-device model's guardrails declined the request"], code: 1)
+    case .assetsUnavailable:
+        reply(["error": "the on-device model isn't downloaded yet"], code: 1)
+    default:
+        reply(["error": String(describing: error)], code: 1)
+    }
+} catch {
+    reply(["error": String(describing: error)], code: 1)
+}
+`;
+
+// src/lib/apple-ai.ts
+function isAppleIntelligenceCapable(platform = process.platform, arch = process.arch, darwinRelease = release()) {
+  return platform === "darwin" && arch === "arm64" && Number(darwinRelease.split(".")[0]) >= 25;
+}
+var REASONS = {
+  deviceNotEligible: "this Mac doesn't support Apple Intelligence",
+  appleIntelligenceNotEnabled: "Apple Intelligence is turned off (System Settings > Apple Intelligence & Siri)",
+  modelNotReady: "the on-device model is still downloading"
+};
+function run(file, args, opts) {
+  return new Promise((resolve) => {
+    const child = spawn(file, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGKILL");
+    }, opts.timeoutMs);
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.on("data", (d) => stderr += d);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      resolve({ code: null, stdout, stderr: stderr || error.message, timedOut });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve({ code, stdout, stderr, timedOut });
+    });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end(opts.input ?? "");
+  });
+}
+function hasDeveloperTools() {
+  return new Promise((resolve) => execFile("xcode-select", ["-p"], (error) => resolve(!error)));
+}
+var helperPromise = null;
+function ensureHelper(env) {
+  if (env.RANKCLI_APPLE_AI_HELPER) return Promise.resolve({ helper: env.RANKCLI_APPLE_AI_HELPER });
+  helperPromise ??= (async () => {
+    const hash = createHash2("sha256").update(APPLE_AI_SWIFT_SOURCE).digest("hex").slice(0, 12);
+    const dir = join4(homedir(), "Library", "Caches", "rankcli", `apple-ai-${hash}`);
+    const helper = join4(dir, "rankcli-apple-ai");
+    if (existsSync4(helper)) return { helper };
+    const failed = join4(dir, "build-failed");
+    if (existsSync4(failed) && Date.now() - statSync2(failed).mtimeMs < 7 * 24 * 60 * 60 * 1e3) {
+      return { error: readFileSync4(failed, "utf8") };
+    }
+    if (!await hasDeveloperTools()) {
+      return { error: "using it needs the Xcode command-line tools (xcode-select --install)" };
+    }
+    mkdirSync(dir, { recursive: true });
+    const source = join4(dir, "main.swift");
+    writeFileSync3(source, APPLE_AI_SWIFT_SOURCE);
+    process.stderr.write("Preparing Apple Intelligence for RankCLI (one-time build of a small helper)...\n");
+    const tmp = `${helper}.${process.pid}`;
+    const build = await run("xcrun", ["swiftc", "-O", "-target", "arm64-apple-macos26.0", source, "-o", tmp], { timeoutMs: 18e4 });
+    if (build.code !== 0 || !existsSync4(tmp)) {
+      const firstError = build.stderr.split("\n").find((line) => /error:/.test(line))?.trim();
+      const error = `the helper didn't build${firstError ? ` (${firstError})` : ""} - it needs the macOS 26 SDK (update Xcode or its command-line tools)`;
+      writeFileSync3(failed, error);
+      return { error };
+    }
+    renameSync(tmp, helper);
+    return { helper };
+  })();
+  return helperPromise;
+}
+async function checkAppleAI(env = process.env) {
+  if (!env.RANKCLI_APPLE_AI_HELPER && !isAppleIntelligenceCapable()) {
+    return { available: false, reason: "it needs macOS 26 or later on Apple silicon" };
+  }
+  const ensured = await ensureHelper(env);
+  if ("error" in ensured) return { available: false, reason: ensured.error };
+  const check = await run(ensured.helper, ["--check"], { timeoutMs: 15e3 });
+  try {
+    const status = JSON.parse(check.stdout);
+    if (status.available) return { available: true, helper: ensured.helper };
+    return { available: false, reason: REASONS[status.reason ?? ""] ?? "Apple Intelligence is unavailable" };
+  } catch {
+    return { available: false, reason: `the helper failed (${(check.stderr || check.stdout).trim().slice(0, 120) || `exit ${check.code}`})` };
+  }
+}
+async function generateWithAppleAI(helper, request, timeoutMs = 12e4) {
+  const result = await run(helper, [], { input: JSON.stringify(request), timeoutMs });
+  if (result.timedOut) return { error: `timed out after ${Math.round(timeoutMs / 1e3)}s` };
+  try {
+    const reply = JSON.parse(result.stdout);
+    if (typeof reply.text === "string") return { text: reply.text };
+    return { error: reply.error || "no reply" };
+  } catch {
+    return { error: (result.stderr || result.stdout).trim().slice(0, 200) || `exit ${result.code}` };
+  }
+}
+
 // src/lib/ai.ts
 var AI_PROVIDERS = {
   // Hosted
@@ -1288,6 +1459,7 @@ var AI_PROVIDERS = {
   together: { label: "Together", baseUrl: "https://api.together.xyz/v1", model: TOGETHER_DEFAULT, envKeys: ["TOGETHER_API_KEY"] },
   fireworks: { label: "Fireworks", baseUrl: "https://api.fireworks.ai/inference/v1", model: FIREWORKS_DEFAULT, envKeys: ["FIREWORKS_API_KEY"] },
   // Local / self-hosted
+  apple: { label: "Apple Intelligence", model: "on-device", envKeys: [], local: true },
   ollama: { label: "Ollama", baseUrl: "http://localhost:11434/v1", envKeys: [], local: true },
   lmstudio: { label: "LM Studio", baseUrl: "http://localhost:1234/v1", envKeys: [], local: true },
   llamacpp: { label: "llama.cpp", baseUrl: "http://localhost:8080/v1", envKeys: [], local: true },
@@ -1352,28 +1524,62 @@ async function firstServerModel(baseUrl, apiKey) {
 }
 function noProviderHints() {
   return [
+    "On a Mac with Apple Intelligence (macOS 26+), the on-device model is used automatically",
     `Set one of ${AI_ENV_KEYS.join(", ")}, or pass --ai-key`,
     "Or run a local model: start Ollama (https://ollama.com) and `ollama pull llama3.2` - it is picked up automatically",
     "Or point at any OpenAI-compatible server: --ai-base-url http://localhost:8080/v1 --ai-model <name>"
   ];
 }
-async function resolveAIProvider(opts, env = process.env, probe = probeOllama) {
-  let provider = opts.aiProvider?.trim().toLowerCase();
+function appleResolution(status, notice) {
+  const preset = AI_PROVIDERS.apple;
+  return {
+    ok: true,
+    ai: {
+      provider: "apple",
+      label: preset.label,
+      baseUrl: "",
+      model: preset.model,
+      jsonMode: false,
+      anthropic: false,
+      local: true,
+      helper: status.helper,
+      notice
+    }
+  };
+}
+async function resolveAIProvider(opts, env = process.env, probe = probeOllama, probeApple = checkAppleAI) {
+  const requested = opts.aiProvider?.trim() || (!opts.aiKey && !opts.aiBaseUrl ? env.RANKCLI_AI_PROVIDER?.trim() : void 0);
+  let provider = requested?.toLowerCase();
   let notice;
   let ollamaModels = null;
   if (provider && !AI_PROVIDERS[provider]) {
     return {
       ok: false,
-      error: `Unknown AI provider "${opts.aiProvider}"`,
+      error: `Unknown AI provider "${requested}"`,
       hints: [`Choose one of: ${AI_PROVIDER_IDS.join(", ")}`]
     };
   }
+  if (provider === "apple") {
+    const apple = await probeApple(env);
+    if (!apple.available) {
+      return {
+        ok: false,
+        error: `Apple Intelligence isn't available: ${apple.reason}`,
+        hints: ["Choose another provider with --ai-provider (e.g. openrouter, ollama)"]
+      };
+    }
+    return appleResolution(apple);
+  }
   if (!provider) {
     if (opts.aiBaseUrl) {
       provider = "custom";
     } else if (opts.aiKey) {
       provider = providerFromKey(opts.aiKey) ?? "openai";
     } else {
+      const apple = await probeApple(env);
+      if (apple.available) {
+        return appleResolution(apple, "Using Apple Intelligence on this Mac (on-device, free) - pass --ai-provider to use another");
+      }
       provider = DETECT_ORDER.find((id) => AI_PROVIDERS[id].envKeys.some((k) => env[k]));
     }
   }
@@ -1513,9 +1719,11 @@ function normalizeAnalysis(raw) {
 }
 var SEVERITY_ORDER = { critical: 0, error: 1, warning: 2, notice: 3, info: 3 };
 var MAX_ISSUES_IN_PROMPT = 60;
-function buildPrompt(url, issues) {
+var APPLE_MAX_ISSUES = 25;
+var APPLE_MAX_TOKENS = 1200;
+function buildPrompt(url, issues, maxIssues = MAX_ISSUES_IN_PROMPT) {
   const ranked = [...issues].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4));
-  const shown = ranked.slice(0, MAX_ISSUES_IN_PROMPT);
+  const shown = ranked.slice(0, maxIssues);
   const more = ranked.length > shown.length ? `
 (${ranked.length - shown.length} lower-severity issues omitted)` : "";
   return `Analyze these SEO audit results and provide prioritized recommendations:
@@ -1535,8 +1743,17 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const prompt = buildPrompt(url, issues);
   const system = "You are an SEO expert. Respond with valid JSON only.";
+  if (ai.provider === "apple" && ai.helper) {
+    const reply = await generateWithAppleAI(ai.helper, {
+      system,
+      prompt: buildPrompt(url, issues, APPLE_MAX_ISSUES),
+      maxTokens: APPLE_MAX_TOKENS
+    });
+    if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
+    return parseAnalysis(reply.text, ai);
+  }
+  const prompt = buildPrompt(url, issues);
   const timeoutMs = ai.local ? 3e5 : 9e4;
   const maxTokens = 4096;
   const headers = { "Content-Type": "application/json" };
@@ -1586,6 +1803,9 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
+  return parseAnalysis(content, ai);
+}
+function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
   const analysis = parsed ? normalizeAnalysis(parsed) : null;
   if (!analysis) {
@@ -2059,8 +2279,8 @@ Examples:
 `;
 
 // src/commands/apply.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
 import {
   runAuditWithFixes,
   generateFixes,
@@ -2094,11 +2314,11 @@ function truncate(str, maxLen) {
 }
 async function apply(options) {
   const cwd = process.cwd();
-  const configPath = join4(cwd, "rankcli.config.json");
+  const configPath = join5(cwd, "rankcli.config.json");
   let config2 = null;
-  if (existsSync4(configPath)) {
+  if (existsSync5(configPath)) {
     try {
-      config2 = JSON.parse(readFileSync4(configPath, "utf-8"));
+      config2 = JSON.parse(readFileSync5(configPath, "utf-8"));
     } catch {
     }
   }
@@ -2222,7 +2442,7 @@ async function apply(options) {
   }
   if (config2 && !config2.url) {
     config2.url = url;
-    writeFileSync3(configPath, JSON.stringify(config2, null, 2));
+    writeFileSync4(configPath, JSON.stringify(config2, null, 2));
     console.log("\n\u{1F4BE} Updated config with URL.");
   }
   console.log("\n" + "\u2500".repeat(50));
@@ -3858,7 +4078,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.31";
+var VERSION = "0.0.32";
 
 // src/index.ts
 var program = new Command();
@@ -3870,7 +4090,7 @@ program.command("logout").description("Log out of your RankCLI account").action(
 program.command("whoami").description("Show current logged in user").action(whoami);
 program.command("init").description("Set up RankCLI in your project (detects framework, git/GitHub, AI keys)").option("-y, --yes", "Skip prompts and use defaults").action(init);
 program.command("analyze").description("AI analyzes your codebase for SEO opportunities").option("-v, --verbose", "Show detailed output").action(analyze);
-program.command("audit").description("Run a comprehensive SEO audit (200+ checks, Ahrefs-level)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted): openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
+program.command("audit").description("Run an SEO + GEO audit (280+ checks)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted; Apple Intelligence on a Mac that has it, or set RANKCLI_AI_PROVIDER): apple, openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
   process.exitCode = await audit(options);
 });
 program.command("apply").description("Analyze a live URL and apply SEO fixes to your codebase").option("-u, --url <url>", "URL to analyze").option("--auto", "Auto-apply fixes without confirmation").option("--dry-run", "Preview changes without applying").action(apply);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/cli",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "RankCLI - Ship code, get ranked. SEO meets CI/CD.",
   "homepage": "https://rankcli.dev",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "update-version": "node scripts/update-version.js"
   },
   "dependencies": {
-    "@rankcli/agent-runtime": "^0.0.22",
+    "@rankcli/agent-runtime": "^0.0.23",
     "@supabase/supabase-js": "^2.98.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",