pi-kot 0.1.21 → 0.1.23

package/dist/server/file-searcher.js

@@ -0,0 +1,318 @@
+import { execFile, spawn } from "node:child_process";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+import { MAX_READ_BYTES, SEARCH_SKIP_DIRS } from "./file-manager.js";
+const execFileAsync = promisify(execFile);
+let cachedRipgrepAvailable;
+export async function ripgrepAvailable() {
+    if (cachedRipgrepAvailable !== undefined)
+        return cachedRipgrepAvailable;
+    try {
+        await execFileAsync("rg", ["--version"], { timeout: 2_000 });
+        cachedRipgrepAvailable = true;
+    }
+    catch {
+        cachedRipgrepAvailable = false;
+    }
+    return cachedRipgrepAvailable;
+}
+export function _resetRipgrepCache() {
+    cachedRipgrepAvailable = undefined;
+}
+export class SearchEngineUnavailableError extends Error {
+    constructor(msg) {
+        super(msg);
+        this.name = "SearchEngineUnavailableError";
+    }
+}
+export async function searchFiles(projectPath, opts) {
+    if (await ripgrepAvailable()) {
+        return searchWithRipgrep(projectPath, opts);
+    }
+    if (opts.regex) {
+        throw new SearchEngineUnavailableError("regex search requires ripgrep, which isn't installed on this host");
+    }
+    return searchInProcess(projectPath, opts);
+}
+async function searchWithRipgrep(projectPath, opts) {
+    const args = [
+        "--json",
+        "--no-heading",
+        "--max-filesize",
+        "5M",
+        "--max-count",
+        String(Math.max(1, Math.min(opts.limit, 1000))),
+    ];
+    if (!opts.regex)
+        args.push("--fixed-strings");
+    if (!opts.caseSensitive)
+        args.push("-i");
+    if (opts.includeGitignored) {
+        args.push("-uu");
+    }
+    if (opts.include !== undefined && opts.include.length > 0) {
+        args.push("--glob", opts.include);
+    }
+    if (opts.exclude !== undefined && opts.exclude.length > 0) {
+        args.push("--glob", `!${opts.exclude}`);
+    }
+    args.push("--", opts.query, ".");
+    return new Promise((resolveFn) => {
+        const matches = [];
+        let truncated = false;
+        const child = spawn("rg", args, { cwd: projectPath });
+        const timer = setTimeout(() => {
+            truncated = true;
+            child.kill("SIGTERM");
+        }, opts.timeoutMs);
+        let buf = "";
+        let currentFile;
+        const finish = () => {
+            clearTimeout(timer);
+            resolveFn({ engine: "ripgrep", matches, truncated });
+        };
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            buf += chunk;
+            let nl = buf.indexOf("\n");
+            while (nl !== -1) {
+                const line = buf.slice(0, nl);
+                buf = buf.slice(nl + 1);
+                if (line.length > 0)
+                    handleEvent(line);
+                nl = buf.indexOf("\n");
+            }
+        });
+        child.on("error", () => finish());
+        child.on("close", () => finish());
+        const handleEvent = (jsonLine) => {
+            let event;
+            try {
+                event = JSON.parse(jsonLine);
+            }
+            catch {
+                return;
+            }
+            if (event.type === "begin") {
+                const data = event.data;
+                currentFile = data?.path?.text;
+            }
+            else if (event.type === "match") {
+                if (matches.length >= opts.limit) {
+                    truncated = true;
+                    child.kill("SIGTERM");
+                    return;
+                }
+                const data = event.data;
+                if (data === undefined || currentFile === undefined)
+                    return;
+                const lineText = data.lines?.text ?? "";
+                const lineNumber = data.line_number ?? 0;
+                const sub = data.submatches?.[0];
+                const start = sub?.start ?? 0;
+                const matchText = sub?.match?.text ?? "";
+                matches.push({
+                    path: currentFile,
+                    line: lineNumber,
+                    column: start + 1,
+                    length: matchText.length,
+                    lineSnippet: stripTrailingNewline(lineText),
+                });
+            }
+        };
+    });
+}
+async function searchInProcess(projectPath, opts) {
+    const matches = [];
+    let truncated = false;
+    const deadline = Date.now() + opts.timeoutMs;
+    const re = opts.regex ? safeRegex(opts.query, opts.caseSensitive) : undefined;
+    if (opts.regex && re === undefined) {
+        return { engine: "node", matches: [], truncated: false };
+    }
+    const includeMatch = opts.include !== undefined ? globToRegExp(opts.include) : undefined;
+    const excludeMatch = opts.exclude !== undefined ? globToRegExp(opts.exclude) : undefined;
+    const root = resolve(projectPath);
+    const stack = [root];
+    const filesToScan = [];
+    while (stack.length > 0 && Date.now() < deadline) {
+        const dir = stack.pop();
+        if (dir === undefined)
+            break;
+        const depth = relative(root, dir)
+            .split(/[\\/]/)
+            .filter((p) => p.length > 0).length;
+        if (depth > 6)
+            continue;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const ent of entries) {
+            const full = join(dir, ent.name);
+            if (ent.isDirectory()) {
+                if (SEARCH_SKIP_DIRS.has(ent.name))
+                    continue;
+                if (ent.name.startsWith(".") && ent.name !== ".")
+                    continue;
+                stack.push(full);
+            }
+            else if (ent.isFile()) {
+                const rel = relative(root, full);
+                if (includeMatch !== undefined && !includeMatch.test(rel))
+                    continue;
+                if (excludeMatch !== undefined && excludeMatch.test(rel))
+                    continue;
+                filesToScan.push(rel);
+            }
+        }
+    }
+    if (Date.now() >= deadline)
+        truncated = true;
+    const CONCURRENCY = 16;
+    let cursor = 0;
+    const worker = async () => {
+        while (cursor < filesToScan.length) {
+            if (Date.now() >= deadline) {
+                truncated = true;
+                return;
+            }
+            if (matches.length >= opts.limit) {
+                truncated = true;
+                return;
+            }
+            const i = cursor++;
+            const rel = filesToScan[i];
+            if (rel === undefined)
+                continue;
+            const full = join(root, rel);
+            let st;
+            try {
+                st = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (!st.isFile() || st.size > MAX_READ_BYTES)
+                continue;
+            let content;
+            try {
+                const buf = await readFile(full);
+                if (looksBinary(buf))
+                    continue;
+                content = buf.toString("utf8");
+            }
+            catch {
+                continue;
+            }
+            scanText(content, rel, opts, re, matches, opts.limit);
+        }
+    };
+    const workers = [];
+    for (let w = 0; w < Math.min(CONCURRENCY, filesToScan.length); w++) {
+        workers.push(worker());
+    }
+    await Promise.all(workers);
+    if (matches.length >= opts.limit)
+        truncated = true;
+    return { engine: "node", matches, truncated };
+}
+function scanText(content, rel, opts, re, out, limit) {
+    const lines = content.split("\n");
+    const cmpQuery = opts.caseSensitive ? opts.query : opts.query.toLowerCase();
+    for (let i = 0; i < lines.length; i++) {
+        if (out.length >= limit)
+            return;
+        const line = lines[i] ?? "";
+        if (re !== undefined) {
+            re.lastIndex = 0;
+            let m;
+            while ((m = re.exec(line)) !== null) {
+                out.push({
+                    path: rel,
+                    line: i + 1,
+                    column: m.index + 1,
+                    length: m[0].length,
+                    lineSnippet: line,
+                });
+                if (out.length >= limit)
+                    return;
+                if (m.index === re.lastIndex)
+                    re.lastIndex += 1;
+            }
+        }
+        else {
+            const haystack = opts.caseSensitive ? line : line.toLowerCase();
+            let from = 0;
+            while (from <= haystack.length) {
+                const idx = haystack.indexOf(cmpQuery, from);
+                if (idx === -1)
+                    break;
+                out.push({
+                    path: rel,
+                    line: i + 1,
+                    column: idx + 1,
+                    length: opts.query.length,
+                    lineSnippet: line,
+                });
+                if (out.length >= limit)
+                    return;
+                from = idx + Math.max(1, opts.query.length);
+            }
+        }
+    }
+}
+function looksBinary(buf) {
+    const probe = buf.subarray(0, Math.min(4096, buf.length));
+    for (let i = 0; i < probe.length; i++) {
+        if (probe[i] === 0)
+            return true;
+    }
+    return false;
+}
+function safeRegex(pattern, caseSensitive) {
+    try {
+        return new RegExp(pattern, caseSensitive ? "g" : "gi");
+    }
+    catch {
+        return undefined;
+    }
+}
+function stripTrailingNewline(s) {
+    if (s.endsWith("\r\n"))
+        return s.slice(0, -2);
+    if (s.endsWith("\n"))
+        return s.slice(0, -1);
+    return s;
+}
+function globToRegExp(glob) {
+    let out = "^";
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i] ?? "";
+        if (c === "*") {
+            if (glob[i + 1] === "*") {
+                out += ".*";
+                i++;
+            }
+            else {
+                out += "[^/]*";
+            }
+        }
+        else if (c === "?") {
+            out += "[^/]";
+        }
+        else if (".+^$()[]{}|\\".includes(c)) {
+            out += "\\" + c;
+        }
+        else {
+            out += c;
+        }
+    }
+    out += "$";
+    return new RegExp(out);
+}
+//# sourceMappingURL=file-searcher.js.map

