@a-company/paradigm 5.11.0 → 5.21.0

package/dist/lint-K6CJGGPH.js

@@ -1,456 +0,0 @@
-#!/usr/bin/env node
-import {
-  findPurposeFiles,
-  parsePurposeFileDetailed,
-  serializePurposeFile,
-  validatePurposeFile
-} from "./chunk-EDOAWN7J.js";
-import {
-  log
-} from "./chunk-4NCFWYGG.js";
-import "./chunk-PDX44BCA.js";
-
-// src/commands/lint.ts
-import * as fs from "fs";
-import * as path from "path";
-import chalk from "chalk";
-import ora from "ora";
-function getSuggestion(error) {
-  const msg = error.message.toLowerCase();
-  if (msg.includes("expected object, received array") && error.path?.includes("features")) {
-    return 'Convert to object format: features: { feature-name: { description: "..." } }';
-  }
-  if (msg.includes("expected object, received array") && error.path?.includes("components")) {
-    return 'Convert to object format: components: { component-name: { description: "..." } }';
-  }
-  if (msg.includes("has no description")) {
-    return "Add a description field to help AI understand this item";
-  }
-  if (msg.includes("should use alphanumeric")) {
-    return "Use kebab-case: my-feature-name (lowercase, hyphens)";
-  }
-  if (msg.includes("references unknown")) {
-    return "Define the symbol in a .purpose file or remove the reference";
-  }
-  if (msg.includes("yaml syntax") || msg.includes("bad indentation")) {
-    return "Check indentation (use 2 spaces) and YAML syntax";
-  }
-  return void 0;
-}
-function isMarkdownFormat(content) {
-  const lines = content.trim().split("\n");
-  const hasMarkdownHeader = lines.some((l) => /^#+\s/.test(l));
-  const hasNoYamlStructure = !content.includes(":") || lines[0].startsWith("#") || lines[0].startsWith("@");
-  return hasMarkdownHeader || hasNoYamlStructure && !content.trim().startsWith("---");
-}
-function convertMarkdownToYaml(content, filePath) {
-  const lines = content.trim().split("\n");
-  const dirName = path.basename(path.dirname(filePath));
-  let description = "";
-  for (const line of lines) {
-    if (!line.startsWith("#") && !line.startsWith("@") && line.trim()) {
-      description = line.trim();
-      break;
-    }
-    if (line.startsWith("#")) {
-      description = line.replace(/^#+\s*/, "").trim();
-    }
-  }
-  return `# Auto-converted from markdown format
-description: "${description || `Purpose file for ${dirName}`}"
-
-# TODO: Add features and components
-# features:
-#   feature-name:
-#     description: "What this feature does"
-
-# components:
-#   component-name:
-#     description: "What this component does"
-`;
-}
-function autoQuoteSpecialChars(content) {
-  return content.replace(
-    /\[\s*([^\]]+)\s*\]/g,
-    (_match, arrayContent) => {
-      const items = arrayContent.split(",").map((item) => {
-        const trimmed = item.trim();
-        if (/^[#@$^!%]/.test(trimmed) && !trimmed.startsWith('"') && !trimmed.startsWith("'")) {
-          return `"${trimmed}"`;
-        }
-        return trimmed;
-      });
-      return `[${items.join(", ")}]`;
-    }
-  );
-}
-function attemptFix(filePath, errors) {
-  try {
-    let content = fs.readFileSync(filePath, "utf8");
-    let modified = false;
-    if (isMarkdownFormat(content)) {
-      content = convertMarkdownToYaml(content, filePath);
-      modified = true;
-    }
-    const hasUnquotedSymbols = errors.some(
-      (e) => e.message.includes("tag suffix") || e.message.includes("flow indicator") || e.message.includes("missed comma")
-    );
-    if (hasUnquotedSymbols || content.match(/\[[^\]]*[#@$^!%][^\]"']*\]/)) {
-      const quoted = autoQuoteSpecialChars(content);
-      if (quoted !== content) {
-        content = quoted;
-        modified = true;
-      }
-    }
-    if (modified) {
-      const tempPath = filePath + ".tmp";
-      fs.writeFileSync(tempPath, content);
-      const result2 = parsePurposeFileDetailed(tempPath);
-      fs.unlinkSync(tempPath);
-      if (result2.isYamlValid && result2.data) {
-        return serializePurposeFile(result2.data);
-      }
-      return content;
-    }
-    const result = parsePurposeFileDetailed(filePath);
-    if (result.isYamlValid && result.data) {
-      const fixed = serializePurposeFile(result.data);
-      if (fixed.trim() !== content.trim()) {
-        return fixed;
-      }
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function lintFile(filePath, rootDir, options) {
-  const relativePath = path.relative(rootDir, filePath);
-  const errors = [];
-  const warnings = [];
-  let fixed = false;
-  const parseResult = parsePurposeFileDetailed(filePath);
-  for (const error of parseResult.detailedErrors || []) {
-    const issue = {
-      message: error.message,
-      line: error.line,
-      path: error.path,
-      type: error.type === "yaml" || error.type === "file" ? "error" : "error",
-      suggestion: getSuggestion(error),
-      fixable: error.type === "schema"
-      // Schema errors might be fixable
-    };
-    errors.push(issue);
-  }
-  if (parseResult.data) {
-    const validationResult = validatePurposeFile(parseResult.data, relativePath);
-    for (const issue of validationResult.issues) {
-      const lintIssue = {
-        message: issue.message,
-        path: issue.path,
-        type: issue.type,
-        suggestion: getSuggestion(issue),
-        fixable: false
-      };
-      if (issue.type === "error") {
-        errors.push(lintIssue);
-      } else {
-        warnings.push(lintIssue);
-      }
-    }
-  }
-  if (options.fix && errors.length > 0) {
-    const fixedContent = attemptFix(filePath, errors);
-    if (fixedContent) {
-      fs.writeFileSync(filePath, fixedContent);
-      fixed = true;
-      const reparse = parsePurposeFileDetailed(filePath);
-      if (reparse.detailedErrors && reparse.detailedErrors.length < errors.length) {
-        errors.length = 0;
-        warnings.length = 0;
-        for (const error of reparse.detailedErrors || []) {
-          errors.push({
-            message: error.message,
-            line: error.line,
-            path: error.path,
-            type: "error",
-            suggestion: getSuggestion(error)
-          });
-        }
-      }
-    }
-  }
-  const valid = errors.length === 0 && (!options.strict || warnings.length === 0);
-  return {
-    path: filePath,
-    relativePath,
-    valid,
-    errors,
-    warnings,
-    fixed
-  };
-}
-function formatIssue(issue, indent = "  ") {
-  const lines = [];
-  const icon = issue.type === "error" ? chalk.red("\u2717") : chalk.yellow("\u26A0");
-  const lineInfo = issue.line ? chalk.gray(` (line ${issue.line})`) : "";
-  const pathInfo = issue.path ? chalk.gray(` at ${issue.path}`) : "";
-  lines.push(`${indent}${icon} ${issue.message}${lineInfo}${pathInfo}`);
-  if (issue.suggestion) {
-    lines.push(`${indent}  ${chalk.cyan("\u2192")} ${chalk.gray(issue.suggestion)}`);
-  }
-  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();
-  if (!options.quiet && !options.json) {
-    console.log(chalk.blue("\n\u{1F50D} Paradigm Lint\n"));
-  }
-  const tracker = log.command("lint").start("Linting purpose files", { fix: !!options.fix });
-  spinner.start("Finding .purpose files...");
-  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 } }));
-    } else if (!options.quiet) {
-      console.log(chalk.yellow("No .purpose files found.\n"));
-      console.log(chalk.gray("Run `paradigm init` to create your first .purpose file.\n"));
-    }
-    return;
-  }
-  if (!options.quiet && !options.json) {
-    console.log(chalk.gray(`Checking ${files.length} .purpose file${files.length > 1 ? "s" : ""}...
-`));
-  }
-  const results = [];
-  for (const file of files) {
-    const result = lintFile(file, rootDir, options);
-    results.push(result);
-    if (!options.quiet && !options.json) {
-      if (!result.valid || result.errors.length > 0 || result.warnings.length > 0) {
-        const icon = result.errors.length > 0 ? chalk.red("\u2717") : result.warnings.length > 0 ? chalk.yellow("\u26A0") : chalk.green("\u2713");
-        const fixedBadge = result.fixed ? chalk.cyan(" [fixed]") : "";
-        console.log(`${icon} ${result.relativePath}${fixedBadge}`);
-        for (const error of result.errors) {
-          for (const line of formatIssue(error)) {
-            console.log(line);
-          }
-        }
-        for (const warning of result.warnings) {
-          for (const line of formatIssue(warning)) {
-            console.log(line);
-          }
-        }
-        console.log("");
-      }
-    }
-  }
-  const summary = {
-    totalFiles: results.length,
-    validFiles: results.filter((r) => r.valid).length,
-    filesWithErrors: results.filter((r) => r.errors.length > 0).length,
-    filesWithWarnings: results.filter((r) => r.warnings.length > 0).length,
-    totalErrors: results.reduce((sum, r) => sum + r.errors.length, 0),
-    totalWarnings: results.reduce((sum, r) => sum + r.warnings.length, 0),
-    fixedFiles: results.filter((r) => r.fixed).length
-  };
-  if (options.json) {
-    const output = {
-      files: results.map((r) => ({
-        path: r.relativePath,
-        valid: r.valid,
-        errors: r.errors,
-        warnings: r.warnings,
-        fixed: r.fixed
-      })),
-      summary
-    };
-    console.log(JSON.stringify(output, null, 2));
-    process.exit(summary.filesWithErrors > 0 ? 1 : 0);
-    return;
-  }
-  if (!options.quiet) {
-    console.log(chalk.gray("\u2500".repeat(40)));
-    if (summary.totalErrors === 0 && summary.totalWarnings === 0) {
-      console.log(chalk.green(`
-\u2713 All ${summary.totalFiles} file${summary.totalFiles > 1 ? "s" : ""} valid
-`));
-      tracker.success("All files valid", { files: summary.totalFiles });
-    } else {
-      tracker.error("Files have issues", {
-        errors: summary.totalErrors,
-        warnings: summary.totalWarnings,
-        fixed: summary.fixedFiles
-      });
-      console.log("");
-      if (summary.validFiles > 0) {
-        console.log(chalk.green(`\u2713 ${summary.validFiles} file${summary.validFiles > 1 ? "s" : ""} valid`));
-      }
-      if (summary.filesWithErrors > 0) {
-        console.log(chalk.red(`\u2717 ${summary.filesWithErrors} file${summary.filesWithErrors > 1 ? "s" : ""} with errors (${summary.totalErrors} total)`));
-      }
-      if (summary.filesWithWarnings > 0) {
-        console.log(chalk.yellow(`\u26A0 ${summary.filesWithWarnings} file${summary.filesWithWarnings > 1 ? "s" : ""} with warnings (${summary.totalWarnings} total)`));
-      }
-      if (summary.fixedFiles > 0) {
-        console.log(chalk.cyan(`\u21BB ${summary.fixedFiles} file${summary.fixedFiles > 1 ? "s" : ""} auto-fixed`));
-      }
-      console.log("");
-      if (summary.totalErrors > 0 && !options.fix) {
-        console.log(chalk.gray("Run `paradigm lint --fix` to auto-fix where possible.\n"));
-      }
-    }
-  }
-  if (summary.filesWithErrors > 0) {
-    process.exit(1);
-  }
-  if (options.strict && summary.filesWithWarnings > 0) {
-    process.exit(1);
-  }
-}
-export {
-  lintCommand
-};

package/dist/list-4YK7QKFF.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-import {
-  loadUniversityIndex,
-  searchContent
-} from "./chunk-GT5QGC2H.js";
-import "./chunk-PDX44BCA.js";
-
-// src/commands/university/list.ts
-import chalk from "chalk";
-async function universityListCommand(options) {
-  const rootDir = process.cwd();
-  const index = loadUniversityIndex(rootDir);
-  if (!index || index.totalContent === 0) {
-    console.log(chalk.yellow("\n  No university content found."));
-    console.log(chalk.gray('  Create content with: paradigm university add note --title "My Note"\n'));
-    return;
-  }
-  const results = searchContent(rootDir, {
-    type: options.type,
-    tag: options.tag,
-    difficulty: options.difficulty,
-    symbol: options.symbol,
-    limit: options.limit ? parseInt(options.limit, 10) : 20
-  });
-  if (options.json) {
-    console.log(JSON.stringify(results, null, 2));
-    return;
-  }
-  console.log(chalk.blue(`
-  University Content (${results.length} of ${index.totalContent})
-`));
-  const typeIcons = {
-    note: "N",
-    policy: "P",
-    guide: "N",
-    runbook: "N",
-    quiz: "Q",
-    path: "LP"
-  };
-  for (const entry of results) {
-    const icon = typeIcons[entry.type] || "?";
-    const diffColor = entry.difficulty === "advanced" ? chalk.red : entry.difficulty === "intermediate" ? chalk.yellow : chalk.green;
-    const tags = entry.tags.length > 0 ? chalk.gray(` [${entry.tags.join(", ")}]`) : "";
-    console.log(`  ${chalk.cyan(icon)} ${chalk.white(entry.id)} \u2014 ${entry.title}${tags}`);
-    if (entry.difficulty) {
-      console.log(`    ${diffColor(entry.difficulty)} \xB7 ${entry.author} \xB7 ${entry.updated || entry.created}`);
-    }
-  }
-  if (index.diplomaCount > 0) {
-    console.log(chalk.gray(`
-  ${index.diplomaCount} diploma${index.diplomaCount > 1 ? "s" : ""} earned`));
-  }
-  console.log();
-}
-export {
-  universityListCommand
-};

package/dist/list-ENR7Q4CR.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-import {
-  loadLoreEntries
-} from "./chunk-EKGMAM62.js";
-import "./chunk-PDX44BCA.js";
-
-// src/commands/lore/list.ts
-import chalk from "chalk";
-async function loreListCommand(options) {
-  const rootDir = process.cwd();
-  const filter = {};
-  if (options.author) filter.author = options.author;
-  if (options.type) filter.type = options.type;
-  if (options.symbol) filter.symbol = options.symbol;
-  if (options.tags) filter.tags = options.tags.split(",");
-  if (options.from) filter.dateFrom = options.from;
-  if (options.to) filter.dateTo = options.to;
-  filter.limit = parseInt(options.limit || "20", 10);
-  const entries = await loadLoreEntries(rootDir, filter);
-  if (options.json) {
-    console.log(JSON.stringify(entries, null, 2));
-    return;
-  }
-  if (entries.length === 0) {
-    console.log(chalk.gray("\nNo lore entries found.\n"));
-    console.log(chalk.gray("Record one with: paradigm lore record"));
-    return;
-  }
-  console.log(chalk.cyan(`
-  Lore Entries (${entries.length})
-`));
-  const typeColor = {
-    "agent-session": chalk.hex("#818cf8"),
-    "human-note": chalk.hex("#34d399"),
-    "decision": chalk.hex("#fbbf24"),
-    "review": chalk.hex("#c084fc"),
-    "incident": chalk.hex("#f87171"),
-    "milestone": chalk.hex("#60a5fa")
-  };
-  for (const entry of entries) {
-    const entryType = entry.type || "note";
-    const colorFn = typeColor[entryType] || chalk.white;
-    const date = new Date(entry.timestamp);
-    const dateStr = date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-    const timeStr = date.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" });
-    const authorIcon = entry.agent ? "\u{1F916}" : "\u{1F464}";
-    const verifyIcon = entry.verification?.status === "pass" ? chalk.green("\u2713") : entry.verification?.status === "fail" ? chalk.red("\u2717") : entry.verification?.status === "partial" ? chalk.yellow("\u26A0") : chalk.gray("\xB7");
-    const reviewStr = entry.review ? chalk.yellow("\u2605".repeat(entry.review.quality) + "\u2606".repeat(5 - entry.review.quality)) : "";
-    console.log(`  ${chalk.gray(entry.id)} ${colorFn(entryType.padEnd(14))} ${verifyIcon} ${chalk.white(entry.title)}`);
-    console.log(`  ${chalk.gray(dateStr + " " + timeStr)}  ${authorIcon} ${chalk.gray(entry.author)}  ${(entry.symbols_touched || []).map((s) => chalk.cyan(s)).join(" ")} ${reviewStr}`);
-    console.log();
-  }
-}
-export {
-  loreListCommand
-};

package/dist/lore-loader-7NO6N6FT.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import {
-  addLoreAssessment,
-  addLoreReview,
-  deleteLoreEntry,
-  init_lore_loader,
-  loadLoreEntries,
-  loadLoreEntry,
-  loadLoreTimeline,
-  rebuildTimeline,
-  recordLoreEntry,
-  updateLoreEntry
-} from "./chunk-5VKJBNJL.js";
-import "./chunk-7N7GSU6K.js";
-init_lore_loader();
-export {
-  addLoreAssessment,
-  addLoreReview,
-  deleteLoreEntry,
-  loadLoreEntries,
-  loadLoreEntry,
-  loadLoreTimeline,
-  rebuildTimeline,
-  recordLoreEntry,
-  updateLoreEntry
-};