getprismo 0.1.22 → 0.1.23

package/README.md

@@ -864,8 +864,11 @@ lib/prismo-dev/fixes.js          safe ignore/template generation
 lib/prismo-dev/mcp.js            local MCP server and Prismo tool bindings
 lib/prismo-dev/report.js         terminal, markdown, ci reports
 lib/prismo-dev/scan.js           repo scanning, scoring, readiness
+lib/prismo-dev/scan-path-utils.js scan ignore/path helper logic
 lib/prismo-dev/shield.js         local command shield and searchable output index
+lib/prismo-dev/usage-log-utils.js local session log parsing helpers
 lib/prismo-dev/usage-watch.js    local logs, watch, cost, timeline
+lib/prismo-dev/utils.js          shared terminal/file/token helpers
 ```
 
 ---

package/lib/prismo-dev/scan-path-utils.js

@@ -0,0 +1,203 @@
+module.exports = function createScanPathUtils(deps) {
+  const { fs, path } = deps;
+
+  function normalizeRel(value) {
+    return value.split(path.sep).join("/");
+  }
+
+  function readIgnoreFile(root, fileName) {
+    const filePath = path.join(root, fileName);
+    if (!fs.existsSync(filePath)) return [];
+    const text = fs.readFileSync(filePath, "utf8");
+    return text
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => line && !line.startsWith("#"))
+      .map((line) => line.replace(/^!/, ""));
+  }
+
+  function patternMatches(pattern, relPath, isDir = false) {
+    const normalizedPattern = pattern.replace(/\\/g, "/").replace(/^\//, "");
+    const normalizedRel = normalizeRel(relPath);
+    const dirRel = isDir && !normalizedRel.endsWith("/") ? `${normalizedRel}/` : normalizedRel;
+
+    if (!normalizedPattern) return false;
+    if (normalizedPattern.endsWith("/")) {
+      const base = normalizedPattern.slice(0, -1);
+      return (
+        normalizedRel === base ||
+        normalizedRel.startsWith(`${base}/`) ||
+        normalizedRel.endsWith(`/${base}`) ||
+        normalizedRel.includes(`/${base}/`) ||
+        dirRel.includes(`/${base}/`)
+      );
+    }
+    if (normalizedPattern.startsWith("*.")) {
+      return normalizedRel.endsWith(normalizedPattern.slice(1));
+    }
+    if (normalizedPattern.includes("*")) {
+      const escaped = normalizedPattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+      return new RegExp(`(^|/)${escaped}$`).test(normalizedRel);
+    }
+    return (
+      normalizedRel === normalizedPattern ||
+      dirRel === normalizedPattern ||
+      normalizedRel.startsWith(`${normalizedPattern}/`) ||
+      normalizedRel.endsWith(`/${normalizedPattern}`)
+    );
+  }
+
+  function isIgnored(relPath, patterns, isDir = false) {
+    return patterns.some((pattern) => patternMatches(pattern, relPath, isDir));
+  }
+
+  function ignoreSuggestionCovered(pattern, existingPatterns) {
+    if (!pattern) return true;
+    if (existingPatterns.includes(pattern)) return true;
+    const sample = pattern
+      .replace(/^\*\//, "")
+      .replace(/^\*\*/, "sample")
+      .replace(/\*/g, "sample")
+      .replace(/\/$/, "");
+    const isDir = pattern.endsWith("/") || pattern.endsWith("/**");
+    return existingPatterns.some((existing) => {
+      if (existing === pattern) return true;
+      if (existing.endsWith("/") && pattern.startsWith(existing)) return true;
+      return patternMatches(existing, sample, isDir);
+    });
+  }
+
+  function missingIgnoreSuggestions(recommended, existingPatterns) {
+    return recommended.filter((pattern) => !ignoreSuggestionCovered(pattern, existingPatterns));
+  }
+
+  const SESSION_NOISE_DIRS = new Set([
+    ".next",
+    ".nuxt",
+    ".prismo",
+    ".pytest_cache",
+    ".turbo",
+    "__pycache__",
+    "build",
+    "calendar-dumps",
+    "coverage",
+    "dist",
+    "event-dumps",
+    "events",
+    "exports",
+    "htmlcov",
+    "inbox-dumps",
+    "logs",
+    "models",
+    "node_modules",
+    "out",
+    "playwright-report",
+    "session-dumps",
+    "source-streams",
+    "state-backups",
+    "test-results",
+    "tmp",
+    "temp",
+  ]);
+
+  const SESSION_NOISE_FILE_NAMES = new Set([
+    "package-lock.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "bun.lockb",
+    "coverage-final.json",
+    "lcov.info",
+  ]);
+
+  const SESSION_NOISE_EXTENSIONS = new Set([
+    ".db",
+    ".jsonl",
+    ".lock",
+    ".log",
+    ".sqlite",
+    ".sqlite3",
+  ]);
+
+  function cleanSessionPath(value) {
+    const text = String(value || "").trim().replace(/\\/g, "/");
+    if (!text || /^https?:\/\//.test(text)) return null;
+    const withoutQuotes = text.replace(/^["'`]+|["'`.,:;)\]]+$/g, "");
+    if (!withoutQuotes || withoutQuotes.includes("\n")) return null;
+    const markerIndex = withoutQuotes.indexOf("/Users/");
+    if (markerIndex > 0) return withoutQuotes.slice(markerIndex);
+    return withoutQuotes;
+  }
+
+  function sessionIgnorePatternForPath(value, root) {
+    const cleaned = cleanSessionPath(value);
+    if (!cleaned) return null;
+    const rootNormalized = normalizeRel(root);
+    let rel = cleaned;
+    if (path.isAbsolute(cleaned)) {
+      const normalized = normalizeRel(cleaned);
+      if (!normalized.startsWith(`${rootNormalized}/`)) return null;
+      rel = normalizeRel(path.relative(root, cleaned));
+    }
+    rel = normalizeRel(rel).replace(/^\.\//, "");
+    if (!rel || rel === "." || rel.startsWith("../") || rel.includes("..")) return null;
+
+    const segments = rel.split("/").filter(Boolean);
+    if (!segments.length) return null;
+    for (let index = 0; index < segments.length; index += 1) {
+      const segment = segments[index];
+      if (SESSION_NOISE_DIRS.has(segment)) {
+        return `${segments.slice(0, index + 1).join("/")}/`;
+      }
+    }
+
+    const fileName = segments[segments.length - 1];
+    const lowerName = fileName.toLowerCase();
+    const ext = path.extname(lowerName);
+    if (SESSION_NOISE_FILE_NAMES.has(lowerName)) return fileName;
+    if (SESSION_NOISE_EXTENSIONS.has(ext)) return rel;
+    if (/_state\.json$/i.test(fileName)) return "*_state.json";
+    if (/_tokens\.json$/i.test(fileName)) return "*_tokens.json";
+    if (/_export\.json$/i.test(fileName)) return "*_export.json";
+    if (/secret|credential|token/i.test(fileName) && /\.json$/i.test(fileName)) return rel;
+    return null;
+  }
+
+  function buildSessionIgnoreSuggestions(realUsage, root) {
+    if (!realUsage || !Array.isArray(realUsage.sessions)) return [];
+    const byPattern = new Map();
+    const add = (pattern, item, source, reason) => {
+      if (!pattern) return;
+      const existing = byPattern.get(pattern) || {
+        pattern,
+        source,
+        reason,
+        count: 0,
+        examples: [],
+      };
+      existing.count += Number(item?.count || 1);
+      const example = item?.value || item?.path || pattern;
+      if (example && !existing.examples.includes(example) && existing.examples.length < 3) existing.examples.push(example);
+      byPattern.set(pattern, existing);
+    };
+
+    for (const session of realUsage.sessions) {
+      for (const item of session.generatedArtifacts || []) {
+        add(sessionIgnorePatternForPath(item.value, root), item, session.tool || "session", "Generated artifact entered local session context.");
+      }
+      for (const item of session.repeatedPathMentions || []) {
+        add(sessionIgnorePatternForPath(item.value, root), item, session.tool || "session", "Noisy path appeared repeatedly in local session context.");
+      }
+    }
+    return Array.from(byPattern.values())
+      .sort((a, b) => b.count - a.count || a.pattern.localeCompare(b.pattern))
+      .slice(0, 25);
+  }
+
+  return {
+    buildSessionIgnoreSuggestions,
+    isIgnored,
+    missingIgnoreSuggestions,
+    normalizeRel,
+    readIgnoreFile,
+  };
+};

