codeprobe 0.1.0

package/dist/core/doctorRunner.js

@@ -0,0 +1,278 @@
+/**
+ * Doctor runner: environment and project diagnostics.
+ *
+ * Runs a series of checks to verify that the development environment
+ * and project structure are properly configured for codeprobe.
+ */
+import { stat, access, constants } from 'node:fs/promises';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fileExists, isDirectory } from '../utils/fs.js';
+import { resolveProjectRoot } from '../utils/paths.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Parse a Node.js version string (e.g. "v18.17.0") into its major
+ * version number.
+ */
+function parseMajorVersion(versionStr) {
+    const match = /^v?(\d+)/.exec(versionStr.trim());
+    if (!match?.[1])
+        return null;
+    return parseInt(match[1], 10);
+}
+/**
+ * Check Node.js version >= 18.
+ */
+async function checkNodeVersion() {
+    const version = process.version;
+    const major = parseMajorVersion(version);
+    if (major === null) {
+        return {
+            name: 'Node.js version',
+            status: 'warn',
+            message: `Unable to parse Node.js version: ${version}`,
+        };
+    }
+    if (major < 18) {
+        return {
+            name: 'Node.js version',
+            status: 'fail',
+            message: `Node.js ${version} is below the minimum required version (>=18).`,
+            details: 'Upgrade Node.js to version 18 or later: https://nodejs.org/',
+        };
+    }
+    return {
+        name: 'Node.js version',
+        status: 'pass',
+        message: `Node.js ${version} meets the minimum requirement (>=18).`,
+    };
+}
+/**
+ * Check that the prompts/ directory exists.
+ */
+async function checkPromptsDir() {
+    const root = resolveProjectRoot();
+    const promptsDir = join(root, 'prompts');
+    if (await isDirectory(promptsDir)) {
+        return {
+            name: 'prompts/ directory',
+            status: 'pass',
+            message: 'prompts/ directory exists.',
+        };
+    }
+    return {
+        name: 'prompts/ directory',
+        status: 'warn',
+        message: 'prompts/ directory not found.',
+        details: 'Create a prompts/ directory to store your prompt specification files.',
+    };
+}
+/**
+ * Check that the datasets/ directory exists.
+ */
+async function checkDatasetsDir() {
+    const root = resolveProjectRoot();
+    const datasetsDir = join(root, 'datasets');
+    if (await isDirectory(datasetsDir)) {
+        return {
+            name: 'datasets/ directory',
+            status: 'pass',
+            message: 'datasets/ directory exists.',
+        };
+    }
+    return {
+        name: 'datasets/ directory',
+        status: 'warn',
+        message: 'datasets/ directory not found.',
+        details: 'Create a datasets/ directory to store evaluation datasets (JSONL files).',
+    };
+}
+/**
+ * Check that codeprobe.config.yaml exists.
+ */
+async function checkConfigFile() {
+    const root = resolveProjectRoot();
+    const configNames = [
+        'codeprobe.config.yaml',
+        'codeprobe.config.yml',
+        '.codeprobe.yaml',
+        '.codeprobe.yml',
+        // Backward compat: also check legacy config file names
+        'claude-test.config.yaml',
+        'claude-test.config.yml',
+        '.claude-test.yaml',
+        '.claude-test.yml',
+    ];
+    for (const name of configNames) {
+        const configPath = join(root, name);
+        if (await fileExists(configPath)) {
+            return {
+                name: 'Configuration file',
+                status: 'pass',
+                message: `Configuration file found: ${name}`,
+            };
+        }
+    }
+    return {
+        name: 'Configuration file',
+        status: 'warn',
+        message: 'No codeprobe configuration file found.',
+        details: 'Create a codeprobe.config.yaml file to customize default settings. ' +
+            'Run with defaults if no configuration is needed.',
+    };
+}
+/**
+ * Check that ANTHROPIC_API_KEY environment variable is set.
+ */
+async function checkApiKey() {
+    const key = process.env['ANTHROPIC_API_KEY'];
+    if (!key) {
+        return {
+            name: 'ANTHROPIC_API_KEY',
+            status: 'warn',
+            message: 'ANTHROPIC_API_KEY environment variable is not set.',
+            details: 'Set ANTHROPIC_API_KEY to enable live model calls. ' +
+                'Mock mode works without an API key.',
+        };
+    }
+    if (key.length < 10) {
+        return {
+            name: 'ANTHROPIC_API_KEY',
+            status: 'warn',
+            message: 'ANTHROPIC_API_KEY appears to be too short to be valid.',
+        };
+    }
+    return {
+        name: 'ANTHROPIC_API_KEY',
+        status: 'pass',
+        message: 'ANTHROPIC_API_KEY is set.',
+    };
+}
+/**
+ * Check that .cache/ directory exists and is writable.
+ */
+async function checkCacheDir() {
+    const root = resolveProjectRoot();
+    const cacheDir = join(root, '.cache');
+    if (!(await isDirectory(cacheDir))) {
+        // Check if it exists but is a file
+        if (await fileExists(cacheDir)) {
+            return {
+                name: '.cache/ directory',
+                status: 'fail',
+                message: '.cache exists but is not a directory.',
+            };
+        }
+        return {
+            name: '.cache/ directory',
+            status: 'warn',
+            message: '.cache/ directory does not exist.',
+            details: 'The cache directory will be created automatically when caching is used. ' +
+                'You can also create it manually: mkdir .cache',
+        };
+    }
+    try {
+        await access(cacheDir, constants.W_OK);
+        return {
+            name: '.cache/ directory',
+            status: 'pass',
+            message: '.cache/ directory exists and is writable.',
+        };
+    }
+    catch {
+        return {
+            name: '.cache/ directory',
+            status: 'fail',
+            message: '.cache/ directory exists but is not writable.',
+            details: 'Check file permissions on the .cache/ directory.',
+        };
+    }
+}
+/**
+ * Check that package.json exists in the project root.
+ */
+async function checkPackageJson() {
+    const root = resolveProjectRoot();
+    const pkgPath = join(root, 'package.json');
+    if (await fileExists(pkgPath)) {
+        return {
+            name: 'package.json',
+            status: 'pass',
+            message: 'package.json exists in the project root.',
+        };
+    }
+    return {
+        name: 'package.json',
+        status: 'warn',
+        message: 'package.json not found in the project root.',
+        details: 'A package.json is recommended for managing dependencies.',
+    };
+}
+/**
+ * Check that TypeScript is installed and accessible.
+ */
+async function checkTypeScript() {
+    try {
+        const { stdout } = await execFileAsync('npx', ['tsc', '--version'], {
+            timeout: 10000,
+        });
+        const version = stdout.trim();
+        return {
+            name: 'TypeScript',
+            status: 'pass',
+            message: `TypeScript is installed: ${version}`,
+        };
+    }
+    catch {
+        // Try checking node_modules directly
+        const root = resolveProjectRoot();
+        const tscPath = join(root, 'node_modules', '.bin', 'tsc');
+        try {
+            await stat(tscPath);
+            return {
+                name: 'TypeScript',
+                status: 'pass',
+                message: 'TypeScript is installed (found in node_modules).',
+            };
+        }
+        catch {
+            // Fall through to warn
+        }
+        return {
+            name: 'TypeScript',
+            status: 'warn',
+            message: 'TypeScript does not appear to be installed.',
+            details: 'Install TypeScript: npm install --save-dev typescript',
+        };
+    }
+}
+/**
+ * Run all diagnostic checks and return the results.
+ *
+ * Checks:
+ * 1. Node.js version (>= 18)
+ * 2. prompts/ directory exists
+ * 3. datasets/ directory exists
+ * 4. codeprobe.config.yaml exists
+ * 5. ANTHROPIC_API_KEY env var is set
+ * 6. .cache/ directory exists/writable
+ * 7. package.json exists
+ * 8. TypeScript installed
+ *
+ * @returns  Array of diagnostic check results.
+ */
+export async function runDiagnostics() {
+    const checks = await Promise.all([
+        checkNodeVersion(),
+        checkPromptsDir(),
+        checkDatasetsDir(),
+        checkConfigFile(),
+        checkApiKey(),
+        checkCacheDir(),
+        checkPackageJson(),
+        checkTypeScript(),
+    ]);
+    return checks;
+}
+//# sourceMappingURL=doctorRunner.js.map

