@skroyc/librarian 0.1.0

package/dist/tools/grep-content.tool.js

@@ -0,0 +1,229 @@
+import { tool } from "langchain";
+import { z } from "zod";
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { logger } from "../utils/logger.js";
+import { isTextFile } from "../utils/file-utils.js";
+async function readFileContent(filePath) {
+    try {
+        return await Bun.file(filePath).text();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to read file: ${errorMessage}`);
+    }
+}
+function searchFileContent(content, regex) {
+    const lines = content.split("\n");
+    const matches = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined) {
+            continue;
+        }
+        const match = regex.exec(line);
+        if (match) {
+            matches.push({
+                line: i + 1,
+                column: match.index + 1,
+                text: line,
+                match,
+            });
+            regex.lastIndex = 0;
+        }
+    }
+    return matches;
+}
+async function findFiles(dirPath, pattern, recursive = true) {
+    const foundFiles = [];
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            if (recursive) {
+                const subDirFiles = await findFiles(fullPath, pattern, recursive);
+                foundFiles.push(...subDirFiles);
+            }
+        }
+        else if (entry.isFile() && (pattern === "*" || entry.name.includes(pattern.replace(/\*/g, "")))) {
+            foundFiles.push(fullPath);
+        }
+    }
+    return foundFiles;
+}
+async function validateAndResolvePath(workingDir, searchPath) {
+    const resolvedPath = path.resolve(workingDir, searchPath);
+    const resolvedWorkingDir = path.resolve(workingDir);
+    const relativePath = path.relative(resolvedWorkingDir, resolvedPath);
+    logger.debug("TOOL", "Path validation", {
+        resolvedPath: resolvedPath.replace(Bun.env.HOME || "", "~"),
+        resolvedWorkingDir: resolvedWorkingDir.replace(Bun.env.HOME || "", "~"),
+        relativePath,
+        validated: !relativePath.startsWith(".."),
+    });
+    if (relativePath.startsWith("..")) {
+        logger.error("PATH", "Search path escapes working directory sandbox", undefined, { searchPath, relativePath });
+        throw new Error(`Search path "${searchPath}" attempts to escape the working directory sandbox`);
+    }
+    const stats = await stat(resolvedPath);
+    if (!stats.isDirectory()) {
+        logger.error("TOOL", "Search path is not a directory", undefined, {
+            searchPath,
+        });
+        throw new Error(`Search path "${searchPath}" is not a directory`);
+    }
+    return resolvedPath;
+}
+async function findFilesToSearch(resolvedPath, patterns, recursive) {
+    let filesToSearch = [];
+    for (const pattern of patterns) {
+        const foundFiles = await findFiles(resolvedPath, pattern, recursive);
+        filesToSearch = [...filesToSearch, ...foundFiles];
+    }
+    logger.debug("TOOL", "Files to search", {
+        count: filesToSearch.length,
+        patterns,
+    });
+    return filesToSearch;
+}
+function compileSearchRegex(query, regex, caseSensitive) {
+    const flags = caseSensitive ? "gm" : "gim";
+    if (regex) {
+        try {
+            const searchRegex = new RegExp(query, flags);
+            logger.debug("TOOL", "Regex pattern compiled", { query, flags });
+            return searchRegex;
+        }
+        catch (e) {
+            logger.error("TOOL", "Invalid regex pattern", e instanceof Error ? e : new Error(String(e)), { query });
+            throw new Error(`Invalid regex pattern: ${e.message}`);
+        }
+    }
+    const escapedQuery = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const searchRegex = new RegExp(escapedQuery, flags);
+    logger.debug("TOOL", "Escaped query compiled to regex", {
+        originalQuery: query,
+        flags,
+    });
+    return searchRegex;
+}
+async function performGrepSearch(filesToSearch, searchRegex, maxResults) {
+    const results = [];
+    let totalMatches = 0;
+    for (const file of filesToSearch) {
+        if (totalMatches >= maxResults) {
+            break;
+        }
+        if (await isTextFile(file)) {
+            try {
+                const content = await readFileContent(file);
+                const fileMatches = searchFileContent(content, searchRegex);
+                if (fileMatches.length > 0) {
+                    const limitedMatches = fileMatches.slice(0, maxResults - totalMatches);
+                    results.push({ path: file, matches: limitedMatches });
+                    totalMatches += limitedMatches.length;
+                }
+            }
+            catch {
+            }
+        }
+    }
+    return results;
+}
+function formatGrepResults(results, query) {
+    if (results.length === 0) {
+        return `No matches found for query "${query}" in the searched files`;
+    }
+    const totalMatches = results.reduce((sum, r) => sum + r.matches.length, 0);
+    let output = `Found ${totalMatches} matches for query "${query}" in ${results.length} files:\n\n`;
+    for (const result of results) {
+        output += `File: ${result.path}\n`;
+        for (const match of result.matches) {
+            output += `  Line ${match.line}, Col ${match.column}: ${match.text}\n`;
+        }
+        output += "\n";
+    }
+    return output;
+}
+export const grepContentTool = tool(async ({ searchPath = ".", query, patterns = ["*"], caseSensitive = false, regex = false, recursive = true, maxResults = 100, }, config) => {
+    const timingId = logger.timingStart("grepContent");
+    logger.info("TOOL", "grep_content called", {
+        searchPath,
+        queryLength: query.length,
+        patterns,
+        caseSensitive,
+        regex,
+        recursive,
+        maxResults,
+    });
+    try {
+        const workingDir = config?.context?.workingDir;
+        if (!workingDir) {
+            throw new Error("Context with workingDir is required for file operations");
+        }
+        logger.debug("TOOL", "Working directory", {
+            workingDir: workingDir.replace(Bun.env.HOME || "", "~"),
+        });
+        if (!query) {
+            logger.error("TOOL", "Query parameter missing", undefined, {});
+            throw new Error('The "query" parameter is required');
+        }
+        const resolvedPath = await validateAndResolvePath(workingDir, searchPath);
+        const filesToSearch = await findFilesToSearch(resolvedPath, patterns, recursive);
+        const searchRegex = compileSearchRegex(query, regex, caseSensitive);
+        const results = await performGrepSearch(filesToSearch, searchRegex, maxResults);
+        logger.timingEnd(timingId, "TOOL", "grep_content completed");
+        logger.debug("TOOL", "Search completed", {
+            filesSearched: filesToSearch.length,
+            filesWithMatches: results.length,
+            totalMatches: results.reduce((sum, r) => sum + r.matches.length, 0),
+        });
+        return formatGrepResults(results, query);
+    }
+    catch (error) {
+        logger.error("TOOL", "grep_content failed", error instanceof Error ? error : new Error(String(error)), { searchPath, query });
+        return `Error searching content: ${error.message}`;
+    }
+}, {
+    name: "grep_content",
+    description: `A powerful search tool built on ripgrep
+
+Usage:
+- ALWAYS use grep_content for search tasks.
+- Supports full regex syntax (e.g., "log.*Error", "function\\s+\\w+")
+- Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
+- Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use \`interface{}\` to find \`interface{}\` in Go code)
+`,
+    schema: z.object({
+        searchPath: z.string().describe("The directory path to search in"),
+        query: z
+            .string()
+            .describe("The search query - the text or pattern to look for in files"),
+        patterns: z
+            .array(z.string())
+            .optional()
+            .default(["*"])
+            .describe("File patterns to search in (e.g., ['*.js', '*.ts'])"),
+        caseSensitive: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether the search should be case-sensitive. Defaults to `false`"),
+        regex: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether the query should be treated as a regular expression. Defaults to `false`"),
+        recursive: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Whether to search recursively in subdirectories. Defaults to `true`"),
+        maxResults: z
+            .number()
+            .optional()
+            .default(100)
+            .describe("Maximum number of matches to return. Defaults to 100"),
+    }),
+});
+//# sourceMappingURL=grep-content.tool.js.map

