@a-company/paradigm 2.0.13 → 3.0.0

package/dist/{auto-IU7VN55K.js → auto-6MOGYQ4G.js}

@@ -450,6 +450,40 @@ Skipped ${skipped.length} existing file(s). Use --force to overwrite.`));
     fs.writeFileSync(g.path, g.content);
   }
   spinner.succeed(chalk.green(`Generated ${generated.length} .purpose file(s)`));
+  if (options.init) {
+    const portalPath = path.join(rootDir, "portal.yaml");
+    const portalExists = fs.existsSync(portalPath);
+    if (portalExists && !options.force) {
+      console.log(chalk.gray("\nportal.yaml already exists. Use --force to overwrite."));
+    } else {
+      const portalGates = {};
+      const portalRoutes = {};
+      for (const gate of gates) {
+        portalGates[`^${gate.id}`] = {
+          description: gate.description,
+          check: `// TODO: implement ${gate.id} check`,
+          prizes: []
+        };
+      }
+      for (const route of routes) {
+        if (route.description.startsWith("GET ") || route.description.startsWith("POST ") || route.description.startsWith("PUT ") || route.description.startsWith("PATCH ") || route.description.startsWith("DELETE ")) {
+          const routeKey = route.description;
+          const gateRefs = gates.length > 0 ? gates.map((g) => `^${g.id}`) : ["# TODO: add gates"];
+          portalRoutes[routeKey] = gateRefs;
+        }
+      }
+      if (Object.keys(portalGates).length > 0 || Object.keys(portalRoutes).length > 0) {
+        const portalData = { version: "1.0" };
+        if (Object.keys(portalGates).length > 0) portalData.gates = portalGates;
+        if (Object.keys(portalRoutes).length > 0) portalData.routes = portalRoutes;
+        const portalContent = yaml.dump(portalData, { lineWidth: -1, noRefs: true });
+        fs.writeFileSync(portalPath, portalContent);
+        spinner.succeed(chalk.green(`Generated portal.yaml with ${Object.keys(portalGates).length} gates and ${Object.keys(portalRoutes).length} routes`));
+      } else {
+        console.log(chalk.gray("\nNo gates or routes detected for portal.yaml."));
+      }
+    }
+  }
   console.log(chalk.gray("\nNext steps:"));
   console.log(chalk.gray("  1. Review generated files and adjust descriptions"));
   console.log(chalk.gray("  2. Run `paradigm lint` to validate"));

