codeep 1.0.123 → 1.0.125

package/README.md

@@ -220,6 +220,64 @@ Custom skill example (`~/.codeep/skills/my-workflow.json`):
 }
 ```
 
+### Project Intelligence (`/scan`)
+
+Scan your project once and cache deep analysis for faster AI responses:
+
+```
+/scan          # Full project scan - analyzes structure, dependencies, patterns
+/scan status   # Show last scan info (age, file count, project type)
+/scan clear    # Clear cached intelligence
+```
+
+**What gets analyzed and cached:**
+
+| Category | Information |
+|----------|-------------|
+| **Structure** | File count, directory tree, language distribution |
+| **Dependencies** | Runtime & dev dependencies, detected frameworks |
+| **Architecture** | Patterns (MVC, Component-based), main modules, entry points |
+| **Scripts** | Available npm/composer/make scripts |
+| **Conventions** | Indentation style, quotes, semicolons, naming conventions |
+| **Testing** | Test framework, test directory location |
+
+**Benefits:**
+- AI understands your project deeply without re-analyzing each time
+- Faster responses - no need to scan files repeatedly  
+- Consistent context across sessions
+- Framework-aware suggestions (React, Vue, Express, Django, etc.)
+
+**Storage:** `.codeep/intelligence.json` (project-local)
+
+**Example output:**
+```
+# Project: my-app
+Type: TypeScript/Node.js
+
+## Structure
+- 156 files, 24 directories
+- Languages: TypeScript React (89), TypeScript (45), JSON (12)
+- Main directories: src, components, utils, hooks
+
+## Frameworks
+React, Next.js
+
+## Architecture
+Patterns: Component-based, File-based routing
+Main modules: src, components, hooks, utils
+
+## Available Scripts
+- dev: next dev
+- build: next build
+- test: vitest
+
+## Code Conventions
+- Indentation: spaces
+- Quotes: single
+- Semicolons: no
+- Naming: camelCase
+```
+
 ### Self-Verification
 After making changes, the agent automatically:
 1. Runs **build** to check for compilation errors
@@ -400,6 +458,14 @@ After installation, `codeep` is available globally in your terminal. Simply run
 | `/learn status` | Show learned preferences |
 | `/learn rule <text>` | Add a custom coding rule |
 
+### Project Intelligence
+
+| Command | Description |
+|---------|-------------|
+| `/scan` | Scan project and cache intelligence for AI |
+| `/scan status` | Show last scan info |
+| `/scan clear` | Clear cached intelligence |
+
 ### Skills
 
 | Command | Description |

package/dist/app.js

@@ -21,7 +21,7 @@ import { MessageList } from './components/MessageList.js';
 import { chat } from './api/index.js';
 import { config, loadApiKey, loadAllApiKeys, PROTOCOLS, LANGUAGES, autoSaveSession, startNewSession, getCurrentSessionId, renameSession, deleteSession, hasReadPermission, hasWritePermission, setProjectPermission, setProvider, getCurrentProvider, getModelsForCurrentProvider, PROVIDERS } from './config/index.js';
 import { getProviderList } from './config/providers.js';
-import { isProjectDirectory, getProjectContext, detectFilePaths, readProjectFile, parseFileChanges, writeProjectFile, deleteProjectFile } from './utils/project.js';
+import { isProjectDirectory, getProjectContext, detectFilePaths, readProjectFile, parseFileChanges, writeProjectFile, deleteProjectFile, getProjectTip } from './utils/project.js';
 import { logStartup, setLogProjectPath } from './utils/logger.js';
 import { searchMessages } from './utils/search.js';
 import { exportMessages, saveExport } from './utils/export.js';
@@ -1264,14 +1264,14 @@ export const App = () => {
             if (permanent) {
                 // Save permission to local .codeep/config.json
                 setProjectPermission(projectPath, true, writeGranted);
-                notify(writeGranted
-                    ? 'Project access granted (read + write, permanent)'
-                    : 'Project access granted (read-only, permanent)');
+            }
+            // Show project tip with type and suggested commands
+            const tip = getProjectTip(projectPath);
+            if (tip) {
+                notify(tip, 5000);
             }
             else {
-                notify(writeGranted
-                    ? 'Project access granted (read + write, this session)'
-                    : 'Project access granted (read-only, this session)');
+                notify(writeGranted ? 'Project access granted (read + write)' : 'Project access granted (read-only)');
             }
             // Warn user if Agent Mode is ON but write access was not granted
             const agentMode = config.get('agentMode');
@@ -1323,7 +1323,7 @@ export const App = () => {
                         const actionColor = change.action === 'delete' ? 'red' : change.action === 'edit' ? 'yellow' : 'green';
                         const actionLabel = change.action === 'delete' ? 'DELETE' : change.action === 'edit' ? 'EDIT' : 'CREATE';
                         return (_jsxs(Text, { children: ["\u2022 ", _jsxs(Text, { color: actionColor, children: ["[", actionLabel, "]"] }), " ", change.path, change.action !== 'delete' && change.content.includes('\n') && ` (${change.content.split('\n').length} lines)`] }, i));
-                    }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["Apply changes? ", _jsx(Text, { color: "#f02a30", bold: true, children: "[Y/n]" })] }), _jsx(Text, { color: "cyan", children: "Press Y to apply, N or Esc to reject" })] })), notification && (_jsx(Box, { justifyContent: "center", children: _jsx(Text, { color: "cyan", children: notification }) })), !isInlineMenu && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", children: '─'.repeat(Math.max(20, stdout?.columns || 80)) }), _jsx(Box, { paddingX: 1, children: _jsx(ChatInput, { onSubmit: handleSubmit, disabled: isLoading || isAgentRunning || pendingFileChanges.length > 0, history: inputHistory, clearTrigger: clearInputTrigger }) }), _jsx(Text, { color: "#f02a30", children: '─'.repeat(Math.max(20, stdout?.columns || 80)) })] })), isInlineMenu && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", children: '─'.repeat(stdout?.columns || 80) }), screen === 'help' && _jsx(Help, {}), screen === 'status' && _jsx(Status, {}), screen === 'settings' && (_jsx(Settings, { onClose: () => setScreen('chat'), notify: notify, hasWriteAccess: hasWriteAccess, hasProjectContext: !!projectContext })), screen === 'sessions' && (_jsx(Sessions, { history: messages, onLoad: handleSessionLoad, onClose: () => setScreen('chat'), projectPath: projectPath })), screen === 'sessions-delete' && (_jsx(Sessions, { history: messages, onLoad: handleSessionLoad, onClose: () => setScreen('chat'), onDelete: (name) => {
+                    }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["Apply changes? ", _jsx(Text, { color: "#f02a30", bold: true, children: "[Y/n]" })] }), _jsx(Text, { color: "cyan", children: "Press Y to apply, N or Esc to reject" })] })), notification && (_jsx(Box, { justifyContent: "center", children: _jsx(Text, { color: "cyan", children: notification }) })), !isInlineMenu && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", children: '─'.repeat(Math.max(20, stdout?.columns || 80)) }), _jsx(Box, { paddingX: 1, children: _jsx(ChatInput, { onSubmit: handleSubmit, disabled: isLoading || isAgentRunning || pendingFileChanges.length > 0, history: inputHistory, clearTrigger: clearInputTrigger }) }), _jsx(Text, { color: "#f02a30", children: '─'.repeat(Math.max(20, stdout?.columns || 80)) })] })), isInlineMenu && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", children: '─'.repeat(stdout?.columns || 80) }), screen === 'help' && _jsx(Help, { projectPath: projectPath }), screen === 'status' && _jsx(Status, {}), screen === 'settings' && (_jsx(Settings, { onClose: () => setScreen('chat'), notify: notify, hasWriteAccess: hasWriteAccess, hasProjectContext: !!projectContext })), screen === 'sessions' && (_jsx(Sessions, { history: messages, onLoad: handleSessionLoad, onClose: () => setScreen('chat'), projectPath: projectPath })), screen === 'sessions-delete' && (_jsx(Sessions, { history: messages, onLoad: handleSessionLoad, onClose: () => setScreen('chat'), onDelete: (name) => {
                             notify(`Deleted: ${name}`);
                             setScreen('chat');
                         }, deleteMode: true, projectPath: projectPath })), screen === 'logout' && (_jsx(LogoutPicker, { onLogout: (providerId) => {

package/dist/components/Help.d.ts

@@ -1,2 +1,6 @@
 import React from 'react';
-export declare const Help: React.FC;
+interface HelpProps {
+    projectPath?: string;
+}
+export declare const Help: React.FC<HelpProps>;
+export {};

package/dist/components/Help.js

@@ -1,5 +1,7 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Text, Box } from 'ink';
-export const Help = () => {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", bold: true, children: "Available Commands" }), _jsx(Text, { children: " " }), _jsxs(Box, { flexDirection: "row", gap: 2, children: [_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/help" }), "       - Show this help"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/status" }), "     - Current status"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/settings" }), "   - Adjust settings"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/sessions" }), "   - Manage sessions"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/grant" }), "      - Grant permissions"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/agent" }), " ", '<task>', " - Run agent"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/clear" }), "      - Clear chat"] })] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/model" }), "      - Switch model"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/provider" }), "   - Switch provider"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/diff" }), "       - Review git changes"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/commit" }), "     - Generate commit msg"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/export" }), "     - Export chat"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/copy" }), " [n]   - Copy code block"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/exit" }), "       - Quit"] })] })] }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Type / to see autocomplete. Docs: github.com/VladoIvankovic/Codeep" })] }));
+import { detectProjectFeatures } from '../utils/project.js';
+export const Help = ({ projectPath }) => {
+    const features = projectPath ? detectProjectFeatures(projectPath) : null;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "#f02a30", bold: true, children: "Available Commands" }), _jsx(Text, { children: " " }), _jsxs(Box, { flexDirection: "row", gap: 2, children: [_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/help" }), "       - Show this help"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/status" }), "     - Current status"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/settings" }), "   - Adjust settings"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/sessions" }), "   - Manage sessions"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/grant" }), "      - Grant permissions"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/agent" }), " ", '<task>', " - Run agent"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/clear" }), "      - Clear chat"] })] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/model" }), "      - Switch model"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/provider" }), "   - Switch provider"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/diff" }), "       - Review git changes"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/commit" }), "     - Generate commit msg"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/export" }), "     - Export chat"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/copy" }), " [n]   - Copy code block"] }), _jsxs(Text, { children: [_jsx(Text, { color: "#f02a30", children: "/exit" }), "       - Quit"] })] })] }), features && (features.hasGit || features.hasPackageJson || features.hasPython || features.hasCargo || features.hasGoMod) && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { color: "green", bold: true, children: "Suggested for this project:" }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [features.hasGit && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/diff" }), " - Review your uncommitted changes"] })), features.hasGit && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/commit" }), " - AI-generated commit message"] })), features.hasPackageJson && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/agent npm run build" }), " - Build Node.js project"] })), features.hasPython && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/agent pytest" }), " - Run Python tests"] })), features.hasCargo && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/agent cargo build" }), " - Build Rust project"] })), features.hasGoMod && (_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "/agent go build" }), " - Build Go project"] }))] })] })), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Type / to see autocomplete. Docs: github.com/VladoIvankovic/Codeep" })] }));
 };

package/dist/config/index.js

@@ -48,21 +48,55 @@ function isProjectDirectory(path) {
     ];
     return projectFiles.some(file => existsSync(join(path, file)));
 }
-export const config = new Conf({
-    projectName: 'codeep',
-    defaults: {
+/**
+ * Get fallback config directory if standard location is not writable
+ * Falls back to .codeep in current working directory
+ */
+function getFallbackConfigDir() {
+    const cwdConfig = join(process.cwd(), '.codeep');
+    try {
+        if (!existsSync(cwdConfig)) {
+            mkdirSync(cwdConfig, { recursive: true });
+        }
+        return cwdConfig;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if a directory is writable
+ */
+function isWritable(dir) {
+    try {
+        const testFile = join(dir, '.write-test');
+        writeFileSync(testFile, 'test');
+        unlinkSync(testFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create config with fallback logic
+ * 1. Try standard Conf location (~/.config/codeep-nodejs on Linux, etc.)
+ * 2. If not writable, use .codeep in current working directory
+ */
+function createConfig() {
+    const defaults = {
         apiKey: '',
         provider: 'z.ai',
         model: 'glm-4.7',
         agentMode: 'on',
-        agentConfirmation: 'dangerous', // Confirm only dangerous actions by default
+        agentConfirmation: 'dangerous',
         agentAutoCommit: false,
         agentAutoCommitBranch: false,
-        agentAutoVerify: true, // Auto-verify by default
+        agentAutoVerify: true,
         agentMaxFixAttempts: 3,
         agentMaxIterations: 100,
-        agentMaxDuration: 20, // minutes
-        agentApiTimeout: 180000, // 180 seconds base timeout for agent (dynamically adjusted)
+        agentMaxDuration: 20,
+        agentApiTimeout: 180000,
         protocol: 'openai',
         plan: 'lite',
         language: 'en',
@@ -71,12 +105,47 @@ export const config = new Conf({
         temperature: 0.7,
         maxTokens: 8192,
         apiTimeout: 60000,
-        rateLimitApi: 30, // 30 requests per minute
-        rateLimitCommands: 100, // 100 commands per minute
+        rateLimitApi: 30,
+        rateLimitCommands: 100,
         projectPermissions: [],
         providerApiKeys: [],
-    },
-});
+    };
+    // First try standard location
+    try {
+        const standardConfig = new Conf({
+            projectName: 'codeep',
+            defaults,
+        });
+        // Test if we can write to the config directory
+        const configDir = dirname(standardConfig.path);
+        if (isWritable(configDir)) {
+            return standardConfig;
+        }
+    }
+    catch {
+        // Standard location failed, try fallback
+    }
+    // Fallback: use .codeep in current working directory
+    const fallbackDir = getFallbackConfigDir();
+    if (fallbackDir) {
+        try {
+            return new Conf({
+                projectName: 'codeep',
+                cwd: fallbackDir,
+                defaults,
+            });
+        }
+        catch {
+            // Even fallback failed
+        }
+    }
+    // Last resort: use standard config anyway (may fail on write)
+    return new Conf({
+        projectName: 'codeep',
+        defaults,
+    });
+}
+export const config = createConfig();
 // Migrate old 'auto' value to 'on'
 if (config.get('agentMode') === 'auto') {
     config.set('agentMode', 'on');

package/dist/utils/project.d.ts

@@ -84,3 +84,38 @@ export declare function getProjectSummary(dir?: string): {
     fileCount: number;
     hasReadme: boolean;
 } | null;
+/**
+ * Project feature detection
+ */
+export interface ProjectFeatures {
+    hasGit: boolean;
+    hasPackageJson: boolean;
+    hasTypescript: boolean;
+    hasPython: boolean;
+    hasDocker: boolean;
+    hasTests: boolean;
+    hasCargo: boolean;
+    hasGoMod: boolean;
+    projectType: string;
+}
+/**
+ * Suggested command based on project features
+ */
+export interface ProjectSuggestion {
+    command: string;
+    description: string;
+    reason: string;
+    priority: number;
+}
+/**
+ * Detect project features
+ */
+export declare function detectProjectFeatures(dir?: string): ProjectFeatures;
+/**
+ * Get smart suggestions based on project type
+ */
+export declare function getProjectSuggestions(dir?: string): ProjectSuggestion[];
+/**
+ * Get a brief tip message for the project type
+ */
+export declare function getProjectTip(dir?: string): string | null;

package/dist/utils/project.js

@@ -414,3 +414,142 @@ export function getProjectSummary(dir = process.cwd()) {
         return null;
     }
 }
+/**
+ * Detect project features
+ */
+export function detectProjectFeatures(dir = process.cwd()) {
+    return {
+        hasGit: existsSync(join(dir, '.git')),
+        hasPackageJson: existsSync(join(dir, 'package.json')),
+        hasTypescript: existsSync(join(dir, 'tsconfig.json')),
+        hasPython: existsSync(join(dir, 'requirements.txt')) || existsSync(join(dir, 'setup.py')) || existsSync(join(dir, 'pyproject.toml')),
+        hasDocker: existsSync(join(dir, 'Dockerfile')) || existsSync(join(dir, 'docker-compose.yml')),
+        hasTests: existsSync(join(dir, 'jest.config.js')) || existsSync(join(dir, 'jest.config.ts')) ||
+            existsSync(join(dir, 'pytest.ini')) || existsSync(join(dir, 'test')) || existsSync(join(dir, 'tests')) ||
+            existsSync(join(dir, '__tests__')) || existsSync(join(dir, 'spec')),
+        hasCargo: existsSync(join(dir, 'Cargo.toml')),
+        hasGoMod: existsSync(join(dir, 'go.mod')),
+        projectType: getProjectType(dir),
+    };
+}
+/**
+ * Get smart suggestions based on project type
+ */
+export function getProjectSuggestions(dir = process.cwd()) {
+    const features = detectProjectFeatures(dir);
+    const suggestions = [];
+    // Git suggestions
+    if (features.hasGit) {
+        suggestions.push({
+            command: '/diff',
+            description: 'Review uncommitted changes',
+            reason: 'Git repository detected',
+            priority: 1,
+        });
+        suggestions.push({
+            command: '/commit',
+            description: 'Generate commit message',
+            reason: 'Git repository detected',
+            priority: 2,
+        });
+    }
+    // Node.js/TypeScript suggestions
+    if (features.hasPackageJson) {
+        suggestions.push({
+            command: '/agent npm run build',
+            description: 'Build the project',
+            reason: 'Node.js project detected',
+            priority: 3,
+        });
+        if (features.hasTests) {
+            suggestions.push({
+                command: '/agent npm test',
+                description: 'Run tests',
+                reason: 'Test configuration found',
+                priority: 4,
+            });
+        }
+    }
+    // Python suggestions
+    if (features.hasPython) {
+        suggestions.push({
+            command: '/agent pip install -r requirements.txt',
+            description: 'Install dependencies',
+            reason: 'Python project detected',
+            priority: 3,
+        });
+        if (features.hasTests) {
+            suggestions.push({
+                command: '/agent pytest',
+                description: 'Run tests',
+                reason: 'Python tests detected',
+                priority: 4,
+            });
+        }
+    }
+    // Rust suggestions
+    if (features.hasCargo) {
+        suggestions.push({
+            command: '/agent cargo build',
+            description: 'Build the project',
+            reason: 'Rust project detected',
+            priority: 3,
+        });
+        suggestions.push({
+            command: '/agent cargo test',
+            description: 'Run tests',
+            reason: 'Rust project detected',
+            priority: 4,
+        });
+    }
+    // Go suggestions
+    if (features.hasGoMod) {
+        suggestions.push({
+            command: '/agent go build',
+            description: 'Build the project',
+            reason: 'Go project detected',
+            priority: 3,
+        });
+        suggestions.push({
+            command: '/agent go test ./...',
+            description: 'Run tests',
+            reason: 'Go project detected',
+            priority: 4,
+        });
+    }
+    // Docker suggestions
+    if (features.hasDocker) {
+        suggestions.push({
+            command: '/agent docker build',
+            description: 'Build Docker image',
+            reason: 'Dockerfile detected',
+            priority: 5,
+        });
+    }
+    // Always suggest agent for code tasks
+    suggestions.push({
+        command: '/agent',
+        description: 'Run autonomous agent for any task',
+        reason: 'Project access granted',
+        priority: 10,
+    });
+    // Sort by priority
+    return suggestions.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Get a brief tip message for the project type
+ */
+export function getProjectTip(dir = process.cwd()) {
+    const features = detectProjectFeatures(dir);
+    const tips = [];
+    if (features.hasGit) {
+        tips.push('/diff, /commit');
+    }
+    if (features.hasPackageJson || features.hasCargo || features.hasGoMod || features.hasPython) {
+        tips.push('/agent for tasks');
+    }
+    if (tips.length === 0)
+        return null;
+    const projectName = features.projectType !== 'Unknown' ? features.projectType : 'project';
+    return `${projectName} • Try: ${tips.join(' • ')}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeep",
-  "version": "1.0.123",
+  "version": "1.0.125",
   "description": "AI-powered coding assistant built for the terminal. Multiple LLM providers, project-aware context, and a seamless development workflow.",
   "type": "module",
   "main": "dist/index.js",