@a-company/paradigm 3.1.5 → 3.5.0

package/dist/{setup-DF4F3ICN.js → setup-363IB6MO.js}

@@ -9,7 +9,7 @@ import {
   mcpSetupCommand,
   mcpStatusCommand,
   writeConfig
-} from "./chunk-MC7XC7XQ.js";
+} from "./chunk-GZDFVP2N.js";
 import "./chunk-4NCFWYGG.js";
 import "./chunk-MO4EEYFW.js";
 export {

package/dist/{setup-JHBPZAG7.js → setup-UKJ3VGHI.js}

@@ -2,14 +2,14 @@
 import {
   cursorrrulesExists,
   writeCursorrules
-} from "./chunk-UUZ2DMG5.js";
-import "./chunk-N6PJAPDE.js";
+} from "./chunk-KWDTBXP2.js";
+import "./chunk-AK5M6KJB.js";
 import {
   getDefaultPremiseContent
-} from "./chunk-5C4SGQKH.js";
+} from "./chunk-6P4IFIK2.js";
 import {
   getDefaultPurposeContent
-} from "./chunk-PW2EXJQT.js";
+} from "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import {
   DEFAULT_CONVENTIONS,

package/dist/{shift-2LQFQP4P.js → shift-KDVYB6CR.js}

@@ -1,36 +1,39 @@
 #!/usr/bin/env node
 import {
   teamInitCommand
-} from "./chunk-UM54F7G5.js";
-import "./chunk-AD2LSCHB.js";
+} from "./chunk-4N6AYEEA.js";
+import "./chunk-Y4XZWCHK.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-WS5KM7OL.js";
+import "./chunk-HPC3JAUP.js";
+import "./chunk-6RNYVBSG.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-TAP5N3HH.js";
+import "./chunk-CCG6KYBT.js";
 import {
   agentsConfigured
 } from "./chunk-PMXRGPRQ.js";
 import {
   hooksInstallCommand
-} from "./chunk-DRUDZKIT.js";
+} from "./chunk-M2XMTJHQ.js";
 import {
-  indexCommand,
   initCommand
-} from "./chunk-GWM2WRXL.js";
+} from "./chunk-IRVA7NKV.js";
+import {
+  indexCommand
+} from "./chunk-UI3XXVJ6.js";
 import {
   detectDiscipline
 } from "./chunk-CHSHON3O.js";
-import "./chunk-N6PJAPDE.js";
-import "./chunk-5C4SGQKH.js";
-import "./chunk-PW2EXJQT.js";
+import "./chunk-AK5M6KJB.js";
+import "./chunk-6P4IFIK2.js";
+import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import {
   syncCommand
-} from "./chunk-QS36NGWV.js";
+} from "./chunk-QHJGB5TV.js";
 import {
   doctorCommand
-} from "./chunk-ZPN7MXRA.js";
-import "./chunk-YCLN7WXV.js";
+} from "./chunk-KFHK6EBI.js";
+import "./chunk-2QNZ6PVD.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{show-WTOJXUTN.js → show-SAMTXEHG.js}

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

package/dist/{snapshot-GTVPRYZG.js → snapshot-KCMONZAO.js}

@@ -3,8 +3,8 @@ import {
   createSnapshot,
   parsePremiseFile,
   serializePremiseFile
-} from "./chunk-5C4SGQKH.js";
-import "./chunk-PW2EXJQT.js";
+} from "./chunk-6P4IFIK2.js";
+import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import "./chunk-MO4EEYFW.js";
 

package/dist/{spawn-BJRQA2NR.js → spawn-EO7B2UM3.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   AgentSpawner
-} from "./chunk-WS5KM7OL.js";
+} from "./chunk-6RNYVBSG.js";
 import "./chunk-PBHIFAL4.js";
 import {
   getBestProvider
-} from "./chunk-TAP5N3HH.js";
+} from "./chunk-CCG6KYBT.js";
 import {
   loadAgentsManifest
 } from "./chunk-PMXRGPRQ.js";

