@antaif3ng/til-work 0.1.0

package/dist/utils/autocomplete.js

@@ -0,0 +1,191 @@
+/**
+ * Path autocomplete for @ file references in the interactive REPL.
+ * Uses `fd` for fuzzy search when available, falls back to readdirSync.
+ * Cross-platform: supports both Unix (/) and Windows (\) path separators.
+ */
+import { readdirSync, statSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { join, dirname, basename, sep } from "node:path";
+import { homedir } from "node:os";
+const IS_WINDOWS = process.platform === "win32";
+/** Check if a path string contains a directory separator (/ or \). */
+function hasSep(p) {
+    return p.includes("/") || p.includes("\\");
+}
+let fdPath;
+function detectFd() {
+    if (fdPath !== undefined)
+        return fdPath;
+    const locateCmd = IS_WINDOWS ? "where fd" : "which fd";
+    try {
+        const result = execSync(locateCmd, { encoding: "utf-8", timeout: 2000 }).trim();
+        // `where` on Windows may return multiple lines; take the first
+        fdPath = result.split(/\r?\n/)[0] || null;
+    }
+    catch {
+        if (!IS_WINDOWS) {
+            try {
+                const result = execSync("which fdfind", { encoding: "utf-8", timeout: 2000 }).trim();
+                fdPath = result || null;
+            }
+            catch {
+                fdPath = null;
+            }
+        }
+        else {
+            fdPath = null;
+        }
+    }
+    return fdPath;
+}
+/**
+ * Expand ~ to home directory. Keeps the original prefix for display purposes
+ * but returns a resolved version for filesystem operations.
+ */
+function expandTilde(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/") || p.startsWith("~\\"))
+        return homedir() + p.slice(1);
+    return p;
+}
+/**
+ * Get file suggestions for an @ prefix.
+ * Supports relative paths, absolute paths (/...), and home paths (~/).
+ * @param prefix - The text after @, e.g. "src/co", "~/dev/", "/usr/local/"
+ * @param cwd - Working directory
+ */
+export function getFileSuggestions(prefix, cwd) {
+    const expanded = expandTilde(prefix);
+    const isHomeOrAbsolute = expanded !== prefix || prefix.startsWith("/");
+    const fd = detectFd();
+    if (fd && expanded.length > 0) {
+        const results = getFuzzyFileSuggestions(expanded, cwd, fd);
+        if (isHomeOrAbsolute)
+            return restoreDisplayPrefix(results, prefix, expanded);
+        return results;
+    }
+    const results = getDirectorySuggestions(expanded, cwd);
+    if (isHomeOrAbsolute)
+        return restoreDisplayPrefix(results, prefix, expanded);
+    return results;
+}
+/**
+ * When the user typed ~/... or /abs/..., the internal search used the
+ * expanded path. We restore the display/value to show the original prefix
+ * form (e.g. ~/dev/foo instead of /Users/xxx/dev/foo).
+ */
+function restoreDisplayPrefix(items, originalPrefix, expandedPrefix) {
+    if (originalPrefix === expandedPrefix)
+        return items;
+    const expandedDir = expandedPrefix.endsWith("/") ? expandedPrefix.slice(0, -1) : dirname(expandedPrefix);
+    const originalDir = originalPrefix.endsWith("/") ? originalPrefix.slice(0, -1) : dirname(originalPrefix);
+    return items.map((item) => ({
+        ...item,
+        display: item.display.replace(expandedDir, originalDir),
+        value: item.value.replace(expandedDir, originalDir),
+    }));
+}
+function getFuzzyFileSuggestions(query, cwd, fdBin) {
+    try {
+        if (query.endsWith("/") || query.endsWith("\\")) {
+            return getDirectorySuggestions(query, cwd);
+        }
+        const dirPart = hasSep(query) ? dirname(query) : "";
+        const searchDir = dirPart ? join(cwd, dirPart) : cwd;
+        const searchQuery = hasSep(query) ? basename(query) : query;
+        const cmd = `${fdBin} --max-results 20 --color never "${searchQuery}" "${searchDir}"`;
+        const output = execSync(cmd, {
+            encoding: "utf-8",
+            timeout: 3000,
+            cwd,
+        }).trim();
+        if (!output)
+            return getDirectorySuggestions(query, cwd);
+        const results = [];
+        for (const line of output.split(/\r?\n/)) {
+            const fullPath = line.trim();
+            if (!fullPath)
+                continue;
+            let relative = fullPath;
+            if (relative.startsWith(cwd)) {
+                relative = relative.slice(cwd.length);
+                if (relative.startsWith(sep))
+                    relative = relative.slice(1);
+            }
+            // Normalize to forward slashes for consistent display
+            relative = relative.replace(/\\/g, "/");
+            let isDir = false;
+            try {
+                isDir = statSync(fullPath).isDirectory();
+            }
+            catch { }
+            const display = isDir ? relative + "/" : relative;
+            results.push({
+                value: `@${display}`,
+                display,
+                isDirectory: isDir,
+            });
+        }
+        return results.slice(0, 20);
+    }
+    catch {
+        return getDirectorySuggestions(query, cwd);
+    }
+}
+function getDirectorySuggestions(prefix, cwd) {
+    const normalizedPrefix = prefix.replace(/\\/g, "/");
+    let dirPart;
+    let filePart;
+    if (normalizedPrefix.endsWith("/")) {
+        dirPart = normalizedPrefix.slice(0, -1);
+        filePart = "";
+    }
+    else if (hasSep(normalizedPrefix)) {
+        dirPart = dirname(normalizedPrefix);
+        filePart = basename(normalizedPrefix);
+    }
+    else {
+        dirPart = "";
+        filePart = normalizedPrefix;
+    }
+    const searchDir = dirPart ? join(cwd, dirPart) : cwd;
+    try {
+        const entries = readdirSync(searchDir, { withFileTypes: true });
+        const results = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith("."))
+                continue;
+            if (filePart && !entry.name.toLowerCase().startsWith(filePart.toLowerCase()))
+                continue;
+            // Always use forward slashes in display/value for consistency
+            const relativePath = dirPart ? `${dirPart}/${entry.name}` : entry.name;
+            const isDir = entry.isDirectory();
+            const display = isDir ? relativePath + "/" : relativePath;
+            results.push({
+                value: `@${display}`,
+                display,
+                isDirectory: isDir,
+            });
+        }
+        results.sort((a, b) => {
+            if (a.isDirectory !== b.isDirectory)
+                return a.isDirectory ? -1 : 1;
+            return a.display.localeCompare(b.display);
+        });
+        return results.slice(0, 30);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract the @ prefix from a line for autocomplete purposes.
+ * Returns the text after @, or null if not in an @ context.
+ */
+export function extractAtPrefix(line) {
+    // Find last @ that is either at start of line or after whitespace
+    const match = line.match(/(?:^|(?<=\s))@([^\s]*)$/);
+    return match ? match[1] : null;
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/utils/autocomplete.js.map

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

package/dist/utils/file-processor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Process @file CLI arguments into text content for injection into user messages.
+ * Text files are wrapped in <file> XML blocks; binary/unsupported files are skipped.
+ */
+export interface ProcessedFiles {
+    text: string;
+    errors: string[];
+}
+export declare function processFileArguments(fileArgs: string[], cwd: string): ProcessedFiles;
+/**
+ * Parse a user input string and extract @path references.
+ * Returns { expandedText, fileArgs } where expandedText has @refs resolved
+ * and fileArgs contains the extracted paths.
+ */
+export declare function extractAtReferences(input: string, cwd: string): {
+    expandedText: string;
+    fileContent: string;
+};
+//# sourceMappingURL=file-processor.d.ts.map

package/dist/utils/file-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/utils/file-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAgBD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAwCpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAwB7G"}

package/dist/utils/file-processor.js

@@ -0,0 +1,86 @@
+/**
+ * Process @file CLI arguments into text content for injection into user messages.
+ * Text files are wrapped in <file> XML blocks; binary/unsupported files are skipped.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { resolveReadPath } from "./path.js";
+const IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".bmp", ".ico"]);
+const BINARY_EXTENSIONS = new Set([
+    ".zip", ".tar", ".gz", ".bz2", ".7z", ".rar",
+    ".exe", ".dll", ".so", ".dylib",
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx",
+    ".mp3", ".mp4", ".avi", ".mov", ".wav",
+    ".woff", ".woff2", ".ttf", ".otf", ".eot",
+]);
+function getExtension(path) {
+    const dot = path.lastIndexOf(".");
+    return dot >= 0 ? path.slice(dot).toLowerCase() : "";
+}
+export function processFileArguments(fileArgs, cwd) {
+    let text = "";
+    const errors = [];
+    for (const fileArg of fileArgs) {
+        const absolutePath = resolve(resolveReadPath(fileArg, cwd));
+        try {
+            const stats = statSync(absolutePath);
+            if (stats.isDirectory()) {
+                errors.push(`Skipping directory: ${absolutePath}`);
+                continue;
+            }
+            if (stats.size === 0) {
+                continue;
+            }
+        }
+        catch {
+            errors.push(`File not found: ${absolutePath}`);
+            continue;
+        }
+        const ext = getExtension(absolutePath);
+        if (BINARY_EXTENSIONS.has(ext)) {
+            errors.push(`Skipping binary file: ${absolutePath}`);
+            continue;
+        }
+        if (IMAGE_EXTENSIONS.has(ext)) {
+            text += `<file name="${absolutePath}">[Image file — use read tool to inspect if needed]</file>\n`;
+            continue;
+        }
+        try {
+            const content = readFileSync(absolutePath, "utf-8");
+            text += `<file name="${absolutePath}">\n${content}\n</file>\n`;
+        }
+        catch (err) {
+            errors.push(`Could not read ${absolutePath}: ${err.message}`);
+        }
+    }
+    return { text, errors };
+}
+/**
+ * Parse a user input string and extract @path references.
+ * Returns { expandedText, fileArgs } where expandedText has @refs resolved
+ * and fileArgs contains the extracted paths.
+ */
+export function extractAtReferences(input, cwd) {
+    // Match @path patterns: @word or @"quoted path"
+    // Note: on Windows paths may contain backslashes, but we require
+    // quoted form for paths with spaces: @"C:\path with spaces\file.txt"
+    const atPattern = /(?:^|(?<=\s))@("(?:[^"\\]|\\.)*"|[^\s]+)/g;
+    const fileArgs = [];
+    const expandedText = input.replace(atPattern, (match, pathPart) => {
+        let filePath = pathPart;
+        if (filePath.startsWith('"') && filePath.endsWith('"')) {
+            filePath = filePath.slice(1, -1).replace(/\\"/g, '"');
+        }
+        fileArgs.push(filePath);
+        return "";
+    }).replace(/\s{2,}/g, " ").trim();
+    if (fileArgs.length === 0) {
+        return { expandedText: input, fileContent: "" };
+    }
+    const processed = processFileArguments(fileArgs, cwd);
+    return {
+        expandedText: expandedText || "请查看以下文件",
+        fileContent: processed.text,
+    };
+}
+//# sourceMappingURL=file-processor.js.map

package/dist/utils/file-processor.js.map

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

package/dist/utils/path.d.ts

@@ -0,0 +1,8 @@
+export declare function expandPath(filePath: string): string;
+export declare function resolveToCwd(filePath: string, cwd: string): string;
+/**
+ * Resolve a read path with fallback strategies for macOS quirks:
+ * AM/PM narrow no-break space, NFD normalization, curly quotes.
+ */
+export declare function resolveReadPath(filePath: string, cwd: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAoBA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBrE"}

package/dist/utils/path.js

@@ -0,0 +1,60 @@
+import { accessSync, constants } from "node:fs";
+import * as os from "node:os";
+import { isAbsolute, resolve as resolvePath } from "node:path";
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+const NARROW_NO_BREAK_SPACE = "\u202F";
+function normalizeUnicodeSpaces(str) {
+    return str.replace(UNICODE_SPACES, " ");
+}
+function fileExists(filePath) {
+    try {
+        accessSync(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function expandPath(filePath) {
+    const normalized = normalizeUnicodeSpaces(filePath.startsWith("@") ? filePath.slice(1) : filePath);
+    if (normalized === "~")
+        return os.homedir();
+    // Handle both ~/path (Unix) and ~\path (Windows)
+    if (normalized.startsWith("~/") || normalized.startsWith("~\\")) {
+        return os.homedir() + normalized.slice(1);
+    }
+    return normalized;
+}
+export function resolveToCwd(filePath, cwd) {
+    const expanded = expandPath(filePath);
+    if (isAbsolute(expanded))
+        return expanded;
+    return resolvePath(cwd, expanded);
+}
+/**
+ * Resolve a read path with fallback strategies for macOS quirks:
+ * AM/PM narrow no-break space, NFD normalization, curly quotes.
+ */
+export function resolveReadPath(filePath, cwd) {
+    const resolved = resolveToCwd(filePath, cwd);
+    if (fileExists(resolved))
+        return resolved;
+    // macOS screenshot AM/PM with narrow no-break space
+    const amPmVariant = resolved.replace(/ (AM|PM)\./g, `${NARROW_NO_BREAK_SPACE}$1.`);
+    if (amPmVariant !== resolved && fileExists(amPmVariant))
+        return amPmVariant;
+    // macOS NFD normalization
+    const nfdVariant = resolved.normalize("NFD");
+    if (nfdVariant !== resolved && fileExists(nfdVariant))
+        return nfdVariant;
+    // macOS curly quote in screenshot names (e.g. French "Capture d'écran")
+    const curlyVariant = resolved.replace(/'/g, "\u2019");
+    if (curlyVariant !== resolved && fileExists(curlyVariant))
+        return curlyVariant;
+    // Combined NFD + curly
+    const nfdCurlyVariant = nfdVariant.replace(/'/g, "\u2019");
+    if (nfdCurlyVariant !== resolved && fileExists(nfdCurlyVariant))
+        return nfdCurlyVariant;
+    return resolved;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAClE,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAEvC,SAAS,sBAAsB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IACnC,IAAI,CAAC;QACJ,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnG,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IAC5C,iDAAiD;IACjD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAW;IACzD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,oDAAoD;IACpD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,qBAAqB,KAAK,CAAC,CAAC;IACnF,IAAI,WAAW,KAAK,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IAE5E,0BAA0B;IAC1B,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAEzE,wEAAwE;IACxE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,YAAY,KAAK,QAAQ,IAAI,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IAE/E,uBAAuB;IACvB,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAI,eAAe,KAAK,QAAQ,IAAI,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAExF,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/utils/shell.d.ts

@@ -0,0 +1,6 @@
+export declare function getShellConfig(): {
+    shell: string;
+    args: string[];
+};
+export declare function killProcessTree(pid: number): void;
+//# sourceMappingURL=shell.d.ts.map

package/dist/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAkBA,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BlE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAYjD"}

package/dist/utils/shell.js

@@ -0,0 +1,64 @@
+import { existsSync } from "node:fs";
+import { spawn, spawnSync } from "node:child_process";
+let cachedShellConfig = null;
+function findBashOnPath() {
+    const cmd = process.platform === "win32" ? "where" : "which";
+    const arg = process.platform === "win32" ? "bash.exe" : "bash";
+    try {
+        const result = spawnSync(cmd, [arg], { encoding: "utf-8", timeout: 5000 });
+        if (result.status === 0 && result.stdout) {
+            const firstMatch = result.stdout.trim().split(/\r?\n/)[0];
+            if (firstMatch)
+                return firstMatch;
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+export function getShellConfig() {
+    if (cachedShellConfig)
+        return cachedShellConfig;
+    if (process.platform === "win32") {
+        const paths = [
+            process.env.ProgramFiles && `${process.env.ProgramFiles}\\Git\\bin\\bash.exe`,
+            process.env["ProgramFiles(x86)"] && `${process.env["ProgramFiles(x86)"]}\\Git\\bin\\bash.exe`,
+        ].filter(Boolean);
+        for (const p of paths) {
+            if (existsSync(p)) {
+                cachedShellConfig = { shell: p, args: ["-c"] };
+                return cachedShellConfig;
+            }
+        }
+    }
+    if (existsSync("/bin/bash")) {
+        cachedShellConfig = { shell: "/bin/bash", args: ["-c"] };
+        return cachedShellConfig;
+    }
+    const bashOnPath = findBashOnPath();
+    if (bashOnPath) {
+        cachedShellConfig = { shell: bashOnPath, args: ["-c"] };
+        return cachedShellConfig;
+    }
+    cachedShellConfig = { shell: "sh", args: ["-c"] };
+    return cachedShellConfig;
+}
+export function killProcessTree(pid) {
+    if (process.platform === "win32") {
+        try {
+            spawn("taskkill", ["/F", "/T", "/PID", String(pid)], { stdio: "ignore", detached: true });
+        }
+        catch { /* ignore */ }
+    }
+    else {
+        try {
+            process.kill(-pid, "SIGKILL");
+        }
+        catch {
+            try {
+                process.kill(pid, "SIGKILL");
+            }
+            catch { /* already dead */ }
+        }
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/utils/shell.js.map

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

package/dist/utils/truncate.d.ts

@@ -0,0 +1,12 @@
+export declare const MAX_LINES = 2000;
+export declare const MAX_BYTES: number;
+export interface TruncationResult {
+    content: string;
+    truncated: boolean;
+    totalLines: number;
+    outputLines: number;
+}
+export declare function formatSize(bytes: number): string;
+export declare function truncateHead(content: string): TruncationResult;
+export declare function truncateTail(content: string): TruncationResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/utils/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,SAAS,QAAY,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAmB9D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAmB9D"}

package/dist/utils/truncate.js

@@ -0,0 +1,46 @@
+export const MAX_LINES = 2000;
+export const MAX_BYTES = 50 * 1024;
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+export function truncateHead(content) {
+    const totalBytes = Buffer.byteLength(content, "utf-8");
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    if (totalLines <= MAX_LINES && totalBytes <= MAX_BYTES) {
+        return { content, truncated: false, totalLines, outputLines: totalLines };
+    }
+    const outputLines = [];
+    let byteCount = 0;
+    for (let i = 0; i < lines.length && i < MAX_LINES; i++) {
+        const lineBytes = Buffer.byteLength(lines[i], "utf-8") + (i > 0 ? 1 : 0);
+        if (byteCount + lineBytes > MAX_BYTES)
+            break;
+        outputLines.push(lines[i]);
+        byteCount += lineBytes;
+    }
+    return { content: outputLines.join("\n"), truncated: true, totalLines, outputLines: outputLines.length };
+}
+export function truncateTail(content) {
+    const totalBytes = Buffer.byteLength(content, "utf-8");
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    if (totalLines <= MAX_LINES && totalBytes <= MAX_BYTES) {
+        return { content, truncated: false, totalLines, outputLines: totalLines };
+    }
+    const outputLines = [];
+    let byteCount = 0;
+    for (let i = lines.length - 1; i >= 0 && outputLines.length < MAX_LINES; i--) {
+        const lineBytes = Buffer.byteLength(lines[i], "utf-8") + (outputLines.length > 0 ? 1 : 0);
+        if (byteCount + lineBytes > MAX_BYTES)
+            break;
+        outputLines.unshift(lines[i]);
+        byteCount += lineBytes;
+    }
+    return { content: outputLines.join("\n"), truncated: true, totalLines, outputLines: outputLines.length };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/utils/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC;AASnC,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,IAAI,UAAU,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,IAAI,SAAS,GAAG,SAAS,GAAG,SAAS;YAAE,MAAM;QAC7C,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,SAAS,IAAI,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,IAAI,UAAU,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1F,IAAI,SAAS,GAAG,SAAS,GAAG,SAAS;YAAE,MAAM;QAC7C,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,SAAS,IAAI,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;AAC1G,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@antaif3ng/til-work",
+	"version": "0.1.0",
+	"description": "TIL Agent — 运行在终端里的个人 AI 助手 (Personal AI assistant CLI powered by LLM)",
+	"type": "module",
+	"bin": {
+		"til": "dist/cli.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
+		"dev": "tsc -p tsconfig.json --watch",
+		"start": "node dist/cli.js",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run build && npm test"
+	},
+	"keywords": [
+		"cli",
+		"agent",
+		"ai",
+		"assistant",
+		"llm",
+		"openai",
+		"anthropic",
+		"google",
+		"terminal",
+		"mcp"
+	],
+	"repository": {
+		"type": "git",
+		"url": ""
+	},
+	"author": "antaif3ng",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"chalk": "^5.5.0",
+		"cli-highlight": "^2.1.11",
+		"marked": "^17.0.4"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"typescript": "^5.7.3",
+		"vitest": "^4.1.0"
+	},
+	"engines": {
+		"node": ">=20.6.0"
+	},
+	"license": "MIT"
+}