@a-company/paradigm 5.11.0 → 5.21.0

package/dist/chunk-YMDLDELF.js

@@ -1,314 +0,0 @@
-#!/usr/bin/env node
-
-// src/core/portal-compliance.ts
-import * as fs from "fs";
-import * as path from "path";
-import * as yaml from "js-yaml";
-import { execFileSync } from "child_process";
-var SKIP_DIRECTORIES = [
-  "node_modules",
-  ".git",
-  "dist",
-  "build",
-  "coverage",
-  ".paradigm",
-  "vendor",
-  "__pycache__",
-  ".next",
-  "target"
-];
-function loadPortalConfig(rootDir) {
-  const portalPath = path.join(rootDir, "portal.yaml");
-  if (!fs.existsSync(portalPath)) {
-    return null;
-  }
-  try {
-    const content = fs.readFileSync(portalPath, "utf-8");
-    return yaml.load(content);
-  } catch {
-    return null;
-  }
-}
-function extractDeclaredGates(config) {
-  const gates = /* @__PURE__ */ new Set();
-  if (config.gates) {
-    for (const key of Object.keys(config.gates)) {
-      const gateName = key.startsWith("^") ? key.slice(1) : key;
-      gates.add(gateName);
-    }
-  }
-  if (config.routes) {
-    for (const routeConfig of Object.values(config.routes)) {
-      const gateList = Array.isArray(routeConfig) ? routeConfig : routeConfig.gates || [];
-      for (const gate of gateList) {
-        const gateName = gate.startsWith("^") ? gate.slice(1) : gate;
-        gates.add(gateName);
-      }
-    }
-  }
-  return Array.from(gates);
-}
-function extractRouteAttachedGates(config) {
-  const gates = /* @__PURE__ */ new Set();
-  if (config.routes) {
-    for (const routeConfig of Object.values(config.routes)) {
-      const gateList = Array.isArray(routeConfig) ? routeConfig : routeConfig.gates || [];
-      for (const gate of gateList) {
-        const gateName = gate.startsWith("^") ? gate.slice(1) : gate;
-        gates.add(gateName);
-      }
-    }
-  }
-  return gates;
-}
-function runGrep(rootDir, pattern) {
-  const options = {
-    encoding: "utf-8",
-    maxBuffer: 10 * 1024 * 1024,
-    stdio: ["ignore", "pipe", "pipe"]
-  };
-  try {
-    const globArgs = SKIP_DIRECTORIES.flatMap((d) => ["--glob", `!${d}/**`]);
-    const rgArgs = ["-n", "--no-ignore-vcs", ...globArgs, "--engine", "auto", pattern, rootDir];
-    return execFileSync("rg", rgArgs, options);
-  } catch {
-  }
-  const skipDirArgs = SKIP_DIRECTORIES.map((d) => `--exclude-dir=${d}`);
-  const grepArgs = ["-rn", ...skipDirArgs, "-E", pattern, "--", rootDir];
-  try {
-    return execFileSync("grep", grepArgs, options);
-  } catch (err) {
-    const code = err?.code;
-    if (code === 1 || err?.status === 1) {
-      return "";
-    }
-    return "";
-  }
-}
-function findGateReferences(rootDir) {
-  const references = [];
-  const symbolPattern = "\\^[a-zA-Z][a-zA-Z0-9_-]+";
-  const symbolResult = runGrep(rootDir, symbolPattern);
-  for (const line of symbolResult.split("\n").filter(Boolean)) {
-    const match = line.match(/^(.+?):(\d+):(.*)$/);
-    if (match) {
-      const [, file, lineNum, context] = match;
-      const gateMatch = context.match(/\^([a-zA-Z][a-zA-Z0-9_-]+)/);
-      if (gateMatch) {
-        references.push({
-          gate: gateMatch[1],
-          file: path.relative(rootDir, file),
-          line: parseInt(lineNum, 10),
-          context: context.trim().slice(0, 100),
-          matchType: "symbol"
-        });
-      }
-    }
-  }
-  const functionPatterns = [
-    { pattern: `checkGate\\s*\\(['"]([^'"]+)['"]`, type: "function" },
-    { pattern: `requireGate\\s*\\(['"]([^'"]+)['"]`, type: "function" },
-    { pattern: `gate:\\s*['"]([^'"]+)['"]`, type: "config" },
-    { pattern: `@Gate\\s*\\(['"]?([^'"\\)]+)['"]?\\)`, type: "function" }
-  ];
-  for (const { pattern, type } of functionPatterns) {
-    const result = runGrep(rootDir, pattern);
-    for (const line of result.split("\n").filter(Boolean)) {
-      const match = line.match(/^(.+?):(\d+):(.*)$/);
-      if (match) {
-        const [, file, lineNum, context] = match;
-        const gateMatch = context.match(new RegExp(pattern));
-        if (gateMatch && gateMatch[1]) {
-          const gateName = gateMatch[1].startsWith("^") ? gateMatch[1].slice(1) : gateMatch[1];
-          references.push({
-            gate: gateName,
-            file: path.relative(rootDir, file),
-            line: parseInt(lineNum, 10),
-            context: context.trim().slice(0, 100),
-            matchType: type
-          });
-        }
-      }
-    }
-  }
-  return references;
-}
-function extractUniqueGates(references) {
-  return [...new Set(references.map((r) => r.gate))];
-}
-async function checkPortalCompliance(rootDir) {
-  const config = loadPortalConfig(rootDir);
-  if (!config) {
-    const references2 = findGateReferences(rootDir);
-    const usedGates2 = extractUniqueGates(references2);
-    if (usedGates2.length === 0) {
-      return {
-        status: "compliant",
-        declaredButUnused: [],
-        routeAttachedUnused: [],
-        orphanUnused: [],
-        usedButUndeclared: [],
-        properlyDeclared: [],
-        suggestions: ["No portal.yaml found, and no gate references detected in code."],
-        references: []
-      };
-    }
-    return {
-      status: "violations",
-      declaredButUnused: [],
-      routeAttachedUnused: [],
-      orphanUnused: [],
-      usedButUndeclared: usedGates2,
-      properlyDeclared: [],
-      suggestions: [
-        "Gate references found in code but no portal.yaml exists.",
-        "Create a portal.yaml file to declare these gates:",
-        ...usedGates2.map((g) => `  - ^${g}`),
-        "",
-        "Run: paradigm portal init"
-      ],
-      references: references2
-    };
-  }
-  const declaredGates = extractDeclaredGates(config);
-  const routeAttachedGates = extractRouteAttachedGates(config);
-  const references = findGateReferences(rootDir);
-  const usedGates = extractUniqueGates(references);
-  const declaredSet = new Set(declaredGates);
-  const usedSet = new Set(usedGates);
-  const declaredButUnused = declaredGates.filter((g) => !usedSet.has(g));
-  const routeAttachedUnused = declaredButUnused.filter((g) => routeAttachedGates.has(g));
-  const orphanUnused = declaredButUnused.filter((g) => !routeAttachedGates.has(g));
-  const usedButUndeclared = usedGates.filter((g) => !declaredSet.has(g));
-  const properlyDeclared = declaredGates.filter((g) => usedSet.has(g));
-  const suggestions = [];
-  if (routeAttachedUnused.length > 0) {
-    suggestions.push("Gates documented on routes but no checkGate/requireGate in code:");
-    for (const gate of routeAttachedUnused) {
-      suggestions.push(`  - ^${gate} (documented on routes; if enforced by middleware, this may be intentional)`);
-    }
-    suggestions.push("");
-  }
-  if (orphanUnused.length > 0) {
-    suggestions.push("Orphan gates (declared but never on a route or in code):");
-    for (const gate of orphanUnused) {
-      suggestions.push(`  - ^${gate} (add to a route or remove from portal.yaml)`);
-    }
-    suggestions.push("");
-  }
-  if (usedButUndeclared.length > 0) {
-    suggestions.push("Gates used in code but not declared in portal.yaml:");
-    for (const gate of usedButUndeclared) {
-      suggestions.push(`  - ^${gate} (add to portal.yaml with proper definition)`);
-    }
-    suggestions.push("");
-  }
-  let status = "compliant";
-  if (usedButUndeclared.length > 0) {
-    status = "violations";
-  } else if (declaredButUnused.length > 0) {
-    status = "warnings";
-  }
-  return {
-    status,
-    declaredButUnused,
-    routeAttachedUnused,
-    orphanUnused,
-    usedButUndeclared,
-    properlyDeclared,
-    suggestions,
-    references
-  };
-}
-function formatComplianceReport(report) {
-  const lines = [];
-  const statusIcon = report.status === "compliant" ? "\u2713" : report.status === "warnings" ? "\u26A0" : "\u2717";
-  lines.push(`Portal Compliance: ${statusIcon} ${report.status.toUpperCase()}`);
-  lines.push("");
-  lines.push(`Properly Declared: ${report.properlyDeclared.length}`);
-  if (report.routeAttachedUnused.length > 0) {
-    lines.push(`Route-Attached, No Code: ${report.routeAttachedUnused.length}`);
-  }
-  if (report.orphanUnused.length > 0) {
-    lines.push(`Orphan Gates: ${report.orphanUnused.length}`);
-  }
-  if (report.usedButUndeclared.length > 0) {
-    lines.push(`Used but Undeclared: ${report.usedButUndeclared.length}`);
-  }
-  lines.push("");
-  if (report.properlyDeclared.length > 0) {
-    lines.push("Gates in Use:");
-    for (const gate of report.properlyDeclared) {
-      lines.push(`  \u2713 ^${gate}`);
-    }
-    lines.push("");
-  }
-  if (report.routeAttachedUnused.length > 0) {
-    lines.push("Route-Attached (no checkGate/requireGate in code):");
-    for (const gate of report.routeAttachedUnused) {
-      lines.push(`  \u26A0 ^${gate}`);
-    }
-    lines.push("");
-  }
-  if (report.orphanUnused.length > 0) {
-    lines.push("Orphan Gates (declared but never on route or in code):");
-    for (const gate of report.orphanUnused) {
-      lines.push(`  \u26A0 ^${gate}`);
-    }
-    lines.push("");
-  }
-  if (report.usedButUndeclared.length > 0) {
-    lines.push("Undeclared Gates (used but not in portal.yaml):");
-    for (const gate of report.usedButUndeclared) {
-      lines.push(`  \u2717 ^${gate}`);
-      const refs = report.references.filter((r) => r.gate === gate).slice(0, 3);
-      for (const ref of refs) {
-        lines.push(`      at ${ref.file}:${ref.line}`);
-      }
-    }
-    lines.push("");
-  }
-  if (report.suggestions.length > 0 && report.status !== "compliant") {
-    lines.push("Suggestions:");
-    for (const suggestion of report.suggestions) {
-      if (suggestion) {
-        lines.push(`  ${suggestion}`);
-      }
-    }
-  }
-  return lines.join("\n");
-}
-function getComplianceSummary(report) {
-  if (report.status === "compliant") {
-    return {
-      status: "ok",
-      message: `${report.properlyDeclared.length} gates properly declared`
-    };
-  }
-  if (report.status === "warnings") {
-    const parts = [];
-    if (report.routeAttachedUnused.length > 0) {
-      parts.push(`${report.routeAttachedUnused.length} route-attached`);
-    }
-    if (report.orphanUnused.length > 0) {
-      parts.push(`${report.orphanUnused.length} orphan`);
-    }
-    return {
-      status: "warn",
-      message: parts.length > 0 ? parts.join(", ") + " gate(s)" : `${report.declaredButUnused.length} unused gates`
-    };
-  }
-  return {
-    status: "error",
-    message: `${report.usedButUndeclared.length} gates used but not declared`
-  };
-}
-
-export {
-  loadPortalConfig,
-  extractDeclaredGates,
-  findGateReferences,
-  checkPortalCompliance,
-  formatComplianceReport,
-  getComplianceSummary
-};

