@ibm/ibmi-mcp-server 0.3.2 → 0.4.0

package/dist/cli/config/loader.js

@@ -0,0 +1,206 @@
+/**
+ * @fileoverview Configuration file loader for the IBM i CLI.
+ * Finds and parses .ibmi/config.yaml from project and user directories,
+ * merging them with project-level taking precedence.
+ * @module cli/config/loader
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import path from "path";
+import yaml from "js-yaml";
+import { CliConfigSchema, validateConfig } from "./schema.js";
+import { expandEnvVars } from "./credentials.js";
+/** Default config file name. */
+const CONFIG_FILE = "config.yaml";
+/** Project-level config directory. */
+const PROJECT_CONFIG_DIR = ".ibmi";
+/** User-level config directory. */
+const USER_CONFIG_DIR = path.join(homedir(), ".ibmi");
+/**
+ * Walk up from cwd to find the nearest .ibmi/config.yaml.
+ * Stops at the filesystem root. Returns null if not found.
+ */
+function findProjectConfigPath() {
+    let dir = process.cwd();
+    const root = path.parse(dir).root;
+    while (true) {
+        const candidate = path.join(dir, PROJECT_CONFIG_DIR, CONFIG_FILE);
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir || dir === root) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+/** Get the project-level config file path (nearest .ibmi/config.yaml walking up from cwd). */
+export function getProjectConfigPath() {
+    return findProjectConfigPath() ?? path.join(process.cwd(), PROJECT_CONFIG_DIR, CONFIG_FILE);
+}
+/** Get the user-level config file path. */
+export function getUserConfigPath() {
+    return path.join(USER_CONFIG_DIR, CONFIG_FILE);
+}
+/**
+ * Load and parse a single YAML config file.
+ * Returns null if file doesn't exist.
+ */
+function loadConfigFile(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = yaml.load(raw);
+    if (!parsed || typeof parsed !== "object") {
+        return null;
+    }
+    const result = CliConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const errors = result.error.issues
+            .map((i) => `  ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid config at ${filePath}:\n${errors}`);
+    }
+    return result.data;
+}
+/**
+ * Expand environment variables in all system configs.
+ */
+function expandSystemEnvVars(config) {
+    const expanded = {
+        default: config.default,
+        format: config.format,
+        systems: {},
+    };
+    for (const [name, system] of Object.entries(config.systems)) {
+        expanded.systems[name] = {
+            ...system,
+            host: expandEnvVars(system.host),
+            user: expandEnvVars(system.user),
+            password: system.password ? expandEnvVars(system.password) : undefined,
+        };
+    }
+    return expanded;
+}
+/**
+ * Merge two configs. Source overrides target on a per-system basis.
+ * Systems in source completely replace same-named systems in target.
+ */
+function mergeConfigs(target, source) {
+    return {
+        default: source.default ?? target.default,
+        format: source.format ?? target.format,
+        systems: {
+            ...target.systems,
+            ...source.systems,
+        },
+    };
+}
+/**
+ * Load the full CLI configuration by merging user-level and project-level configs.
+ * Project-level config takes precedence over user-level.
+ *
+ * @returns The merged, validated, and env-expanded configuration.
+ */
+export function loadConfig() {
+    const userConfig = loadConfigFile(getUserConfigPath());
+    const projectConfig = loadConfigFile(getProjectConfigPath());
+    let config;
+    if (userConfig && projectConfig) {
+        config = mergeConfigs(userConfig, projectConfig);
+    }
+    else if (projectConfig) {
+        config = projectConfig;
+    }
+    else if (userConfig) {
+        config = userConfig;
+    }
+    else {
+        config = { systems: {} };
+    }
+    // Validate cross-references
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        throw new Error(`Configuration errors:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+    }
+    return expandSystemEnvVars(config);
+}
+/**
+ * Save a config to the user-level config file.
+ */
+export function saveUserConfig(config) {
+    const configDir = USER_CONFIG_DIR;
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    const yamlStr = yaml.dump(config, {
+        indent: 2,
+        lineWidth: 120,
+        noRefs: true,
+    });
+    writeFileSync(getUserConfigPath(), yamlStr, "utf-8");
+}
+/**
+ * Add or update a system in the user config.
+ */
+export function upsertSystem(name, system) {
+    let config;
+    try {
+        config = loadConfigFile(getUserConfigPath()) ?? { systems: {} };
+    }
+    catch {
+        config = { systems: {} };
+    }
+    config.systems[name] = system;
+    // If this is the first system, make it the default
+    if (!config.default && Object.keys(config.systems).length === 1) {
+        config.default = name;
+    }
+    saveUserConfig(config);
+}
+/**
+ * Remove a system from the user config.
+ * @returns true if the system existed and was removed.
+ */
+export function removeSystem(name) {
+    let config;
+    try {
+        config = loadConfigFile(getUserConfigPath()) ?? { systems: {} };
+    }
+    catch {
+        return false;
+    }
+    if (!(name in config.systems)) {
+        return false;
+    }
+    delete config.systems[name];
+    // Clear default if it pointed to the removed system
+    if (config.default === name) {
+        const remaining = Object.keys(config.systems);
+        config.default = remaining.length > 0 ? remaining[0] : undefined;
+    }
+    saveUserConfig(config);
+    return true;
+}
+/**
+ * Set the default system in the user config.
+ */
+export function setDefaultSystem(name) {
+    let config;
+    try {
+        config = loadConfigFile(getUserConfigPath()) ?? { systems: {} };
+    }
+    catch {
+        config = { systems: {} };
+    }
+    // Load project config to check if system exists there
+    const fullConfig = loadConfig();
+    if (!(name in fullConfig.systems)) {
+        throw new Error(`System "${name}" not found. Available systems: ${Object.keys(fullConfig.systems).join(", ") || "(none)"}`);
+    }
+    config.default = name;
+    saveUserConfig(config);
+}
+//# sourceMappingURL=loader.js.map

package/dist/cli/config/loader.js.map

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

package/dist/cli/config/resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview System resolution for the IBM i CLI.
+ * Resolves which IBM i system to connect to based on:
+ *   1. --system flag (highest priority)
+ *   2. IBMI_SYSTEM environment variable
+ *   3. Config file default
+ *   4. DB2i_* environment variables (legacy fallback)
+ * @module cli/config/resolver
+ */
+import type { CliConfig, ResolvedSystem } from "./types.js";
+/**
+ * Resolve which system to use for a CLI command.
+ *
+ * Resolution priority:
+ * 1. --system <name> flag
+ * 2. IBMI_SYSTEM environment variable
+ * 3. Config file `default:` setting
+ * 4. DB2i_* environment variables (creates implicit "env" system)
+ *
+ * @param systemFlag - The --system flag value, if provided.
+ * @param config - Pre-loaded config (optional, will load if not provided).
+ * @returns The resolved system context.
+ * @throws If no system can be resolved.
+ */
+export declare function resolveSystem(systemFlag?: string, config?: CliConfig): ResolvedSystem;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/cli/config/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/cli/config/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AA6B1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,SAAS,GACjB,cAAc,CAiEhB"}

package/dist/cli/config/resolver.js

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview System resolution for the IBM i CLI.
+ * Resolves which IBM i system to connect to based on:
+ *   1. --system flag (highest priority)
+ *   2. IBMI_SYSTEM environment variable
+ *   3. Config file default
+ *   4. DB2i_* environment variables (legacy fallback)
+ * @module cli/config/resolver
+ */
+import { loadConfig } from "./loader.js";
+/**
+ * Build a SystemConfig from legacy DB2i_* environment variables.
+ * Returns null if the required env vars are not set.
+ */
+function buildLegacySystemConfig() {
+    const host = process.env["DB2i_HOST"];
+    const user = process.env["DB2i_USER"];
+    const password = process.env["DB2i_PASS"];
+    if (!host || !user) {
+        return null;
+    }
+    return {
+        host,
+        user,
+        password,
+        port: 8076,
+        readOnly: false,
+        confirm: false,
+        timeout: 60,
+        maxRows: 5000,
+        ignoreUnauthorized: process.env["DB2i_IGNORE_UNAUTHORIZED"] !== "false",
+    };
+}
+/**
+ * Resolve which system to use for a CLI command.
+ *
+ * Resolution priority:
+ * 1. --system <name> flag
+ * 2. IBMI_SYSTEM environment variable
+ * 3. Config file `default:` setting
+ * 4. DB2i_* environment variables (creates implicit "env" system)
+ *
+ * @param systemFlag - The --system flag value, if provided.
+ * @param config - Pre-loaded config (optional, will load if not provided).
+ * @returns The resolved system context.
+ * @throws If no system can be resolved.
+ */
+export function resolveSystem(systemFlag, config) {
+    const cfg = config ?? loadConfig();
+    // 1. --system flag
+    if (systemFlag) {
+        const system = cfg.systems[systemFlag];
+        if (!system) {
+            const available = Object.keys(cfg.systems);
+            throw new Error(`System "${systemFlag}" not found in configuration. ` +
+                (available.length > 0
+                    ? `Available systems: ${available.join(", ")}`
+                    : `No systems configured. Run "ibmi system add" to add one.`));
+        }
+        return { name: systemFlag, config: system, source: "flag" };
+    }
+    // 2. IBMI_SYSTEM env var
+    const envSystem = process.env["IBMI_SYSTEM"];
+    if (envSystem) {
+        const system = cfg.systems[envSystem];
+        if (!system) {
+            const available = Object.keys(cfg.systems);
+            throw new Error(`System "${envSystem}" (from IBMI_SYSTEM env var) not found. ` +
+                (available.length > 0
+                    ? `Available systems: ${available.join(", ")}`
+                    : `No systems configured.`));
+        }
+        return { name: envSystem, config: system, source: "env" };
+    }
+    // 3. Config default
+    if (cfg.default) {
+        const system = cfg.systems[cfg.default];
+        if (system) {
+            return { name: cfg.default, config: system, source: "config-default" };
+        }
+    }
+    // 4. If there's only one system, use it
+    const systemNames = Object.keys(cfg.systems);
+    if (systemNames.length === 1 && systemNames[0]) {
+        return {
+            name: systemNames[0],
+            config: cfg.systems[systemNames[0]],
+            source: "config-default",
+        };
+    }
+    // 5. Legacy DB2i_* env vars
+    const legacyConfig = buildLegacySystemConfig();
+    if (legacyConfig) {
+        return { name: "env", config: legacyConfig, source: "legacy-env" };
+    }
+    // Nothing found
+    throw new Error("No IBM i system configured. Options:\n" +
+        "  1. Run: ibmi system add <name>\n" +
+        "  2. Set IBMI_SYSTEM environment variable\n" +
+        "  3. Set DB2i_HOST, DB2i_USER, DB2i_PASS environment variables");
+}
+//# sourceMappingURL=resolver.js.map

package/dist/cli/config/resolver.js.map

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

package/dist/cli/config/schema.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview Zod schemas for validating CLI configuration files.
+ * @module cli/config/schema
+ */
+import { z } from "zod";
+/** Schema for a single system configuration entry. */
+export declare const SystemConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    user: z.ZodString;
+    password: z.ZodOptional<z.ZodString>;
+    defaultSchema: z.ZodOptional<z.ZodString>;
+    readOnly: z.ZodDefault<z.ZodBoolean>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    maxRows: z.ZodDefault<z.ZodNumber>;
+    ignoreUnauthorized: z.ZodDefault<z.ZodBoolean>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    user: string;
+    host: string;
+    port: number;
+    readOnly: boolean;
+    ignoreUnauthorized: boolean;
+    timeout: number;
+    confirm: boolean;
+    maxRows: number;
+    password?: string | undefined;
+    description?: string | undefined;
+    tools?: string[] | undefined;
+    defaultSchema?: string | undefined;
+}, {
+    user: string;
+    host: string;
+    password?: string | undefined;
+    description?: string | undefined;
+    port?: number | undefined;
+    readOnly?: boolean | undefined;
+    tools?: string[] | undefined;
+    ignoreUnauthorized?: boolean | undefined;
+    timeout?: number | undefined;
+    defaultSchema?: string | undefined;
+    confirm?: boolean | undefined;
+    maxRows?: number | undefined;
+}>;
+/** Schema for the full CLI config file. */
+export declare const CliConfigSchema: z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["table", "json", "csv", "markdown"]>>;
+    systems: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        host: z.ZodString;
+        port: z.ZodDefault<z.ZodNumber>;
+        user: z.ZodString;
+        password: z.ZodOptional<z.ZodString>;
+        defaultSchema: z.ZodOptional<z.ZodString>;
+        readOnly: z.ZodDefault<z.ZodBoolean>;
+        confirm: z.ZodDefault<z.ZodBoolean>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+        maxRows: z.ZodDefault<z.ZodNumber>;
+        ignoreUnauthorized: z.ZodDefault<z.ZodBoolean>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        user: string;
+        host: string;
+        port: number;
+        readOnly: boolean;
+        ignoreUnauthorized: boolean;
+        timeout: number;
+        confirm: boolean;
+        maxRows: number;
+        password?: string | undefined;
+        description?: string | undefined;
+        tools?: string[] | undefined;
+        defaultSchema?: string | undefined;
+    }, {
+        user: string;
+        host: string;
+        password?: string | undefined;
+        description?: string | undefined;
+        port?: number | undefined;
+        readOnly?: boolean | undefined;
+        tools?: string[] | undefined;
+        ignoreUnauthorized?: boolean | undefined;
+        timeout?: number | undefined;
+        defaultSchema?: string | undefined;
+        confirm?: boolean | undefined;
+        maxRows?: number | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    systems: Record<string, {
+        user: string;
+        host: string;
+        port: number;
+        readOnly: boolean;
+        ignoreUnauthorized: boolean;
+        timeout: number;
+        confirm: boolean;
+        maxRows: number;
+        password?: string | undefined;
+        description?: string | undefined;
+        tools?: string[] | undefined;
+        defaultSchema?: string | undefined;
+    }>;
+    default?: string | undefined;
+    format?: "table" | "json" | "markdown" | "csv" | undefined;
+}, {
+    default?: string | undefined;
+    format?: "table" | "json" | "markdown" | "csv" | undefined;
+    systems?: Record<string, {
+        user: string;
+        host: string;
+        password?: string | undefined;
+        description?: string | undefined;
+        port?: number | undefined;
+        readOnly?: boolean | undefined;
+        tools?: string[] | undefined;
+        ignoreUnauthorized?: boolean | undefined;
+        timeout?: number | undefined;
+        defaultSchema?: string | undefined;
+        confirm?: boolean | undefined;
+        maxRows?: number | undefined;
+    }> | undefined;
+}>;
+/** Validate that the default system references an existing system. */
+export declare function validateConfig(config: z.infer<typeof CliConfigSchema>): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/cli/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/cli/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sDAAsD;AACtD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAKH,2CAA2C;AAC3C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI1B,CAAC;AAEH,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACtC,MAAM,EAAE,CAUV"}

package/dist/cli/config/schema.js

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Zod schemas for validating CLI configuration files.
+ * @module cli/config/schema
+ */
+import { z } from "zod";
+/** Schema for a single system configuration entry. */
+export const SystemConfigSchema = z.object({
+    description: z.string().optional(),
+    host: z.string().min(1, "host is required"),
+    port: z.coerce.number().int().positive().default(8076),
+    user: z.string().min(1, "user is required"),
+    password: z.string().optional(),
+    defaultSchema: z.string().optional(),
+    readOnly: z.boolean().default(false),
+    confirm: z.boolean().default(false),
+    timeout: z.coerce.number().int().positive().default(60),
+    maxRows: z.coerce.number().int().positive().default(5000),
+    ignoreUnauthorized: z.boolean().default(true),
+    tools: z.array(z.string()).optional(),
+});
+/** Valid output format values. */
+const OutputFormatEnum = z.enum(["table", "json", "csv", "markdown"]);
+/** Schema for the full CLI config file. */
+export const CliConfigSchema = z.object({
+    default: z.string().optional(),
+    format: OutputFormatEnum.optional(),
+    systems: z.record(z.string(), SystemConfigSchema).default({}),
+});
+/** Validate that the default system references an existing system. */
+export function validateConfig(config) {
+    const errors = [];
+    if (config.default && !config.systems[config.default]) {
+        errors.push(`Default system "${config.default}" is not defined in systems. Available: ${Object.keys(config.systems).join(", ") || "(none)"}`);
+    }
+    return errors;
+}
+//# sourceMappingURL=schema.js.map

package/dist/cli/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/cli/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sDAAsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACzD,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,kCAAkC;AAClC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,MAAuC;IAEvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CACT,mBAAmB,MAAM,CAAC,OAAO,2CAA2C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACjI,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/config/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview TypeScript types for the IBM i CLI configuration system.
+ * @module cli/config/types
+ */
+/** Connection configuration for a single IBM i system. */
+export interface SystemConfig {
+    /** Human-readable description of this system. */
+    description?: string;
+    /** Hostname or IP address of the IBM i system. */
+    host: string;
+    /** Mapepire WebSocket port. Default: 8076. */
+    port: number;
+    /** User profile for authentication. */
+    user: string;
+    /** Password (supports ${ENV_VAR} expansion). */
+    password?: string;
+    /** Default schema/library for queries. */
+    defaultSchema?: string;
+    /** Block mutation queries (INSERT, UPDATE, DELETE, DROP). */
+    readOnly: boolean;
+    /** Require interactive confirmation before executing queries. */
+    confirm: boolean;
+    /** Query execution timeout in seconds. */
+    timeout: number;
+    /** Maximum rows returned per query. */
+    maxRows: number;
+    /** Ignore unauthorized SSL certificates. */
+    ignoreUnauthorized: boolean;
+    /** Additional YAML tool files for this system. */
+    tools?: string[];
+}
+/** Full CLI configuration file structure. */
+export interface CliConfig {
+    /** Name of the default system to use. */
+    default?: string;
+    /** Default output format (table, json, csv, markdown). Overrides TTY auto-detection. */
+    format?: OutputFormat;
+    /** Named system configurations. */
+    systems: Record<string, SystemConfig>;
+}
+/** Resolved system context for a CLI command execution. */
+export interface ResolvedSystem {
+    /** The system name (from config, "env" for legacy env vars). */
+    name: string;
+    /** The resolved system configuration. */
+    config: SystemConfig;
+    /** How this system was resolved. */
+    source: "flag" | "env" | "config-default" | "legacy-env";
+}
+/** Output format options. */
+export type OutputFormat = "table" | "json" | "csv" | "markdown";
+/** Global CLI options passed to every command. */
+export interface GlobalOptions {
+    system?: string;
+    format?: OutputFormat;
+    raw?: boolean;
+    noColor?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,gBAAgB,GAAG,YAAY,CAAC;CAC1D;AAED,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;AAEjE,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/cli/config/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview TypeScript types for the IBM i CLI configuration system.
+ * @module cli/config/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/cli/formatters/output.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Central output controller for the IBM i CLI.
+ * Handles TTY detection, format routing, and consistent output rendering.
+ *
+ * Supports two JSON output modes:
+ * - **Envelope** (default): `{ok, system, host, command, data, meta}` — full result in one object
+ * - **NDJSON** (--stream): One JSON object per row, newline-delimited — for piped workflows
+ *
+ * @module cli/formatters/output
+ */
+import type { OutputFormat, ResolvedSystem } from "../config/types.js";
+import { type ErrorCodeValue } from "../utils/exit-codes.js";
+/**
+ * Set the output file path. When set, all output is buffered and written
+ * to the file on `finalizeOutput()`.
+ */
+export declare function setOutputFile(filePath: string | undefined): void;
+/**
+ * Finalize file output — write buffered content to file and print confirmation to stderr.
+ */
+export declare function finalizeOutput(): void;
+/** Result metadata for output rendering. */
+export interface OutputMeta {
+    /** Number of rows returned. */
+    rowCount: number;
+    /** Whether more rows exist beyond the current result. */
+    hasMore?: boolean;
+    /** Time taken for the query in milliseconds. */
+    elapsedMs?: number;
+    /** The resolved system used for this command. */
+    system?: ResolvedSystem;
+    /** The command name (e.g., "schemas", "sql", "tool:system_status"). */
+    command?: string;
+}
+/**
+ * Detect the appropriate output format.
+ *
+ * Priority: --raw → --format → config format → TTY auto-detect (table/json).
+ */
+export declare function detectFormat(explicitFormat?: OutputFormat, raw?: boolean, configFormat?: OutputFormat): OutputFormat;
+/**
+ * Render query results to stdout in the specified format.
+ */
+export declare function renderOutput(data: Record<string, unknown>[], format: OutputFormat, meta?: OutputMeta): void;
+/**
+ * Render results as NDJSON (newline-delimited JSON) for streaming.
+ * Each row is a separate JSON object on its own line.
+ * Agents and tools like `jq` can process rows incrementally.
+ */
+export declare function renderNdjson(data: Record<string, unknown>[]): void;
+/**
+ * Render an error to stderr. In JSON mode, outputs structured error JSON to stdout
+ * with an error code for programmatic consumption.
+ */
+export declare function renderError(error: Error, format: OutputFormat, system?: ResolvedSystem, errorCode?: ErrorCodeValue): void;
+/**
+ * Render a simple message to stdout (e.g., success confirmation).
+ */
+export declare function renderMessage(message: string, format: OutputFormat): void;
+//# sourceMappingURL=output.d.ts.map