windows-development-sandbox 1.4.1 → 1.5.0

package/dist/cli/tui/list-screen.js

@@ -1,299 +0,0 @@
-import { Text } from './text.js';
-import { Theme } from './theme.js';
-export class ListScreen {
-    o;
-    category = 0;
-    focus = 'list';
-    cursor = 0;
-    offset = 0;
-    query = '';
-    searching = false;
-    notice;
-    checked;
-    constructor(o) {
-        this.o = o;
-        this.notice = o.notice;
-        this.checked = new Set(o.items.flatMap((item, i) => (item.checked ? [i] : [])));
-        const start = o.startAt === undefined ? -1 : o.items.findIndex((item) => item.value === o.startAt);
-        const startCategory = start >= 0 ? o.items[start].category : o.startCategory;
-        if (o.categories && startCategory)
-            this.category = Math.max(0, o.categories.findIndex((c) => c.id === startCategory));
-        if (start >= 0)
-            this.cursor = Math.max(0, this.visible().indexOf(start));
-    }
-    /** Indexes of the entries shown now: all matches of the search, else the current category's, else all. */
-    visible() {
-        const all = this.o.items.map((_, i) => i);
-        if (this.query.trim()) {
-            const words = this.query.toLowerCase().split(/\s+/).filter(Boolean);
-            const label = (id) => this.o.categories?.find((c) => c.id === id)?.label ?? '';
-            return all.filter((i) => {
-                const it = this.o.items[i];
-                const hay = [it.label, Text.strip(it.hint ?? ''), it.description, it.keywords, it.section, label(it.category)].join(' ').toLowerCase();
-                return words.every((w) => hay.includes(w));
-            });
-        }
-        const cat = this.o.categories?.[this.category];
-        return cat ? all.filter((i) => this.o.items[i].category === cat.id) : all;
-    }
-    rows(visible) {
-        const rows = [];
-        let section;
-        const searchAll = Boolean(this.query.trim() && this.o.categories);
-        for (const index of visible) {
-            const it = this.o.items[index];
-            const heading = searchAll ? [this.o.categories?.find((c) => c.id === it.category)?.label, it.section].filter(Boolean).join(' › ') : it.section;
-            if (heading && heading !== section)
-                rows.push({ kind: 'section', text: heading });
-            section = heading;
-            rows.push({ kind: 'item', index });
-        }
-        return rows;
-    }
-    render(size) {
-        const visible = this.visible();
-        this.cursor = Math.min(this.cursor, Math.max(0, visible.length - 1));
-        const sideWidth = this.o.categories ? Math.min(32, Math.max(...this.o.categories.map((c) => Text.width(c.label))) + 7) : 0;
-        const rest = size.width - 1 - (sideWidth ? sideWidth + 3 : 0);
-        const detailsRight = rest >= 100;
-        const detailsWidth = detailsRight ? Math.min(52, Math.floor(rest * 0.38)) : rest;
-        const listWidth = detailsRight ? rest - detailsWidth - 3 : rest;
-        const top = [];
-        if (this.o.tabs)
-            top.push(' ' + this.o.tabs.items.map((tab, i) => (i === this.o.tabs.active ? tab.paint(' ' + tab.badge + ' ' + tab.label + ' ') : Theme.muted('  ' + tab.label + '  '))).join(' ') + Theme.muted('   tab switches'), '');
-        const intro = typeof this.o.intro === 'string' ? [this.o.intro] : this.o.intro ?? [];
-        for (const line of intro)
-            top.push(...Text.wrap(line, size.width - 3).map((l) => ' ' + Theme.muted(l)));
-        if (this.searching || this.query)
-            top.push(' ' + Theme.accent(Theme.glyph.search) + ' ' + this.query + (this.searching ? Theme.accent('▏') : '') + Theme.muted('   ' + visible.length + ' match' + (visible.length === 1 ? '' : 'es')));
-        if (top.length)
-            top.push('');
-        const details = this.detailsLines(visible[this.cursor], detailsWidth);
-        const bottomDetails = !detailsRight && size.height - top.length >= 14 ? details.slice(0, 6) : [];
-        const rows = this.rows(visible);
-        const room = size.height - top.length - (bottomDetails.length ? bottomDetails.length + 1 : 0);
-        // A list longer than the room keeps one row for "▲ / ▼ more".
-        const listHeight = rows.length > room ? room - 1 : room;
-        const cursorRow = rows.findIndex((r) => r.kind === 'item' && r.index === visible[this.cursor]);
-        if (cursorRow >= 0) {
-            // Keep the heading above the first entry in view, and the cursor inside the window.
-            const want = cursorRow > 0 && rows[cursorRow - 1].kind === 'section' ? cursorRow - 1 : cursorRow;
-            if (want < this.offset)
-                this.offset = want;
-            if (cursorRow >= this.offset + listHeight)
-                this.offset = cursorRow - listHeight + 1;
-        }
-        this.offset = Math.max(0, Math.min(this.offset, Math.max(0, rows.length - listHeight)));
-        const listLines = rows.slice(this.offset, this.offset + listHeight).map((row) => this.rowLine(row, visible, listWidth));
-        if (!visible.length)
-            listLines.push('', '  ' + Theme.muted(this.query ? 'Nothing matches "' + this.query + '".' : this.o.empty ?? 'Nothing here yet.'));
-        if (rows.length > listHeight) {
-            const above = this.offset;
-            const below = rows.length - this.offset - listHeight;
-            listLines.push(Theme.muted('   ' + (above > 0 ? '▲ ' + above + ' above' : '') + (above > 0 && below > 0 ? '   ' : '') + (below > 0 ? '▼ ' + below + ' more' : '')));
-        }
-        const sideLines = this.sideLines(sideWidth);
-        const body = [...top];
-        const height = Math.max(listLines.length, detailsRight ? details.length : 0, sideLines.length);
-        for (let i = 0; i < Math.min(height, size.height - top.length); i++) {
-            const side = sideWidth ? Text.fit(sideLines[i] ?? '', sideWidth) + ' ' + Theme.dim(Theme.glyph.vline) + ' ' : '';
-            const main = Text.fit(listLines[i] ?? '', listWidth);
-            const right = detailsRight ? ' ' + Theme.dim(Theme.glyph.vline) + ' ' + (details[i] ?? '') : '';
-            body.push(side + main + right);
-        }
-        if (bottomDetails.length) {
-            // The details sit at the bottom, whatever the length of the list.
-            while (body.length < size.height - bottomDetails.length - 1)
-                body.push(sideWidth ? Text.fit(sideLines[body.length - top.length] ?? '', sideWidth) + ' ' + Theme.dim(Theme.glyph.vline) : '');
-            body.push(Theme.dim(' ' + Theme.glyph.line.repeat(size.width - 3)), ...bottomDetails.map((l) => ' ' + l));
-        }
-        return { path: this.o.path, status: this.o.status, body, keys: this.keys(), notice: this.notice };
-    }
-    rowLine(row, visible, width) {
-        if (row.kind === 'section')
-            return ' ' + Theme.accentBold(row.text);
-        const it = this.o.items[row.index];
-        const selected = visible[this.cursor] === row.index;
-        const box = this.o.multi ? (this.checked.has(row.index) ? Theme.ok(Theme.glyph.checked) : Theme.muted(Theme.glyph.unchecked)) + ' ' : '';
-        const icon = it.icon ? it.icon + ' ' : '';
-        const hint = it.hint ?? '';
-        const hintWidth = Math.min(Text.width(hint), Math.floor(width * 0.5));
-        const labelWidth = width - 4 - Text.width(box) - Text.width(icon) - (hintWidth ? hintWidth + 2 : 0);
-        const label = it.disabled ? Theme.muted(it.label) : it.label;
-        const line = (selected ? Theme.glyph.pointer : ' ') + ' ' + box + icon + Text.fit(label, labelWidth) + (hintWidth ? '  ' + Text.fit(hint, hintWidth, 'right') : '') + ' ';
-        if (!selected)
-            return ' ' + line;
-        return this.focus === 'list' ? ' ' + Theme.selected(Text.strip(line)) : ' ' + Theme.accent(Text.strip(line));
-    }
-    sideLines(width) {
-        if (!this.o.categories)
-            return [];
-        return this.o.categories.map((cat, i) => {
-            const count = this.o.items.filter((it) => it.category === cat.id).length;
-            const text = ' ' + Text.fit(cat.label, width - 6) + ' ' + Text.fit(String(count), 3, 'right') + ' ';
-            if (i !== this.category)
-                return Theme.muted(text);
-            return this.focus === 'side' ? Theme.selected(text) : Theme.accentBold(text);
-        });
-    }
-    detailsLines(index, width) {
-        const w = Math.max(10, width - 1);
-        if (this.focus === 'side' && this.o.categories) {
-            const cat = this.o.categories[this.category];
-            return [Theme.bold(cat.label), ...(cat.description ? Text.wrap(cat.description, w).map((l) => Theme.muted(l)) : [])];
-        }
-        if (index === undefined)
-            return [];
-        const it = this.o.items[index];
-        return [
-            Theme.bold(Text.truncate(it.label, w)),
-            ...(it.description ? Text.wrap(it.description, w).map((l) => Theme.muted(l)) : []),
-            ...(it.details?.length ? ['', ...it.details.flatMap((d) => Text.wrap(d, w))] : []),
-            ...(it.disabled ? ['', Theme.warn(it.disabled)] : []),
-        ];
-    }
-    keys() {
-        if (this.searching)
-            return [['type', 'to search'], ['↑↓', 'move'], ['↵', this.o.multi ? 'done' : 'open'], ['esc', 'clear search']];
-        return [
-            ['↑↓', 'move'],
-            ...(this.o.tabs ? [['tab', 'switch ' + this.o.tabs.items.map((t) => t.label.toLowerCase()).join(' / ')]] : []),
-            ...(this.o.categories ? [['←→', 'categories']] : []),
-            ...(this.o.multi ? [['space', 'tick'], ['a', 'tick all shown'], ['↵', 'done']] : [['↵', 'open']]),
-            ['/', 'search'],
-            ...(this.o.actions ?? []).map((a) => [a.key, a.label]),
-            ['esc', this.o.escapeLabel ?? 'back'],
-        ];
-    }
-    /** Programmatic notice (e.g. "Saved") shown until the next key. */
-    setNotice(text) { this.notice = text; }
-    handle(key) {
-        const visible = this.visible();
-        const current = visible[this.cursor];
-        this.notice = undefined;
-        const move = (by) => { this.cursor = Math.max(0, Math.min(visible.length - 1, this.cursor + by)); };
-        if (key.name === 'up') {
-            if (this.focus === 'side')
-                this.switchCategory(-1);
-            else
-                move(-1);
-            return;
-        }
-        if (key.name === 'down') {
-            if (this.focus === 'side')
-                this.switchCategory(1);
-            else
-                move(1);
-            return;
-        }
-        if (key.name === 'pageup') {
-            move(-10);
-            return;
-        }
-        if (key.name === 'pagedown') {
-            move(10);
-            return;
-        }
-        if (key.name === 'home') {
-            this.cursor = 0;
-            return;
-        }
-        if (key.name === 'end') {
-            this.cursor = visible.length - 1;
-            return;
-        }
-        if (this.searching) {
-            if (key.name === 'escape') {
-                this.searching = false;
-                this.query = '';
-                this.cursor = 0;
-                return;
-            }
-            if (key.name === 'backspace') {
-                if (this.query)
-                    this.query = this.query.slice(0, -1);
-                else
-                    this.searching = false;
-                this.cursor = 0;
-                return;
-            }
-            // In a tick list, space always ticks (even while searching).
-            if (key.name !== 'return' && key.text && !(this.o.multi && key.name === 'space')) {
-                this.query += key.text;
-                this.cursor = 0;
-                return;
-            }
-        }
-        if (this.o.tabs && key.name === 'tab') {
-            const n = this.o.tabs.items.length;
-            return { done: { kind: 'tab', index: (this.o.tabs.active + (key.shift ? n - 1 : 1)) % n } };
-        }
-        if (this.o.categories && !this.query) {
-            if (key.name === 'left' && this.focus === 'list') {
-                this.focus = 'side';
-                return;
-            }
-            if ((key.name === 'right' || key.name === 'return') && this.focus === 'side') {
-                this.focus = 'list';
-                return;
-            }
-        }
-        if (key.name === 'escape' || (key.name === 'backspace' && !this.searching)) {
-            if (this.query) {
-                this.query = '';
-                this.cursor = 0;
-                return;
-            }
-            return { done: { kind: 'back' } };
-        }
-        if (key.text === '/' || (key.name === 'f' && key.ctrl)) {
-            this.searching = true;
-            this.focus = 'list';
-            return;
-        }
-        if (this.o.multi) {
-            if (key.name === 'space' && current !== undefined) {
-                this.toggle(current);
-                return;
-            }
-            if (key.text === 'a') {
-                const all = visible.filter((i) => !this.o.items[i].disabled);
-                const tick = all.some((i) => !this.checked.has(i));
-                all.forEach((i) => (tick ? this.checked.add(i) : this.checked.delete(i)));
-                return;
-            }
-            if (key.name === 'return')
-                return { done: { kind: 'multi', values: this.o.items.filter((_, i) => this.checked.has(i)).map((it) => it.value) } };
-        }
-        if ((key.name === 'return' || key.name === 'right' || (key.name === 'space' && !this.searching)) && current !== undefined && !this.o.multi) {
-            const it = this.o.items[current];
-            if (it.disabled) {
-                this.notice = Theme.warn(it.disabled);
-                return;
-            }
-            return { done: { kind: 'pick', value: it.value } };
-        }
-        const action = !this.searching && key.text ? this.o.actions?.find((a) => a.key === key.text) : undefined;
-        if (action)
-            return { done: { kind: 'action', key: action.key, value: current === undefined ? undefined : this.o.items[current].value } };
-        return;
-    }
-    toggle(index) {
-        if (this.o.items[index].disabled) {
-            this.notice = Theme.warn(this.o.items[index].disabled);
-            return;
-        }
-        if (this.checked.has(index))
-            this.checked.delete(index);
-        else
-            this.checked.add(index);
-    }
-    switchCategory(by) {
-        const count = this.o.categories?.length ?? 0;
-        if (!count)
-            return;
-        this.category = (this.category + by + count) % count;
-        this.cursor = 0;
-        this.offset = 0;
-    }
-}

