@sicilianwildcat/aiready 0.1.3 → 0.1.4

package/dist/cli.js

@@ -133,6 +133,59 @@ function loadAgentEntry(targetDir) {
   }
   return null;
 }
+var GRAPHIFY_DIRECT_PATHS = ["graphify-out/graph.json", ".graphify/graph.json"];
+function findGraphifyOutput(target) {
+  for (const p of GRAPHIFY_DIRECT_PATHS) {
+    const full = (0, import_path2.join)(target, p);
+    if (exists(full)) return full;
+  }
+  const datedBase = (0, import_path2.join)(target, "graphify-out");
+  if (exists(datedBase)) {
+    const subdirs = listDirs(datedBase).sort().reverse();
+    for (const subdir of subdirs) {
+      const candidate = (0, import_path2.join)(datedBase, subdir, "graph.json");
+      if (exists(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+function loadFromGraph(target, graphPath) {
+  const raw = readFile(graphPath);
+  if (!raw) return [];
+  let graph;
+  try {
+    graph = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  const nodeDegree = /* @__PURE__ */ new Map();
+  for (const link of graph.links ?? []) {
+    nodeDegree.set(link.source, (nodeDegree.get(link.source) ?? 0) + 1);
+    nodeDegree.set(link.target, (nodeDegree.get(link.target) ?? 0) + 1);
+  }
+  const fileDegree = /* @__PURE__ */ new Map();
+  for (const node of graph.nodes ?? []) {
+    if (node.file_type !== "document") continue;
+    if (!node.source_file?.endsWith(".md")) continue;
+    const current = fileDegree.get(node.source_file) ?? 0;
+    fileDegree.set(node.source_file, current + (nodeDegree.get(node.id) ?? 0));
+  }
+  const topFiles = [...fileDegree.entries()].sort((a, b) => b[1] - a[1]).slice(0, 10).map(([filePath]) => filePath);
+  const repoFiles = [];
+  for (const filePath of topFiles) {
+    const full = (0, import_path2.join)(target, filePath);
+    if (!exists(full)) continue;
+    const content = readFile(full);
+    if (content === null) continue;
+    repoFiles.push({
+      path: filePath,
+      name: filePath.split("/").pop() ?? filePath,
+      preview: content.slice(0, 200),
+      fullContent: content
+    });
+  }
+  return repoFiles;
+}
 function loadRepo(targetDir) {
   const read = (name) => readFile((0, import_path2.join)(targetDir, name));
   const packageJsonRaw = read("package.json");
@@ -149,15 +202,27 @@ function loadRepo(targetDir) {
   const progressMd = read("PROGRESS.md") ?? read("progress.md");
   const sessionHandoffMd = read("SESSION-HANDOFF.md") ?? read("session-handoff.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
-  }));
+  const graphPath = findGraphifyOutput(targetDir);
+  let mdFiles;
+  let usedGraphify = false;
+  if (graphPath) {
+    mdFiles = loadFromGraph(targetDir, graphPath);
+    usedGraphify = true;
+    const rel = graphPath.startsWith(targetDir) ? graphPath.slice(targetDir.length + 1) : graphPath;
+    console.log(`  Using Graphify knowledge graph (${rel})`);
+    console.log(`  Top ${mdFiles.length} files by centrality selected`);
+  } else {
+    const rawMdFiles = walkMdFiles(targetDir);
+    mdFiles = rawMdFiles.map(({ relPath, name, fullContent }) => ({
+      path: relPath,
+      name,
+      preview: fullContent.slice(0, 200),
+      fullContent
+    }));
+  }
   return {
     mdFiles,
+    usedGraphify,
     agentsMd,
     architectureMd,
     constraintsMd,
@@ -173,7 +238,7 @@ function loadRepo(targetDir) {
 }
 
 // src/audit/mapper.ts
-var TRIAGE_SYSTEM = `You are a repository analyst. Given a list of files with short previews,
+var TRIAGE_SYSTEM = `You are a repository analyst. Given a list of file paths,
 identify which files could plausibly serve as harness artifacts for AI
 coding agents.
 
@@ -237,12 +302,11 @@ function parseMapperResponse(text) {
     return [];
   }
 }
-async function triageFiles(mdFiles, provider) {
-  const fileList = mdFiles.map((f) => `- path: ${f.path}
-  preview: ${JSON.stringify(firstLines(f.fullContent, 5))}`).join("\n");
+async function triageByFilename(mdFiles, provider) {
+  const fileList = mdFiles.map((f) => `- ${f.path}`).join("\n");
   const text = await provider.chat(
     TRIAGE_SYSTEM,
-    `Identify harness-relevant files:
+    `Identify harness-relevant files from these paths:
 
 ${fileList}`,
     { fast: true }
@@ -261,9 +325,12 @@ ${fileList}`,
   );
   return parseMapperResponse(text);
 }
-async function mapFiles(mdFiles, provider) {
+async function mapFiles(mdFiles, provider, usedGraphify = false) {
   if (mdFiles.length === 0) return [];
-  const relevantPaths = await triageFiles(mdFiles, provider);
+  if (usedGraphify) {
+    return classifyFiles(mdFiles, provider);
+  }
+  const relevantPaths = await triageByFilename(mdFiles, provider);
   if (relevantPaths.length === 0) return [];
   const pathSet = new Set(relevantPaths);
   const relevantFiles = mdFiles.filter((f) => pathSet.has(f.path));
@@ -295,23 +362,28 @@ function extractDocumentedModules(content) {
   }
   return [...new Set(modules)];
 }
-function checkCommands(files) {
-  if (!files.agentsMd) {
+function checkCommands(files, mappings, mdFileMap) {
+  let contentToCheck = files.agentsMd;
+  if (!contentToCheck && mappings.length > 0) {
+    const mapped = mappings.filter((m) => m.subsystems.includes("identity") || m.subsystems.includes("verification")).map((m) => mdFileMap.get(m.path)).filter((c) => c !== void 0).join("\n\n");
+    if (mapped) contentToCheck = mapped;
+  }
+  if (!contentToCheck) {
     return [
       {
         name: "commands-in-agents-exist-in-package",
         passed: false,
-        detail: "No AGENTS.md to extract commands from"
+        detail: "No agent harness file found to extract commands from"
       }
     ];
   }
-  const commands = extractNpmRunCommands(files.agentsMd);
+  const commands = extractNpmRunCommands(contentToCheck);
   if (commands.length === 0) {
     return [
       {
         name: "commands-in-agents-exist-in-package",
         passed: true,
-        detail: "No npm run commands found in AGENTS.md bash blocks"
+        detail: "No npm run commands found in harness bash blocks"
       }
     ];
   }
@@ -323,30 +395,35 @@ function checkCommands(files) {
       {
         name: "commands-in-agents-exist-in-package",
         passed: true,
-        detail: `All ${commands.length} npm run command(s) in AGENTS.md found in package.json scripts`
+        detail: `All ${commands.length} npm run command(s) in harness found in package.json scripts`
       }
     ];
   }
   return missing.map((cmd) => ({
     name: "commands-in-agents-exist-in-package",
     passed: false,
-    detail: `\`npm run ${cmd}\` in AGENTS.md not found in package.json scripts`
+    detail: `\`npm run ${cmd}\` in harness not found in package.json scripts`
   }));
 }
-function checkModules(files) {
-  if (!files.architectureMd) {
+function checkModules(files, mappings, mdFileMap) {
+  let contentToCheck = files.architectureMd;
+  if (!contentToCheck && mappings.length > 0) {
+    const mapped = mappings.filter((m) => m.subsystems.includes("memory")).map((m) => mdFileMap.get(m.path)).filter((c) => c !== void 0).join("\n\n");
+    if (mapped) contentToCheck = mapped;
+  }
+  if (!contentToCheck) {
     return {
       name: "architecture-modules-match-src",
       passed: false,
-      detail: "No ARCHITECTURE.md to extract documented modules from"
+      detail: "No architecture file found to extract documented modules from"
     };
   }
-  const documented = extractDocumentedModules(files.architectureMd);
+  const documented = extractDocumentedModules(contentToCheck);
   if (documented.length === 0) {
     return {
       name: "architecture-modules-match-src",
       passed: true,
-      detail: "No annotated module directories found in ARCHITECTURE.md"
+      detail: "No annotated module directories found in architecture file"
     };
   }
   const missing = documented.filter((mod) => !files.srcDirs.includes(mod));
@@ -360,7 +437,7 @@ function checkModules(files) {
   return {
     name: "architecture-modules-match-src",
     passed: false,
-    detail: `Module(s) in ARCHITECTURE.md not found in src/: ${missing.join(", ")}`
+    detail: `Module(s) in architecture file not found in src/: ${missing.join(", ")}`
   };
 }
 function checkProgressFreshness(files) {
@@ -385,11 +462,12 @@ function checkProgressFreshness(files) {
     detail: `PROGRESS.md last updated ${Math.round(ageDays)} days ago (threshold: 7)`
   };
 }
-function crossRef(files) {
+function crossRef(files, mappings = []) {
+  const mdFileMap = new Map(files.mdFiles.map((f) => [f.path, f.fullContent]));
   return {
     checks: [
-      ...checkCommands(files),
-      checkModules(files),
+      ...checkCommands(files, mappings, mdFileMap),
+      checkModules(files, mappings, mdFileMap),
       checkProgressFreshness(files)
     ]
   };
@@ -475,7 +553,7 @@ ${contentSections}`,
   const overall = Math.round(
     (identity.score + verification.score + state.score + memory.score + constraints.score) / 5
   );
-  const xref = crossRef(files);
+  const xref = crossRef(files, mappings);
   return { identity, verification, state, memory, constraints, overall, crossRef: xref };
 }
 
@@ -825,7 +903,7 @@ async function runAudit(target, opts) {
   const provider = createProvider(config.provider, config.apiKey, config.modelId);
   const targetDir = (0, import_path3.resolve)(target);
   const files = loadRepo(targetDir);
-  const mappings = await mapFiles(files.mdFiles, provider);
+  const mappings = await mapFiles(files.mdFiles, provider, files.usedGraphify);
   const scored = await scoreRepo(files, mappings, provider);
   const totalTokens = provider.getTotalTokens();
   report(scored, { json: opts.json, tokenUsage: totalTokens });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sicilianwildcat/aiready",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Audit repositories for AI agent readiness",
   "license": "MIT",
   "author": "harikrishn4a",