@a-company/paradigm 3.46.0 → 5.4.0

package/dist/{chunk-MW5DMGBB.js → chunk-YMDLDELF.js}

@@ -4,7 +4,7 @@
 import * as fs from "fs";
 import * as path from "path";
 import * as yaml from "js-yaml";
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 var SKIP_DIRECTORIES = [
   "node_modules",
   ".git",
@@ -13,7 +13,9 @@ var SKIP_DIRECTORIES = [
   "coverage",
   ".paradigm",
   "vendor",
-  "__pycache__"
+  "__pycache__",
+  ".next",
+  "target"
 ];
 function loadPortalConfig(rootDir) {
   const portalPath = path.join(rootDir, "portal.yaml");
@@ -46,32 +48,62 @@ function extractDeclaredGates(config) {
   }
   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 skipDirsArg = SKIP_DIRECTORIES.map((d) => `--exclude-dir=${d}`).join(" ");
-  try {
-    const symbolPattern = "\\^[a-zA-Z][a-zA-Z0-9_-]+";
-    const symbolResult = execSync(
-      `grep -rn ${skipDirsArg} -E "${symbolPattern}" "${rootDir}" 2>/dev/null || true`,
-      { encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
-    );
-    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 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"
+        });
       }
     }
-  } catch {
   }
   const functionPatterns = [
     { pattern: `checkGate\\s*\\(['"]([^'"]+)['"]`, type: "function" },
@@ -80,29 +112,23 @@ function findGateReferences(rootDir) {
     { pattern: `@Gate\\s*\\(['"]?([^'"\\)]+)['"]?\\)`, type: "function" }
   ];
   for (const { pattern, type } of functionPatterns) {
-    try {
-      const result = execSync(
-        `grep -rn ${skipDirsArg} -E "${pattern}" "${rootDir}" 2>/dev/null || true`,
-        { encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
-      );
-      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
-            });
-          }
+    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
+          });
         }
       }
-    } catch {
     }
   }
   return references;