package/dist/core/config.d.ts

@@ -1,17 +0,0 @@
-import type { Config, LoadedConfig } from './types.js';
-export declare const DEFAULTS: Config;
-/** Per-user folder for config and hooks. Survives reinstalling the npm package. */
-export declare const userDir: () => string;
-export declare const userConfigPath: () => string;
-/** Deep merge where arrays (and anything that is not a plain object) replace instead of merging element by element. */
-export declare const mergeConfig: <T>(base: T, extra: unknown) => T;
-/** Validates a full config; throws one readable error listing every problem. */
-export declare const validateConfig: (config: unknown, source: string) => Config;
-/**
- * Lookup order: --config, %AGENT_SANDBOX_CONFIG%, ~/.agent-sandbox/config.json, built-in defaults.
- * Whatever file is found (JSON with comments) is merged over the defaults, so it only needs the keys you change.
- */
-export declare const loadConfig: (explicitPath?: string) => LoadedConfig;
-export declare const assertNoGuestOverlap: (mappings: {
-    guest: string;
-}[]) => void;

package/dist/core/config.js

@@ -1,109 +0,0 @@
-// Built-in defaults and loading the user config (~/.agent-sandbox/config.json). Shapes live in schema.ts.
-import fs from 'node:fs';
-import path from 'node:path';
-import _ from 'lodash';
-import { Config as ConfigSchema, describeIssues } from './schema.js';
-import { fail, homeDir, readJsonc } from './util.js';
-export const DEFAULTS = {
-    defaultHarness: 'claude',
-    guestWorkspace: 'auto',
-    readOnly: false,
-    workspaceFilter: { enabled: false, exclude: [], include: [] },
-    audit: { enabled: false, days: 14, maxMb: 100, processes: true, files: true },
-    mappings: [],
-    sandbox: { memoryMb: 'auto', maxMemoryMb: 32768, maxMemoryPercent: 80, cpuLimit: 80, pageFileMb: 16384, reserveHostMb: 8192, vGpu: false, networking: true, clipboard: true, audioInput: false, videoInput: false, printerRedirection: false, protectedClient: true, headless: false, keepAwake: true },
-    storage: { root: '%LOCALAPPDATA%\\AgentSandbox', persistAgentState: true, dataName: 'default', markSandboxFiles: true, warnDataGb: 50 },
-    network: { blockPrivateRanges: true, allowOnly: [], blockHosts: [], forwardPorts: [], dns: [], proxy: '' },
-    provisioning: { copyFromHost: true, fallbackToInstall: true, refresh: false, git: { enabled: true, access: 'full' }, terminal: { enabled: true }, conpty: { enabled: true } },
-    downloads: { requireChecksum: false },
-    toolchains: {
-        node: { version: 'host', extraVersions: [], corepack: true, volta: 'auto', globalPackages: [] },
-        python: { enabled: 'auto', version: '3', python2: true, pyenv: 'auto', tools: [] },
-        rust: { enabled: 'auto', toolchain: 'stable', host: 'auto', components: [], targets: [], crates: [], targetDir: 'separate' },
-        msvc: { enabled: 'auto', acceptLicense: false, msvcVersion: 'latest', sdkVersion: 'latest' },
-        cpp: { enabled: 'auto', flexBison: true },
-        dotnet: { enabled: 'auto', channels: ['LTS'], tools: [], workloads: [], frameworkTargets: ['net48', 'net472'], netfx35: false },
-        // Bigger downloads only for projects that use them.
-        go: { enabled: 'auto', version: 'stable', tools: [] },
-        java: { enabled: 'auto', version: 'lts', maven: true, gradle: true },
-        ruby: { enabled: 'auto', version: '3', gems: [] },
-        php: { enabled: 'auto', version: '8', composer: true },
-        deno: { enabled: 'auto' },
-        pwsh: { enabled: 'auto' },
-        cli: { gh: 'auto', zstd: false, openssl: 'auto' },
-        bun: { enabled: true },
-        uv: { enabled: true },
-        vcRuntime: { enabled: false },
-        mesa: { enabled: false, vulkan: false },
-        vscode: { enabled: true, setup: true, recommended: true, extensions: [] },
-        environment: {},
-    },
-    databases: {
-        postgres: { enabled: 'auto', version: 'latest', port: 5432 },
-        mysql: { enabled: 'auto', version: 'lts', port: 3306 },
-        mongodb: { enabled: 'auto', version: 'latest', port: 27017 },
-        redis: { enabled: 'auto', port: 6379 },
-        dynamodb: { enabled: 'auto', port: 8000, adminPort: 8001, admin: true },
-        sqlserver: { enabled: 'auto' },
-    },
-    attach: { enabled: true, reuseSession: true, auto: false, autoHide: false },
-    agentCommands: { enabled: false, agents: 'auto' },
-    secrets: { strip: true, allow: [], patterns: [], warnFiles: true },
-    personalization: { enabled: true },
-    apps: { install: [], custom: {} },
-    claudeProfile: { enabled: true, hostDir: 'auto', include: ['settings.json', 'CLAUDE.md', 'commands', 'agents', 'skills', 'plugins'], globalStateFile: 'auto', copyCredentials: false, overwrite: true, syncHistory: true, historyScope: 'project', syncClaudeMem: true, syncClaudeMemBack: false },
-    harnesses: {
-        claude: { hostExecutable: 'claude.exe', hostDir: 'auto', npmPackage: '@anthropic-ai/claude-code@latest', npmBin: 'claude', arguments: [], environment: { DISABLE_AUTOUPDATER: '1' }, resumeArguments: ['--continue'] },
-        codex: { npmPackage: '@openai/codex@latest', npmBin: 'codex', arguments: [], environment: {}, resumeArguments: ['resume', '--last'] },
-        gemini: { npmPackage: '@google/gemini-cli@latest', npmBin: 'gemini', arguments: [], environment: {}, resumeArguments: ['--resume'] },
-        // Not tested by us; installed from each project's official npm / PyPI package.
-        opencode: { npmPackage: 'opencode-ai@latest', npmBin: 'opencode', arguments: [], environment: {}, resumeArguments: ['--continue'] },
-        qwen: { npmPackage: '@qwen-code/qwen-code@latest', npmBin: 'qwen', arguments: [], environment: {}, resumeArguments: ['--continue'] },
-        crush: { npmPackage: '@charmland/crush@latest', npmBin: 'crush', arguments: [], environment: {}, resumeArguments: ['--continue'] },
-        copilot: { npmPackage: '@github/copilot@latest', npmBin: 'copilot', arguments: [], environment: {}, resumeArguments: ['--continue'] },
-        kilo: { npmPackage: '@kilocode/cli@latest', npmBin: 'kilo', arguments: [], environment: {}, resumeArguments: ['--continue'] },
-        amp: { npmPackage: '@ampcode/cli@latest', npmBin: 'amp', arguments: [], environment: {} },
-        cline: { npmPackage: 'cline@latest', npmBin: 'cline', arguments: [], environment: {} },
-        continue: { npmPackage: '@continuedev/cli@latest', npmBin: 'cn', arguments: [], environment: {}, resumeArguments: ['--resume'] },
-        kimi: { npmPackage: '@moonshot-ai/kimi-code@latest', npmBin: 'kimi', arguments: [], environment: {}, resumeArguments: ['-c'] },
-        // DeepSeek has no official coding CLI; these two community agents are built for it.
-        reasonix: { npmPackage: 'reasonix@latest', npmBin: 'reasonix', arguments: [], environment: {} },
-        deepseek: { npmPackage: 'codewhale@latest', npmBin: 'codewhale', arguments: [], environment: {} },
-        aider: { uvPackage: 'aider-chat', uvBin: 'aider', arguments: [], environment: {}, resumeArguments: ['--restore-chat-history'] },
-    },
-    hooks: { failFast: false },
-    projects: { all: false, exclude: [], roots: [], askToAddRoot: true, declinedRoots: [], allowOutsideMappings: 'ask', wsbShare: true },
-};
-/** Per-user folder for config and hooks. Survives reinstalling the npm package. */
-export const userDir = () => process.env.AGENT_SANDBOX_HOME ?? path.join(homeDir(), '.agent-sandbox');
-export const userConfigPath = () => path.join(userDir(), 'config.json');
-/** Deep merge where arrays (and anything that is not a plain object) replace instead of merging element by element. */
-export const mergeConfig = (base, extra) => _.mergeWith(_.cloneDeep(base), extra, (_target, source) => (Array.isArray(source) ? source : undefined));
-/** Validates a full config; throws one readable error listing every problem. */
-export const validateConfig = (config, source) => {
-    const parsed = ConfigSchema.safeParse(config);
-    if (!parsed.success)
-        fail(source + ' is not valid:\n  - ' + describeIssues(parsed.error).join('\n  - '));
-    return parsed.data;
-};
-/**
- * Lookup order: --config, %AGENT_SANDBOX_CONFIG%, ~/.agent-sandbox/config.json, built-in defaults.
- * Whatever file is found (JSON with comments) is merged over the defaults, so it only needs the keys you change.
- */
-export const loadConfig = (explicitPath) => {
-    const requested = explicitPath ?? process.env.AGENT_SANDBOX_CONFIG;
-    const full = path.resolve(requested ?? userConfigPath());
-    if (!fs.existsSync(full)) {
-        if (requested)
-            fail('Config file not found: ' + full, 'Check the --config path or AGENT_SANDBOX_CONFIG, or create one with: sandbox config init');
-        return { config: structuredClone(DEFAULTS), configPath: null, base: userDir() };
-    }
-    return { config: validateConfig(mergeConfig(DEFAULTS, readJsonc(full)), full), configPath: full, base: path.dirname(full) };
-};
-export const assertNoGuestOverlap = (mappings) => {
-    const normal = mappings.map((m) => m.guest.replace(/\\+$/, '').toLowerCase());
-    normal.forEach((a, i) => normal.slice(i + 1).forEach((b, j) => {
-        if (a === b || a.startsWith(b + '\\') || b.startsWith(a + '\\'))
-            fail('Two folders map to overlapping places in the sandbox: ' + mappings[i].guest + ' and ' + mappings[i + 1 + j].guest + '.', 'Give each mapping its own guest folder (one must not be inside the other).');
-    }));
-};

