chatroom-cli 1.31.1 → 1.32.1

package/dist/tools/parse-pdf/index.test.js

@@ -0,0 +1,183 @@
+/**
+ * Parse-PDF Tool — Unit Tests
+ *
+ * Tests the parse-pdf tool using injected dependencies (fake fs, mock parser,
+ * mock HTTP client). No real file system, network, or PDF parsing.
+ */
+import { describe, expect, it } from 'vitest';
+import { parsePdf } from './index.js';
+// ─── Fake Deps Factory ─────────────────────────────────────────────────────
+function createFakeDeps(initialFiles = {}, overrides) {
+    const store = new Map(Object.entries(initialFiles));
+    const writtenFiles = new Map();
+    const deps = {
+        fs: {
+            // OutputFsOps methods
+            access: async (p) => {
+                if (!store.has(p))
+                    throw new Error(`ENOENT: ${p}`);
+            },
+            mkdir: async (_p, _opts) => {
+                // no-op in tests
+            },
+            readFile: async (p, _encoding) => {
+                const content = store.get(p);
+                if (content === undefined)
+                    throw new Error(`ENOENT: ${p}`);
+                return typeof content === 'string' ? content : content.toString();
+            },
+            appendFile: async (p, content) => {
+                const existing = store.get(p) ?? '';
+                const value = typeof existing === 'string' ? existing + content : existing.toString() + content;
+                store.set(p, value);
+            },
+            // ParsePdfFsOps-specific methods
+            readFileAsBuffer: async (p) => {
+                const content = store.get(p);
+                if (content === undefined)
+                    throw new Error(`ENOENT: ${p}`);
+                return Buffer.isBuffer(content) ? content : Buffer.from(content);
+            },
+            writeFile: async (p, content, _encoding) => {
+                store.set(p, content);
+                writtenFiles.set(p, content);
+            },
+        },
+        parser: overrides?.parser ?? {
+            parse: async (_input) => {
+                return { text: 'Extracted PDF text content here.' };
+            },
+        },
+        http: overrides?.http ?? {
+            download: async (_url) => {
+                return Buffer.from('fake-pdf-bytes');
+            },
+        },
+    };
+    return { store, writtenFiles, deps };
+}
+// ─── Tests ──────────────────────────────────────────────────────────────────
+describe('parsePdf', () => {
+    describe('successful file parsing', () => {
+        it('parses a local PDF file and writes output', async () => {
+            const { writtenFiles, deps } = createFakeDeps({
+                '/project/document.pdf': Buffer.from('fake-pdf-bytes'),
+            });
+            const result = await parsePdf('/project/document.pdf', '/project', deps);
+            expect(result.success).toBe(true);
+            expect(result.outputPath).toBeDefined();
+            expect(result.outputPath).toContain('/project/.chatroom/parse-pdf-');
+            expect(result.outputPath).toMatch(/\.txt$/);
+            expect(result.message).toContain('PDF parsed successfully');
+            expect(result.message).toContain(result.outputPath);
+            // Verify the output file was written with the parsed text
+            expect(writtenFiles.size).toBe(1);
+            const outputContent = writtenFiles.values().next().value;
+            expect(outputContent).toBe('Extracted PDF text content here.');
+        });
+        it('includes the output file path in the result', async () => {
+            const { deps } = createFakeDeps({
+                '/project/report.pdf': Buffer.from('fake-pdf'),
+            });
+            const result = await parsePdf('/project/report.pdf', '/project', deps);
+            expect(result.success).toBe(true);
+            expect(result.outputPath).toBeDefined();
+            expect(result.outputPath.startsWith('/project/.chatroom/')).toBe(true);
+        });
+    });
+    describe('file not found', () => {
+        it('returns error when PDF file does not exist', async () => {
+            const { deps } = createFakeDeps();
+            const result = await parsePdf('/project/missing.pdf', '/project', deps);
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('PDF file not found');
+            expect(result.message).toContain('missing.pdf');
+            expect(result.outputPath).toBeUndefined();
+        });
+    });
+    describe('URL input', () => {
+        it('downloads and parses a PDF from a URL', async () => {
+            const { writtenFiles, deps } = createFakeDeps();
+            const result = await parsePdf('https://example.com/doc.pdf', '/project', deps);
+            expect(result.success).toBe(true);
+            expect(result.outputPath).toBeDefined();
+            expect(result.outputPath).toContain('/project/.chatroom/parse-pdf-');
+            expect(writtenFiles.size).toBe(1);
+        });
+        it('handles HTTP URL input', async () => {
+            const { deps } = createFakeDeps();
+            const result = await parsePdf('http://example.com/doc.pdf', '/project', deps);
+            expect(result.success).toBe(true);
+        });
+        it('returns error when URL download fails', async () => {
+            const { deps } = createFakeDeps({}, {
+                http: {
+                    download: async () => {
+                        throw new Error('HTTP 404: Not Found');
+                    },
+                },
+            });
+            const result = await parsePdf('https://example.com/missing.pdf', '/project', deps);
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('Failed to download PDF');
+            expect(result.message).toContain('HTTP 404');
+        });
+    });
+    describe('parse error', () => {
+        it('returns error when PDF parsing fails', async () => {
+            const { deps } = createFakeDeps({ '/project/corrupt.pdf': Buffer.from('not-a-pdf') }, {
+                parser: {
+                    parse: async () => {
+                        throw new Error('Invalid PDF header');
+                    },
+                },
+            });
+            const result = await parsePdf('/project/corrupt.pdf', '/project', deps);
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('Failed to parse PDF');
+            expect(result.message).toContain('Invalid PDF header');
+        });
+    });
+    describe('output path format', () => {
+        it('generates output path with correct format', async () => {
+            const { deps } = createFakeDeps({
+                '/work/test.pdf': Buffer.from('pdf'),
+            });
+            const result = await parsePdf('/work/test.pdf', '/work', deps);
+            expect(result.success).toBe(true);
+            // Pattern: parse-pdf-YYYYMMDD-HHmmss-SSS.txt
+            expect(result.outputPath).toMatch(/parse-pdf-\d{8}-\d{6}-\d{3}\.txt$/);
+        });
+    });
+    describe('output directory preparation failure', () => {
+        it('returns error when mkdir fails', async () => {
+            const { deps } = createFakeDeps({
+                '/project/doc.pdf': Buffer.from('fake-pdf'),
+            });
+            // Override mkdir to throw
+            deps.fs.mkdir = async () => {
+                throw new Error('EACCES: permission denied');
+            };
+            const result = await parsePdf('/project/doc.pdf', '/project', deps);
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('Failed to prepare output directory');
+            expect(result.message).toContain('EACCES');
+        });
+    });
+    describe('write failure', () => {
+        it('returns error when writeFile fails', async () => {
+            const { deps } = createFakeDeps({
+                '/project/doc.pdf': Buffer.from('fake-pdf'),
+            });
+            // Override writeFile to throw
+            deps.fs.writeFile = async () => {
+                throw new Error('ENOSPC: no space left on device');
+            };
+            const result = await parsePdf('/project/doc.pdf', '/project', deps);
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('Failed to write output file');
+            expect(result.message).toContain('ENOSPC');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/tools/parse-pdf/index.test.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tool Types — Base types shared by all CLI tools.
+ */
+/** Result of a tool execution. */
+export interface ToolResult {
+    success: boolean;
+    /** Path to the output file (if any). */
+    outputPath?: string;
+    /** Human-readable message for the agent. */
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/tools/types.js

@@ -0,0 +1,5 @@
+/**
+ * Tool Types — Base types shared by all CLI tools.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/convex-error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared error message extraction for CLI commands.
+ *
+ * ConvexErrors carry structured data (code, message) that is more helpful
+ * than the generic "[Request ID: xxx] Server Error" .message property.
+ */
+/**
+ * Extracts a user-friendly error message from a Convex error or generic Error.
+ * Prefers structured ConvexError data over the generic Error.message.
+ *
+ * Handles all ConvexError data types:
+ * - String data: `throw new ConvexError('some message')` → returns the string directly
+ * - Object data with message: `throw new ConvexError({ code: 'X', message: 'Y' })` → returns Y
+ * - Object data with code only: `throw new ConvexError({ code: 'X' })` → returns X
+ * - Other types: falls back to String(error.data)
+ * - Non-ConvexError: returns (error as Error).message or String(error) for non-Error values
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=convex-error.d.ts.map

package/dist/utils/convex-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-error.d.ts","sourceRoot":"","sources":["../../src/utils/convex-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkBtD"}

package/dist/utils/convex-error.js

@@ -0,0 +1,38 @@
+/**
+ * Shared error message extraction for CLI commands.
+ *
+ * ConvexErrors carry structured data (code, message) that is more helpful
+ * than the generic "[Request ID: xxx] Server Error" .message property.
+ */
+import { ConvexError } from 'convex/values';
+/**
+ * Extracts a user-friendly error message from a Convex error or generic Error.
+ * Prefers structured ConvexError data over the generic Error.message.
+ *
+ * Handles all ConvexError data types:
+ * - String data: `throw new ConvexError('some message')` → returns the string directly
+ * - Object data with message: `throw new ConvexError({ code: 'X', message: 'Y' })` → returns Y
+ * - Object data with code only: `throw new ConvexError({ code: 'X' })` → returns X
+ * - Other types: falls back to String(error.data)
+ * - Non-ConvexError: returns (error as Error).message or String(error) for non-Error values
+ */
+export function getErrorMessage(error) {
+    if (error instanceof ConvexError) {
+        if (typeof error.data === 'string') {
+            return error.data;
+        }
+        if (error.data !== null && typeof error.data === 'object') {
+            const data = error.data;
+            return data.message ?? data.code ?? String(error.data);
+        }
+        return String(error.data);
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (error === null || error === undefined) {
+        return String(error);
+    }
+    return String(error);
+}
+//# sourceMappingURL=convex-error.js.map

package/dist/utils/convex-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-error.js","sourceRoot":"","sources":["../../src/utils/convex-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAA2C,CAAC;YAC/D,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/utils/convex-error.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for the getErrorMessage() utility function.
+ *
+ * Tests all ConvexError data shapes plus regular errors and non-error values.
+ */
+export {};
+//# sourceMappingURL=convex-error.test.d.ts.map

package/dist/utils/convex-error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-error.test.d.ts","sourceRoot":"","sources":["../../src/utils/convex-error.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/convex-error.test.js

@@ -0,0 +1,71 @@
+/**
+ * Unit tests for the getErrorMessage() utility function.
+ *
+ * Tests all ConvexError data shapes plus regular errors and non-error values.
+ */
+import { ConvexError } from 'convex/values';
+import { describe, expect, it } from 'vitest';
+import { getErrorMessage } from './convex-error.js';
+describe('getErrorMessage', () => {
+    describe('ConvexError with string data', () => {
+        it('returns string data directly', () => {
+            const error = new ConvexError('Backlog item not found');
+            expect(getErrorMessage(error)).toBe('Backlog item not found');
+        });
+        it('returns empty string data', () => {
+            const error = new ConvexError('');
+            expect(getErrorMessage(error)).toBe('');
+        });
+    });
+    describe('ConvexError with object data containing message', () => {
+        it('returns data.message when present', () => {
+            const error = new ConvexError({ code: 'NOT_FOUND', message: 'Item not found' });
+            expect(getErrorMessage(error)).toBe('Item not found');
+        });
+        it('returns data.message even when code is present', () => {
+            const error = new ConvexError({ code: 'FORBIDDEN', message: 'Access denied' });
+            expect(getErrorMessage(error)).toBe('Access denied');
+        });
+    });
+    describe('ConvexError with object data containing code only', () => {
+        it('returns data.code when message is absent', () => {
+            const error = new ConvexError({ code: 'NOT_AUTHORIZED' });
+            expect(getErrorMessage(error)).toBe('NOT_AUTHORIZED');
+        });
+    });
+    describe('ConvexError with other data types', () => {
+        it('falls back to String(data) for numeric data', () => {
+            const error = new ConvexError(42);
+            expect(getErrorMessage(error)).toBe('42');
+        });
+        it('falls back to String(data) for null data', () => {
+            const error = new ConvexError(null);
+            expect(getErrorMessage(error)).toBe('null');
+        });
+    });
+    describe('regular Error', () => {
+        it('returns message from regular Error', () => {
+            const error = new Error('Something went wrong');
+            expect(getErrorMessage(error)).toBe('Something went wrong');
+        });
+        it('returns message from TypeError', () => {
+            const error = new TypeError('Cannot read property x of undefined');
+            expect(getErrorMessage(error)).toBe('Cannot read property x of undefined');
+        });
+    });
+    describe('non-Error values', () => {
+        it('returns "null" for null', () => {
+            expect(getErrorMessage(null)).toBe('null');
+        });
+        it('returns "undefined" for undefined', () => {
+            expect(getErrorMessage(undefined)).toBe('undefined');
+        });
+        it('returns the string itself for string values', () => {
+            expect(getErrorMessage('error string')).toBe('error string');
+        });
+        it('converts numbers to string', () => {
+            expect(getErrorMessage(404)).toBe('404');
+        });
+    });
+});
+//# sourceMappingURL=convex-error.test.js.map

package/dist/utils/convex-error.test.js.map

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

package/dist/utils/error-formatting.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Error formatting utilities for consistent CLI error messages
+ */
+/**
+ * Format an error message with optional suggestions
+ */
+export declare function formatError(message: string, suggestions?: string[]): void;
+/**
+ * Format a validation error with got/expected pattern
+ */
+export declare function formatValidationError(field: string, value: string, expected: string): void;
+/**
+ * Format a file access error
+ */
+export declare function formatFileError(operation: string, filePath: string, reason?: string): void;
+/**
+ * Format an authentication error
+ */
+export declare function formatAuthError(currentUrl?: string, otherUrls?: string[]): void;
+/**
+ * Format a chatroom ID validation error
+ */
+export declare function formatChatroomIdError(chatroomId: string | undefined): void;
+/**
+ * Check if an error is a network/connectivity error (backend unreachable)
+ * as opposed to an application-level error (auth invalid, etc.)
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Format a connectivity error message for when the backend is unreachable
+ */
+export declare function formatConnectivityError(error: unknown, backendUrl?: string): void;
+//# sourceMappingURL=error-formatting.d.ts.map

package/dist/utils/error-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatting.d.ts","sourceRoot":"","sources":["../../src/utils/error-formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAQzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAO1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAc/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqBtD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAYjF"}

package/dist/utils/error-formatting.js

@@ -0,0 +1,96 @@
+/**
+ * Error formatting utilities for consistent CLI error messages
+ */
+import { sanitizeForTerminal } from './terminal-safety.js';
+/**
+ * Format an error message with optional suggestions
+ */
+export function formatError(message, suggestions) {
+    console.error(`❌ ${message}`);
+    if (suggestions && suggestions.length > 0) {
+        console.error('');
+        suggestions.forEach((suggestion) => {
+            console.error(`💡 ${suggestion}`);
+        });
+    }
+}
+/**
+ * Format a validation error with got/expected pattern
+ */
+export function formatValidationError(field, value, expected) {
+    formatError(`Invalid ${field}`, [`Got: ${value}`, `Expected: ${expected}`]);
+}
+/**
+ * Format a file access error
+ */
+export function formatFileError(operation, filePath, reason) {
+    const message = `Cannot ${operation} file: ${filePath}`;
+    if (reason) {
+        formatError(message, [`Reason: ${reason}`]);
+    }
+    else {
+        console.error(`❌ ${message}`);
+    }
+}
+/**
+ * Format an authentication error
+ */
+export function formatAuthError(currentUrl, otherUrls) {
+    console.error(`❌ Not authenticated${currentUrl ? ` for: ${currentUrl}` : ''}`);
+    if (otherUrls && otherUrls.length > 0) {
+        console.error(`\n💡 You have sessions for other environments:`);
+        for (const url of otherUrls) {
+            console.error(`   • ${url}`);
+        }
+        console.error(`\n   To use a different environment, set CHATROOM_CONVEX_URL:`);
+        console.error(`   CHATROOM_CONVEX_URL=${otherUrls[0]} chatroom <command>`);
+        console.error(`\n   Or to authenticate for the current environment:`);
+    }
+    console.error(`   chatroom auth login`);
+}
+/**
+ * Format a chatroom ID validation error
+ */
+export function formatChatroomIdError(chatroomId) {
+    formatValidationError('chatroom ID format', `ID must be 20-40 characters (got ${chatroomId?.length || 0})`, '20-40 character string');
+}
+/**
+ * Check if an error is a network/connectivity error (backend unreachable)
+ * as opposed to an application-level error (auth invalid, etc.)
+ */
+export function isNetworkError(error) {
+    const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    const code = typeof error === 'object' && error !== null && 'code' in error
+        ? error.code
+        : undefined;
+    return (msg.includes('fetch failed') ||
+        msg.includes('failed to fetch') ||
+        msg.includes('econnrefused') ||
+        msg.includes('enotfound') ||
+        msg.includes('etimedout') ||
+        msg.includes('network') ||
+        msg.includes('connection refused') ||
+        msg.includes('socket hang up') ||
+        msg.includes('dns') ||
+        code === 'ECONNREFUSED' ||
+        code === 'ENOTFOUND' ||
+        code === 'ETIMEDOUT' ||
+        code === 'ECONNRESET');
+}
+/**
+ * Format a connectivity error message for when the backend is unreachable
+ */
+export function formatConnectivityError(error, backendUrl) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    const safeBackendUrl = backendUrl ? sanitizeForTerminal(backendUrl) : undefined;
+    console.error(`\n❌ Could not reach the backend${safeBackendUrl ? ` at ${safeBackendUrl}` : ''}`);
+    console.error(`   ${sanitizeForTerminal(err.message)}`);
+    console.error(`\n   Your session may still be valid. Please check:`);
+    console.error(`   • Network connectivity`);
+    console.error(`   • Whether the backend service is running`);
+    if (safeBackendUrl) {
+        console.error(`   • CHATROOM_CONVEX_URL is correct (currently: ${safeBackendUrl})`);
+    }
+    console.error(`\n   Try again once the backend is reachable.`);
+}
+//# sourceMappingURL=error-formatting.js.map

package/dist/utils/error-formatting.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Utility for reading content from files for CLI commands.
+ *
+ * All content-heavy CLI options (--message-file, --description-file, etc.)
+ * use file-based input to avoid complex escape sequences in bash commands.
+ * This makes the CLI more accessible to AI models that struggle with escaping.
+ */
+/**
+ * Read content from a file.
+ *
+ * @param filePath - Path to file containing content (relative or absolute)
+ * @param optionName - Name of the option (for error messages, e.g., 'message-file')
+ * @returns The file content as a string
+ * @throws Error if file cannot be read
+ *
+ * @example
+ * const msg = readFileContent('/tmp/message.md', 'message-file');
+ *
+ * @example
+ * // Relative paths are resolved from CWD
+ * const msg = readFileContent('./handoff.md', 'message-file');
+ */
+export declare function readFileContent(filePath: string, optionName: string): string;
+//# sourceMappingURL=file-content.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-content.d.ts","sourceRoot":"","sources":["../../src/utils/file-content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU5E"}

package/dist/utils/file-content.js

@@ -0,0 +1,35 @@
+/**
+ * Utility for reading content from files for CLI commands.
+ *
+ * All content-heavy CLI options (--message-file, --description-file, etc.)
+ * use file-based input to avoid complex escape sequences in bash commands.
+ * This makes the CLI more accessible to AI models that struggle with escaping.
+ */
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Read content from a file.
+ *
+ * @param filePath - Path to file containing content (relative or absolute)
+ * @param optionName - Name of the option (for error messages, e.g., 'message-file')
+ * @returns The file content as a string
+ * @throws Error if file cannot be read
+ *
+ * @example
+ * const msg = readFileContent('/tmp/message.md', 'message-file');
+ *
+ * @example
+ * // Relative paths are resolved from CWD
+ * const msg = readFileContent('./handoff.md', 'message-file');
+ */
+export function readFileContent(filePath, optionName) {
+    const absolutePath = resolve(process.cwd(), filePath);
+    try {
+        return readFileSync(absolutePath, 'utf-8');
+    }
+    catch (err) {
+        const nodeErr = err;
+        throw new Error(`Cannot read file for --${optionName}: ${absolutePath}\n` + `Reason: ${nodeErr.message}`);
+    }
+}
+//# sourceMappingURL=file-content.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-content.js","sourceRoot":"","sources":["../../src/utils/file-content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,UAAkB;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAA4B,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,KAAK,YAAY,IAAI,GAAG,WAAW,OAAO,CAAC,OAAO,EAAE,CACzF,CAAC;IACJ,CAAC;AACH,CAAC"}