package/dist/chunk-27OSFWHG.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+
+// src/core/lore/storage.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "js-yaml";
+
+// src/core/lore/filter.ts
+function applyLoreFilter(entries, filter) {
+  let result = entries;
+  if (filter.author) {
+    result = result.filter((e) => e.author.id === filter.author);
+  }
+  if (filter.authorType) {
+    result = result.filter((e) => e.author.type === filter.authorType);
+  }
+  if (filter.symbol) {
+    result = result.filter(
+      (e) => e.symbols_touched.includes(filter.symbol) || e.symbols_created?.includes(filter.symbol)
+    );
+  }
+  if (filter.dateFrom) {
+    const from = new Date(filter.dateFrom).getTime();
+    result = result.filter((e) => new Date(e.timestamp).getTime() >= from);
+  }
+  if (filter.dateTo) {
+    const to = new Date(filter.dateTo).getTime();
+    result = result.filter((e) => new Date(e.timestamp).getTime() <= to);
+  }
+  if (filter.type) {
+    result = result.filter((e) => e.type === filter.type);
+  }
+  if (filter.tags && filter.tags.length > 0) {
+    result = result.filter(
+      (e) => filter.tags.some((tag) => e.tags?.includes(tag))
+    );
+  }
+  if (filter.hasReview !== void 0) {
+    result = result.filter(
+      (e) => filter.hasReview ? e.review != null : e.review == null
+    );
+  }
+  if (filter.minCompleteness !== void 0) {
+    result = result.filter(
+      (e) => e.review != null && e.review.completeness >= filter.minCompleteness
+    );
+  }
+  result.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+  if (filter.offset) {
+    result = result.slice(filter.offset);
+  }
+  if (filter.limit) {
+    result = result.slice(0, filter.limit);
+  }
+  return result;
+}
+
+// src/core/lore/storage.ts
+var LORE_DIR = ".paradigm/lore";
+var ENTRIES_DIR = "entries";
+var TIMELINE_FILE = "timeline.yaml";
+async function recordLore(rootDir, entry) {
+  const lorePath = path.join(rootDir, LORE_DIR);
+  const dateStr = entry.timestamp.slice(0, 10);
+  const datePath = path.join(lorePath, ENTRIES_DIR, dateStr);
+  if (!fs.existsSync(datePath)) {
+    fs.mkdirSync(datePath, { recursive: true });
+  }
+  if (!entry.id) {
+    entry.id = generateLoreId(rootDir, dateStr);
+  }
+  const entryPath = path.join(datePath, `${entry.id}.yaml`);
+  fs.writeFileSync(entryPath, yaml.dump(entry, { lineWidth: -1, noRefs: true }));
+  await rebuildTimeline(rootDir);
+}
+async function loadLoreEntries(rootDir, filter) {
+  const entriesPath = path.join(rootDir, LORE_DIR, ENTRIES_DIR);
+  if (!fs.existsSync(entriesPath)) {
+    return [];
+  }
+  const entries = [];
+  const dateDirs = fs.readdirSync(entriesPath).filter((d) => /^\d{4}-\d{2}-\d{2}$/.test(d)).sort().reverse();
+  for (const dateDir of dateDirs) {
+    if (filter?.dateFrom && dateDir < filter.dateFrom.slice(0, 10)) continue;
+    if (filter?.dateTo && dateDir > filter.dateTo.slice(0, 10)) continue;
+    const dirPath = path.join(entriesPath, dateDir);
+    const files = fs.readdirSync(dirPath).filter((f) => f.endsWith(".yaml")).sort();
+    for (const file of files) {
+      try {
+        const content = fs.readFileSync(path.join(dirPath, file), "utf8");
+        const entry = yaml.load(content);
+        entries.push(entry);
+      } catch {
+      }
+    }
+  }
+  return filter ? applyLoreFilter(entries, filter) : entries;
+}
+async function rebuildTimeline(rootDir) {
+  const lorePath = path.join(rootDir, LORE_DIR);
+  const entriesPath = path.join(lorePath, ENTRIES_DIR);
+  if (!fs.existsSync(entriesPath)) {
+    return;
+  }
+  const authors = /* @__PURE__ */ new Set();
+  let entryCount = 0;
+  let lastUpdated = "";
+  const dateDirs = fs.readdirSync(entriesPath).filter((d) => /^\d{4}-\d{2}-\d{2}$/.test(d));
+  for (const dateDir of dateDirs) {
+    const dirPath = path.join(entriesPath, dateDir);
+    const files = fs.readdirSync(dirPath).filter((f) => f.endsWith(".yaml"));
+    for (const file of files) {
+      try {
+        const content = fs.readFileSync(path.join(dirPath, file), "utf8");
+        const entry = yaml.load(content);
+        authors.add(entry.author.id);
+        entryCount++;
+        if (!lastUpdated || entry.timestamp > lastUpdated) {
+          lastUpdated = entry.timestamp;
+        }
+      } catch {
+      }
+    }
+  }
+  let project = "unknown";
+  const configPath = path.join(rootDir, ".paradigm", "config.yaml");
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = yaml.load(fs.readFileSync(configPath, "utf8"));
+      project = config.project || config.name || "unknown";
+    } catch {
+    }
+  }
+  const timeline = {
+    version: "1.0",
+    project,
+    entries: entryCount,
+    last_updated: lastUpdated || (/* @__PURE__ */ new Date()).toISOString(),
+    authors: Array.from(authors)
+  };
+  if (!fs.existsSync(lorePath)) {
+    fs.mkdirSync(lorePath, { recursive: true });
+  }
+  fs.writeFileSync(
+    path.join(lorePath, TIMELINE_FILE),
+    yaml.dump(timeline, { lineWidth: -1, noRefs: true })
+  );
+}
+async function addReview(rootDir, entryId, review) {
+  const entries = await loadLoreEntries(rootDir);
+  const entry = entries.find((e) => e.id === entryId);
+  if (!entry) {
+    return false;
+  }
+  const dateStr = entry.timestamp.slice(0, 10);
+  const entryPath = path.join(rootDir, LORE_DIR, ENTRIES_DIR, dateStr, `${entryId}.yaml`);
+  if (!fs.existsSync(entryPath)) {
+    return false;
+  }
+  entry.review = review;
+  fs.writeFileSync(entryPath, yaml.dump(entry, { lineWidth: -1, noRefs: true }));
+  return true;
+}
+async function loadLoreEntry(rootDir, entryId) {
+  const dateMatch = entryId.match(/^L-(\d{4}-\d{2}-\d{2})-/);
+  if (dateMatch) {
+    const dateStr = dateMatch[1];
+    const entryPath = path.join(rootDir, LORE_DIR, ENTRIES_DIR, dateStr, `${entryId}.yaml`);
+    if (fs.existsSync(entryPath)) {
+      try {
+        const content = fs.readFileSync(entryPath, "utf8");
+        return yaml.load(content);
+      } catch {
+        return null;
+      }
+    }
+  }
+  const entries = await loadLoreEntries(rootDir);
+  return entries.find((e) => e.id === entryId) || null;
+}
+function generateLoreId(rootDir, dateStr) {
+  const datePath = path.join(rootDir, LORE_DIR, ENTRIES_DIR, dateStr);
+  if (!fs.existsSync(datePath)) {
+    return `L-${dateStr}-001`;
+  }
+  const existing = fs.readdirSync(datePath).filter((f) => f.startsWith("L-") && f.endsWith(".yaml")).map((f) => {
+    const match = f.match(/L-\d{4}-\d{2}-\d{2}-(\d+)\.yaml/);
+    return match ? parseInt(match[1], 10) : 0;
+  });
+  const next = existing.length > 0 ? Math.max(...existing) + 1 : 1;
+  return `L-${dateStr}-${String(next).padStart(3, "0")}`;
+}
+
+export {
+  recordLore,
+  loadLoreEntries,
+  addReview,
+  loadLoreEntry
+};