package/dist/{summary-5SBFO7QK.js → summary-E2PU4UN2.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   aggregateFromDirectory
-} from "./chunk-5C4SGQKH.js";
-import "./chunk-PW2EXJQT.js";
+} from "./chunk-6P4IFIK2.js";
+import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import {
   detectIDE,
   getAdapter
-} from "./chunk-YCLN7WXV.js";
+} from "./chunk-2QNZ6PVD.js";
 import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";
 

package/dist/{switch-6EANJ7O6.js → switch-CC2KACXO.js}

@@ -2,7 +2,7 @@
 import {
   detectAllClients,
   getServersFromConfig
-} from "./chunk-MC7XC7XQ.js";
+} from "./chunk-GZDFVP2N.js";
 import "./chunk-4NCFWYGG.js";
 import "./chunk-MO4EEYFW.js";
 

package/dist/{sync-5KSTPJ4B.js → sync-5VJPZQNX.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   syncCommand
-} from "./chunk-QS36NGWV.js";
-import "./chunk-YCLN7WXV.js";
+} from "./chunk-QHJGB5TV.js";
+import "./chunk-2QNZ6PVD.js";
 import "./chunk-4NCFWYGG.js";
 import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";

package/dist/sync-llms-7QDA3ZWC.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import {
+  loadParadigmFiles
+} from "./chunk-2QNZ6PVD.js";
+import {
+  log
+} from "./chunk-4NCFWYGG.js";
+import "./chunk-YO6DVTL7.js";
+import "./chunk-MO4EEYFW.js";
+
+// src/commands/sync-llms.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "js-yaml";
+import chalk from "chalk";
+import ora from "ora";
+async function syncLlmsCommand(options) {
+  const rootDir = process.cwd();
+  const spinner = ora();
+  console.log(chalk.blue("\n  Paradigm Sync LLMs\n"));
+  spinner.start("Loading .paradigm/ configuration...");
+  const files = loadParadigmFiles(rootDir);
+  if (!files) {
+    spinner.fail("No .paradigm/ directory found");
+    console.log(chalk.gray("\nRun `paradigm init` to initialize Paradigm in this project.\n"));
+    log.command("sync-llms").error("Missing .paradigm/ directory");
+    process.exit(1);
+  }
+  spinner.succeed(`Loaded configuration for ${chalk.cyan(files.projectName)}`);
+  log.command("sync-llms").debug("Configuration loaded", { projectName: files.projectName });
+  spinner.start("Reading navigator.yaml...");
+  let navigator = null;
+  const navigatorPath = path.join(rootDir, ".paradigm", "navigator.yaml");
+  if (fs.existsSync(navigatorPath)) {
+    try {
+      const content2 = fs.readFileSync(navigatorPath, "utf8");
+      navigator = yaml.load(content2);
+      spinner.succeed("Loaded navigator.yaml");
+    } catch {
+      spinner.warn("Could not parse navigator.yaml, skipping key files section");
+      log.command("sync-llms").warn("Failed to parse navigator.yaml");
+    }
+  } else {
+    spinner.info("No navigator.yaml found, skipping key files section");
+  }
+  let flows = null;
+  const flowsPath = path.join(rootDir, ".paradigm", "flows.yaml");
+  if (fs.existsSync(flowsPath)) {
+    try {
+      const content2 = fs.readFileSync(flowsPath, "utf8");
+      flows = yaml.load(content2);
+    } catch {
+      log.command("sync-llms").warn("Failed to parse flows.yaml");
+    }
+  }
+  let portal = null;
+  const portalPath = path.join(rootDir, "portal.yaml");
+  if (fs.existsSync(portalPath)) {
+    try {
+      const content2 = fs.readFileSync(portalPath, "utf8");
+      portal = yaml.load(content2);
+    } catch {
+      log.command("sync-llms").warn("Failed to parse portal.yaml");
+    }
+  }
+  spinner.start("Generating llms.txt...");
+  const content = generateLlmsTxt(files, navigator, flows, portal);
+  const outputPath = options.output ? path.resolve(rootDir, options.output) : path.join(rootDir, "llms.txt");
+  try {
+    fs.writeFileSync(outputPath, content, "utf8");
+    spinner.succeed(chalk.green(`Generated llms.txt`));
+    console.log(chalk.gray(`
+  Path: ${path.relative(rootDir, outputPath)}`));
+    console.log("");
+    log.command("sync-llms").success("llms.txt generated", { path: outputPath });
+  } catch (error) {
+    spinner.fail(chalk.red(`Failed to write llms.txt`));
+    log.command("sync-llms").error("Write failed", { error: error.message });
+    process.exit(1);
+  }
+}
+function generateLlmsTxt(files, navigator, flows, portal) {
+  const { config, projectName } = files;
+  const sections = [];
+  sections.push(`# ${config.project || projectName}`);
+  const overview = config["agent-guidelines"]?.overview?.trim();
+  if (overview) {
+    sections.push(`> ${overview.replace(/\n/g, "\n> ")}`);
+  }
+  const symbolSystem = config["symbol-system"];
+  if (symbolSystem) {
+    const symbolLines = ["## Symbols", ""];
+    symbolLines.push("| Prefix | Name | Description |");
+    symbolLines.push("|--------|------|-------------|");
+    for (const [prefix, def] of Object.entries(symbolSystem)) {
+      if (["#", "$", "^", "!", "~"].includes(prefix)) {
+        symbolLines.push(`| \`${prefix}\` | ${def.name} | ${def.description} |`);
+      }
+    }
+    sections.push(symbolLines.join("\n"));
+  }
+  if (navigator?.key_files) {
+    const keyFileLines = ["## Key Files", ""];
+    for (const [category, paths] of Object.entries(navigator.key_files)) {
+      if (paths && paths.length > 0) {
+        keyFileLines.push(`### ${category.charAt(0).toUpperCase() + category.slice(1)}`);
+        keyFileLines.push("");
+        for (const p of paths) {
+          keyFileLines.push(`- \`${p}\``);
+        }
+        keyFileLines.push("");
+      }
+    }
+    if (keyFileLines.length > 2) {
+      sections.push(keyFileLines.join("\n").trimEnd());
+    }
+  }
+  if (flows?.flows && Object.keys(flows.flows).length > 0) {
+    const flowLines = ["## Flows", ""];
+    for (const [id, flow] of Object.entries(flows.flows)) {
+      const name = flow.name || flow.description || id;
+      const trigger = flow.trigger ? ` (trigger: \`${flow.trigger}\`)` : "";
+      flowLines.push(`- **$${id}**: ${name}${trigger}`);
+    }
+    sections.push(flowLines.join("\n"));
+  }
+  if (portal?.gates && Object.keys(portal.gates).length > 0) {
+    const gateLines = ["## Gates", ""];
+    gateLines.push("| Gate | Description |");
+    gateLines.push("|------|-------------|");
+    for (const [id, gate] of Object.entries(portal.gates)) {
+      const desc = gate.description || "";
+      gateLines.push(`| \`^${id}\` | ${desc} |`);
+    }
+    if (portal.routes && Object.keys(portal.routes).length > 0) {
+      gateLines.push("");
+      gateLines.push("### Protected Routes");
+      gateLines.push("");
+      for (const [route, gates] of Object.entries(portal.routes)) {
+        gateLines.push(`- \`${route}\`: ${gates.join(", ")}`);
+      }
+    }
+    sections.push(gateLines.join("\n"));
+  }
+  const conventions = config.conventions;
+  if (conventions && conventions.length > 0) {
+    const convLines = ["## Conventions", ""];
+    for (const conv of conventions) {
+      convLines.push(`- ${conv}`);
+    }
+    sections.push(convLines.join("\n"));
+  }
+  const furtherReading = [
+    "## Further Reading",
+    "",
+    "- `.paradigm/specs/` - Detailed specifications",
+    "- `.paradigm/docs/` - Commands, patterns, troubleshooting",
+    "- `CLAUDE.md` - AI agent instructions (Claude Code)",
+    "- `AGENTS.md` - Universal agent instructions"
+  ];
+  sections.push(furtherReading.join("\n"));
+  return sections.join("\n\n") + "\n";
+}
+export {
+  syncLlmsCommand
+};