package/dist/core/detect-databases.d.ts

@@ -1,15 +0,0 @@
-export declare const DATABASES: readonly ["postgres", "mysql", "sqlserver", "mongodb", "redis", "dynamodb"];
-export type Database = (typeof DATABASES)[number];
-export interface ProjectFile {
-    path: string;
-    text: string;
-}
-/** Files worth reading, by name (lower case). Everything else is ignored, so a scan stays fast on big repos. */
-export declare const INTERESTING_FILE: RegExp;
-export interface Detection {
-    database: Database;
-    reasons: string[];
-}
-export declare const detectDatabases: (input: ProjectFile[], hostHas?: Database[] | (() => Database[])) => Detection[];
-/** Windows service names of databases installed on this PC (from `sc query`), e.g. postgresql-x64-16, MySQL80. */
-export declare const databasesFromServices: (serviceNames: string[]) => Database[];

package/dist/core/detect-databases.js

@@ -1,147 +0,0 @@
-// Which databases a project needs, worked out from its files: compose files, dependency manifests of every ecosystem,
-// ORM schemas, connection strings and .env templates. Pure (file contents in, verdicts out), so the host can run it at
-// launch and the tests can feed it fixtures.
-export const DATABASES = ['postgres', 'mysql', 'sqlserver', 'mongodb', 'redis', 'dynamodb'];
-/** Files worth reading, by name (lower case). Everything else is ignored, so a scan stays fast on big repos. */
-export const INTERESTING_FILE = /^(package\.json|requirements[\w.-]{0,40}\.txt|pyproject\.toml|pipfile|setup\.py|setup\.cfg|gemfile|go\.mod|cargo\.toml|composer\.json|pom\.xml|build\.gradle(\.kts)?|[\w.-]+\.(cs|fs|vb)proj|directory\.packages\.props|packages\.config|schema\.prisma|(docker-)?compose[\w.-]{0,40}\.ya?ml|\.env(\.[\w.-]+)?|appsettings[\w.-]{0,40}\.json|database\.yml|application[\w.-]{0,40}\.(properties|ya?ml)|knexfile\.[jt]s|ormconfig\.(json|[jt]s)|drizzle\.config\.[jt]s|alembic\.ini|settings\.py|mix\.exs|deno\.json|serverless\.ya?ml|template\.ya?ml|samconfig\.toml|[\w.-]+\.tf|cdk\.json)$/i;
-const manifests = /^(package\.json|deno\.json)$/i;
-const python = /^(requirements[\w.-]{0,40}\.txt|pyproject\.toml|pipfile|setup\.py|setup\.cfg)$/i;
-const dotnet = /\.(cs|fs|vb)proj$|^directory\.packages\.props$|^packages\.config$/i;
-const jvm = /^(pom\.xml|build\.gradle(\.kts)?)$/i;
-const compose = /^(docker-)?compose[\w.-]{0,40}\.ya?ml$/i;
-const config = /^(\.env(\.[\w.-]+)?|appsettings[\w.-]{0,40}\.json|database\.yml|application[\w.-]{0,40}\.(properties|ya?ml)|knexfile\.[jt]s|ormconfig\.(json|[jt]s)|drizzle\.config\.[jt]s|alembic\.ini|settings\.py)$/i;
-const infra = /^(serverless\.ya?ml|template\.ya?ml|[\w.-]+\.tf)$/i;
-const dep = (names) => new RegExp('["\'\\s/=]?(' + names + ')["\'\\s@=<>~^:,\\]\\n]', 'i');
-const RULES = {
-    postgres: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(postgres|postgis|timescaledb|supabase\/postgres|pgvector)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs Postgres'],
-        [manifests, dep('pg|postgres|pg-promise|@neondatabase/serverless|@vercel/postgres|slonik|postgres-js|@electric-sql/pglite'), 'a Postgres driver in package.json'],
-        [python, dep('psycopg2?(-binary)?|psycopg\\[[\\w,]+\\]|asyncpg|pg8000|django\\.db\\.backends\\.postgresql'), 'a Postgres driver in the Python dependencies'],
-        [/^gemfile$/i, /gem\s+["']pg["']/, 'the pg gem'],
-        [/^go\.mod$/i, /github\.com\/(jackc\/pgx|lib\/pq)/, 'a Postgres driver in go.mod'],
-        [/^cargo\.toml$/i, /tokio-postgres|postgres\s*=|sqlx[^\n]{0,200}postgres|diesel[^\n]{0,200}postgres|sea-orm[^\n]{0,200}postgres/i, 'a Postgres driver in Cargo.toml'],
-        [dotnet, /Npgsql/i, 'Npgsql in a .NET project'],
-        [jvm, /org\.postgresql|postgresql:postgresql|r2dbc-postgresql/i, 'the Postgres JDBC driver'],
-        [/^composer\.json$/i, /ext-pgsql|ext-pdo_pgsql/i, 'the PHP Postgres extension'],
-        [/^mix\.exs$/i, /:postgrex/, 'Postgrex'],
-        [/^schema\.prisma$/i, /provider\s*=\s*"(postgresql|postgres|cockroachdb)"/, 'Prisma uses PostgreSQL'],
-        [config, /postgres(ql)?(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*pgsql|adapter:\s*postgres|\bHost=[^;\s]{1,200};\s*(Port=\d{1,5};\s*)?Database=|jdbc:postgresql:/i, 'a Postgres connection string'],
-    ],
-    mysql: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(mysql|mariadb|percona)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs MySQL / MariaDB'],
-        [manifests, dep('mysql2?|mariadb|@planetscale/database'), 'a MySQL driver in package.json'],
-        [python, dep('pymysql|mysqlclient|mysql-connector-python|aiomysql|asyncmy|mariadb'), 'a MySQL driver in the Python dependencies'],
-        [/^gemfile$/i, /gem\s+["'](mysql2|trilogy)["']/, 'a MySQL gem'],
-        [/^go\.mod$/i, /github\.com\/go-sql-driver\/mysql/, 'the MySQL driver in go.mod'],
-        [/^cargo\.toml$/i, /mysql_async|mysql\s*=|sqlx[^\n]{0,200}mysql|diesel[^\n]{0,200}mysql/i, 'a MySQL driver in Cargo.toml'],
-        [dotnet, /MySqlConnector|MySql\.Data|Pomelo\.EntityFrameworkCore\.MySql/i, 'a MySQL driver in a .NET project'],
-        [jvm, /mysql-connector|mariadb-java-client|com\.mysql/i, 'the MySQL JDBC driver'],
-        [/^composer\.json$/i, /ext-mysqli|ext-pdo_mysql/i, 'the PHP MySQL extension'],
-        [/^mix\.exs$/i, /:myxql/, 'MyXQL'],
-        [/^schema\.prisma$/i, /provider\s*=\s*"mysql"/, 'Prisma uses MySQL'],
-        [config, /(mysql|mariadb)(\+\w+)?:\/\/|DB_CONNECTION\s*=\s*(mysql|mariadb)|adapter:\s*(mysql2|trilogy)|jdbc:(mysql|mariadb):/i, 'a MySQL connection string'],
-    ],
-    sqlserver: [
-        [compose, /image:\s*["']?(mcr\.microsoft\.com\/(mssql|azure-sql-edge)|[\w./-]{0,80}mssql)[\w./:-]{0,80}/im, 'a compose service runs SQL Server'],
-        [manifests, dep('mssql|tedious|msnodesqlv8'), 'a SQL Server driver in package.json'],
-        [python, dep('pyodbc|pymssql|aioodbc|mssql-django'), 'a SQL Server driver in the Python dependencies'],
-        [/^go\.mod$/i, /(denisenkom|microsoft)\/go-mssqldb/, 'the SQL Server driver in go.mod'],
-        [/^cargo\.toml$/i, /tiberius|sqlx[^\n]{0,200}mssql/i, 'a SQL Server driver in Cargo.toml'],
-        [dotnet, /Microsoft\.Data\.SqlClient|System\.Data\.SqlClient|EntityFrameworkCore\.SqlServer|Dapper\.SqlBuilder|LocalDb/i, 'SQL Server in a .NET project'],
-        [jvm, /mssql-jdbc|com\.microsoft\.sqlserver/i, 'the SQL Server JDBC driver'],
-        [/^composer\.json$/i, /ext-sqlsrv|ext-pdo_sqlsrv/i, 'the PHP SQL Server extension'],
-        [/^schema\.prisma$/i, /provider\s*=\s*"sqlserver"/, 'Prisma uses SQL Server'],
-        [config, /\(localdb\)|mssql(\+\w+)?:\/\/|sqlserver:\/\/|DB_CONNECTION\s*=\s*sqlsrv|jdbc:sqlserver:|Initial Catalog=|Trusted_Connection=|TrustServerCertificate=|Integrated Security=/i, 'a SQL Server connection string'],
-    ],
-    mongodb: [
-        [compose, /image:\s*["']?[\w./-]{0,80}mongo(db)?[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs MongoDB'],
-        [manifests, dep('mongodb|mongoose|@typegoose/typegoose|mongodb-memory-server'), 'a MongoDB driver in package.json'],
-        [python, dep('pymongo|motor|mongoengine|beanie|djongo'), 'a MongoDB driver in the Python dependencies'],
-        [/^gemfile$/i, /gem\s+["'](mongoid|mongo)["']/, 'a MongoDB gem'],
-        [/^go\.mod$/i, /go\.mongodb\.org\/mongo-driver/, 'the MongoDB driver in go.mod'],
-        [/^cargo\.toml$/i, /^\s*mongodb\s*=/m, 'the MongoDB crate'],
-        [dotnet, /MongoDB\.Driver|MongoDB\.EntityFrameworkCore/i, 'the MongoDB driver in a .NET project'],
-        [jvm, /mongodb-driver|spring-boot-starter-data-mongodb/i, 'the MongoDB Java driver'],
-        [/^schema\.prisma$/i, /provider\s*=\s*"mongodb"/, 'Prisma uses MongoDB'],
-        [config, /mongodb(\+srv)?:\/\//i, 'a MongoDB connection string'],
-    ],
-    dynamodb: [
-        [compose, /image:\s*["']?(amazon\/dynamodb-local|[\w./-]{0,80}dynamodb-local|instructure\/dynamo-local-admin)[\w.:-]{0,40}/im, 'a compose service runs DynamoDB Local'],
-        [manifests, dep('@aws-sdk/client-dynamodb|@aws-sdk/lib-dynamodb|dynamoose|electrodb|dynamodb-toolbox|@typedorm/core|dynamodb-onetable'), 'a DynamoDB client in package.json'],
-        [python, dep('pynamodb|boto3-stubs\\[[^\\]]{0,80}dynamodb[^\\]]{0,80}\\]|types-aiobotocore-dynamodb|mypy-boto3-dynamodb|dynamorm'), 'a DynamoDB client in the Python dependencies'],
-        [/^gemfile$/i, /gem\s+["'](aws-sdk-dynamodb|dynamoid|aws-record)["']/, 'a DynamoDB gem'],
-        [/^go\.mod$/i, /aws-sdk-go-v2\/service\/dynamodb|github\.com\/guregu\/dynamo/, 'a DynamoDB client in go.mod'],
-        [/^cargo\.toml$/i, /^\s*(aws-sdk-dynamodb|serde_dynamo|modyne)\s*=/m, 'a DynamoDB crate'],
-        [dotnet, /AWSSDK\.DynamoDBv2/i, 'AWSSDK.DynamoDBv2 in a .NET project'],
-        [jvm, /software\.amazon\.awssdk[^\n]{0,200}dynamodb|aws-java-sdk-dynamodb|dynamodb-enhanced/i, 'the DynamoDB Java SDK'],
-        [infra, /AWS::DynamoDB::(Global)?Table|aws_dynamodb_table/, 'a DynamoDB table in the infrastructure code'],
-        [config, /AWS_ENDPOINT_URL_DYNAMODB|DYNAMO(DB)?_(ENDPOINT|URL|TABLE)|dynamodb\.[\w-]+\.amazonaws\.com|localhost:8000/i, 'DynamoDB settings in the config'],
-    ],
-    redis: [
-        [compose, /image:\s*["']?[\w./-]{0,80}(redis|valkey|keydb|dragonfly)[\w.-]{0,40}(:|\s|["']|$)/im, 'a compose service runs Redis'],
-        [manifests, dep('redis|ioredis|bullmq|bull|@upstash/redis|connect-redis|rate-limit-redis'), 'a Redis client in package.json'],
-        [python, dep('redis|aioredis|rq|celery\\[redis\\]|django-redis|arq'), 'a Redis client in the Python dependencies'],
-        [/^gemfile$/i, /gem\s+["'](redis|sidekiq|resque)["']/, 'a Redis gem'],
-        [/^go\.mod$/i, /github\.com\/(redis\/go-redis|go-redis\/redis|gomodule\/redigo)/, 'a Redis client in go.mod'],
-        [/^cargo\.toml$/i, /^\s*(redis|deadpool-redis|bb8-redis)\s*=/m, 'a Redis crate'],
-        [dotnet, /StackExchange\.Redis|Microsoft\.Extensions\.Caching\.StackExchangeRedis/i, 'StackExchange.Redis in a .NET project'],
-        [jvm, /jedis|lettuce-core|spring-boot-starter-data-redis|redisson/i, 'a Redis Java client'],
-        [/^composer\.json$/i, /predis\/predis|ext-redis/i, 'a PHP Redis client'],
-        [config, /rediss?:\/\/|REDIS_(URL|HOST)\s*=|CACHE_DRIVER\s*=\s*redis/i, 'a Redis connection string'],
-    ],
-};
-/** Libraries that talk to "a SQL database" without saying which: then this PC's own database decides (see below). */
-const GENERIC_SQL = [
-    [manifests, dep('knex|sequelize|typeorm|drizzle-orm|kysely|@mikro-orm/core|objection|prisma'), 'an SQL ORM'],
-    [python, dep('sqlalchemy|django|peewee|tortoise-orm|sqlmodel|alembic'), 'an SQL ORM'],
-    [dotnet, /Microsoft\.EntityFrameworkCore(?!\.(Sqlite|InMemory))|Dapper/i, 'Entity Framework / Dapper'],
-    [/^gemfile$/i, /gem\s+["'](rails|activerecord|sequel)["']/, 'ActiveRecord'],
-    [jvm, /spring-boot-starter-data-jpa|hibernate-core|jooq/i, 'JPA / Hibernate'],
-    [/^go\.mod$/i, /gorm\.io\/gorm|entgo\.io\/ent|github\.com\/jmoiron\/sqlx/, 'an SQL ORM'],
-    [/^cargo\.toml$/i, /^\s*(sqlx|diesel|sea-orm)\s*=/m, 'an SQL ORM'],
-    [/^composer\.json$/i, /laravel\/framework|doctrine\/orm/i, 'Laravel / Doctrine'],
-];
-const fileName = (p) => p.split(/[\\/]/).pop() ?? p;
-const SQL = ['postgres', 'mysql', 'sqlserver'];
-/**
- * The databases a project needs, each with the evidence ("compose.yaml: a compose service runs Postgres"). `hostHas` is
- * what this PC has installed: when the project only shows a database-agnostic ORM, the SQL database you use here is
- * taken (Postgres first if several), so an ORM project still gets a database.
- */
-/** Longest line and file looked at: bounded work per file whatever a (sandbox-written) file contains. */
-const MAX_LINE = 1000;
-const MAX_TEXT = 256 * 1024;
-const bounded = (text) => text.slice(0, MAX_TEXT).split('\n').filter((line) => line.length <= MAX_LINE).join('\n');
-export const detectDatabases = (input, hostHas = []) => {
-    const files = input.map((f) => ({ path: f.path, text: bounded(f.text) }));
-    const found = new Map();
-    const add = (db, reason) => { const list = found.get(db) ?? []; if (!list.includes(reason))
-        list.push(reason); found.set(db, list); };
-    for (const file of files) {
-        const name = fileName(file.path);
-        for (const db of DATABASES)
-            for (const [test, pattern, reason] of RULES[db])
-                if (test.test(name) && pattern.test(file.text))
-                    add(db, file.path + ': ' + reason);
-    }
-    if (!SQL.some((db) => found.has(db))) {
-        const orm = files.flatMap((file) => GENERIC_SQL.filter(([test, pattern]) => test.test(fileName(file.path)) && pattern.test(file.text)).map(([, , reason]) => file.path + ': ' + reason));
-        const host = orm.length ? (typeof hostHas === 'function' ? hostHas() : hostHas) : [];
-        const mine = SQL.find((db) => host.includes(db));
-        if (orm.length && mine)
-            add(mine, orm[0] + ', and this PC has ' + mine + ' installed');
-    }
-    return DATABASES.filter((db) => found.has(db)).map((database) => ({ database, reasons: found.get(database) }));
-};
-/** Windows service names of databases installed on this PC (from `sc query`), e.g. postgresql-x64-16, MySQL80. */
-export const databasesFromServices = (serviceNames) => {
-    const has = (r) => serviceNames.some((s) => r.test(s));
-    return DATABASES.filter((db) => ({
-        postgres: has(/^postgresql/i),
-        mysql: has(/^(mysql|mariadb)/i),
-        sqlserver: has(/^(MSSQLSERVER|MSSQL\$|SQLServer)/i),
-        mongodb: has(/^mongodb/i),
-        redis: has(/^(redis|memurai)/i),
-        dynamodb: false,
-    })[db]);
-};

package/dist/core/detect-pwsh.d.ts

@@ -1,18 +0,0 @@
-import type { ProjectFile } from './detect-databases.js';
-/** Scripts looked at: the workspace root and one folder down, at most this many, only their start. */
-export declare const PWSH_MAX_SCRIPTS = 40;
-export declare const PWSH_MAX_BYTES: number;
-/** The first script that needs PowerShell 7 and why ("moh.ps1: #Requires -Version 7"), or null. */
-export declare const usesPwsh: (files: readonly ProjectFile[]) => string | null;
-/** *.ps1 / *.psm1 / *.psd1 in the workspace root and its direct sub-folders (root first), capped. Links are skipped. */
-export declare const readPwshScripts: (root: string) => ProjectFile[];
-/** PowerShell 7 installed on this PC (the MSI's folder, or a pwsh.exe on PATH other than a Store alias). */
-export declare const pcHasPwsh: (env?: NodeJS.ProcessEnv, exists?: (p: string) => boolean) => boolean;
-/**
- * The decision for toolchains.pwsh.enabled: true/false are kept; "auto" is on when a script needs PowerShell 7, or, in
- * a folder that is no project yet (`fresh`), when this PC has it.
- */
-export declare const decidePwsh: (setting: boolean | "auto", scripts: readonly ProjectFile[], fresh: boolean, pcHas: boolean) => {
-    on: boolean;
-    reason: string;
-};