ankui 0.1.0

package/dist/scanner/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../src/scanner/parallel.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAmB,EACnB,MAA8C,EAC9C,OAA2B;IAE3B,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,UAAU,CAClB,kEAAkE,WAAW,GAAG,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAY,SAAS,CAAC;IAEpC,KAAK,UAAU,MAAM;QACnB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO;YACrC,MAAM,CAAC,GAAG,SAAS,CAAC;YACpB,SAAS,IAAI,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACH,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,CAAC,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,UAAU,KAAK,SAAS;oBAAE,UAAU,GAAG,KAAK,CAAC;gBACjD,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/scanner/parsing.d.ts

@@ -0,0 +1,9 @@
+import { type SafeResult, type SafetyCheckOptions } from "./safety.js";
+export declare function readJsonFile(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<unknown>>;
+export declare function readJsoncFile(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<unknown>>;
+export declare function readTomlFile(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<unknown>>;
+export declare function readMarkdownFile(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<string>>;
+export declare function parseJsonText(text: string, sourcePath: string): SafeResult<unknown>;
+export declare function parseJsoncText(text: string, sourcePath: string): SafeResult<unknown>;
+export declare function parseTomlText(text: string, sourcePath: string): SafeResult<unknown>;
+export declare function parseYamlText(text: string, sourcePath: string): SafeResult<unknown>;

package/dist/scanner/parsing.js

@@ -0,0 +1,135 @@
+import { parse as parseJsonc, printParseErrorCode } from "jsonc-parser";
+import { parse as parseToml } from "smol-toml";
+import { parse as parseYaml } from "yaml";
+import { createWarning } from "../types.js";
+import { maskSecretText, maskSecrets, safeReadTextFile } from "./safety.js";
+export async function readJsonFile(filePath, options = {}) {
+    const text = await safeReadTextFile(filePath, options);
+    if (!text.ok) {
+        return text;
+    }
+    const parsed = parseJsonText(text.value, filePath);
+    if (!parsed.ok) {
+        return {
+            ok: false,
+            warnings: [...text.warnings, ...parsed.warnings]
+        };
+    }
+    return {
+        ok: true,
+        value: parsed.value,
+        warnings: [...text.warnings, ...parsed.warnings]
+    };
+}
+export async function readJsoncFile(filePath, options = {}) {
+    const text = await safeReadTextFile(filePath, options);
+    if (!text.ok) {
+        return text;
+    }
+    const parsed = parseJsoncText(text.value, filePath);
+    if (!parsed.ok) {
+        return {
+            ok: false,
+            warnings: [...text.warnings, ...parsed.warnings]
+        };
+    }
+    return {
+        ok: true,
+        value: parsed.value,
+        warnings: [...text.warnings, ...parsed.warnings]
+    };
+}
+export async function readTomlFile(filePath, options = {}) {
+    const text = await safeReadTextFile(filePath, options);
+    if (!text.ok) {
+        return text;
+    }
+    const parsed = parseTomlText(text.value, filePath);
+    if (!parsed.ok) {
+        return {
+            ok: false,
+            warnings: [...text.warnings, ...parsed.warnings]
+        };
+    }
+    return {
+        ok: true,
+        value: parsed.value,
+        warnings: [...text.warnings, ...parsed.warnings]
+    };
+}
+export async function readMarkdownFile(filePath, options = {}) {
+    const text = await safeReadTextFile(filePath, options);
+    if (!text.ok) {
+        return text;
+    }
+    return {
+        ok: true,
+        value: maskSecretText(text.value),
+        warnings: text.warnings
+    };
+}
+export function parseJsonText(text, sourcePath) {
+    try {
+        return {
+            ok: true,
+            value: maskSecrets(JSON.parse(text)),
+            warnings: []
+        };
+    }
+    catch (error) {
+        return createParseFailure(sourcePath, error);
+    }
+}
+export function parseJsoncText(text, sourcePath) {
+    const errors = [];
+    const parsed = parseJsonc(text, errors, {
+        allowTrailingComma: true,
+        disallowComments: false
+    });
+    if (errors.length > 0) {
+        return createParseFailure(sourcePath, `JSONC parse error: ${errors.map((error) => printParseErrorCode(error.error)).join(", ")}`);
+    }
+    return {
+        ok: true,
+        value: maskSecrets(parsed),
+        warnings: []
+    };
+}
+export function parseTomlText(text, sourcePath) {
+    try {
+        return {
+            ok: true,
+            value: maskSecrets(parseToml(text)),
+            warnings: []
+        };
+    }
+    catch (error) {
+        return createParseFailure(sourcePath, error);
+    }
+}
+export function parseYamlText(text, sourcePath) {
+    try {
+        return {
+            ok: true,
+            value: maskSecrets(parseYaml(text)),
+            warnings: []
+        };
+    }
+    catch (error) {
+        return createParseFailure(sourcePath, error);
+    }
+}
+function createParseFailure(sourcePath, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        ok: false,
+        warnings: [
+            createWarning({
+                reason: "parse_failed",
+                path: sourcePath,
+                message: `Could not parse ${sourcePath}: ${message}`
+            })
+        ]
+    };
+}
+//# sourceMappingURL=parsing.js.map

package/dist/scanner/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/scanner/parsing.ts"],"names":[],"mappings":"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"}

package/dist/scanner/paths.d.ts

@@ -0,0 +1,8 @@
+export interface PathContext {
+    cwd?: string;
+    homeDir?: string;
+}
+export declare function resolveLocalPath(inputPath: string, context?: PathContext): string;
+export declare function toDisplayPath(inputPath: string, context?: PathContext): string;
+export declare function isPathInside(childPath: string, parentPath: string): boolean;
+export declare function splitPathSegments(inputPath: string): string[];

package/dist/scanner/paths.js

@@ -0,0 +1,39 @@
+import os from "node:os";
+import path from "node:path";
+export function resolveLocalPath(inputPath, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const homeDir = context.homeDir ?? os.homedir();
+    if (inputPath === "~") {
+        return path.resolve(homeDir);
+    }
+    if (inputPath.startsWith("~/")) {
+        return path.resolve(homeDir, inputPath.slice(2));
+    }
+    if (path.isAbsolute(inputPath)) {
+        return path.normalize(inputPath);
+    }
+    return path.resolve(cwd, inputPath);
+}
+export function toDisplayPath(inputPath, context = {}) {
+    const homeDir = path.resolve(context.homeDir ?? os.homedir());
+    const normalizedPath = path.resolve(inputPath);
+    if (normalizedPath === homeDir) {
+        return "~";
+    }
+    if (isPathInside(normalizedPath, homeDir)) {
+        return `~/${path.relative(homeDir, normalizedPath)}`;
+    }
+    return normalizedPath;
+}
+export function isPathInside(childPath, parentPath) {
+    const relativePath = path.relative(path.resolve(parentPath), path.resolve(childPath));
+    return (relativePath === "" ||
+        (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)));
+}
+export function splitPathSegments(inputPath) {
+    return path
+        .normalize(inputPath)
+        .split(/[\\/]+/)
+        .filter((segment) => segment.length > 0);
+}
+//# sourceMappingURL=paths.js.map

package/dist/scanner/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/scanner/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,UAAuB,EAAE;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAEhD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,UAAuB,EAAE;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/C,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,UAAkB;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtF,OAAO,CACL,YAAY,KAAK,EAAE;QACnB,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI;SACR,SAAS,CAAC,SAAS,CAAC;SACpB,KAAK,CAAC,QAAQ,CAAC;SACf,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/scanner/preview.d.ts

@@ -0,0 +1,12 @@
+import { type SafeResult, type SafetyCheckOptions } from "./safety.js";
+export declare const DEFAULT_PREVIEW_LINES = 10;
+export interface Preview {
+    sourcePath: string;
+    lines: string[];
+    truncated: boolean;
+}
+export declare function readSanitizedPreview(filePath: string, options?: SafetyCheckOptions & {
+    maxLines?: number;
+}): Promise<SafeResult<Preview>>;
+export declare function createSanitizedPreview(text: string, sourcePath: string, maxLines?: number): Preview;
+export declare function countTextLines(text: string): number;

package/dist/scanner/preview.js

@@ -0,0 +1,29 @@
+import { maskSecretText, safeReadTextFile } from "./safety.js";
+export const DEFAULT_PREVIEW_LINES = 10;
+export async function readSanitizedPreview(filePath, options = {}) {
+    const text = await safeReadTextFile(filePath, options);
+    if (!text.ok) {
+        return text;
+    }
+    return {
+        ok: true,
+        value: createSanitizedPreview(text.value, filePath, options.maxLines),
+        warnings: text.warnings
+    };
+}
+export function createSanitizedPreview(text, sourcePath, maxLines = DEFAULT_PREVIEW_LINES) {
+    const normalizedLines = splitNormalizedLines(text);
+    const previewLines = normalizedLines.slice(0, maxLines).map((line) => maskSecretText(line));
+    return {
+        sourcePath,
+        lines: previewLines,
+        truncated: normalizedLines.length > maxLines
+    };
+}
+export function countTextLines(text) {
+    return splitNormalizedLines(text).length;
+}
+function splitNormalizedLines(text) {
+    return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+}
+//# sourceMappingURL=preview.js.map

package/dist/scanner/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/scanner/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAQxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,UAAsD,EAAE;IAExD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEvD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,sBAAsB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;QACrE,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,UAAkB,EAClB,QAAQ,GAAG,qBAAqB;IAEhC,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5F,OAAO;QACL,UAAU;QACV,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,eAAe,CAAC,MAAM,GAAG,QAAQ;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC"}

package/dist/scanner/project-discovery.d.ts

@@ -0,0 +1,11 @@
+import type { FoundProject } from "./filesystem-crawler.js";
+export declare const MIN_PROJECTS_FOR_DEFAULT_ON = 3;
+export interface DevRootCandidate {
+    parentPath: string;
+    projectCount: number;
+    projectPaths: string[];
+    defaultOn: boolean;
+}
+export declare function groupProjectsByParent(projects: readonly FoundProject[]): DevRootCandidate[];
+export declare function applyDefaultOnHeuristic(candidates: readonly DevRootCandidate[]): DevRootCandidate[];
+export declare function selectDefaultOnRoots(candidates: readonly DevRootCandidate[]): string[];

package/dist/scanner/project-discovery.js

@@ -0,0 +1,35 @@
+export const MIN_PROJECTS_FOR_DEFAULT_ON = 3;
+export function groupProjectsByParent(projects) {
+    const byParent = new Map();
+    for (const project of projects) {
+        const list = byParent.get(project.parentPath) ?? [];
+        list.push(project.projectPath);
+        byParent.set(project.parentPath, list);
+    }
+    const candidates = [];
+    for (const [parentPath, projectPaths] of byParent) {
+        candidates.push({
+            parentPath,
+            projectCount: projectPaths.length,
+            projectPaths,
+            defaultOn: false
+        });
+    }
+    candidates.sort((a, b) => {
+        if (b.projectCount !== a.projectCount) {
+            return b.projectCount - a.projectCount;
+        }
+        return a.parentPath.localeCompare(b.parentPath);
+    });
+    return applyDefaultOnHeuristic(candidates);
+}
+export function applyDefaultOnHeuristic(candidates) {
+    return candidates.map((candidate) => ({
+        ...candidate,
+        defaultOn: candidate.projectCount >= MIN_PROJECTS_FOR_DEFAULT_ON
+    }));
+}
+export function selectDefaultOnRoots(candidates) {
+    return candidates.filter((c) => c.defaultOn).map((c) => c.parentPath);
+}
+//# sourceMappingURL=project-discovery.js.map

package/dist/scanner/project-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery.js","sourceRoot":"","sources":["../../src/scanner/project-discovery.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAS7C,MAAM,UAAU,qBAAqB,CACnC,QAAiC;IAEjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC;QAClD,UAAU,CAAC,IAAI,CAAC;YACd,UAAU;YACV,YAAY,EAAE,YAAY,CAAC,MAAM;YACjC,YAAY;YACZ,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;QACzC,CAAC;QACD,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAuC;IAEvC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,SAAS;QACZ,SAAS,EAAE,SAAS,CAAC,YAAY,IAAI,2BAA2B;KACjE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAuC;IAEvC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACxE,CAAC"}

package/dist/scanner/ripgrep.d.ts

@@ -0,0 +1,11 @@
+import { type Warning } from "../types.js";
+export interface RipgrepFilesOptions {
+    cwd: string;
+    globs?: string[];
+    excludeGlobs?: string[];
+}
+export interface RipgrepFilesResult {
+    paths: string[];
+    warnings: Warning[];
+}
+export declare function listRipgrepFiles(options: RipgrepFilesOptions): Promise<RipgrepFilesResult>;

package/dist/scanner/ripgrep.js

@@ -0,0 +1,61 @@
+import { spawn } from "node:child_process";
+import { rgPath } from "@vscode/ripgrep";
+import { createWarning } from "../types.js";
+export async function listRipgrepFiles(options) {
+    const args = ["--files", "--hidden", "--null"];
+    for (const glob of options.globs ?? []) {
+        args.push("--glob", glob);
+    }
+    for (const glob of options.excludeGlobs ?? []) {
+        args.push("--glob", `!${glob}`);
+    }
+    return new Promise((resolve) => {
+        const child = spawn(rgPath, args, {
+            cwd: options.cwd,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout.on("data", (chunk) => {
+            stdoutChunks.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderrChunks.push(chunk);
+        });
+        child.on("error", (error) => {
+            resolve({
+                paths: [],
+                warnings: [
+                    createWarning({
+                        reason: "unknown",
+                        path: options.cwd,
+                        message: `Could not run ripgrep discovery in ${options.cwd}: ${error.message}`
+                    })
+                ]
+            });
+        });
+        child.on("close", (code) => {
+            if (code !== 0 && code !== 1) {
+                const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+                resolve({
+                    paths: [],
+                    warnings: [
+                        createWarning({
+                            reason: "unknown",
+                            path: options.cwd,
+                            message: `Ripgrep discovery failed in ${options.cwd}: ${stderr || `exit code ${code}`}`
+                        })
+                    ]
+                });
+                return;
+            }
+            const output = Buffer.concat(stdoutChunks).toString("utf8");
+            const paths = output.split("\0").filter((entry) => entry.length > 0);
+            resolve({
+                paths,
+                warnings: []
+            });
+        });
+    });
+}
+//# sourceMappingURL=ripgrep.js.map

package/dist/scanner/ripgrep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep.js","sourceRoot":"","sources":["../../src/scanner/ripgrep.ts"],"names":[],"mappings":"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"}

package/dist/scanner/safety.d.ts

@@ -0,0 +1,37 @@
+import type { Dirent, Stats } from "node:fs";
+import { type Warning } from "../types.js";
+export declare const MAX_SAFE_FILE_BYTES: number;
+export declare const MASKED_SECRET = "......";
+export type SafeResult<T> = {
+    ok: true;
+    value: T;
+    warnings: Warning[];
+} | {
+    ok: false;
+    warnings: Warning[];
+};
+export interface SafetyCheckOptions {
+    expectedType?: "file" | "directory" | "any";
+    maxBytes?: number;
+    sensitivePath?: string;
+    warnOnMissing?: boolean;
+    allowedRoots?: string[];
+}
+export interface SafePathInfo {
+    path: string;
+    stat: Stats;
+    linked: boolean;
+    linkTarget?: string;
+}
+export declare function checkSafePath(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<SafePathInfo>>;
+export declare function getLinkInfo(filePath: string): Promise<{
+    linked: boolean;
+    linkTarget?: string;
+}>;
+export declare function safeReadTextFile(filePath: string, options?: SafetyCheckOptions): Promise<SafeResult<string>>;
+export declare function safeReadDirectory(directoryPath: string, options?: SafetyCheckOptions): Promise<SafeResult<Dirent[]>>;
+export declare function isSensitivePath(filePath: string): boolean;
+export declare function isSecretLikeKey(key: string): boolean;
+export declare function maskSecrets<T>(value: T): T;
+export declare function maskUrl(value: string): string;
+export declare function maskSecretText(text: string): string;