package/dist/core/doctorRunner.js.map

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

package/dist/core/hookScanner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Hook scanner: detect hook-like assets in a repository.
+ *
+ * Looks for hook definitions in Claude Code configuration,
+ * package.json scripts, Husky, git hooks directories, and
+ * custom hooks directories.
+ */
+import type { HookInfo } from '../types/agent.js';
+/**
+ * Scan a repository for hook-like assets.
+ *
+ * Detects hooks from multiple sources:
+ * - .claude/settings.json hooks configuration
+ * - .claude/hooks/ directory
+ * - hooks/ directory at repository root
+ * - package.json scripts with "hook" in the name
+ * - .husky/ directory (Husky git hooks)
+ * - .githooks/ directory (custom git hooks)
+ *
+ * @param rootPath  Absolute path to the repository root.
+ * @returns         Array of detected hook descriptions.
+ */
+export declare function scanForHooks(rootPath: string): Promise<HookInfo[]>;
+//# sourceMappingURL=hookScanner.d.ts.map

package/dist/core/hookScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookScanner.d.ts","sourceRoot":"","sources":["../../src/core/hookScanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAwMlD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmBxE"}

package/dist/core/hookScanner.js

@@ -0,0 +1,226 @@
+/**
+ * Hook scanner: detect hook-like assets in a repository.
+ *
+ * Looks for hook definitions in Claude Code configuration,
+ * package.json scripts, Husky, git hooks directories, and
+ * custom hooks directories.
+ */
+import { join } from 'node:path';
+import { readFile, stat, readdir } from 'node:fs/promises';
+/**
+ * Safely read and parse a JSON file. Returns null on failure.
+ */
+async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List files in a directory. Returns an empty array if the directory
+ * does not exist or is not accessible.
+ */
+async function listDirectory(dirPath) {
+    try {
+        const dirStat = await stat(dirPath);
+        if (!dirStat.isDirectory())
+            return [];
+        const entries = await readdir(dirPath);
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Scan .claude/settings.json for hook configurations.
+ */
+async function scanClaudeSettings(rootPath) {
+    const hooks = [];
+    const settingsPath = join(rootPath, '.claude', 'settings.json');
+    const data = await readJsonFile(settingsPath);
+    if (!data)
+        return hooks;
+    // Look for a "hooks" key in the settings
+    if (typeof data['hooks'] === 'object' && data['hooks'] !== null) {
+        const hooksObj = data['hooks'];
+        for (const [event, config] of Object.entries(hooksObj)) {
+            if (typeof config === 'string') {
+                hooks.push({
+                    path: settingsPath,
+                    type: 'claude-hook',
+                    description: `Claude hook for event "${event}": ${config}`,
+                    events: [event],
+                });
+            }
+            else if (typeof config === 'object' && config !== null) {
+                const configObj = config;
+                const command = typeof configObj['command'] === 'string'
+                    ? configObj['command']
+                    : 'unknown';
+                hooks.push({
+                    path: settingsPath,
+                    type: 'claude-hook',
+                    description: `Claude hook for event "${event}": ${command}`,
+                    events: [event],
+                });
+            }
+        }
+    }
+    return hooks;
+}
+/**
+ * Scan .claude/hooks/ directory for hook scripts.
+ */
+async function scanClaudeHooksDir(rootPath) {
+    const hooks = [];
+    const hooksDir = join(rootPath, '.claude', 'hooks');
+    const entries = await listDirectory(hooksDir);
+    for (const entry of entries) {
+        const fullPath = join(hooksDir, entry);
+        hooks.push({
+            path: fullPath,
+            type: 'claude-hook',
+            description: `Claude hook script: ${entry}`,
+        });
+    }
+    return hooks;
+}
+/**
+ * Scan hooks/ directory at repository root.
+ */
+async function scanRootHooksDir(rootPath) {
+    const hooks = [];
+    const hooksDir = join(rootPath, 'hooks');
+    const entries = await listDirectory(hooksDir);
+    for (const entry of entries) {
+        const fullPath = join(hooksDir, entry);
+        hooks.push({
+            path: fullPath,
+            type: 'project-hook',
+            description: `Hook script in hooks/ directory: ${entry}`,
+        });
+    }
+    return hooks;
+}
+/**
+ * Scan package.json for scripts with "hook" in their name.
+ */
+async function scanPackageJsonHooks(rootPath) {
+    const hooks = [];
+    const pkgPath = join(rootPath, 'package.json');
+    const data = await readJsonFile(pkgPath);
+    if (!data)
+        return hooks;
+    if (typeof data['scripts'] === 'object' && data['scripts'] !== null) {
+        const scripts = data['scripts'];
+        for (const [name, command] of Object.entries(scripts)) {
+            if (name.toLowerCase().includes('hook') && typeof command === 'string') {
+                hooks.push({
+                    path: pkgPath,
+                    type: 'npm-hook',
+                    description: `npm script "${name}": ${command}`,
+                    events: [name],
+                });
+            }
+        }
+    }
+    return hooks;
+}
+/**
+ * Scan .husky/ directory for Husky git hooks.
+ */
+async function scanHuskyDir(rootPath) {
+    const hooks = [];
+    const huskyDir = join(rootPath, '.husky');
+    const entries = await listDirectory(huskyDir);
+    for (const entry of entries) {
+        // Skip husky internal files
+        if (entry === '_' || entry.startsWith('.'))
+            continue;
+        const fullPath = join(huskyDir, entry);
+        try {
+            const entryStat = await stat(fullPath);
+            if (!entryStat.isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        hooks.push({
+            path: fullPath,
+            type: 'husky-hook',
+            description: `Husky git hook: ${entry}`,
+            events: [entry],
+        });
+    }
+    return hooks;
+}
+/**
+ * Scan .githooks/ directory for custom git hooks.
+ */
+async function scanGitHooksDir(rootPath) {
+    const hooks = [];
+    const gitHooksDir = join(rootPath, '.githooks');
+    const entries = await listDirectory(gitHooksDir);
+    for (const entry of entries) {
+        const fullPath = join(gitHooksDir, entry);
+        try {
+            const entryStat = await stat(fullPath);
+            if (!entryStat.isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        hooks.push({
+            path: fullPath,
+            type: 'git-hook',
+            description: `Custom git hook: ${entry}`,
+            events: [entry],
+        });
+    }
+    return hooks;
+}
+/**
+ * Scan a repository for hook-like assets.
+ *
+ * Detects hooks from multiple sources:
+ * - .claude/settings.json hooks configuration
+ * - .claude/hooks/ directory
+ * - hooks/ directory at repository root
+ * - package.json scripts with "hook" in the name
+ * - .husky/ directory (Husky git hooks)
+ * - .githooks/ directory (custom git hooks)
+ *
+ * @param rootPath  Absolute path to the repository root.
+ * @returns         Array of detected hook descriptions.
+ */
+export async function scanForHooks(rootPath) {
+    // Verify root exists
+    try {
+        const rootStat = await stat(rootPath);
+        if (!rootStat.isDirectory())
+            return [];
+    }
+    catch {
+        return [];
+    }
+    const results = await Promise.all([
+        scanClaudeSettings(rootPath),
+        scanClaudeHooksDir(rootPath),
+        scanRootHooksDir(rootPath),
+        scanPackageJsonHooks(rootPath),
+        scanHuskyDir(rootPath),
+        scanGitHooksDir(rootPath),
+    ]);
+    return results.flat();
+}
+//# sourceMappingURL=hookScanner.js.map

package/dist/core/hookScanner.js.map

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

package/dist/core/mcpScanner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP (Model Context Protocol) scanner.
+ *
+ * Detects MCP-related configuration files, server definitions,
+ * and dependencies in a repository.
+ */
+import type { MCPAsset } from '../types/agent.js';
+/**
+ * Scan a repository for MCP-related files and configurations.
+ *
+ * Detects:
+ * - .mcp.json, mcp.json root config files
+ * - .claude/mcp*.json config files
+ * - Files containing "mcpServers" or "mcp_servers" patterns
+ * - package.json MCP-related dependencies
+ * - Files referencing "ModelContextProtocol" or "@modelcontextprotocol"
+ *
+ * @param rootPath  Absolute path to the repository root.
+ * @returns         Array of detected MCP assets.
+ */
+export declare function scanForMCP(rootPath: string): Promise<MCPAsset[]>;
+//# sourceMappingURL=mcpScanner.d.ts.map

package/dist/core/mcpScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpScanner.d.ts","sourceRoot":"","sources":["../../src/core/mcpScanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAwQlD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA+BtE"}