@promptwheel/core 0.6.0

package/dist/scope/shared.js

@@ -0,0 +1,355 @@
+/**
+ * Pure scope algorithms — no filesystem, no external dependencies.
+ *
+ * Shared by both @promptwheel/cli and @promptwheel/mcp.
+ * CLI keeps its proposal-level scope checking wrapper.
+ * MCP keeps its minimatch-based policy enforcement + file I/O.
+ */
+// ---------------------------------------------------------------------------
+// Always-denied paths (build artifacts, lockfiles, VCS internals)
+// ---------------------------------------------------------------------------
+export const ALWAYS_DENIED = [
+    '.env', '.env.*',
+    'node_modules/**', '.git/**', '.promptwheel/**',
+    'dist/**', 'build/**', 'coverage/**',
+    // Lock files are auto-generated; governed by per-ticket allowed_paths instead
+    'package-lock.json',
+];
+// ---------------------------------------------------------------------------
+// Credential / secret detection patterns
+// ---------------------------------------------------------------------------
+export const CREDENTIAL_PATTERNS = [
+    /AKIA[0-9A-Z]{16}/, // AWS access key
+    /-----BEGIN.*PRIVATE KEY-----/, // PEM keys
+    /ghp_[a-zA-Z0-9]{36}/, // GitHub PAT
+    /\bsk-(?:proj-)?[a-zA-Z0-9_-]{32,}/, // OpenAI key
+    /password\s*[:=]\s*['"][^'"]+/i, // hardcoded passwords
+    /xox[bporas]-[a-zA-Z0-9-]+/, // Slack tokens
+    /postgres(ql)?:\/\/[^\s'"]+/i, // PostgreSQL connection string
+    /mongodb(\+srv)?:\/\/[^\s'"]+/i, // MongoDB connection string
+    /mysql:\/\/[^\s'"]+/i, // MySQL connection string
+    /eyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\./, // JWT tokens
+    /(?:SECRET|TOKEN|API_?KEY|PRIVATE_?KEY)\s*[:=]\s*['"][^'"]{8,}/i, // Generic secrets
+];
+// ---------------------------------------------------------------------------
+// File deny patterns (sensitive file names)
+// ---------------------------------------------------------------------------
+export const FILE_DENY_PATTERNS = [
+    /\.(env|pem|key)$/,
+    /credentials/i,
+    /secret/i,
+];
+// ---------------------------------------------------------------------------
+// Path normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a file path for consistent matching.
+ */
+export function normalizePath(filePath) {
+    return filePath
+        .replace(/\\/g, '/') // Normalize backslashes
+        .replace(/^\.\//, '') // Remove leading ./
+        .replace(/\/+/g, '/') // Collapse multiple slashes
+        .replace(/\/$/, ''); // Remove trailing slash
+}
+// ---------------------------------------------------------------------------
+// Hallucinated path detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect if a path appears to be hallucinated by an LLM.
+ * Common patterns: repeated segments like 'foo/foo/'.
+ */
+export function detectHallucinatedPath(filePath) {
+    const normalized = normalizePath(filePath);
+    const segments = normalized.split('/').filter(s => s.length > 0);
+    // Check for repeated consecutive segments
+    for (let i = 0; i < segments.length - 1; i++) {
+        if (segments[i] === segments[i + 1] && segments[i].length > 0) {
+            return {
+                isHallucinated: true,
+                reason: `Repeated path segment: '${segments[i]}/${segments[i]}'`,
+            };
+        }
+    }
+    // Double slashes in original
+    if (/\/\//.test(filePath)) {
+        return {
+            isHallucinated: true,
+            reason: 'Contains double slashes',
+        };
+    }
+    return { isHallucinated: false };
+}
+// ---------------------------------------------------------------------------
+// Credential detection in file content
+// ---------------------------------------------------------------------------
+/**
+ * Check file content for credential patterns.
+ * Returns a description of the first match, or null if clean.
+ */
+export function detectCredentialInContent(content) {
+    for (const pattern of CREDENTIAL_PATTERNS) {
+        const match = content.match(pattern);
+        if (match) {
+            return `Content contains potential credential: ${pattern.source}`;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a file path matches credential/sensitive file patterns.
+ */
+export function detectCredentialPattern(filePath) {
+    for (const pattern of FILE_DENY_PATTERNS) {
+        if (pattern.test(filePath))
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Pure glob-style pattern matching (no external deps)
+// ---------------------------------------------------------------------------
+/**
+ * Simple glob-style pattern matching.
+ * Supports: * (any chars), ** (any path segments), ? (single char)
+ */
+export function matchesPattern(filePath, pattern) {
+    const normalizedFile = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    // Convert glob to regex
+    let regexPattern = normalizedPattern
+        .replace(/\*\*\//g, '<<<GLOBSTAR_SLASH>>>')
+        .replace(/\*\*/g, '<<<GLOBSTAR>>>')
+        .replace(/\*/g, '<<<STAR>>>')
+        .replace(/\?/g, '<<<QUESTION>>>');
+    regexPattern = regexPattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    regexPattern = regexPattern
+        .replace(/<<<GLOBSTAR_SLASH>>>/g, '(?:.*/)?')
+        .replace(/<<<GLOBSTAR>>>/g, '.*')
+        .replace(/<<<STAR>>>/g, '[^/]*')
+        .replace(/<<<QUESTION>>>/g, '[^/]');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(normalizedFile);
+}
+// ---------------------------------------------------------------------------
+// Path allowed/denied checking (pure — no minimatch dependency)
+// ---------------------------------------------------------------------------
+/**
+ * Check if a path is allowed given allow/deny lists using built-in glob matching.
+ * When allowed is empty, everything not denied is allowed.
+ */
+export function isPathAllowed(filePath, allowed, denied) {
+    const normalized = normalizePath(filePath);
+    // Check denied first (higher priority)
+    for (const pattern of denied) {
+        if (matchesPattern(normalized, pattern))
+            return false;
+    }
+    // Check denied file patterns
+    if (detectCredentialPattern(normalized))
+        return false;
+    // Check allowed (empty = everything allowed)
+    if (allowed.length === 0)
+        return true;
+    return allowed.some(pattern => matchesPattern(normalized, pattern));
+}
+/**
+ * Check if changed files violate scope constraints.
+ */
+export function checkScopeViolations(changedFiles, allowedPaths, forbiddenPaths) {
+    const violations = [];
+    for (const file of changedFiles) {
+        // Check hallucinated paths first
+        const hallucinationCheck = detectHallucinatedPath(file);
+        if (hallucinationCheck.isHallucinated) {
+            violations.push({
+                file,
+                violation: 'not_in_allowed',
+                pattern: `hallucinated: ${hallucinationCheck.reason}`,
+            });
+            continue;
+        }
+        const normalizedFile = normalizePath(file);
+        // Check forbidden paths (higher priority)
+        let isForbidden = false;
+        for (const pattern of forbiddenPaths) {
+            if (matchesPattern(normalizedFile, pattern)) {
+                violations.push({ file, violation: 'in_forbidden', pattern });
+                isForbidden = true;
+                break;
+            }
+        }
+        // Check allowed paths
+        if (!isForbidden && allowedPaths.length > 0) {
+            let isAllowed = allowedPaths.some(pattern => matchesPattern(normalizedFile, pattern));
+            if (!isAllowed && file.endsWith('/')) {
+                const dirPrefix = normalizedFile + '/';
+                isAllowed = allowedPaths.some(pattern => pattern.startsWith(dirPrefix));
+            }
+            if (!isAllowed) {
+                violations.push({ file, violation: 'not_in_allowed' });
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Analyze violations and determine if paths can be auto-expanded.
+ * Allows expansion for sibling files, test files, type definitions,
+ * index files, subdirectories, and root configs.
+ */
+export function analyzeViolationsForExpansion(violations, currentAllowedPaths, maxExpansions = 10) {
+    // Forbidden violations cannot be expanded
+    const forbiddenViolations = violations.filter(v => v.violation === 'in_forbidden');
+    if (forbiddenViolations.length > 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${forbiddenViolations.length} file(s) match forbidden paths`,
+        };
+    }
+    // Hallucinated paths cannot be expanded
+    const hallucinatedViolations = violations.filter(v => v.pattern?.startsWith('hallucinated:'));
+    if (hallucinatedViolations.length > 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${hallucinatedViolations.length} hallucinated path(s) detected`,
+        };
+    }
+    // Get allowed directories
+    const allowedDirs = new Set();
+    for (const p of currentAllowedPaths) {
+        const normalized = normalizePath(p);
+        const lastSlash = normalized.lastIndexOf('/');
+        if (lastSlash > 0) {
+            allowedDirs.add(normalized.slice(0, lastSlash));
+        }
+    }
+    const pathsToAdd = [];
+    const notAllowedViolations = violations.filter(v => v.violation === 'not_in_allowed');
+    for (const violation of notAllowedViolations) {
+        const normalizedFile = normalizePath(violation.file);
+        const lastSlash = normalizedFile.lastIndexOf('/');
+        const fileDir = lastSlash > 0 ? normalizedFile.slice(0, lastSlash) : '';
+        const fileName = lastSlash > 0 ? normalizedFile.slice(lastSlash + 1) : normalizedFile;
+        const isSiblingFile = allowedDirs.has(fileDir);
+        const isRelatedFile = 
+        // JS/TS
+        fileName.endsWith('.d.ts') ||
+            fileName.includes('.test.') ||
+            fileName.includes('.spec.') ||
+            fileName === 'index.ts' || fileName === 'index.tsx' || fileName === 'index.js' ||
+            fileName === 'types.ts' || fileName === 'types.tsx' ||
+            // Python
+            fileName === '__init__.py' || fileName === 'conftest.py' ||
+            fileName.startsWith('test_') || fileName.endsWith('_test.py') ||
+            // Rust
+            fileName === 'mod.rs' || fileName === 'lib.rs' || fileName === 'build.rs' ||
+            // Go
+            fileName === 'go.mod' || fileName === 'go.sum' ||
+            fileName.endsWith('_test.go') ||
+            // Java/Kotlin
+            fileName.endsWith('Test.java') || fileName.endsWith('Test.kt') ||
+            // C#
+            fileName.endsWith('.csproj') || fileName.endsWith('.sln') ||
+            fileName.endsWith('Tests.cs') || fileName.endsWith('Test.cs') ||
+            // Ruby
+            fileName.endsWith('_spec.rb') || fileName === 'Rakefile' || fileName === 'Gemfile.lock' ||
+            // Elixir
+            fileName.endsWith('_test.exs') || fileName === 'mix.lock' ||
+            // Swift
+            fileName === 'Package.swift' || fileName.endsWith('Tests.swift') ||
+            // Dart
+            fileName === 'pubspec.yaml' || fileName === 'pubspec.lock' ||
+            fileName.endsWith('_test.dart') ||
+            // Scala
+            fileName.endsWith('Spec.scala') || fileName.endsWith('Test.scala') ||
+            fileName === 'build.sbt' ||
+            // Haskell
+            fileName.endsWith('Spec.hs') || fileName === 'stack.yaml' ||
+            fileName.endsWith('.cabal') ||
+            // Zig
+            fileName === 'build.zig' || fileName === 'build.zig.zon' ||
+            // C/C++
+            fileName === 'CMakeLists.txt' || fileName === 'Makefile';
+        const isSubdirectory = [...allowedDirs].some(dir => fileDir.startsWith(dir + '/'));
+        const isRootConfig = !fileDir && /^(vitest|vite|jest|tsconfig|eslint|prettier|babel|rollup|webpack|next|tailwind|pyproject|setup|Cargo|go\.mod|go\.sum|Gemfile|mix|pom|build\.gradle|CMakeLists|Makefile)\b/.test(fileName);
+        if (isSiblingFile || isRelatedFile || isSubdirectory || isRootConfig) {
+            pathsToAdd.push(normalizedFile);
+        }
+    }
+    // Second pass: cross-directory within same top-level module
+    if (pathsToAdd.length < notAllowedViolations.length) {
+        const allowedTopDirs = new Set();
+        for (const dir of allowedDirs) {
+            const parts = dir.split('/');
+            if (parts.length >= 1)
+                allowedTopDirs.add(parts[0]);
+            if (parts.length >= 2)
+                allowedTopDirs.add(parts.slice(0, 2).join('/'));
+        }
+        const hasPackagesDir = [...allowedDirs].some(d => d.startsWith('packages/'));
+        if (hasPackagesDir)
+            allowedTopDirs.add('packages');
+        for (const violation of notAllowedViolations) {
+            const normalizedFile = normalizePath(violation.file);
+            if (pathsToAdd.includes(normalizedFile))
+                continue;
+            const fileParts = normalizedFile.split('/');
+            const fileTopDir = fileParts.length >= 2
+                ? fileParts.slice(0, 2).join('/')
+                : fileParts[0];
+            if (allowedTopDirs.has(fileTopDir) || allowedTopDirs.has(fileParts[0])) {
+                pathsToAdd.push(normalizedFile);
+            }
+        }
+    }
+    if (pathsToAdd.length === 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${notAllowedViolations.length} file(s) in unrelated directories`,
+        };
+    }
+    if (pathsToAdd.length > maxExpansions) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${pathsToAdd.length} files need expansion (max: ${maxExpansions})`,
+        };
+    }
+    const expandedPaths = [...new Set([...currentAllowedPaths, ...pathsToAdd])];
+    return {
+        canExpand: true,
+        expandedPaths,
+        addedPaths: pathsToAdd,
+    };
+}
+// ---------------------------------------------------------------------------
+// Git status parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse git status --porcelain output to get changed file paths.
+ */
+export function parseChangedFiles(statusOutput) {
+    if (!statusOutput.trim())
+        return [];
+    return statusOutput
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => {
+        // Format: XY filename or XY original -> renamed
+        // eslint-disable-next-line security/detect-unsafe-regex
+        const match = line.match(/^..\s+(.+?)(?:\s+->\s+(.+))?$/);
+        if (!match)
+            return null;
+        return match[2] || match[1];
+    })
+        .filter((f) => f !== null);
+}
+//# sourceMappingURL=shared.js.map

package/dist/scope/shared.js.map

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

package/dist/scout/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Scout service - Analyzes codebases and generates improvement proposals
+ *
+ * This is the core scout implementation that works with any DatabaseAdapter.
+ */
+import type { ScoutOptions, ScoutResult } from './types.js';
+export * from './types.js';
+export { buildScoutPrompt, buildCategoryPrompt } from './prompt.js';
+export { runClaude, parseClaudeOutput, ClaudeScoutBackend, CodexScoutBackend, CodexMcpScoutBackend, type ScoutBackend } from './runner.js';
+export { KimiScoutBackend } from './kimi-runner.js';
+export { OpenAILocalScoutBackend } from './openai-local-runner.js';
+export { McpBatchServer } from './mcp-batch-server.js';
+export { scanFiles, batchFiles, batchFilesByTokens, batchFilesByModule, estimateTokens, type ScannedFile, type ModuleGroup } from './scanner.js';
+/**
+ * Scout a codebase for improvement opportunities
+ */
+export declare function scout(options: ScoutOptions): Promise<ScoutResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scout/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAIZ,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3I,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAiOjJ;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6QvE"}