parasor 0.1.0

package/server/fs/git-watcher.js

@@ -0,0 +1,356 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const ESCAPE_MAP = {
+    "\\": "\\",
+    '"': '"',
+    n: "\n",
+    t: "\t",
+    a: "\x07",
+    b: "\b",
+    f: "\f",
+    r: "\r",
+    v: "\v",
+};
+function unquoteGitPath(raw) {
+    if (raw.length < 2 || raw[0] !== '"' || raw[raw.length - 1] !== '"')
+        return raw;
+    const inner = raw.slice(1, -1);
+    const bytes = [];
+    for (let i = 0; i < inner.length; i++) {
+        if (inner[i] === "\\" && i + 1 < inner.length) {
+            const next = inner[i + 1];
+            if (next >= "0" && next <= "3" && i + 3 < inner.length) {
+                const octal = inner.slice(i + 1, i + 4);
+                if (/^[0-3][0-7]{2}$/.test(octal)) {
+                    bytes.push(parseInt(octal, 8));
+                    i += 3;
+                    continue;
+                }
+            }
+            const mapped = ESCAPE_MAP[next];
+            if (mapped !== undefined) {
+                for (let j = 0; j < mapped.length; j++)
+                    bytes.push(mapped.charCodeAt(j));
+                i++;
+                continue;
+            }
+        }
+        bytes.push(inner.charCodeAt(i));
+    }
+    return new TextDecoder().decode(new Uint8Array(bytes));
+}
+function findArrowInPorcelainPath(pathPart) {
+    if (pathPart.startsWith('"')) {
+        // Old path is quoted -- find closing quote (skip escaped quotes)
+        for (let i = 1; i < pathPart.length; i++) {
+            if (pathPart[i] === "\\" && i + 1 < pathPart.length) {
+                i++;
+                continue;
+            }
+            if (pathPart[i] === '"')
+                return pathPart.indexOf(" -> ", i + 1);
+        }
+        return -1;
+    }
+    return pathPart.indexOf(" -> ");
+}
+/**
+ * Parse `git status --porcelain` output into a map of relative paths to status codes.
+ * Format per line: "XY path" where X=index status, Y=worktree status.
+ * Returns the most relevant single status character per file.
+ */
+export function parseGitPorcelain(raw) {
+    const result = {};
+    for (const line of raw.split("\n")) {
+        if (line.length < 4)
+            continue;
+        const x = line[0]; // index status
+        const y = line[1]; // worktree status
+        const pathPart = line.slice(3);
+        // Handle renames/copies: "R  old -> new" / "C  old -> new"
+        const isRenameOrCopy = x === "R" || x === "C";
+        const arrowIdx = isRenameOrCopy ? findArrowInPorcelainPath(pathPart) : -1;
+        const rawPath = arrowIdx >= 0 ? pathPart.slice(arrowIdx + 4) : pathPart;
+        const filePath = unquoteGitPath(rawPath);
+        // Pick the most visible status: worktree status takes priority over index
+        // unless index-only (staged but worktree clean)
+        if (x === "?" && y === "?") {
+            result[filePath] = "?";
+        }
+        else if (y !== " " && y !== "?") {
+            result[filePath] = y; // worktree change (M, D, etc.)
+        }
+        else if (x !== " " && x !== "?") {
+            result[filePath] = x; // index-only change (staged)
+        }
+    }
+    return result;
+}
+/**
+ * Parse `git status --porcelain=v2 -b` output into ahead/behind/dirtyCount.
+ *
+ * v2 line shapes (per `git-status(1)`):
+ *   `# branch.ab +N -M`           upstream tracking header (omitted when no upstream)
+ *   `1 XY ...`                    ordinary changed entry
+ *   `2 XY ...`                    rename/copy entry
+ *   `u XY ...`                    unmerged entry
+ *   `? <path>`                    untracked
+ *   `! <path>`                    ignored (excluded from dirtyCount)
+ *
+ * `dirtyCount` includes 1/2/u entries plus `?` untracked. Ignored `!` is
+ * deliberately excluded so the sidebar counter matches what the user sees as
+ * actionable change.
+ */
+export function parseGitStatusV2(raw) {
+    let ahead;
+    let behind;
+    let dirtyCount = 0;
+    for (const line of raw.split("\n")) {
+        if (line.length === 0)
+            continue;
+        if (line.startsWith("# branch.ab ")) {
+            const m = line.slice(12).match(/^([+-]?\d+)\s+([+-]?\d+)/);
+            if (m) {
+                // git emits `+N -M` so behind is signed negative; abs flips it.
+                ahead = Math.abs(parseInt(m[1], 10));
+                behind = Math.abs(parseInt(m[2], 10));
+            }
+            continue;
+        }
+        if (line.startsWith("#"))
+            continue;
+        const head = line[0];
+        if (head === "1" || head === "2" || head === "u" || head === "?") {
+            dirtyCount += 1;
+        }
+    }
+    return { ahead, behind, dirtyCount };
+}
+/**
+ * Parse `git status --porcelain=v2 -b -z` output into both the file-status
+ * map (used by the filetree diff badges) and the ahead/behind/dirtyCount
+ * summary (used by WorktreeTabBar). One pass replaces the earlier
+ * v1+v2 dual call so the watcher can refresh the live counters on every
+ * tick without an extra `git status` round-trip.
+ *
+ * v2 entry shapes (`git-status(1)` `--porcelain=v2`):
+ *   `1 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <path>`        ordinary entry
+ *   `2 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <X><score> <path>\t<orig>`  rename
+ *   `u <XY> ...`                                            unmerged
+ *   `? <path>`                                              untracked
+ *   `! <path>`                                              ignored (skipped)
+ *
+ * `-z` switches to NUL-delimited records and disables the legacy
+ * shell-quoted path encoding, so paths with spaces / unicode arrive verbatim
+ * without us having to decode escape sequences.
+ */
+export function parseGitStatusV2WithFiles(raw) {
+    let branch = "";
+    let ahead;
+    let behind;
+    let dirtyCount = 0;
+    const fileStatuses = {};
+    // `-z` separates records by NUL. Renames carry an extra NUL between new
+    // and old paths; the loop reads the next record on encountering one.
+    const records = raw.split("\0");
+    for (let i = 0; i < records.length; i++) {
+        const line = records[i];
+        if (!line)
+            continue;
+        if (line.startsWith("# branch.head ")) {
+            branch = line.slice("# branch.head ".length).trim();
+            continue;
+        }
+        if (line.startsWith("# branch.ab ")) {
+            const m = line
+                .slice("# branch.ab ".length)
+                .match(/^([+-]?\d+)\s+([+-]?\d+)/);
+            if (m) {
+                ahead = Math.abs(parseInt(m[1], 10));
+                behind = Math.abs(parseInt(m[2], 10));
+            }
+            continue;
+        }
+        if (line.startsWith("#"))
+            continue;
+        const head = line[0];
+        if (head === "1") {
+            // `1 XY ... <path>` -- fields 1..7 are space-delimited; path is the
+            // remainder after the 8th space.
+            const parts = line.split(" ");
+            if (parts.length < 9)
+                continue;
+            const xy = parts[1];
+            const path = parts.slice(8).join(" ");
+            const code = pickStatusCode(xy);
+            if (code)
+                fileStatuses[path] = code;
+            dirtyCount += 1;
+        }
+        else if (head === "2") {
+            // Rename/copy. Path = current name (this record's tail), original
+            // path = next NUL-delimited record (consumed below).
+            const parts = line.split(" ");
+            if (parts.length < 10)
+                continue;
+            const xy = parts[1];
+            const newPath = parts.slice(9).join(" ");
+            const code = pickStatusCode(xy);
+            if (code)
+                fileStatuses[newPath] = code;
+            dirtyCount += 1;
+            i += 1; // skip the original-path record
+        }
+        else if (head === "u") {
+            const parts = line.split(" ");
+            if (parts.length < 11)
+                continue;
+            const path = parts.slice(10).join(" ");
+            fileStatuses[path] = "U";
+            dirtyCount += 1;
+        }
+        else if (head === "?") {
+            // `? <path>` -- single space, then path.
+            const path = line.slice(2);
+            fileStatuses[path] = "?";
+            dirtyCount += 1;
+        }
+        // `!` ignored entries are skipped (would only appear with --ignored).
+    }
+    return { branch, ahead, behind, dirtyCount, fileStatuses };
+}
+function stderrOf(err) {
+    if (!err || typeof err !== "object")
+        return "";
+    const e = err;
+    if (typeof e.stderr === "string")
+        return e.stderr;
+    if (e.stderr instanceof Buffer)
+        return e.stderr.toString("utf8");
+    return "";
+}
+function pickStatusCode(xy) {
+    if (xy.length !== 2)
+        return null;
+    const x = xy[0];
+    const y = xy[1];
+    if (y !== "." && y !== " ")
+        return y;
+    if (x !== "." && x !== " ")
+        return x;
+    return null;
+}
+function cacheKey(projectId, worktreePath) {
+    return `${projectId}|${worktreePath}`;
+}
+export class GitWatcher {
+    cache = new Map();
+    async check(worktreePath) {
+        const env = { ...process.env, GIT_OPTIONAL_LOCKS: "0" };
+        try {
+            const { stdout } = await execFileAsync("git", ["-C", worktreePath, "status", "--porcelain=v2", "-b", "-z"], {
+                timeout: 5000,
+                env,
+                // `--porcelain=v2 -z` on a repo with thousands of dirty entries
+                // can blow past Node's 1MiB default. Match project-queries.ts so
+                // the watcher and ad-hoc enrichment fail in identical conditions.
+                maxBuffer: 16 * 1024 * 1024,
+            });
+            const snap = parseGitStatusV2WithFiles(stdout);
+            const dirty = snap.dirtyCount > 0;
+            return {
+                branch: snap.branch,
+                dirty,
+                fileStatuses: dirty ? snap.fileStatuses : undefined,
+                ahead: snap.ahead,
+                behind: snap.behind,
+                dirtyCount: snap.dirtyCount,
+                lastChecked: Date.now(),
+            };
+        }
+        catch (err) {
+            // Distinguish "not a git repository" from transient errors so the Git
+            // pane can offer `git init` instead of a blank "loading…" state.
+            // Inspect stderr only -- message text is locale-stable in C/C.UTF-8 git
+            // builds (`fatal: not a git repository`).
+            const stderr = stderrOf(err).toLowerCase();
+            if (stderr.includes("not a git repository")) {
+                return {
+                    branch: "",
+                    dirty: false,
+                    isRepo: false,
+                    lastChecked: Date.now(),
+                };
+            }
+            return null;
+        }
+    }
+    async checkAndDiff(projectId, worktreePath) {
+        const state = await this.check(worktreePath);
+        const key = cacheKey(projectId, worktreePath);
+        const cached = this.cache.get(key);
+        const fileStatusesChanged = !fileStatusesEqual(state?.fileStatuses, cached?.fileStatuses);
+        const changed = state?.branch !== cached?.branch ||
+            state?.dirty !== cached?.dirty ||
+            state?.ahead !== cached?.ahead ||
+            state?.behind !== cached?.behind ||
+            state?.dirtyCount !== cached?.dirtyCount ||
+            // The repo/non-repo transition (`git init` flipping isRepo from false
+            // to undefined+populated) usually shows up as a branch change, but the
+            // sidebar gates `root` label / folder icon / `Initialize git…` menu
+            // strictly on `isRepo === false`. Including it here guarantees the
+            // UI re-renders the moment the flag flips, even on degenerate cases
+            // where the post-init branch happens to read as `""`.
+            state?.isRepo !== cached?.isRepo ||
+            fileStatusesChanged;
+        if (changed) {
+            this.cache.set(key, state);
+        }
+        return { state, changed };
+    }
+    getCached(projectId, worktreePath) {
+        return this.cache.get(cacheKey(projectId, worktreePath)) ?? null;
+    }
+    /**
+     * Snapshot of every cached state grouped by project. Outer key = projectId,
+     * inner key = worktreePath. Hydration payload consumes this shape directly.
+     */
+    getAllCached() {
+        const result = {};
+        for (const [k, v] of this.cache) {
+            const idx = k.indexOf("|");
+            if (idx < 0)
+                continue;
+            const projectId = k.slice(0, idx);
+            const worktreePath = k.slice(idx + 1);
+            const projectCache = result[projectId] ?? {};
+            result[projectId] = projectCache;
+            projectCache[worktreePath] = v;
+        }
+        return result;
+    }
+    /** Clear all worktree entries belonging to a project. */
+    clearProject(projectId) {
+        const prefix = `${projectId}|`;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix))
+                this.cache.delete(key);
+        }
+    }
+    /** Clear a single worktree entry. */
+    clearWorktree(projectId, worktreePath) {
+        this.cache.delete(cacheKey(projectId, worktreePath));
+    }
+}
+function fileStatusesEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const keysA = Object.keys(a);
+    if (keysA.length !== Object.keys(b).length)
+        return false;
+    return keysA.every((k) => a[k] === b[k]);
+}
+//# sourceMappingURL=git-watcher.js.map

