getprismo 0.1.58 → 0.1.60

package/docs/manual.md

@@ -1055,6 +1055,15 @@ npx getprismo context backend
 
 use these as the starting point for coding sessions instead of letting agents explore the whole repo.
 
+Each generated context pack also gets a machine-readable receipt next to it, for example:
+
+```text
+.prismo/frontend-context.md
+.prismo/frontend-context.receipt.json
+```
+
+Receipts record the repo ref, intended agent surfaces, source roots, omitted context classes, a digest of the source-file slice, estimated pack tokens, stale-after policy, and the command to regenerate/verify the pack. They do not include raw prompts or source contents; the digest is an audit handle so later sessions and the dashboard can tell what a pack represents without treating it as opaque markdown.
+
 ---
 
 ## tracking modes
@@ -1081,8 +1090,13 @@ no api keys. no intercepted prompts. no data uploaded.
 ├── architecture-summary.md
 ├── backend-summary.md
 ├── frontend-summary.md
+├── architecture-summary.receipt.json
+├── backend-summary.receipt.json
+├── frontend-summary.receipt.json
 ├── frontend-context.md
+├── frontend-context.receipt.json
 ├── backend-context.md
+├── backend-context.receipt.json
 ├── recommended-CLAUDE.boilerplate.md
 ├── recommended-AGENTS.boilerplate.md
 ├── recommended-.claudeignore

package/lib/prismo-dev/agent.js

