@a-company/paradigm 3.1.5 → 3.5.0

package/dist/{lint-HXKTWRNO.js → lint-N4LMMEXH.js}

@@ -4,7 +4,7 @@ import {
   parsePurposeFileDetailed,
   serializePurposeFile,
   validatePurposeFile
-} from "./chunk-PW2EXJQT.js";
+} from "./chunk-MRENOFTR.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
@@ -201,6 +201,94 @@ function formatIssue(issue, indent = "  ") {
   }
   return lines;
 }
+var SOURCE_DIR_PATTERNS = [
+  "src",
+  "lib",
+  "features",
+  "components",
+  "services",
+  "utils",
+  "routes",
+  "api",
+  "commands",
+  "core",
+  "middleware",
+  "models",
+  "handlers",
+  "hooks",
+  "stores",
+  "config",
+  "plugins"
+];
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  "build",
+  ".git",
+  ".paradigm",
+  "coverage",
+  "__pycache__",
+  ".next",
+  ".nuxt",
+  "vendor",
+  "target"
+]);
+function findUndocumentedDirs(rootDir, existingPurposeFiles) {
+  const coveredDirs = new Set(existingPurposeFiles.map((f) => path.dirname(f)));
+  const suggestions = [];
+  function scanDir(dir, depth) {
+    if (depth > 4) return;
+    if (coveredDirs.has(dir)) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    const dirName = path.basename(dir);
+    if (SKIP_DIRS.has(dirName)) return;
+    const isSourceDir = SOURCE_DIR_PATTERNS.includes(dirName) || entries.some((e) => !e.isDirectory() && /\.(ts|tsx|js|jsx|rs|py|go)$/.test(e.name));
+    if (isSourceDir && !entries.some((e) => e.name === ".purpose")) {
+      const sourceFiles = entries.filter((e) => !e.isDirectory() && /\.(ts|tsx|js|jsx|rs|py|go)$/.test(e.name)).filter((e) => !e.name.endsWith(".test.ts") && !e.name.endsWith(".spec.ts") && e.name !== "index.ts").map((e) => e.name.replace(/\.[^.]+$/, ""));
+      const components = sourceFiles.slice(0, 10).map(
+        (f) => f.replace(/([A-Z])/g, (_, c, i) => (i > 0 ? "-" : "") + c.toLowerCase())
+      );
+      if (components.length > 0) {
+        const purposePath = path.join(dir, ".purpose");
+        const relDir = path.relative(rootDir, dir);
+        const content = generatePurposeDraft(dirName, components);
+        suggestions.push({
+          dir,
+          relativeDir: relDir,
+          purposePath,
+          relativePurposePath: path.relative(rootDir, purposePath),
+          components,
+          content
+        });
+      }
+    }
+    for (const entry of entries) {
+      if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+        scanDir(path.join(dir, entry.name), depth + 1);
+      }
+    }
+  }
+  scanDir(rootDir, 0);
+  return suggestions;
+}
+function generatePurposeDraft(dirName, components) {
+  const lines = [
+    `description: "Components in ${dirName}"`,
+    "",
+    "components:"
+  ];
+  for (const comp of components) {
+    lines.push(`  ${comp}:`);
+    lines.push(`    description: "TODO: describe #${comp}"`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
 async function lintCommand(targetPath, options) {
   const rootDir = targetPath ? path.resolve(targetPath) : process.cwd();
   const spinner = ora();
@@ -212,6 +300,58 @@ async function lintCommand(targetPath, options) {
   const files = await findPurposeFiles(rootDir);
   spinner.stop();
   log.operation("find-files").debug("Purpose files found", { count: files.length });
+  if (options.autoPopulate) {
+    spinner.start("Scanning for undocumented source directories...");
+    const suggestions = findUndocumentedDirs(rootDir, files);
+    spinner.stop();
+    if (suggestions.length === 0) {
+      if (!options.quiet && !options.json) {
+        console.log(chalk.green("All source directories have .purpose coverage.\n"));
+      }
+      if (options.json) {
+        console.log(JSON.stringify({ suggestions: [], populated: 0 }));
+      }
+      return;
+    }
+    if (options.json) {
+      const populated = options.fix ? suggestions.length : 0;
+      if (options.fix) {
+        for (const s of suggestions) {
+          fs.writeFileSync(s.purposePath, s.content, "utf8");
+        }
+      }
+      console.log(JSON.stringify({
+        suggestions: suggestions.map((s) => ({
+          dir: s.relativeDir,
+          purposePath: s.relativePurposePath,
+          components: s.components
+        })),
+        populated
+      }));
+      return;
+    }
+    console.log(chalk.yellow(`Found ${suggestions.length} source director${suggestions.length > 1 ? "ies" : "y"} without .purpose files:
+`));
+    for (const s of suggestions) {
+      console.log(`  ${chalk.cyan(s.relativeDir)}/`);
+      for (const comp of s.components) {
+        console.log(chalk.gray(`    #${comp}`));
+      }
+      if (options.fix) {
+        fs.writeFileSync(s.purposePath, s.content, "utf8");
+        console.log(chalk.green(`    \u2192 Created ${s.relativePurposePath}`));
+      }
+      console.log("");
+    }
+    if (!options.fix) {
+      console.log(chalk.gray(`Run ${chalk.cyan("paradigm lint --auto-populate --fix")} to create these .purpose files.
+`));
+    } else {
+      console.log(chalk.green(`Created ${suggestions.length} .purpose file${suggestions.length > 1 ? "s" : ""}.
+`));
+    }
+    return;
+  }
   if (files.length === 0) {
     if (options.json) {
       console.log(JSON.stringify({ files: [], summary: { totalFiles: 0 } }));

package/dist/{list-R3QWW4SC.js → list-JKBJ7ESH.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   loadLoreEntries
-} from "./chunk-MVXJVRFI.js";
+} from "./chunk-5TUAVVIG.js";
 import "./chunk-MO4EEYFW.js";
 
 // src/commands/lore/list.ts