@prom.codes/saver 0.1.4 → 0.1.6

package/README.md

@@ -25,6 +25,14 @@ 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.
 
+**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
 `PROMETHEUS_WORKSPACE_ROOT` only to target a different folder. An API key is

package/dist/bin.js

@@ -13,23 +13,8 @@ function classifyKey(raw) {
   return KEY_PATTERN.test(key) ? "valid" : "malformed";
 }
 
-// dist/workspace.js
-import { resolve } from "node:path";
-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 } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 var SAVER_LEVELS = ["lite", "balanced", "aggressive"];
@@ -94,6 +79,28 @@ function detectRuntimes(workspaceRoot) {
   const found = SAVER_RUNTIMES.filter((rt) => existsSync(join(workspaceRoot, TARGETS[rt].detect)));
   return found.length > 0 ? found : ["agents"];
 }
+function installedRuntimes(workspaceRoot) {
+  return SAVER_RUNTIMES.filter((rt) => {
+    const p = join(workspaceRoot, TARGETS[rt].relPath);
+    if (!existsSync(p))
+      return false;
+    try {
+      return readFileSync(p, "utf-8").includes(BLOCK_START);
+    } catch {
+      return false;
+    }
+  });
+}
+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);
@@ -119,7 +126,31 @@ async function installRuntime(workspaceRoot, runtime, level) {
   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) }] };
@@ -130,14 +161,24 @@ var setupInput = {
   level: levelEnum.optional(),
   runtimes: z.array(runtimeEnum).min(1).optional()
 };
+var emptyInput = {};
 function registerTools(server, deps) {
   const { workspaceRoot, apiKey, requireKey } = deps;
   const keyState = deps.keyState ?? (apiKey !== void 0 ? "valid" : "absent");
+  const rootIsHomeOrFsRoot = isHomeOrFilesystemRoot(workspaceRoot);
   server.registerTool("setup", {
     title: "Install the prom.codes Saver efficient-output rules",
     description: "Idempotently install the prom.codes Saver efficient-output rule block into this workspace's agent runtime configs (CLAUDE.md / .cursor/rules / .augment/rules / AGENTS.md). The rules cut token cost by trimming the agent's own prose (preamble, narration, pasted tool output) while keeping code, caveats and destructive sequences verbatim. `level`: `lite` (filler only) | `balanced` (default \u2014 lean, not terse) | `aggressive` (telegraphic, opt-in, never for code/destructive). Without `runtimes` it auto-detects which are present (fallback: agents). Re-running updates the block in place. Run this once per workspace.",
     inputSchema: setupInput
   }, async (args) => {
+    if (rootIsHomeOrFsRoot) {
+      return textResult({
+        ok: false,
+        installed: false,
+        workspaceRoot,
+        reason: "Workspace resolved to your home directory or a filesystem root \u2014 refusing to write rule files there. Open your project folder (Claude Code passes it via CLAUDE_PROJECT_DIR) or set PROMETHEUS_WORKSPACE_ROOT, then retry."
+      });
+    }
     if (requireKey === true && keyState !== "valid") {
       return {
         isError: true,
@@ -168,6 +209,24 @@ function registerTools(server, deps) {
       results
     });
   });
+  server.registerTool("status", {
+    title: "Saver status / health check",
+    description: "Health check for the prom.codes Saver in this workspace: the resolved workspace root, whether the API key is present/valid (optional \u2014 the Saver works keyless), which agent runtimes are detected here, and which of them already have the Saver rule block installed. Call this to confirm where it would write and whether `setup` has already run.",
+    inputSchema: emptyInput
+  }, async () => {
+    const detected = detectRuntimes(workspaceRoot);
+    const installed = rootIsHomeOrFsRoot ? [] : installedRuntimes(workspaceRoot);
+    const summary = rootIsHomeOrFsRoot ? `Workspace resolved to ${workspaceRoot} (home/root) \u2014 setup is refused here. Open your project folder.` : installed.length > 0 ? `Saver installed in ${workspaceRoot} for: ${installed.join(", ")}.` : `Saver not yet installed in ${workspaceRoot}. Run setup. Detected runtimes: ${detected.join(", ")}.`;
+    return textResult({
+      installed: installed.length > 0,
+      workspaceRoot,
+      rootIsHomeOrFsRoot,
+      key: { keyed: apiKey !== void 0, keyState, requireKey: requireKey === true },
+      detectedRuntimes: detected,
+      installedRuntimes: installed,
+      summary
+    });
+  });
 }
 
 // dist/server.js
@@ -177,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: {} };
@@ -212,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.4",
+  "version": "0.1.6",
   "description": "prom.codes Saver — cut token cost without cutting quality, as an MCP installer.",
   "type": "module",
   "bin": {