package/dist/{chunk-753RICFF.js → chunk-2NMUSZFA.js}

@@ -2,7 +2,7 @@
 import {
   detectIDE,
   getAdapter
-} from "./chunk-YDNKXH4Z.js";
+} from "./chunk-A5BKW7QV.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{chunk-2M6OSOIG.js → chunk-4WR7X3FE.js}

@@ -113,6 +113,7 @@ var CLAUDE_CODE_STOP_HOOK = `#!/bin/sh
 #   4. Aspect anchor files that no longer exist
 #   5. Per-directory .purpose freshness (tracked via .pending-review)
 #   6. Aspect coverage advisory
+#   7. Lore entry expected for significant sessions (3+ source files)
 
 # Read JSON from stdin (hook input)
 INPUT=$(cat)
@@ -334,6 +335,27 @@ if [ "$HAS_ASPECTS" = true ] && [ "$SOURCE_COUNT" -gt 0 ]; then
   fi
 fi
 
+# --- Check 7: Lore entry expected for significant sessions ---
+if [ "$SOURCE_COUNT" -ge 3 ] && [ -d ".paradigm/lore" ]; then
+  LORE_RECORDED=false
+  for file in $MODIFIED; do
+    case "$file" in
+      .paradigm/lore/entries/*.yaml|.paradigm/lore/entries/*/*.yaml)
+        LORE_RECORDED=true
+        break
+        ;;
+    esac
+  done
+
+  if [ "$LORE_RECORDED" = false ]; then
+    VIOLATIONS="$VIOLATIONS
+  - You modified $SOURCE_COUNT source files but recorded no lore entry.
+    Record your session: paradigm_lore_record (MCP) or paradigm lore record (CLI).
+    Include: type, title, summary, and symbols_touched."
+    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+  fi
+fi
+
 # --- Final verdict ---
 if [ "$VIOLATION_COUNT" -gt 0 ]; then
   echo "" >&2
@@ -350,6 +372,7 @@ if [ "$VIOLATION_COUNT" -gt 0 ]; then
   echo "  2. paradigm_purpose_add_aspect \u2014 register cross-cutting concerns (with anchors)" >&2
   echo "  3. paradigm_portal_add_route \u2014 register new endpoints with gates" >&2
   echo "  4. paradigm_reindex \u2014 rebuild indexes after updates" >&2
+  echo "  5. paradigm_lore_record \u2014 record session lore entry" >&2
   exit 2
 fi
 
@@ -525,6 +548,7 @@ var CURSOR_STOP_HOOK = `#!/bin/sh
 #   4. Aspect anchor files that no longer exist
 #   5. Per-directory .purpose freshness (tracked via .pending-review)
 #   6. Aspect coverage advisory