package/server/fs/git-watcher.js.map

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

package/server/fs/media.d.ts

@@ -0,0 +1,35 @@
+import { Buffer } from "node:buffer";
+import type { FileHandle } from "node:fs/promises";
+export type MediaKind = "image" | "video" | "audio" | "pdf";
+export interface MediaDetectionResult {
+    kind: MediaKind | null;
+    contentType: string | null;
+}
+/**
+ * Identify a media file by its first 32 bytes plus extension. Magic-number
+ * match wins; if the magic match disagrees with the extension, the magic
+ * match is authoritative. SVG sniff is conservative -- only accepted when the
+ * extension claims SVG so a plain XML file is not mis-classified.
+ */
+export declare function detectMedia(absPath: string): Promise<MediaDetectionResult>;
+/**
+ * Same magic-number + extension pipeline as `detectMedia`, but reads through
+ * a caller-owned `FileHandle`. Use this when the route layer has already
+ * `O_NOFOLLOW`-opened the file and needs detection, size validation, and
+ * streaming all anchored to the same inode (so a leaf swap between checks
+ * cannot bypass the size cap or content-type lock). Caller retains ownership
+ * of the handle.
+ */
+export declare function detectMediaFromHandle(handle: FileHandle, pathHint: string): Promise<MediaDetectionResult>;
+/**
+ * Pure classifier so tests can hand it raw bytes without touching disk.
+ * Exposed for unit testing -- `detectMedia` is the production entry point.
+ */
+export declare function classify(buf: Buffer, ext: string): MediaDetectionResult;
+/**
+ * Lightweight extension-only check. Used by the route for the cheap
+ * pre-filter before opening the file (so we never read an executable just
+ * to learn it isn't media).
+ */
+export declare function isMediaExtension(absPath: string): boolean;
+//# sourceMappingURL=media.d.ts.map

package/server/fs/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/fs/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAyMD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAM/B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAyCvE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}