@selesai/code 0.13.37 → 0.13.39

package/dist/extensions/jev-find-source.ts

@@ -0,0 +1,190 @@
+/**
+ * jev-find-source — the source units `jev_find` asks Jev about and returns verbatim.
+ *
+ * A unit is a line range of one file. JavaScript and TypeScript files are split with the
+ * TypeScript parser into top-level statements (consecutive imports merged, and a class or
+ * interface longer than FIND_CHUNK_LINES split into its members, each keeping the header line),
+ * each with the comments directly above it. Every other file, and a script file when the parser
+ * is not installed, is split into blank-line-separated chunks of at most FIND_CHUNK_LINES lines.
+ * Line numbers are 1-based and always the file's own: excerpts are cut from the file, never
+ * reconstructed.
+ */
+import { extname } from "node:path";
+import type * as TypeScript from "typescript";
+
+type TypeScriptApi = typeof TypeScript;
+
+/** ponytail: 40-line chunks for non-script files; raise once Jev is measured on longer units. */
+export const FIND_CHUNK_LINES = 40;
+const UNIT_NAME_CHARS = 40;
+
+export interface SourceUnit {
+	/** What the unit is: a declaration name, `Class.member`, `imports`, or the chunk's first line. */
+	name: string;
+	/** First line, 1-based, inclusive. */
+	start: number;
+	/** Last line, 1-based, inclusive. */
+	end: number;
+	/** Header line of the enclosing class or interface, kept with a member unit. */
+	header?: number;
+}
+
+let typeScript: Promise<TypeScriptApi | undefined> | undefined;
+
+/**
+ * The TypeScript compiler, or undefined when it is not installed: it is a devDependency, so a
+ * published install parses nothing and every file is chunked instead.
+ */
+export function loadTypeScript(): Promise<TypeScriptApi | undefined> {
+	typeScript ??= import("typescript").then(
+		(module: unknown) => {
+			const api = ((module as { default?: TypeScriptApi }).default ?? module) as TypeScriptApi;
+			return typeof api.createSourceFile === "function" ? api : undefined;
+		},
+		() => undefined,
+	);
+	return typeScript;
+}
+
+const SCRIPT_KINDS: Record<string, "TS" | "TSX" | "JS" | "JSX"> = {
+	".ts": "TS",
+	".tsx": "TSX",
+	".js": "JS",
+	".jsx": "JSX",
+	".mjs": "JS",
+	".cjs": "JS",
+};
+
+/** Whether `path` is split with the TypeScript parser (when it is installed). */
+export function isScriptPath(path: string): boolean {
+	return extname(path).toLowerCase() in SCRIPT_KINDS;
+}
+
+/** A file's source units in file order; `ts` undefined chunks every file. */
+export function splitSourceUnits(path: string, text: string, ts: TypeScriptApi | undefined): SourceUnit[] {
+	const kind = SCRIPT_KINDS[extname(path).toLowerCase()];
+	if (ts && kind) {
+		try {
+			const units = scriptUnits(ts, path, text, ts.ScriptKind[kind]);
+			if (units.length > 0) return units;
+		} catch {
+			// A parser crash on odd input falls back to chunks; the file is still readable.
+		}
+	}
+	return chunkUnits(text);
+}
+
+function firstLine(text: string): string {
+	const line = text.split("\n").find((row) => row.trim() !== "") ?? "";
+	return line.trim().slice(0, UNIT_NAME_CHARS);
+}
+
+function scriptUnits(ts: TypeScriptApi, path: string, text: string, kind: TypeScript.ScriptKind): SourceUnit[] {
+	const source = ts.createSourceFile(path, text, ts.ScriptTarget.Latest, true, kind);
+	const lineOf = (pos: number) => source.getLineAndCharacterOfPosition(pos).line + 1;
+	/**
+	 * A node's first line, counting the comments directly above it: a comment separated by a blank
+	 * line (a section banner) or sitting on the previous node's last line (`a(); // note`) is not its own.
+	 */
+	const startOf = (node: TypeScript.Node, floor: number): number => {
+		let start = lineOf(node.getStart(source));
+		const comments = ts.getLeadingCommentRanges(text, node.pos) ?? [];
+		for (let i = comments.length - 1; i >= 0; i -= 1) {
+			const comment = comments[i];
+			const from = lineOf(comment.pos);
+			if (from <= floor || lineOf(comment.end) < start - 1) break;
+			start = from;
+		}
+		return start;
+	};
+	const nameOf = (node: TypeScript.Node): string => {
+		const named = (node as { name?: TypeScript.Node }).name;
+		if (named) return named.getText(source);
+		if (ts.isVariableStatement(node)) {
+			return node.declarationList.declarations.map((declaration) => declaration.name.getText(source)).join(", ");
+		}
+		if (ts.isConstructorDeclaration(node)) return "constructor";
+		if (ts.isExportAssignment(node)) return "export default";
+		return firstLine(node.getText(source));
+	};
+
+	const units: SourceUnit[] = [];
+	let floor = 0;
+	for (const statement of source.statements) {
+		const start = startOf(statement, floor);
+		const end = lineOf(statement.end);
+		floor = end;
+		if (ts.isImportDeclaration(statement) || ts.isImportEqualsDeclaration(statement)) {
+			const last = units.at(-1);
+			if (last?.name === "imports" && last.end >= start - 1) last.end = end;
+			else units.push({ name: "imports", start, end });
+			continue;
+		}
+		const container =
+			ts.isClassDeclaration(statement) || ts.isInterfaceDeclaration(statement) ? statement : undefined;
+		const members = container?.members;
+		if (container && members && members.length > 0 && end - start + 1 > FIND_CHUNK_LINES) {
+			const owner = nameOf(container);
+			const header = lineOf((container.name ?? container).getStart(source));
+			let memberFloor = header;
+			for (const member of members) {
+				const memberStart = startOf(member, memberFloor);
+				const memberEnd = lineOf(member.end);
+				memberFloor = memberEnd;
+				units.push({
+					name: `${owner}.${nameOf(member)}`,
+					start: memberStart,
+					end: memberEnd,
+					...(memberStart > header ? { header } : {}),
+				});
+			}
+			continue;
+		}
+		units.push({ name: nameOf(statement), start, end });
+	}
+	return units;
+}
+
+/** Blank-line-separated paragraphs packed into chunks of at most FIND_CHUNK_LINES lines. */
+export function chunkUnits(text: string): SourceUnit[] {
+	const rows = text.split("\n");
+	const paragraphs: Array<{ start: number; end: number }> = [];
+	rows.forEach((row, index) => {
+		if (row.trim() === "") return;
+		const last = paragraphs.at(-1);
+		if (last && last.end === index) last.end = index + 1;
+		else paragraphs.push({ start: index + 1, end: index + 1 });
+	});
+	const ranges: Array<{ start: number; end: number }> = [];
+	for (const paragraph of paragraphs) {
+		const current = ranges.at(-1);
+		if (current && paragraph.end - current.start + 1 <= FIND_CHUNK_LINES) {
+			current.end = paragraph.end;
+			continue;
+		}
+		// A paragraph longer than a chunk is cut into chunk-sized pieces.
+		for (let start = paragraph.start; start <= paragraph.end; start += FIND_CHUNK_LINES) {
+			ranges.push({ start, end: Math.min(paragraph.end, start + FIND_CHUNK_LINES - 1) });
+		}
+	}
+	return ranges.map((range) => ({ ...range, name: firstLine(rows[range.start - 1]) }));
+}
+
+/**
+ * Line windows around the best keyword lines (±`context` lines), merged where they overlap: the
+ * source returned when Jev could not judge a file's units. With no keyword line, the file's head.
+ */
+export function keywordWindows(lineCount: number, hits: readonly number[], context = 3, maxWindows = 3): SourceUnit[] {
+	if (lineCount <= 0) return [];
+	const anchors = [...new Set(hits.filter((line) => line >= 1 && line <= lineCount))].slice(0, maxWindows);
+	if (anchors.length === 0) return [{ name: "file head", start: 1, end: Math.min(lineCount, 2 * context + 1) }];
+	const windows: SourceUnit[] = [];
+	for (const line of anchors.sort((a, b) => a - b)) {
+		const start = Math.max(1, line - context);
+		const end = Math.min(lineCount, line + context);
+		const last = windows.at(-1);
+		if (last && start <= last.end + 1) last.end = Math.max(last.end, end);
+		else windows.push({ name: "keyword window", start, end });
+	}
+	return windows;
+}

