cgraphx 1.1.0

package/dist/dbquery/cli.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * CLI wiring for the db-query subsystem.
+ *
+ * Exposes `registerDbCommands(program)` — called once from
+ * `src/bin/codegraph.ts`. All db subcommands live under `cgraphx db <sub>`
+ * and are implemented in this file. Spec §5.2.
+ *
+ * Exit codes (spec §5.2):
+ *   0  success
+ *   2  config error (no profile / bad JSON / missing field)
+ *   3  safety rejection (write keyword / multi-statement)
+ *   4  connection failed / timeout / disabled
+ *   5  argument error (unknown mode, etc.)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDbCommands = registerDbCommands;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("./index");
+const init_1 = require("./init");
+function parseFormat(s) {
+    if (!s || s === 'json')
+        return 'json';
+    if (s === 'table')
+        return 'table';
+    if (s === 'csv')
+        return 'csv';
+    throw new ArgError(`--format must be json, table, or csv (got: ${s})`);
+}
+class ArgError extends Error {
+}
+function csvEscape(s) {
+    if (s === null || s === undefined)
+        return '';
+    const str = typeof s === 'string' ? s : JSON.stringify(s);
+    if (/[",\n\r]/.test(str)) {
+        return `"${str.replace(/"/g, '""')}"`;
+    }
+    return str;
+}
+function renderQueryCsv(result) {
+    const header = result.columns.map(c => csvEscape(c.name)).join(',');
+    const rows = result.rows.map(row => result.columns.map(c => csvEscape(row[c.name])).join(','));
+    return [header, ...rows].join('\n');
+}
+function renderQueryTable(result) {
+    if (result.rows.length === 0)
+        return '(no rows)';
+    const cols = result.columns.map(c => c.name);
+    const allRows = [cols, ...result.rows.map(r => cols.map(c => formatCell(r[c])))];
+    const widths = cols.map((_, i) => Math.max(...allRows.map(r => String(r[i] ?? '').length)));
+    return allRows.map(r => r.map((cell, i) => String(cell).padEnd(widths[i])).join('  ')).join('\n');
+}
+function formatCell(v) {
+    if (v === null || v === undefined)
+        return '';
+    if (typeof v === 'string')
+        return v;
+    return JSON.stringify(v);
+}
+function outputQueryResult(result, format) {
+    if (format === 'json') {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    }
+    else if (format === 'csv') {
+        process.stdout.write(renderQueryCsv(result) + '\n');
+    }
+    else {
+        process.stdout.write(renderQueryTable(result) + '\n');
+        if (result.truncated) {
+            process.stderr.write(`[db-query] Result truncated (LIMIT ${result.rowCount} rows hit).\n`);
+        }
+    }
+}
+function outputSchemaResult(result, format) {
+    // For schema results, json is the only first-class format; table/csv
+    // fall back to json because the shape varies per mode.
+    if (format !== 'json') {
+        process.stderr.write(`[db-query] --format=${format} not supported for schema output; using json.\n`);
+    }
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}
+function outputProfilesResult(result, format) {
+    if (format !== 'json') {
+        process.stderr.write(`[db-query] --format=${format} not supported for profiles output; using json.\n`);
+    }
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}
+// ─── Exit code mapping (spec §5.2) ─────────────────────────────────────────
+function exitCodeForError(err) {
+    if (err instanceof ArgError)
+        return 5;
+    if (err instanceof index_1.DbQueryError) {
+        switch (err.code) {
+            case 'CONFIG_NOT_FOUND':
+            case 'PROFILE_NOT_FOUND':
+                return 2;
+            case 'SAFETY_REJECTED':
+                return 3;
+            case 'CONNECTION_FAILED':
+            case 'QUERY_TIMEOUT':
+            case 'DRIVER_ERROR':
+            case 'SUBSYSTEM_DISABLED':
+                return 4;
+        }
+    }
+    return 1; // unknown — process-level failure
+}
+// ─── Command registration ─────────────────────────────────────────────────
+function registerDbCommands(program) {
+    const db = program
+        .command('db')
+        .description('Database introspection — MySQL / PostgreSQL read-only queries (thin wrapper, isolated from the code graph)');
+    db
+        .command('query')
+        .description('Execute a read-only SQL query. Writes are pre-rejected; LIMIT auto-applied.')
+        .requiredOption('--sql <sql>', 'SQL statement (single statement; no semicolons)')
+        .option('--profile <name>', 'Profile from db-profiles.json (default profile if omitted)')
+        .option('--limit <n>', 'Override LIMIT (clamped to 1000)', v => parseInt(v, 10))
+        .option('--format <format>', 'json / table / csv', 'json')
+        .action(async (options) => {
+        await runQueryAndExit({
+            sql: options.sql,
+            profile: options.profile,
+            limit: options.limit,
+        }, options.format);
+    });
+    db
+        .command('schema')
+        .description('Introspect DB schema: tables / ddl / indexes / table-comment')
+        .requiredOption('--mode <mode>', 'One of: tables, ddl, indexes, table-comment')
+        .option('--table <name>', 'Table name (required for ddl/indexes/table-comment)')
+        .option('--profile <name>', 'Profile from db-profiles.json')
+        .option('--format <format>', 'Output format (schema always emits json)', 'json')
+        .action(async (options) => {
+        const validModes = new Set(['tables', 'ddl', 'indexes', 'table-comment']);
+        if (!validModes.has(options.mode)) {
+            process.stderr.write(`[db-query] Invalid --mode: ${options.mode}. Must be one of: tables, ddl, indexes, table-comment\n`);
+            process.exitCode = 5;
+            return;
+        }
+        const mode = options.mode;
+        if ((mode === 'ddl' || mode === 'indexes' || mode === 'table-comment') && !options.table) {
+            process.stderr.write(`[db-query] --table is required for mode=${mode}\n`);
+            process.exitCode = 5;
+            return;
+        }
+        const projectRoot = process.cwd();
+        try {
+            const format = parseFormat(options.format);
+            const result = await (0, index_1.runSchema)({ mode, table: options.table, profile: options.profile }, projectRoot);
+            outputSchemaResult(result, format);
+        }
+        catch (err) {
+            renderErrorAndExit(err);
+        }
+    });
+    db
+        .command('profiles')
+        .description('List configured DB profiles (never returns passwords)')
+        .option('--format <format>', 'Output format (always json)', 'json')
+        .action(async (options) => {
+        const projectRoot = process.cwd();
+        try {
+            const format = parseFormat(options.format);
+            const result = await (0, index_1.listProfiles)({}, projectRoot);
+            outputProfilesResult(result, format);
+        }
+        catch (err) {
+            renderErrorAndExit(err);
+        }
+    });
+    db
+        .command('init')
+        .description('Create .cgraphx/db-profiles.json template with example MySQL + PostgreSQL profiles')
+        .option('--force', 'Overwrite the file if it already exists')
+        .action((options) => {
+        const projectRoot = process.cwd();
+        try {
+            const report = (0, init_1.initDbProfiles)(projectRoot, { force: options.force === true });
+            if (report.action === 'already-exists') {
+                process.stderr.write(`[db-query] ${report.filePath} already exists — use --force to overwrite.\n`);
+                process.exitCode = 0;
+                return;
+            }
+            process.stdout.write(`[db-query] ${report.action === 'overwritten' ? 'Overwrote' : 'Created'} ${report.filePath}\n` +
+                `[db-query] Edit the file to fill in real host/user/password, then run \`cgraphx db profiles\`.\n`);
+        }
+        catch (err) {
+            renderErrorAndExit(err);
+        }
+    });
+}
+async function runQueryAndExit(input, formatStr) {
+    const projectRoot = process.cwd();
+    try {
+        const format = parseFormat(formatStr);
+        const result = await (0, index_1.runQuery)(input, projectRoot);
+        outputQueryResult(result, format);
+    }
+    catch (err) {
+        renderErrorAndExit(err);
+    }
+}
+function renderErrorAndExit(err) {
+    const code = exitCodeForError(err);
+    if (err instanceof index_1.SubsystemDisabledError) {
+        // Match MCP: same fixed text. Spec §2.5.
+        process.stderr.write('数据库无法连接,请以代码中查询为准\n');
+    }
+    else if (err instanceof index_1.DbQueryError) {
+        process.stderr.write(`[db-query] ${err.message}\n`);
+    }
+    else if (err instanceof ArgError) {
+        process.stderr.write(`[db-query] ${err.message}\n`);
+    }
+    else {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[db-query] Unexpected error: ${msg}\n`);
+    }
+    process.exitCode = code;
+}
+// `path" import is reserved for future use (resolving projectPath passed via CLI
+// flag); kept here so the module compiles cleanly even if unused for now.
+void node_path_1.default;
+//# sourceMappingURL=cli.js.map

package/dist/dbquery/cli.js.map

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

package/dist/dbquery/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Config loader for the db-query subsystem.
+ *
+ * Spec §2.2 — three-tier load order (first wins for path source):
+ *   1. CGRAPHX_DB_PROFILES_PATH env var (custom file path; ONLY this file)
+ *   2. <projectRoot>/.cgraphx/db-profiles.json (project-local)
+ *   3. ~/.cgraphx/db-profiles.json (user-global)
+ *
+ * Merge semantics:
+ *   - same-name profile: project-local overrides user-global
+ *   - different-name profiles: union
+ *   - `default` field: project-local wins
+ *
+ * Spec §2.5 — subsystem disable switch (OR semantics, any source disables):
+ *   1. CGRAPHX_DB_QUERY_DISABLED env var (highest priority)
+ *   2. project-local top-level `enabled: false`
+ *   3. user-global top-level `enabled: false`
+ *
+ * Errors are NOT thrown for missing config / bad JSON / missing fields — the
+ * caller (executor / MCP / CLI) gets back a result with status, then converts
+ * to success-shaped response (spec §6.2). We only throw for genuinely
+ * unexpected filesystem errors (permission denied mid-read of a real file).
+ */
+import { type DBProfile, type ProfilesConfig } from './types';
+/**
+ * Load and merge profiles config per spec §2.2-§2.5.
+ *
+ * Never throws for expected conditions (file missing / bad JSON / missing
+ * fields); returns a ConfigNotFoundError in those cases. Only throws for
+ * unexpected filesystem errors (e.g. permission denied on an existing file).
+ */
+export declare function loadProfiles(projectRoot?: string): ProfilesConfig;
+/**
+ * Resolve the actual profile to use given an optional name.
+ * Throws ProfileNotFoundError when the name doesn't exist or no name + no default.
+ */
+export declare function resolveProfile(config: ProfilesConfig, requested?: string): DBProfile;
+//# sourceMappingURL=config.d.ts.map

package/dist/dbquery/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/dbquery/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EAIpB,MAAM,SAAS,CAAC;AA8FjB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CAgGjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAgBpF"}

package/dist/dbquery/config.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Config loader for the db-query subsystem.
+ *
+ * Spec §2.2 — three-tier load order (first wins for path source):
+ *   1. CGRAPHX_DB_PROFILES_PATH env var (custom file path; ONLY this file)
+ *   2. <projectRoot>/.cgraphx/db-profiles.json (project-local)
+ *   3. ~/.cgraphx/db-profiles.json (user-global)
+ *
+ * Merge semantics:
+ *   - same-name profile: project-local overrides user-global
+ *   - different-name profiles: union
+ *   - `default` field: project-local wins
+ *
+ * Spec §2.5 — subsystem disable switch (OR semantics, any source disables):
+ *   1. CGRAPHX_DB_QUERY_DISABLED env var (highest priority)
+ *   2. project-local top-level `enabled: false`
+ *   3. user-global top-level `enabled: false`
+ *
+ * Errors are NOT thrown for missing config / bad JSON / missing fields — the
+ * caller (executor / MCP / CLI) gets back a result with status, then converts
+ * to success-shaped response (spec §6.2). We only throw for genuinely
+ * unexpected filesystem errors (permission denied mid-read of a real file).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProfiles = loadProfiles;
+exports.resolveProfile = resolveProfile;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const VALID_DRIVERS = new Set(['mysql', 'postgres']);
+function readConfigFile(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { existed: false, data: null };
+        throw err;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return { existed: true, data: null, error: { message: 'invalid config shape (expected object)', detail: filePath } };
+        }
+        return { existed: true, data: parsed };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { existed: true, data: null, error: { message: 'JSON parse failed', detail: msg } };
+    }
+}
+function userGlobalConfigPath() {
+    return path.join(os.homedir(), '.cgraphx', constants_1.PROFILES_FILENAME);
+}
+function projectLocalConfigPath(projectRoot) {
+    return path.join(projectRoot, '.cgraphx', constants_1.PROFILES_FILENAME);
+}
+function envConfigPath() {
+    const v = process.env[constants_1.PROFILES_PATH_ENV];
+    return v && v.trim() ? v : null;
+}
+function envDisabled() {
+    const v = process.env[constants_1.DISABLED_ENV];
+    return !!v && v.trim() !== '' && v.trim() !== '0' && v.trim().toLowerCase() !== 'false';
+}
+function normalizeProfileEntry(name, raw, sourcePath) {
+    if (!raw || typeof raw !== 'object') {
+        return { profile: null, error: `profile "${name}" is not an object (${sourcePath})` };
+    }
+    const { type, host, port, user, password, database, schema, description } = raw;
+    if (!type || !VALID_DRIVERS.has(type)) {
+        return { profile: null, error: `profile "${name}": type must be 'mysql' or 'postgres' (got: ${String(type)})` };
+    }
+    if (typeof host !== 'string' || !host) {
+        return { profile: null, error: `profile "${name}": missing required field "host"` };
+    }
+    if (typeof user !== 'string' || !user) {
+        return { profile: null, error: `profile "${name}": missing required field "user"` };
+    }
+    if (typeof password !== 'string') {
+        return { profile: null, error: `profile "${name}": missing required field "password"` };
+    }
+    if (typeof database !== 'string' || !database) {
+        return { profile: null, error: `profile "${name}": missing required field "database"` };
+    }
+    const defaultPort = type === 'mysql' ? 3306 : 5432;
+    return {
+        profile: {
+            name,
+            description: typeof description === 'string' ? description : undefined,
+            type,
+            host,
+            port: typeof port === 'number' && port > 0 ? port : defaultPort,
+            user,
+            password,
+            database,
+            schema: type === 'postgres' ? (schema ?? 'public') : undefined,
+        },
+        error: null,
+    };
+}
+/**
+ * Load and merge profiles config per spec §2.2-§2.5.
+ *
+ * Never throws for expected conditions (file missing / bad JSON / missing
+ * fields); returns a ConfigNotFoundError in those cases. Only throws for
+ * unexpected filesystem errors (e.g. permission denied on an existing file).
+ */
+function loadProfiles(projectRoot) {
+    // 1. Resolve which files to read.
+    const envPath = envConfigPath();
+    const filesToRead = [];
+    if (envPath) {
+        filesToRead.push({ source: 'env', path: envPath });
+    }
+    else {
+        if (projectRoot) {
+            filesToRead.push({ source: 'project-local', path: projectLocalConfigPath(projectRoot) });
+        }
+        filesToRead.push({ source: 'user-global', path: userGlobalConfigPath() });
+    }
+    // 2. Read each.
+    const loaded = filesToRead.map(({ source, path: p }) => {
+        const r = readConfigFile(p);
+        return { source, path: p, existed: r.existed, data: r.data, error: r.error };
+    });
+    // 3. Compute disabled state (OR semantics across all sources).
+    //    Spec §2.5: env disabled is highest priority; if env path is set,
+    //    only that file's `enabled` flag is consulted (along with the env var).
+    const disabled = envDisabled() ||
+        loaded.some(f => f.data && f.data.enabled === false);
+    // 4. Collect errors and merge profiles.
+    const sources = [];
+    const errors = [];
+    const mergedProfiles = new Map();
+    let defaultProfile = null;
+    // Process in reverse priority order so higher-priority writes win.
+    // Order in `loaded`: [env?, project-local?, user-global?].
+    // We iterate from the end so project-local / env overwrite user-global.
+    for (let i = loaded.length - 1; i >= 0; i--) {
+        const f = loaded[i];
+        if (!f.data) {
+            if (f.error) {
+                errors.push(`${f.path}: ${f.error.message} (${f.error.detail})`);
+            }
+            continue;
+        }
+        sources.push(f.source);
+        if (typeof f.data.default === 'string' && f.data.default) {
+            defaultProfile = f.data.default;
+        }
+        for (const [name, raw] of Object.entries(f.data)) {
+            if (name === 'default' || name === 'enabled')
+                continue;
+            if (typeof raw !== 'object' || raw === null)
+                continue;
+            const { profile, error } = normalizeProfileEntry(name, raw, f.path);
+            if (error) {
+                errors.push(error);
+                continue;
+            }
+            if (profile) {
+                mergedProfiles.set(profile.name, profile);
+            }
+        }
+    }
+    // 5. No file on disk at all → ConfigNotFoundError (enabled still computed above).
+    const hasAnyFile = loaded.some(f => f.existed);
+    if (!hasAnyFile) {
+        throw new errors_1.ConfigNotFoundError(`No db-profiles.json found. Create .cgraphx/db-profiles.json in ` +
+            `the project root, or ~/.cgraphx/db-profiles.json globally, or set ` +
+            `the ${constants_1.PROFILES_PATH_ENV} environment variable.`, { searchedPaths: loaded.map(f => f.path) });
+    }
+    // 6. Field errors.
+    if (errors.length > 0) {
+        throw new errors_1.ConfigNotFoundError(`db-profiles.json has errors: ${errors.join('; ')}`, { errors });
+    }
+    // 7. Default points to nonexistent profile.
+    const profileList = Array.from(mergedProfiles.values());
+    if (defaultProfile && !mergedProfiles.has(defaultProfile)) {
+        throw new errors_1.ConfigNotFoundError(`Default profile "${defaultProfile}" does not exist. ` +
+            `Available profiles: ${profileList.map(p => p.name).join(', ') || '(none)'}`, { defaultProfile, available: profileList.map(p => p.name) });
+    }
+    return {
+        profiles: profileList,
+        defaultProfile,
+        sources: Array.from(new Set(sources)).sort(),
+        enabled: !disabled,
+    };
+}
+/**
+ * Resolve the actual profile to use given an optional name.
+ * Throws ProfileNotFoundError when the name doesn't exist or no name + no default.
+ */
+function resolveProfile(config, requested) {
+    const name = requested ?? config.defaultProfile;
+    if (!name) {
+        throw new errors_1.ConfigNotFoundError(`No profile specified and no default configured. Available: ` +
+            `${config.profiles.map(p => p.name).join(', ') || '(none)'}`);
+    }
+    const found = config.profiles.find(p => p.name === name);
+    if (!found) {
+        throw new errors_1.ConfigNotFoundError(`Profile "${name}" not found. Available: ${config.profiles.map(p => p.name).join(', ') || '(none)'}`, { requested: name });
+    }
+    return found;
+}
+//# sourceMappingURL=config.js.map

package/dist/dbquery/config.js.map

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

package/dist/dbquery/constants.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Constants for the db-query subsystem.
+ *
+ * All tunable knobs live here. See spec §3.4 / §3.5 / §2.6 for the values
+ * behind each.
+ */
+/**
+ * SQL keywords that mutate state. If any of these appear in the SQL (after
+ * comment stripping — see safety.ts), the query is rejected.
+ *
+ * Case-insensitive, word-boundary matched (so `INSERTED` is NOT mistaken for
+ * `INSERT`). MySQL backtick-quoted identifiers are NOT exempted (defensive —
+ * a `\`INSERT\`` table reference still triggers rejection).
+ */
+export declare const FORBIDDEN_KEYWORDS: readonly string[];
+/** Default LIMIT applied to SELECT without an explicit LIMIT. */
+export declare const DEFAULT_LIMIT = 100;
+/** Hard ceiling on LIMIT — anything higher is rewritten down to this. */
+export declare const MAX_LIMIT = 1000;
+/** Per-field byte limit before truncation (BLOB / large text → base64 + truncated). */
+export declare const MAX_FIELD_BYTES: number;
+/** Query timeout (milliseconds). Applied per query via driver-level timeout. */
+export declare const QUERY_TIMEOUT_MS = 30000;
+/** Connect timeout (milliseconds). TCP / auth must complete within this. */
+export declare const CONNECT_TIMEOUT_MS = 5000;
+/** Config file name (placed under .cgraphx/ or ~/.cgraphx/). */
+export declare const PROFILES_FILENAME = "db-profiles.json";
+/** Environment variable to override the config file path entirely. */
+export declare const PROFILES_PATH_ENV = "CGRAPHX_DB_PROFILES_PATH";
+/** Environment variable that disables the entire db-query subsystem. */
+export declare const DISABLED_ENV = "CGRAPHX_DB_QUERY_DISABLED";
+/** Log file name (placed under .cgraphx/). */
+export declare const LOG_FILENAME = "db-query.log";
+/** Log file size threshold that triggers rotation, in bytes. */
+export declare const LOG_MAX_BYTES: number;
+/** Number of rotated log files to keep (.log, .log.1, ..., .log.<N-1>). */
+export declare const LOG_KEEP_FILES = 5;
+/** Fixed response text when the subsystem is disabled. See spec §2.5. */
+export declare const DISABLED_RESPONSE_TEXT = "\u6570\u636E\u5E93\u65E0\u6CD5\u8FDE\u63A5,\u8BF7\u4EE5\u4EE3\u7801\u4E2D\u67E5\u8BE2\u4E3A\u51C6";
+//# sourceMappingURL=constants.d.ts.map

package/dist/dbquery/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/dbquery/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAsB/C,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,yEAAyE;AACzE,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,uFAAuF;AACvF,eAAO,MAAM,eAAe,QAAW,CAAC;AAExC,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,wEAAwE;AACxE,eAAO,MAAM,YAAY,8BAA8B,CAAC;AAExD,8CAA8C;AAC9C,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,gEAAgE;AAChE,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C,2EAA2E;AAC3E,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,sGAAsB,CAAC"}

package/dist/dbquery/constants.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Constants for the db-query subsystem.
+ *
+ * All tunable knobs live here. See spec §3.4 / §3.5 / §2.6 for the values
+ * behind each.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISABLED_RESPONSE_TEXT = exports.LOG_KEEP_FILES = exports.LOG_MAX_BYTES = exports.LOG_FILENAME = exports.DISABLED_ENV = exports.PROFILES_PATH_ENV = exports.PROFILES_FILENAME = exports.CONNECT_TIMEOUT_MS = exports.QUERY_TIMEOUT_MS = exports.MAX_FIELD_BYTES = exports.MAX_LIMIT = exports.DEFAULT_LIMIT = exports.FORBIDDEN_KEYWORDS = void 0;
+/**
+ * SQL keywords that mutate state. If any of these appear in the SQL (after
+ * comment stripping — see safety.ts), the query is rejected.
+ *
+ * Case-insensitive, word-boundary matched (so `INSERTED` is NOT mistaken for
+ * `INSERT`). MySQL backtick-quoted identifiers are NOT exempted (defensive —
+ * a `\`INSERT\`` table reference still triggers rejection).
+ */
+exports.FORBIDDEN_KEYWORDS = [
+    'DELETE',
+    'UPDATE',
+    'INSERT',
+    'DROP',
+    'CREATE',
+    'ALTER',
+    'TRUNCATE',
+    'GRANT',
+    'REVOKE',
+    'MERGE',
+    'REPLACE',
+    'CALL',
+    'EXEC',
+    'EXECUTE',
+    'RENAME',
+    'ATTACH',
+    'DETACH',
+    'VACUUM',
+    'REINDEX',
+    'LOAD',
+    'COPY',
+];
+/** Default LIMIT applied to SELECT without an explicit LIMIT. */
+exports.DEFAULT_LIMIT = 100;
+/** Hard ceiling on LIMIT — anything higher is rewritten down to this. */
+exports.MAX_LIMIT = 1000;
+/** Per-field byte limit before truncation (BLOB / large text → base64 + truncated). */
+exports.MAX_FIELD_BYTES = 8 * 1024;
+/** Query timeout (milliseconds). Applied per query via driver-level timeout. */
+exports.QUERY_TIMEOUT_MS = 30_000;
+/** Connect timeout (milliseconds). TCP / auth must complete within this. */
+exports.CONNECT_TIMEOUT_MS = 5_000;
+/** Config file name (placed under .cgraphx/ or ~/.cgraphx/). */
+exports.PROFILES_FILENAME = 'db-profiles.json';
+/** Environment variable to override the config file path entirely. */
+exports.PROFILES_PATH_ENV = 'CGRAPHX_DB_PROFILES_PATH';
+/** Environment variable that disables the entire db-query subsystem. */
+exports.DISABLED_ENV = 'CGRAPHX_DB_QUERY_DISABLED';
+/** Log file name (placed under .cgraphx/). */
+exports.LOG_FILENAME = 'db-query.log';
+/** Log file size threshold that triggers rotation, in bytes. */
+exports.LOG_MAX_BYTES = 10 * 1024 * 1024;
+/** Number of rotated log files to keep (.log, .log.1, ..., .log.<N-1>). */
+exports.LOG_KEEP_FILES = 5;
+/** Fixed response text when the subsystem is disabled. See spec §2.5. */
+exports.DISABLED_RESPONSE_TEXT = '数据库无法连接,请以代码中查询为准';
+//# sourceMappingURL=constants.js.map

package/dist/dbquery/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/dbquery/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;;GAOG;AACU,QAAA,kBAAkB,GAAsB;IACnD,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,OAAO;IACP,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;CACP,CAAC;AAEF,iEAAiE;AACpD,QAAA,aAAa,GAAG,GAAG,CAAC;AAEjC,yEAAyE;AAC5D,QAAA,SAAS,GAAG,IAAI,CAAC;AAE9B,uFAAuF;AAC1E,QAAA,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC;AAExC,gFAAgF;AACnE,QAAA,gBAAgB,GAAG,MAAM,CAAC;AAEvC,4EAA4E;AAC/D,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAExC,gEAAgE;AACnD,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAEpD,sEAAsE;AACzD,QAAA,iBAAiB,GAAG,0BAA0B,CAAC;AAE5D,wEAAwE;AAC3D,QAAA,YAAY,GAAG,2BAA2B,CAAC;AAExD,8CAA8C;AACjC,QAAA,YAAY,GAAG,cAAc,CAAC;AAE3C,gEAAgE;AACnD,QAAA,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,2EAA2E;AAC9D,QAAA,cAAc,GAAG,CAAC,CAAC;AAEhC,yEAAyE;AAC5D,QAAA,sBAAsB,GAAG,mBAAmB,CAAC"}