@nexus-cortex/core 4.26.0

package/dist/utils/ContextResolver.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Context Resolver
+ *
+ * Determines storage and configuration paths based on launch directory.
+ * Implements context-aware runtime behavior:
+ * - Workspace-level: Launched from workspace root
+ * - Project-level: Launched from project subdirectory
+ *
+ * Similar to git's behavior with .git/ directories.
+ */
+/**
+ * Storage configuration for a given context
+ */
+export interface StorageConfig {
+    /** Session storage directory */
+    sessionsDir: string;
+    /** System messages directory */
+    systemMessagesDir: string;
+    /** Context level: workspace, project, or global */
+    contextLevel: 'workspace' | 'project' | 'global';
+    /** Root directory for this context */
+    contextRoot: string;
+}
+/**
+ * Context resolution options
+ */
+export interface ContextResolverOptions {
+    /** Current working directory (default: process.cwd()) */
+    cwd?: string;
+    /** Force workspace root detection (for testing) */
+    forceWorkspaceRoot?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Context Resolver
+ *
+ * Determines whether to use workspace-level or project-level storage
+ * based on launch directory.
+ */
+export declare class ContextResolver {
+    private options;
+    constructor(options?: ContextResolverOptions);
+    /**
+     * Resolve storage configuration for current context
+     *
+     * Algorithm:
+     * 1. Check if launched from workspace root → workspace-level
+     * 2. Check if launched from project subdirectory → project-level
+     * 3. Fallback to global user directory
+     *
+     * @returns Storage configuration for current context
+     */
+    resolve(): StorageConfig;
+    /**
+     * Find workspace root by walking up directory tree
+     *
+     * Looks for workspace markers (.git, package.json, etc.)
+     * Stops at filesystem root or home directory.
+     *
+     * For monorepos, prefers package.json with "workspaces" field over regular package.json
+     *
+     * @param startDir - Directory to start search from
+     * @returns Workspace root path or null if not found
+     */
+    private findWorkspaceRoot;
+    /**
+     * Create workspace-level storage config
+     *
+     * Used when launched from workspace root (monorepo root).
+     * ALL data goes to workspace-local .cortex/ directory.
+     *
+     * Example: cd nexus-cortex/ && cortex
+     * → Uses nexus-cortex/.cortex/ (workspace-local storage)
+     *
+     * @param workspaceRoot - Workspace root directory
+     * @returns Workspace-level storage config (uses workspace-local .cortex/)
+     */
+    private createWorkspaceConfig;
+    /**
+     * Create project-level storage config
+     *
+     * Used when launched from project subdirectory.
+     * ALL data is project-isolated in local .cortex/ directory.
+     * This allows project-specific sessions, artifacts, and context.
+     *
+     * Example: cd dateroi/ && cortex
+     * → Creates dateroi/.cortex/ with project-specific data
+     *
+     * @param projectDir - Project directory
+     * @returns Project-level storage config
+     */
+    private createProjectConfig;
+    /**
+     * Create global user-level storage config
+     *
+     * Used when no workspace is detected (rare case).
+     * Stores in user home directory.
+     *
+     * @returns Global storage config
+     */
+    private createGlobalConfig;
+    /**
+     * Check if current directory is a project (not workspace root)
+     *
+     * @returns True if in project subdirectory
+     */
+    isProjectContext(): boolean;
+    /**
+     * Check if current directory is workspace root
+     *
+     * @returns True if at workspace root
+     */
+    isWorkspaceContext(): boolean;
+    /**
+     * Get relative path from context root
+     *
+     * Useful for display purposes.
+     *
+     * @param contextRoot - Context root directory
+     * @returns Relative path from cwd to context root
+     */
+    getRelativeContext(contextRoot: string): string;
+}
+/**
+ * Helper function to resolve context from current directory
+ *
+ * @param options - Resolution options
+ * @returns Storage configuration
+ */
+export declare function resolveContext(options?: ContextResolverOptions): StorageConfig;
+//# sourceMappingURL=ContextResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextResolver.d.ts","sourceRoot":"","sources":["../../src/utils/ContextResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IAEpB,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,mDAAmD;IACnD,YAAY,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEjD,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgBD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAmC;gBAEtC,OAAO,GAAE,sBAA2B;IAQhD;;;;;;;;;OASG;IACH,OAAO,IAAI,aAAa;IAmCxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IA6EzB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;;OAIG;IACH,gBAAgB,IAAI,OAAO;IAK3B;;;;OAIG;IACH,kBAAkB,IAAI,OAAO;IAK7B;;;;;;;OAOG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAOhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAG9E"}

package/dist/utils/ContextResolver.js

@@ -0,0 +1,269 @@
+/**
+ * Context Resolver
+ *
+ * Determines storage and configuration paths based on launch directory.
+ * Implements context-aware runtime behavior:
+ * - Workspace-level: Launched from workspace root
+ * - Project-level: Launched from project subdirectory
+ *
+ * Similar to git's behavior with .git/ directories.
+ */
+import { join, dirname, resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+/**
+ * Workspace detection markers
+ * If any of these exist, we consider it a workspace root
+ */
+const WORKSPACE_MARKERS = [
+    '.git', // Git repository root
+    'package.json', // Node.js project root
+    'Cargo.toml', // Rust workspace
+    'go.mod', // Go module
+    'pyproject.toml', // Python project
+    'pom.xml', // Maven project
+    '.workspace', // Explicit workspace marker
+];
+/**
+ * Context Resolver
+ *
+ * Determines whether to use workspace-level or project-level storage
+ * based on launch directory.
+ */
+export class ContextResolver {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            cwd: options.cwd || process.cwd(),
+            forceWorkspaceRoot: options.forceWorkspaceRoot || '',
+            debug: options.debug || false
+        };
+    }
+    /**
+     * Resolve storage configuration for current context
+     *
+     * Algorithm:
+     * 1. Check if launched from workspace root → workspace-level
+     * 2. Check if launched from project subdirectory → project-level
+     * 3. Fallback to global user directory
+     *
+     * @returns Storage configuration for current context
+     */
+    resolve() {
+        const cwd = resolve(this.options.cwd);
+        if (this.options.debug) {
+            console.log('[ContextResolver] Resolving context from:', cwd);
+        }
+        // Find workspace root
+        const workspaceRoot = this.options.forceWorkspaceRoot || this.findWorkspaceRoot(cwd);
+        if (!workspaceRoot) {
+            // No workspace detected, use global user directory
+            if (this.options.debug) {
+                console.log('[ContextResolver] No workspace found, using global');
+            }
+            return this.createGlobalConfig();
+        }
+        // Check if we're at workspace root or in a subdirectory
+        if (cwd === workspaceRoot) {
+            // Launched from workspace root → workspace-level storage
+            if (this.options.debug) {
+                console.log('[ContextResolver] At workspace root, using workspace-level');
+            }
+            return this.createWorkspaceConfig(workspaceRoot);
+        }
+        else {
+            // Launched from project subdirectory → project-level storage
+            // Use the current directory (project subdirectory) as the context root
+            if (this.options.debug) {
+                console.log('[ContextResolver] In project subdirectory, using project-level storage');
+            }
+            return this.createProjectConfig(cwd);
+        }
+    }
+    /**
+     * Find workspace root by walking up directory tree
+     *
+     * Looks for workspace markers (.git, package.json, etc.)
+     * Stops at filesystem root or home directory.
+     *
+     * For monorepos, prefers package.json with "workspaces" field over regular package.json
+     *
+     * @param startDir - Directory to start search from
+     * @returns Workspace root path or null if not found
+     */
+    findWorkspaceRoot(startDir) {
+        let currentDir = resolve(startDir);
+        const homeDir = homedir();
+        let fallbackRoot = null;
+        // Walk up directory tree until we reach filesystem root or home
+        while (true) {
+            const parentDir = dirname(currentDir);
+            // Stop if we've reached the filesystem root or home directory
+            if (currentDir === parentDir || currentDir === homeDir) {
+                break;
+            }
+            // Check for workspace markers
+            for (const marker of WORKSPACE_MARKERS) {
+                const markerPath = join(currentDir, marker);
+                if (existsSync(markerPath)) {
+                    // Special handling for package.json - check if it's a monorepo root
+                    if (marker === 'package.json') {
+                        try {
+                            const packageJsonContent = readFileSync(markerPath, 'utf-8');
+                            const packageJson = JSON.parse(packageJsonContent);
+                            if (packageJson.workspaces) {
+                                // Found monorepo root - this takes priority
+                                if (this.options.debug) {
+                                    console.log(`[ContextResolver] Found monorepo root with workspaces at ${currentDir}`);
+                                }
+                                return currentDir;
+                            }
+                            else {
+                                // Regular package.json - save as fallback but keep searching UP
+                                if (!fallbackRoot) {
+                                    fallbackRoot = currentDir;
+                                    if (this.options.debug) {
+                                        console.log(`[ContextResolver] Found package.json at ${currentDir} (searching for monorepo root)`);
+                                    }
+                                }
+                                // Don't return, continue searching in parent directories
+                            }
+                        }
+                        catch (error) {
+                            // Invalid package.json, treat as regular marker
+                            if (this.options.debug) {
+                                console.log(`[ContextResolver] Found workspace marker: ${marker} at ${currentDir}`);
+                            }
+                            return currentDir;
+                        }
+                    }
+                    else {
+                        // Non-package.json marker (.git, etc.) - use immediately if no better match
+                        if (this.options.debug) {
+                            console.log(`[ContextResolver] Found workspace marker: ${marker} at ${currentDir}`);
+                        }
+                        // For .git marker, if we already have a fallback package.json, use that instead
+                        // (prefer package.json directory over .git directory)
+                        if (fallbackRoot) {
+                            return fallbackRoot;
+                        }
+                        return currentDir;
+                    }
+                }
+            }
+            // Move up one level
+            currentDir = dirname(currentDir);
+        }
+        // Return fallback if we found a package.json but no monorepo root
+        if (fallbackRoot) {
+            if (this.options.debug) {
+                console.log(`[ContextResolver] Using fallback workspace root: ${fallbackRoot}`);
+            }
+            return fallbackRoot;
+        }
+        // No workspace found
+        return null;
+    }
+    /**
+     * Create workspace-level storage config
+     *
+     * Used when launched from workspace root (monorepo root).
+     * ALL data goes to workspace-local .cortex/ directory.
+     *
+     * Example: cd nexus-cortex/ && cortex
+     * → Uses nexus-cortex/.cortex/ (workspace-local storage)
+     *
+     * @param workspaceRoot - Workspace root directory
+     * @returns Workspace-level storage config (uses workspace-local .cortex/)
+     */
+    createWorkspaceConfig(workspaceRoot) {
+        return {
+            sessionsDir: join(workspaceRoot, '.cortex', 'sessions'),
+            systemMessagesDir: join(workspaceRoot, '.cortex', 'system-messages'),
+            contextLevel: 'workspace',
+            contextRoot: workspaceRoot
+        };
+    }
+    /**
+     * Create project-level storage config
+     *
+     * Used when launched from project subdirectory.
+     * ALL data is project-isolated in local .cortex/ directory.
+     * This allows project-specific sessions, artifacts, and context.
+     *
+     * Example: cd dateroi/ && cortex
+     * → Creates dateroi/.cortex/ with project-specific data
+     *
+     * @param projectDir - Project directory
+     * @returns Project-level storage config
+     */
+    createProjectConfig(projectDir) {
+        return {
+            sessionsDir: join(projectDir, '.cortex', 'sessions'),
+            systemMessagesDir: join(projectDir, '.cortex', 'system-messages'),
+            contextLevel: 'project',
+            contextRoot: projectDir
+        };
+    }
+    /**
+     * Create global user-level storage config
+     *
+     * Used when no workspace is detected (rare case).
+     * Stores in user home directory.
+     *
+     * @returns Global storage config
+     */
+    createGlobalConfig() {
+        const homeDir = homedir();
+        return {
+            sessionsDir: join(homeDir, '.cortex', 'sessions'),
+            systemMessagesDir: join(homeDir, '.cortex', 'system-messages'),
+            contextLevel: 'global',
+            contextRoot: homeDir
+        };
+    }
+    /**
+     * Check if current directory is a project (not workspace root)
+     *
+     * @returns True if in project subdirectory
+     */
+    isProjectContext() {
+        const config = this.resolve();
+        return config.contextLevel === 'project';
+    }
+    /**
+     * Check if current directory is workspace root
+     *
+     * @returns True if at workspace root
+     */
+    isWorkspaceContext() {
+        const config = this.resolve();
+        return config.contextLevel === 'workspace';
+    }
+    /**
+     * Get relative path from context root
+     *
+     * Useful for display purposes.
+     *
+     * @param contextRoot - Context root directory
+     * @returns Relative path from cwd to context root
+     */
+    getRelativeContext(contextRoot) {
+        const cwd = resolve(this.options.cwd);
+        if (cwd === contextRoot) {
+            return '.';
+        }
+        return cwd.replace(contextRoot + '/', '');
+    }
+}
+/**
+ * Helper function to resolve context from current directory
+ *
+ * @param options - Resolution options
+ * @returns Storage configuration
+ */
+export function resolveContext(options) {
+    const resolver = new ContextResolver(options);
+    return resolver.resolve();
+}
+//# sourceMappingURL=ContextResolver.js.map

