@promptwheel/core 0.6.0

package/dist/codebase-index/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pre-Scout Codebase Index — lightweight structural map built at session start.
+ *
+ * Walks directories 2 levels deep using `fs` only. No AST parsing, no heavy deps.
+ * Provides module map, dependency edges, test gaps, complexity hotspots, and entrypoints.
+ *
+ * Pure algorithms (classification, import extraction, formatting) live in ./shared.ts.
+ * This file provides the I/O-heavy functions that use the filesystem and git.
+ *
+ * Single source of truth — imported by both @promptwheel/cli and @promptwheel/mcp.
+ */
+export { type CodebaseIndex, type ClassificationConfidence, type ModuleEntry, type LargeFileEntry, type ClassifyResult, SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, } from './shared.js';
+import type { CodebaseIndex } from './shared.js';
+/**
+ * Use `git ls-files` to discover which top-level directories contain tracked
+ * (or unignored) files. Returns null if git is unavailable or the project
+ * is not a git repo — callers should fall back to hardcoded excludes.
+ */
+export declare function getTrackedDirectories(projectRoot: string): Set<string> | null;
+export declare function buildCodebaseIndex(projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean): CodebaseIndex;
+export declare function refreshCodebaseIndex(existing: CodebaseIndex, projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean): CodebaseIndex;
+export declare function hasStructuralChanges(index: CodebaseIndex, projectRoot: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/codebase-index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codebase-index/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,aAAa,CAAC;AAyC9E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAe7E;AAMD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,GACpB,aAAa,CAkPf;AAMD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,GACpB,aAAa,CAwBf;AAMD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAuCT"}

package/dist/codebase-index/index.js

@@ -0,0 +1,361 @@
+/**
+ * Pre-Scout Codebase Index — lightweight structural map built at session start.
+ *
+ * Walks directories 2 levels deep using `fs` only. No AST parsing, no heavy deps.
+ * Provides module map, dependency edges, test gaps, complexity hotspots, and entrypoints.
+ *
+ * Pure algorithms (classification, import extraction, formatting) live in ./shared.ts.
+ * This file provides the I/O-heavy functions that use the filesystem and git.
+ *
+ * Single source of truth — imported by both @promptwheel/cli and @promptwheel/mcp.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+// Re-export everything from shared (pure algorithms + types + constants)
+export { SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, } from './shared.js';
+import { SOURCE_EXTENSIONS, sampleEvenly, classifyModule, extractImports, resolveImportToModule, } from './shared.js';
+// ---------------------------------------------------------------------------
+// I/O helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a short header snippet from a file (first 512 bytes, ~12 lines).
+ * Cheaper than the full 4KB read used for import scanning.
+ */
+function readHeader(filePath) {
+    try {
+        const fd = fs.openSync(filePath, 'r');
+        const buf = Buffer.alloc(512);
+        const bytesRead = fs.readSync(fd, buf, 0, 512, 0);
+        fs.closeSync(fd);
+        return buf.toString('utf8', 0, bytesRead);
+    }
+    catch {
+        return null;
+    }
+}
+function existsDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Git-aware directory filtering
+// ---------------------------------------------------------------------------
+/**
+ * Use `git ls-files` to discover which top-level directories contain tracked
+ * (or unignored) files. Returns null if git is unavailable or the project
+ * is not a git repo — callers should fall back to hardcoded excludes.
+ */
+export function getTrackedDirectories(projectRoot) {
+    try {
+        const stdout = execFileSync('git', ['ls-files', '--cached', '--others', '--exclude-standard'], {
+            cwd: projectRoot, maxBuffer: 10 * 1024 * 1024, encoding: 'utf8',
+        });
+        const dirs = new Set();
+        for (const line of stdout.split('\n')) {
+            if (!line)
+                continue;
+            const parts = line.split('/');
+            if (parts.length > 1)
+                dirs.add(parts[0]);
+        }
+        return dirs;
+    }
+    catch {
+        return null; // Not a git repo or git not available
+    }
+}
+// ---------------------------------------------------------------------------
+// buildCodebaseIndex
+// ---------------------------------------------------------------------------
+export function buildCodebaseIndex(projectRoot, excludeDirs = [], useGitTracking = true) {
+    const excludeSet = new Set(excludeDirs.map(d => d.toLowerCase()));
+    // Git-aware filtering: only walk directories that contain tracked files
+    const trackedDirs = useGitTracking ? getTrackedDirectories(projectRoot) : null;
+    // Step 1: Module map — walk dirs 2 levels deep
+    const modules = [];
+    const sourceFilesByModule = new Map();
+    function shouldExclude(name) {
+        if (excludeSet.has(name.toLowerCase()) || name.startsWith('.'))
+            return true;
+        return false;
+    }
+    function walkForModules(dir, depth) {
+        if (modules.length >= 80)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        const sourceFiles = [];
+        const subdirs = [];
+        for (const entry of entries) {
+            if (entry.isFile() && SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+                sourceFiles.push(path.join(dir, entry.name));
+            }
+            else if (entry.isDirectory() && !shouldExclude(entry.name)) {
+                // At depth 0 (project root), skip directories not tracked by git
+                if (depth === 0 && trackedDirs && !trackedDirs.has(entry.name)) {
+                    continue;
+                }
+                subdirs.push(entry);
+            }
+        }
+        // Register this dir as a module if it has source files
+        if (sourceFiles.length > 0 && depth > 0) {
+            const relPath = path.relative(projectRoot, dir);
+            if (relPath && modules.length < 80) {
+                // Placeholder — classified after import scanning (Step 2)
+                modules.push({
+                    path: relPath,
+                    file_count: sourceFiles.length,
+                    production_file_count: sourceFiles.length,
+                    purpose: 'unknown',
+                    production: true,
+                    classification_confidence: 'low',
+                });
+                sourceFilesByModule.set(relPath, sourceFiles);
+            }
+        }
+        // Recurse into subdirs (up to depth 2)
+        if (depth < 3) {
+            for (const sub of subdirs) {
+                if (modules.length >= 80)
+                    break;
+                walkForModules(path.join(dir, sub.name), depth + 1);
+            }
+        }
+    }
+    walkForModules(projectRoot, 0);
+    const modulePaths = modules.map(m => m.path);
+    // Step 2: Import scanning + content sampling — build dependency_edges, classify modules
+    const dependencyEdges = {};
+    const sampledFileMtimes = {};
+    const contentByModule = new Map();
+    for (const mod of modules) {
+        const files = sourceFilesByModule.get(mod.path) ?? [];
+        const deps = new Set();
+        const snippets = [];
+        // Sample up to 5 files evenly for full import scanning (4KB read)
+        const filesToScan = sampleEvenly(files, 5);
+        for (const filePath of filesToScan) {
+            try {
+                // Record mtime for change detection
+                const relFile = path.relative(projectRoot, filePath);
+                sampledFileMtimes[relFile] = fs.statSync(filePath).mtimeMs;
+                const fd = fs.openSync(filePath, 'r');
+                const buf = Buffer.alloc(4096);
+                const bytesRead = fs.readSync(fd, buf, 0, 4096, 0);
+                fs.closeSync(fd);
+                // Skip binary files (check for null bytes in first 512 bytes of actual content)
+                const checkLen = Math.min(bytesRead, 512);
+                if (checkLen > 0 && buf.subarray(0, checkLen).indexOf(0) !== -1)
+                    continue;
+                const content = buf.toString('utf8', 0, bytesRead);
+                // Trim to ~50 lines
+                const lines = content.split('\n').slice(0, 50).join('\n');
+                snippets.push(lines);
+                const imports = extractImports(lines, filePath);
+                for (const spec of imports) {
+                    const resolved = resolveImportToModule(spec, filePath, projectRoot, modulePaths);
+                    if (resolved && resolved !== mod.path) {
+                        deps.add(resolved);
+                    }
+                }
+            }
+            catch {
+                // skip unreadable files
+            }
+        }
+        // Sample additional files for classification (header-only, 512B — cheap)
+        const scannedSet = new Set(filesToScan);
+        const extraFiles = sampleEvenly(files.filter(f => !scannedSet.has(f)), 10);
+        for (const filePath of extraFiles) {
+            const header = readHeader(filePath);
+            if (header)
+                snippets.push(header);
+        }
+        contentByModule.set(mod.path, snippets);
+        if (deps.size > 0) {
+            dependencyEdges[mod.path] = [...deps];
+        }
+    }
+    // Step 2b: Classify modules using ALL file names + sampled content
+    for (const mod of modules) {
+        const files = sourceFilesByModule.get(mod.path) ?? [];
+        const allFileNames = files.map(f => path.basename(f));
+        const snippets = contentByModule.get(mod.path) ?? [];
+        const { purpose, production, productionFileCount, confidence } = classifyModule(path.basename(path.join(projectRoot, mod.path)), allFileNames, snippets, mod.file_count);
+        mod.purpose = purpose;
+        mod.production = production;
+        mod.production_file_count = productionFileCount;
+        mod.classification_confidence = confidence;
+    }
+    // Step 3: Test coverage — find untested modules
+    const untestedModules = [];
+    for (const mod of modules) {
+        if (mod.purpose === 'tests')
+            continue;
+        const modAbsPath = path.join(projectRoot, mod.path);
+        const modParent = path.dirname(modAbsPath);
+        let hasTesting = false;
+        if (existsDir(path.join(modAbsPath, '__tests__'))) {
+            hasTesting = true;
+        }
+        if (!hasTesting && (existsDir(path.join(modParent, 'test')) || existsDir(path.join(modParent, 'tests')))) {
+            hasTesting = true;
+        }
+        if (!hasTesting) {
+            const files = sourceFilesByModule.get(mod.path) ?? [];
+            hasTesting = files.some(f => {
+                const base = path.basename(f);
+                return base.includes('.test.') || base.includes('.spec.');
+            });
+        }
+        if (!hasTesting) {
+            untestedModules.push(mod.path);
+        }
+    }
+    // Step 4: Large files — stat.size / 40 heuristic for LOC
+    const largeFiles = [];
+    for (const mod of modules) {
+        const files = sourceFilesByModule.get(mod.path) ?? [];
+        for (const filePath of files) {
+            if (largeFiles.length >= 20)
+                break;
+            try {
+                const stat = fs.statSync(filePath);
+                // Heuristic: ~45 bytes/line for code (accounts for indentation)
+                const estimatedLines = Math.round(stat.size / 45);
+                if (estimatedLines > 300) {
+                    largeFiles.push({
+                        path: path.relative(projectRoot, filePath),
+                        lines: estimatedLines,
+                    });
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+        if (largeFiles.length >= 20)
+            break;
+    }
+    // Step 5: Entrypoints
+    const entrypoints = [];
+    const entrypointNames = [
+        'index.ts', 'index.js', 'main.ts', 'main.js',
+        'app.ts', 'app.js', 'server.ts', 'server.js',
+        'main.py', 'app.py', 'manage.py', 'wsgi.py',
+        'main.go',
+        'main.rs', 'lib.rs',
+        'index.php', 'artisan',
+        'main.swift',
+        'main.rb', 'config/application.rb',
+        'main.ex', 'lib.ex',
+        'main.dart', 'lib/main.dart',
+        'Main.java', 'Application.java',
+        'Program.cs', 'Main.cs', // C#
+        'Main.scala', // Scala
+        'main.c', 'main.cpp',
+        'Main.hs',
+        'main.zig',
+    ];
+    const searchDirs = [projectRoot, path.join(projectRoot, 'src'), path.join(projectRoot, 'cmd')];
+    for (const dir of searchDirs) {
+        for (const name of entrypointNames) {
+            if (entrypoints.length >= 10)
+                break;
+            const full = path.join(dir, name);
+            try {
+                if (fs.statSync(full).isFile()) {
+                    entrypoints.push(path.relative(projectRoot, full));
+                }
+            }
+            catch {
+                // doesn't exist
+            }
+        }
+    }
+    return {
+        built_at: new Date().toISOString(),
+        modules,
+        dependency_edges: dependencyEdges,
+        untested_modules: untestedModules,
+        large_files: largeFiles,
+        entrypoints,
+        sampled_file_mtimes: sampledFileMtimes,
+    };
+}
+// ---------------------------------------------------------------------------
+// refreshCodebaseIndex
+// ---------------------------------------------------------------------------
+export function refreshCodebaseIndex(existing, projectRoot, excludeDirs = [], useGitTracking = true) {
+    const fresh = buildCodebaseIndex(projectRoot, excludeDirs, useGitTracking);
+    const oldByPath = new Map(existing.modules.map(m => [m.path, m]));
+    const mergedEdges = {};
+    for (const mod of fresh.modules) {
+        const old = oldByPath.get(mod.path);
+        if (old && old.file_count === mod.file_count) {
+            const oldEdges = existing.dependency_edges[mod.path];
+            if (oldEdges) {
+                mergedEdges[mod.path] = oldEdges;
+            }
+        }
+        else {
+            const freshEdges = fresh.dependency_edges[mod.path];
+            if (freshEdges) {
+                mergedEdges[mod.path] = freshEdges;
+            }
+        }
+    }
+    fresh.dependency_edges = mergedEdges;
+    return fresh;
+}
+// ---------------------------------------------------------------------------
+// hasStructuralChanges
+// ---------------------------------------------------------------------------
+export function hasStructuralChanges(index, projectRoot) {
+    const builtAt = new Date(index.built_at).getTime();
+    const dirsToCheck = new Set();
+    for (const mod of index.modules) {
+        const absPath = path.join(projectRoot, mod.path);
+        dirsToCheck.add(absPath);
+        dirsToCheck.add(path.dirname(absPath));
+    }
+    dirsToCheck.add(projectRoot);
+    dirsToCheck.add(path.join(projectRoot, 'src'));
+    for (const dir of dirsToCheck) {
+        try {
+            if (fs.statSync(dir).mtimeMs > builtAt) {
+                return true;
+            }
+        }
+        catch {
+            const rel = path.relative(projectRoot, dir);
+            if (index.modules.some(m => m.path === rel)) {
+                return true;
+            }
+        }
+    }
+    for (const [relFile, oldMtime] of Object.entries(index.sampled_file_mtimes)) {
+        try {
+            const currentMtime = fs.statSync(path.join(projectRoot, relFile)).mtimeMs;
+            if (currentMtime !== oldMtime) {
+                return true;
+            }
+        }
+        catch {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/codebase-index/index.js.map

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

package/dist/codebase-index/shared.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Codebase index shared algorithms — pure functions for module classification,
+ * import extraction, dependency resolution, and prompt formatting.
+ *
+ * No filesystem, git, or child_process I/O. The I/O-heavy functions
+ * (buildCodebaseIndex, refreshCodebaseIndex, hasStructuralChanges) live
+ * in ./index.ts and import these pure algorithms.
+ */
+export interface CodebaseIndex {
+    built_at: string;
+    modules: ModuleEntry[];
+    dependency_edges: Record<string, string[]>;
+    untested_modules: string[];
+    large_files: LargeFileEntry[];
+    entrypoints: string[];
+    /** mtimes of files sampled for import scanning — used for change detection. Not included in prompt. */
+    sampled_file_mtimes: Record<string, number>;
+}
+export type ClassificationConfidence = 'high' | 'medium' | 'low';
+export interface ModuleEntry {
+    path: string;
+    file_count: number;
+    production_file_count: number;
+    purpose: string;
+    production: boolean;
+    /** How confident the classifier is. 'low' means no signals matched — assumed production. */
+    classification_confidence: ClassificationConfidence;
+}
+export interface LargeFileEntry {
+    path: string;
+    lines: number;
+}
+export interface ClassifyResult {
+    purpose: string;
+    production: boolean;
+    productionFileCount: number;
+    confidence: ClassificationConfidence;
+}
+export declare const SOURCE_EXTENSIONS: Set<string>;
+/** Directory-name hint — fast path when the name is unambiguous. */
+export declare const PURPOSE_HINT: Record<string, string>;
+export declare const NON_PRODUCTION_PURPOSES: Set<string>;
+/** Chunk size for prompt rendering. */
+export declare const CHUNK_SIZE = 15;
+/** File-name patterns that indicate non-production files (even within production modules). */
+export declare const NON_PROD_FILE_RE: RegExp;
+/**
+ * Polyglot test-content patterns — matches test framework calls across languages.
+ */
+export declare const TEST_CONTENT_RE: RegExp;
+export declare const GENERATED_RE: RegExp;
+export declare const CONFIG_CONTENT_RE: RegExp;
+export declare const CONFIG_EXT_RE: RegExp;
+export declare const FIXTURE_CONTENT_RE: RegExp;
+export declare const JS_IMPORT_RE: RegExp;
+export declare const PY_IMPORT_RE: RegExp;
+export declare const GO_IMPORT_RE: RegExp;
+/** Map directory name to a purpose hint. Returns 'unknown' if no match. */
+export declare function purposeHintFromDirName(dirName: string): string;
+/**
+ * Pick up to `count` items, evenly spaced across the array.
+ * Avoids alphabetical bias of always sampling the first N.
+ */
+export declare function sampleEvenly<T>(arr: T[], count: number): T[];
+/** Count non-production files by name pattern within a file list. */
+export declare function countNonProdFiles(fileNames: string[]): number;
+/**
+ * Classify a module by analyzing its file names and content snippets.
+ *
+ * Uses file-name patterns (checked against ALL files — cheap string matching)
+ * and content analysis (sampled snippets from evenly-distributed files).
+ *
+ * Thresholds use both ratio AND absolute count to avoid misclassifying
+ * large mixed modules (40% test in a 500-file module ≠ production).
+ */
+export declare function classifyModule(dirName: string, allFileNames: string[], contentSnippets: string[], totalFileCount: number): ClassifyResult;
+/**
+ * Extract import specifiers from file content using polyglot regex patterns.
+ * Supports JS/TS, Python, and Go.
+ */
+export declare function extractImports(content: string, filePath: string): string[];
+/**
+ * Resolve a relative import specifier to a module path relative to projectRoot.
+ * Returns null for non-relative (package) imports.
+ */
+export declare function resolveImportToModule(specifier: string, sourceFile: string, projectRoot: string, modulePaths: string[]): string | null;
+/**
+ * Format a codebase index for injection into a scout prompt.
+ *
+ * Chunks modules (15 per chunk) and rotates by cycle number so all modules
+ * get exposure over multiple cycles. Includes untested modules, hotspots,
+ * and entrypoints.
+ */
+export declare function formatIndexForPrompt(index: CodebaseIndex, scoutCycle: number): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/codebase-index/shared.d.ts.map

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