@intentic/claude-plugin 1.318.0 → 1.319.0

package/dist/post-bash.mjs

@@ -793,12 +793,6 @@ var OPTIONS = {
     description: "Let Claude read documents, PDFs, spreadsheets, slides, notebooks, images, audio and archives as markdown with the bundled `fileq` CLI. Off makes the command refuse; its one-line skill description stays listed, since a plugin cannot hide its own skills.",
     default: true
   },
-  shadows: {
-    type: "boolean",
-    title: "Document shadows",
-    description: "Keep a markdown rendering of every document in the project up to date in the background (a sweep at session start and every ten minutes, and each binary file Claude writes), so a read finds one ready. Costs background CPU on a document-heavy project.",
-    default: false
-  },
   holdout: {
     type: "number",
     title: "Measured share",

package/dist/prompt-submit.mjs

@@ -2,13 +2,10 @@ import { createRequire as __intenticRequire } from 'node:module'; const require
 
 // src/prompt-submit.ts
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
 
 // src/runtime.ts
-import { spawn } from "node:child_process";
 import { accessSync, closeSync, constants, mkdirSync, openSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { delimiter, dirname, join } from "node:path";
-var pluginRoot = (env = process.env) => env["CLAUDE_PLUGIN_ROOT"] ?? dirname(import.meta.dirname);
 var onPath = (name, env = process.env) => {
   const extensions = process.platform === "win32" ? (env["PATHEXT"] ?? ".EXE;.CMD;.BAT").split(";") : [""];
   for (const dir of (env["PATH"] ?? "").split(delimiter)) {
@@ -22,36 +19,6 @@ var onPath = (name, env = process.env) => {
   }
   return false;
 };
-var startDetached = (command, args, options) => {
-  mkdirSync(dirname(options.log), { recursive: true });
-  const out = openSync(options.log, "w");
-  try {
-    const child = spawn(command, args, { cwd: options.cwd, detached: true, stdio: ["ignore", out, out], env: { ...options.env ?? process.env } });
-    child.on("error", () => void 0);
-    child.unref();
-  } finally {
-    closeSync(out);
-  }
-};
-var claimIfDue = (stamp, everyMs, now = Date.now()) => {
-  try {
-    if (now - statSync(stamp).mtimeMs < everyMs) {
-      return false;
-    }
-  } catch {
-  }
-  try {
-    mkdirSync(dirname(stamp), { recursive: true });
-    writeFileSync(stamp, `${now}
-`);
-    return true;
-  } catch (error) {
-    process.stderr.write(`intentic: ${stamp} cannot be written (${error instanceof Error ? error.message : String(error)}), so what it paces is skipped
-`);
-    return false;
-  }
-};
-var projectSlug = (project) => project.replace(/[^a-zA-Z0-9]/g, "-");
 
 // src/features.ts
 var OPTIONS = {
@@ -99,12 +66,6 @@ var OPTIONS = {
     description: "Let Claude read documents, PDFs, spreadsheets, slides, notebooks, images, audio and archives as markdown with the bundled `fileq` CLI. Off makes the command refuse; its one-line skill description stays listed, since a plugin cannot hide its own skills.",
     default: true
   },
-  shadows: {
-    type: "boolean",
-    title: "Document shadows",
-    description: "Keep a markdown rendering of every document in the project up to date in the background (a sweep at session start and every ten minutes, and each binary file Claude writes), so a read finds one ready. Costs background CPU on a document-heavy project.",
-    default: false
-  },
   holdout: {
     type: "number",
     title: "Measured share",
@@ -145,8 +106,6 @@ var readOptions = (env = process.env) => {
 };
 
 // src/hook-io.ts
-import { homedir } from "node:os";
-import { join as join2 } from "node:path";
 var readStdin = async () => {
   const chunks = [];
   for await (const chunk of process.stdin) {
@@ -181,35 +140,15 @@ var runHook = async (handle) => {
 `);
   }
 };
-var dataDir = (env = process.env) => env["CLAUDE_PLUGIN_DATA"] ?? join2(env["CLAUDE_CONFIG_DIR"] ?? join2(homedir(), ".claude"), "plugins", "data", "intentic-intentic");
 var projectDir = (input, env = process.env) => env["CLAUDE_PROJECT_DIR"] ?? input.cwd ?? process.cwd();
 
-// src/shadows.ts
-import { relative, isAbsolute, join as join3 } from "node:path";
-var SWEEP_EVERY_MS = 10 * 6e4;
-var fileq = (env) => join3(pluginRoot(env), "dist", "fileq.mjs");
-var logOf = (data, project, what) => join3(data, "shadows", `${projectSlug(project)}.${what}.log`);
-var fileqEnv = (env, project) => ({ ...env, WORKSPACE_ROOT: project });
-var sweepIfDue = (data, project, env = process.env, now = Date.now()) => {
-  if (!claimIfDue(join3(data, "shadows", `${projectSlug(project)}.stamp`), SWEEP_EVERY_MS, now)) {
-    return false;
-  }
-  startDetached(process.execPath, [fileq(env), "sweep", "--json"], { cwd: project, log: logOf(data, project, "sweep"), env: fileqEnv(env, project) });
-  return true;
-};
-
 // src/prompt-submit.ts
 var MATCH_TIMEOUT_MS = 8e3;
 var promptSubmit = (input, raw, env = process.env) => {
-  const options = readOptions(env);
-  const project = projectDir(input, env);
-  if (options.shadows && existsSync(project)) {
-    sweepIfDue(dataDir(env), project, env);
-  }
-  if (!options.iq || !onPath("iq", env)) {
+  if (!readOptions(env).iq || !onPath("iq", env)) {
     return void 0;
   }
-  const match = spawnSync("iq", ["sessions", "match", "--hook"], { cwd: project, input: raw, encoding: "utf8", timeout: MATCH_TIMEOUT_MS, env: { ...env } });
+  const match = spawnSync("iq", ["sessions", "match", "--hook"], { cwd: projectDir(input, env), input: raw, encoding: "utf8", timeout: MATCH_TIMEOUT_MS, env: { ...env } });
   return match.status === 0 && typeof match.stdout === "string" && match.stdout.trim() !== "" ? match.stdout : void 0;
 };
 if (process.argv[1]?.endsWith("prompt-submit.mjs")) {

package/dist/session-start.mjs

@@ -837,8 +837,8 @@ var require_ignore = __commonJS({
 });
 
 // src/session-start.ts
-import { appendFileSync as appendFileSync2, existsSync } from "node:fs";
-import { join as join7 } from "node:path";
+import { appendFileSync as appendFileSync2 } from "node:fs";
+import { join as join6 } from "node:path";
 
 // ../agent-context/src/field-notes.ts
 import { createHash } from "node:crypto";
@@ -1395,12 +1395,6 @@ var OPTIONS = {
     description: "Let Claude read documents, PDFs, spreadsheets, slides, notebooks, images, audio and archives as markdown with the bundled `fileq` CLI. Off makes the command refuse; its one-line skill description stays listed, since a plugin cannot hide its own skills.",
     default: true
   },
-  shadows: {
-    type: "boolean",
-    title: "Document shadows",
-    description: "Keep a markdown rendering of every document in the project up to date in the background (a sweep at session start and every ten minutes, and each binary file Claude writes), so a read finds one ready. Costs background CPU on a document-heavy project.",
-    default: false
-  },
   holdout: {
     type: "number",
     title: "Measured share",
@@ -1527,20 +1521,6 @@ var recordSession = (data, row) => {
 `);
 };
 
-// src/shadows.ts
-import { relative as relative2, isAbsolute, join as join6 } from "node:path";
-var SWEEP_EVERY_MS = 10 * 6e4;
-var fileq = (env) => join6(pluginRoot(env), "dist", "fileq.mjs");
-var logOf = (data, project, what) => join6(data, "shadows", `${projectSlug(project)}.${what}.log`);
-var fileqEnv = (env, project) => ({ ...env, WORKSPACE_ROOT: project });
-var sweepIfDue = (data, project, env = process.env, now = Date.now()) => {
-  if (!claimIfDue(join6(data, "shadows", `${projectSlug(project)}.stamp`), SWEEP_EVERY_MS, now)) {
-    return false;
-  }
-  startDetached(process.execPath, [fileq(env), "sweep", "--json"], { cwd: project, log: logOf(data, project, "sweep"), env: fileqEnv(env, project) });
-  return true;
-};
-
 // src/session-start.ts
 var NOTES_BUDGET = 4e3;
 var NOTICE_EVERY_MS = 24 * 60 * 6e4;
@@ -1550,7 +1530,7 @@ var compose = (options, input, project, arms, data, env) => {
   const context = [];
   const notices = [];
   const notice = (id, text) => {
-    if (claimIfDue(join7(data, "notices", `${id}.stamp`), NOTICE_EVERY_MS)) {
+    if (claimIfDue(join6(data, "notices", `${id}.stamp`), NOTICE_EVERY_MS)) {
       notices.push(text);
     }
   };
@@ -1590,7 +1570,7 @@ var compose = (options, input, project, arms, data, env) => {
 ${nudge.trim()}`);
         sent.iq = true;
       }
-      startDetached("iq", ["sessions", "ingest"], { cwd: project, log: join7(data, "iq", `${projectSlug(project)}.ingest.log`), env });
+      startDetached("iq", ["sessions", "ingest"], { cwd: project, log: join6(data, "iq", `${projectSlug(project)}.ingest.log`), env });
     } else {
       notice("iq-missing", "intentic: iq search is on but the `iq` CLI is not installed (`npm i -g @intentic/iq`), so nothing was taught.");
     }
@@ -1622,9 +1602,6 @@ var sessionStart = (input, env = process.env) => {
   const source = input.source ?? "startup";
   record("the switches", () => saveOptions(data, options));
   exportEnv(options, project, env);
-  if (options.shadows && existsSync(project)) {
-    sweepIfDue(data, project, env);
-  }
   if (!TOLD_ON.has(source)) {
     return void 0;
   }

package/dist/stats.mjs

@@ -1,7 +1,7 @@
 import { createRequire as __intenticRequire } from 'node:module'; const require = __intenticRequire(import.meta.url);
 
 // src/stats.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync5 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { join as join8 } from "node:path";
 
 // ../agent-context/src/arm-stats.ts
@@ -21,6 +21,13 @@ var armOfValues = (values) => {
   const variance = values.length < 2 ? 0 : values.reduce((sum2, value) => sum2 + (value - mean) ** 2, 0) / (values.length - 1);
   return { turns: values.length, mean, variance };
 };
+var CAP_QUANTILE = 0.95;
+var capped = (on, off) => {
+  const pooled = [...on, ...off].toSorted((left, right) => left - right);
+  const cap = pooled[Math.min(pooled.length - 1, Math.floor(CAP_QUANTILE * pooled.length))] ?? 0;
+  const bound = (values) => values.map((value) => Math.min(value, cap));
+  return { on: bound(on), off: bound(off) };
+};
 var RESOLVING_MARGIN_PCT = 10;
 var controlTurnsNeededFor = (offTurns, marginPct) => {
   if (marginPct <= RESOLVING_MARGIN_PCT) {
@@ -96,7 +103,8 @@ var measureExperiment = (turns, design) => {
       const value = sample.arm === arm ? design.sample(sample.turns, metric) : void 0;
       return value === void 0 ? [] : [value];
     });
-    return readingOfArms(armOfValues(values(true)), armOfValues(values(false)), metric, false);
+    const arms = capped(values(true), values(false));
+    return readingOfArms(armOfValues(arms.on), armOfValues(arms.off), metric, false);
   };
   const [headline, ...rest] = design.metrics;
   return {
@@ -463,27 +471,6 @@ var readClaudeSession = (file, options) => {
   return session;
 };
 
-// ../../_tools/base/src/outside-text.ts
-var CONTROL_TAGS = ["system-reminder", "task-notification", "command-name", "command-message", "command-args", "local-command-stdout"];
-var CONTROL = new RegExp(String.raw`<\s*/?\s*(?:${CONTROL_TAGS.join("|")})\b[^>]*>`, "gi");
-
-// ../../_tools/constants/src/hosted-tiers.ts
-var HOSTED_TIERS = [
-  { id: "free", name: "Free", cpuKind: "shared", cpus: 4, memoryMb: 4096, volumeGb: 10, monthlyHours: 40, priceUsd: 0, flyHourUsd: 0.0329 },
-  { id: "standard", name: "Standard", cpuKind: "shared", cpus: 8, memoryMb: 8192, volumeGb: 25, monthlyHours: 220, priceUsd: 20, flyHourUsd: 0.0657 },
-  { id: "max", name: "Max", cpuKind: "shared", cpus: 8, memoryMb: 16384, volumeGb: 50, monthlyHours: 320, priceUsd: 50, flyHourUsd: 0.1234 }
-];
-var FREE_TIER = HOSTED_TIERS[0];
-var PAID_TIERS = HOSTED_TIERS.filter((tier) => tier.priceUsd > 0);
-
-// ../../_tools/constants/src/index.ts
-var STATE_DIR = ".intentic";
-var GOOGLE_CLIENT_ID = "481795963975-cq9msl6higcd91joidrfp8mjlkuq5fk3.apps.googleusercontent.com";
-var GOOGLE_TOKEN_STORAGE_KEY = `intentic.gid.${GOOGLE_CLIENT_ID}`;
-
-// ../fileq/src/lib/sidecar.ts
-var DERIVED_DIR = `${STATE_DIR}/local/cache/derived`;
-
 // ../agent-context/src/turn-metrics.ts
 var createTurnMetrics = (root) => {
   let calls = 0;
@@ -666,7 +653,6 @@ var isMissing2 = (error) => {
   const code = typeof error === "object" && error !== null ? error.code : void 0;
   return code === "ENOENT" || code === "ENOTDIR";
 };
-var projectSlug = (project) => project.replace(/[^a-zA-Z0-9]/g, "-");
 
 // src/features.ts
 var OPTIONS = {
@@ -714,12 +700,6 @@ var OPTIONS = {
     description: "Let Claude read documents, PDFs, spreadsheets, slides, notebooks, images, audio and archives as markdown with the bundled `fileq` CLI. Off makes the command refuse; its one-line skill description stays listed, since a plugin cannot hide its own skills.",
     default: true
   },
-  shadows: {
-    type: "boolean",
-    title: "Document shadows",
-    description: "Keep a markdown rendering of every document in the project up to date in the background (a sweep at session start and every ten minutes, and each binary file Claude writes), so a read finds one ready. Costs background CPU on a document-heavy project.",
-    default: false
-  },
   holdout: {
     type: "number",
     title: "Measured share",
@@ -1244,9 +1224,9 @@ var cleanSucceeded = (lines, command, enabled, ran) => {
     out = ran("wide", elideWideRuns(out));
   }
   if (enabled.has("cap")) {
-    const capped = capOutput(out, command);
-    if (capped !== out) {
-      out = ran("cap", capped);
+    const capped2 = capOutput(out, command);
+    if (capped2 !== out) {
+      out = ran("cap", capped2);
     }
   }
   return out;
@@ -1750,48 +1730,6 @@ var mechanismLine = (title, reads, on, experiment, holdout) => {
   }
   return `${title}, ${reads}: ${readingLine(experiment.metrics[0], experiment.sampleUnit ?? "conversations")}`;
 };
-var countShadows = (dir) => {
-  let count = 0;
-  const walk = (current) => {
-    let entries;
-    try {
-      entries = readdirSync3(current, { withFileTypes: true });
-    } catch (error) {
-      if (isMissing2(error)) {
-        return;
-      }
-      throw error;
-    }
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        walk(join8(current, entry.name));
-      } else if (entry.name.endsWith(".md")) {
-        count += 1;
-      }
-    }
-  };
-  walk(dir);
-  return count;
-};
-var lastSweep = (data, project) => {
-  const text = readText(join8(data, "shadows", `${projectSlug(project)}.sweep.log`));
-  try {
-    const summary = JSON.parse(text ?? "");
-    return typeof summary.derived === "number" && typeof summary.fresh === "number" ? ` (last sweep: ${summary.derived} derived, ${summary.fresh} already fresh${typeof summary.pruned === "number" && summary.pruned > 0 ? `, ${summary.pruned} pruned` : ""})` : "";
-  } catch {
-    return "";
-  }
-};
-var shadowLine = (args) => {
-  if (!args.options.shadows) {
-    return "Document shadows: switched off.";
-  }
-  if (args.project === void 0) {
-    return "Document shadows: reported per project.";
-  }
-  const count = countShadows(join8(args.project, DERIVED_DIR));
-  return `Document shadows: ${count} documents have a markdown shadow${lastSweep(args.data, args.project)}. Nothing measures what they save yet.`;
-};
 var inScope = (args, project) => args.project === void 0 || project === args.project;
 var statsReport = (args) => {
   const rows = parseStatsFile(readText(join8(outputDir(args.data), "filter-stats.jsonl")) ?? "").filter((row) => inScope(args, row.project));
@@ -1810,8 +1748,6 @@ var statsReport = (args) => {
     ...DESIGNS.map(
       ({ title, option, design, reads }) => mechanismLine(title, reads, args.options[option] === true, measureExperiment(turns, design), args.options.holdout)
     ),
-    ``,
-    shadowLine(args),
     ``
   ].join("\n");
 };

package/generated/skills/field-notes/SKILL.md

@@ -11,7 +11,9 @@ It exists because the project map cannot carry this. The map is recomputed from
 
 The evidence is the digest below: this project's own Claude Code sessions, read back and counted by the plugin (failures by how many sessions hit them, the commands that ran and how often they failed, the files edited most, how sessions opened). Open a transcript it names when a count needs its story. Work from counts, not impressions: how MANY sessions hit a thing is what decides its rank, and one bad afternoon is not a standing problem.
 
-Rank by what it costs a turn NOT to know: how often sessions hit it, how much it costs when they do, and whether they could have found it out cheaply themselves. Rank 1 is the costliest gap.
+Rank by what it costs a turn NOT to know: how often sessions hit it, how much it costs when they do, and whether they could have found it out cheaply themselves. Rank 1 is the costliest gap. Rank on recent sessions only, and recount every percentage from them rather than carrying the old one forward: a trap sessions stopped hitting, because the code or the environment has since fixed it, drops down or out however costly it once was.
+
+SIZE IS PART OF THE RANKING. The intentic plugin sends the priority table on every turn, then whole sections in rank order until the owner's budget runs out (4,000 characters by default, the table included), and stops at the first section that does not fit, so one long section silences every rank below it. Keep the table's cells to a few words, keep each section under about 700 characters, and split anything longer into two ranks. Leave out what every turn is already told elsewhere (the system prompt's working rules, the skills it lists, the search teaching): repeating it spends the budget twice.
 
 VERIFY EVERY FACT AGAINST THIS PROJECT BEFORE YOU WRITE IT DOWN. A transcript from six weeks ago is a hypothesis: run the command, list the directory, check the port. A brief that is confidently wrong is worse than no brief, because every turn reads it and none of them will doubt it.
 

package/generated/skills/fileq/SKILL.md

@@ -5,12 +5,12 @@ description: Read binary files (docx, xlsx, pptx, pdf, odt, epub, ipynb, images,
 
 # fileq: binary files as markdown
 
-The `fileq` CLI (on PATH) turns the workspace files you cannot open as text into markdown, and keeps a
-sidecar copy fresh so reading twice derives once.
+The `fileq` CLI (on PATH) turns the workspace files you cannot open as text into markdown. Renderings are
+cached by content, so a repeat read of unchanged content is instant.
 
 ## Read a file
 `fileq <file>` (or `fileq read <file> --budget 8000`)
-- Prints a capsule (format, token cost), the content up to the budget, and `saved:` — the sidecar path
+- Prints a capsule (format, token cost), the content up to the budget, and `saved:` — the markdown file
   carrying the whole thing. Over budget, the cut is announced with that exact path to Read.
 - Formats: docx and odt (headings, lists, tables), xlsx (capped tables), pptx (slides + speaker notes),
   pdf (text layer; a scan is OCR'd when `tesseract` is on PATH, and the note says the words are
@@ -22,10 +22,11 @@ sidecar copy fresh so reading twice derives once.
   compressed file (`server.log.gz`) is the exception and derives to its text, since there the archive is
   the document. 7z and rar answer that nothing here opens them.
 
-## Check the sidecar first
-A file may already have a shadow at `.intentic/local/cache/derived/<path>.md` — front matter says which
-source hash it was derived from. `fileq read` checks freshness for you, so prefer it over trusting a
-shadow's age by eye.
+## Reading again is free
+A rendering is keyed by the file's sha256 and the reader's version, not its path: `fileq read` on an
+unchanged file, a copy or a move of it, or the same bytes downloaded elsewhere answers from the cache
+without parsing it again. Run it again rather than opening a sidecar under `.intentic/local/cache/derived` by hand; it
+checks the hash for you.
 
 ## What it refuses, and why
 - A scanned PDF with no `tesseract` on PATH answers "no usable text layer … OCR is not part of this tier"

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-    "description": "intentic: session context (map, field notes, iq teaching), Bash output cleaning, document shadows. Each script reads its own /config switch and answers nothing when it is off. Without node on PATH the tool hooks stand down silently and each session opens with one line saying why nothing ran.",
+    "description": "intentic: session context (map, field notes, iq teaching), Bash output cleaning. Each script reads its own /config switch and answers nothing when it is off. Without node on PATH the tool hooks stand down silently and each session opens with one line saying why nothing ran.",
     "hooks": {
         "SessionStart": [
             {
@@ -33,16 +33,6 @@
                         "timeout": 15
                     }
                 ]
-            },
-            {
-                "matcher": "Write|Edit|MultiEdit|NotebookEdit",
-                "hooks": [
-                    {
-                        "type": "command",
-                        "command": "command -v node >/dev/null 2>&1 && node \"${CLAUDE_PLUGIN_ROOT}/dist/post-edit.mjs\"; exit 0",
-                        "timeout": 10
-                    }
-                ]
             }
         ]
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@intentic/claude-plugin",
-  "version": "1.318.0",
-  "description": "The intentic Claude Code plugin: trimmed Bash output, a project map and field notes at session start, iq search and fileq teaching, background document shadows, and a /intentic:stats report of what each saved",
+  "version": "1.319.0",
+  "description": "The intentic Claude Code plugin: trimmed Bash output, a project map and field notes at session start, iq search and fileq teaching, and a /intentic:stats report of what each saved",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -40,8 +40,8 @@
   },
   "devDependencies": {
     "@intentic/agent-context": "0.0.0",
-    "@intentic/fileq": "1.318.0",
-    "@intentic/iq": "1.318.0",
+    "@intentic/fileq": "1.319.0",
+    "@intentic/iq": "1.319.0",
     "@intentic/output-cleaners": "0.0.0",
     "@intentic/testing": "0.0.0",
     "@intentic/tsconfig": "0.0.0",