crewly 1.20.301 → 1.20.302

package/dist/cli/backend/src/services/worktree/low-disk-guard.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Low-disk guard — pure helpers for the disk janitor's free-space check.
+ *
+ * The janitor checks free space on the volume holding CREWLY_HOME every
+ * 10 minutes. Below 15 GB it cleans up at once with shorter idle thresholds;
+ * if space is still short it tells the owner (at most once per 24 h, or once
+ * per 6 h and marked urgent below 5 GB) what it could not remove and why.
+ * This file holds the decisions and the wording; the service does the I/O.
+ *
+ * @module services/worktree/low-disk-guard
+ */
+/** Subset of `fs.StatFs` the guard needs (numbers or bigints). */
+export interface StatFsLike {
+    /** Free blocks available to unprivileged users */
+    bavail: number | bigint;
+    /** Block size in bytes */
+    bsize: number | bigint;
+}
+/** `fs.promises.statfs`-compatible probe. */
+export type StatFsFn = (p: string) => Promise<StatFsLike>;
+/** Disk level relative to the thresholds. */
+export type DiskLevel = 'ok' | 'low' | 'critical';
+/** When the owner was last told about low disk (persisted). */
+export interface LowDiskNoticeState {
+    /** Last notice of any kind (ms epoch) */
+    lastNoticeAt?: number;
+    /** Last urgent notice (ms epoch) */
+    lastUrgentAt?: number;
+}
+/** Something the janitor looked at and left on disk. */
+export interface KeptItem {
+    /** Absolute path */
+    path: string;
+    /** Size in bytes */
+    bytes: number;
+    /** Janitor reason code (`dirty`, `not-merged`, `unpushed`, …) */
+    reason: string;
+}
+/**
+ * Free bytes on the volume holding `p`.
+ *
+ * @param p - Any path on the volume
+ * @param statfs - Probe (default `fs.promises.statfs`)
+ * @returns Free bytes for unprivileged users, or null when the probe failed
+ */
+export declare function readFreeBytes(p: string, statfs?: StatFsFn): Promise<number | null>;
+/**
+ * Classify free space.
+ *
+ * @param freeBytes - Free bytes
+ * @returns `critical` below CRITICAL_DISK_BYTES, `low` below LOW_DISK_BYTES, else `ok`
+ */
+export declare function diskLevel(freeBytes: number): DiskLevel;
+/**
+ * Idle threshold to use, shortened in low-disk mode.
+ *
+ * @param normalMs - Threshold in normal mode
+ * @param lowDisk - Whether free space is below LOW_DISK_BYTES
+ * @returns `normalMs`, or `normalMs / LOW_DISK_IDLE_DIVISOR` floored at LOW_DISK_MIN_IDLE_FLOOR_MS
+ *
+ * @example
+ * ```typescript
+ * idleThreshold(24 * HOUR, true); // 12 h
+ * idleThreshold(2 * HOUR, true);  // 2 h (floor)
+ * ```
+ */
+export declare function idleThreshold(normalMs: number, lowDisk: boolean): number;
+/**
+ * Whether to tell the owner now, and how.
+ *
+ * @param level - Current disk level (after cleanup)
+ * @param state - When the owner was last told
+ * @param now - Current time (ms)
+ * @returns `urgent`, `normal`, or null (nothing to send)
+ */
+export declare function noticeToSend(level: DiskLevel, state: LowDiskNoticeState, now: number): 'urgent' | 'normal' | null;
+/**
+ * The state after a notice went out.
+ *
+ * @param state - Previous state
+ * @param kind - What was sent
+ * @param now - Send time (ms)
+ * @returns New state
+ */
+export declare function recordNotice(state: LowDiskNoticeState, kind: 'urgent' | 'normal', now: number): LowDiskNoticeState;
+/**
+ * Plain-English reason for a kept item.
+ *
+ * @param reason - Janitor reason code
+ * @returns Short phrase ("has changes that were never committed")
+ */
+export declare function describeReason(reason: string): string;
+/**
+ * Owner notice for low disk: free space, what was freed, and the biggest
+ * items left with the reason, short enough for a phone.
+ *
+ * @param input - Free bytes, urgency, bytes freed this pass, kept items
+ * @returns Title and message
+ */
+export declare function buildLowDiskNotice(input: {
+    freeBytes: number;
+    urgent: boolean;
+    freedBytes: number;
+    items: KeptItem[];
+}): {
+    title: string;
+    message: string;
+};
+//# sourceMappingURL=low-disk-guard.d.ts.map

