@intentic/claude-plugin 1.317.0 → 1.319.0

package/generated/skills/iq/SKILL.md

@@ -33,6 +33,12 @@ iq "where do we enforce the secrets floor?"
 
 Every answer opens with a capsule (`answer:`, `candidates:`, `more:`). Read that and stop — do not pipe through `head`; `--budget` already caps output. Scope with `--in`, `--repo`, `--lang`, `--glob`. Wrong grep habits (`iq search`, `iq ask`) are rewritten to `q`; use canonical forms next time. Full verb list: `iq --help`.
 
+A question's `answer:` line ends with a verdict:
+
+- `confident` — the top result stands out. Read it and stop.
+- `ambiguous` — the top files scored close. The answer is probably among them and the `candidates:`; compare those rather than searching again.
+- `weak` — no result scored as a likely answer, so what you asked about probably does not exist in this workspace. Stop and say so, or rephrase once in the code's own words (the name you would expect it to have). A second `weak` means it is not here. Do not read on through the candidates or fall back to grep hunting for it.
+
 **Session recall:** `iq sessions grab "topic"` for ranked excerpts from past sessions; `iq sessions files "topic"` for files those sessions touched. Verify load-bearing hits against current code.
 
 **Another conversation**, rather than what past sessions touched, is the `agents` CLI: `agents show <handle>` answers one whole (its task, where it got to, branch, worktree, delta, record) from any spelling of its name — id, branch, id prefix, session id, or title words. `agents ls` is the fleet, `agents find '<text>'` is who said a phrase. Never search `/history` by hand for one.

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.317.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.317.0",
-    "@intentic/iq": "0.0.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",

package/dist/post-edit.mjs

