@intentic/claude-plugin 1.326.0 → 1.328.0

package/dist/stats.mjs

@@ -75,9 +75,6 @@ var MECHANISMS = {
   map: { metrics: [ROOT_LISTINGS, CALLS_BEFORE_TARGET], sampleUnit: "opening turns", sample: openingTurn },
   // The brief rides the whole session, so turn 40 is as much evidence as turn 1.
   notes: { metrics: [FAILED_CALLS, CALLS_BEFORE_TARGET], sampleUnit: "conversations", sample: meanOfTurns },
-  // Judged on what the long form was written to prevent: calls that fail, calls spent before reaching the work, and
-  // the round trips its batching and context-reuse paragraphs ask the agent not to spend.
-  guidance: { metrics: [FAILED_CALLS, CALLS_BEFORE_TARGET, ROUND_TRIPS], sampleUnit: "conversations", sample: meanOfTurns },
   // Judged on what it is for, the prompt each call carries, and on what it could cost: a model that has lost a result
   // it needed runs the tool again (more round trips) or guesses (more calls that fail).
   clearing: { metrics: [CONTEXT_PER_CALL, ROUND_TRIPS, FAILED_CALLS], sampleUnit: "conversations", sample: meanOfTurns }
@@ -125,6 +122,53 @@ var measureExperiment = (turns, design) => {
 import { readdirSync, readFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 
+// ../../_search/iq/src/recall/transcript/lines.ts
+var asRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+var asString = (value) => typeof value === "string" ? value : void 0;
+var typeOf = (line) => asString(line["type"]);
+var INTERRUPTION = "[Request interrupted by user";
+var kindOf = (line, text) => {
+  if (line["isMeta"] === true) {
+    return "meta";
+  }
+  if (line["isCompactSummary"] === true) {
+    return "compaction";
+  }
+  if (text.startsWith("<local-command-")) {
+    return "local-command";
+  }
+  if (text.startsWith("<command-")) {
+    return "command";
+  }
+  return text.startsWith(INTERRUPTION) ? "interruption" : "typed";
+};
+var promptOf = (line) => {
+  if (typeOf(line) !== "user") {
+    return void 0;
+  }
+  const content = asRecord(line["message"])?.["content"];
+  let text;
+  if (typeof content === "string") {
+    text = content;
+  } else if (Array.isArray(content)) {
+    const texts = [];
+    for (const block of content) {
+      const record = asRecord(block);
+      if (record?.["type"] === "tool_result") {
+        return { kind: "tool-result", text: "" };
+      }
+      const blockText = record?.["type"] === "text" ? asString(record["text"]) : void 0;
+      if (blockText !== void 0) {
+        texts.push(blockText);
+      }
+    }
+    text = texts.join("\n");
+  } else {
+    return void 0;
+  }
+  return { kind: kindOf(line, text), text };
+};
+
 // ../agent-context/src/tool-calls.ts
 import { isAbsolute, relative } from "node:path";
 var DISPLAY_NAMES = {
@@ -138,7 +182,10 @@ var DISPLAY_NAMES = {
   webfetch: "WebFetch",
   websearch: "WebSearch",
   task: "Task",
-  patch: "Edit"
+  patch: "Edit",
+  // The page tools a chat draws from (the sandbox's agent/pages), named for a reader rather than by their server.
+  mcp__ui__show_page: "Show page",
+  mcp__ui__ask_page: "Ask on a page"
 };
 var BROWSER_TOOL = /^mcp__.+__browser_(.+)$/;
 var BROWSER_VERB_NAMES = { take_screenshot: "screenshot" };
@@ -337,16 +384,9 @@ var isMissing = (error) => {
   const code = typeof error === "object" && error !== null ? error.code : void 0;
   return code === "ENOENT" || code === "ENOTDIR";
 };
-var promptOf = (line) => {
-  if (line.type !== "user" || line.isMeta === true || line.isCompactSummary === true) {
-    return void 0;
-  }
-  const content = line.message?.content;
-  if (Array.isArray(content) && content.some((block) => block["type"] === "tool_result")) {
-    return void 0;
-  }
-  const text = textOf(content);
-  return text.startsWith("<local-command-") ? void 0 : text;
+var promptOf2 = (line) => {
+  const prompt = promptOf(line);
+  return prompt?.kind === "typed" || prompt?.kind === "command" ? prompt.text : void 0;
 };
 var callsOf = (line, options, subagent) => {
   const content = line.message?.content;
@@ -382,7 +422,12 @@ var failuresOf = (line) => {
     return [];
   }
   return content.flatMap(
-    (block) => block["type"] === "tool_result" && block["is_error"] === true && typeof block["tool_use_id"] === "string" ? [{ id: block["tool_use_id"], text: (typeof block["content"] === "string" ? block["content"] : textOf(block["content"])).slice(0, FAILURE_TEXT_CHARS) }] : []
+    (block) => block["type"] === "tool_result" && block["is_error"] === true && typeof block["tool_use_id"] === "string" ? [
+      {
+        id: block["tool_use_id"],
+        text: (typeof block["content"] === "string" ? block["content"] : textOf(block["content"])).slice(0, FAILURE_TEXT_CHARS)
+      }
+    ] : []
   );
 };
 var readClaudeTranscript = (text, options) => {
@@ -396,7 +441,7 @@ var readClaudeTranscript = (text, options) => {
     }
     sessionId ??= line.sessionId;
     cwd ??= line.cwd;
-    const prompt = promptOf(line);
+    const prompt = promptOf2(line);
     if (prompt !== void 0) {
       turns.push({ index: turns.length, at: stampOf(line) ?? turns.at(-1)?.at ?? 0, prompt, calls: [], failures: [] });
       continue;

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

@@ -13,7 +13,7 @@ The evidence is the digest below: this project's own Claude Code sessions, read
 
 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.
+SIZE IS PART OF THE RANKING. The intentic plugin sends the `meta` block on every turn, then whole sections in rank order until the owner's budget runs out (4,000 characters by default, `meta` included), and stops at the first section that does not fit, so one long section silences every rank below it. The priority table is the order, never sent, so keep its cells to a few words for whoever opens the file; 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/iq/SKILL.md

@@ -11,6 +11,8 @@ Pick by what you already know:
 - **You know the file** (stack trace, failing test) → `iq outline <path>` for its shape, then `iq read <path>::<symbol>`; `iq context path:line` when all you have is a line.
 - **You know the symbol, but want its anchor or callers** → `iq def X` / `iq refs X` — one call, not grep-then-filter.
 - **You don't know where it lives** → bare `iq "…"`. No separate verb for questions.
+- **You have text off a screenshot** (a label, an error, a toast) → bare `iq "the text as shown"`, filled-in values and all. Text the workspace holds verbatim leads the answer; UI text in a translation catalog resolves to its key and answers with the component that renders it, so do not `rg` the key afterwards.
+- **You have an address** (`/agents`, `/sandbox/agent?section=tools`) → `iq '/sandbox/agent?section=tools'`. It answers with the route declaration, the view it loads, and the branch each parameter and query value selects.
 - **Checking your own edit** → `grep`/`rg`. Verification is not discovery.
 
 ```
@@ -32,12 +34,16 @@ iq "where do we enforce the secrets floor?"
 | several at once | `iq multi "def foo" "refs bar"` |
 | do an answer's anchors hold? | `iq verify answer.md` (or pipe it in) |
 
-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`.
+Every answer opens with a capsule (`answer:`, `candidates:`, `more:`). Read that and stop — do not pipe through `head`; `--budget` already caps output. Lines under `answer:` say what it resolved through and what is next to it:
+
+- `key: agents.agentActions.noConversationLeft · …/en.json:8 (+4 locales) · used at …/agentActions.ts:178` — the translation key UI text matched, and where code uses it.
+- `route: /sandbox/:tab? at …/router/index.ts:375 loads …/SandboxHub.vue`, then one `tab=agent: …` line per value followed into the view.
+- `siblings: pictureQuickLook.ts · ChatImageThumb.test.ts · …` — the other source files in the answer's folder, the ones iq ranked first. iq usually lands in the right folder; when the answer is a near miss, pick the neighbour from here instead of searching again. 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.
+- `confident` — the top result scored as an answer on its own and clearly ahead of the rest, or is an exact match (one translation key, one route, one definition). Read it and stop.
+- `ambiguous` — the most common word: nothing stood out enough to be sure. The answer is usually among the top files, their `siblings:` 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/claude-plugin",
-  "version": "1.326.0",
+  "version": "1.328.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",
@@ -40,13 +40,13 @@
   },
   "devDependencies": {
     "@intentic/agent-context": "0.0.0",
-    "@intentic/fileq": "1.326.0",
-    "@intentic/iq": "1.326.0",
+    "@intentic/fileq": "1.328.0",
+    "@intentic/iq": "1.328.0",
     "@intentic/output-cleaners": "0.0.0",
     "@intentic/testing": "0.0.0",
     "@intentic/tsconfig": "0.0.0",
     "@types/bun": "1.4.2",
-    "@types/node": "24.13.6",
+    "@types/node": "24.19.1",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "esbuild": "0.28.2"
   },