@@ -980,6 +980,7 @@ module.exports = function createAgent(deps) {
     openWorkspace,
     parseCommand,
     renderAgentTerminal,
+    registerSelfRepair,
     reportAutoDetect,
     reportProgress,
     runAgent,

package/lib/prismo-dev/cli.js

@@ -135,6 +135,7 @@ function createCli(deps) {
     buildMultiSessionTimeline: _timeline,
     buildSyncPayload,
     loadConfig,
+    registerSelfRepair,
     buildReceipt: _receipt,
     buildReplay: _replay,
     runFirewall: _firewall,
@@ -841,15 +842,37 @@ function createCli(deps) {
         else console.log(renderPlannerTerminal(result));
         return;
       }
+      const tier = (tierIndex >= 0 ? ownArgs[tierIndex + 1] : null) || "mild";
       const result = await runRepair(target, cause, {
         limit: parsePositiveInt(limitIndex >= 0 ? ownArgs[limitIndex + 1] : null, 5),
         tokenBudget: parseTokenBudget(budgetIndex >= 0 ? ownArgs[budgetIndex + 1] : null),
         scope: scopeIndex >= 0 ? ownArgs[scopeIndex + 1] : null,
-        tier: tierIndex >= 0 ? ownArgs[tierIndex + 1] : null,
+        tier,
         commandArgs,
       });
-      if (json) console.log(JSON.stringify(result, null, 2));
-      else console.log(renderRepairTerminal(result));
+      // Register a completed manual repair with the cloud so the backend
+      // verification loop measures it like a dashboard-queued repair —
+      // otherwise hand-run repairs never become verified savings.
+      let registered = false;
+      if (result.status === "completed" && typeof registerSelfRepair === "function") {
+        const config = loadConfig();
+        if (config && config.token) {
+          registered = await registerSelfRepair(config, {
+            generatedAt: result.generatedAt,
+            decision: { cause: result.cause, tier },
+            outcome: {
+              status: result.status,
+              statusMessage: result.statusMessage,
+              generatedFiles: (result.result && result.result.generatedFiles) || [],
+            },
+          });
+        }
+      }
+      if (json) console.log(JSON.stringify({ ...result, registered }, null, 2));
+      else {
+        console.log(renderRepairTerminal(result));
+        if (registered) console.log("\nReported to Prismo Cloud — savings will verify as new sessions come in.");
+      }
       if (result.status === "failed") process.exitCode = 1;
       return;
     }

package/lib/prismo-dev/cloud-sync.js

@@ -386,7 +386,9 @@ module.exports = function createCloudSync(deps) {
   }
 
   async function runSync(rootDir = process.cwd(), options = {}) {
-    const config = loadConfig();
+    // Allow an embedding host (the editor extension) to inject its own
+    // connection instead of reading the CLI's on-disk config.
+    const config = options.config || loadConfig();
     const payload = buildSyncPayload(rootDir, {
       limit: options.limit || config?.sync?.defaultLimit || 20,
       tool: options.tool || "all",

package/lib/prismo-dev/context-optimize.js

@@ -1,4 +1,6 @@
 module.exports = function createContextOptimize(deps) {
+  const crypto = require("crypto");
+  const { spawnSync } = require("child_process");
   const {
     fs,
     path,
@@ -125,6 +127,111 @@ function proseList(items, empty = "none detected") {
   return items && items.length ? items.join(", ") : empty;
 }
 
+function estimateTokens(text) {
+  return Math.ceil(String(text || "").length / 4);
+}
+
+function sha256(value) {
+  return `sha256:${crypto.createHash("sha256").update(String(value)).digest("hex")}`;
+}
+
+function gitValue(root, args) {
+  try {
+    const result = spawnSync("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return result.status === 0 ? result.stdout.trim() || null : null;
+  } catch {
+    return null;
+  }
+}
+
+function repoRef(root) {
+  return {
+    branch: gitValue(root, ["rev-parse", "--abbrev-ref", "HEAD"]),
+    commit: gitValue(root, ["rev-parse", "--short=12", "HEAD"]),
+  };
+}
+
+function isContextPackFile(name) {
+  return name === "architecture-summary.md" ||
+    name === "backend-summary.md" ||
+    name === "frontend-summary.md" ||
+    name.endsWith("-context.md");
+}
+
+function rootsFromPaths(paths) {
+  return Array.from(new Set((paths || [])
+    .map((p) => String(p || "").replace(/\\/g, "/").split("/").filter(Boolean).slice(0, 2).join("/"))
+    .filter(Boolean)))
+    .sort();
+}
+
+function sourceRootsForPack(ctx, name) {
+  if (name === "backend-summary.md") {
+    return rootsFromPaths([
+      ...ctx.backend.api,
+      ...ctx.backend.services,
+      ...ctx.backend.models,
+      ...ctx.backend.db,
+      ...ctx.backend.auth,
+      ...ctx.backend.config,
+    ]);
+  }
+  if (name === "frontend-summary.md") {
+    return rootsFromPaths([
+      ...ctx.frontend.app,
+      ...ctx.frontend.components,
+      ...ctx.frontend.apiClient,
+      ...ctx.frontend.state,
+      ...ctx.frontend.styling,
+    ]);
+  }
+  if (name.endsWith("-context.md")) {
+    return rootsFromPaths(scopedRelevantFiles(ctx, name.replace(/-context\.md$/, "")));
+  }
+  return ctx.folders.slice(0, 30);
+}
+
+function matchingSourceFiles(ctx, roots) {
+  if (!roots || !roots.length) return ctx.scan.files.slice(0, 250);
+  return ctx.scan.files.filter((file) => roots.some((root) => file.path === root || file.path.startsWith(`${root}/`)));
+}
+
+function renderPackReceipt(ctx, name, contents) {
+  const packPath = `.prismo/${name}`;
+  const packId = name.replace(/\.md$/, "");
+  const sourceRoots = sourceRootsForPack(ctx, name);
+  const sourceFiles = matchingSourceFiles(ctx, sourceRoots)
+    .filter((file) => file.kind !== "binary")
+    .map((file) => ({
+      path: file.path,
+      size: file.size,
+      kind: file.kind,
+      tokens: file.tokens,
+    }))
+    .sort((a, b) => a.path.localeCompare(b.path));
+  return JSON.stringify({
+    schema_version: 1,
+    pack_id: packId,
+    pack_path: packPath,
+    receipt_path: `.prismo/${packId}.receipt.json`,
+    generated_at: ctx.generatedAt,
+    prismo_version: require("../../package.json").version,
+    repo_ref: repoRef(ctx.root),
+    target_agents: ["claude-code", "cursor", "codex", "mcp"],
+    source_roots: sourceRoots,
+    source_globs_digest: sha256(JSON.stringify({
+      pack_id: packId,
+      source_roots: sourceRoots,
+      files: sourceFiles,
+    })),
+    omitted_classes: ["lockfiles", "build-output", "large-logs", "coverage", "dependency-vendor", "binary-media"],
+    token_budget: 12000,
+    estimated_pack_tokens: estimateTokens(contents),
+    stale_if_older_than_ms: 86400000,
+    verify_command: `${NPX_COMMAND} optimize${ctx.scope ? ` ${ctx.scope}` : ""}`,
+  }, null, 2) + "\n";
+}
+
 function renderArchitectureSummary(ctx) {
   const apiLayer = ctx.backend.api.slice(0, 6);
   const dbLayer = ctx.backend.db.slice(0, 6);
@@ -429,9 +536,9 @@ function writeOptimizeGeneratedFile(root, relPath, contents) {
   return { path: relPath, backupPath: null, replaced: existed };
 }
 
-function renderScopedContext(ctx, scope) {
+function scopedRelevantFiles(ctx, scope) {
   const scopeLower = scope.toLowerCase();
-  const relevant = ctx.scan.files
+  return ctx.scan.files
     .filter((file) => {
       const rel = file.path.toLowerCase();
       if (scopeLower === "frontend") return rel.includes("frontend/") || rel.includes("src/app/") || rel.includes("src/components/");
@@ -442,6 +549,10 @@ function renderScopedContext(ctx, scope) {
     .filter((file) => file.kind !== "binary")
     .slice(0, 60)
     .map((file) => file.path);
+}
+
+function renderScopedContext(ctx, scope) {
+  const relevant = scopedRelevantFiles(ctx, scope);
 
   return [
     `# ${scope.charAt(0).toUpperCase()}${scope.slice(1)} Context`,
@@ -544,7 +655,11 @@ function runOptimize(rootDir = process.cwd(), options = {}) {
   const pending = getOptimizePendingFiles(ctx);
 
   if (options.dryRun) {
-    const generatedFiles = pending.map(([name]) => path.join(".prismo", name));
+    const generatedFiles = pending.flatMap(([name]) => {
+      const files = [path.join(".prismo", name)];
+      if (isContextPackFile(name)) files.push(path.join(".prismo", `${name.replace(/\.md$/, "")}.receipt.json`));
+      return files;
+    });
     generatedFiles.push(".prismo/optimize-report.md");
     return {
       root: ctx.root,
@@ -564,6 +679,12 @@ function runOptimize(rootDir = process.cwd(), options = {}) {
   for (const [name, contents] of pending) {
     const written = writeOptimizeGeneratedFile(ctx.root, path.join(".prismo", name), contents);
     generated.push(written.path);
+    if (isContextPackFile(name)) {
+      const receipt = renderPackReceipt(ctx, name, contents);
+      const receiptName = `${name.replace(/\.md$/, "")}.receipt.json`;
+      const writtenReceipt = writeOptimizeGeneratedFile(ctx.root, path.join(".prismo", receiptName), receipt);
+      generated.push(writtenReceipt.path);
+    }
   }
   const report = renderOptimizeReport(ctx, [...generated, ".prismo/optimize-report.md"]);
   const writtenReport = writeOptimizeReport(ctx.root, path.join(".prismo", "optimize-report.md"), report);

package/lib/prismo-dev-scan.js

@@ -383,6 +383,7 @@ const {
 const {
   renderAgentTerminal,
   runAgent,
+  registerSelfRepair,
   VALID_MODES: AGENT_VALID_MODES,
 } = require("./prismo-dev/agent")({
   fs,
@@ -479,6 +480,7 @@ const { runCli } = require("./prismo-dev/cli")({
   NPX_COMMAND,
   DEFAULT_PRISMO_PROXY_URL,
   AGENT_VALID_MODES,
+  registerSelfRepair,
   openUrl,
   printStep,
   getPositionals,
@@ -586,7 +588,6 @@ const { runCli } = require("./prismo-dev/cli")({
   buildMultiAgentView,
   buildSyncPayload,
   loadConfig,
-  runFirewall,
 });
 
 module.exports = {

package/package.json

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