@sicilianwildcat/aiready 0.1.0 → 0.1.1

package/dist/cli.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,6 +18,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/cli.ts
@@ -24,16 +34,18 @@ __export(cli_exports, {
   program: () => program
 });
 module.exports = __toCommonJS(cli_exports);
+var import_config = require("dotenv/config");
 var import_commander = require("commander");
 
 // src/audit/index.ts
-var import_path2 = require("path");
+var import_path3 = require("path");
 
 // src/audit/loader.ts
-var import_path = require("path");
+var import_path2 = require("path");
 
 // src/utils/fs.ts
 var import_fs = require("fs");
+var import_path = require("path");
 function readFile(filePath) {
   try {
     return (0, import_fs.readFileSync)(filePath, "utf8");
@@ -41,6 +53,9 @@ function readFile(filePath) {
     return null;
   }
 }
+function exists(filePath) {
+  return (0, import_fs.existsSync)(filePath);
+}
 function listDirs(dirPath) {
   try {
     return (0, import_fs.readdirSync)(dirPath, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
@@ -62,10 +77,64 @@ function statMtime(filePath) {
     return null;
   }
 }
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  "coverage",
+  ".next",
+  ".nuxt",
+  "__pycache__",
+  ".cache",
+  "vendor",
+  "tmp",
+  ".tmp"
+]);
+function walkMdFiles(dirPath, relBase = "", depth = 0) {
+  if (depth > 3) return [];
+  const results = [];
+  try {
+    const entries = (0, import_fs.readdirSync)(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      const relPath = relBase ? `${relBase}/${entry.name}` : entry.name;
+      const fullPath = (0, import_path.join)(dirPath, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...walkMdFiles(fullPath, relPath, depth + 1));
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
+        const content = readFile(fullPath);
+        if (content !== null) {
+          results.push({ relPath, name: entry.name, fullContent: content });
+        }
+      }
+    }
+  } catch {
+  }
+  return results;
+}
 
 // src/audit/loader.ts
