Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
// Copyright 2026 Ix Infrastructure Inc.
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { Command } from "commander";
import { mkdtempSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { registerTextCommand, resolveTextSearchPath, scanWindow } from "../commands/text.js";
describe("text workspace boundary", () => {
let fixture: string;
let workspace: string;
let outside: string;
let originalCwd: string;
let originalExitCode: number | string | undefined;
let logs: string[];
let runRipgrep: ReturnType<typeof vi.fn<(args: string[]) => Promise<{ stdout: string }>>>;
beforeEach(() => {
fixture = mkdtempSync(join(tmpdir(), "ix-text-boundary-"));
workspace = join(fixture, "workspace");
outside = join(fixture, "outside");
mkdirSync(join(workspace, "src"), { recursive: true });
mkdirSync(outside, { recursive: true });
writeFileSync(join(workspace, "src", "inside.ts"), "export const boundaryNeedle = true;\n");
writeFileSync(join(outside, "outside.ts"), "export const boundaryNeedle = false;\n");
originalCwd = process.cwd();
originalExitCode = process.exitCode;
process.chdir(outside);
process.exitCode = undefined;
logs = [];
vi.spyOn(console, "log").mockImplementation((...args: unknown[]) => {
logs.push(args.join(" "));
});
runRipgrep = vi.fn(async () => ({
stdout: JSON.stringify({
type: "match",
data: {
path: { text: join(workspace, "src", "inside.ts") },
line_number: 1,
lines: { text: "export const boundaryNeedle = true;\n" },
},
}),
}));
});
afterEach(() => {
vi.restoreAllMocks();
process.chdir(originalCwd);
process.exitCode = originalExitCode;
rmSync(fixture, { recursive: true, force: true });
});
async function run(args: string[]): Promise<void> {
const program = new Command();
registerTextCommand(program, runRipgrep);
await program.parseAsync(["node", "ix", ...args]);
}
it("resolves --path relative to --root instead of the process cwd", async () => {
expect(resolveTextSearchPath(workspace, "src")).toBe(join(workspace, "src"));
await run(["text", "boundaryNeedle", "--root", workspace, "--path", "src", "--format", "json"]);
// The scan window, not `--limit`: ranking has to see more rows than it prints.
expect(runRipgrep).toHaveBeenCalledWith(
expect.arrayContaining(["boundaryNeedle", join(workspace, "src")]),
scanWindow(20),
);
expect(JSON.parse(logs.join("\n"))).toMatchObject([{ path: "src/inside.ts" }]);
expect(process.exitCode).toBeUndefined();
});
it("rejects an absolute search path outside the explicit workspace", async () => {
await run(["text", "boundaryNeedle", "--root", workspace, "--path", outside, "--format", "json"]);
expect(JSON.parse(logs.join("\n"))).toMatchObject({ error: "path_outside_workspace" });
expect(process.exitCode).toBe(1);
});
it.skipIf(process.platform === "win32")("rejects a symlink that leaves the workspace", async () => {
symlinkSync(outside, join(workspace, "linked"), "dir");
await run(["text", "boundaryNeedle", "--root", workspace, "--path", "linked", "--format", "json"]);
expect(JSON.parse(logs.join("\n"))).toMatchObject({ error: "path_outside_workspace" });
expect(process.exitCode).toBe(1);
});
});