+#   7. Lore entry expected for significant sessions (3+ source files)
 
 # Read JSON from stdin (hook input)
 INPUT=$(cat)
@@ -746,6 +770,27 @@ if [ "$HAS_ASPECTS" = true ] && [ "$SOURCE_COUNT" -gt 0 ]; then
   fi
 fi
 
+# --- Check 7: Lore entry expected for significant sessions ---
+if [ "$SOURCE_COUNT" -ge 3 ] && [ -d ".paradigm/lore" ]; then
+  LORE_RECORDED=false
+  for file in $MODIFIED; do
+    case "$file" in
+      .paradigm/lore/entries/*.yaml|.paradigm/lore/entries/*/*.yaml)
+        LORE_RECORDED=true
+        break
+        ;;
+    esac
+  done
+
+  if [ "$LORE_RECORDED" = false ]; then
+    VIOLATIONS="$VIOLATIONS
+  - You modified $SOURCE_COUNT source files but recorded no lore entry.
+    Record your session: paradigm_lore_record (MCP) or paradigm lore record (CLI).
+    Include: type, title, summary, and symbols_touched."
+    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+  fi
+fi
+
 # --- Final verdict ---
 if [ "$VIOLATION_COUNT" -gt 0 ]; then
   echo "" >&2
@@ -762,6 +807,7 @@ if [ "$VIOLATION_COUNT" -gt 0 ]; then
   echo "  2. paradigm_purpose_add_aspect \u2014 register cross-cutting concerns (with anchors)" >&2
   echo "  3. paradigm_portal_add_route \u2014 register new endpoints with gates" >&2
   echo "  4. paradigm_reindex \u2014 rebuild indexes after updates" >&2
+  echo "  5. paradigm_lore_record \u2014 record session lore entry" >&2
   exit 2
 fi
 

package/dist/{chunk-YDNKXH4Z.js → chunk-A5BKW7QV.js}