+var AGENT_ENTRY_CANDIDATES = [
+  "AGENTS.md",
+  "CLAUDE.md",
+  "AGENT.md",
+  ".cursorrules",
+  ".windsurfrules",
+  ".github/copilot-instructions.md",
+  "COPILOT.md"
+];
+function loadAgentEntry(targetDir) {
+  for (const rel of AGENT_ENTRY_CANDIDATES) {
+    const filePath = (0, import_path2.join)(targetDir, rel);
+    if (exists(filePath)) {
+      return readFile(filePath);
+    }
+  }
+  return null;
+}
 function loadRepo(targetDir) {
-  const read = (name) => readFile((0, import_path.join)(targetDir, name));
+  const read = (name) => readFile((0, import_path2.join)(targetDir, name));
   const packageJsonRaw = read("package.json");
   let packageJson = null;
   if (packageJsonRaw) {
@@ -74,13 +143,21 @@ function loadRepo(targetDir) {
     } catch {
     }
   }
-  const agentsMd = read("AGENTS.md") ?? read("agents.md") ?? read(".agents.md");
+  const agentsMd = loadAgentEntry(targetDir);
   const architectureMd = read("ARCHITECTURE.md") ?? read("architecture.md");
   const constraintsMd = read("CONSTRAINTS.md") ?? read("constraints.md");
   const progressMd = read("PROGRESS.md") ?? read("progress.md");
   const sessionHandoffMd = read("SESSION-HANDOFF.md") ?? read("session-handoff.md");
-  const progressMdModifiedAt = statMtime((0, import_path.join)(targetDir, "PROGRESS.md")) ?? statMtime((0, import_path.join)(targetDir, "progress.md"));
+  const progressMdModifiedAt = statMtime((0, import_path2.join)(targetDir, "PROGRESS.md")) ?? statMtime((0, import_path2.join)(targetDir, "progress.md"));
+  const rawMdFiles = walkMdFiles(targetDir);
+  const mdFiles = rawMdFiles.map(({ relPath, name, fullContent }) => ({
+    path: relPath,
+    name,
+    preview: fullContent.slice(0, 200),
+    fullContent
+  }));
   return {
+    mdFiles,
     agentsMd,
     architectureMd,
     constraintsMd,
@@ -88,164 +165,59 @@ function loadRepo(targetDir) {
     sessionHandoffMd,
     packageJsonRaw,
     packageJson,
-    srcDirs: listDirs((0, import_path.join)(targetDir, "src")),
+    srcDirs: listDirs((0, import_path2.join)(targetDir, "src")),
     rootFiles: listFiles(targetDir),
     progressMdModifiedAt,
     targetDir
   };
 }
 
-// src/audit/scorer.ts
-function scoreIdentity(files) {
-  const gaps = [];
-  if (!files.agentsMd) {
-    return {
-      score: 0,
-      gaps: ["No AGENTS.md \u2014 agents have no entry point for this repository"]
-    };
-  }
-  let score = 20;
-  const wordCount = files.agentsMd.split(/\s+/).filter(Boolean).length;
-  if (wordCount >= 50) {
-    score += 20;
-  } else {
-    gaps.push(`AGENTS.md description too short (${wordCount} words, need 50+)`);
-  }
-  if (/^##\s+stack/im.test(files.agentsMd)) {
-    score += 20;
-  } else {
-    gaps.push("No ## Stack section in AGENTS.md");
-  }
-  const hasVersion = typeof files.packageJson?.["version"] === "string" || /v?\d+\.\d+\.\d+/.test(files.agentsMd);
-  if (hasVersion) {
-    score += 20;
-  } else {
-    gaps.push("No version number found in AGENTS.md or package.json");
-  }
-  if (/^##\s+repo\s+structure/im.test(files.agentsMd) || /src\//m.test(files.agentsMd)) {
-    score += 20;
-  } else {
-    gaps.push("No repo structure section in AGENTS.md");
-  }
-  return { score, gaps };
-}
-function scoreVerification(files) {
-  const gaps = [];
-  let score = 0;
-  const hasVerificationSection = files.agentsMd != null && (/^##\s+verification/im.test(files.agentsMd) || /```(?:bash|sh)/.test(files.agentsMd));
-  if (hasVerificationSection) {
-    score += 30;
-  } else {
-    gaps.push("No verification commands section in AGENTS.md");
-  }
-  const npmCommandMatches = files.agentsMd?.match(/npm\s+(?:run\s+\w+|test|install|ci)/g) ?? [];
-  if (npmCommandMatches.length >= 2) {
-    score += 20;
-  } else {
-    gaps.push("Fewer than 2 verification commands documented in AGENTS.md");
-  }
-  const scripts = files.packageJson?.["scripts"];
-  const scriptNames = scripts != null && typeof scripts === "object" ? Object.keys(scripts) : [];
-  if (scriptNames.length >= 2) {
-    score += 30;
-  } else {
-    gaps.push("package.json missing scripts (need at least 2)");
-  }
-  if (scriptNames.includes("build") && scriptNames.includes("test")) {
-    score += 20;
-  } else {
-    gaps.push("package.json missing build or test script");
-  }
-  return { score, gaps };
-}
-function scoreState(files) {
-  const gaps = [];
-  let score = 0;
-  if (files.progressMd) {
-    score += 30;
-    if (/^##\s+(?:completed|in\s+progress|current)/im.test(files.progressMd)) {
-      score += 20;
-    } else {
-      gaps.push("PROGRESS.md lacks structured sections (## Completed / ## In progress)");
-    }
-  } else {
-    gaps.push("No PROGRESS.md \u2014 agents cannot resume sessions without project state");
-  }
-  if (files.sessionHandoffMd) {
-    score += 30;
-  } else {
-    gaps.push("No SESSION-HANDOFF.md \u2014 agents start blind each session");
-  }
-  if (files.progressMdModifiedAt) {
-    const ageMs = Date.now() - files.progressMdModifiedAt.getTime();
-    const ageDays = ageMs / (1e3 * 60 * 60 * 24);
-    if (ageDays <= 7) {
-      score += 20;
-    } else {
-      gaps.push(`PROGRESS.md last updated ${Math.round(ageDays)} days ago (threshold: 7)`);
-    }
-  }
-  return { score, gaps };
-}
-function scoreMemory(files) {
-  const gaps = [];
-  if (!files.architectureMd) {
-    return {
-      score: 0,
-      gaps: ["No ARCHITECTURE.md \u2014 agents cannot navigate the codebase without exploring"]
-    };
-  }
-  let score = 30;
-  const annotatedLines = (files.architectureMd.match(/←/g) ?? []).length;
-  if (annotatedLines >= 3) {
-    score += 30;
-  } else {
-    gaps.push("ARCHITECTURE.md has few module annotations (add \u2190 comments to explain modules)");
-  }
-  if (files.architectureMd.length > 300) {
-    score += 20;
-  } else {
-    gaps.push("ARCHITECTURE.md too short \u2014 add module responsibilities and data flow");
-  }
-  if (/src\//m.test(files.architectureMd)) {
-    score += 20;
-  } else {
-    gaps.push("ARCHITECTURE.md does not reference src/ directory structure");
+// src/audit/mapper.ts
+var MAPPER_SYSTEM = `You are classifying repository markdown files by AI agent harness subsystem.
+
+There are exactly 5 subsystems:
+- identity: File describes what the project is, its purpose, stack, version, or high-level structure
+- verification: File contains commands to build/test/validate work, CI configuration, or runbooks
+- state: File tracks current progress, session state, what is done, blocked, or next
+- memory: File maps the architecture, module responsibilities, file structure, or code navigation
+- constraints: File defines rules agents must follow, using MUST or MUST NOT language
+
+For each file provided (path and first 200 characters), return which subsystems it belongs to.
+A file can belong to multiple subsystems. Omit files with no harness relevance.
+
+Return ONLY valid JSON with no explanation:
+{"mappings":[{"path":"file.md","subsystems":["identity"]}]}`;
+var VALID_SUBSYSTEMS = /* @__PURE__ */ new Set([
+  "identity",
+  "verification",
+  "state",
+  "memory",
+  "constraints"
+]);
+function parseMapperResponse(text) {
+  try {
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) return [];
+    const parsed = JSON.parse(jsonMatch[0]);
+    if (!Array.isArray(parsed.mappings)) return [];
+    return parsed.mappings.filter((m) => typeof m.path === "string" && Array.isArray(m.subsystems)).map((m) => ({
+      path: m.path,
+      subsystems: m.subsystems.filter(
+        (s) => VALID_SUBSYSTEMS.has(s)
+      )
+    })).filter((m) => m.subsystems.length > 0);
+  } catch {
+    return [];
   }
-  return { score, gaps };
 }
-function scoreConstraints(files) {
-  const gaps = [];
-  let score = 0;
-  const hasSection = files.constraintsMd != null || /^##\s+constraints/im.test(files.agentsMd ?? "");
-  const constraintContent = files.constraintsMd ?? files.agentsMd ?? "";
-  if (hasSection) {
-    score += 30;
-  } else {
-    gaps.push("No CONSTRAINTS.md and no ## Constraints section in AGENTS.md");
-  }
-  if (/\bMUST\b/.test(constraintContent)) {
-    score += 40;
-  } else {
-    gaps.push("No MUST language in constraints \u2014 use imperative MUST / MUST NOT");
-  }
-  if (/\bMUST NOT\b/.test(constraintContent)) {
-    score += 30;
-  } else {
-    gaps.push("No MUST NOT language in constraints");
-  }
-  return { score, gaps };
-}
-function scoreRepo(files) {
-  const identity = scoreIdentity(files);
-  const verification = scoreVerification(files);
-  const state = scoreState(files);
-  const memory = scoreMemory(files);
-  const constraints = scoreConstraints(files);
-  const overall = Math.round(
-    (identity.score + verification.score + state.score + memory.score + constraints.score) / 5
-  );
-  return { identity, verification, state, memory, constraints, overall };
+async function mapFiles(mdFiles, provider) {
+  if (mdFiles.length === 0) return [];
+  const fileList = mdFiles.map((f) => `- path: ${f.path}
+  preview: ${JSON.stringify(f.preview)}`).join("\n");
+  const text = await provider.chat(MAPPER_SYSTEM, `Classify these repository files:
+
+${fileList}`, { fast: true });
+  return parseMapperResponse(text);
 }
 
 // src/audit/cross-ref.ts
@@ -372,15 +344,106 @@ function crossRef(files) {
   };
 }
 
+// src/audit/scorer.ts
+var SCORER_SYSTEM = `You are scoring an AI agent harness for a software repository.
+
+Score each of the 5 subsystems from 0 to 100 based on the file contents provided.
+
+Scoring criteria:
+- identity (0-100): Does an agent know what this project is? (purpose, stack, version, structure)
+  Score 0 if no relevant files. Score 30-60 for partial coverage. Score 70-90 for good coverage. Score 91-100 for comprehensive coverage including stack, version, and structure.
+- verification (0-100): Can an agent confirm work is correct? (build/test commands documented and present)
+  Score 0 if no verification commands. Score 50-70 if commands mentioned. Score 80-100 if commands are specific, runnable, and cross-referenced with scripts.
+- state (0-100): Can an agent resume sessions? (progress tracking, session handoffs)
+  Score 0 if no state files. Score 30-50 for minimal tracking. Score 60-80 for structured progress + handoff. Score 90-100 for structured, fresh, and complete state.
+- memory (0-100): Can an agent navigate without exploring? (architecture doc, module map with annotations)
+  Score 0 if no architecture doc. Score 30-50 for basic architecture. Score 70-90 for annotated module map. Score 91-100 for detailed map with \u2190 annotations and data flow.
+- constraints (0-100): Does an agent know what it must never do? (MUST/MUST NOT rules)
+  Score 0 if no constraints. Score 30-50 for general rules. Score 70-90 for MUST language. Score 91-100 for explicit MUST NOT rules covering critical failure modes.
+
+Return ONLY valid JSON with no explanation:
+{"identity":{"score":85,"gaps":["one specific gap"]},"verification":{"score":70,"gaps":[]},"state":{"score":60,"gaps":["gap"]},"memory":{"score":90,"gaps":[]},"constraints":{"score":100,"gaps":[]}}`;
+var SUBSYSTEMS = ["identity", "verification", "state", "memory", "constraints"];
+function parseScorerResponse(text) {
+  try {
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) return {};
+    return JSON.parse(jsonMatch[0]);
+  } catch {
+    return {};
+  }
+}
+function emptyScore() {
+  return { score: 0, gaps: ["No files mapped to this subsystem"], files: [] };
+}
+function buildSubsystemContent(subsystem, mdFiles, mappings) {
+  const mappedPaths = mappings.filter((m) => m.subsystems.includes(subsystem)).map((m) => m.path);
+  if (mappedPaths.length === 0) return { files: [], content: "" };
+  const fileMap = new Map(mdFiles.map((f) => [f.path, f.fullContent]));
+  const sections = mappedPaths.map((p) => {
+    const content = fileMap.get(p) ?? "";
+    return `=== ${p} ===
+${content}`;
+  });
+  return { files: mappedPaths, content: sections.join("\n\n") };
+}
+async function scoreRepo(files, mappings, provider) {
+  const subsystemContents = SUBSYSTEMS.map((s) => ({
+    subsystem: s,
+    ...buildSubsystemContent(s, files.mdFiles, mappings)
+  }));
+  const contentSections = subsystemContents.map(({ subsystem, content }) => {
+    if (!content) return `### ${subsystem}
+(no files mapped)`;
+    return `### ${subsystem}
+${content}`;
+  }).join("\n\n");
+  const text = await provider.chat(
+    SCORER_SYSTEM,
+    `Score this repository's AI harness across all 5 subsystems:
+
+${contentSections}`,
+    { fast: false }
+  );
+  const llmScores = parseScorerResponse(text);
+  function toSubsystemScore(key) {
+    const entry = llmScores[key];
+    const { files: subsysFiles } = subsystemContents.find((s) => s.subsystem === key) ?? { files: [] };
+    if (!entry) return emptyScore();
+    return {
+      score: Math.min(100, Math.max(0, Math.round(entry.score))),
+      gaps: Array.isArray(entry.gaps) ? entry.gaps.filter((g) => typeof g === "string") : [],
+      files: subsysFiles
+    };
+  }
+  const identity = toSubsystemScore("identity");
+  const verification = toSubsystemScore("verification");
+  const state = toSubsystemScore("state");
+  const memory = toSubsystemScore("memory");
+  const constraints = toSubsystemScore("constraints");
+  const overall = Math.round(
+    (identity.score + verification.score + state.score + memory.score + constraints.score) / 5
+  );
+  const xref = crossRef(files);
+  return { identity, verification, state, memory, constraints, overall, crossRef: xref };
+}
+
 // src/audit/reporter.ts
 function bar(score) {
   const filled = Math.round(score / 10);
   return "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
 }
-function subsystemLine(name, score, gaps) {
+function abbreviateFiles(files) {
+  if (files.length === 0) return "(no files)";
+  const names = files.map((p) => p.split("/").pop() ?? p);
+  if (names.length <= 3) return names.join(", ");
+  return `${names.slice(0, 2).join(", ")} +${names.length - 2} more`;
+}
+function subsystemLine(name, score, gaps, files) {
   const scoreStr = String(score).padStart(3);
+  const filePart = abbreviateFiles(files).padEnd(30);
   const summary = gaps.length > 0 ? gaps[0] : "All checks passed";
-  return `${name.padEnd(14)}  ${bar(score)}  ${scoreStr}   ${summary}`;
+  return `${name.padEnd(14)}  ${bar(score)}  ${scoreStr}   ${filePart}  ${summary}`;
 }
 function getRecommendation(scored) {
   const subsystems = [
@@ -403,35 +466,33 @@ function getRecommendation(scored) {
   }
   return messages[lowest.name] ?? "Run `npx aiready init` to generate missing artifacts.";
 }
-function collectCriticalGaps(scored, xref) {
+function collectCriticalGaps(scored) {
   const gaps = [];
-  for (const [, value] of Object.entries(scored)) {
-    if (typeof value === "object" && "score" in value && "gaps" in value) {
-      const sub = value;
-      if (sub.score < 50) {
-        gaps.push(...sub.gaps.slice(0, 1));
-      }
+  for (const key of ["identity", "verification", "state", "memory", "constraints"]) {
+    const sub = scored[key];
+    if (sub.score < 50 && sub.gaps.length > 0) {
+      gaps.push(sub.gaps[0]);
     }
   }
-  for (const check of xref.checks) {
+  for (const check of scored.crossRef.checks) {
     if (!check.passed) {
       gaps.push(check.detail);
     }
   }
   return gaps;
 }
-function report(scored, xref, opts) {
+function report(scored, opts) {
   if (opts.json) {
     const out = {
       overall: scored.overall,
       subsystems: {
-        identity: scored.identity,
-        verification: scored.verification,
-        state: scored.state,
-        memory: scored.memory,
-        constraints: scored.constraints
+        identity: { score: scored.identity.score, gaps: scored.identity.gaps, files: scored.identity.files },
+        verification: { score: scored.verification.score, gaps: scored.verification.gaps, files: scored.verification.files },
+        state: { score: scored.state.score, gaps: scored.state.gaps, files: scored.state.files },
+        memory: { score: scored.memory.score, gaps: scored.memory.gaps, files: scored.memory.files },
+        constraints: { score: scored.constraints.score, gaps: scored.constraints.gaps, files: scored.constraints.files }
       },
-      crossReference: xref,
+      crossReference: scored.crossRef,
       recommendation: getRecommendation(scored)
     };
     process.stdout.write(JSON.stringify(out, null, 2) + "\n");
@@ -440,12 +501,12 @@ function report(scored, xref, opts) {
   const lines = [];
   lines.push(`AI Readiness: ${scored.overall}/100`);
   lines.push("");
-  lines.push(subsystemLine("identity", scored.identity.score, scored.identity.gaps));
-  lines.push(subsystemLine("verification", scored.verification.score, scored.verification.gaps));
-  lines.push(subsystemLine("state", scored.state.score, scored.state.gaps));
-  lines.push(subsystemLine("memory", scored.memory.score, scored.memory.gaps));
-  lines.push(subsystemLine("constraints", scored.constraints.score, scored.constraints.gaps));
-  const criticalGaps = collectCriticalGaps(scored, xref);
+  lines.push(subsystemLine("identity", scored.identity.score, scored.identity.gaps, scored.identity.files));
+  lines.push(subsystemLine("verification", scored.verification.score, scored.verification.gaps, scored.verification.files));
+  lines.push(subsystemLine("state", scored.state.score, scored.state.gaps, scored.state.files));
+  lines.push(subsystemLine("memory", scored.memory.score, scored.memory.gaps, scored.memory.files));
+  lines.push(subsystemLine("constraints", scored.constraints.score, scored.constraints.gaps, scored.constraints.files));
+  const criticalGaps = collectCriticalGaps(scored);
   if (criticalGaps.length > 0) {
     lines.push("");
     lines.push("Critical gaps:");
@@ -458,13 +519,212 @@ function report(scored, xref, opts) {
   process.stdout.write(lines.join("\n") + "\n");
 }
 
+// src/utils/prompt.ts
+var import_prompts = require("@inquirer/prompts");
+
+// src/utils/llm.ts
+var import_sdk = __toESM(require("@anthropic-ai/sdk"));
+var import_openai = __toESM(require("openai"));
+
+// src/utils/models.ts
+var ANTHROPIC_MODELS = [
+  { id: "claude-haiku-4-5-20251001", label: "Claude Haiku 4.5  \u2014 fast, cheapest" },
+  { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6 \u2014 balanced (recommended)" },
+  { id: "claude-sonnet-4-20250514", label: "Claude Sonnet 4   \u2014 balanced" },
+  { id: "claude-opus-4-8", label: "Claude Opus 4.8   \u2014 most capable" },
+  { id: "claude-opus-4-20250514", label: "Claude Opus 4     \u2014 most capable" }
+];
+var OPENAI_FALLBACK_MODELS = [
+  { id: "gpt-4o-mini", label: "GPT-4o Mini" },
+  { id: "gpt-4o", label: "GPT-4o" },
+  { id: "gpt-4-turbo", label: "GPT-4 Turbo" },
+  { id: "gpt-3.5-turbo", label: "GPT-3.5 Turbo" }
+];
+
+// src/utils/llm.ts
+var ANTHROPIC_FAST = "claude-haiku-4-5-20251001";
+var ANTHROPIC_QUALITY = "claude-sonnet-4-6";
+var AnthropicProvider = class {
+  client;
+  modelId;
+  constructor(apiKey, modelId) {
+    this.client = new import_sdk.default({ apiKey });
+    this.modelId = modelId;
+  }
+  async chat(system, user, opts) {
+    const model = this.modelId ?? (opts?.fast ? ANTHROPIC_FAST : ANTHROPIC_QUALITY);
+    const maxTokens = opts?.fast ? 1024 : 2048;
+    const response = await this.client.messages.create({
+      model,
+      max_tokens: maxTokens,
+      system: [{ type: "text", text: system, cache_control: { type: "ephemeral" } }],
+      messages: [{ role: "user", content: user }]
+    });
+    const block = response.content.find((b) => b.type === "text");
+    return block && block.type === "text" ? block.text : "";
+  }
+};
+var OPENAI_FAST = "gpt-4o-mini";
+var OPENAI_QUALITY = "gpt-4o";
+var OpenAIProvider = class {
+  client;
+  modelId;
+  constructor(apiKey, modelId) {
+    const baseURL = process.env["OPENAI_BASE_URL"];
+    this.client = new import_openai.default({ apiKey, ...baseURL ? { baseURL } : {} });
+    this.modelId = modelId;
+  }
+  async chat(system, user, opts) {
+    const model = this.modelId ?? (opts?.fast ? OPENAI_FAST : OPENAI_QUALITY);
+    const response = await this.client.chat.completions.create({
+      model,
+      messages: [
+        { role: "system", content: system },
+        { role: "user", content: user }
+      ]
+    });
+    return response.choices[0]?.message?.content ?? "";
+  }
+};
+var OllamaProvider = class {
+  client;
+  model;
+  constructor() {
+    const host = process.env["OLLAMA_HOST"] ?? "http://localhost:11434";
+    this.model = process.env["OLLAMA_MODEL"] ?? "llama3";
+    this.client = new import_openai.default({
+      apiKey: "ollama",
+      baseURL: `${host}/v1`
+    });
+  }
+  async chat(system, user) {
+    const response = await this.client.chat.completions.create({
+      model: this.model,
+      messages: [
+        { role: "system", content: system },
+        { role: "user", content: user }
+      ]
+    });
+    return response.choices[0]?.message?.content ?? "";
+  }
+};
+async function listOpenAIModels(apiKey) {
+  try {
+    const baseURL = process.env["OPENAI_BASE_URL"];
+    const client = new import_openai.default({ apiKey, ...baseURL ? { baseURL } : {} });
+    const response = await client.models.list();
+    const chatModels = response.data.filter((m) => m.id.startsWith("gpt-") && !m.id.includes(":")).sort((a, b) => b.created - a.created).map((m) => ({ id: m.id, label: m.id }));
+    return chatModels.length > 0 ? chatModels : OPENAI_FALLBACK_MODELS;
+  } catch {
+    return OPENAI_FALLBACK_MODELS;
+  }
+}
+function createProvider(name, apiKey, modelId) {
+  switch (name) {
+    case "anthropic":
+      if (!apiKey) throw new Error("API key required for Anthropic provider");
+      return new AnthropicProvider(apiKey, modelId);
+    case "openai":
+      if (!apiKey) throw new Error("API key required for OpenAI provider");
+      return new OpenAIProvider(apiKey, modelId);
+    case "ollama":
+      return new OllamaProvider();
+    default: {
+      const _exhaustive = name;
+      throw new Error(`Unknown provider: ${String(_exhaustive)}`);
+    }
+  }
+}
+
+// src/utils/prompt.ts
+var ENV_KEY_NAMES = {
+  anthropic: "ANTHROPIC_API_KEY",
+  openai: "OPENAI_API_KEY",
+  ollama: null
+};
+var GET_KEY_URLS = {
+  anthropic: "https://console.anthropic.com",
+  openai: "https://platform.openai.com/api-keys"
+};
+function exitMissingKey(provider, envVar) {
+  const url = GET_KEY_URLS[provider];
+  process.stderr.write(`ERROR: ${envVar} not set
+`);
+  process.stderr.write(`WHY:   aiready needs an API key to analyse your repository with ${provider}
+`);
+  process.stderr.write(`FIX:   Add it to your .env file:
+`);
+  process.stderr.write(`         ${envVar}=your_key_here
+`);
+  if (url) {
+    process.stderr.write(`       Get your key at: ${url}
+`);
+  }
+  process.stderr.write(`
+`);
+  process.stderr.write(`       If you use Cursor Pro or Claude Code without your own API key,
+`);
+  process.stderr.write(`       use Ollama instead (free, runs locally): https://ollama.com
+`);
+  process.exit(1);
+}
+function resolveProvider(flag) {
+  const valid = ["anthropic", "openai", "ollama"];
+  const lower = flag.toLowerCase();
+  if (!valid.includes(lower)) {
+    process.stderr.write(`ERROR: Unknown provider "${flag}". Valid options: anthropic, openai, ollama
+`);
+    process.exit(1);
+  }
+  return lower;
+}
+async function promptProvider() {
+  return (0, import_prompts.select)({
+    message: "Select LLM provider:",
+    choices: [
+      { name: "Anthropic", value: "anthropic" },
+      { name: "OpenAI", value: "openai" },
+      { name: "Ollama (local \u2014 no API key needed)", value: "ollama" }
+    ]
+  });
+}
+async function promptModelId(provider, apiKey) {
+  if (provider === "ollama") {
+    return process.env["OLLAMA_MODEL"] ?? "llama3";
+  }
+  if (provider === "anthropic") {
+    return (0, import_prompts.select)({
+      message: "Select model:",
+      choices: ANTHROPIC_MODELS.map((m) => ({ name: m.label, value: m.id }))
+    });
+  }
+  const models = await listOpenAIModels(apiKey);
+  return (0, import_prompts.select)({
+    message: "Select model:",
+    choices: models.map((m) => ({ name: m.label, value: m.id }))
+  });
+}
+async function selectAuditConfig(flags) {
+  const provider = flags.provider ? resolveProvider(flags.provider) : await promptProvider();
+  const envVarName = ENV_KEY_NAMES[provider];
+  let apiKey;
+  if (envVarName) {
+    apiKey = process.env[envVarName];
+    if (!apiKey) exitMissingKey(provider, envVarName);
+  }
+  const modelId = flags.model ?? await promptModelId(provider, apiKey);
+  return { provider, modelId, apiKey };
+}
+
 // src/audit/index.ts
-function runAudit(target, opts) {
-  const targetDir = (0, import_path2.resolve)(target);
+async function runAudit(target, opts) {
+  const config = await selectAuditConfig({ provider: opts.provider, model: opts.model });
+  const provider = createProvider(config.provider, config.apiKey, config.modelId);
+  const targetDir = (0, import_path3.resolve)(target);
   const files = loadRepo(targetDir);
-  const scored = scoreRepo(files);
-  const xref = crossRef(files);
-  report(scored, xref, { json: opts.json });
+  const mappings = await mapFiles(files.mdFiles, provider);
+  const scored = await scoreRepo(files, mappings, provider);
+  report(scored, { json: opts.json });
   if (scored.overall < opts.minScore) {
     process.exit(1);
   }
@@ -473,10 +733,16 @@ function runAudit(target, opts) {
 // src/cli.ts
 var program = new import_commander.Command();
 program.name("aiready").description("Audit repositories for AI agent readiness").version("0.1.0");
-program.command("audit").description("Score a repository against the 5 AI-readiness subsystems").option("-t, --target <dir>", "target directory to audit", ".").option("--json", "output results as JSON", false).option("--min-score <n>", "exit 1 if overall score is below this threshold", "70").action((opts) => {
+program.command("audit").description("Score a repository against the 5 AI-readiness subsystems").option("-t, --target <dir>", "target directory to audit", ".").option("--json", "output results as JSON", false).option("--min-score <n>", "exit 1 if overall score is below this threshold", "70").option("--provider <name>", "LLM provider: anthropic | openai | ollama (skips prompt)").option("--model <id>", "model ID (e.g. claude-sonnet-4-6, gpt-4o) \u2014 skips prompt").action((opts) => {
   runAudit(opts.target, {
     json: opts.json,
-    minScore: parseInt(opts.minScore, 10)
+    minScore: parseInt(opts.minScore, 10),
+    provider: opts.provider,
+    model: opts.model
+  }).catch((err) => {
+    process.stderr.write(`ERROR: ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
   });
 });
 if (require.main === module) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sicilianwildcat/aiready",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Audit repositories for AI agent readiness",
   "license": "MIT",
   "author": "harikrishn4a",
@@ -39,7 +39,11 @@
     "dev": "tsup --watch"
   },
   "dependencies": {
-    "commander": "^12.0.0"
+    "@anthropic-ai/sdk": "^0.100.1",
+    "@inquirer/prompts": "^7.10.1",
+    "commander": "^12.0.0",
+    "dotenv": "^17.4.2",
+    "openai": "^6.42.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",