@@ -119,6 +145,8 @@ async function checkPortalCompliance(rootDir) {
       return {
         status: "compliant",
         declaredButUnused: [],
+        routeAttachedUnused: [],
+        orphanUnused: [],
         usedButUndeclared: [],
         properlyDeclared: [],
         suggestions: ["No portal.yaml found, and no gate references detected in code."],
@@ -128,6 +156,8 @@ async function checkPortalCompliance(rootDir) {
     return {
       status: "violations",
       declaredButUnused: [],
+      routeAttachedUnused: [],
+      orphanUnused: [],
       usedButUndeclared: usedGates2,
       properlyDeclared: [],
       suggestions: [
@@ -141,18 +171,28 @@ async function checkPortalCompliance(rootDir) {
     };
   }
   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 (declaredButUnused.length > 0) {
-    suggestions.push("Gates declared but never referenced:");
-    for (const gate of declaredButUnused) {
-      suggestions.push(`  - ^${gate} (consider removing from portal.yaml or implementing)`);
+  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("");
   }
@@ -172,6 +212,8 @@ async function checkPortalCompliance(rootDir) {
   return {
     status,
     declaredButUnused,
+    routeAttachedUnused,
+    orphanUnused,
     usedButUndeclared,
     properlyDeclared,
     suggestions,
@@ -184,8 +226,11 @@ function formatComplianceReport(report) {
   lines.push(`Portal Compliance: ${statusIcon} ${report.status.toUpperCase()}`);
   lines.push("");
   lines.push(`Properly Declared: ${report.properlyDeclared.length}`);
-  if (report.declaredButUnused.length > 0) {
-    lines.push(`Declared but Unused: ${report.declaredButUnused.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}`);
@@ -198,9 +243,16 @@ function formatComplianceReport(report) {
     }
     lines.push("");
   }
-  if (report.declaredButUnused.length > 0) {
-    lines.push("Unused Gates (declared but never referenced):");
-    for (const gate of report.declaredButUnused) {
+  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("");
@@ -234,9 +286,16 @@ function getComplianceSummary(report) {
     };
   }
   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: `${report.declaredButUnused.length} unused gates`
+      message: parts.length > 0 ? parts.join(", ") + " gate(s)" : `${report.declaredButUnused.length} unused gates`
     };
   }
   return {

package/dist/{claude-63ISJAZK.js → claude-FRRWJSTJ.js}

@@ -2,7 +2,7 @@
 import {
   MODEL_PRICING
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/providers/claude.ts
 var MODEL_IDS = {

package/dist/{claude-cli-ABML5RHX.js → claude-cli-XJLK2X4L.js}

@@ -2,7 +2,7 @@
 import {
   MODEL_PRICING
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/providers/claude-cli.ts
 import * as fs from "fs";

package/dist/{claude-code-JRLMRPTO.js → claude-code-HTBA4XRB.js}

@@ -2,7 +2,7 @@
 import {
   MODEL_PRICING
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/providers/claude-code.ts
 import * as fs from "fs";

package/dist/{claude-code-teams-CAJBEFIZ.js → claude-code-teams-T4SP24MD.js}

@@ -2,7 +2,7 @@
 import {
   MODEL_PRICING
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/providers/claude-code-teams.ts
 import * as fs from "fs";

package/dist/{conductor-HLWYWUVH.js → conductor-PGPDVIVE.js}

@@ -2,7 +2,7 @@
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/conductor.ts
 import { execSync, spawn } from "child_process";

package/dist/{config-schema-3YNIFJCJ.js → config-schema-EA4XALGG.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/config-schema.ts
 import { z } from "zod";
@@ -106,7 +106,9 @@ var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "context",
   "probe",
   "states",
-  "custom-symbols"
+  "custom-symbols",
+  "docs",
+  "features"
 ]);
 function validateConfig(content) {
   const warnings = [];

package/dist/{constellation-FAGT45TU.js → constellation-A26CCGQS.js}

@@ -11,7 +11,7 @@ import "./chunk-IRKUEJVW.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/constellation.ts
 import * as fs from "fs";

package/dist/{context-audit-557EO6PK.js → context-audit-RLO3ETRP.js}

@@ -2,11 +2,12 @@
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/doctor/context-audit.ts
 import * as fs from "fs";
 import * as path from "path";
+import * as yaml from "js-yaml";
 var INSTRUCTION_FILES = ["CLAUDE.md", ".cursorrules", "AGENTS.md"];
 function loadInstructionFiles(rootDir) {
   const results = [];
@@ -94,6 +95,9 @@ async function checkStaleReferences(rootDir) {
       if (cleaned.startsWith("node_modules/")) continue;
       if (checked.has(cleaned)) continue;
       checked.add(cleaned);
+      const hasExt = /\.(ts|js|py|rs|go|yaml|yml|json|md|toml)(?:\/|$)/.test(cleaned);
+      const hasPathPrefix = /^(\.|src\/|packages\/|lib\/|app\/|docs\/)/.test(cleaned);
+      if (!hasExt && !hasPathPrefix) continue;
       const fullPath = path.join(rootDir, cleaned);
       if (!fs.existsSync(fullPath)) {
         stale.push(`${file.name}: ${cleaned}`);
@@ -406,8 +410,7 @@ async function checkStalePortal(rootDir) {
   }
   let portal;
   try {
-    const { parse } = await import("./dist-PSF5CP4I.js");
-    portal = parse(fs.readFileSync(portalPath, "utf8"));
+    portal = yaml.load(fs.readFileSync(portalPath, "utf8"));
   } catch {
     results.push({
       check: "stale-portal",
@@ -486,7 +489,7 @@ var VAGUE_PATTERNS = [
   { pattern: /\btry to\b/i, label: "try to" },
   { pattern: /\bmaybe\b/i, label: "maybe" },
   { pattern: /\bif possible\b/i, label: "if possible" },
-  { pattern: /\bconsider\b/i, label: "consider" },
+  { pattern: /\bconsider\b(?!-handoff)/i, label: "consider" },
   { pattern: /\bmight want to\b/i, label: "might want to" },
   { pattern: /\byou could\b/i, label: "you could" },
   { pattern: /\boptionally\b/i, label: "optionally" }
@@ -547,7 +550,7 @@ async function checkConfigSchema(rootDir) {
   }
   try {
     const content = fs.readFileSync(configPath, "utf8");
-    const { validateConfig } = await import("./config-schema-3YNIFJCJ.js");
+    const { validateConfig } = await import("./config-schema-EA4XALGG.js");
     const validation = validateConfig(content);
     const details = [];
     for (const err of validation.errors) {

package/dist/{cost-XEBADYFT.js → cost-BGM32XJU.js}

@@ -6,7 +6,7 @@ import {
   formatCost,
   formatTokens
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/team/cost.ts
 import * as path from "path";

package/dist/{cost-UD3WPEKZ.js → cost-VI46A4XL.js}

@@ -5,7 +5,7 @@ import {
 import {
   findGateFiles
 } from "./chunk-IRKUEJVW.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/cost.ts
 import * as fs from "fs";

package/dist/{cursor-cli-QUOOF2N4.js → cursor-cli-JVEZGHWQ.js}

@@ -2,7 +2,7 @@
 import {
   MODEL_PRICING
 } from "./chunk-5JGJACDU.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/core/providers/cursor-cli.ts
 import * as fs from "fs";

package/dist/{cursorrules-3TKZ4E4R.js → cursorrules-HLIKJJZT.js}

@@ -11,7 +11,7 @@ import {
   parseParadigmConfig,
   serializeParadigmConfig
 } from "./chunk-YO6DVTL7.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/cursorrules.ts
 import * as fs from "fs";

package/dist/decision-loader-WWCLIQPJ.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import {
+  findDecisionsForSymbol,
+  getDecisionSummary,
+  loadDecision,
+  loadDecisions,
+  recordDecision,
+  supersedeDecision,
+  updateDecision
+} from "./chunk-EZ3GOCYC.js";
+import "./chunk-7N7GSU6K.js";
+export {
+  findDecisionsForSymbol,
+  getDecisionSummary,
+  loadDecision,
+  loadDecisions,
+  recordDecision,
+  supersedeDecision,
+  updateDecision
+};

package/dist/{delete-RRK4RL6Y.js → delete-KBRPQLPC.js}

@@ -2,8 +2,8 @@
 import {
   deleteLoreEntry,
   loadLoreEntry
-} from "./chunk-QIOCFXDQ.js";
-import "./chunk-ZXMDA7VB.js";
+} from "./chunk-EKGMAM62.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/lore/delete.ts
 import chalk from "chalk";

package/dist/{diff-IP5CIARP.js → diff-RQLLNAFI.js}

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import {
   BackgroundOrchestrator
-} from "./chunk-QWA26UNO.js";
-import "./chunk-J4E6K5MG.js";
+} from "./chunk-WQITYKHM.js";
+import "./chunk-LSRABQIY.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-FS3WTUHY.js";
+import "./chunk-TXESEO7Y.js";
 import "./chunk-6QC3YGB6.js";
 import "./chunk-PMXRGPRQ.js";
-import "./chunk-MW5DMGBB.js";
 import "./chunk-5JGJACDU.js";
 import "./chunk-ZGUAAVMA.js";
 import "./chunk-EDOAWN7J.js";
 import "./chunk-IRKUEJVW.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-YMDLDELF.js";
+import "./chunk-PDX44BCA.js";
 
 // src/commands/team/diff.ts
 import * as fs from "fs";

package/dist/{discipline-5F5OVTXB.js → discipline-FA4OZXIS.js}

@@ -10,7 +10,7 @@ import {
   getStackConfig,
   listStackPresets
 } from "./chunk-UPLDI7CN.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 export {
   DISCIPLINE_MAPPINGS,
   GENERIC_SYMBOL_MAPPING,

package/dist/{dist-UXWV4OKX.js → dist-34NA5RS5.js}

@@ -36,7 +36,7 @@ import {
 } from "./chunk-ZGUAAVMA.js";
 import "./chunk-EDOAWN7J.js";
 import "./chunk-IRKUEJVW.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 export {
   PREFIX_TO_TYPE,
   SYMBOL_PREFIXES,

package/dist/{dist-5QE2BB2B-X6DYVSUL.js → dist-5QE2BB2B-5S3T6Y3T.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 
 // ../sentinel/dist/dist-5QE2BB2B.js
 import * as fs4 from "fs";

package/dist/{dist-CM3MVWWW.js → dist-77JDTVAY.js}

@@ -29,6 +29,7 @@ import {
   loadUniversalPatterns,
   writeConfig
 } from "./chunk-ZDHLG5VP.js";
+import "./chunk-7N7GSU6K.js";
 export {
   ContextEnricher,
   DEFAULT_AUTH_CONFIG,

package/dist/{dist-POMVY6WP.js → dist-QK4SQAK7.js}

@@ -31,7 +31,7 @@ import {
   loadServerConfig,
   writeConfig
 } from "./chunk-FKJUBQU3.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 export {
   ContextEnricher,
   DEFAULT_AUTH_CONFIG,

package/dist/{dist-3RVKEJRT.js → dist-TA6LSC2Q.js}

@@ -8,7 +8,7 @@ import {
   serializeGateConfig,
   validateGateConfig
 } from "./chunk-IRKUEJVW.js";
-import "./chunk-ZXMDA7VB.js";
+import "./chunk-PDX44BCA.js";
 export {
   findGateFiles,
   formatValidationResult,