package/dist/cli/backend/src/services/worktree/low-disk-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"low-disk-guard.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/worktree/low-disk-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,kEAAkE;AAClE,MAAM,WAAW,UAAU;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IAClC,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACxB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,QAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOvG;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAItD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAQjH;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAElH;AAqBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkBrC"}

package/dist/cli/backend/src/services/worktree/low-disk-guard.js

@@ -0,0 +1,148 @@
+/**
+ * Low-disk guard — pure helpers for the disk janitor's free-space check.
+ *
+ * The janitor checks free space on the volume holding CREWLY_HOME every
+ * 10 minutes. Below 15 GB it cleans up at once with shorter idle thresholds;
+ * if space is still short it tells the owner (at most once per 24 h, or once
+ * per 6 h and marked urgent below 5 GB) what it could not remove and why.
+ * This file holds the decisions and the wording; the service does the I/O.
+ *
+ * @module services/worktree/low-disk-guard
+ */
+import * as fs from 'fs';
+import { WORKTREE_JANITOR_CONSTANTS } from '../../constants.js';
+import { formatBytes } from './worktree-janitor.git.js';
+/**
+ * Free bytes on the volume holding `p`.
+ *
+ * @param p - Any path on the volume
+ * @param statfs - Probe (default `fs.promises.statfs`)
+ * @returns Free bytes for unprivileged users, or null when the probe failed
+ */
+export async function readFreeBytes(p, statfs = defaultStatFs) {
+    try {
+        const s = await statfs(p);
+        return Number(s.bavail) * Number(s.bsize);
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultStatFs(p) {
+    return fs.promises.statfs(p);
+}
+/**
+ * Classify free space.
+ *
+ * @param freeBytes - Free bytes
+ * @returns `critical` below CRITICAL_DISK_BYTES, `low` below LOW_DISK_BYTES, else `ok`
+ */
+export function diskLevel(freeBytes) {
+    if (freeBytes < WORKTREE_JANITOR_CONSTANTS.CRITICAL_DISK_BYTES)
+        return 'critical';
+    if (freeBytes < WORKTREE_JANITOR_CONSTANTS.LOW_DISK_BYTES)
+        return 'low';
+    return 'ok';
+}
+/**
+ * Idle threshold to use, shortened in low-disk mode.
+ *
+ * @param normalMs - Threshold in normal mode
+ * @param lowDisk - Whether free space is below LOW_DISK_BYTES
+ * @returns `normalMs`, or `normalMs / LOW_DISK_IDLE_DIVISOR` floored at LOW_DISK_MIN_IDLE_FLOOR_MS
+ *
+ * @example
+ * ```typescript
+ * idleThreshold(24 * HOUR, true); // 12 h
+ * idleThreshold(2 * HOUR, true);  // 2 h (floor)
+ * ```
+ */
+export function idleThreshold(normalMs, lowDisk) {
+    if (!lowDisk)
+        return normalMs;
+    const halved = normalMs / WORKTREE_JANITOR_CONSTANTS.LOW_DISK_IDLE_DIVISOR;
+    return Math.max(Math.min(normalMs, WORKTREE_JANITOR_CONSTANTS.LOW_DISK_MIN_IDLE_FLOOR_MS), halved);
+}
+/**
+ * Whether to tell the owner now, and how.
+ *
+ * @param level - Current disk level (after cleanup)
+ * @param state - When the owner was last told
+ * @param now - Current time (ms)
+ * @returns `urgent`, `normal`, or null (nothing to send)
+ */
+export function noticeToSend(level, state, now) {
+    if (level === 'ok')
+        return null;
+    if (level === 'critical') {
+        const last = state.lastUrgentAt;
+        return last === undefined || now - last >= WORKTREE_JANITOR_CONSTANTS.CRITICAL_DISK_NOTIFY_INTERVAL_MS ? 'urgent' : null;
+    }
+    const last = state.lastNoticeAt;
+    return last === undefined || now - last >= WORKTREE_JANITOR_CONSTANTS.LOW_DISK_NOTIFY_INTERVAL_MS ? 'normal' : null;
+}
+/**
+ * The state after a notice went out.
+ *
+ * @param state - Previous state
+ * @param kind - What was sent
+ * @param now - Send time (ms)
+ * @returns New state
+ */
+export function recordNotice(state, kind, now) {
+    return { ...state, lastNoticeAt: now, ...(kind === 'urgent' ? { lastUrgentAt: now } : {}) };
+}
+const REASON_TEXT = {
+    dirty: 'has changes that were never committed',
+    'not-merged': 'has work that is not merged yet',
+    unpushed: 'has commits that were never pushed',
+    stash: 'has stashed changes',
+    'no-remote': 'is a git repo with no remote, so its history may exist nowhere else',
+    'has-external-worktrees': 'has a worktree somewhere else that depends on it',
+    'contains-worktree': 'holds a worktree that is still in use or not finished',
+    recent: 'was used recently',
+    locked: 'is locked by a running tool',
+    'process-inside': 'a program is still open in it',
+    'agent-session-inside': 'an agent is working in it',
+    'cwd-probe-failed': 'could not check whether a program is using it',
+    'managed-by-workitem-worktrees': 'belongs to an open task',
+    'status-failed': 'git could not read it',
+    'git-failed': 'git could not read it',
+    'remove-failed': 'deleting it failed',
+};
+/**
+ * Plain-English reason for a kept item.
+ *
+ * @param reason - Janitor reason code
+ * @returns Short phrase ("has changes that were never committed")
+ */
+export function describeReason(reason) {
+    return REASON_TEXT[reason] ?? `kept (${reason})`;
+}
+/**
+ * Owner notice for low disk: free space, what was freed, and the biggest
+ * items left with the reason, short enough for a phone.
+ *
+ * @param input - Free bytes, urgency, bytes freed this pass, kept items
+ * @returns Title and message
+ */
+export function buildLowDiskNotice(input) {
+    const title = input.urgent ? 'URGENT: disk almost full' : 'Disk space is running low';
+    const lines = [];
+    lines.push(`Only ${formatBytes(input.freeBytes)} free on this machine.${input.urgent ? ' Crewly and the agents may stop working soon.' : ''}`);
+    lines.push(input.freedBytes > 0
+        ? `I cleaned up ${formatBytes(input.freedBytes)} of finished work, but it is not enough.`
+        : 'I found nothing more that is safe to delete on my own.');
+    const top = [...input.items].sort((a, b) => b.bytes - a.bytes).slice(0, WORKTREE_JANITOR_CONSTANTS.LOW_DISK_REPORT_ITEMS);
+    if (top.length > 0) {
+        lines.push('', 'Biggest things I left alone:');
+        for (const it of top)
+            lines.push(`• ${it.path} (${formatBytes(it.bytes)}) — ${describeReason(it.reason)}`);
+        lines.push('', 'Tell me which ones can go, or free up space another way.');
+    }
+    else {
+        lines.push('Please free up some space.');
+    }
+    return { title, message: lines.join('\n') };
+}
+//# sourceMappingURL=low-disk-guard.js.map

package/dist/cli/backend/src/services/worktree/low-disk-guard.js.map

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

package/dist/cli/backend/src/services/worktree/worktree-janitor.git.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Worktree janitor — low-level helpers.
+ *
+ * A command runner that never throws, a parser for `git worktree list
+ * --porcelain`, path helpers, and the process-cwd probe used to tell whether
+ * anything is still working inside a worktree. Kept apart from the service so
+ * each piece can be tested on its own.
+ *
+ * @module services/worktree/worktree-janitor.git
+ */
+/** Result of one external command. `code` is null when it could not start or timed out. */
+export interface CommandResult {
+    /** Exit code, or null when the process did not exit normally */
+    code: number | null;
+    /** Captured stdout */
+    stdout: string;
+    /** Captured stderr (or the spawn error message) */
+    stderr: string;
+}
+/** Options for {@link runCommand}. */
+export interface RunCommandOptions {
+    /** Working directory */
+    cwd?: string;
+    /** Timeout in ms (default: GIT_TIMEOUT_MS) */
+    timeoutMs?: number;
+    /** Extra environment variables merged over process.env */
+    env?: Record<string, string>;
+    /** Text written to the command's stdin (then closed) */
+    input?: string;
+}
+/**
+ * Run a command without a shell and never throw.
+ *
+ * Git and gh are told never to prompt (no credential dialogs, no pager), so a
+ * periodic background job cannot hang on input, and git takes no optional
+ * locks (a status never rewrites the index).
+ *
+ * @param file - Executable (e.g. `git`, `gh`, or an absolute path)
+ * @param args - Arguments
+ * @param options - cwd / timeout / env
+ * @returns Exit code and output; `code` is null on spawn failure or timeout
+ *
+ * @example
+ * ```typescript
+ * const r = await runCommand('git', ['-C', repo, 'status', '--porcelain']);
+ * if (r.code === 0 && r.stdout === '') console.log('clean');
+ * ```
+ */
+export declare function runCommand(file: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+/** One entry of `git worktree list --porcelain`. */
+export interface PorcelainWorktree {
+    /** Absolute worktree path as git reports it */
+    path: string;
+    /** HEAD commit, or null (bare) */
+    head: string | null;
+    /** Short branch name (`refs/heads/` stripped), or null when detached */
+    branch: string | null;
+    /** True for the bare entry */
+    bare: boolean;
+    /** True when HEAD is detached */
+    detached: boolean;
+    /** True when the worktree is locked (`git worktree lock`) */
+    locked: boolean;
+    /** Lock reason, when given */
+    lockReason?: string;
+    /** True when git reports the directory as gone (`prunable`) */
+    prunable: boolean;
+    /** True for the first entry — the main worktree */
+    isMain: boolean;
+}
+/**
+ * Parse `git worktree list --porcelain` output.
+ *
+ * Entries are separated by blank lines; the first entry is the main worktree.
+ *
+ * @param output - Raw porcelain output
+ * @returns Parsed entries in git's order
+ *
+ * @example
+ * ```typescript
+ * parsePorcelainWorktrees('worktree /r\nHEAD abc\nbranch refs/heads/main\n');
+ * // [{ path: '/r', head: 'abc', branch: 'main', isMain: true, ... }]
+ * ```
+ */
+export declare function parsePorcelainWorktrees(output: string): PorcelainWorktree[];
+/**
+ * Real path of `p`, or its resolved form when it does not exist.
+ *
+ * @param p - Path
+ * @returns Canonical path for comparisons
+ */
+export declare function canonicalPath(p: string): string;
+/**
+ * Whether `child` is `parent` or inside it (both canonicalised first).
+ *
+ * @param child - Candidate path
+ * @param parent - Directory
+ * @returns True when child === parent or child is under parent
+ *
+ * @example
+ * ```typescript
+ * isPathInside('/r/.claude/worktrees/a/src', '/r/.claude/worktrees/a'); // true
+ * isPathInside('/r/.claude/worktrees/ab', '/r/.claude/worktrees/a');    // false
+ * ```
+ */
+export declare function isPathInside(child: string, parent: string): boolean;
+/**
+ * Latest modification time (ms) of a worktree: the directory itself plus its
+ * private git dir's `index`, `HEAD` and `logs/HEAD` — every commit, checkout,
+ * stage or reset touches one of those. Uncommitted edits are caught by the
+ * dirty check instead.
+ *
+ * @param worktreePath - Worktree root
+ * @param gitDir - Its private git dir (`.git/worktrees/<name>`), when known
+ * @returns Newest mtime in ms, or null when nothing could be stat'ed
+ */
+export declare function latestWorktreeMtimeMs(worktreePath: string, gitDir: string | null): number | null;
+/**
+ * Current working directories of every process this user can see.
+ *
+ * macOS: `lsof -a -d cwd -u <uid> -Fn`. Linux: `/proc/<pid>/cwd`. Returns
+ * null when the probe cannot run, so the caller can treat "unknown" as busy.
+ *
+ * @returns Absolute cwd paths (deduplicated), or null when unavailable
+ */
+export declare function listProcessCwds(): Promise<string[] | null>;
+/**
+ * Whether the kill switch disables the janitor.
+ *
+ * @param env - Environment (defaults to process.env)
+ * @returns True when `CREWLY_WORKTREE_JANITOR` is `0`/`off`/`false`/`no`
+ */
+export declare function isJanitorDisabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Yield to the event loop every YIELD_EVERY_ENTRIES calls, so a long
+ * filesystem walk never holds up Slack, relay polls or PTY I/O.
+ */
+export declare class EventLoopYielder {
+    private count;
+    /**
+     * Count one unit of work; every YIELD_EVERY_ENTRIES units, wait one
+     * `setImmediate` turn.
+     *
+     * @returns Resolves when the caller may continue
+     */
+    tick(): Promise<void>;
+}
+/**
+ * Git dir a `.git` file points to (`gitdir: <path>`), resolved against `dir`.
+ *
+ * @param dir - Directory holding the `.git` file
+ * @returns Absolute git dir, or null when there is no readable `.git` file
+ */
+export declare function readGitFilePointer(dir: string): Promise<string | null>;
+/**
+ * Main worktree of the repo a linked worktree belongs to, read from the
+ * worktree's `.git` file (`gitdir: <main>/.git/worktrees/<name>`). Returns
+ * null for anything else: a `.git` directory (a normal clone), a submodule
+ * (`gitdir: …/.git/modules/…`), or an unreadable file.
+ *
+ * @param dir - Directory that may be a linked worktree
+ * @returns Absolute path of the main worktree, or null
+ *
+ * @example
+ * ```typescript
+ * // /tmp/visa-cm-wt/.git contains "gitdir: /src/ce-core/.git/worktrees/visa-cm-wt"
+ * await mainRepoOfLinkedWorktree('/tmp/visa-cm-wt'); // '/src/ce-core'
+ * ```
+ */
+export declare function mainRepoOfLinkedWorktree(dir: string): Promise<string | null>;
+/** A git checkout found on disk. */
+export interface FoundRepo {
+    /** Directory holding `.git` */
+    path: string;
+    /** `dir` for a `.git` directory (clone / main worktree), `file` for a `.git` file (linked worktree or submodule) */
+    kind: 'dir' | 'file';
+}
+/**
+ * Find git checkouts under `root` without following symlinks. A directory
+ * with a `.git` directory or file is a checkout and is not descended into;
+ * `node_modules` and `.git` are never descended into. Fully async; yields to
+ * the event loop every few directories.
+ *
+ * @param root - Directory to search (itself included, at depth 0)
+ * @param maxDepth - Deepest level searched (root = 0)
+ * @param maxDirs - Stop after visiting this many directories
+ * @returns Checkouts found, in walk order
+ */
+export declare function findGitCheckouts(root: string, maxDepth: number, maxDirs?: number): Promise<FoundRepo[]>;
+/**
+ * Main worktrees of every repo that owns a linked worktree somewhere under
+ * the given roots (e.g. `/tmp/claude-501/visa-cm-wt` → `~/src/ce-core`), so
+ * repos that are not registered projects still get their temp worktrees
+ * cleaned. Visits at most DISCOVERY_MAX_DIRS directories per root.
+ *
+ * @param roots - Temp roots to scan (missing roots are skipped)
+ * @returns De-duplicated main-worktree paths
+ */
+export declare function discoverLinkedWorktreeRepos(roots: readonly string[]): Promise<string[]>;
+/**
+ * Newest mtime (ms) of `dir` and everything within `depth` levels below it,
+ * using lstat (symlinks are not followed). Async; yields every few entries.
+ *
+ * @param dir - Directory
+ * @param depth - Levels below `dir` to include (0 = only `dir`)
+ * @returns Newest mtime in ms, or null when `dir` cannot be stat'ed
+ */
+export declare function latestTreeMtimeMs(dir: string, depth: number): Promise<number | null>;
+/**
+ * Disk usage of a path in bytes (`du -sk` in a child process, so the event
+ * loop is never blocked; `du` does not follow symlinks).
+ *
+ * @param p - File or directory
+ * @returns Bytes, or null when `du` failed or timed out
+ */
+export declare function diskUsageBytes(p: string): Promise<number | null>;
+/**
+ * Human-readable size (`1.8 GB`, `512 MB`).
+ *
+ * @param bytes - Size in bytes
+ * @returns Short string with one decimal for GB
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=worktree-janitor.git.d.ts.map

package/dist/cli/backend/src/services/worktree/worktree-janitor.git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-janitor.git.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/worktree/worktree-janitor.git.ts"],"names":[],"mappings":"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"}