package/dist/tools/grep-content.tool.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function isTextFile(filePath: string): Promise<boolean>;
+//# sourceMappingURL=file-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAWA,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BnE"}

package/dist/utils/file-utils.js

@@ -0,0 +1,28 @@
+import path from 'node:path';
+export async function isTextFile(filePath) {
+    const textExtensions = new Set([
+        '.txt', '.js', '.ts', '.jsx', '.tsx', '.json', '.yaml', '.yml', '.md',
+        '.html', '.htm', '.css', '.scss', '.sass', '.less', '.py', '.rb', '.java',
+        '.cpp', '.c', '.h', '.hpp', '.go', '.rs', '.php', '.sql', '.xml', '.csv',
+        '.toml', '.lock', '.sh', '.bash', '.zsh', '.env', '.dockerfile', 'dockerfile',
+        '.gitignore', '.npmrc', '.prettierrc', '.eslintrc', '.editorconfig', '.jsonc'
+    ]);
+    const ext = path.extname(filePath).toLowerCase();
+    if (textExtensions.has(ext)) {
+        return true;
+    }
+    try {
+        const buffer = await Bun.file(filePath).arrayBuffer();
+        const uint8Array = new Uint8Array(buffer);
+        for (let i = 0; i < Math.min(512, uint8Array.length); i++) {
+            if (uint8Array[i] === 0) {
+                return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=file-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAKA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;QACrE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO;QACzE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;QACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY;QAC7E,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ;KAC9E,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAGA,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1D,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+export type LogLevel = 'INFO' | 'DEBUG' | 'WARN' | 'ERROR';
+export type LogComponent = 'CLI' | 'CONFIG' | 'LIBRARIAN' | 'AGENT' | 'TOOL' | 'LLM' | 'GIT' | 'PATH' | 'LOGGER' | 'TIMING';
+interface LogMetadata {
+    [key: string]: unknown;
+}
+declare class Logger {
+    private static instance;
+    private writer;
+    private debugMode;
+    private readonly timingOperations;
+    private constructor();
+    static getInstance(): Logger;
+    setDebugMode(enabled: boolean): void;
+    private initializeLogFile;
+    private formatTimestamp;
+    private redactMetadata;
+    private getRedactedValue;
+    private redactUrl;
+    private formatLogEntry;
+    private writeLog;
+    private log;
+    info(component: LogComponent, message: string, metadata?: LogMetadata): void;
+    debug(component: LogComponent, message: string, metadata?: LogMetadata): void;
+    warn(component: LogComponent, message: string, metadata?: LogMetadata): void;
+    error(component: LogComponent, message: string, error?: Error, metadata?: LogMetadata): void;
+    timingStart(operation: string): string;
+    timingEnd(operationId: string, component: LogComponent, message?: string): void;
+    close(): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5H,UAAU,WAAW;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAOD,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAE5E,OAAO;IAMP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;YAQtB,iBAAiB;IAgD/B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,cAAc;IAerB,OAAO,CAAC,QAAQ;IAajB,OAAO,CAAC,GAAG;IAYX,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAO5E,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAS7E,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAO5E,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAoB5F,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAetC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAqB9E,KAAK,IAAI,IAAI;CASf;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,177 @@
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+class Logger {
+    static instance;
+    writer = null;
+    debugMode = false;
+    timingOperations = new Map();
+    constructor() {
+        this.initializeLogFile().catch(() => {
+        });
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    setDebugMode(enabled) {
+        this.debugMode = enabled;
+    }
+    async initializeLogFile() {
+        try {
+            const now = new Date();
+            const isoString = now.toISOString();
+            if (!isoString) {
+                throw new Error('Failed to generate timestamp');
+            }
+            const year = now.getFullYear();
+            const month = String(now.getMonth() + 1).padStart(2, '0');
+            const day = String(now.getDate()).padStart(2, '0');
+            const hours = String(now.getHours()).padStart(2, '0');
+            const minutes = String(now.getMinutes()).padStart(2, '0');
+            const seconds = String(now.getSeconds()).padStart(2, '0');
+            const ms = String(now.getMilliseconds()).padStart(3, '0');
+            const timestamp = `${year}-${month}-${day}_${hours}-${minutes}-${seconds}_${ms}`;
+            const logDir = path.join(os.homedir(), '.config', 'librarian', 'logs');
+            if (!(await Bun.file(logDir).exists())) {
+                await mkdir(logDir, { recursive: true });
+            }
+            const logFilename = `${timestamp}-librarian.log`;
+            const logPath = path.join(logDir, logFilename);
+            const logFile = Bun.file(logPath);
+            this.writer = logFile.writer();
+            this.info('LOGGER', `Logging initialized: ${logPath}`);
+        }
+        catch {
+        }
+    }
+    formatTimestamp() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        const ms = String(now.getMilliseconds()).padStart(3, '0');
+        return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${ms}`;
+    }
+    redactMetadata(metadata) {
+        const redacted = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            redacted[key] = this.getRedactedValue(key, value);
+        }
+        return redacted;
+    }
+    getRedactedValue(key, value) {
+        const lowerKey = key.toLowerCase();
+        if (['apiKey', 'token', 'secret', 'password'].includes(lowerKey)) {
+            return '[REDACTED]';
+        }
+        if ((key === 'query' || key === 'content') && typeof value === 'string') {
+            return value.length;
+        }
+        if ((key === 'repoUrl' || key === 'baseURL') && typeof value === 'string') {
+            return this.redactUrl(value);
+        }
+        if (key === 'workingDir' && typeof value === 'string') {
+            return value.replace(os.homedir(), '~');
+        }
+        if (typeof value === 'string' && (value.includes(os.homedir()) || value.includes('/home/'))) {
+            return value.replace(os.homedir(), '~');
+        }
+        return value;
+    }
+    redactUrl(value) {
+        try {
+            const url = new URL(value);
+            return url.hostname;
+        }
+        catch {
+            return '[INVALID_URL]';
+        }
+    }
+    formatLogEntry(level, component, message, metadata) {
+        const timestamp = this.formatTimestamp();
+        let entry = `[${timestamp}] [${level}] [${component}] ${message}`;
+        if (metadata && Object.keys(metadata).length > 0) {
+            const redactedMetadata = this.redactMetadata(metadata);
+            entry += ` | ${JSON.stringify(redactedMetadata)}`;
+        }
+        return entry;
+    }
+    writeLog(entry) {
+        try {
+            if (this.writer) {
+                this.writer.write(`${entry}\n`);
+            }
+        }
+        catch {
+        }
+    }
+    log(level, component, message, metadata) {
+        try {
+            const entry = this.formatLogEntry(level, component, message, metadata);
+            this.writeLog(entry);
+        }
+        catch {
+        }
+    }
+    info(component, message, metadata) {
+        this.log('INFO', component, message, metadata);
+    }
+    debug(component, message, metadata) {
+        if (this.debugMode) {
+            this.log('DEBUG', component, message, metadata);
+        }
+    }
+    warn(component, message, metadata) {
+        this.log('WARN', component, message, metadata);
+    }
+    error(component, message, error, metadata) {
+        const errorMetadata = metadata ? { ...metadata } : {};
+        if (error) {
+            errorMetadata.errorName = error.name;
+            errorMetadata.errorMessage = error.message;
+            if (error.stack) {
+                errorMetadata.stack = error.stack;
+            }
+        }
+        this.log('ERROR', component, message, errorMetadata);
+    }
+    timingStart(operation) {
+        const operationId = `${operation}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        this.timingOperations.set(operationId, {
+            operation,
+            startTime: performance.now()
+        });
+        this.debug('TIMING', `Started: ${operation}`);
+        return operationId;
+    }
+    timingEnd(operationId, component, message) {
+        const timing = this.timingOperations.get(operationId);
+        if (timing) {
+            const duration = performance.now() - timing.startTime;
+            const durationMs = Math.round(duration);
+            this.timingOperations.delete(operationId);
+            const logMessage = message || `Completed: ${timing.operation}`;
+            this.info(component, logMessage, { duration: `${durationMs}ms` });
+            if (this.debugMode) {
+                this.debug('TIMING', `Ended: ${timing.operation}`, { durationMs });
+            }
+        }
+    }
+    close() {
+        try {
+            if (this.writer) {
+                this.writer.end();
+            }
+        }
+        catch {
+        }
+    }
+}
+export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function expandTilde(filePath: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAWA,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/utils/path-utils.js

@@ -0,0 +1,9 @@
+import path from 'node:path';
+import os from 'node:os';
+export function expandTilde(filePath) {
+    if (filePath.startsWith('~/')) {
+        return path.join(os.homedir(), filePath.slice(2));
+    }
+    return filePath;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAKA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAKzB,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@skroyc/librarian",
+  "version": "0.1.0",
+  "description": "Librarian CLI - Technology Research Agent",
+  "main": "./dist/index.js",
+  "bin": {
+    "librarian": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js",
+      "require": "./dist/cli.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.0.0"
+  },
+  "type": "module",
+  "scripts": {
+    "prepublishOnly": "npm run build:dev",
+    "build": "bun build --outfile librarian --target bun ./src/cli.ts",
+    "build:dev": "tsc",
+    "test": "bun test tests/",
+    "test:watch": "bun test --watch tests/",
+    "lint": "eslint src --ext .ts",
+    "start": "bun dist/index.js",
+    "cli": "bun dist/cli.js",
+    "postinstall": "bunx bun2nix -o bun.nix"
+  },
+  "keywords": [
+    "cli",
+    "research",
+    "ai",
+    "typescript",
+    "langchain",
+    "git"
+  ],
+  "author": "Oscar",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SkrOYC/librarian.git"
+  },
+  "homepage": "https://github.com/SkrOYC/librarian#readme",
+  "bugs": {
+    "url": "https://github.com/SkrOYC/librarian/issues"
+  },
+  "dependencies": {
+    "@langchain/anthropic": "^1.3.2",
+    "@langchain/core": "^1.1.7",
+    "@langchain/google-genai": "^2.1.2",
+    "@langchain/langgraph": "^1.0.7",
+    "@langchain/openai": "^1.2.0",
+    "commander": "^14.0.2",
+    "glob": "^13.0.0",
+    "isomorphic-git": "^1.36.1",
+    "langchain": "^1.2.2",
+    "yaml": "^2.8.2",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "@types/bun": "^1.3.5",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "bun-types": "^1.3.5",
+    "bun2nix": "^2.0.6",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3",
+    "ultracite": "7.0.11"
+  }
+}