package/dist/utils/ContextResolver.js.map

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

package/dist/utils/DiffParser.d.ts

@@ -0,0 +1,101 @@
+/**
+ * DiffParser - Shared utility for parsing unified diff strings
+ *
+ * This module provides a consistent way to parse unified diff output
+ * (from tools like `diff -u` or the `diff` npm package) into structured
+ * data that can be rendered by any UI.
+ *
+ * Used by:
+ * - Chalk CLI (ToolFormatter.ts)
+ * - Ink UI (DiffPreview.tsx)
+ * - Edit tool result display in both UIs
+ *
+ * @module DiffParser
+ */
+/**
+ * Represents a single line in a diff
+ */
+export interface DiffLine {
+    /** Line number in the old file (for removed/context lines) */
+    oldLineNumber?: number;
+    /** Line number in the new file (for added/context lines) */
+    newLineNumber?: number;
+    /** Legacy line number field for backwards compatibility */
+    lineNumber?: number;
+    /** Type of change */
+    type: 'added' | 'removed' | 'context';
+    /** The actual line content (without the +/- prefix) */
+    content: string;
+}
+/**
+ * Represents a chunk/hunk in a diff (a contiguous section of changes)
+ */
+export interface DiffChunk {
+    /** Context lines before the changes */
+    contextBefore: DiffLine[];
+    /** The actual changed lines (additions and removals) */
+    changes: DiffLine[];
+    /** Context lines after the changes */
+    contextAfter: DiffLine[];
+}
+/**
+ * Represents a complete parsed diff
+ */
+export interface ParsedDiff {
+    /** Path to the file that was diffed */
+    file: string;
+    /** Number of lines added */
+    additions: number;
+    /** Number of lines removed */
+    removals: number;
+    /** The diff chunks */
+    chunks: DiffChunk[];
+}
+/**
+ * Parse a unified diff string into structured data
+ *
+ * Handles standard unified diff format:
+ * ```
+ * --- a/file.txt
+ * +++ b/file.txt
+ * @@ -1,3 +1,4 @@
+ *  context line
+ * -removed line
+ * +added line
+ *  context line
+ * ```
+ *
+ * @param diffString - The unified diff string to parse
+ * @param filePath - The file path (used if not found in diff header)
+ * @returns Parsed diff structure, or null if parsing fails
+ */
+export declare function parseUnifiedDiff(diffString: string, filePath?: string): ParsedDiff | null;
+/**
+ * Generate a unified diff from old and new strings
+ *
+ * This is a convenience wrapper that can be used when you have
+ * the before/after content rather than a diff string.
+ *
+ * Note: Requires the 'diff' package to be available.
+ *
+ * @param oldString - The original content
+ * @param newString - The modified content
+ * @param filePath - The file path for the diff header
+ * @returns Parsed diff structure, or null if no changes
+ */
+export declare function generateAndParseDiff(oldString: string, newString: string, filePath: string): ParsedDiff | null;
+/**
+ * Get a summary of a parsed diff
+ *
+ * @param diff - The parsed diff
+ * @returns Human-readable summary string
+ */
+export declare function getDiffSummary(diff: ParsedDiff): string;
+/**
+ * Check if a diff represents actual changes
+ *
+ * @param diff - The parsed diff (or null)
+ * @returns true if there are actual changes
+ */
+export declare function hasChanges(diff: ParsedDiff | null): boolean;
+//# sourceMappingURL=DiffParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DiffParser.d.ts","sourceRoot":"","sources":["../../src/utils/DiffParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,wDAAwD;IACxD,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAe,GAAG,UAAU,GAAG,IAAI,CAwHjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,IAAI,CASnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAG3D"}