maestro-flow 0.1.4 → 0.2.0

package/dist/src/utils/file-reader.js

@@ -0,0 +1,217 @@
+/**
+ * Shared file reading utilities
+ *
+ * Extracted from read-file.ts for reuse across read_file and read_many_files tools.
+ */
+import { readFileSync, readdirSync } from 'fs';
+import { join, extname } from 'path';
+// Max content per file (truncate if larger)
+export const MAX_CONTENT_LENGTH = 5000;
+// Max files to return
+export const MAX_FILES = 50;
+// Max total content length
+export const MAX_TOTAL_CONTENT = 50000;
+// Common binary extensions to skip
+export const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.bmp', '.ico', '.webp', '.svg',
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+    '.zip', '.tar', '.gz', '.rar', '.7z',
+    '.exe', '.dll', '.so', '.dylib',
+    '.mp3', '.mp4', '.wav', '.avi', '.mov',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.pyc', '.class', '.o', '.obj',
+]);
+/**
+ * Check if file is likely binary
+ */
+export function isBinaryFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+/**
+ * Convert glob pattern to regex
+ * Supports: *, ?, and brace expansion {a,b,c}
+ */
+export function globToRegex(pattern) {
+    // Handle brace expansion: *.{md,json,ts} -> (?:.*\.md|.*\.json|.*\.ts)
+    const braceMatch = pattern.match(/^(.*)\{([^}]+)\}(.*)$/);
+    if (braceMatch) {
+        const [, prefix, options, suffix] = braceMatch;
+        const optionList = options.split(',').map(opt => `${prefix}${opt}${suffix}`);
+        // Create a regex that matches any of the expanded patterns
+        const expandedPatterns = optionList.map(opt => {
+            return opt
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*/g, '.*')
+                .replace(/\?/g, '.');
+        });
+        return new RegExp(`^(?:${expandedPatterns.join('|')})$`, 'i');
+    }
+    // Standard glob conversion
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`, 'i');
+}
+/**
+ * Check if filename matches glob pattern
+ */
+export function matchesPattern(filename, pattern) {
+    const regex = globToRegex(pattern);
+    return regex.test(filename);
+}
+/**
+ * Recursively collect files from directory
+ */
+export function collectFiles(dir, pattern, maxDepth, currentDepth = 0) {
+    if (currentDepth > maxDepth)
+        return [];
+    const files = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files/dirs and node_modules
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...collectFiles(fullPath, pattern, maxDepth, currentDepth + 1));
+            }
+            else if (entry.isFile()) {
+                if (!pattern || matchesPattern(entry.name, pattern)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Skip directories we can't read
+    }
+    return files;
+}
+/**
+ * Read file content with truncation and optional line-based pagination
+ */
+export function readFileContent(filePath, options) {
+    const { maxLength, offset, limit } = options;
+    if (isBinaryFile(filePath)) {
+        return { content: '[Binary file]', truncated: false };
+    }
+    try {
+        const content = readFileSync(filePath, 'utf8');
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        // If offset/limit specified, use line-based pagination
+        if (offset !== undefined || limit !== undefined) {
+            const startLine = Math.min(offset ?? 0, totalLines);
+            const endLine = limit !== undefined ? Math.min(startLine + limit, totalLines) : totalLines;
+            const selectedLines = lines.slice(startLine, endLine);
+            const selectedContent = selectedLines.join('\n');
+            const actualEnd = endLine;
+            const hasMore = actualEnd < totalLines;
+            let finalContent = selectedContent;
+            if (selectedContent.length > maxLength) {
+                finalContent = selectedContent.substring(0, maxLength) + `\n... (+${selectedContent.length - maxLength} chars)`;
+            }
+            // Calculate actual line range (handle empty selection)
+            const actualLineEnd = selectedLines.length > 0 ? startLine + selectedLines.length - 1 : startLine;
+            return {
+                content: finalContent,
+                truncated: hasMore || selectedContent.length > maxLength,
+                totalLines,
+                lineRange: { start: startLine, end: actualLineEnd },
+            };
+        }
+        // Default behavior: truncate by character length
+        if (content.length > maxLength) {
+            return {
+                content: content.substring(0, maxLength) + `\n... (+${content.length - maxLength} chars)`,
+                truncated: true,
+                totalLines,
+            };
+        }
+        return { content, truncated: false, totalLines };
+    }
+    catch (error) {
+        return { content: `[Error: ${error.message}]`, truncated: false };
+    }
+}
+/**
+ * Find regex matches in content with safety protections
+ * - Empty string pattern = "match all" (no filtering) - returns null
+ * - Dangerous patterns (zero-width matches) = "match all" for safety - returns null
+ * - Validates pattern to prevent infinite loops
+ * - Limits iterations to prevent ReDoS attacks
+ * - Deduplicates results to prevent duplicates
+ * - Reports errors instead of silent failure
+ *
+ * @returns Array of matching lines, null to match all content (empty string or dangerous pattern), empty array for no matches
+ */
+export function findMatches(content, pattern) {
+    // 1. Empty string pattern = "match all" (no filtering)
+    if (!pattern || pattern.length === 0) {
+        return null;
+    }
+    // 2. Pattern length limit
+    if (pattern.length > 1000) {
+        console.error('[read_file] contentPattern error: Pattern too long (max 1000 characters), returning all content');
+        return null;
+    }
+    // 3. Dangerous pattern detection
+    try {
+        const testRegex = new RegExp(pattern, 'gm');
+        const emptyTest = testRegex.exec('');
+        if (emptyTest && emptyTest[0] === '' && emptyTest.index === 0) {
+            const secondMatch = testRegex.exec('');
+            if (secondMatch && secondMatch.index === 0) {
+                console.warn(`[read_file] contentPattern: Dangerous pattern "${pattern.substring(0, 50)}" detected, returning all content`);
+                return null;
+            }
+        }
+    }
+    catch (e) {
+        console.error(`[read_file] contentPattern: Invalid regex pattern: ${e.message}, returning all content`);
+        return null;
+    }
+    try {
+        const regex = new RegExp(pattern, 'gm');
+        const matches = [];
+        const seen = new Set();
+        let match;
+        let iterations = 0;
+        let lastIndex = -1;
+        const MAX_ITERATIONS = 1000;
+        const MAX_MATCHES = 50;
+        while ((match = regex.exec(content)) !== null && matches.length < MAX_MATCHES) {
+            iterations++;
+            if (iterations > MAX_ITERATIONS) {
+                console.error(`[read_file] contentPattern warning: Exceeded ${MAX_ITERATIONS} iterations for pattern "${pattern.substring(0, 50)}"`);
+                break;
+            }
+            if (match.index === lastIndex) {
+                regex.lastIndex = match.index + 1;
+                continue;
+            }
+            lastIndex = match.index;
+            const lineStart = content.lastIndexOf('\n', match.index) + 1;
+            const lineEnd = content.indexOf('\n', match.index);
+            const line = content.substring(lineStart, lineEnd === -1 ? undefined : lineEnd).trim();
+            if (!line)
+                continue;
+            if (!seen.has(line)) {
+                seen.add(line);
+                matches.push(line.substring(0, 200));
+            }
+            if (matches.length >= 10)
+                break;
+        }
+        return matches;
+    }
+    catch (error) {
+        const errorMsg = error.message;
+        console.error(`[read_file] contentPattern error: ${errorMsg}`);
+        return [];
+    }
+}
+//# sourceMappingURL=file-reader.js.map

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

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

package/dist/src/utils/jsonl-log.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Append-only JSONL file I/O utility.
+ *
+ * Shared by agent-domain (team-msg) and human-collab-domain (team-activity)
+ * tools that need to read/write newline-delimited JSON logs. All functions
+ * are synchronous to match the style of `src/utils/path-validator.ts` and
+ * keep them usable from hot-path hooks.
+ *
+ * Design rules:
+ * - Never throw from append/read helpers; callers are often PostToolUse hooks
+ *   that must not fail the host tool call.
+ * - Malformed lines are silently skipped.
+ * - Rotation uses ISO week numbers (no external dependencies).
+ */
+/**
+ * Append a JSON-serializable object as a single line to `path`.
+ *
+ * - Ensures the parent directory exists (recursive mkdir).
+ * - Writes atomically via a single `appendFileSync` call.
+ * - Silently no-ops on serialization or I/O errors — callers are hot-path
+ *   hooks that should never fail the host tool.
+ */
+export declare function appendLine(path: string, obj: unknown): void;
+/**
+ * Read all records from a JSONL file.
+ *
+ * - Returns `[]` if the file does not exist.
+ * - Parses each line with try/catch; malformed lines are skipped.
+ */
+export declare function readAll<T = unknown>(path: string): T[];
+/**
+ * Return the last `n` successfully parsed records from a JSONL file.
+ *
+ * Efficient tail: reads only the last ~64KB of the file unless the file
+ * is smaller, in which case it falls back to `readAll`. Partial leading
+ * line from the read window is discarded so we never emit a half-parsed
+ * record.
+ */
+export declare function tailLast<T = unknown>(path: string, n: number): T[];
+/**
+ * Rotate `path` to `archiveDir` if its size is >= `maxBytes`.
+ *
+ * - Returns `null` if the file does not exist or is below the threshold.
+ * - Archive name: `{basename-without-ext}-{YYYY}W{WW}{ext}` (ISO week).
+ * - Ensures `archiveDir` exists before moving.
+ * - Returns the absolute archive path on success.
+ */
+export declare function rotateIfLarge(path: string, maxBytes: number, archiveDir: string): string | null;
+/**
+ * Compute ISO 8601 week number for a date.
+ *
+ * Reference algorithm (no external dependency):
+ *   1. Copy date, adjust to nearest Thursday in the same ISO week
+ *      (ISO weeks run Mon-Sun; Thursday anchors the week-year).
+ *   2. Week year = year of that Thursday.
+ *   3. Week number = 1 + floor((thursday - jan4thOfWeekYear) / 7days),
+ *      rounded to the Monday of the week containing Jan 4.
+ */
+export declare function isoWeek(date: Date): {
+    year: number;
+    week: number;
+};
+//# sourceMappingURL=jsonl-log.d.ts.map

package/dist/src/utils/jsonl-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-log.d.ts","sourceRoot":"","sources":["../../../src/utils/jsonl-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAkBH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAa3D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAWtD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CA+ClE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CA4Bf;AAsBD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBlE"}

package/dist/src/utils/jsonl-log.js

@@ -0,0 +1,198 @@
+/**
+ * Append-only JSONL file I/O utility.
+ *
+ * Shared by agent-domain (team-msg) and human-collab-domain (team-activity)
+ * tools that need to read/write newline-delimited JSON logs. All functions
+ * are synchronous to match the style of `src/utils/path-validator.ts` and
+ * keep them usable from hot-path hooks.
+ *
+ * Design rules:
+ * - Never throw from append/read helpers; callers are often PostToolUse hooks
+ *   that must not fail the host tool call.
+ * - Malformed lines are silently skipped.
+ * - Rotation uses ISO week numbers (no external dependencies).
+ */
+import { appendFileSync, existsSync, mkdirSync, openSync, closeSync, readSync, readFileSync, renameSync, statSync, } from 'node:fs';
+import { dirname, basename, extname, join } from 'node:path';
+// Bytes read from the tail of the file when efficient tailing.
+const TAIL_READ_BYTES = 64 * 1024;
+/**
+ * Append a JSON-serializable object as a single line to `path`.
+ *
+ * - Ensures the parent directory exists (recursive mkdir).
+ * - Writes atomically via a single `appendFileSync` call.
+ * - Silently no-ops on serialization or I/O errors — callers are hot-path
+ *   hooks that should never fail the host tool.
+ */
+export function appendLine(path, obj) {
+    try {
+        const line = JSON.stringify(obj);
+        if (line === undefined)
+            return; // unserializable (e.g. bigint, undefined)
+        const dir = dirname(path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        appendFileSync(path, line + '\n', 'utf-8');
+    }
+    catch {
+        // Swallow — hot path.
+    }
+}
+/**
+ * Read all records from a JSONL file.
+ *
+ * - Returns `[]` if the file does not exist.
+ * - Parses each line with try/catch; malformed lines are skipped.
+ */
+export function readAll(path) {
+    if (!existsSync(path))
+        return [];
+    let content;
+    try {
+        content = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    return parseLines(content);
+}
+/**
+ * Return the last `n` successfully parsed records from a JSONL file.
+ *
+ * Efficient tail: reads only the last ~64KB of the file unless the file
+ * is smaller, in which case it falls back to `readAll`. Partial leading
+ * line from the read window is discarded so we never emit a half-parsed
+ * record.
+ */
+export function tailLast(path, n) {
+    if (n <= 0 || !existsSync(path))
+        return [];
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return [];
+    }
+    if (size === 0)
+        return [];
+    // Small file — just read everything.
+    if (size <= TAIL_READ_BYTES) {
+        const all = readAll(path);
+        return all.slice(-n);
+    }
+    // Large file — read only the tail window.
+    const readLen = TAIL_READ_BYTES;
+    const start = size - readLen;
+    const buf = Buffer.alloc(readLen);
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+    }
+    catch {
+        return [];
+    }
+    try {
+        readSync(fd, buf, 0, readLen, start);
+    }
+    catch {
+        closeSync(fd);
+        return [];
+    }
+    closeSync(fd);
+    let content = buf.toString('utf-8');
+    // Drop the first (possibly partial) line so we never parse a truncated record.
+    const firstNewline = content.indexOf('\n');
+    if (firstNewline >= 0) {
+        content = content.slice(firstNewline + 1);
+    }
+    const parsed = parseLines(content);
+    return parsed.slice(-n);
+}
+/**
+ * Rotate `path` to `archiveDir` if its size is >= `maxBytes`.
+ *
+ * - Returns `null` if the file does not exist or is below the threshold.
+ * - Archive name: `{basename-without-ext}-{YYYY}W{WW}{ext}` (ISO week).
+ * - Ensures `archiveDir` exists before moving.
+ * - Returns the absolute archive path on success.
+ */
+export function rotateIfLarge(path, maxBytes, archiveDir) {
+    if (!existsSync(path))
+        return null;
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return null;
+    }
+    if (size < maxBytes)
+        return null;
+    const ext = extname(path);
+    const base = basename(path, ext);
+    const { year, week } = isoWeek(new Date());
+    const archiveName = `${base}-${year}W${String(week).padStart(2, '0')}${ext}`;
+    const archivePath = join(archiveDir, archiveName);
+    try {
+        if (!existsSync(archiveDir)) {
+            mkdirSync(archiveDir, { recursive: true });
+        }
+        renameSync(path, archivePath);
+    }
+    catch {
+        return null;
+    }
+    return archivePath;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function parseLines(content) {
+    if (!content)
+        return [];
+    const out = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed line.
+        }
+    }
+    return out;
+}
+/**
+ * Compute ISO 8601 week number for a date.
+ *
+ * Reference algorithm (no external dependency):
+ *   1. Copy date, adjust to nearest Thursday in the same ISO week
+ *      (ISO weeks run Mon-Sun; Thursday anchors the week-year).
+ *   2. Week year = year of that Thursday.
+ *   3. Week number = 1 + floor((thursday - jan4thOfWeekYear) / 7days),
+ *      rounded to the Monday of the week containing Jan 4.
+ */
+export function isoWeek(date) {
+    // Work in UTC to avoid DST / timezone drift.
+    const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+    // ISO: Monday=1..Sunday=7. JS getUTCDay: Sunday=0..Saturday=6.
+    const dayNum = d.getUTCDay() || 7;
+    // Shift to the Thursday of the current ISO week.
+    d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+    const year = d.getUTCFullYear();
+    // Jan 4 is always in ISO week 1.
+    const yearStart = new Date(Date.UTC(year, 0, 4));
+    const yearStartDayNum = yearStart.getUTCDay() || 7;
+    // Monday of ISO week 1.
+    const week1Monday = new Date(yearStart);
+    week1Monday.setUTCDate(yearStart.getUTCDate() + 1 - yearStartDayNum);
+    const diffDays = Math.round((d.getTime() - week1Monday.getTime()) / (24 * 60 * 60 * 1000));
+    const week = Math.floor(diffDays / 7) + 1;
+    return { year, week };
+}
+//# sourceMappingURL=jsonl-log.js.map

package/dist/src/utils/jsonl-log.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Centralized Path Validation Utility
+ *
+ * Provides secure path validation and resolution for MCP tools.
+ * Prevents path traversal attacks and ensures operations stay within allowed directories.
+ */
+/**
+ * Check if sandbox mode is enabled
+ * When enabled, path validation restricts access to allowed directories only
+ */
+export declare function isSandboxEnabled(): boolean;
+/**
+ * Get project root directory
+ * Priority: MAESTRO_PROJECT_ROOT > process.cwd()
+ */
+export declare function getProjectRoot(): string;
+/**
+ * Get allowed directories list
+ * Priority: MAESTRO_ALLOWED_DIRS > [getProjectRoot()]
+ */
+export declare function getAllowedDirectories(): string[];
+/**
+ * Normalize path (unify separators to forward slash)
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Check if path is within allowed directories
+ */
+export declare function isPathWithinAllowedDirectories(targetPath: string, allowedDirectories: string[]): boolean;
+/**
+ * Validate and resolve path (core function)
+ *
+ * Security model:
+ * 1. Resolve to absolute path
+ * 2. Check against allowed directories
+ * 3. Resolve symlinks and re-verify
+ *
+ * @param filePath - Path to validate
+ * @param options - Validation options
+ * @returns Validated absolute path
+ * @throws Error if path is outside allowed directories or validation fails
+ */
+export declare function validatePath(filePath: string, options?: {
+    allowedDirectories?: string[];
+    mustExist?: boolean;
+}): Promise<string>;
+/**
+ * Resolve project-relative path (simplified, no strict validation)
+ * Use for cases where strict security validation is not needed
+ */
+export declare function resolveProjectPath(...pathSegments: string[]): string;
+//# sourceMappingURL=path-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/path-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAMhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAuBD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,OAAO,CAST;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpE"}