package/dist/chunk-YO6DVTL7.js

@@ -1,99 +0,0 @@
-#!/usr/bin/env node
-
-// src/core/paradigm-config.ts
-import * as yaml from "js-yaml";
-var DEFAULT_SYMBOL_SYSTEM = {
-  "#": {
-    name: "Component",
-    description: "Any documented code unit",
-    owner: "purpose",
-    examples: ["#Button", "#api-client", "#AuthProvider"]
-  },
-  "$": {
-    name: "Flow",
-    description: "Multi-step processes or user journeys",
-    owner: "shared",
-    examples: ["$checkout-flow", "$auth-flow"]
-  },
-  "^": {
-    name: "Gate",
-    description: "Authorization checkpoints",
-    owner: "portal",
-    examples: ["^authenticated", "^admin-only", "^resource-owner"]
-  },
-  "!": {
-    name: "Signal",
-    description: "Events for side effects",
-    owner: "portal",
-    examples: ["!payment-completed", "!login-failed", "!rate-limited"]
-  },
-  "~": {
-    name: "Aspect",
-    description: "Rules with required code anchors",
-    owner: "purpose",
-    examples: ["~audit-required", "~rate-limited", "~cache-invalidation"]
-  }
-};
-var DEFAULT_CONVENTIONS = [
-  "Use kebab-case for all symbol IDs (feature-name, not featureName)",
-  "Document flows when logic spans 3+ components",
-  "Reference related items using symbol prefixes (@ # $ % ~ ^ ! ?)",
-  "Add descriptions to all features and gates",
-  "Update .purpose files when changing feature behavior",
-  "Keep gates minimal - one responsibility per gate",
-  "Use signals for side effects, not direct state mutations"
-];
-function getDefaultParadigmConfig(projectName) {
-  return {
-    version: "1.0",
-    "agent-guidelines": {
-      overview: `${projectName} uses Paradigm for structured planning and context management.`,
-      "how-to-use": [
-        "Check .purpose files in directories for context before making changes",
-        "Run `paradigm status` to see the project symbol index",
-        "Run `paradigm visualize` to explore the Dreamscape",
-        "Reference symbols using prefixes: @feature #component ^gate",
-        'Attach an image and say "paradigm scan" to map UI to code'
-      ],
-      "update-rules": [
-        "When adding a feature, create/update the nearest .purpose file",
-        "When adding authorization, update portal.yaml",
-        "When exploring ideas, add to .premise or use ?symbol prefix",
-        "Always update references when renaming symbols"
-      ]
-    },
-    "symbol-system": DEFAULT_SYMBOL_SYSTEM,
-    states: {
-      user: {
-        authenticated: { type: "boolean", default: false, description: "User is logged in" },
-        role: { type: "enum", values: ["guest", "user", "admin"], description: "User access level" }
-      },
-      app: {
-        loading: { type: "boolean", default: false, description: "App is loading" }
-      }
-    },
-    "purpose-required": [
-      { pattern: "src/features/*", depth: 1 },
-      { pattern: "src/components/*", depth: 1 }
-    ],
-    conventions: DEFAULT_CONVENTIONS,
-    scan: {
-      enabled: true,
-      autoInclude: true
-    }
-  };
-}
-function serializeParadigmConfig(config) {
-  return yaml.dump(config, { lineWidth: -1, quotingType: '"' });
-}
-function parseParadigmConfig(content) {
-  return yaml.load(content);
-}
-
-export {
-  DEFAULT_SYMBOL_SYSTEM,
-  DEFAULT_CONVENTIONS,
-  getDefaultParadigmConfig,
-  serializeParadigmConfig,
-  parseParadigmConfig
-};