@@ -1,252 +0,0 @@
-import { createRequire as __intenticRequire } from 'node:module'; const require = __intenticRequire(import.meta.url);
-
-// 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 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 projectSlug = (project) => project.replace(/[^a-zA-Z0-9]/g, "-");
-
-// src/features.ts
-var OPTIONS = {
-  output_cleaners: {
-    type: "boolean",
-    title: "Trim Bash output",
-    description: "Clean what a successful command printed before Claude reads it (progress bars, install chatter, repeated lines, the middle of huge logs), keep the full text retrievable with `retrieve-output`, and ledger what each cleaner saved.",
-    default: true
-  },
-  cleaners: {
-    type: "string",
-    title: "Cleaners",
-    description: "Which cleaners run, as the sandbox spells it: empty for all, `-cap,-wide` to switch some off, `git,pnpm` to allow only those. `/intentic:stats` lists them by what they saved.",
-    default: ""
-  },
-  output_holdout: {
-    type: "number",
-    title: "Untrimmed share",
-    description: "Share of commands left untrimmed, so the saving can be measured against a real comparison and not only computed. 0 turns the comparison off; the exact per-command saving is reported either way.",
-    default: 0,
-    min: 0,
-    max: 0.5
-  },
-  project_map: {
-    type: "boolean",
-    title: "Project map",
-    description: "Open each session with a map of the project it starts in: its areas, what each is for, and where Claude is standing. Worked out from the tree every time, never stored, so it cannot go stale.",
-    default: true
-  },
-  field_notes: {
-    type: "boolean",
-    title: "Field notes",
-    description: "Open each session with this project's field notes: the traps past sessions hit and the commands that really verify. Written by `/intentic:field-notes` from your own sessions here; nothing is sent until you run it once.",
-    default: true
-  },
-  iq: {
-    type: "boolean",
-    title: "iq search",
-    description: "Teach Claude the `iq` code search CLI and recall past sessions on a matching prompt. Needs `npm i -g @intentic/iq`; without it this switch does nothing and says so once.",
-    default: true
-  },
-  fileq: {
-    type: "boolean",
-    title: "fileq",
-    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",
-    description: "Share of sessions opened without the map, the field notes and the iq teaching, so `/intentic:stats` can show what each changed. 0 sends them to every session and measures nothing.",
-    default: 0.1,
-    min: 0,
-    max: 0.5
-  }
-};
-var asBoolean = (raw, fallback) => {
-  const value = raw?.trim().toLowerCase();
-  if (value === "true" || value === "1" || value === "yes" || value === "on") {
-    return true;
-  }
-  if (value === "false" || value === "0" || value === "no" || value === "off") {
-    return false;
-  }
-  return fallback;
-};
-var asShare = (raw, option) => {
-  const value = raw === void 0 || raw.trim() === "" ? Number.NaN : Number(raw);
-  return Number.isFinite(value) ? Math.min(option.max, Math.max(option.min, value)) : option.default;
-};
-var optionEnvName = (key) => `CLAUDE_PLUGIN_OPTION_${key.toUpperCase()}`;
-var readOptions = (env = process.env) => {
-  const entries = Object.keys(OPTIONS).map((key) => {
-    const option = OPTIONS[key];
-    const raw = env[optionEnvName(key)];
-    if (option.type === "boolean") {
-      return [key, asBoolean(raw, option.default)];
-    }
-    if (option.type === "number") {
-      return [key, asShare(raw, option)];
-    }
-    return [key, raw ?? option.default];
-  });
-  return Object.fromEntries(entries);
-};
-
-// 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) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf8");
-};
-var parseHookInput = (text) => {
-  try {
-    const value = JSON.parse(text);
-    return typeof value === "object" && value !== null ? value : void 0;
-  } catch {
-    return void 0;
-  }
-};
-var runHook = async (handle) => {
-  try {
-    const raw = await readStdin();
-    const input = parseHookInput(raw);
-    if (input === void 0) {
-      return;
-    }
-    const answer = await handle(input, raw);
-    if (typeof answer === "string") {
-      process.stdout.write(answer);
-    } else if (answer !== void 0) {
-      process.stdout.write(`${JSON.stringify(answer)}
-`);
-    }
-  } catch (error) {
-    process.stderr.write(`intentic: ${error instanceof Error ? error.message : String(error)}
-`);
-  }
-};
-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";
-
-// ../fileq/src/lib/formats.ts
-import { extname } from "node:path";
-var EXTENSION_FORMAT = {
-  ".docx": "docx",
-  ".xlsx": "xlsx",
-  ".pptx": "pptx",
-  ".odt": "odt",
-  ".ott": "odt",
-  // a template is the same document with a different intent
-  ".ods": "ods",
-  ".ots": "ods",
-  ".odp": "odp",
-  ".otp": "odp",
-  ".odg": "odp",
-  // a drawing is a presentation of one page
-  ".rtf": "rtf",
-  ".epub": "epub",
-  ".ipynb": "ipynb",
-  // JSON: no magic bytes name it, so the extension is the whole recognition.
-  ".cpuprofile": "profile",
-  // V8 profiles are JSON too: named by extension alone, like a notebook.
-  ".heapprofile": "profile",
-  ".pdf": "pdf",
-  ".png": "image",
-  ".jpg": "image",
-  ".jpeg": "image",
-  ".gif": "image",
-  ".webp": "image",
-  ".tif": "image",
-  ".tiff": "image",
-  ".heic": "image",
-  ".avif": "image",
-  ".mp3": "media",
-  ".wav": "media",
-  ".flac": "media",
-  ".ogg": "media",
-  ".opus": "media",
-  ".aac": "media",
-  ".m4a": "media",
-  ".mp4": "media",
-  ".mov": "media",
-  ".webm": "media",
-  ".mkv": "media",
-  ".html": "html",
-  ".htm": "html",
-  // Archives, including the three zip-underneath package formats (a jar, a war and a wheel are each a zip with a
-  // manifest); a double extension like `.tar.gz` is recognized by its last one, which is the compressor.
-  ".zip": "archive",
-  ".jar": "archive",
-  ".war": "archive",
-  ".whl": "archive",
-  ".tar": "archive",
-  ".tgz": "archive",
-  ".gz": "archive",
-  ".bz2": "archive",
-  ".xz": "archive",
-  ".zst": "archive",
-  ".7z": "archive",
-  ".rar": "archive"
-};
-var isCandidatePath = (path) => extname(path).toLowerCase() in EXTENSION_FORMAT;
-
-// src/shadows.ts
-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 derivablePath = (project, file) => {
-  const rel = isAbsolute(file) ? relative(project, file) : file;
-  return rel === "" || rel.startsWith("..") || isAbsolute(rel) || !isCandidatePath(rel) ? void 0 : rel.split("\\").join("/");
-};
-var deriveNow = (data, project, rel, env = process.env) => {
-  startDetached(process.execPath, [fileq(env), "derive", rel], { cwd: project, log: logOf(data, project, "derive"), env: fileqEnv(env, project) });
-};
-
-// src/post-edit.ts
-var PATH_KEYS = ["file_path", "notebook_path"];
-var postEdit = (input, env = process.env) => {
-  if (!readOptions(env).shadows) {
-    return void 0;
-  }
-  const project = projectDir(input, env);
-  for (const key of PATH_KEYS) {
-    const file = input.tool_input?.[key];
-    const rel = typeof file === "string" ? derivablePath(project, file) : void 0;
-    if (rel !== void 0) {
-      deriveNow(dataDir(env), project, rel, env);
-      return void 0;
-    }
-  }
-  return void 0;
-};
-if (process.argv[1]?.endsWith("post-edit.mjs")) {
-  await runHook((input) => postEdit(input));
-}
-export {
-  postEdit
-};