package/dist/extensions/package.json

@@ -24,9 +24,9 @@
 			"./tokenin-onboarding.ts",
 			"./pi-graft",
 			"./undo.ts",
+			"./pi-web-agent",
 			"./pi-subagents",
 			"./pi-tool-display",
-			"./pi-web-agent",
 			"./pi-hermes-memory",
 			"./tps.ts",
 			"./capability-gateway",

package/dist/extensions/pi-graft/cli.test.ts

@@ -68,8 +68,8 @@ describe("installGraft", () => {
 	it("runs the compatible global npm install without a shell off Windows", async () => {
 		const { pi } = makePi(async () => execReturning(OK));
 		const run = await installGraft(pi.exec as never, "/repo");
-		expect(GRAFT_INSTALL_SPEC).toBe("@nanonets/graft@^0.18");
-		expect(INSTALL_COMMAND).toBe("npm install -g @nanonets/graft@^0.18");
+		expect(GRAFT_INSTALL_SPEC).toBe("@nanonets/graft@^0.21");
+		expect(INSTALL_COMMAND).toBe("npm install -g @nanonets/graft@^0.21");
 		const [command, args, options] = pi.exec.mock.calls[0] as [string, string[], { cwd: string; timeout: number }];
 		expect(command).toBe(process.platform === "win32" ? "cmd" : "npm");
 		expect(args).toContain("install");
@@ -118,7 +118,7 @@ describe("version handling", () => {
 
 	it("accepts the verified range and rejects the boundaries", () => {
 		expect(isCompatibleVersion(MIN_GRAFT_VERSION)).toBe(true);
-		expect(isCompatibleVersion("0.18.4")).toBe(true);
+		expect(isCompatibleVersion("0.21.1")).toBe(true);
 		expect(isCompatibleVersion("0.99.0")).toBe(true);
 		expect(isCompatibleVersion("0.17.9")).toBe(false);
 		expect(isCompatibleVersion(MAX_GRAFT_VERSION_EXCLUSIVE)).toBe(false);
@@ -128,9 +128,9 @@ describe("version handling", () => {
 
 describe("probeGraft", () => {
 	it("accepts a supported version and reports it", async () => {
-		const { pi } = makePi(async () => execReturning({ ...OK, stdout: "0.18.0\n" }));
+		const { pi } = makePi(async () => execReturning({ ...OK, stdout: "0.21.1\n" }));
 		const probe = await probeGraft(pi.exec as never, "/repo");
-		expect(probe).toMatchObject({ kind: "ok", version: "0.18.0" });
+		expect(probe).toMatchObject({ kind: "ok", version: "0.21.1" });
 		if (probe.kind === "ok") expect(probe.argv.at(-1)).toBe("--version");
 	});
 

package/dist/extensions/pi-graft/cli.ts

@@ -15,7 +15,7 @@
  *   Selesai model for deep enrichment, otherwise stay structural and local.
  * - Extension-spawned commands default to telemetry opt-out (`DO_NOT_TRACK=1`).
  *
- * Verified against @nanonets/graft 0.18.0 (see {@link MIN_GRAFT_VERSION}).
+ * Verified against @nanonets/graft 0.21.1 (see {@link MIN_GRAFT_VERSION}).
  */
 
 import { truncateHead, type ExecOptions, type ExecResult } from "@selesai/code";
@@ -27,8 +27,13 @@ export const GRAFT_PACKAGE = "@nanonets/graft";
  * Lowest Graft CLI whose documented surface this adapter was verified against:
  * `ask --source/--json`, `skeleton`, `callers --direction/-d`, `grep --in/-i/--fixed`,
  * `map --max-dirs`, `check --json`, `build [--deep]`, and `--version`.
+ *
+ * The floor sits on the 0.21 minor line this adapter is verified against
+ * (0.21.1). Upgrades are deliberate: an executable below the floor reports
+ * `incompatible`, and the adapter never overwrites it — the user upgrades with
+ * {@link INSTALL_COMMAND}.
  */
-export const MIN_GRAFT_VERSION = "0.18.0";
+export const MIN_GRAFT_VERSION = "0.21.0";
 /** Upper bound is exclusive: a 1.x CLI is allowed to change its contract. */
 export const MAX_GRAFT_VERSION_EXCLUSIVE = "1.0.0";
 
@@ -45,8 +50,8 @@ export const DEEP_BUILD_TIMEOUT_MS = 1_800_000;
 /** Global npm installs can be slow on a cold cache. */
 export const INSTALL_TIMEOUT_MS = 180_000;
 
-/** Kept on the verified 0.18 minor line; never install a floating latest CLI. */
-export const GRAFT_INSTALL_SPEC = `${GRAFT_PACKAGE}@^0.18`;
+/** Kept on the verified 0.21 minor line; never install a floating latest CLI. */
+export const GRAFT_INSTALL_SPEC = `${GRAFT_PACKAGE}@^0.21`;
 export const INSTALL_COMMAND = `npm install -g ${GRAFT_INSTALL_SPEC}`;
 export const TELEMETRY_ENV = "DO_NOT_TRACK";
 
@@ -399,7 +404,7 @@ export interface AskHit {
 }
 
 /**
- * `graft ask --json` result, as emitted by `AskResult` upstream (0.18.0).
+ * `graft ask --json` result, as emitted by `AskResult` upstream (0.21.1).
  *
  * Every field is optional on read: a CLI that changes shape degrades to raw
  * text rather than to a wrong summary, and callers must never treat the parse

package/dist/extensions/pi-graft/commands.test.ts

@@ -15,11 +15,11 @@ import {
 import { MODE_ENTRY_TYPE, type GraftState } from "./state.ts";
 import { notified, makeCtx, makePi, type CtxStub } from "./test-support.ts";
 
-const HEALTHY: GraftState = { name: "fresh-structural", version: "0.18.0" };
+const HEALTHY: GraftState = { name: "fresh-structural", version: "0.21.1" };
 
 function installOf(overrides: Partial<GraftInstallRun> = {}): GraftInstallRun {
 	return {
-		argv: ["npm", "install", "-g", "@nanonets/graft@^0.18"],
+		argv: ["npm", "install", "-g", "@nanonets/graft@^0.21"],
 		cwd: "/repo",
 		code: 0,
 		stdout: "",
@@ -75,7 +75,7 @@ function makeRuntime(
 	const recheck = vi.fn(async () => {});
 	const installCli = vi.fn(async () => {
 		const result = overrides.installResult ?? installOf();
-		if (result.code === 0 && !result.killed) state = overrides.postInstallState ?? { name: "unbuilt", version: "0.18.0" };
+		if (result.code === 0 && !result.killed) state = overrides.postInstallState ?? { name: "unbuilt", version: "0.21.1" };
 		return result;
 	});
 	const runBuild = vi.fn(async () => overrides.buildResult ?? runOf());
@@ -134,7 +134,7 @@ describe("formatDoctor", () => {
 	it("reports repository, executable, graph, state, mode, telemetry and provider boundary", () => {
 		const text = formatDoctor(base);
 		expect(text).toContain("/repo (git ✓)");
-		expect(text).toContain("graft 0.18.0");
+		expect(text).toContain("graft 0.21.1");
 		expect(text).toContain("structural only");
 		expect(text).toContain("fresh-structural");
 		expect(text).toContain("nothing is injected");
@@ -188,7 +188,7 @@ describe("formatStatus", () => {
 			providerEnv: [],
 		});
 		expect(text.split("\n")).toHaveLength(4);
-		expect(text).toContain("graft: ● structural v0.18.0");
+		expect(text).toContain("graft: ● structural v0.21.1");
 		expect(text).toContain("hybrid");
 		expect(text).toContain("root: /repo");
 	});

package/dist/extensions/pi-graft/graft.integration.test.ts

@@ -6,7 +6,7 @@
  * adapter against the real executable, and it skips itself when no compatible
  * Graft CLI is on PATH — which is the state of ordinary CI.
  *
- * To run it for real: `npm install -g @nanonets/graft@^0.18` then
+ * To run it for real: `npm install -g @nanonets/graft@^0.21` then
  *   npx vitest run src/extensions/pi-graft/graft.integration.test.ts
  *
  * A structural build is tree-sitter only: no model, no API key, no network. The

package/dist/extensions/pi-graft/lifecycle.test.ts

@@ -39,7 +39,7 @@ function writeProjectSettings(value: unknown): void {
 function exec(graftOutput = ASK_JSON) {
 	return async (command: string, args: string[]) => {
 		if (command === "git" && args.includes("--show-toplevel")) return { ...OK, stdout: `${repo}\n` };
-		if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+		if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 		return { ...OK, stdout: graftOutput };
 	};
 }
@@ -88,7 +88,7 @@ describe("session start", () => {
 	it("resolves the Git working tree, probes the executable, and publishes a status line", async () => {
 		const session = await bootSession();
 		expect(session.commandsRun()).toEqual(["git rev-parse --show-toplevel", "graft --version"]);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
 		await session.reset();
 	});
 
@@ -163,7 +163,7 @@ describe("session start", () => {
 			}
 			if (args.includes("--version")) {
 				if (!installed) throw new Error("spawn graft ENOENT");
-				return { ...OK, stdout: "0.18.0\n" };
+				return { ...OK, stdout: "0.21.1\n" };
 			}
 			return { ...OK };
 		});
@@ -171,8 +171,8 @@ describe("session start", () => {
 		const ctx = makeCtx({ cwd: repo });
 		const start = handlerFor(harness, "session_start") as (e: unknown, c: unknown) => Promise<void>;
 		await start({ type: "session_start", reason: "startup" }, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
-		expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.18");
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
+		expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.21");
 
 		await start({ type: "session_start", reason: "reload" }, ctx);
 		expect(harness.commandsRun().filter((command) => command.startsWith("npm install"))).toHaveLength(1);
@@ -202,7 +202,7 @@ describe("session start", () => {
 		writeProjectSettings({});
 		const harness = makePi(async (command: string) => {
 			if (command === "git") return { code: 128, stdout: "", stderr: "not a git repository", killed: false };
-			return { ...OK, stdout: "0.18.0\n" };
+			return { ...OK, stdout: "0.21.1\n" };
 		});
 		graftExtension(harness.pi as never);
 		const ctx = makeCtx({ cwd: repo });
@@ -233,14 +233,14 @@ describe("mutation awareness", () => {
 	it("marks the graph changed after a successful edit", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "edit", { path: "src/a.ts" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 		await session.reset();
 	});
 
 	it("marks the graph changed after a clearly mutating bash command", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "bash", { command: "rm -rf dist" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 		await session.reset();
 	});
 
@@ -249,7 +249,7 @@ describe("mutation awareness", () => {
 		await onToolResult(session, "read", { path: "src/a.ts" });
 		await onToolResult(session, "bash", { command: "git status" });
 		await onToolResult(session, "edit", { path: "src/a.ts" }, true);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
 		await session.reset();
 	});
 });
@@ -270,7 +270,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -283,7 +283,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		expect(harness.commandsRun()).toContain("graft build");
 	});
 
@@ -294,7 +294,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -314,7 +314,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build", "--deep"]);
 		expect(build[2]).toMatchObject({
@@ -335,7 +335,7 @@ describe("proactive refresh", () => {
 		const models: string[] = [];
 		const harness = makePi(async (command: string, args: string[], options?: unknown) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				const model = (options as { env?: Record<string, string> }).env?.GRAFT_MODEL ?? "";
 				models.push(model);
@@ -359,7 +359,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
 		expect(models).toEqual(["deepseek-v4.1-flash", "glm-5.3-flash"]);
 		expect(notified(ctx)).toContain("retrying the deep pass");
 	});
@@ -371,7 +371,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -388,7 +388,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build"]);
 	});
@@ -403,11 +403,11 @@ describe("proactive refresh", () => {
 			{ type: "tool_result", toolName: "write", toolCallId: "c1", input: {}, content: [], isError: false },
 			session.ctx,
 		);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 
 		await (handlerFor(session, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, session.ctx);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ⚙ syncing v0.18.0");
-		await vi.waitFor(() => expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ⚙ syncing v0.21.1");
+		await vi.waitFor(() => expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		expect(session.commandsRun()).toContain("graft build");
 		await session.reset();
 	});
@@ -434,7 +434,7 @@ describe("proactive refresh", () => {
 		writeProjectSettings({ refreshDebounceSeconds: 0 });
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${repo}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) return { code: 1, stdout: "", stderr: "✗ index failed", killed: false };
 			return { ...OK, stdout: ASK_JSON };
 		});
@@ -449,7 +449,7 @@ describe("proactive refresh", () => {
 			ctx,
 		);
 		await (handlerFor(harness, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ✕ failed v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ✕ failed v0.21.1"));
 	});
 });
 
@@ -541,7 +541,7 @@ describe("retrieval strategy", () => {
 		writeProjectSettings({ mode: "push" });
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${repo}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			return { code: 1, stdout: "", stderr: "✗ graph missing", killed: false };
 		});
 		graftExtension(harness.pi as never);
@@ -565,7 +565,7 @@ describe("retrieval strategy", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: { mode: "push" } }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -642,7 +642,7 @@ describe("tool readiness", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -671,7 +671,7 @@ describe("tool readiness", () => {
 				gitCalls += 1;
 				return { code: 128, stdout: "", stderr: "not a git repository", killed: false };
 			}
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			return { ...OK, stdout: ASK_JSON };
 		});
 		graftExtension(harness.pi as never);

package/dist/extensions/pi-graft/prompt.test.ts

@@ -13,7 +13,7 @@ import {
 } from "./prompt.ts";
 import { DEFAULT_MIN_COVERAGE, type GraftState } from "./state.ts";
 
-const FRESH: GraftState = { name: "fresh-structural", version: "0.18.0" };
+const FRESH: GraftState = { name: "fresh-structural", version: "0.21.1" };
 
 function payload(overrides: Partial<AskPayload> = {}): AskPayload {
 	return {

package/dist/extensions/pi-graft/state.test.ts

@@ -22,8 +22,8 @@ import {
 } from "./state.ts";
 
 const UNBUILT: GraftState = { name: "unbuilt", detail: "no graph yet" };
-const FRESH: GraftState = { name: "fresh-structural", version: "0.18.0", deep: false };
-const DEEP: GraftState = { name: "fresh-deep", version: "0.18.0", deep: true };
+const FRESH: GraftState = { name: "fresh-structural", version: "0.21.1", deep: false };
+const DEEP: GraftState = { name: "fresh-deep", version: "0.21.1", deep: true };
 
 describe("reduceGraftState", () => {
 	it("only claims a repository once root resolution says there is a Git working tree", () => {
@@ -36,16 +36,16 @@ describe("reduceGraftState", () => {
 	});
 
 	it("derives built/fresh/deep from what is actually on disk", () => {
-		expect(reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: ABSENT_GRAPH })).toEqual({
+		expect(reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: ABSENT_GRAPH })).toEqual({
 			name: "unbuilt",
-			version: "0.18.0",
+			version: "0.21.1",
 			detail: expect.stringContaining("/graft build"),
 		});
 		expect(
-			reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: { built: true, deep: false } }),
+			reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: { built: true, deep: false } }),
 		).toEqual(FRESH);
 		expect(
-			reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: { built: true, deep: true } }),
+			reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: { built: true, deep: true } }),
 		).toMatchObject({ name: "fresh-deep", deep: true });
 	});
 
@@ -91,7 +91,7 @@ describe("reduceGraftState", () => {
 		expect(reduceGraftState(FRESH, { type: "build-started", deep: true })).toMatchObject({
 			name: "building",
 			deep: true,
-			version: "0.18.0",
+			version: "0.21.1",
 		});
 	});
 
@@ -140,8 +140,8 @@ describe("state predicates and rendering", () => {
 	});
 
 	it("renders a compact status line with the version when it is known", () => {
-		expect(statusText(FRESH)).toBe("graft: ● structural v0.18.0");
-		expect(statusText(DEEP)).toBe("graft: ● deep v0.18.0");
+		expect(statusText(FRESH)).toBe("graft: ● structural v0.21.1");
+		expect(statusText(DEEP)).toBe("graft: ● deep v0.21.1");
 		expect(statusText({ name: "unavailable" })).toBe("graft: ✕ no cli");
 		expect(statusText({ name: "changed" })).toBe("graft: ◐ changed");
 	});

package/dist/extensions/pi-graft/test-support.ts

@@ -190,7 +190,7 @@ export function makeCtx(
  */
 export function healthyExec(overrides: { gitRoot?: string; version?: string; queryOutput?: string } = {}): ExecImpl {
 	const gitRoot = overrides.gitRoot ?? "/repo";
-	const version = overrides.version ?? "0.18.0";
+	const version = overrides.version ?? "0.21.1";
 	return async (command, args) => {
 		if (command === "git" && args.includes("--show-toplevel")) return { ...OK, stdout: `${gitRoot}\n` };
 		if (args.includes("--version")) return { ...OK, stdout: `${version}\n` };

package/dist/extensions/pi-graft/tools.test.ts

@@ -64,7 +64,7 @@ function makeHarness(
 	const runtime: GraftToolRuntime = {
 		run: run as never,
 		settings: () => options.settings ?? {},
-		state: () => options.state ?? { name: "fresh-structural", version: "0.18.0" },
+		state: () => options.state ?? { name: "fresh-structural", version: "0.21.1" },
 		noteQuery: ((_ctx: unknown, result: GraftRun) => {
 			noted.push(result);
 		}) as never,

package/dist/extensions/pi-subagents/agents/researcher.md

@@ -1,7 +1,7 @@
 ---
 name: researcher
 description: Autonomous web researcher — searches, evaluates, and synthesizes a focused research brief
-tools: read, write, web_search, fetch_content, get_search_content, source_check
+tools: read, write, web_explore
 thinking: medium
 systemPromptMode: replace
 inheritProjectContext: true
@@ -16,11 +16,10 @@ Given a question or topic, run focused web research and produce a concise, well-
 
 Working rules:
 - Break the problem into 2-4 distinct research angles.
-- Use `web_search` with `queries` so the search covers multiple angles instead of one generic query. Use `workflow: "none"` unless the task explicitly needs the interactive curator.
-- Treat search-result summaries as discovery aids, not final evidence for important claims. Fetch the original source when a claim is important, disputed, surprising, or decision-relevant.
+- Use `web_explore` once per research angle with a focused `query`; it handles search, fetch, and source ranking internally. Call it again with a narrower query to fill gaps.
+- Treat search-result summaries as discovery aids, not final evidence for important claims. Re-check important, disputed, surprising, or decision-relevant claims against the original source with a narrower `web_explore` query.
 - Prefer primary, official, authoritative, or directly relevant sources. Keep a smaller set of strong sources rather than many weak or redundant ones; reject stale, redundant, or SEO-heavy sources, and flag stale evidence when freshness materially affects the answer.
-- Use `source_check` against fetched source content for decision-critical or disputed claims, benchmark/performance claims, pricing/licensing claims, security claims, and wording that could materially affect a recommendation. Do not use it for every trivial fact.
-- `source_check` must be registered by the loaded provider before launch. If a registered `source_check` call fails, continue by fetching and inspecting the original source directly, and disclose the validation limitation rather than failing the research run.
+- Verify decision-critical or disputed claims, benchmark/performance claims, pricing/licensing claims, security claims, and wording that could materially affect a recommendation against the original source. Do not do this for every trivial fact. Disclose any validation limitation rather than failing the research run.
 - Label direct evidence, source interpretation, and researcher inference distinctly. Never present an inference as if the source stated it directly.
 - Record contradictions instead of silently resolving them. Record missing evidence when a claim cannot be verified.
 - Never invent dates, quotations, citations, or unsupported precision.