package/dist/{team-NWP2KJAB.js → team-6CCNANKE.js}

@@ -8,15 +8,16 @@ import {
   teamModelsCommand,
   teamResetCommand,
   teamStatusCommand
-} from "./chunk-UM54F7G5.js";
-import "./chunk-AD2LSCHB.js";
+} from "./chunk-4N6AYEEA.js";
+import "./chunk-Y4XZWCHK.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-WS5KM7OL.js";
+import "./chunk-HPC3JAUP.js";
+import "./chunk-6RNYVBSG.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-TAP5N3HH.js";
+import "./chunk-CCG6KYBT.js";
 import "./chunk-PMXRGPRQ.js";
-import "./chunk-5C4SGQKH.js";
-import "./chunk-PW2EXJQT.js";
+import "./chunk-6P4IFIK2.js";
+import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import "./chunk-5JGJACDU.js";
 import "./chunk-MO4EEYFW.js";

package/dist/{test-MA5TWJQV.js → test-DK2RWLTK.js}

@@ -831,6 +831,96 @@ var enableValidation = typeof process !== "undefined" ? process.env.PORTAL_VALID
 var isTestMode = typeof process !== "undefined" ? process.env.PORTAL_TEST_MODE === "true" : typeof import.meta !== "undefined" && import.meta.env?.VITE_TEST_MODE === "true";
 
 // src/commands/portal/test.ts
