Function runCodexSandboxProbe

ai/scripts/diagnostics/bootstrapCodexSandbox.mjs:152–203

({
    projectRoot,
    probeId,
    DatabaseClass = Database,
    fsImpl        = fs,
    env           = process.env
} = {})

 * @returns {Object} Structured probe result.
 */
export function runCodexSandboxProbe({
    projectRoot,
    probeId,
    DatabaseClass = Database,
    fsImpl        = fs,
    env           = process.env
} = {}) {
    const paths           = buildProbePaths({projectRoot, probeId, fsImpl});
    const dirExistedBefore = fsImpl.existsSync(paths.logicalDir);
    const sandboxMode     = detectSandboxMode(env);

    let db = null;

    try {
        fsImpl.mkdirSync(paths.logicalDir, {recursive: true});
        db = new DatabaseClass(paths.probePath);
        db.exec?.('CREATE TABLE IF NOT EXISTS codex_sandbox_probe (id INTEGER PRIMARY KEY);');
        db.close?.();
        db = null;

        const cleanup = cleanupProbeArtifacts({
            probePath       : paths.probePath,
            logicalDir      : paths.logicalDir,
            removeCreatedDir: !dirExistedBefore,
            fsImpl
        });

        return {ok: true, paths, sandboxMode, cleanup};
    } catch (error) {
        try {
            db?.close?.();
        } catch {}

        const cleanup = cleanupProbeArtifacts({
            probePath       : paths.probePath,
            logicalDir      : paths.logicalDir,
            removeCreatedDir: !dirExistedBefore,
            fsImpl
        });

        return {
            ok: false,
            paths,
            sandboxMode,
            cleanup,
            error: {
                code   : error.code || error.name || 'UNKNOWN',
                message: error.message || String(error)
            }
        };
    }
}

/**
 * @summary Format the probe result for operator-facing CLI output.