package/lib/prismo-dev/scan.js

@@ -27,197 +27,13 @@ const ASSUMED_TURNS_PER_AI_SESSION = 40;
 const ASSUMED_INPUT_COST_PER_1K_TOKENS = 0.003;
 const ASSUMED_SESSIONS_PER_MONTH = 30;
 
-function normalizeRel(value) {
-  return value.split(path.sep).join("/");
-}
-
-function readIgnoreFile(root, fileName) {
-  const filePath = path.join(root, fileName);
-  if (!fs.existsSync(filePath)) return [];
-  const text = fs.readFileSync(filePath, "utf8");
-  return text
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line && !line.startsWith("#"))
-    .map((line) => line.replace(/^!/, ""));
-}
-
-function patternMatches(pattern, relPath, isDir = false) {
-  const normalizedPattern = pattern.replace(/\\/g, "/").replace(/^\//, "");
-  const normalizedRel = normalizeRel(relPath);
-  const dirRel = isDir && !normalizedRel.endsWith("/") ? `${normalizedRel}/` : normalizedRel;
-
-  if (!normalizedPattern) return false;
-  if (normalizedPattern.endsWith("/")) {
-    const base = normalizedPattern.slice(0, -1);
-    return (
-      normalizedRel === base ||
-      normalizedRel.startsWith(`${base}/`) ||
-      normalizedRel.endsWith(`/${base}`) ||
-      normalizedRel.includes(`/${base}/`) ||
-      dirRel.includes(`/${base}/`)
-    );
-  }
-  if (normalizedPattern.startsWith("*.")) {
-    return normalizedRel.endsWith(normalizedPattern.slice(1));
-  }
-  if (normalizedPattern.includes("*")) {
-    const escaped = normalizedPattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
-    return new RegExp(`(^|/)${escaped}$`).test(normalizedRel);
-  }
-  return (
-    normalizedRel === normalizedPattern ||
-    dirRel === normalizedPattern ||
-    normalizedRel.startsWith(`${normalizedPattern}/`) ||
-    normalizedRel.endsWith(`/${normalizedPattern}`)
-  );
-}
-
-function isIgnored(relPath, patterns, isDir = false) {
-  return patterns.some((pattern) => patternMatches(pattern, relPath, isDir));
-}
-
-function ignoreSuggestionCovered(pattern, existingPatterns) {
-  if (!pattern) return true;
-  if (existingPatterns.includes(pattern)) return true;
-  const sample = pattern
-    .replace(/^\*\//, "")
-    .replace(/^\*\*/, "sample")
-    .replace(/\*/g, "sample")
-    .replace(/\/$/, "");
-  const isDir = pattern.endsWith("/") || pattern.endsWith("/**");
-  return existingPatterns.some((existing) => {
-    if (existing === pattern) return true;
-    if (existing.endsWith("/") && pattern.startsWith(existing)) return true;
-    return patternMatches(existing, sample, isDir);
-  });
-}
-
-function missingIgnoreSuggestions(recommended, existingPatterns) {
-  return recommended.filter((pattern) => !ignoreSuggestionCovered(pattern, existingPatterns));
-}
-
-const SESSION_NOISE_DIRS = new Set([
-  ".next",
-  ".nuxt",
-  ".prismo",
-  ".pytest_cache",
-  ".turbo",
-  "__pycache__",
-  "build",
-  "calendar-dumps",
-  "coverage",
-  "dist",
-  "event-dumps",
-  "events",
-  "exports",
-  "htmlcov",
-  "inbox-dumps",
-  "logs",
-  "models",
-  "node_modules",
-  "out",
-  "playwright-report",
-  "session-dumps",
-  "source-streams",
-  "state-backups",
-  "test-results",
-  "tmp",
-  "temp",
-]);
-
-const SESSION_NOISE_FILE_NAMES = new Set([
-  "package-lock.json",
-  "pnpm-lock.yaml",
-  "yarn.lock",
-  "bun.lockb",
-  "coverage-final.json",
-  "lcov.info",
-]);
-
-const SESSION_NOISE_EXTENSIONS = new Set([
-  ".db",
-  ".jsonl",
-  ".lock",
-  ".log",
-  ".sqlite",
-  ".sqlite3",
-]);
-
-function cleanSessionPath(value) {
-  const text = String(value || "").trim().replace(/\\/g, "/");
-  if (!text || /^https?:\/\//.test(text)) return null;
-  const withoutQuotes = text.replace(/^["'`]+|["'`.,:;)\]]+$/g, "");
-  if (!withoutQuotes || withoutQuotes.includes("\n")) return null;
-  const markerIndex = withoutQuotes.indexOf("/Users/");
-  if (markerIndex > 0) return withoutQuotes.slice(markerIndex);
-  return withoutQuotes;
-}
-
-function sessionIgnorePatternForPath(value, root) {
-  const cleaned = cleanSessionPath(value);
-  if (!cleaned) return null;
-  const rootNormalized = normalizeRel(root);
-  let rel = cleaned;
-  if (path.isAbsolute(cleaned)) {
-    const normalized = normalizeRel(cleaned);
-    if (!normalized.startsWith(`${rootNormalized}/`)) return null;
-    rel = normalizeRel(path.relative(root, cleaned));
-  }
-  rel = normalizeRel(rel).replace(/^\.\//, "");
-  if (!rel || rel === "." || rel.startsWith("../") || rel.includes("..")) return null;
-
-  const segments = rel.split("/").filter(Boolean);
-  if (!segments.length) return null;
-  for (let index = 0; index < segments.length; index += 1) {
-    const segment = segments[index];
-    if (SESSION_NOISE_DIRS.has(segment)) {
-      return `${segments.slice(0, index + 1).join("/")}/`;
-    }
-  }
-
-  const fileName = segments[segments.length - 1];
-  const lowerName = fileName.toLowerCase();
-  const ext = path.extname(lowerName);
-  if (SESSION_NOISE_FILE_NAMES.has(lowerName)) return fileName;
-  if (SESSION_NOISE_EXTENSIONS.has(ext)) return rel;
-  if (/_state\.json$/i.test(fileName)) return "*_state.json";
-  if (/_tokens\.json$/i.test(fileName)) return "*_tokens.json";
-  if (/_export\.json$/i.test(fileName)) return "*_export.json";
-  if (/secret|credential|token/i.test(fileName) && /\.json$/i.test(fileName)) return rel;
-  return null;
-}
-
-function buildSessionIgnoreSuggestions(realUsage, root) {
-  if (!realUsage || !Array.isArray(realUsage.sessions)) return [];
-  const byPattern = new Map();
-  const add = (pattern, item, source, reason) => {
-    if (!pattern) return;
-    const existing = byPattern.get(pattern) || {
-      pattern,
-      source,
-      reason,
-      count: 0,
-      examples: [],
-    };
-    existing.count += Number(item?.count || 1);
-    const example = item?.value || item?.path || pattern;
-    if (example && !existing.examples.includes(example) && existing.examples.length < 3) existing.examples.push(example);
-    byPattern.set(pattern, existing);
-  };
-
-  for (const session of realUsage.sessions) {
-    for (const item of session.generatedArtifacts || []) {
-      add(sessionIgnorePatternForPath(item.value, root), item, session.tool || "session", "Generated artifact entered local session context.");
-    }
-    for (const item of session.repeatedPathMentions || []) {
-      add(sessionIgnorePatternForPath(item.value, root), item, session.tool || "session", "Noisy path appeared repeatedly in local session context.");
-    }
-  }
-  return Array.from(byPattern.values())
-    .sort((a, b) => b.count - a.count || a.pattern.localeCompare(b.pattern))
-    .slice(0, 25);
-}
+const {
+  buildSessionIgnoreSuggestions,
+  isIgnored,
+  missingIgnoreSuggestions,
+  normalizeRel,
+  readIgnoreFile,
+} = require("./scan-path-utils")({ fs, path });
 
 function getFileKind(filePath) {
   const ext = path.extname(filePath).toLowerCase();

package/lib/prismo-dev/usage-log-utils.js

@@ -0,0 +1,251 @@
+module.exports = function createUsageLogUtils(deps) {
+  const {
+    fs,
+    path,
+    GENERATED_ARTIFACT_PATTERNS,
+    readIfText,
+  } = deps;
+
+  function listFilesRecursive(root, predicate = () => true, limit = 300) {
+    const files = [];
+    if (!fs.existsSync(root)) return files;
+    const stack = [root];
+    while (stack.length && files.length < limit) {
+      const current = stack.pop();
+      let entries;
+      try {
+        entries = fs.readdirSync(current, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        const fullPath = path.join(current, entry.name);
+        if (entry.isDirectory()) {
+          stack.push(fullPath);
+        } else if (entry.isFile() && predicate(fullPath)) {
+          files.push(fullPath);
+        }
+      }
+    }
+    return files.sort((a, b) => {
+      try {
+        return fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs;
+      } catch {
+        return 0;
+      }
+    });
+  }
+
+  function parseJsonl(filePath, maxLines = 20000) {
+    const text = readIfText(filePath, 30 * 1024 * 1024);
+    if (!text) return [];
+    const rows = [];
+    const lines = text.split(/\r?\n/).filter(Boolean);
+    for (const line of lines.slice(Math.max(0, lines.length - maxLines))) {
+      try {
+        rows.push(JSON.parse(line));
+      } catch {
+        // Local tool logs can contain partial writes while a session is active.
+      }
+    }
+    return rows;
+  }
+
+  function collectText(value, options = {}, depth = 0) {
+    if (value == null || depth > 8) return "";
+    if (typeof value === "string") return value;
+    if (typeof value === "number" || typeof value === "boolean") return String(value);
+    if (Array.isArray(value)) return value.map((item) => collectText(item, options, depth + 1)).join("\n");
+    if (typeof value !== "object") return "";
+
+    const skipKeys = new Set(["signature", "encrypted_content", "image_url", "data", "auth", "api_key", "token"]);
+    const parts = [];
+    for (const [key, child] of Object.entries(value)) {
+      if (skipKeys.has(key)) continue;
+      parts.push(collectText(child, options, depth + 1));
+    }
+    return parts.filter(Boolean).join("\n");
+  }
+
+  function addUsage(target, usage) {
+    if (!usage || typeof usage !== "object") return;
+    target.inputTokens += Number(usage.input_tokens || usage.prompt_tokens || 0);
+    target.outputTokens += Number(usage.output_tokens || usage.completion_tokens || 0);
+    target.cacheReadTokens += Number(usage.cache_read_input_tokens || 0);
+    target.cacheCreationTokens += Number(usage.cache_creation_input_tokens || 0);
+  }
+
+  function totalUsageTokens(usage) {
+    if (!usage) return 0;
+    return (
+      Number(usage.input_tokens || usage.prompt_tokens || 0) +
+      Number(usage.output_tokens || usage.completion_tokens || 0) +
+      Number(usage.cache_read_input_tokens || 0) +
+      Number(usage.cache_creation_input_tokens || 0)
+    );
+  }
+
+  function incrementMap(map, key, amount = 1) {
+    if (!key) return;
+    map[key] = (map[key] || 0) + amount;
+  }
+
+  function normalizeMentionedPath(value, cwd = "") {
+    let normalized = String(value || "")
+      .replace(/\\/g, "/")
+      .replace(/^[`'"]+|[`'",:;)\]}]+$/g, "")
+      .trim();
+    normalized = normalized.replace(/^[ MADRCU?!]{1,4}\s+(?=\/|Users\/|home\/)/, "");
+    const normalizedCwd = String(cwd || "").replace(/\\/g, "/");
+    const wasAbsolute = normalized.startsWith("/");
+    if (wasAbsolute && normalizedCwd && !normalized.startsWith(`${normalizedCwd}/`) && normalized !== normalizedCwd) {
+      return "";
+    }
+    if (normalizedCwd && normalized.startsWith(normalizedCwd)) {
+      normalized = normalized.slice(normalizedCwd.length);
+    }
+    normalized = normalized.replace(/^\.?\//, "");
+    if (normalizedCwd) {
+      const repoName = path.basename(normalizedCwd);
+      const repoIndex = normalized.indexOf(`${repoName}/`);
+      if (repoIndex >= 0) normalized = normalized.slice(repoIndex + repoName.length + 1);
+    }
+    return normalized;
+  }
+
+  function isGeneratedArtifactPath(relPath) {
+    const normalized = normalizeMentionedPath(relPath);
+    return GENERATED_ARTIFACT_PATTERNS.some((pattern) => pattern.test(normalized));
+  }
+
+  function looksLikeUsefulPath(relPath) {
+    const normalized = normalizeMentionedPath(relPath);
+    if (!normalized || normalized.startsWith("http") || normalized.includes("://")) return false;
+    if (normalized.length < 3 || normalized.split("/").some((part) => !part || part.length > 120)) return false;
+    if (/^(Users|home|var|tmp|private|Volumes)\//i.test(normalized)) return false;
+    if (/^(Users|home|var|tmp|Downloads|Code|Projects)$/i.test(normalized)) return false;
+    if (isGeneratedArtifactPath(normalized)) return true;
+    if (/\.[A-Za-z0-9]{1,12}$/.test(normalized)) return true;
+    return /(^|\/)(src|app|lib|backend|frontend|tests|docs|scripts|components|pages|routes|api)\//.test(normalized);
+  }
+
+  function extractMentionedPaths(text, cwd = "") {
+    const found = new Set();
+    const source = String(text || "");
+    const pathPattern = /(?:^|[\s"'`])((?:\.{0,2}\/)?(?:[\w.@-]+\/)+[\w.@+-]+\.[A-Za-z0-9]{1,12})/g;
+    const filePattern = /(?:^|[\s"'`])((?:package-lock\.json|pnpm-lock\.yaml|yarn\.lock|coverage-final\.json|tsconfig\.json|pyproject\.toml|requirements\.txt|README\.md|CLAUDE\.md|AGENTS\.md))/g;
+    for (const pattern of [pathPattern, filePattern]) {
+      let match;
+      while ((match = pattern.exec(source))) {
+        const rel = normalizeMentionedPath(match[1], cwd);
+        if (!looksLikeUsefulPath(rel)) continue;
+        if (cwd && !isGeneratedArtifactPath(rel) && !fs.existsSync(path.join(cwd, rel))) continue;
+        found.add(rel);
+      }
+    }
+    return Array.from(found);
+  }
+
+  function normalizeCommand(value) {
+    return String(value || "")
+      .replace(/\s+/g, " ")
+      .replace(/[;|&]+$/g, "")
+      .trim()
+      .slice(0, 160);
+  }
+
+  function isShellCommand(value) {
+    return /^(npm|pnpm|yarn|bun|pytest|python3?|node|npx|uv|ruff|cargo|go|make|git|cd|rm|cp|mv|sed|rg|grep|find|cat)\b/.test(String(value || "").trim());
+  }
+
+  function extractCommandCandidates(row, text) {
+    const commands = [];
+    const directInputs = [
+      row.payload?.input,
+      row.payload?.arguments,
+      row.message?.input,
+      row.message?.arguments,
+    ];
+    for (const input of directInputs) {
+      if (typeof input === "string") commands.push(input);
+      else if (input && typeof input === "object") {
+        for (const value of Object.values(input)) {
+          if (typeof value === "string") commands.push(value);
+        }
+      }
+    }
+    const toolItems = Array.isArray(row.message?.content) ? row.message.content : [];
+    for (const item of toolItems) {
+      if (!item || typeof item !== "object") continue;
+      if (typeof item.input === "string") commands.push(item.input);
+      if (item.input && typeof item.input === "object") {
+        for (const value of Object.values(item.input)) {
+          if (typeof value === "string") commands.push(value);
+        }
+      }
+    }
+    if (/tool_use|function_call/i.test(row.type || row.payload?.type || "")) {
+      const commandPattern = /\b(?:npm|pnpm|yarn|bun|pytest|python3?|node|npx|uv|ruff|cargo|go test|make|git)\b[^\n\r"`']{0,140}/g;
+      for (const match of String(text || "").matchAll(commandPattern)) {
+        commands.push(match[0]);
+      }
+    }
+    return Array.from(new Set(commands.map(normalizeCommand).filter((cmd) => cmd.length >= 3 && /\s/.test(cmd) && isShellCommand(cmd))));
+  }
+
+  function topCountEntries(map, limit = 5, minCount = 2) {
+    return Object.entries(map || {})
+      .filter(([, count]) => count >= minCount)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, limit)
+      .map(([value, count]) => ({ value, count }));
+  }
+
+  function isExpectedRepeatedPath(value) {
+    const normalized = normalizeMentionedPath(value).toLowerCase();
+    return ["claude.md", "agents.md", "readme.md"].includes(normalized) || normalized.endsWith("/readme.md");
+  }
+
+  function getActionableRepeatedPaths(session, limit = 3) {
+    return (session.repeatedPathMentions || [])
+      .filter((item) => !isExpectedRepeatedPath(item.value))
+      .filter((item) => !isGeneratedArtifactPath(item.value))
+      .slice(0, limit);
+  }
+
+  function summarizeGeneratedArtifacts(items = [], limit = 4) {
+    const groups = new Map();
+    for (const item of items) {
+      const value = normalizeMentionedPath(item.value);
+      let key = "generated files";
+      if (value.includes("__pycache__/") || value.endsWith(".pyc")) key = "__pycache__";
+      else if (value.includes("node_modules/")) key = "node_modules";
+      else if (/package-lock\.json|pnpm-lock\.yaml|yarn\.lock$/i.test(value)) key = "lockfiles";
+      else if (value.includes("/dist/") || value.startsWith("dist/")) key = "dist";
+      else if (value.includes("/build/") || value.startsWith("build/")) key = "build";
+      else if (value.includes("/coverage/") || value.startsWith("coverage/")) key = "coverage";
+      else if (/(^|\/)assets\/[^/]+-[A-Za-z0-9_-]{6,}\.(js|css|map)$/i.test(value)) key = "hashed assets";
+      const current = groups.get(key) || { type: key, count: 0, examples: [] };
+      current.count += Number(item.count || 1);
+      if (current.examples.length < 2) current.examples.push(value);
+      groups.set(key, current);
+    }
+    return Array.from(groups.values()).sort((a, b) => b.count - a.count).slice(0, limit);
+  }
+
+  return {
+    addUsage,
+    collectText,
+    extractCommandCandidates,
+    extractMentionedPaths,
+    getActionableRepeatedPaths,
+    incrementMap,
+    isGeneratedArtifactPath,
+    listFilesRecursive,
+    normalizeMentionedPath,
+    parseJsonl,
+    summarizeGeneratedArtifacts,
+    topCountEntries,
+    totalUsageTokens,
+  };
+};

package/lib/prismo-dev/usage-watch.js

@@ -13,84 +13,26 @@ module.exports = function createUsageWatch(deps) {
     writeGeneratedFile,
   } = deps;
 
-function listFilesRecursive(root, predicate = () => true, limit = 300) {
-  const files = [];
-  if (!fs.existsSync(root)) return files;
-  const stack = [root];
-  while (stack.length && files.length < limit) {
-    const current = stack.pop();
-    let entries;
-    try {
-      entries = fs.readdirSync(current, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      const fullPath = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(fullPath);
-      } else if (entry.isFile() && predicate(fullPath)) {
-        files.push(fullPath);
-      }
-    }
-  }
-  return files.sort((a, b) => {
-    try {
-      return fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs;
-    } catch {
-      return 0;
-    }
-  });
-}
-
-function parseJsonl(filePath, maxLines = 20000) {
-  const text = readIfText(filePath, 30 * 1024 * 1024);
-  if (!text) return [];
-  const rows = [];
-  const lines = text.split(/\r?\n/).filter(Boolean);
-  for (const line of lines.slice(Math.max(0, lines.length - maxLines))) {
-    try {
-      rows.push(JSON.parse(line));
-    } catch {
-      // Local tool logs can contain partial writes while a session is active.
-    }
-  }
-  return rows;
-}
-
-function collectText(value, options = {}, depth = 0) {
-  if (value == null || depth > 8) return "";
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (Array.isArray(value)) return value.map((item) => collectText(item, options, depth + 1)).join("\n");
-  if (typeof value !== "object") return "";
-
-  const skipKeys = new Set(["signature", "encrypted_content", "image_url", "data", "auth", "api_key", "token"]);
-  const parts = [];
-  for (const [key, child] of Object.entries(value)) {
-    if (skipKeys.has(key)) continue;
-    parts.push(collectText(child, options, depth + 1));
-  }
-  return parts.filter(Boolean).join("\n");
-}
-
-function addUsage(target, usage) {
-  if (!usage || typeof usage !== "object") return;
-  target.inputTokens += Number(usage.input_tokens || usage.prompt_tokens || 0);
-  target.outputTokens += Number(usage.output_tokens || usage.completion_tokens || 0);
-  target.cacheReadTokens += Number(usage.cache_read_input_tokens || 0);
-  target.cacheCreationTokens += Number(usage.cache_creation_input_tokens || 0);
-}
-
-function totalUsageTokens(usage) {
-  if (!usage) return 0;
-  return (
-    Number(usage.input_tokens || usage.prompt_tokens || 0) +
-    Number(usage.output_tokens || usage.completion_tokens || 0) +
-    Number(usage.cache_read_input_tokens || 0) +
-    Number(usage.cache_creation_input_tokens || 0)
-  );
-}
+const {
+  addUsage,
+  collectText,
+  extractCommandCandidates,
+  extractMentionedPaths,
+  getActionableRepeatedPaths,
+  incrementMap,
+  isGeneratedArtifactPath,
+  listFilesRecursive,
+  normalizeMentionedPath,
+  parseJsonl,
+  summarizeGeneratedArtifacts,
+  topCountEntries,
+  totalUsageTokens,
+} = require("./usage-log-utils")({
+  fs,
+  path,
+  GENERATED_ARTIFACT_PATTERNS,
+  readIfText,
+});
 
 function inferClaudePricingKey(model) {
   const normalized = String(model || "").toLowerCase();
@@ -139,154 +81,6 @@ function getSessionRisk(tokens, toolTokens) {
   return "Low";
 }
 
-function incrementMap(map, key, amount = 1) {
-  if (!key) return;
-  map[key] = (map[key] || 0) + amount;
-}
-
-function normalizeMentionedPath(value, cwd = "") {
-  let normalized = String(value || "")
-    .replace(/\\/g, "/")
-    .replace(/^[`'"]+|[`'",:;)\]}]+$/g, "")
-    .trim();
-  normalized = normalized.replace(/^[ MADRCU?!]{1,4}\s+(?=\/|Users\/|home\/)/, "");
-  const normalizedCwd = String(cwd || "").replace(/\\/g, "/");
-  const wasAbsolute = normalized.startsWith("/");
-  if (wasAbsolute && normalizedCwd && !normalized.startsWith(`${normalizedCwd}/`) && normalized !== normalizedCwd) {
-    return "";
-  }
-  if (normalizedCwd && normalized.startsWith(normalizedCwd)) {
-    normalized = normalized.slice(normalizedCwd.length);
-  }
-  normalized = normalized.replace(/^\.?\//, "");
-  if (normalizedCwd) {
-    const repoName = path.basename(normalizedCwd);
-    const repoIndex = normalized.indexOf(`${repoName}/`);
-    if (repoIndex >= 0) normalized = normalized.slice(repoIndex + repoName.length + 1);
-  }
-  return normalized;
-}
-
-function isGeneratedArtifactPath(relPath) {
-  const normalized = normalizeMentionedPath(relPath);
-  return GENERATED_ARTIFACT_PATTERNS.some((pattern) => pattern.test(normalized));
-}
-
-function looksLikeUsefulPath(relPath) {
-  const normalized = normalizeMentionedPath(relPath);
-  if (!normalized || normalized.startsWith("http") || normalized.includes("://")) return false;
-  if (normalized.length < 3 || normalized.split("/").some((part) => !part || part.length > 120)) return false;
-  if (/^(Users|home|var|tmp|private|Volumes)\//i.test(normalized)) return false;
-  if (/^(Users|home|var|tmp|Downloads|Code|Projects)$/i.test(normalized)) return false;
-  if (isGeneratedArtifactPath(normalized)) return true;
-  if (/\.[A-Za-z0-9]{1,12}$/.test(normalized)) return true;
-  return /(^|\/)(src|app|lib|backend|frontend|tests|docs|scripts|components|pages|routes|api)\//.test(normalized);
-}
-
-function extractMentionedPaths(text, cwd = "") {
-  const found = new Set();
-  const source = String(text || "");
-  const pathPattern = /(?:^|[\s"'`])((?:\.{0,2}\/)?(?:[\w.@-]+\/)+[\w.@+-]+\.[A-Za-z0-9]{1,12})/g;
-  const filePattern = /(?:^|[\s"'`])((?:package-lock\.json|pnpm-lock\.yaml|yarn\.lock|coverage-final\.json|tsconfig\.json|pyproject\.toml|requirements\.txt|README\.md|CLAUDE\.md|AGENTS\.md))/g;
-  for (const pattern of [pathPattern, filePattern]) {
-    let match;
-    while ((match = pattern.exec(source))) {
-      const rel = normalizeMentionedPath(match[1], cwd);
-      if (!looksLikeUsefulPath(rel)) continue;
-      if (cwd && !isGeneratedArtifactPath(rel) && !fs.existsSync(path.join(cwd, rel))) continue;
-      found.add(rel);
-    }
-  }
-  return Array.from(found);
-}
-
-function normalizeCommand(value) {
-  return String(value || "")
-    .replace(/\s+/g, " ")
-    .replace(/[;|&]+$/g, "")
-    .trim()
-    .slice(0, 160);
-}
-
-function isShellCommand(value) {
-  return /^(npm|pnpm|yarn|bun|pytest|python3?|node|npx|uv|ruff|cargo|go|make|git|cd|rm|cp|mv|sed|rg|grep|find|cat)\b/.test(String(value || "").trim());
-}
-
-function extractCommandCandidates(row, text) {
-  const commands = [];
-  const directInputs = [
-    row.payload?.input,
-    row.payload?.arguments,
-    row.message?.input,
-    row.message?.arguments,
-  ];
-  for (const input of directInputs) {
-    if (typeof input === "string") commands.push(input);
-    else if (input && typeof input === "object") {
-      for (const value of Object.values(input)) {
-        if (typeof value === "string") commands.push(value);
-      }
-    }
-  }
-  const toolItems = Array.isArray(row.message?.content) ? row.message.content : [];
-  for (const item of toolItems) {
-    if (!item || typeof item !== "object") continue;
-    if (typeof item.input === "string") commands.push(item.input);
-    if (item.input && typeof item.input === "object") {
-      for (const value of Object.values(item.input)) {
-        if (typeof value === "string") commands.push(value);
-      }
-    }
-  }
-  if (/tool_use|function_call/i.test(row.type || row.payload?.type || "")) {
-    const commandPattern = /\b(?:npm|pnpm|yarn|bun|pytest|python3?|node|npx|uv|ruff|cargo|go test|make|git)\b[^\n\r"`']{0,140}/g;
-    for (const match of String(text || "").matchAll(commandPattern)) {
-      commands.push(match[0]);
-    }
-  }
-  return Array.from(new Set(commands.map(normalizeCommand).filter((cmd) => cmd.length >= 3 && /\s/.test(cmd) && isShellCommand(cmd))));
-}
-
-function topCountEntries(map, limit = 5, minCount = 2) {
-  return Object.entries(map || {})
-    .filter(([, count]) => count >= minCount)
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, limit)
-    .map(([value, count]) => ({ value, count }));
-}
-
-function isExpectedRepeatedPath(value) {
-  const normalized = normalizeMentionedPath(value).toLowerCase();
-  return ["claude.md", "agents.md", "readme.md"].includes(normalized) || normalized.endsWith("/readme.md");
-}
-
-function getActionableRepeatedPaths(session, limit = 3) {
-  return (session.repeatedPathMentions || [])
-    .filter((item) => !isExpectedRepeatedPath(item.value))
-    .filter((item) => !isGeneratedArtifactPath(item.value))
-    .slice(0, limit);
-}
-
-function summarizeGeneratedArtifacts(items = [], limit = 4) {
-  const groups = new Map();
-  for (const item of items) {
-    const value = normalizeMentionedPath(item.value);
-    let key = "generated files";
-    if (value.includes("__pycache__/") || value.endsWith(".pyc")) key = "__pycache__";
-    else if (value.includes("node_modules/")) key = "node_modules";
-    else if (/package-lock\.json|pnpm-lock\.yaml|yarn\.lock$/i.test(value)) key = "lockfiles";
-    else if (value.includes("/dist/") || value.startsWith("dist/")) key = "dist";
-    else if (value.includes("/build/") || value.startsWith("build/")) key = "build";
-    else if (value.includes("/coverage/") || value.startsWith("coverage/")) key = "coverage";
-    else if (/(^|\/)assets\/[^/]+-[A-Za-z0-9_-]{6,}\.(js|css|map)$/i.test(value)) key = "hashed assets";
-    const current = groups.get(key) || { type: key, count: 0, examples: [] };
-    current.count += Number(item.count || 1);
-    if (current.examples.length < 2) current.examples.push(value);
-    groups.set(key, current);
-  }
-  return Array.from(groups.values()).sort((a, b) => b.count - a.count).slice(0, limit);
-}
-
 function analyzeSessionFile(filePath, tool) {
   const rows = parseJsonl(filePath);
   const stat = fs.existsSync(filePath) ? fs.statSync(filePath) : null;

package/lib/prismo-dev/utils.js

@@ -0,0 +1,85 @@
+const fs = require("fs");
+const path = require("path");
+
+const { BINARY_EXTENSIONS } = require("./constants");
+
+function shouldUseColor() {
+  return process.stdout.isTTY && !process.env.NO_COLOR;
+}
+
+const colorCodes = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  yellow: "\x1b[33m",
+  green: "\x1b[32m",
+  cyan: "\x1b[36m",
+};
+
+function color(text, tone, enabled = shouldUseColor()) {
+  if (!enabled || !colorCodes[tone]) return text;
+  return `${colorCodes[tone]}${text}${colorCodes.reset}`;
+}
+
+function severityIcon(severity) {
+  if (severity === "critical") return "[critical]";
+  if (severity === "high") return "[high]";
+  if (severity === "medium") return "[medium]";
+  return "[low]";
+}
+
+function severityColor(severity) {
+  if (severity === "critical" || severity === "high") return "red";
+  if (severity === "medium") return "yellow";
+  return "cyan";
+}
+
+function printStep(label, json = false) {
+  if (json) return () => {};
+  process.stderr.write(`${color("...", "cyan")} ${label}`);
+  return (status = "done") => {
+    process.stderr.write(` ${color(`[${status}]`, status === "done" ? "green" : "yellow")}\n`);
+  };
+}
+
+function estimateTokens(textOrBytes) {
+  const length = typeof textOrBytes === "string" ? textOrBytes.length : Number(textOrBytes || 0);
+  return Math.ceil(length / 4);
+}
+
+function readIfText(filePath, maxBytes = 2 * 1024 * 1024) {
+  const ext = path.extname(filePath).toLowerCase();
+  if (BINARY_EXTENSIONS.has(ext)) return null;
+
+  let stat;
+  try {
+    stat = fs.statSync(filePath);
+  } catch {
+    return null;
+  }
+  if (!stat.isFile() || stat.size > maxBytes) return null;
+
+  const buffer = fs.readFileSync(filePath);
+  if (buffer.includes(0)) return null;
+  return buffer.toString("utf8");
+}
+
+function safeReadJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+module.exports = {
+  color,
+  estimateTokens,
+  printStep,
+  readIfText,
+  safeReadJson,
+  severityColor,
+  severityIcon,
+  shouldUseColor,
+};

package/lib/prismo-dev-scan.js

@@ -19,76 +19,15 @@ const {
   GENERATED_ARTIFACT_PATTERNS,
 } = require("./prismo-dev/constants");
 
-function shouldUseColor() {
-  return process.stdout.isTTY && !process.env.NO_COLOR;
-}
-
-const colorCodes = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  red: "\x1b[31m",
-  yellow: "\x1b[33m",
-  green: "\x1b[32m",
-  cyan: "\x1b[36m",
-};
-
-function color(text, tone, enabled = shouldUseColor()) {
-  if (!enabled || !colorCodes[tone]) return text;
-  return `${colorCodes[tone]}${text}${colorCodes.reset}`;
-}
-
-function severityIcon(severity) {
-  if (severity === "critical") return "[critical]";
-  if (severity === "high") return "[high]";
-  if (severity === "medium") return "[medium]";
-  return "[low]";
-}
-
-function severityColor(severity) {
-  if (severity === "critical" || severity === "high") return "red";
-  if (severity === "medium") return "yellow";
-  return "cyan";
-}
-
-function printStep(label, json = false) {
-  if (json) return () => {};
-  process.stderr.write(`${color("...", "cyan")} ${label}`);
-  return (status = "done") => {
-    process.stderr.write(` ${color(`[${status}]`, status === "done" ? "green" : "yellow")}\n`);
-  };
-}
-
-function estimateTokens(textOrBytes) {
-  const length = typeof textOrBytes === "string" ? textOrBytes.length : Number(textOrBytes || 0);
-  return Math.ceil(length / 4);
-}
-
-function readIfText(filePath, maxBytes = 2 * 1024 * 1024) {
-  const ext = path.extname(filePath).toLowerCase();
-  if (BINARY_EXTENSIONS.has(ext)) return null;
-
-  let stat;
-  try {
-    stat = fs.statSync(filePath);
-  } catch {
-    return null;
-  }
-  if (!stat.isFile() || stat.size > maxBytes) return null;
-
-  const buffer = fs.readFileSync(filePath);
-  if (buffer.includes(0)) return null;
-  return buffer.toString("utf8");
-}
-
-
-function safeReadJson(filePath) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, "utf8"));
-  } catch {
-    return null;
-  }
-}
+const {
+  color,
+  estimateTokens,
+  printStep,
+  readIfText,
+  safeReadJson,
+  severityColor,
+  severityIcon,
+} = require("./prismo-dev/utils");
 
 let scanRepo;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getprismo",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Local AI coding workflow scanner for Codex, Claude Code, Cursor, and token-waste diagnostics.",
   "license": "MIT",
   "homepage": "https://github.com/shanirsh/prismodev#readme",