phantom-pr 0.1.0

package/dist/core/context/packer.d.ts

@@ -0,0 +1,31 @@
+import type { ContextBudgets, ContextPack } from './types.js';
+type Boundary = {
+    kind: 'js' | 'py' | 'unknown';
+    rootPathPosix: string | null;
+    boundaryFileRel: string | null;
+};
+export declare function buildContextPack(input: {
+    rootAbs: string;
+    targetId: string;
+    targetPathPosix: string;
+    boundary: Boundary;
+    inferred: {
+        runner: string;
+        command: string | null;
+        source: string;
+        reason: string;
+    };
+    observed: {
+        runner: string;
+        hints: {
+            failingFiles: string[];
+            failingTests: string[];
+        };
+    } | null;
+    budgets: ContextBudgets;
+    nowMs: () => number;
+    readFileText: (absPath: string) => Promise<string>;
+    listIndexFiles?: () => Promise<string[]>;
+    redact: (s: string) => string;
+}): Promise<ContextPack>;
+export {};

package/dist/core/context/packer.js

@@ -0,0 +1,345 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+function toPosix(p) {
+    return p.replace(/\\/g, '/');
+}
+function normalizeRelPosix(p) {
+    let x = toPosix(p).trim();
+    if (x.startsWith('./'))
+        x = x.slice(2);
+    x = path.posix.normalize(x);
+    if (x === '.')
+        x = '';
+    return x;
+}
+function uniqSorted(xs) {
+    return [...new Set(xs.map((x) => x.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
+}
+function sha256_8(text) {
+    return crypto.createHash('sha256').update(text).digest('hex').slice(0, 8);
+}
+function sanitizeText(text) {
+    // Replace null bytes and other control chars with spaces (deterministic).
+    return text.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, ' ');
+}
+function isInsideRoot(rootAbs, absPath) {
+    const rel = path.relative(rootAbs, absPath);
+    if (!rel)
+        return true;
+    const norm = rel.replace(/\\/g, '/');
+    return !norm.startsWith('../') && norm !== '..';
+}
+function absFromMaybePath(rootAbs, p) {
+    const looksAbs = path.isAbsolute(p) || /^[A-Za-z]:[\\/]/.test(p);
+    return looksAbs ? path.resolve(p) : path.resolve(rootAbs, p);
+}
+function isSensitivePath(pathPosix) {
+    const p = pathPosix.replace(/\\/g, '/');
+    const lower = p.toLowerCase();
+    const base = path.posix.basename(lower);
+    if (base === '.env')
+        return true;
+    if (base === '.npmrc')
+        return true;
+    if (base === 'id_rsa')
+        return true;
+    if (base.endsWith('.pem'))
+        return true;
+    if (base.endsWith('.key'))
+        return true;
+    if (lower.includes('secrets'))
+        return true;
+    if (lower === '.git/config' || lower.endsWith('/.git/config'))
+        return true;
+    return false;
+}
+function kindOrder(k) {
+    switch (k) {
+        case 'target':
+            return 0;
+        case 'test':
+            return 1;
+        case 'neighbor':
+            return 2;
+        case 'config':
+            return 3;
+        case 'readme':
+            return 4;
+        default:
+            return 5;
+    }
+}
+function extractRelativeImportsJsTs(source) {
+    const out = [];
+    // import ... from '...'
+    for (const m of source.matchAll(/\bimport\s+[^;]*?\s+from\s+['"]([^'"]+)['"]/g)) {
+        const spec = m[1] ?? '';
+        if (spec.startsWith('.'))
+            out.push(spec);
+    }
+    // require('...')
+    for (const m of source.matchAll(/\brequire\(\s*['"]([^'"]+)['"]\s*\)/g)) {
+        const spec = m[1] ?? '';
+        if (spec.startsWith('.'))
+            out.push(spec);
+    }
+    return uniqSorted(out);
+}
+const RESOLVE_EXTS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json'];
+async function resolveRelativeImport(opts) {
+    const fromDir = path.posix.dirname(opts.fromFilePosix);
+    const specPosix = toPosix(opts.spec);
+    const joined = normalizeRelPosix(path.posix.join(fromDir, specPosix));
+    if (!joined)
+        return null;
+    const hasExt = path.posix.extname(joined) !== '';
+    const candidates = [];
+    if (hasExt)
+        candidates.push(joined);
+    else
+        for (const ext of RESOLVE_EXTS)
+            candidates.push(`${joined}${ext}`);
+    for (const rel of candidates) {
+        // Never traverse node_modules (defensive; relative paths shouldn’t hit it, but keep safe).
+        if (rel.split('/').includes('node_modules'))
+            continue;
+        const abs = path.resolve(opts.rootAbs, ...rel.split('/'));
+        if (!isInsideRoot(opts.rootAbs, abs))
+            continue;
+        const text = await opts.readTextCached(abs);
+        if (text != null)
+            return rel;
+    }
+    return null;
+}
+function pickNearestTestsFromIndex(opts) {
+    const targetDir = path.posix.dirname(opts.targetPathPosix);
+    const prefix = targetDir === '.' ? '' : `${targetDir.replace(/\/+$/, '')}/`;
+    const isTest = (p) => p.includes('__tests__/') || /\.[Tt]est\./.test(p);
+    const candidates = opts.indexPaths
+        .map((p) => normalizeRelPosix(p))
+        .filter((p) => (prefix ? p.startsWith(prefix) : true))
+        .filter(isTest);
+    const depth = (p) => p.split('/').filter(Boolean).length;
+    const baseDepth = prefix ? depth(prefix) : 0;
+    candidates.sort((a, b) => {
+        const da = Math.max(0, depth(a) - baseDepth);
+        const db = Math.max(0, depth(b) - baseDepth);
+        if (da !== db)
+            return da - db;
+        return a.localeCompare(b);
+    });
+    return candidates.slice(0, Math.max(0, opts.max));
+}
+export async function buildContextPack(input) {
+    const rootAbs = path.resolve(input.rootAbs);
+    const budgets = {
+        maxFiles: Math.max(1, Math.trunc(input.budgets.maxFiles)),
+        maxChars: Math.max(1, Math.trunc(input.budgets.maxChars)),
+        maxDepth: Math.max(0, Math.trunc(input.budgets.maxDepth)),
+        maxFileChars: Math.max(1, Math.trunc(input.budgets.maxFileChars)),
+    };
+    const warnings = [];
+    let charsUsed = 0;
+    let hitMaxFiles = false;
+    let hitMaxChars = false;
+    // Cache reads to avoid double I/O and keep deterministic behavior.
+    const readCache = new Map();
+    const readTextCached = async (abs) => {
+        const key = path.resolve(abs);
+        const existing = readCache.get(key);
+        if (existing)
+            return existing;
+        const p = (async () => {
+            try {
+                const t = await input.readFileText(key);
+                return t;
+            }
+            catch {
+                return null;
+            }
+        })();
+        readCache.set(key, p);
+        return p;
+    };
+    const included = new Map(); // pathPosix -> file
+    const includeFile = async (pathPosixRaw, kind) => {
+        const pathPosix = normalizeRelPosix(pathPosixRaw);
+        if (!pathPosix)
+            return;
+        if (included.has(pathPosix))
+            return;
+        if (isSensitivePath(pathPosix)) {
+            warnings.push(`deny_sensitive:${pathPosix}`);
+            return;
+        }
+        if (included.size >= budgets.maxFiles) {
+            hitMaxFiles = true;
+            return;
+        }
+        const abs = path.resolve(rootAbs, ...pathPosix.split('/'));
+        if (!isInsideRoot(rootAbs, abs))
+            return;
+        const raw = await readTextCached(abs);
+        if (raw == null)
+            return;
+        let content = input.redact(sanitizeText(raw));
+        let truncated = false;
+        if (content.length > budgets.maxFileChars) {
+            content = content.slice(0, budgets.maxFileChars);
+            truncated = true;
+            warnings.push(`file_truncated:${pathPosix}`);
+        }
+        const remaining = budgets.maxChars - charsUsed;
+        if (remaining <= 0) {
+            hitMaxChars = true;
+            return;
+        }
+        if (content.length > remaining) {
+            content = content.slice(0, remaining);
+            truncated = true;
+            hitMaxChars = true;
+            warnings.push(`file_truncated:${pathPosix}`);
+        }
+        charsUsed += content.length;
+        included.set(pathPosix, {
+            pathPosix,
+            kind,
+            sha256_8: sha256_8(content),
+            truncated,
+            content,
+        });
+    };
+    // 1) Always include target
+    await includeFile(input.targetPathPosix, 'target');
+    // 2) Related tests
+    const observedHints = input.observed?.hints ?? null;
+    if (observedHints && observedHints.failingFiles.length > 0) {
+        const candidates = uniqSorted(observedHints.failingFiles);
+        for (const p of candidates) {
+            const abs = absFromMaybePath(rootAbs, p);
+            if (!isInsideRoot(rootAbs, abs))
+                continue;
+            const rel = normalizeRelPosix(toPosix(path.relative(rootAbs, abs)));
+            if (!rel)
+                continue;
+            await includeFile(rel, 'test');
+            if (included.size >= budgets.maxFiles)
+                break;
+            if (charsUsed >= budgets.maxChars)
+                break;
+        }
+    }
+    else if (input.listIndexFiles) {
+        try {
+            const indexFiles = await input.listIndexFiles();
+            const nearest = pickNearestTestsFromIndex({ targetPathPosix: input.targetPathPosix, indexPaths: indexFiles, max: 3 });
+            for (const p of nearest) {
+                await includeFile(p, 'test');
+            }
+        }
+        catch {
+            // ignore: optional signal
+        }
+    }
+    // 3) Minimal repo config files
+    const boundaryRootPosix = input.boundary.rootPathPosix ? normalizeRelPosix(input.boundary.rootPathPosix) : '';
+    const boundaryAbs = boundaryRootPosix ? path.resolve(rootAbs, ...boundaryRootPosix.split('/')) : rootAbs;
+    const configCandidates = [];
+    configCandidates.push('package.json', 'tsconfig.json');
+    configCandidates.push('jest.config.js', 'jest.config.ts', 'jest.config.cjs', 'jest.config.mjs');
+    configCandidates.push('vitest.config.js', 'vitest.config.ts', 'vitest.config.cjs', 'vitest.config.mjs');
+    if (input.boundary.kind === 'py')
+        configCandidates.push('pyproject.toml', 'pytest.ini', 'setup.cfg');
+    for (const name of configCandidates) {
+        const abs = path.resolve(boundaryAbs, name);
+        if (!isInsideRoot(rootAbs, abs))
+            continue;
+        const rel = normalizeRelPosix(toPosix(path.relative(rootAbs, abs)));
+        await includeFile(rel, 'config');
+    }
+    // 4) README at boundary root
+    {
+        const abs = path.resolve(boundaryAbs, 'README.md');
+        const rel = normalizeRelPosix(toPosix(path.relative(rootAbs, abs)));
+        await includeFile(rel, 'readme');
+    }
+    // 5) Neighbor imports (JS/TS only), BFS up to maxDepth
+    const targetExt = path.posix.extname(normalizeRelPosix(input.targetPathPosix)).toLowerCase();
+    const canTraverse = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(targetExt);
+    if (canTraverse && budgets.maxDepth > 0) {
+        const seen = new Set();
+        let frontier = [normalizeRelPosix(input.targetPathPosix)];
+        seen.add(frontier[0] ?? '');
+        for (let depth = 1; depth <= budgets.maxDepth; depth++) {
+            const next = [];
+            frontier.sort((a, b) => a.localeCompare(b));
+            for (const filePosix of frontier) {
+                const abs = path.resolve(rootAbs, ...filePosix.split('/'));
+                const raw = await readTextCached(abs);
+                if (raw == null)
+                    continue;
+                const textForParse = input.redact(sanitizeText(raw)).slice(0, budgets.maxFileChars);
+                const relImports = extractRelativeImportsJsTs(textForParse);
+                for (const spec of relImports) {
+                    const resolved = await resolveRelativeImport({
+                        fromFilePosix: filePosix,
+                        spec,
+                        rootAbs,
+                        readTextCached,
+                    });
+                    if (!resolved)
+                        continue;
+                    if (seen.has(resolved))
+                        continue;
+                    seen.add(resolved);
+                    next.push(resolved);
+                }
+            }
+            const uniqNext = uniqSorted(next);
+            for (const p of uniqNext) {
+                await includeFile(p, 'neighbor');
+            }
+            frontier = uniqNext;
+            if (included.size >= budgets.maxFiles)
+                break;
+            if (charsUsed >= budgets.maxChars)
+                break;
+            if (frontier.length === 0)
+                break;
+        }
+    }
+    if (hitMaxFiles)
+        warnings.push('budget_hit_maxFiles');
+    if (hitMaxChars)
+        warnings.push('budget_hit_maxChars');
+    const files = [...included.values()].sort((a, b) => {
+        const ka = kindOrder(a.kind);
+        const kb = kindOrder(b.kind);
+        if (ka !== kb)
+            return ka - kb;
+        return a.pathPosix.localeCompare(b.pathPosix);
+    });
+    return {
+        schemaVersion: 1,
+        createdAtMs: Math.trunc(input.nowMs()),
+        rootPathPosix: input.boundary.rootPathPosix ? normalizeRelPosix(input.boundary.rootPathPosix) : null,
+        targetId: input.targetId,
+        targetPathPosix: normalizeRelPosix(input.targetPathPosix),
+        boundary: input.boundary,
+        runnerInferred: input.inferred.runner,
+        runnerObserved: input.observed?.runner ?? null,
+        testCommandUsed: input.inferred.command,
+        budgets,
+        usage: {
+            filesUsed: files.length,
+            charsUsed,
+            hitMaxFiles,
+            hitMaxChars,
+        },
+        hints: observedHints ? { failingFiles: uniqSorted(observedHints.failingFiles), failingTests: uniqSorted(observedHints.failingTests) } : null,
+        files,
+        warnings: uniqSorted(warnings),
+    };
+}
+//# sourceMappingURL=packer.js.map

package/dist/core/context/packer.js.map

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

package/dist/core/context/types.d.ts

@@ -0,0 +1,41 @@
+export type ContextBudgets = {
+    maxFiles: number;
+    maxChars: number;
+    maxDepth: number;
+    maxFileChars: number;
+};
+export type ContextFile = {
+    pathPosix: string;
+    kind: 'target' | 'test' | 'neighbor' | 'config' | 'readme' | 'other';
+    sha256_8: string;
+    truncated: boolean;
+    content: string;
+};
+export type ContextPack = {
+    schemaVersion: 1;
+    createdAtMs: number;
+    rootPathPosix: string | null;
+    targetId: string;
+    targetPathPosix: string;
+    boundary: {
+        kind: 'js' | 'py' | 'unknown';
+        rootPathPosix: string | null;
+        boundaryFileRel: string | null;
+    };
+    runnerInferred: string;
+    runnerObserved: string | null;
+    testCommandUsed: string | null;
+    budgets: ContextBudgets;
+    usage: {
+        filesUsed: number;
+        charsUsed: number;
+        hitMaxFiles: boolean;
+        hitMaxChars: boolean;
+    };
+    hints: {
+        failingFiles: string[];
+        failingTests: string[];
+    } | null;
+    files: ContextFile[];
+    warnings: string[];
+};

package/dist/core/context/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/context/types.ts"],"names":[],"mappings":""}

package/dist/core/converge/loop.d.ts

@@ -0,0 +1,13 @@
+import type { JestFailure } from '../jest/parser.js';
+import type { ConvergeReport } from './types.js';
+export type ConvergeRunnerResult = {
+    exitCode: number | null;
+    timedOut: boolean;
+    durationMs: number;
+    output: string;
+};
+export declare function runConvergeLoop(opts: {
+    maxIterations: number;
+    runOnce: (attempt: number) => Promise<ConvergeRunnerResult>;
+    parseFailures: (output: string) => JestFailure[];
+}): Promise<ConvergeReport>;

package/dist/core/converge/loop.js

@@ -0,0 +1,35 @@
+export async function runConvergeLoop(opts) {
+    const maxIterations = Math.max(1, Math.trunc(opts.maxIterations));
+    const attempts = [];
+    let stopReason = 'max_iterations';
+    for (let attempt = 1; attempt <= maxIterations; attempt++) {
+        const r = await opts.runOnce(attempt);
+        const failures = opts.parseFailures(r.output);
+        attempts.push({
+            attempt,
+            exitCode: r.exitCode,
+            timedOut: r.timedOut,
+            durationMs: r.durationMs,
+            failures,
+        });
+        if (r.exitCode === 0) {
+            stopReason = 'passed';
+            break;
+        }
+        if (r.timedOut) {
+            stopReason = 'timeout';
+            break;
+        }
+        if (r.exitCode === null) {
+            stopReason = 'runner_error';
+            break;
+        }
+        if (attempt === maxIterations) {
+            stopReason = 'max_iterations';
+            break;
+        }
+        // MVP: no codegen or plan changes; just framework + reporting.
+    }
+    return { schemaVersion: 1, maxIterations, stopReason, attempts };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/converge/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/core/converge/loop.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAIrC;IACC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,IAAI,UAAU,GAAuB,gBAAgB,CAAC;IAEtD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAE9C,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO;YACP,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ;SACT,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACrB,UAAU,GAAG,QAAQ,CAAC;YACtB,MAAM;QACR,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,UAAU,GAAG,SAAS,CAAC;YACvB,MAAM;QACR,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxB,UAAU,GAAG,cAAc,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC9B,UAAU,GAAG,gBAAgB,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,+DAA+D;IACjE,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACnE,CAAC"}

package/dist/core/converge/types.d.ts

@@ -0,0 +1,15 @@
+import type { JestFailure } from '../jest/parser.js';
+export type ConvergeStopReason = 'passed' | 'max_iterations' | 'timeout' | 'runner_error';
+export type ConvergeAttempt = {
+    attempt: number;
+    exitCode: number | null;
+    timedOut: boolean;
+    durationMs: number;
+    failures: JestFailure[];
+};
+export type ConvergeReport = {
+    schemaVersion: 1;
+    maxIterations: number;
+    stopReason: ConvergeStopReason;
+    attempts: ConvergeAttempt[];
+};

package/dist/core/converge/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/converge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/converge/types.ts"],"names":[],"mappings":""}

package/dist/core/generator/llm/diffApply.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Unified diff parsing and application for LLM-generated test patches.
+ * Deterministic, fail-closed: rejects invalid, unsafe, or out-of-scope patches.
+ */
+export declare function toPosix(p: string): string;
+export declare function isAllowedTestPathForRunner(runner: string, pathPosix: string): boolean;
+export declare function isAllowedFixturePath(pathPosix: string): boolean;
+export declare function applyUnifiedDiffToTestFiles(opts: {
+    rootAbs: string;
+    boundaryRootPosix: string | null;
+    runner: string;
+    diffText: string;
+    tuning: {
+        minTestCases: number;
+        maxTestCases: number;
+        minExpectCalls: number;
+    };
+    targetExportNames: readonly string[];
+    targetModuleStem: string;
+    targetSource?: string | null;
+}): {
+    ok: boolean;
+    warnings: string[];
+    pathsPosix: string[];
+    createdPathsPosix: string[];
+};