@prom.codes/saver 0.1.5 → 0.1.6

package/README.md

@@ -25,10 +25,13 @@ never for code/destructive work). The rules keep code, caveats, destructive step
 and anything the agent needs later **verbatim** — it shapes phrasing, never what the
 agent does or remembers.
 
-A second tool, `status`, reports where it would write, the key state, and which
-runtimes already have the block installed. If a fresh window opens with no
-project (workspace falls back to home), `setup` **refuses to write rule files
-into your home dir** — open your project folder first.
+**It installs itself.** An MCP server can't act on its own, so the rule only
+saves tokens once it's in a config file. On startup the Saver **auto-installs**
+the marked rule block into config files you already have (CLAUDE.md / AGENTS.md /
+Cursor / Augment) — idempotent, never creates a new file, skipped for home/root,
+opt out with `PROMETHEUS_SAVER_AUTO_SETUP=off`. Run `setup` to install into all
+runtimes (incl. creating AGENTS.md if you have none). A `status` tool reports
+where it writes, the key state, and which runtimes already have the block.
 
 No database and no native modules — `npx` works turnkey everywhere (Node ≥ 20.10).
 The workspace is auto-detected (Claude Code `CLAUDE_PROJECT_DIR`); set

package/dist/bin.js

@@ -13,36 +13,10 @@ function classifyKey(raw) {
   return KEY_PATTERN.test(key) ? "valid" : "malformed";
 }
 
-// dist/workspace.js
-import { homedir } from "node:os";
-import { dirname, resolve } from "node:path";
-function isHomeOrFilesystemRoot(root) {
-  const abs = resolve(root);
-  if (abs === "")
-    return true;
-  if (abs === resolve(homedir()))
-    return true;
-  if (dirname(abs) === abs)
-    return true;
-  return false;
-}
-function resolveWorkspaceRoot(env = process.env) {
-  const explicit = (env.PROMETHEUS_WORKSPACE_ROOT ?? "").trim();
-  if (explicit !== "")
-    return resolve(explicit);
-  const claude = (env.CLAUDE_PROJECT_DIR ?? "").trim();
-  if (claude !== "")
-    return resolve(claude);
-  return resolve(process.cwd());
-}
-
-// dist/tools.js
-import { z } from "zod";
-
 // dist/setup.js
 import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname as dirname2, join } from "node:path";
+import { dirname, join } from "node:path";
 var SAVER_LEVELS = ["lite", "balanced", "aggressive"];
 var DEFAULT_LEVEL = "balanced";
 var SAVER_RUNTIMES = [
@@ -117,6 +91,16 @@ function installedRuntimes(workspaceRoot) {
     }
   });
 }
+function existingRuntimes(workspaceRoot) {
+  return SAVER_RUNTIMES.filter((rt) => existsSync(join(workspaceRoot, TARGETS[rt].detect)));
+}
+async function autoInstallExisting(workspaceRoot, level) {
+  const results = [];
+  for (const rt of existingRuntimes(workspaceRoot)) {
+    results.push(await installRuntime(workspaceRoot, rt, level));
+  }
+  return results;
+}
 function upsertBlock(existing, block) {
   const marked = withMarkers(block);
   const start = existing.indexOf(BLOCK_START);
@@ -137,12 +121,36 @@ async function installRuntime(workspaceRoot, runtime, level) {
   if (exists && before === after) {
     return { runtime, path: absPath, action: "unchanged" };
   }
-  await mkdir(dirname2(absPath), { recursive: true });
+  await mkdir(dirname(absPath), { recursive: true });
   await writeFile(absPath, after, "utf-8");
   return { runtime, path: absPath, action: exists ? "updated" : "created" };
 }
 
+// dist/workspace.js
+import { homedir } from "node:os";
+import { dirname as dirname2, resolve } from "node:path";
+function isHomeOrFilesystemRoot(root) {
+  const abs = resolve(root);
+  if (abs === "")
+    return true;
+  if (abs === resolve(homedir()))
+    return true;
+  if (dirname2(abs) === abs)
+    return true;
+  return false;
+}
+function resolveWorkspaceRoot(env = process.env) {
+  const explicit = (env.PROMETHEUS_WORKSPACE_ROOT ?? "").trim();
+  if (explicit !== "")
+    return resolve(explicit);
+  const claude = (env.CLAUDE_PROJECT_DIR ?? "").trim();
+  if (claude !== "")
+    return resolve(claude);
+  return resolve(process.cwd());
+}
+
 // dist/tools.js
+import { z } from "zod";
 var REQUIRE_KEY_ENV = "PROMETHEUS_SAVER_REQUIRE_KEY";
 function textResult(payload) {
   return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
@@ -228,7 +236,7 @@ var SERVER_IDENTITY = {
   version: "0.1.0",
   title: "prom.codes Saver"
 };
-var SERVER_INSTRUCTIONS = "prom.codes Saver cuts token cost by trimming the agent's own prose \u2014 preamble, play-by-play narration and pasted tool output \u2014 while keeping code, caveats and destructive sequences verbatim. Run `setup` once per workspace to install the efficient-output protocol into the runtime rule files. Default level is `balanced` (lean, not terse): lead with the answer, summarize long output, one end-of-task summary. Never sacrifice correctness, safety or completeness to save tokens.";
+var SERVER_INSTRUCTIONS = "prom.codes Saver cuts token cost by trimming the agent's own prose \u2014 preamble, play-by-play narration and pasted tool output \u2014 while keeping code, caveats and destructive sequences verbatim. The rule only works once it is installed into this workspace's runtime config: the server AUTO-INSTALLS it on startup when a config file already exists; otherwise call `setup` once to install it (it also creates AGENTS.md if you have no config yet). Call `status` to check. Default level `balanced` (lean, not terse): lead with the answer, summarize long output, one end-of-task summary. Never sacrifice correctness, safety or completeness to save tokens.";
 function createServer(deps, options = {}) {
   const identity = { ...SERVER_IDENTITY, ...options.identity ?? {} };
   const capabilities = options.capabilities ?? { tools: {} };
@@ -263,6 +271,17 @@ async function main() {
     requireKey,
     ...apiKey !== void 0 ? { apiKey } : {}
   });
+  const autoSetup = !/^(off|0|false|no)$/i.test(process.env.PROMETHEUS_SAVER_AUTO_SETUP ?? "");
+  if (autoSetup && !isHomeOrFilesystemRoot(workspaceRoot)) {
+    void autoInstallExisting(workspaceRoot, DEFAULT_LEVEL).then((results) => {
+      const wrote = results.filter((r) => r.action !== "unchanged");
+      if (wrote.length > 0) {
+        process.stderr.write(`prom-codes-saver: auto-installed the efficiency rule into ${wrote.map((r) => r.runtime).join(", ")} (set PROMETHEUS_SAVER_AUTO_SETUP=off to disable)
+`);
+      }
+    }).catch(() => {
+    });
+  }
   const transport = new StdioServerTransport();
   const shutdown = async (signal) => {
     process.stderr.write(`prom-codes-saver: received ${signal}, shutting down

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/saver",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "prom.codes Saver — cut token cost without cutting quality, as an MCP installer.",
   "type": "module",
   "bin": {