package/dist/server/file-searcher.js.map

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

package/dist/server/git-operations.d.ts

@@ -0,0 +1,346 @@
+export declare class GitNotInstalledError extends Error {
+    constructor();
+}
+export type GitCommandErrorCode = "git_failed" | "git_auth_required";
+export declare class GitCommandError extends Error {
+    readonly exitCode: number | null;
+    /** Stable route error code for user-actionable git failures. */
+    readonly errorCode: GitCommandErrorCode;
+    /** Sanitized first line of stderr — safe to surface to the user. */
+    readonly userMessage: string;
+    constructor(exitCode: number | null, userMessage: string, fullMessage: string, errorCode?: GitCommandErrorCode);
+}
+/**
+ * Status flag combinations exposed to the client. We map git's
+ * porcelain v1 two-character XY codes into a coarser bucket so the
+ * UI can render badges without a full git literacy quiz.
+ */
+export type FileStatusKind = "modified" | "added" | "deleted" | "renamed" | "copied" | "untracked" | "ignored" | "conflicted" | "unknown";
+export interface FileStatusEntry {
+    /** Path relative to the project root. */
+    path: string;
+    /** True when the change is in the index (XY's first char != ' ' or '?'). */
+    staged: boolean;
+    /** True when the working-tree differs from the index (XY's second char != ' '). */
+    unstaged: boolean;
+    /** Coarse classification driven by the dominant XY char. */
+    kind: FileStatusKind;
+    /** Two-char porcelain code, returned verbatim for advanced UI. */
+    code: string;
+    /** For renames/copies, the original path (porcelain "<orig> -> <new>"). */
+    originalPath?: string;
+}
+export interface StatusResult {
+    isGitRepo: boolean;
+    branch: string | undefined;
+    files: FileStatusEntry[];
+}
+export interface LogEntry {
+    hash: string;
+    message: string;
+    author: string;
+    date: string;
+    /** Parent commit hashes — empty for the root commit, two for merges. */
+    parents: string[];
+    /**
+     * Ref decorations git would print with `%D` — branch tips, tags, and
+     * the magic "HEAD -> main" indicator that tells you which ref is
+     * currently checked out. The renderer uses these to badge the
+     * commit row with branch / tag pills.
+     */
+    refs: string[];
+}
+export interface CommitFileEntry {
+    path: string;
+    /**
+     * Git change type: A(dded), M(odified), D(eleted), R(enamed),
+     * C(opied), T(ype changed), U(nmerged), X(unknown).
+     */
+    changeType: "A" | "M" | "D" | "R" | "C" | "T" | "U" | "X";
+}
+/**
+ * List files changed in a specific commit.
+ * Uses `git diff-tree --no-commit-id -r --name-status <hash>`
+ * which works for root commits (diffs against empty tree) and
+ * normal commits. For merge commits it shows a combined diff
+ * (files that differ from both parents).
+ */
+export declare function getCommitFiles(cwd: string, hash: string): Promise<CommitFileEntry[]>;
+/**
+ * Get the unified diff for a single file as it was changed in a specific commit.
+ * Uses `git diff-tree --no-commit-id -p -r <hash> -- <path>`.
+ * Works for root commits and merge commits (combined diff).
+ */
+export declare function getCommitFileDiff(cwd: string, hash: string, path: string): Promise<string>;
+export interface BranchEntry {
+    name: string;
+    current: boolean;
+    remote: boolean;
+}
+export interface BranchesResult {
+    isGitRepo: boolean;
+    current: string | undefined;
+    branches: BranchEntry[];
+}
+export interface WorktreeEntry {
+    path: string;
+    head: string | undefined;
+    branch: string | undefined;
+    bare: boolean;
+    detached: boolean;
+    current: boolean;
+}
+export interface WorktreesResult {
+    isGitRepo: boolean;
+    worktrees: WorktreeEntry[];
+}
+/**
+ * Permissive runner for callers that need a custom maxBuffer or
+ * non-typed-error semantics. Returns the raw stdout/stderr/exitCode
+ * tuple WITHOUT mapping non-zero exit codes to GitCommandError —
+ * callers handle exit codes themselves. Inherits the same env
+ * scrubbing as `runGit`.
+ *
+ * Currently used by `turn-diff-builder.ts` which wants `git diff` to
+ * succeed even when the path is untracked (exit 0 with empty output)
+ * and accepts a 16 MB diff buffer.
+ */
+export declare function runGitRaw(cwd: string, args: string[], opts?: {
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Initialize a fresh git repo at `cwd` with `main` as the initial
+ * branch. `git init -b main` requires git ≥ 2.28; below that the
+ * `--initial-branch` flag is unrecognized and we fall back to a
+ * plain `git init` — caller can still rename to main on the first
+ * commit if desired. Idempotent: if `cwd` is already a repo, this
+ * resolves without changing anything (git's own `init` is a no-op
+ * on an existing repo).
+ */
+export declare function initRepo(cwd: string): Promise<void>;
+/**
+ * True iff `cwd` is inside a git working tree. Cheap probe used by
+ * every public function so "not a repo" can return the empty default
+ * rather than throw. Exported so route helpers (e.g. for the diff
+ * endpoints' `isGitRepo` flag) don't have to re-implement it.
+ */
+export declare function isGitRepo(cwd: string): Promise<boolean>;
+export declare function getStatus(cwd: string): Promise<StatusResult>;
+/**
+ * Diff variants share the same shape (raw unified text + a
+ * "isGitRepo" flag the route can use to decide between 200 empty and
+ * 200 with content). Empty repo / non-repo → empty string.
+ */
+/**
+ * Diff result that includes the `isGitRepo` flag the route returns
+ * verbatim. Wrapping the flag here means a single `isGitRepo` probe
+ * inside the runner — the route doesn't need to call `isGitRepo`
+ * a second time after the runner returned an empty diff.
+ */
+export interface DiffResult {
+    isGitRepo: boolean;
+    diff: string;
+}
+export declare function getDiff(cwd: string): Promise<DiffResult>;
+export declare function getStagedDiff(cwd: string): Promise<DiffResult>;
+export declare function getFileDiff(cwd: string, path: string, staged: boolean): Promise<DiffResult>;
+export interface LogResult {
+    isGitRepo: boolean;
+    commits: LogEntry[];
+}
+export declare function getLog(cwd: string, limit?: number): Promise<LogResult>;
+export interface RemoteEntry {
+    name: string;
+    /** Fetch URL (the more meaningful of the two for users). */
+    fetchUrl: string;
+    /** Push URL — usually identical to fetch, but git allows configuring them
+     *  separately (e.g. read-only mirror + write-through fork). Surfaced
+     *  alongside fetch so the UI can flag the divergence when present. */
+    pushUrl: string;
+    /** True when this repo has local URL-scoped SSL verification disabled for the remote URL. */
+    insecureTls: boolean;
+}
+/**
+ * `git remote -v` output is two lines per remote (one (fetch), one (push)),
+ * tab-delimited:
+ *
+ *   origin\thttps://github.com/foo/bar.git (fetch)
+ *   origin\thttps://github.com/foo/bar.git (push)
+ *
+ * We parse both forms into a single entry per remote so the UI doesn't
+ * render duplicates. Empty array for non-git or no-remotes-configured.
+ */
+export interface RemotesResult {
+    isGitRepo: boolean;
+    remotes: RemoteEntry[];
+}
+export declare function getRemotes(cwd: string): Promise<RemotesResult>;
+/**
+ * Add a remote. Same name validator as branch creation reused via
+ * `assertRemoteName`. The URL is passed verbatim to git as a
+ * positional arg; `execFile` (no shell) means there's no command-
+ * injection surface even if the URL contains spaces or shell
+ * metachars. Common shapes: `https://github.com/foo/bar.git`,
+ * `git@github.com:foo/bar.git`, `file:///abs/path`.
+ */
+export declare function addRemote(cwd: string, name: string, url: string, opts?: {
+    insecureTls?: boolean;
+}): Promise<void>;
+export declare function setRemoteInsecureTls(cwd: string, name: string, enabled: boolean): Promise<void>;
+/**
+ * Remove a remote. Idempotent at the route layer — git emits
+ * "fatal: No such remote" if the name is unknown, which surfaces as
+ * the existing 400 git_failed; the route layer can choose to map
+ * that to 404 if needed.
+ */
+export declare function removeRemote(cwd: string, name: string): Promise<void>;
+export declare function getWorktrees(cwd: string): Promise<WorktreesResult>;
+export declare function getBranches(cwd: string): Promise<BranchesResult>;
+export declare function stagePaths(cwd: string, paths: string[]): Promise<void>;
+export declare function unstagePaths(cwd: string, paths: string[]): Promise<void>;
+/**
+ * Discard local changes for the given files: restores both the
+ * index AND the working tree to HEAD via `git restore --staged
+ * --worktree --source=HEAD -- <paths>`. The user-visible "Revert"
+ * action.
+ *
+ * For untracked files, `git restore` errors with "pathspec did
+ * not match any file(s) known to git". The route surfaces this
+ * via `GitCommandError` so the UI can display "untracked files
+ * can't be reverted; delete them via the file browser instead."
+ *
+ * Destructive — the caller is expected to gate this behind a
+ * confirmation in the UI (the click-twice-to-confirm pattern in
+ * GitPanel).
+ */
+export declare function revertPaths(cwd: string, paths: string[]): Promise<void>;
+/**
+ * Commit the currently-staged changes. Empty / whitespace-only
+ * messages are rejected at the route layer; this just runs the
+ * command. `--no-verify` is NOT used — we want pre-commit hooks to
+ * fire so the user's lint/test/format checks gate browser commits
+ * the same way they gate terminal commits.
+ */
+export declare function commit(cwd: string, message: string): Promise<{
+    hash: string;
+}>;
+/**
+ * Restrict branch names to the same character set git itself accepts in
+ * common usage — letters, digits, dot, dash, underscore, slash. Reject
+ * anything else (spaces, control chars, leading dash that could be
+ * mistaken for a flag, dot-only segments, double slashes, etc.) with a
+ * single error code so the route can return a stable 400.
+ */
+export declare class InvalidBranchNameError extends Error {
+    constructor(name: string);
+}
+/**
+ * Switch the working tree to `branch`. Refuses on a dirty tree (git's
+ * default) — the caller is expected to surface the resulting
+ * `GitCommandError` to the user, who can stash or revert first.
+ *
+ * No `--` separator: `git checkout -- <name>` interprets <name> as a
+ * pathspec and ALWAYS fails with "did not match any file(s) known to
+ * git". The branch-name validator (assertBranchName) already rejects
+ * leading dashes, so flag injection isn't a concern here.
+ */
+export declare function checkoutBranch(cwd: string, branch: string): Promise<void>;
+export interface CreateBranchOptions {
+    /** Branch / commit to base the new branch on. Defaults to current HEAD. */
+    startPoint?: string;
+    /** When true, also switch the working tree to the new branch. */
+    checkout?: boolean;
+}
+/**
+ * Create a new local branch. `startPoint` defaults to HEAD; pass
+ * `origin/main` (etc.) to branch off a tracking ref. When `checkout`
+ * is true, uses `git checkout -b` to create + switch in one step.
+ */
+export declare function createBranch(cwd: string, name: string, opts?: CreateBranchOptions): Promise<void>;
+export interface DeleteBranchOptions {
+    /** Force-delete via `-D` even when the branch isn't merged. */
+    force?: boolean;
+}
+/**
+ * Delete a local branch. Default uses `-d` (refuses to delete an
+ * unmerged branch); `force: true` switches to `-D`. Refuses to delete
+ * the currently-checked-out branch (git's default behavior surfaces a
+ * `GitCommandError`).
+ */
+export declare function deleteBranch(cwd: string, name: string, opts?: DeleteBranchOptions): Promise<void>;
+export interface PushOptions {
+    remote?: string;
+    branch?: string;
+    /**
+     * When true, adds `--set-upstream` so the push records the
+     * remote/branch as the tracking ref. Required on first push of a
+     * new branch — without this the user gets the default
+     * "fatal: The current branch has no upstream branch" error.
+     */
+    setUpstream?: boolean;
+}
+export interface FetchOptions {
+    remote?: string;
+    /** Add `--prune` so deleted upstream branches are removed locally too. */
+    prune?: boolean;
+}
+/**
+ * `git fetch [<remote>]` — never touches the working tree, so safe to
+ * call regardless of dirty state. Returns the captured output (mostly
+ * stderr — git's "Fetching origin\nFrom github.com:foo/bar..." text).
+ */
+export declare function fetch(cwd: string, opts?: FetchOptions): Promise<{
+    stdout: string;
+}>;
+export interface PullOptions {
+    remote?: string;
+    branch?: string;
+    /**
+     * `--rebase` rebases local commits on top of the fetched ref instead
+     * of merging. Mirrors `git pull --rebase` semantics; the user can
+     * switch in the UI per-pull.
+     */
+    rebase?: boolean;
+}
+/**
+ * `git pull [<remote> [<branch>]]` — fetches AND merges (or rebases).
+ * Conflicts are NOT resolved by us — the underlying GitCommandError's
+ * stderr is surfaced verbatim (e.g. "CONFLICT (content): Merge
+ * conflict in foo.ts") so the user can drop to the integrated
+ * terminal to fix.
+ *
+ * Argument grammar: the second positional is a branch ONLY when the
+ * first positional is also given. `git pull <name>` is interpreted
+ * as a remote, not a branch — so when the caller passes only `branch`
+ * we default `remote` to `"origin"` rather than producing a
+ * misleading "remote not found" error.
+ */
+export declare function pull(cwd: string, opts?: PullOptions): Promise<{
+    stdout: string;
+}>;
+export declare function push(cwd: string, opts?: PushOptions): Promise<{
+    stdout: string;
+}>;
+/**
+ * Create a linked working tree at `worktreePath` pinned to `commitHash`.
+ * `git worktree add` does NOT require a clean working tree in the primary
+ * checkout — you can be mid-edit and still create a worktree to try an
+ * old commit. Returns the resolved absolute path so the UI can display
+ * it.
+ *
+ * `worktreePath` is resolved against `cwd` — the caller's route should
+ * use something like `.git-worktrees/<short-hash>/` relative to the
+ * project root.
+ */
+export declare function addWorktree(cwd: string, worktreePath: string, commitHash: string): Promise<void>;
+/**
+ * Remove a linked working tree. Git refuses if the worktree has
+ * uncommitted changes (non-zero exit) — the route layer surfaces the
+ * `GitCommandError` message so the user knows to commit or stash
+ * before removing.
+ */
+export declare function removeWorktree(cwd: string, worktreePath: string): Promise<void>;
+//# sourceMappingURL=git-operations.d.ts.map