+function extractPropertiesFromExpression(expr) {
+  const propPattern = /\b([a-zA-Z_$][\w$]*(?:\.[a-zA-Z_$][\w$]*)+)/g;
+  const matches = /* @__PURE__ */ new Set();
+  let match;
+  while ((match = propPattern.exec(expr)) !== null) {
+    matches.add(match[1]);
+  }
+  return [...matches];
+}
+function buildEntityFromPath(path4) {
+  const parts = path4.split(".");
+  const root = {};
+  let current = root;
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i];
+    if (i === parts.length - 1) {
+      current[part] = "test-value";
+    } else {
+      const next = {};
+      current[part] = next;
+      current = next;
+    }
+  }
+  return root;
+}
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const [key, value] of Object.entries(source)) {
+    if (value && typeof value === "object" && !Array.isArray(value) && result[key] && typeof result[key] === "object" && !Array.isArray(result[key])) {
+      result[key] = deepMerge(
+        result[key],
+        value
+      );
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function generateTestCasesFromLocks(gate) {
+  const cases = [];
+  if (!gate.locks || gate.locks.length === 0) {
+    cases.push({
+      name: `${gate.id}: no locks (should pass)`,
+      entity: { user: { id: "test-user" } },
+      expected: true
+    });
+    return cases;
+  }
+  let fullEntity = {};
+  for (const lock of gate.locks) {
+    for (const key of lock.keys) {
+      const paths = extractPropertiesFromExpression(key.expression);
+      for (const p of paths) {
+        const partial = buildEntityFromPath(p);
+        fullEntity = deepMerge(fullEntity, partial);
+      }
+    }
+  }
+  cases.push({
+    name: `${gate.id}: entity satisfying all locks (should pass)`,
+    entity: fullEntity,
+    expected: true
+  });
+  for (const lock of gate.locks) {
+    const lockPaths = [];
+    for (const key of lock.keys) {
+      lockPaths.push(...extractPropertiesFromExpression(key.expression));
+    }
+    if (lockPaths.length > 0) {
+      const missingEntity = {};
+      for (const otherLock of gate.locks) {
+        if (otherLock.id === lock.id) continue;
+        for (const key of otherLock.keys) {
+          const paths = extractPropertiesFromExpression(key.expression);
+          for (const p of paths) {
+            const partial = buildEntityFromPath(p);
+            Object.assign(missingEntity, deepMerge(missingEntity, partial));
+          }
+        }
+      }
+      cases.push({
+        name: `${gate.id}: missing lock "${lock.id}" properties (should fail)`,
+        entity: gate.locks.length === 1 ? {} : missingEntity,
+        expected: false
+      });
+    }
+  }
+  return cases;
+}
 async function gateTestCommand(targetPath, options) {
   const rootDir = targetPath ? path3.resolve(targetPath) : process.cwd();
   const gateConfigPath = path3.join(rootDir, "portal.yaml");
@@ -896,14 +986,7 @@ async function gateTestCommand(targetPath, options) {
           entity: {},
           expected: false
         },
-        {
-          name: "Entity with required properties",
-          entity: {
-            // TODO: Add properties based on gate locks
-            user: { id: "test-user" }
-          },
-          expected: true
-        }
+        ...generateTestCasesFromLocks(gate)
       ];
       const result = await validateGateway(options.gate, testCases, client);
       if (result.passed) {

package/dist/{thread-JCJVRUQR.js → thread-RNSLADXN.js}

@@ -5,6 +5,7 @@ import "./chunk-MO4EEYFW.js";
 import * as fs from "fs";
 import * as path from "path";
 import chalk from "chalk";
+import * as yaml from "js-yaml";
 var THREAD_TEMPLATE = `# Thread - Session Continuity
 
 > Pass context between AI agent sessions. Updated by \`paradigm thread save\`.
@@ -24,6 +25,21 @@ var THREAD_TEMPLATE = `# Thread - Session Continuity
 *Run \`paradigm thread save "message"\` to update*
 *Run \`paradigm thread clear\` to reset*
 `;
+function getThreadTrailMax() {
+  try {
+    const configPath = path.join(process.cwd(), ".paradigm", "config.yaml");
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, "utf8");
+      const config = yaml.load(content);
+      const limits = config?.limits;
+      if (limits?.threadTrailMax && typeof limits.threadTrailMax === "number") {
+        return limits.threadTrailMax;
+      }
+    }
+  } catch {
+  }
+  return 10;
+}
 function parseThread(content) {
   const data = {
     trail: [],
@@ -75,7 +91,7 @@ function generateThread(data) {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").split(".")[0];
   let trailContent = "_No activity recorded yet_";
   if (data.trail.length > 0) {
-    trailContent = data.trail.slice(-10).map((entry) => `- ${entry.message}`).join("\n");
+    trailContent = data.trail.slice(-getThreadTrailMax()).map((entry) => `- ${entry.message}`).join("\n");
   }
   let looseEndsContent = "_No pending tasks_";
   if (data.looseEnds.length > 0) {
@@ -83,7 +99,7 @@ function generateThread(data) {
   }
   let breadcrumbsContent = "_No notes yet_";
   if (data.breadcrumbs.length > 0) {
-    breadcrumbsContent = data.breadcrumbs.slice(-10).map((item) => `- ${item}`).join("\n");
+    breadcrumbsContent = data.breadcrumbs.slice(-getThreadTrailMax()).map((item) => `- ${item}`).join("\n");
   }
   return THREAD_TEMPLATE.replace("{timestamp}", timestamp).replace("{trail}", trailContent).replace("{looseEnds}", looseEndsContent).replace("{breadcrumbs}", breadcrumbsContent);
 }

package/dist/{timeline-P7BARFLI.js → timeline-TJDVVVA3.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/timeline.ts

package/dist/{triage-TBIWJA6R.js → triage-PXMU3RWV.js}

@@ -6,10 +6,10 @@ import {
   StatsCalculator,
   TimelineBuilder,
   loadAllSeedPatterns
-} from "./chunk-4LGLU2LO.js";
+} from "./chunk-2E2RTBSM.js";
 import {
   SentinelStorage
-} from "./chunk-VZ7CXFRZ.js";
+} from "./chunk-CRICL4FQ.js";
 import "./chunk-MO4EEYFW.js";
 
 // src/commands/triage/index.ts

package/dist/university-content/courses/para-101.json

@@ -355,7 +355,8 @@
         "config.yaml defines discipline, conventions, and agent preferences",
         "navigator.yaml is generated by 'paradigm scan' for fast symbol lookup",
         "wisdom/ captures team decisions, preferences, and antipatterns",
-        "portal.yaml lives at the project root, not inside .paradigm/"
+        "portal.yaml lives at the project root, not inside .paradigm/",
+        "llms.txt at project root is an LLM-readable project summary — regenerate with 'paradigm sync-llms'"
       ],
       "quiz": [
         {