@nexus-cortex/core 4.26.0

package/dist/tools/context-management/InitCortexContext.d.ts

@@ -0,0 +1,184 @@
+/**
+ * InitCortexContext Tool
+ *
+ * Generates CORTEX.md file with project context that gets injected as a system message.
+ * Similar to CLAUDE.md but auto-generated with:
+ * - File tree structure
+ * - Dependencies (package.json, requirements.txt, etc.)
+ * - Scripts and build commands
+ * - Project overview
+ *
+ * Usage:
+ * - init_cortex_context() - Generate in current directory (.cortex/CORTEX.md)
+ * - init_cortex_context({ scope: 'global' }) - Generate in ~/.cortex/CORTEX.md
+ */
+import type { CanonicalTool } from '../types/CanonicalTool.js';
+export interface InitCortexContextInput {
+    /**
+     * Target location for CORTEX.md
+     * - 'auto' (default): Use current directory (.cortex/CORTEX.md)
+     * - 'global': Use ~/.cortex/CORTEX.md
+     */
+    scope?: 'auto' | 'global';
+    /**
+     * Maximum depth for file tree
+     * Default: Auto-detect (5 for monorepos, 4 for regular projects)
+     */
+    max_depth?: number;
+    /**
+     * Include file sizes in tree (default: false)
+     */
+    include_sizes?: boolean;
+    /**
+     * Dry run - show what would be generated without writing file
+     */
+    dry_run?: boolean;
+}
+interface PackageInfo {
+    name: string;
+    path: string;
+    description?: string;
+    type?: string;
+}
+interface DependencyInfo {
+    type: string;
+    file: string;
+    count: number;
+    main?: string[];
+}
+interface ScriptInfo {
+    source: string;
+    name: string;
+    command: string;
+}
+export interface InitCortexContextOutput {
+    status: 'success' | 'error';
+    message: string;
+    cortexPath?: string;
+    memoryPath?: string;
+    dryRun: boolean;
+    tree?: string;
+    dependencyCount?: number;
+    scriptCount?: number;
+}
+export interface ProjectScanResult {
+    tree: string;
+    dependencies: DependencyInfo[];
+    scripts: ScriptInfo[];
+    overview: string;
+    isMonorepo: boolean;
+    packages?: PackageInfo[];
+    architecturePatterns?: string[];
+    existingCortexMd?: string;
+    existingClaudeMd?: string;
+    existingGeminiMd?: string;
+    targetPath: string;
+    scope: string;
+}
+/**
+ * InitCortexContext Tool Implementation
+ */
+export declare class InitCortexContext {
+    /**
+     * Scan a project and return structured data for the model to write CORTEX.md.
+     * This is the raw data gathering step — the model does the synthesis.
+     */
+    static scan(workingDir: string, options?: {
+        scope?: 'auto' | 'global';
+        max_depth?: number;
+    }): Promise<ProjectScanResult>;
+    /**
+     * Format scan results as a prompt for the model to write CORTEX.md.
+     */
+    static formatScanAsPrompt(scan: ProjectScanResult): string;
+    /**
+     * Execute the init_cortex_context tool.
+     *
+     * When called by the model as a tool, returns scan data + writing instructions
+     * so the model writes CORTEX.md itself (via an /init flow).
+     * Also auto-creates MEMORY.md if none exists.
+     */
+    static execute(input: InitCortexContextInput, workingDir: string): Promise<InitCortexContextOutput>;
+    /**
+     * Analyze project directory and gather context
+     */
+    private static analyzeProject;
+    /**
+     * Check if entry should be included based on patterns
+     */
+    private static shouldIncludeEntry;
+    /**
+     * Generate file tree with selective expansion
+     */
+    private static generateFileTree;
+    /**
+     * Selective directory walker - expands important paths, collapses others
+     */
+    private static walkDirectorySelective;
+    /**
+     * Expand directory showing key contents
+     */
+    private static expandDirectory;
+    /**
+     * Check if directory should be expanded
+     */
+    private static shouldExpand;
+    /**
+     * Check if file is important enough to show
+     */
+    private static isImportantFile;
+    /**
+     * Get enhanced description for directories
+     */
+    private static getEnhancedDescription;
+    /**
+     * Get description for files
+     */
+    private static getFileDescription;
+    /**
+     * Format file size
+     */
+    private static formatSize;
+    /**
+     * Analyze dependencies from various manifest files
+     */
+    private static analyzeDependencies;
+    /**
+     * Analyze scripts from package.json, Makefile, etc.
+     */
+    private static analyzeScripts;
+    /**
+     * Detect if project is a monorepo
+     */
+    private static detectMonorepo;
+    /**
+     * Read project description from README.md
+     */
+    private static readProjectDescription;
+    /**
+     * Analyze packages in a monorepo
+     */
+    private static analyzePackages;
+    /**
+     * Infer package type from name and package.json
+     */
+    private static inferPackageType;
+    /**
+     * Generate project overview
+     */
+    private static generateOverview;
+    /**
+     * Identify key directories worth highlighting
+     */
+    private static identifyKeyDirectories;
+    /**
+     * Detect architecture patterns from codebase
+     */
+    private static detectArchitecturePatterns;
+    /**
+     * Get the canonical tool definition for init_cortex_context
+     */
+    static getToolDefinition(): CanonicalTool;
+}
+export {};
+//# sourceMappingURL=InitCortexContext.d.ts.map

package/dist/tools/context-management/InitCortexContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitCortexContext.d.ts","sourceRoot":"","sources":["../../../src/tools/context-management/InitCortexContext.ts"],"names":[],"mappings":"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"}