@@ -1514,6 +1514,7 @@ var ClaudeAdapter = class {
     sections.push(".paradigm/docs/        \u2192 Commands, patterns, troubleshooting");
     sections.push(".cursorrules           \u2192 IDE instructions (if using Cursor)");
     sections.push("portal.yaml            \u2192 Security/auth definitions");
+    sections.push(".paradigm/lore/        \u2192 Project timeline and history");
     sections.push("```");
     sections.push("");
     sections.push(generateTerminalGuidance());
@@ -1620,6 +1621,35 @@ var ClaudeAdapter = class {
     sections.push("3. Check `portal.yaml` for existing auth gates");
     sections.push("4. Check `.paradigm/docs/patterns.md` for coding patterns");
     sections.push("");
+    sections.push("## Lore (Project Timeline)");
+    sections.push("");
+    sections.push("Lore records what happened, why, and what was learned \u2014 forming a queryable project history.");
+    sections.push("");
+    sections.push("### MCP Tools");
+    sections.push("");
+    sections.push("| Tool | Purpose |");
+    sections.push("|------|---------|");
+    sections.push("| `paradigm_lore_search` | Search and filter lore entries by author, symbol, date, type |");
+    sections.push("| `paradigm_lore_record` | Record a new lore entry (session, decision, milestone, etc.) |");
+    sections.push("| `paradigm_lore_timeline` | Get project timeline summary with entry count and authors |");
+    sections.push("");
+    sections.push("### CLI Commands");
+    sections.push("");
+    sections.push("| Command | Description |");
+    sections.push("|---------|-------------|");
+    sections.push("| `paradigm lore` | List recent lore entries |");
+    sections.push("| `paradigm lore record` | Interactively record a new entry |");
+    sections.push("| `paradigm lore show <id>` | Show full details of an entry |");
+    sections.push("| `paradigm lore review <id>` | Add human review to an entry |");
+    sections.push("| `paradigm lore timeline` | Show project timeline summary |");
+    sections.push("");
+    sections.push("### When to Record Lore");
+    sections.push("");
+    sections.push("- After completing a feature or significant session");
+    sections.push("- When making architectural decisions");
+    sections.push("- After resolving incidents or bugs");
+    sections.push("- At project milestones");
+    sections.push("");
     sections.push(generateNavigationSection(config));
     sections.push("## Context Monitoring Protocol");
     sections.push("");
@@ -1651,6 +1681,8 @@ var ClaudeAdapter = class {
     sections.push("| **Getting test data** | `paradigm_test_fixtures` for fixtures |");
     sections.push('| **Building a feature (3+ files)** | `paradigm_orchestrate_inline` mode="plan" |');
     sections.push('| **Task involves security + code** | `paradigm_orchestrate_inline` mode="plan" |');
+    sections.push("| **Recording work done** | `paradigm_lore_record` to capture session history |");
+    sections.push("| **Checking project history** | `paradigm_lore_timeline` for timeline overview |");
     sections.push("| **Finishing work session** | `paradigm_reindex` to rebuild static index |");
     sections.push("");
     sections.push("**Benefits**: ~100 tokens per query vs ~2000 for reading files. Always fresh data from live index.");
@@ -1861,6 +1893,7 @@ var ClaudeAdapter = class {
     sections.push("| Add multi-step flow | Document as `$flow` in `.purpose` |");
     sections.push("| Rename/delete symbol | Update all `.purpose` references |");
     sections.push("| Learn antipattern | Add to `.paradigm/wisdom/antipatterns.yaml` |");
+    sections.push("| Complete feature/session | Record lore entry via `paradigm_lore_record` |");
     sections.push("");
     sections.push("**CRITICAL: Authorization requires portal.yaml**");
     sections.push("");

package/dist/{chunk-THFVK5AE.js → chunk-CH6VCTXQ.js}

@@ -8,7 +8,7 @@ import {
   syncToIDE,
   writeMcpConfig,
   writeNestedContexts
-} from "./chunk-YDNKXH4Z.js";
+} from "./chunk-A5BKW7QV.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{chunk-5GOA7WYD.js → chunk-MOZPTZ77.js}

@@ -18,7 +18,7 @@ import {
   detectIDE,
   loadParadigmFiles,
   syncToIDE
-} from "./chunk-YDNKXH4Z.js";
+} from "./chunk-A5BKW7QV.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{chunk-ELLR7WP6.js → chunk-S65LENNL.js}

@@ -2121,7 +2121,7 @@ var require_sql_wasm = __commonJS({
   }
 });
 
-// ../sentinel/dist/chunk-CL7K7CMH.js
+// ../sentinel/dist/chunk-WNZBSJR7.js
 var import_sql = __toESM(require_sql_wasm(), 1);
 
 // ../sentinel/node_modules/uuid/dist/esm-node/rng.js
@@ -2171,7 +2171,7 @@ function v4(options, buf, offset) {
 }
 var v4_default = v4;
 
-// ../sentinel/dist/chunk-CL7K7CMH.js
+// ../sentinel/dist/chunk-WNZBSJR7.js
 import * as path from "path";
 import * as fs from "fs";
 var SCHEMA_VERSION = 1;
@@ -2191,8 +2191,8 @@ var SentinelStorage = class {
     this.dbPath = dbPath || this.getDefaultDbPath();
   }
   getDefaultDbPath() {
-    const paradigmDir = process.env.PARADIGM_DATA_DIR || path.join(process.cwd(), ".paradigm", "sentinel");
-    return path.join(paradigmDir, "sentinel.db");
+    const dataDir = process.env.SENTINEL_DATA_DIR || process.env.PARADIGM_DATA_DIR || path.join(process.cwd(), ".paradigm", "sentinel");
+    return path.join(dataDir, "sentinel.db");
   }
   createSchema() {
     if (!this.db) return;