sandoichi 0.1.1 → 0.1.3

package/README.md

@@ -1,25 +1,21 @@
 # sandoichi
 
-Cuts what Claude Code and Codex charge you to re-read their own output. Redacts secrets, caps oversized tool results, and, if you turn it on, trims request history before it's sent — all without calling an LLM itself.
+Sando's local JavaScript library for reducing repeated tool-output context.
 
-This is the core library (`@sando/core` renamed `sandoichi` for npm). For the Claude Code plugin, Codex plugin, and provider proxy, see the [main repo](https://github.com/yuzushi-dev/Sando).
-
-## Install
-
-```sh
+```bash
 npm install sandoichi
 ```
 
-Requires Node.js `22.22.x`.
-
-## Usage
-
 ```js
 import { optimizeToolOutput, createProviderProxy } from 'sandoichi';
 ```
 
-See [index.mjs](./index.mjs) for the full list of exports (tool-output optimization, provider request transforms, semantic compaction, metrics, status line rendering).
+Telemetry is off by default. The npm install asks once for consent.
+
+The Claude Code and Codex plugins are installed from the Yuzushi marketplace:
 
-## License
+```text
+/plugin install sando@yuzushi
+```
 
-MIT
+MIT.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sandoichi",
-  "version": "0.1.1",
-  "description": "Cuts what Claude Code and Codex charge you to re-read their own output.",
+  "version": "0.1.3",
+  "description": "Reduce repeated tool-output context in Claude Code and Codex.",
   "license": "MIT",
   "author": "yuzushi",
   "repository": {

package/src/hook-cli.mjs

@@ -5,21 +5,25 @@ import path from 'node:path';
 import { createReceipt, normalizeEvent, normalizePolicy, optimizeToolOutput } from './core.mjs';
 import { defaultMetricsPath, recordMetrics } from './metrics.mjs';
 import {
-  defaultTelemetryConfigPath, defaultTelemetryStatePaths, incrementCounter, readTelemetryConfig,
+  closeFinishedDays, defaultTelemetryConfigPath, defaultTelemetryStatePaths, incrementCounter, readTelemetryConfig,
 } from './telemetry.mjs';
 
+const PLUGIN_VERSION = '0.1';
+
 function todayUtc() { return new Date().toISOString().slice(0, 10); }
 
 /** Only counts (never content, paths, or IDs) — see docs/plans/2026-08-25-sando-telemetry-design.md.
  *  `enforce` covers both `apply` and `dry-run`: both walk the real rewrite path, only
  *  `observe` collects without deciding anything. */
 function recordHookTelemetry({ host, env, policy, optimization }) {
+  const configPath = defaultTelemetryConfigPath(env);
   let config;
-  try { config = readTelemetryConfig(defaultTelemetryConfigPath(env)); } catch { return; }
+  try { config = readTelemetryConfig(configPath); } catch { return; }
   if (!config.enabled) return;
   try {
+    const statePaths = defaultTelemetryStatePaths(env);
     incrementCounter({
-      statePaths: defaultTelemetryStatePaths(env),
+      statePaths,
       day: todayUtc(),
       event: 'hook_summary',
       host,
@@ -31,6 +35,7 @@ function recordHookTelemetry({ host, env, policy, optimization }) {
         bytesSaved: Math.max(0, optimization.stats.inputBytes - optimization.stats.inlineBytes),
       },
     });
+    closeFinishedDays({ statePaths, configPath, day: todayUtc(), pluginVersion: PLUGIN_VERSION });
   } catch { /* telemetry is best-effort and must never affect hook output */ }
 }
 

package/src/proxy.mjs

@@ -4,9 +4,11 @@ import { estimateTokens } from './core.mjs';
 import { detectProviderBody, listSemanticCandidates, transformProviderRequest } from './context-transform.mjs';
 import { recordProxyRequest } from './proxy-metrics.mjs';
 import {
-  defaultTelemetryConfigPath, defaultTelemetryStatePaths, incrementCounter, readTelemetryConfig,
+  closeFinishedDays, defaultTelemetryConfigPath, defaultTelemetryStatePaths, incrementCounter, readTelemetryConfig,
 } from './telemetry.mjs';
 
+const PLUGIN_VERSION = '0.1';
+
 function todayUtc() { return new Date().toISOString().slice(0, 10); }
 
 /** Only counts (never request/response content) — see docs/plans/2026-08-25-sando-telemetry-design.md.
@@ -15,13 +17,15 @@ function todayUtc() { return new Date().toISOString().slice(0, 10); }
  *  under a fixed `claude` label — this is the one place the design doc's host/provider split is
  *  approximate, flagged for the design doc rather than silently assumed. */
 function recordProxyTelemetry({ env, transformed, beforeText, afterText }) {
+  const configPath = defaultTelemetryConfigPath(env);
   let config;
-  try { config = readTelemetryConfig(defaultTelemetryConfigPath(env)); } catch { return; }
+  try { config = readTelemetryConfig(configPath); } catch { return; }
   if (!config.enabled) return;
   const cacheWarm = transformed.stats.cacheRewriteRatio !== null;
   try {
+    const statePaths = defaultTelemetryStatePaths(env);
     incrementCounter({
-      statePaths: defaultTelemetryStatePaths(env),
+      statePaths,
       day: todayUtc(),
       event: 'proxy_summary',
       host: 'claude',
@@ -33,6 +37,7 @@ function recordProxyTelemetry({ env, transformed, beforeText, afterText }) {
         cacheHitNo: cacheWarm ? 0 : 1,
       },
     });
+    closeFinishedDays({ statePaths, configPath, day: todayUtc(), pluginVersion: PLUGIN_VERSION });
   } catch { /* telemetry is best-effort and must never affect the proxied response */ }
 }
 

package/src/session-start.mjs

@@ -0,0 +1,28 @@
+import path from 'node:path';
+
+import { defaultTelemetryConfigPath, readTelemetryConfig } from './telemetry.mjs';
+
+export function runSessionStart({
+  env = process.env,
+  stdout = process.stdout,
+  rootEnv = 'PLUGIN_ROOT',
+} = {}) {
+  try {
+    const config = readTelemetryConfig(defaultTelemetryConfigPath(env));
+    if (config.prompted_consent_version > 0) {
+      stdout.write('{}\n');
+      return;
+    }
+    const pluginRoot = env[rootEnv] || path.resolve(import.meta.dirname, '..');
+    const cli = path.join(pluginRoot, 'lib', 'telemetry-cli.mjs');
+    stdout.write(`${JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        systemMessage: 'Sando can send anonymous aggregate telemetry (opt-in, off by default). '
+          + `Run \`node "${cli}" enable\` to turn it on. Details: TELEMETRY.md`,
+      },
+    })}\n`);
+  } catch {
+    stdout.write('{}\n');
+  }
+}

package/src/telemetry.mjs

@@ -1,6 +1,8 @@
+import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 import { atomicWrite, ensureDirectory, withLock } from './provider-usage.mjs';
 
@@ -257,6 +259,37 @@ export function closeDay({ statePaths, day, pluginVersion }) {
   return closedRows;
 }
 
+function launchDetachedFlush({ statePaths, configPath, spawnImpl }) {
+  try {
+    const entryPath = fileURLToPath(new URL('./telemetry-flush-entry.mjs', import.meta.url));
+    const child = spawnImpl(process.execPath, [entryPath, '--queue', statePaths.queue, '--config', configPath], {
+      detached: true, env: {}, stdio: 'ignore', windowsHide: true,
+    });
+    child.unref();
+  } catch { /* telemetry must never affect the caller */ }
+}
+
+/** Closes every raw counter day before `day` and starts one detached uploader.
+ * The child receives only local state paths and an empty environment. */
+export function closeFinishedDays({
+  statePaths, configPath = defaultTelemetryConfigPath(), day, pluginVersion,
+  spawnImpl = spawn,
+} = {}) {
+  const days = new Set();
+  if (fs.existsSync(statePaths.counters)) {
+    const state = readCounters(statePaths.counters);
+    for (const entry of Object.values(state.counters)) {
+      if (typeof entry.day === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(entry.day) && entry.day < day) days.add(entry.day);
+    }
+  }
+  const closedRows = [];
+  for (const closedDay of [...days].sort()) {
+    closedRows.push(...closeDay({ statePaths, day: closedDay, pluginVersion }));
+  }
+  if (closedRows.length) launchDetachedFlush({ statePaths, configPath, spawnImpl });
+  return closedRows;
+}
+
 export function loadBatch({ statePaths, max = DEFAULT_BATCH_MAX } = {}) {
   return readQueueRows(statePaths.queue).slice(0, max);
 }