getprismo 0.1.26 → 0.1.28

package/lib/prismo-dev-scan.js

@@ -53,6 +53,9 @@ const {
 
 const {
   analyzeSessionFile,
+  analyzeCursorSessions,
+  buildCursorDiagnosis,
+  buildCursorSessionTimeline,
   calculateClaudeCost,
   compactUsageSummary,
   formatMoney,
@@ -60,11 +63,13 @@ const {
   getClaudeCodeCostSummary,
   getClaudeSessionFiles,
   getCodexSessionFiles,
+  getCursorSessionSummary,
   getUsageSummary,
   getPositionals,
   parsePositiveInt,
   parseScopeAndTarget,
   renderClaudeCostTerminal,
+  renderCursorTerminal,
   renderUsageTerminal,
   renderContextThrottle,
   renderRescuePrompt,
@@ -202,6 +207,7 @@ const {
 const {
   renderFirewallTerminal,
   runFirewall,
+  runTimelineFirewallSuggestions,
 } = require("./prismo-dev/firewall")({
   fs,
   path,
@@ -263,9 +269,10 @@ Usage:
   prismo scan [--fix] [--ci] [--json] [--usage] [--optimizer-fit] [--report-card] [--simple] [--no-report] [path]
   prismo optimize [scope] [--json] [path]
   prismo context [scope] [--json] [path]
-  prismo cc [list|last N|all] [--json] [--limit N] [path]
-  prismo usage [codex|claude|all] [--json] [--limit N] [path]
-  prismo watch [codex|claude|all] [--json] [--once] [--agents] [--report] [--rescue] [--guardrails] [--throttle] [--events] [--no-events] [--auto] [--budget N] [--redact-paths] [--interval N] [path]
+  prismo cc [list|last N|all|timeline] [--json] [--limit N] [--firewall] [--task TASK] [path]
+  prismo cursor [list|authorship|timeline|files|all] [--json] [--limit N] [path]
+  prismo usage [codex|claude|cursor|all] [--json] [--limit N] [path]
+  prismo watch [codex|claude|cursor|all] [--json] [--once] [--agents] [--report] [--rescue] [--guardrails] [--throttle] [--events] [--no-events] [--auto] [--budget N] [--redact-paths] [--interval N] [path]
   prismo demo
 
 Commands:
@@ -280,7 +287,8 @@ Commands:
   optimize    Generate lightweight AI-readable project context files in .prismo/.
   context     Print a copy-pasteable compact context prompt for AI coding tools.
   cc          Show Claude Code token cost, cache cost, and all-time totals.
-  usage       Read local Codex/Claude Code session logs and summarize token usage.
+  cursor      Show Cursor session data, AI authorship, and AI-generated file tracking.
+  usage       Read local Codex/Claude Code/Cursor session logs and summarize token usage.
   watch       Refresh local session usage in the terminal.
   demo        Show sample output without needing a messy repo.
   setup       Detect coding tools, tracking modes, local logs, and Prismo proxy readiness.
@@ -295,6 +303,8 @@ Options:
   --simple    Print a plain-English scan summary for first-time or non-technical users.
   --no-report Do not write .prismo/prismo-dev-report.md.
   --limit N   Number of recent local sessions to show.
+  --firewall Generate cc timeline-derived firewall suggestion files.
+  --task TASK Name the task for timeline-derived firewall suggestions.
   --interval N Refresh interval in seconds for watch mode.
   --dry-run  Preview doctor/fix actions without writing files.
   --apply-ignores-only Only create/suggest AI ignore files in doctor mode.
@@ -377,7 +387,7 @@ Output:
 
 Usage:
   prismo cc [--json] [path]
-  prismo cc timeline [--json] [path]
+  prismo cc timeline [--json] [--firewall] [--task TASK] [path]
   prismo cc list [--json] [--limit N] [path]
   prismo cc last N [--json] [path]
   prismo cc all [--json] [path]
@@ -385,6 +395,7 @@ Usage:
 Examples:
   prismo cc
   prismo cc timeline
+  prismo cc timeline --firewall --task auth-bug
   prismo cc list
   prismo cc last 5
   prismo cc all --json
@@ -393,23 +404,47 @@ Examples:
   Reads ~/.claude/projects session logs and estimates Claude API token cost from input, output, cache write, and cache read tokens.
   Adds Prismo diagnosis: cost drivers, estimated avoidable spend, and context-optimization next actions.
   timeline shows context spikes, repeated commands, artifact leaks, and tool-output pressure for the latest session.
+  --firewall writes .prismo/timeline-firewall-suggestions.md and suggested allow/block files from timeline evidence.
   Without a path, cc commands read all Claude Code projects. Passing a path filters to that project.`,
+    cursor: `Prismo Cursor Sessions
+
+Usage:
+  prismo cursor [--json] [--limit N] [path]
+  prismo cursor list [--json] [--limit N] [path]
+  prismo cursor authorship [--json] [--limit N] [path]
+  prismo cursor timeline [--json] [--limit N] [path]
+  prismo cursor files [--json] [--limit N] [path]
+  prismo cursor all [--json] [--limit N] [path]
+
+Examples:
+  prismo cursor
+  prismo cursor authorship
+  prismo cursor list --limit 20
+  prismo cursor timeline --json
+  prismo cursor files
+
+Output:
+  Reads ~/.cursor/ai-tracking/ai-code-tracking.db and Cursor workspace state databases.
+  Shows Cursor composer sessions, AI authorship percentages from scored commits, AI-generated file tracking, and churn analysis.
+  Requires sqlite3 to be installed on the system.`,
     usage: `Prismo Usage
 
 Usage:
-  prismo usage [codex|claude|all] [--json] [--limit N] [path]
+  prismo usage [codex|claude|cursor|all] [--json] [--limit N] [path]
 
 Examples:
   prismo usage
   prismo usage codex --json
+  prismo usage cursor
   prismo usage claude --limit 3`,
     watch: `Prismo Watch
 
 Usage:
-  prismo watch [codex|claude|all] [--json] [--once] [--agents] [--report] [--rescue] [--guardrails] [--throttle] [--events] [--no-events] [--auto] [--budget N] [--redact-paths] [--interval N] [path]
+  prismo watch [codex|claude|cursor|all] [--json] [--once] [--agents] [--report] [--rescue] [--guardrails] [--throttle] [--events] [--no-events] [--auto] [--budget N] [--redact-paths] [--interval N] [path]
 
 Examples:
   prismo watch codex
+  prismo watch cursor --once --json
   prismo watch claude --once --json
   prismo watch --agents --once
   prismo watch --once --report
@@ -514,6 +549,7 @@ Tools exposed:
   prismo_context_pack
   prismo_firewall
   prismo_cc_timeline
+  prismo_cursor_sessions
 
 Output:
   Starts a local JSON-RPC MCP server over stdio. Use it from MCP-compatible clients so agents can scan context waste, search shielded command output, and request scoped context without loading huge logs into chat.
@@ -569,8 +605,8 @@ async function runCli(argv) {
     printCommandHelp(command);
     return;
   }
-  if (!["dev", "init", "doctor", "firewall", "benchmark", "shield", "mcp", "setup", "scan", "optimize", "context", "cc", "usage", "watch", "demo"].includes(command)) {
-    throw new Error(`Unknown command: ${command}. Try: prismo doctor, prismo watch, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, or prismo usage`);
+  if (!["dev", "init", "doctor", "firewall", "benchmark", "shield", "mcp", "setup", "scan", "optimize", "context", "cc", "cursor", "usage", "watch", "demo"].includes(command)) {
+    throw new Error(`Unknown command: ${command}. Try: prismo doctor, prismo watch, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, prismo cursor, or prismo usage`);
   }
 
   if (command === "demo") {
@@ -720,6 +756,7 @@ async function runCli(argv) {
       toDoctorJsonPayload,
       getUsageSummary,
       getClaudeCodeCostSummary,
+      getCursorSessionSummary,
       runOptimize,
       createOptimizeContext,
       renderStarterPrompt,
@@ -759,7 +796,17 @@ async function runCli(argv) {
   if (command === "cc") {
     const json = rest.includes("--json");
     const limitIndex = rest.indexOf("--limit");
-    const positional = getPositionals(rest, new Set(["--limit"]));
+    const firewall = rest.includes("--firewall");
+    const taskIndex = rest.indexOf("--task");
+    const firewallTask = taskIndex >= 0 && rest[taskIndex + 1] && !rest[taskIndex + 1].startsWith("-")
+      ? rest[taskIndex + 1]
+      : "timeline-followup";
+    const ccArgs = rest.filter((_, index) => {
+      if (index === rest.indexOf("--firewall")) return false;
+      if (taskIndex >= 0 && (index === taskIndex || index === taskIndex + 1)) return false;
+      return true;
+    });
+    const positional = getPositionals(ccArgs, new Set(["--limit"]));
     const subcommand = positional[0] && ["list", "last", "all", "timeline"].includes(positional[0].toLowerCase()) ? positional[0].toLowerCase() : "latest";
     const lastCount = subcommand === "last" ? parsePositiveInt(positional[1], 5) : null;
     const limit = subcommand === "list"
@@ -780,6 +827,9 @@ async function runCli(argv) {
     if (json) {
       if (subcommand === "timeline") {
         const latest = summary.sessions[0] || null;
+        const firewallSuggestions = firewall && latest
+          ? runTimelineFirewallSuggestions(path.resolve(target), latest, { task: firewallTask, dryRun: false })
+          : null;
         console.log(JSON.stringify({
           schemaVersion: 1,
           generatedAt: summary.generatedAt,
@@ -796,6 +846,7 @@ async function runCli(argv) {
               }
             : null,
           timeline: latest ? latest.timeline || [] : [],
+          firewallSuggestions,
           suggestedAction: latest?.prismo?.recommendations?.[0] || `${NPX_COMMAND} doctor`,
         }, null, 2));
         return;
@@ -803,13 +854,48 @@ async function runCli(argv) {
       console.log(JSON.stringify(summary, null, 2));
       return;
     }
-    console.log(renderClaudeCostTerminal(summary));
+    const output = [renderClaudeCostTerminal(summary)];
+    if (subcommand === "timeline" && firewall) {
+      const latest = summary.sessions[0] || null;
+      if (latest) {
+        const suggestions = runTimelineFirewallSuggestions(path.resolve(target), latest, { task: firewallTask, dryRun: false });
+        output.push("");
+        output.push("Timeline Firewall Suggestions");
+        output.push(`Wrote: ${suggestions.generatedFiles.join(", ")}`);
+        output.push(`Session-derived allowed: ${suggestions.sessionAllowed.length}`);
+        output.push(`Session-derived blocked: ${suggestions.sessionBlocked.length}`);
+        output.push("Tell your agent: Use .prismo/context-firewall.suggested.md for the next scoped session.");
+      }
+    }
+    console.log(output.join("\n"));
+    return;
+  }
+
+  if (command === "cursor") {
+    const json = rest.includes("--json");
+    const limitIndex = rest.indexOf("--limit");
+    const positional = getPositionals(rest, new Set(["--limit"]));
+    const subcommand = positional[0] && ["list", "authorship", "timeline", "files", "all"].includes(positional[0].toLowerCase())
+      ? positional[0].toLowerCase()
+      : "latest";
+    const target = (subcommand !== "latest" ? positional[1] : positional[0]) || process.cwd();
+    const limit = parsePositiveInt(limitIndex >= 0 ? rest[limitIndex + 1] : null, subcommand === "all" ? 200 : 20);
+    const summary = getCursorSessionSummary({
+      cwd: path.resolve(target),
+      limit,
+      mode: subcommand,
+    });
+    if (json) {
+      console.log(JSON.stringify(summary, null, 2));
+      return;
+    }
+    console.log(renderCursorTerminal(summary, subcommand));
     return;
   }
 
   if (command === "usage" || command === "watch") {
     const json = rest.includes("--json");
-    const knownTools = new Set(["codex", "claude", "all"]);
+    const knownTools = new Set(["codex", "claude", "cursor", "all"]);
     const positional = getPositionals(rest, new Set(["--limit", "--interval", "--budget"]));
     const explicitTool = positional[0] && knownTools.has(positional[0].toLowerCase());
     const tool = explicitTool ? positional[0].toLowerCase() : "all";
@@ -989,6 +1075,7 @@ module.exports = {
   renderMarkdownReport,
   renderSimpleScanReport,
   renderClaudeCostTerminal,
+  renderCursorTerminal,
   renderUsageTerminal,
   renderContextThrottle,
   renderRescuePrompt,
@@ -1008,7 +1095,9 @@ module.exports = {
   runCli,
   scanRepo,
   getClaudeCodeCostSummary,
+  getCursorSessionSummary,
   getUsageSummary,
+  analyzeCursorSessions,
   analyzeSessionFile,
   calculateClaudeCost,
   toDoctorJsonPayload,

package/package.json

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