@compass-ai/nova 1.0.73 → 1.0.74

package/dist/utils/path.js

@@ -0,0 +1,549 @@
+/**
+ * Path utilities for Compass directory management and path sanitization.
+ *
+ * This module provides utilities for:
+ * - Resolving global (~/.compass/) and project-level (./.compass/) directories
+ * - Sanitizing paths to prevent directory traversal attacks
+ * - Cross-platform path handling and normalization
+ * - Pattern matching for file filtering
+ */
+import path from 'path';
+import os from 'os';
+import { GLOBAL_COMPASS_DIR, PROJECT_COMPASS_DIR, } from '../constants/defaults.js';
+/**
+ * Gets the global Compass directory path (~/.compass/).
+ * This directory stores user-wide configuration, credentials, and usage data.
+ *
+ * @returns Absolute path to the global Compass directory
+ *
+ * @example
+ * ```typescript
+ * const globalDir = getGlobalCompassDir();
+ * // Returns: '/home/user/.compass' (Linux/macOS)
+ * // Returns: 'C:\\Users\\user\\.compass' (Windows)
+ * ```
+ */
+export function getGlobalCompassDir() {
+    return path.join(os.homedir(), GLOBAL_COMPASS_DIR);
+}
+/**
+ * Gets the project-level Compass directory path (./.compass/).
+ * This directory stores project-specific session data, backups, and indexes.
+ *
+ * @param projectRoot - Optional project root path. Defaults to current working directory.
+ * @returns Absolute path to the project Compass directory
+ *
+ * @example
+ * ```typescript
+ * const projectDir = getProjectCompassDir();
+ * // Returns: '/path/to/project/.compass'
+ *
+ * const customDir = getProjectCompassDir('/custom/path');
+ * // Returns: '/custom/path/.compass'
+ * ```
+ */
+export function getProjectCompassDir(projectRoot) {
+    const root = projectRoot || process.cwd();
+    return path.join(root, PROJECT_COMPASS_DIR);
+}
+/**
+ * Resolves a path relative to the global Compass directory.
+ *
+ * @param segments - Path segments to join with the global directory
+ * @returns Absolute path within the global Compass directory
+ *
+ * @example
+ * ```typescript
+ * const configPath = resolveGlobalPath('config.json');
+ * // Returns: '/home/user/.compass/config.json'
+ *
+ * const logsPath = resolveGlobalPath('logs', '2024-01.log');
+ * // Returns: '/home/user/.compass/logs/2024-01.log'
+ * ```
+ */
+export function resolveGlobalPath(...segments) {
+    return path.join(getGlobalCompassDir(), ...segments);
+}
+/**
+ * Resolves a path relative to the project Compass directory.
+ *
+ * @param projectRoot - The project root directory
+ * @param segments - Path segments to join with the project directory
+ * @returns Absolute path within the project Compass directory
+ *
+ * @example
+ * ```typescript
+ * const sessionPath = resolveProjectPath('/my/project', 'session.json');
+ * // Returns: '/my/project/.compass/session.json'
+ *
+ * const backupPath = resolveProjectPath('/my/project', 'backups', 'file.bak');
+ * // Returns: '/my/project/.compass/backups/file.bak'
+ * ```
+ */
+export function resolveProjectPath(projectRoot, ...segments) {
+    return path.join(getProjectCompassDir(projectRoot), ...segments);
+}
+/**
+ * Sanitizes a path to prevent directory traversal attacks.
+ * Returns null if the path would escape the base directory.
+ *
+ * @param inputPath - The user-provided path to sanitize
+ * @param basePath - The base directory that the path must stay within
+ * @returns Sanitized absolute path, or null if path is invalid/unsafe
+ *
+ * @example
+ * ```typescript
+ * // Valid paths
+ * sanitizePath('src/index.ts', '/project');
+ * // Returns: '/project/src/index.ts'
+ *
+ * sanitizePath('./utils/helper.ts', '/project');
+ * // Returns: '/project/utils/helper.ts'
+ *
+ * // Invalid paths (directory traversal attempts)
+ * sanitizePath('../../../etc/passwd', '/project');
+ * // Returns: null
+ *
+ * sanitizePath('/etc/passwd', '/project');
+ * // Returns: null (absolute path outside base)
+ * ```
+ */
+export function sanitizePath(inputPath, basePath) {
+    // Normalize the base path
+    const normalizedBase = path.resolve(basePath);
+    // Resolve the input path relative to the base
+    const normalizedInput = path.resolve(normalizedBase, inputPath);
+    // Check if the resolved path is within the base path
+    // The path must either equal the base or start with base + separator
+    if (normalizedInput !== normalizedBase &&
+        !normalizedInput.startsWith(normalizedBase + path.sep)) {
+        return null;
+    }
+    return normalizedInput;
+}
+/**
+ * Checks if a target path is within a given base directory.
+ *
+ * @param targetPath - The path to check
+ * @param basePath - The base directory
+ * @returns True if the target path is within the base directory
+ *
+ * @example
+ * ```typescript
+ * isPathWithin('/project/src/index.ts', '/project');
+ * // Returns: true
+ *
+ * isPathWithin('/project', '/project');
+ * // Returns: true
+ *
+ * isPathWithin('/other/path', '/project');
+ * // Returns: false
+ * ```
+ */
+export function isPathWithin(targetPath, basePath) {
+    const normalizedBase = path.resolve(basePath);
+    const normalizedTarget = path.resolve(targetPath);
+    return (normalizedTarget === normalizedBase ||
+        normalizedTarget.startsWith(normalizedBase + path.sep));
+}
+/**
+ * Gets the relative path from a base directory to a target path.
+ *
+ * @param targetPath - The target path
+ * @param basePath - The base directory
+ * @returns Relative path from base to target
+ *
+ * @example
+ * ```typescript
+ * getRelativePath('/project/src/index.ts', '/project');
+ * // Returns: 'src/index.ts'
+ *
+ * getRelativePath('/project', '/project');
+ * // Returns: ''
+ * ```
+ */
+export function getRelativePath(targetPath, basePath) {
+    return path.relative(basePath, targetPath);
+}
+/**
+ * Normalizes path separators for cross-platform compatibility.
+ * Replaces multiple consecutive separators with a single platform-specific separator.
+ *
+ * @param inputPath - The path to normalize
+ * @returns Path with normalized separators
+ *
+ * @example
+ * ```typescript
+ * normalizeSeparators('src//utils\\\\helper.ts');
+ * // Returns: 'src/utils/helper.ts' (on Unix)
+ * // Returns: 'src\\utils\\helper.ts' (on Windows)
+ * ```
+ */
+export function normalizeSeparators(inputPath) {
+    return inputPath.replace(/[/\\]+/g, path.sep);
+}
+/**
+ * Converts a path to use forward slashes (for display, storage, or cross-platform consistency).
+ *
+ * @param inputPath - The path to convert
+ * @returns Path with forward slashes
+ *
+ * @example
+ * ```typescript
+ * toForwardSlashes('src\\utils\\helper.ts');
+ * // Returns: 'src/utils/helper.ts'
+ *
+ * toForwardSlashes('src/utils/helper.ts');
+ * // Returns: 'src/utils/helper.ts'
+ * ```
+ */
+export function toForwardSlashes(inputPath) {
+    return inputPath.replace(/\\/g, '/');
+}
+/**
+ * Converts a path to use the platform-specific separator.
+ *
+ * @param inputPath - The path to convert
+ * @returns Path with platform-specific separators
+ *
+ * @example
+ * ```typescript
+ * toPlatformSeparators('src/utils/helper.ts');
+ * // Returns: 'src/utils/helper.ts' (on Unix)
+ * // Returns: 'src\\utils\\helper.ts' (on Windows)
+ * ```
+ */
+export function toPlatformSeparators(inputPath) {
+    if (path.sep === '/') {
+        return inputPath.replace(/\\/g, '/');
+    }
+    return inputPath.replace(/\//g, '\\');
+}
+/**
+ * Gets the file extension without the leading dot.
+ *
+ * @param filePath - The file path
+ * @returns File extension without dot, or empty string if no extension
+ *
+ * @example
+ * ```typescript
+ * getExtension('src/index.ts');
+ * // Returns: 'ts'
+ *
+ * getExtension('Makefile');
+ * // Returns: ''
+ *
+ * getExtension('.gitignore');
+ * // Returns: 'gitignore'
+ * ```
+ */
+export function getExtension(filePath) {
+    const ext = path.extname(filePath);
+    return ext.startsWith('.') ? ext.slice(1) : ext;
+}
+/**
+ * Gets the filename without its extension.
+ *
+ * @param filePath - The file path
+ * @returns Filename without extension
+ *
+ * @example
+ * ```typescript
+ * getBasename('src/index.ts');
+ * // Returns: 'index'
+ *
+ * getBasename('config.json');
+ * // Returns: 'config'
+ * ```
+ */
+export function getBasename(filePath) {
+    return path.basename(filePath, path.extname(filePath));
+}
+/**
+ * Gets the filename with extension.
+ *
+ * @param filePath - The file path
+ * @returns Filename with extension
+ *
+ * @example
+ * ```typescript
+ * getFilename('src/utils/helper.ts');
+ * // Returns: 'helper.ts'
+ * ```
+ */
+export function getFilename(filePath) {
+    return path.basename(filePath);
+}
+/**
+ * Gets the directory name from a file path.
+ *
+ * @param filePath - The file path
+ * @returns Directory path
+ *
+ * @example
+ * ```typescript
+ * getDirname('src/utils/helper.ts');
+ * // Returns: 'src/utils'
+ * ```
+ */
+export function getDirname(filePath) {
+    return path.dirname(filePath);
+}
+/**
+ * Checks if a path matches any of the given glob patterns.
+ *
+ * @param filePath - The file path to check
+ * @param patterns - Array of glob patterns to match against
+ * @returns True if the path matches any pattern
+ *
+ * @example
+ * ```typescript
+ * matchesPattern('src/index.ts', ['*.ts', '*.js']);
+ * // Returns: true
+ *
+ * matchesPattern('node_modules/pkg/index.js', ['node_modules/**']);
+ * // Returns: true
+ *
+ * matchesPattern('src/index.ts', ['*.json']);
+ * // Returns: false
+ * ```
+ */
+export function matchesPattern(filePath, patterns) {
+    const normalizedPath = toForwardSlashes(filePath);
+    for (const pattern of patterns) {
+        const regex = patternToRegex(pattern);
+        if (regex.test(normalizedPath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Converts a glob pattern to a regular expression.
+ *
+ * Supports:
+ * - `*` - Matches any characters except path separator
+ * - `**` - Matches any characters including path separator (globstar)
+ * - `?` - Matches a single character except path separator
+ *
+ * @param pattern - The glob pattern to convert
+ * @returns Regular expression for matching
+ */
+function patternToRegex(pattern) {
+    // Escape special regex characters except * and ?
+    let escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Replace ** with a placeholder to handle it separately
+    escaped = escaped.replace(/\*\*/g, '{{GLOBSTAR}}');
+    // Replace * with pattern that matches anything except /
+    escaped = escaped.replace(/\*/g, '[^/]*');
+    // Replace ? with pattern that matches single char except /
+    escaped = escaped.replace(/\?/g, '[^/]');
+    // Replace globstar placeholder with pattern that matches anything
+    escaped = escaped.replace(/{{GLOBSTAR}}/g, '.*');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Joins path segments and normalizes the result.
+ *
+ * @param segments - Path segments to join
+ * @returns Joined and normalized path
+ *
+ * @example
+ * ```typescript
+ * joinPath('src', 'utils', 'helper.ts');
+ * // Returns: 'src/utils/helper.ts' (on Unix)
+ * ```
+ */
+export function joinPath(...segments) {
+    return path.join(...segments);
+}
+/**
+ * Resolves a sequence of paths to an absolute path.
+ *
+ * @param segments - Path segments to resolve
+ * @returns Absolute path
+ *
+ * @example
+ * ```typescript
+ * resolvePath('src', 'utils', 'helper.ts');
+ * // Returns: '/current/working/dir/src/utils/helper.ts'
+ * ```
+ */
+export function resolvePath(...segments) {
+    return path.resolve(...segments);
+}
+/**
+ * Checks if a path is absolute.
+ *
+ * @param inputPath - The path to check
+ * @returns True if the path is absolute
+ *
+ * @example
+ * ```typescript
+ * isAbsolutePath('/home/user/project');
+ * // Returns: true
+ *
+ * isAbsolutePath('src/index.ts');
+ * // Returns: false
+ * ```
+ */
+export function isAbsolutePath(inputPath) {
+    return path.isAbsolute(inputPath);
+}
+/**
+ * Ensures a path ends with a trailing separator.
+ *
+ * @param inputPath - The path to process
+ * @returns Path with trailing separator
+ *
+ * @example
+ * ```typescript
+ * ensureTrailingSeparator('/home/user');
+ * // Returns: '/home/user/'
+ *
+ * ensureTrailingSeparator('/home/user/');
+ * // Returns: '/home/user/'
+ * ```
+ */
+export function ensureTrailingSeparator(inputPath) {
+    if (inputPath.endsWith(path.sep) || inputPath.endsWith('/')) {
+        return inputPath;
+    }
+    return inputPath + path.sep;
+}
+/**
+ * Removes trailing separator from a path.
+ *
+ * @param inputPath - The path to process
+ * @returns Path without trailing separator
+ *
+ * @example
+ * ```typescript
+ * removeTrailingSeparator('/home/user/');
+ * // Returns: '/home/user'
+ *
+ * removeTrailingSeparator('/home/user');
+ * // Returns: '/home/user'
+ * ```
+ */
+export function removeTrailingSeparator(inputPath) {
+    // Don't remove separator from root paths
+    if (inputPath === '/' || inputPath === path.sep) {
+        return inputPath;
+    }
+    // Handle Windows drive roots like 'C:\'
+    if (/^[a-zA-Z]:[/\\]$/.test(inputPath)) {
+        return inputPath;
+    }
+    return inputPath.replace(/[/\\]+$/, '');
+}
+/**
+ * Gets the common base path from an array of paths.
+ *
+ * @param paths - Array of paths to find common base for
+ * @returns Common base path, or empty string if no common base
+ *
+ * @example
+ * ```typescript
+ * getCommonBasePath([
+ *   '/project/src/index.ts',
+ *   '/project/src/utils/helper.ts',
+ *   '/project/tests/test.ts'
+ * ]);
+ * // Returns: '/project'
+ * ```
+ */
+export function getCommonBasePath(paths) {
+    if (paths.length === 0) {
+        return '';
+    }
+    if (paths.length === 1) {
+        return getDirname(paths[0]);
+    }
+    // Normalize all paths to use forward slashes for comparison
+    const normalizedPaths = paths.map((p) => toForwardSlashes(path.resolve(p)));
+    // Split into segments
+    const segmentArrays = normalizedPaths.map((p) => p.split('/').filter(Boolean));
+    // Find common prefix
+    const firstSegments = segmentArrays[0];
+    const commonSegments = [];
+    for (let i = 0; i < firstSegments.length; i++) {
+        const segment = firstSegments[i];
+        const allMatch = segmentArrays.every((segments) => segments[i] === segment);
+        if (allMatch) {
+            commonSegments.push(segment);
+        }
+        else {
+            break;
+        }
+    }
+    if (commonSegments.length === 0) {
+        return '';
+    }
+    // Reconstruct path with platform separator
+    const commonPath = commonSegments.join(path.sep);
+    // Add leading separator for absolute paths
+    if (normalizedPaths[0].startsWith('/')) {
+        return path.sep + commonPath;
+    }
+    return commonPath;
+}
+/**
+ * Checks if a filename matches common hidden file patterns.
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is hidden
+ *
+ * @example
+ * ```typescript
+ * isHiddenFile('.gitignore');
+ * // Returns: true
+ *
+ * isHiddenFile('src/index.ts');
+ * // Returns: false
+ * ```
+ */
+export function isHiddenFile(filePath) {
+    const filename = path.basename(filePath);
+    return filename.startsWith('.');
+}
+/**
+ * Parses a path into its components.
+ *
+ * @param filePath - The path to parse
+ * @returns Object containing path components
+ *
+ * @example
+ * ```typescript
+ * parsePath('/home/user/project/src/index.ts');
+ * // Returns: {
+ * //   root: '/',
+ * //   dir: '/home/user/project/src',
+ * //   base: 'index.ts',
+ * //   ext: '.ts',
+ * //   name: 'index'
+ * // }
+ * ```
+ */
+export function parsePath(filePath) {
+    return path.parse(filePath);
+}
+/**
+ * Formats path components into a path string.
+ *
+ * @param pathObject - Object containing path components
+ * @returns Formatted path string
+ *
+ * @example
+ * ```typescript
+ * formatPath({
+ *   dir: '/home/user/project/src',
+ *   base: 'index.ts'
+ * });
+ * // Returns: '/home/user/project/src/index.ts'
+ * ```
+ */
+export function formatPath(pathObject) {
+    return path.format(pathObject);
+}
+//# 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":"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"}

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

@@ -0,0 +1,63 @@
+/**
+ * Schedule.md file management — read, write, parse, and serialize.
+ *
+ * The Schedule.md file lives at `.compass/projects/<current-project>/Schedule.md`
+ * and stores scheduled task definitions in a human-readable markdown format.
+ *
+ * Format:
+ * ```markdown
+ * # Scheduled Tasks
+ * > Managed by Nova. ...
+ *
+ * ### sched-a1b2c3d4 — Weekly Market Research Email
+ * - **Description:** Send a market research summary email every Friday
+ * - **Cron:** `0 9 * * 5` (Fridays at 9:00 AM)
+ * - **Steps:**
+ *   1. Run web research on current market trends
+ *   2. Summarize findings
+ *   3. Send email to user@example.com
+ * - **Created:** 2026-02-20
+ * - **Last Run:** —
+ * - **Status:** active
+ * ```
+ */
+import type { ScheduleFileContent } from '../types/schedule.js';
+/**
+ * Gets the absolute path to the Schedule.md file for the given project root.
+ * Stored globally at `~/.compass/projects/<slug>/Schedule.md`.
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Absolute path to Schedule.md
+ */
+export declare function getScheduleFilePath(projectRoot?: string): string;
+/**
+ * Parses a Schedule.md file content string into structured data.
+ *
+ * @param content - Raw markdown string
+ * @returns Parsed ScheduleFileContent with header and tasks
+ */
+export declare function parseScheduleMd(content: string): ScheduleFileContent;
+/**
+ * Serializes a full ScheduleFileContent back to markdown.
+ *
+ * @param content - Structured schedule data
+ * @returns Markdown string ready to write to Schedule.md
+ */
+export declare function serializeScheduleMd(content: ScheduleFileContent): string;
+/**
+ * Reads and parses the Schedule.md file for the given project.
+ * Returns an empty schedule if the file doesn't exist.
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Parsed ScheduleFileContent
+ */
+export declare function readScheduleFile(projectRoot?: string): Promise<ScheduleFileContent>;
+/**
+ * Writes a ScheduleFileContent to the Schedule.md file.
+ * Creates the file and parent directories if they don't exist.
+ *
+ * @param content - The schedule data to write
+ * @param projectRoot - Project root directory (defaults to cwd)
+ */
+export declare function writeScheduleFile(content: ScheduleFileContent, projectRoot?: string): Promise<void>;
+//# sourceMappingURL=schedule-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-file.d.ts","sourceRoot":"","sources":["../../src/utils/schedule-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAiB,mBAAmB,EAAkB,MAAM,sBAAsB,CAAC;AAsB/F;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhE;AAsED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CA8CpE;AAkCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAiBxE;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CASzF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf"}