@hassangameryt/freeflow 0.5.0 → 0.7.0

package/pi-extension/tests/output-router/search.test.js

@@ -1,722 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-
-import freeflow from "../../dist/index.js";
-import { createVault, readOutputText, storeCommandOutput } from "../../../router/dist/index.js";
-
-function registerMockPi() {
-  const tools = new Map();
-  const commands = new Map();
-  const handlers = new Map();
-  const pi = {
-    registerTool(tool) {
-      tools.set(tool.name, tool);
-    },
-    registerCommand(name, command) {
-      commands.set(name, command);
-    },
-    on(name, handler) {
-      handlers.set(name, handler);
-    },
-    appendEntry() {},
-    async sendUserMessage() {},
-    async exec() {
-      throw new Error("exec should not be called in pi extension transform tests");
-    },
-  };
-  freeflow(pi);
-  return { tools, commands, handlers };
-}
-
-function mockCtx(cwd = process.cwd(), sessionId = "pi-extension-search-test") {
-  return {
-    cwd,
-    ui: {
-      notify() {},
-      setStatus() {},
-    },
-    sessionManager: {
-      getSessionId: () => sessionId,
-    },
-  };
-}
-
-const testTheme = {
-  fg(_color, text) {
-    return text;
-  },
-  bold(text) {
-    return text;
-  },
-};
-
-function renderText(component, width = 120) {
-  return component.render(width).join("\n");
-}
-
-function schemaMatches(schema, value) {
-  return schemaErrors(schema, value).length === 0;
-}
-
-function schemaErrors(schema, value, path = "$") {
-  if (!schema) {
-    return [];
-  }
-
-  const errors = [];
-  if (schema.oneOf) {
-    const matches = schema.oneOf.filter((candidate) => schemaMatches(candidate, value));
-    if (matches.length !== 1) {
-      errors.push(`${path} should match exactly one schema, matched ${matches.length}`);
-    }
-  }
-  if (schema.anyOf) {
-    const matches = schema.anyOf.filter((candidate) => schemaMatches(candidate, value));
-    if (matches.length === 0) {
-      errors.push(`${path} should match at least one schema`);
-    }
-  }
-  if (schema.allOf) {
-    for (const candidate of schema.allOf) {
-      errors.push(...schemaErrors(candidate, value, path));
-    }
-  }
-  if (schema.not && schemaMatches(schema.not, value)) {
-    errors.push(`${path} should not match forbidden schema`);
-  }
-
-  if (schema.type) {
-    const validType =
-      schema.type === "object"
-        ? value !== null && typeof value === "object" && !Array.isArray(value)
-        : schema.type === "array"
-          ? Array.isArray(value)
-          : schema.type === "integer"
-            ? Number.isInteger(value)
-            : schema.type === "number"
-              ? typeof value === "number"
-              : typeof value === schema.type;
-    if (!validType) {
-      errors.push(`${path} should be ${schema.type}`);
-      return errors;
-    }
-  }
-
-  if (Object.prototype.hasOwnProperty.call(schema, "const") && value !== schema.const) {
-    errors.push(`${path} should equal ${schema.const}`);
-  }
-  if (schema.enum && !schema.enum.includes(value)) {
-    errors.push(`${path} should be one of ${schema.enum.join(", ")}`);
-  }
-  if (typeof value === "string") {
-    if (schema.minLength !== undefined && value.length < schema.minLength) {
-      errors.push(`${path} should have length >= ${schema.minLength}`);
-    }
-    if (schema.pattern && !new RegExp(schema.pattern).test(value)) {
-      errors.push(`${path} should match ${schema.pattern}`);
-    }
-  }
-  if (typeof value === "number") {
-    if (schema.minimum !== undefined && value < schema.minimum) {
-      errors.push(`${path} should be >= ${schema.minimum}`);
-    }
-    if (schema.maximum !== undefined && value > schema.maximum) {
-      errors.push(`${path} should be <= ${schema.maximum}`);
-    }
-  }
-
-  if (Array.isArray(value)) {
-    if (schema.minItems !== undefined && value.length < schema.minItems) {
-      errors.push(`${path} should have at least ${schema.minItems} item(s)`);
-    }
-    if (schema.items) {
-      value.forEach((item, index) => {
-        errors.push(...schemaErrors(schema.items, item, `${path}[${index}]`));
-      });
-    }
-  }
-
-  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
-    for (const key of schema.required ?? []) {
-      if (!Object.prototype.hasOwnProperty.call(value, key)) {
-        errors.push(`${path}.${key} is required`);
-      }
-    }
-    if (schema.additionalProperties === false && schema.properties) {
-      for (const key of Object.keys(value)) {
-        if (!Object.prototype.hasOwnProperty.call(schema.properties, key)) {
-          errors.push(`${path}.${key} is not allowed`);
-        }
-      }
-    }
-    for (const [key, propertySchema] of Object.entries(schema.properties ?? {})) {
-      if (Object.prototype.hasOwnProperty.call(value, key)) {
-        errors.push(...schemaErrors(propertySchema, value[key], `${path}.${key}`));
-      }
-    }
-  }
-
-  return errors;
-}
-
-function assertSchemaAccepts(schema, value) {
-  assert.deepEqual(schemaErrors(schema, value), []);
-}
-
-function assertSchemaRejects(schema, value) {
-  assert.equal(schemaMatches(schema, value), false, `schema unexpectedly accepted ${JSON.stringify(value)}`);
-}
-
-function collectSchemaKeys(schema, keys, path = "$", found = []) {
-  if (!schema || typeof schema !== "object") {
-    return found;
-  }
-  for (const key of keys) {
-    if (Object.prototype.hasOwnProperty.call(schema, key)) {
-      found.push(`${path}.${key}`);
-    }
-  }
-  for (const [key, value] of Object.entries(schema)) {
-    if (value && typeof value === "object") {
-      collectSchemaKeys(value, keys, `${path}.${key}`, found);
-    }
-  }
-  return found;
-}
-
-test("Pi extension registers public freeflow_search with deterministic operation schema", () => {
-  const { tools } = registerMockPi();
-  const search = tools.get("freeflow_search");
-
-  assert.ok(search, "freeflow_search should be registered");
-  assert.equal(tools.has("freeflow_script_transform"), false);
-  assert.deepEqual(search.parameters.required, ["action"]);
-  assert.deepEqual(search.parameters.properties.source.properties.kind.enum, ["repo", "local", "vault"]);
-  assert.match(search.description, /Search|transform/i);
-  assert.match(search.promptGuidelines.join("\n"), /action=transform/i);
-  assert.deepEqual(collectSchemaKeys(search.parameters, ["oneOf", "anyOf", "allOf", "not", "const"]), []);
-
-  const operationKinds = search.parameters.properties.operation.properties.kind.enum;
-  assert.deepEqual(operationKinds, [
-    "regexFilter",
-    "countMatches",
-    "jsonExtract",
-    "groupByRegex",
-    "dedupe",
-    "topN",
-    "extractUrls",
-    "extractCitations",
-    "lineStats",
-    "sizeStats",
-    "script",
-  ]);
-});
-
-test("Pi extension freeflow_search schema stays Pi-compatible while rejecting invalid primitive shapes", () => {
-  const { tools } = registerMockPi();
-  const search = tools.get("freeflow_search");
-  const schema = search.parameters;
-  const source = { kind: "vault", outputId: "ffout_source" };
-
-  assertSchemaAccepts(schema, {
-    action: "query",
-    source: { kind: "local", root: "/absolute/local/docs" },
-    query: "docs marker",
-  });
-  assertSchemaAccepts(schema, {
-    action: "retrieve",
-    source: { kind: "local", root: "/absolute/local/docs", path: "README.md" },
-    lineRange: { start: 1, end: 3 },
-  });
-  assertSchemaAccepts(schema, { action: "transform", source, operation: { kind: "jsonExtract", pointer: "" } });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", pointer: "/suite/failures/0/message" },
-  });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", pointer: "/escaped~0tilde/~1slash" },
-  });
-  assertSchemaAccepts(schema, { action: "transform", source, operation: { kind: "jsonExtract", path: "$" } });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", path: "$.suite.failures[0]" },
-  });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", path: '$["quoted.key"]' },
-  });
-  assertSchemaAccepts(schema, { action: "transform", source, operation: { kind: "topN", limit: 10 } });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "topN", limit: 10, pattern: "duration=(\\d+)", flags: "im", group: "1", sort: "numeric" },
-  });
-  assertSchemaAccepts(schema, {
-    action: "transform",
-    sources: [{ kind: "vault", outputId: "ffout_source", stream: "combined", alias: "test_log" }],
-    operation: { kind: "script", language: "python", code: "write_text('ok')" },
-    limits: { timeoutMs: 1000, maxInputBytes: 2048, maxOutputBytes: 4096 },
-  });
-
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source: { kind: "file", outputId: "ffout_source" },
-    operation: { kind: "lineStats" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", pointer: "not/a/pointer" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", pointer: "/bad~2escape" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", pointer: "/dangling~" },
-  });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "jsonExtract", path: "$." } });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", path: "$['singleQuoted']" },
-  });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "jsonExtract", path: "$[01]" } });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", path: '$["unterminated]' },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "jsonExtract", path: '$["bad\\xescape"]' },
-  });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "notReal" } });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "topN", limit: 10, group: 1 } });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "regexFilter", pattern: "FAIL", flags: "ii" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "regexFilter", pattern: "FAIL", flags: "y" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "regexFilter", pattern: "FAIL", contextLines: 21 },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "regexFilter", pattern: "FAIL", maxMatches: 1001 },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "groupByRegex", pattern: "kind=(\\w+)", maxGroups: 1001 },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "groupByRegex", pattern: "kind=(\\w+)", maxLinesPerGroup: 1001 },
-  });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "dedupe", maxLines: 10001 } });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "topN", limit: 1001 } });
-  assertSchemaRejects(schema, { action: "transform", source, operation: { kind: "extractUrls", maxMatches: 1001 } });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    source,
-    operation: { kind: "extractCitations", maxMatches: 1001 },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    sources: [{ kind: "vault", outputId: "ffout_source", alias: "1bad" }],
-    operation: { kind: "script", language: "python", code: "ok" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    sources: [{ kind: "vault", outputId: "ffout_source", alias: "ok" }],
-    operation: { kind: "script", language: "ruby", code: "ok" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    sources: [{ kind: "vault", outputId: "ffout_source", alias: "ok" }],
-    operation: { kind: "script", language: "python", code: "" },
-  });
-  assertSchemaRejects(schema, {
-    action: "transform",
-    sources: [{ kind: "vault", outputId: "ffout_source", alias: "ok" }],
-    operation: { kind: "script", language: "python", code: "ok" },
-    limits: { timeoutMs: 0 },
-  });
-});
-
-test("Pi extension public freeflow_search returns structured disabled result for script transform by default", async () => {
-  const cwd = await mkdtemp(join(tmpdir(), "freeflow-pi-transform-script-disabled-"));
-  try {
-    await mkdir(join(cwd, ".freeflow"));
-    await writeFile(
-      join(cwd, ".freeflow/config.json"),
-      JSON.stringify({ defaultMode: "workflow", outputRouter: { enabled: true } }),
-      "utf8",
-    );
-
-    const { tools } = registerMockPi();
-    const search = tools.get("freeflow_search");
-    const result = await search.execute(
-      "search-transform-script-disabled",
-      {
-        action: "transform",
-        sources: [{ kind: "vault", outputId: "ffout_missing", alias: "missing" }],
-        operation: { kind: "script", language: "python", code: "print('RAW_SCRIPT_SENTINEL')" },
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, "pi-extension-search-script-disabled-test"),
-    );
-
-    assert.equal(result.details.result.failure.kind, "script_transform_disabled");
-    assert.equal(result.details.result.transformExecution.status, "unavailable");
-    assert.equal(result.details.result.persistence.recoverability, "none");
-    assert.doesNotMatch(JSON.stringify(result.details.result), /RAW_SCRIPT_SENTINEL/);
-  } finally {
-    await rm(cwd, { recursive: true, force: true });
-  }
-});
-
-test("Pi extension public freeflow_search returns structured failures for operation-specific validation", async () => {
-  const cwd = await mkdtemp(join(tmpdir(), "freeflow-pi-transform-invalid-"));
-  const sessionId = "pi-extension-search-invalid-test";
-  try {
-    const vaultRoot = join(cwd, "vault");
-    await mkdir(join(cwd, ".freeflow"));
-    await writeFile(
-      join(cwd, ".freeflow/config.json"),
-      JSON.stringify({ defaultMode: "workflow", outputRouter: { enabled: true, vaultRoot } }),
-      "utf8",
-    );
-
-    const vault = createVault({ root: vaultRoot });
-    const source = await storeCommandOutput(vault, {
-      sessionId,
-      command: "printf json",
-      stdout: '{"suite":{"failed":1}}',
-      stderr: "",
-      executionStatus: "success",
-      exitCode: 0,
-      createdAt: "2026-06-22T00:13:00.000Z",
-    });
-
-    const { tools } = registerMockPi();
-    const search = tools.get("freeflow_search");
-    const missingSelector = await search.execute(
-      "search-transform-invalid-json",
-      {
-        action: "transform",
-        source: { kind: "vault", outputId: source.outputId, stream: "stdout" },
-        operation: { kind: "jsonExtract" },
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, sessionId),
-    );
-
-    assert.equal(missingSelector.details.result.failure.kind, "transform_validation_failure");
-    assert.equal(missingSelector.details.result.transformExecution.status, "rejected");
-    assert.match(missingSelector.details.result.failure.message, /exactly one JSON selector/);
-
-    const topNGroupWithoutPattern = await search.execute(
-      "search-transform-invalid-topn",
-      {
-        action: "transform",
-        source: { kind: "vault", outputId: source.outputId, stream: "stdout" },
-        operation: { kind: "topN", limit: 10, group: "1" },
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, sessionId),
-    );
-
-    assert.equal(topNGroupWithoutPattern.details.result.failure.kind, "transform_validation_failure");
-    assert.equal(topNGroupWithoutPattern.details.result.transformExecution.status, "rejected");
-    assert.match(topNGroupWithoutPattern.details.result.failure.message, /topN group requires a pattern/);
-  } finally {
-    await rm(cwd, { recursive: true, force: true });
-  }
-});
-
-test("Pi extension public freeflow_search action=transform processes repo files", async () => {
-  const cwd = await mkdtemp(join(tmpdir(), "freeflow-pi-search-transform-repo-"));
-  try {
-    await mkdir(join(cwd, ".freeflow"));
-    await writeFile(
-      join(cwd, ".freeflow/config.json"),
-      JSON.stringify({ defaultMode: "workflow", outputRouter: { enabled: true } }),
-      "utf8",
-    );
-    await writeFile(
-      join(cwd, "test-output.txt"),
-      [
-        " RUN  v2.1.8 /repo",
-        " ✗ src/components/UserList.test.tsx (4 tests) 234ms",
-        " Test Files  1 failed | 2 passed (3)",
-        " Tests       1 failed | 7 passed (8)",
-      ].join("\n"),
-      "utf8",
-    );
-
-    const { tools } = registerMockPi();
-    const search = tools.get("freeflow_search");
-    const result = await search.execute(
-      "search-transform-repo",
-      {
-        action: "transform",
-        source: { kind: "repo", path: "test-output.txt" },
-        goal: "test output summary",
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, "pi-extension-search-transform-repo-test"),
-    );
-
-    const visibleText = result.content[0].text;
-    const routed = result.details.result;
-    assert.match(visibleText, /freeflow_search\|ok\|transform/);
-    assert.match(visibleText, /1 failed/);
-    assert.equal(routed.status, "ok");
-    assert.equal(routed.implementation, "processing-engine-skeleton-v1");
-    assert.equal(routed.source.displayPath, "test-output.txt");
-    assert.equal(routed.reducer.status, "selected");
-    assert.equal(routed.reducer.selected.name, "test-output");
-  } finally {
-    await rm(cwd, { recursive: true, force: true });
-  }
-});
-
-test("Pi extension public freeflow_search action=transform processes explicit local files", async () => {
-  const cwd = await mkdtemp(join(tmpdir(), "freeflow-pi-search-transform-local-cwd-"));
-  const localRoot = await mkdtemp(join(tmpdir(), "freeflow-pi-search-transform-local-source-"));
-  try {
-    await mkdir(join(cwd, ".freeflow"));
-    await writeFile(
-      join(cwd, ".freeflow/config.json"),
-      JSON.stringify({ defaultMode: "workflow", outputRouter: { enabled: true } }),
-      "utf8",
-    );
-    await writeFile(
-      join(localRoot, "test-output.txt"),
-      [
-        " RUN  v2.1.8 /external-docs",
-        " ✗ docs/LocalDocs.test.ts (1 test) 42ms",
-        " Test Files  1 failed | 0 passed (1)",
-        " Tests       1 failed | 0 passed (1)",
-      ].join("\n"),
-      "utf8",
-    );
-
-    const { tools } = registerMockPi();
-    const search = tools.get("freeflow_search");
-    const result = await search.execute(
-      "search-transform-local",
-      {
-        action: "transform",
-        source: { kind: "local", root: localRoot, path: "test-output.txt" },
-        goal: "test output summary",
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, "pi-extension-search-transform-local-test"),
-    );
-
-    const visibleText = result.content[0].text;
-    const routed = result.details.result;
-    assert.match(visibleText, /freeflow_search\|ok\|transform\|local-file:test-output\.txt/);
-    assert.match(visibleText, /1 failed/);
-    assert.equal(routed.status, "ok");
-    assert.equal(routed.implementation, "processing-engine-skeleton-v1");
-    assert.equal(routed.source.kind, "local-file");
-    assert.equal(routed.source.ref.kind, "local");
-    assert.equal(routed.source.displayPath, "test-output.txt");
-    assert.equal(routed.reducer.status, "selected");
-    assert.equal(routed.reducer.selected.name, "test-output");
-  } finally {
-    await rm(cwd, { recursive: true, force: true });
-    await rm(localRoot, { recursive: true, force: true });
-  }
-});
-
-test("Pi extension public freeflow_search executes against vaulted output", async () => {
-  const cwd = await mkdtemp(join(tmpdir(), "freeflow-pi-transform-"));
-  const sessionId = "pi-extension-search-execute-test";
-  try {
-    const vaultRoot = join(cwd, "vault");
-    await mkdir(join(cwd, ".freeflow"));
-    await writeFile(
-      join(cwd, ".freeflow/config.json"),
-      JSON.stringify({ defaultMode: "workflow", outputRouter: { enabled: true, vaultRoot } }),
-      "utf8",
-    );
-
-    const vault = createVault({ root: vaultRoot });
-    const source = await storeCommandOutput(vault, {
-      sessionId,
-      command: "npm test",
-      stdout: ["PASS first", "FAIL target", "FAIL second"].join("\n"),
-      stderr: "",
-      executionStatus: "failed",
-      exitCode: 1,
-      createdAt: "2026-06-22T00:12:00.000Z",
-    });
-
-    const { tools } = registerMockPi();
-    const search = tools.get("freeflow_search");
-    const result = await search.execute(
-      "search-transform-regex",
-      {
-        action: "transform",
-        source: { kind: "vault", outputId: source.outputId, stream: "stdout" },
-        operation: { kind: "regexFilter", pattern: "FAIL", contextLines: 0, maxMatches: 10 },
-        preserve: "important",
-      },
-      undefined,
-      undefined,
-      mockCtx(cwd, sessionId),
-    );
-
-    const visibleText = result.content[0].text;
-    const routed = result.details.result;
-    assert.match(visibleText, /freeflow_search\|routed/);
-    assert.match(visibleText, /regexFilter/);
-    assert.doesNotMatch(visibleText, /^\s*\{/);
-    assert.ok(Buffer.byteLength(visibleText, "utf8") < Buffer.byteLength(JSON.stringify(routed, null, 2), "utf8"));
-    assert.equal(routed.toolStatus, "ok");
-    assert.equal(routed.routing.route, "transform");
-    assert.equal(routed.routing.status, "routed");
-    assert.equal(routed.producer.name, "regexFilter");
-    assert.equal(routed.source.outputId, source.outputId);
-    assert.equal(routed.persistence.recoverability, "exact");
-    assert.deepEqual(routed.lineage.sourceOutputIds, [source.outputId]);
-    assert.ok(routed.outputId.startsWith("ffout_"));
-
-    const raw = await readOutputText(vault, sessionId, routed.outputId, "raw");
-    assert.match(raw, /# freeflow_search action=transform regexFilter/);
-    assert.match(raw, /matches: 2/);
-    assert.match(raw, /2\| FAIL target/);
-    assert.match(raw, /3\| FAIL second/);
-  } finally {
-    await rm(cwd, { recursive: true, force: true });
-  }
-});
-
-test("Pi extension freeflow_search renders source, operation, lineage, routing, persistence, evidence, and recovery", () => {
-  const { tools } = registerMockPi();
-  const search = tools.get("freeflow_search");
-
-  const call = renderText(
-    search.renderCall(
-      {
-        action: "transform",
-        source: { kind: "vault", outputId: "ffout_source123", stream: "stdout" },
-        operation: { kind: "topN", pattern: "duration=(\\d+)", group: 1, sort: "numeric", order: "desc", limit: 2 },
-        preserve: "important",
-      },
-      testTheme,
-    ),
-  );
-  assert.match(call, /freeflow_search transform/);
-  assert.match(call, /vault ffout_source123:stdout/);
-  assert.doesNotMatch(call, /raw json/);
-
-  const toolResult = {
-    content: [{ type: "text", text: "raw json should not be the visible UI" }],
-    details: {
-      result: {
-        toolStatus: "ok",
-        decisionId: "ffdec_transform_test",
-        preserve: "important",
-        outputId: "ffout_transform123",
-        recordId: "ffrec_transform123",
-        action: "transform",
-        source: { kind: "vault", outputId: "ffout_source123", stream: "stdout" },
-        operation: { kind: "topN", pattern: "duration=(\\d+)", group: 1, sort: "numeric", order: "desc", limit: 2 },
-        producer: { kind: "transform", name: "topN" },
-        persistence: { status: "vaulted", recoverability: "exact", recoveryOutputId: "ffout_transform123" },
-        lineage: {
-          sourceOutputIds: ["ffout_source123"],
-          sourceRecordIds: ["ffrec_source123"],
-          operation: "topN",
-          operationHash: "sha256_abcdef",
-        },
-        routing: {
-          status: "routed",
-          route: "transform",
-          reason: "Transformed output was vaulted and returned within routing caps.",
-        },
-        summary: "Transformed topN from vaulted stdout output: returned 2 of 3 matched line(s).",
-        evidence: [
-          {
-            id: "ev_transform",
-            source: { kind: "vault", outputId: "ffout_transform123", stream: "raw" },
-            path: "ffout_transform123:raw",
-            lines: "1-8",
-            excerpt: "# freeflow_search topN\n2| score=200 | duration=200 slow",
-            why: "Transformed exact topN output from source ffout_source123:stdout within routing caps; source lineage is preserved.",
-            window: "exact",
-            expandable: true,
-          },
-        ],
-        recovery: {
-          how: "Use freeflow_search with source.kind=vault and outputId=ffout_transform123 to recover exact transformed content.",
-          outputId: "ffout_transform123",
-        },
-      },
-    },
-  };
-
-  const collapsed = renderText(search.renderResult(toolResult, { expanded: false }, testTheme));
-  assert.match(collapsed, /freeflow_search topN/);
-  assert.match(collapsed, /routing: routed/);
-  assert.match(collapsed, /persistence vaulted\/exact/);
-  assert.match(collapsed, /transformed output recoverable from vault/);
-  assert.doesNotMatch(collapsed, /raw json/);
-
-  const expanded = renderText(search.renderResult(toolResult, { expanded: true }, testTheme));
-  assert.match(expanded, /toolStatus: ok/);
-  assert.match(expanded, /routing\.status: routed/);
-  assert.match(expanded, /persistence: vaulted \/ exact/);
-  assert.match(expanded, /Storage/);
-  assert.match(expanded, /decisionId: ffdec_transform_test/);
-  assert.match(expanded, /recordId: ffrec_transform123/);
-  assert.match(expanded, /Source/);
-  assert.match(expanded, /ffout_source123:stdout/);
-  assert.match(expanded, /Operation/);
-  assert.match(expanded, /"kind":"topN"/);
-  assert.match(expanded, /Lineage/);
-  assert.match(expanded, /sourceOutputIds: ffout_source123/);
-  assert.match(expanded, /Evidence/);
-  assert.match(expanded, /evidenceId: ev_transform/);
-  assert.match(expanded, /source: vault ffout_transform123:raw/);
-  assert.match(expanded, /expandable: true/);
-  assert.match(expanded, /duration=200 slow/);
-  assert.match(expanded, /Recovery/);
-  assert.match(expanded, /ffout_transform123/);
-  assert.match(
-    expanded,
-    /exact search: action=retrieve source.kind=vault lineRange=1-8 stream=raw outputId=ffout_transform123/,
-  );
-});