@ariacode/cli 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,170 @@
+import { z } from "zod";
+/**
+ * Provider configuration
+ * Supports Anthropic, OpenAI, Ollama, and OpenRouter
+ */
+export declare const ProviderConfigSchema: z.ZodObject<{
+    default: z.ZodDefault<z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+        ollama: "ollama";
+        openrouter: "openrouter";
+    }>>;
+    model: z.ZodDefault<z.ZodString>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;
+/**
+ * Agent configuration
+ * Controls agent loop behavior and execution mode
+ */
+export declare const AgentConfigSchema: z.ZodObject<{
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        plan: "plan";
+        build: "build";
+    }>>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+/**
+ * Safety configuration
+ * Enforces boundaries and resource limits
+ */
+export declare const SafetyConfigSchema: z.ZodObject<{
+    requireConfirmForShell: z.ZodDefault<z.ZodBoolean>;
+    allowedShellCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxFileSizeKb: z.ZodDefault<z.ZodNumber>;
+    maxFilesPerPatch: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type SafetyConfig = z.infer<typeof SafetyConfigSchema>;
+/**
+ * UI configuration
+ * Controls terminal output formatting
+ */
+export declare const UIConfigSchema: z.ZodObject<{
+    color: z.ZodDefault<z.ZodEnum<{
+        never: "never";
+        auto: "auto";
+        always: "always";
+    }>>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UIConfig = z.infer<typeof UIConfigSchema>;
+/**
+ * History configuration
+ * Controls session retention policy
+ */
+export declare const HistoryConfigSchema: z.ZodObject<{
+    retainDays: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type HistoryConfig = z.infer<typeof HistoryConfigSchema>;
+/**
+ * Complete configuration schema
+ * Combines all configuration sections
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    provider: z.ZodObject<{
+        default: z.ZodDefault<z.ZodEnum<{
+            anthropic: "anthropic";
+            openai: "openai";
+            ollama: "ollama";
+            openrouter: "openrouter";
+        }>>;
+        model: z.ZodDefault<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    agent: z.ZodObject<{
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            plan: "plan";
+            build: "build";
+        }>>;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    safety: z.ZodObject<{
+        requireConfirmForShell: z.ZodDefault<z.ZodBoolean>;
+        allowedShellCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        maxFileSizeKb: z.ZodDefault<z.ZodNumber>;
+        maxFilesPerPatch: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    ui: z.ZodObject<{
+        color: z.ZodDefault<z.ZodEnum<{
+            never: "never";
+            auto: "auto";
+            always: "always";
+        }>>;
+        quiet: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    history: z.ZodObject<{
+        retainDays: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Configuration error with context
+ */
+export declare class ConfigError extends Error {
+    readonly source?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, source?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Parse a TOML configuration file
+ * @param filePath - Path to the TOML file
+ * @returns Parsed configuration object
+ * @throws ConfigError if file cannot be read or parsed
+ */
+export declare function parseConfigFile(filePath: string): unknown;
+/**
+ * Configuration source for precedence tracking
+ */
+export interface ConfigSource {
+    provider?: Partial<ProviderConfig>;
+    agent?: Partial<AgentConfig>;
+    safety?: Partial<SafetyConfig>;
+    ui?: Partial<UIConfig>;
+    history?: Partial<HistoryConfig>;
+}
+/**
+ * CLI flags that can override configuration
+ */
+export interface CLIFlags {
+    dryRun?: boolean;
+    assumeYes?: boolean;
+    quiet?: boolean;
+    maxTokens?: number;
+    mode?: "plan" | "build";
+    color?: "auto" | "always" | "never";
+}
+/**
+ * Load and merge configuration from all sources with correct precedence
+ * Precedence order (highest to lowest):
+ * 1. CLI flags
+ * 2. Environment variables
+ * 3. Project config (./.aria.toml)
+ * 4. User config (~/.aria/config.toml)
+ * 5. Defaults (from zod schemas)
+ *
+ * @param projectRoot - Project root directory for loading ./.aria.toml
+ * @param flags - CLI flags
+ * @returns Merged configuration from all sources
+ */
+export declare function loadConfig(projectRoot: string, flags?: CLIFlags): ConfigSource;
+/**
+ * Validate and normalize configuration
+ * @param config - Raw configuration from all sources
+ * @returns Validated and normalized configuration
+ * @throws ConfigError if validation fails
+ */
+export declare function validateConfig(config: ConfigSource): Config;
+/**
+ * Load, merge, and validate configuration from all sources
+ * This is the main entry point for configuration loading
+ *
+ * @param projectRoot - Project root directory
+ * @param flags - CLI flags
+ * @returns Validated configuration
+ * @throws ConfigError if loading or validation fails
+ */
+export declare function getConfig(projectRoot: string, flags?: CLIFlags): Config;

package/dist/config.js

@@ -0,0 +1,291 @@
+import { z } from "zod";
+import { ExecutionModeSchema } from "./context.js";
+import { parse as parseToml } from "smol-toml";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * Provider configuration
+ * Supports Anthropic, OpenAI, Ollama, and OpenRouter
+ */
+export const ProviderConfigSchema = z.object({
+    default: z
+        .enum(["anthropic", "openai", "ollama", "openrouter"])
+        .default("anthropic"),
+    model: z.string().default("claude-sonnet-4-6"),
+    maxTokens: z.number().int().positive().default(4096),
+});
+/**
+ * Agent configuration
+ * Controls agent loop behavior and execution mode
+ */
+export const AgentConfigSchema = z.object({
+    maxIterations: z.number().int().positive().default(25),
+    mode: ExecutionModeSchema.default("build"),
+    timeoutSeconds: z.number().int().positive().default(120),
+});
+/**
+ * Safety configuration
+ * Enforces boundaries and resource limits
+ */
+export const SafetyConfigSchema = z.object({
+    requireConfirmForShell: z.boolean().default(true),
+    allowedShellCommands: z
+        .array(z.string())
+        .default(["npm", "pnpm", "yarn", "npx", "git", "prisma", "tsc", "node"]),
+    maxFileSizeKb: z.number().int().positive().default(1024),
+    maxFilesPerPatch: z.number().int().positive().default(50),
+});
+/**
+ * UI configuration
+ * Controls terminal output formatting
+ */
+export const UIConfigSchema = z.object({
+    color: z.enum(["auto", "always", "never"]).default("auto"),
+    quiet: z.boolean().default(false),
+});
+/**
+ * History configuration
+ * Controls session retention policy
+ */
+export const HistoryConfigSchema = z.object({
+    retainDays: z.number().int().positive().default(90),
+});
+/**
+ * Complete configuration schema
+ * Combines all configuration sections
+ */
+export const ConfigSchema = z.object({
+    provider: ProviderConfigSchema,
+    agent: AgentConfigSchema,
+    safety: SafetyConfigSchema,
+    ui: UIConfigSchema,
+    history: HistoryConfigSchema,
+});
+/**
+ * Configuration error with context
+ */
+export class ConfigError extends Error {
+    source;
+    cause;
+    constructor(message, source, cause) {
+        super(message);
+        this.source = source;
+        this.cause = cause;
+        this.name = "ConfigError";
+    }
+}
+/**
+ * Parse a TOML configuration file
+ * @param filePath - Path to the TOML file
+ * @returns Parsed configuration object
+ * @throws ConfigError if file cannot be read or parsed
+ */
+export function parseConfigFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return parseToml(content);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Check if it's a file not found error
+            if ("code" in error && error.code === "ENOENT") {
+                throw new ConfigError(`Configuration file not found: ${filePath}`, filePath, error);
+            }
+            // Check if it's a TOML parse error
+            if (error.message.includes("TOML") || error.message.includes("parse")) {
+                throw new ConfigError(`Invalid TOML syntax in ${filePath}: ${error.message}`, filePath, error);
+            }
+            // Generic error
+            throw new ConfigError(`Failed to read configuration file ${filePath}: ${error.message}`, filePath, error);
+        }
+        throw new ConfigError(`Unknown error reading configuration file ${filePath}`, filePath, error);
+    }
+}
+/**
+ * Load configuration from a TOML file if it exists
+ * @param filePath - Path to the TOML file
+ * @returns Parsed configuration or empty object if file doesn't exist
+ */
+function loadConfigFile(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return {};
+        }
+        const parsed = parseConfigFile(filePath);
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof ConfigError && error.cause) {
+            const cause = error.cause;
+            if (cause.code === "ENOENT") {
+                return {};
+            }
+        }
+        throw error;
+    }
+}
+/**
+ * Load configuration from environment variables
+ * @returns Configuration from environment variables
+ */
+function loadEnvironmentConfig() {
+    const config = {};
+    // Provider configuration
+    const validProviders = ["anthropic", "openai", "ollama", "openrouter"];
+    if (process.env.ARIA_PROVIDER) {
+        const p = process.env.ARIA_PROVIDER;
+        if (validProviders.includes(p)) {
+            config.provider = { default: p };
+        }
+    }
+    if (process.env.ARIA_MODEL) {
+        config.provider = { ...config.provider, model: process.env.ARIA_MODEL };
+    }
+    if (process.env.ARIA_MAX_TOKENS) {
+        const maxTokens = parseInt(process.env.ARIA_MAX_TOKENS, 10);
+        if (!isNaN(maxTokens)) {
+            config.provider = { ...config.provider, maxTokens };
+        }
+    }
+    // Agent configuration
+    if (process.env.ARIA_MAX_ITERATIONS) {
+        const maxIterations = parseInt(process.env.ARIA_MAX_ITERATIONS, 10);
+        if (!isNaN(maxIterations)) {
+            config.agent = { maxIterations };
+        }
+    }
+    if (process.env.ARIA_TIMEOUT_SECONDS) {
+        const timeoutSeconds = parseInt(process.env.ARIA_TIMEOUT_SECONDS, 10);
+        if (!isNaN(timeoutSeconds)) {
+            config.agent = { ...config.agent, timeoutSeconds };
+        }
+    }
+    // UI configuration
+    const validColorModes = ["auto", "always", "never"];
+    if (process.env.ARIA_COLOR) {
+        const c = process.env.ARIA_COLOR;
+        if (validColorModes.includes(c)) {
+            config.ui = { color: c };
+        }
+    }
+    if (process.env.ARIA_QUIET) {
+        config.ui = { ...config.ui, quiet: process.env.ARIA_QUIET === "true" };
+    }
+    // History configuration
+    if (process.env.ARIA_RETAIN_DAYS) {
+        const retainDays = parseInt(process.env.ARIA_RETAIN_DAYS, 10);
+        if (!isNaN(retainDays)) {
+            config.history = { retainDays };
+        }
+    }
+    return config;
+}
+/**
+ * Convert CLI flags to configuration overrides
+ * @param flags - CLI flags
+ * @returns Configuration from CLI flags
+ */
+function flagsToConfig(flags) {
+    const config = {};
+    if (flags.maxTokens !== undefined) {
+        config.provider = { maxTokens: flags.maxTokens };
+    }
+    if (flags.mode !== undefined) {
+        config.agent = { mode: flags.mode };
+    }
+    if (flags.quiet !== undefined) {
+        config.ui = { quiet: flags.quiet };
+    }
+    if (flags.color !== undefined) {
+        config.ui = { ...config.ui, color: flags.color };
+    }
+    return config;
+}
+/**
+ * Deep merge two configuration sources
+ * Later source takes precedence for defined values
+ */
+function mergeConfigSources(base, override) {
+    return {
+        provider: { ...base.provider, ...override.provider },
+        agent: { ...base.agent, ...override.agent },
+        safety: { ...base.safety, ...override.safety },
+        ui: { ...base.ui, ...override.ui },
+        history: { ...base.history, ...override.history },
+    };
+}
+/**
+ * Load and merge configuration from all sources with correct precedence
+ * Precedence order (highest to lowest):
+ * 1. CLI flags
+ * 2. Environment variables
+ * 3. Project config (./.aria.toml)
+ * 4. User config (~/.aria/config.toml)
+ * 5. Defaults (from zod schemas)
+ *
+ * @param projectRoot - Project root directory for loading ./.aria.toml
+ * @param flags - CLI flags
+ * @returns Merged configuration from all sources
+ */
+export function loadConfig(projectRoot, flags = {}) {
+    // Load from all sources
+    const userConfigPath = path.join(os.homedir(), ".aria", "config.toml");
+    const projectConfigPath = path.join(projectRoot, ".aria.toml");
+    const userConfig = loadConfigFile(userConfigPath);
+    const projectConfig = loadConfigFile(projectConfigPath);
+    const envConfig = loadEnvironmentConfig();
+    const flagConfig = flagsToConfig(flags);
+    // Merge with correct precedence (later overrides earlier)
+    let merged = {};
+    merged = mergeConfigSources(merged, userConfig);
+    merged = mergeConfigSources(merged, projectConfig);
+    merged = mergeConfigSources(merged, envConfig);
+    merged = mergeConfigSources(merged, flagConfig);
+    return merged;
+}
+/**
+ * Validate and normalize configuration
+ * @param config - Raw configuration from all sources
+ * @returns Validated and normalized configuration
+ * @throws ConfigError if validation fails
+ */
+export function validateConfig(config) {
+    try {
+        // Ensure all top-level sections are present as objects so Zod can apply
+        // nested defaults. Zod v4 does not apply defaults when the parent key is
+        // undefined — we must provide at least an empty object for each section.
+        const normalized = {
+            provider: config.provider ?? {},
+            agent: config.agent ?? {},
+            safety: config.safety ?? {},
+            ui: config.ui ?? {},
+            history: config.history ?? {},
+        };
+        const validated = ConfigSchema.parse(normalized);
+        return validated;
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.issues
+                .map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`)
+                .join("\n");
+            throw new ConfigError(`Configuration validation failed:\n${issues}`, undefined, error);
+        }
+        throw new ConfigError("Unknown configuration validation error", undefined, error);
+    }
+}
+/**
+ * Load, merge, and validate configuration from all sources
+ * This is the main entry point for configuration loading
+ *
+ * @param projectRoot - Project root directory
+ * @param flags - CLI flags
+ * @returns Validated configuration
+ * @throws ConfigError if loading or validation fails
+ */
+export function getConfig(projectRoot, flags = {}) {
+    const merged = loadConfig(projectRoot, flags);
+    return validateConfig(merged);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+/**
+ * Execution mode determines which tools are available
+ * - plan: Read-only mode, no mutations allowed
+ * - build: Normal mode, mutations allowed with confirmation
+ */
+export declare const ExecutionModeSchema: z.ZodEnum<{
+    plan: "plan";
+    build: "build";
+}>;
+export type ExecutionMode = z.infer<typeof ExecutionModeSchema>;
+/**
+ * ExecutionContext is passed to all commands and tools
+ * Enforces safety boundaries and execution mode
+ */
+export declare const ExecutionContextSchema: z.ZodObject<{
+    projectRoot: z.ZodString;
+    sessionId: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<{
+        plan: "plan";
+        build: "build";
+    }>>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    assumeYes: z.ZodDefault<z.ZodBoolean>;
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ExecutionContext = z.infer<typeof ExecutionContextSchema>;
+/**
+ * Risk level for mutations
+ */
+export declare const RiskLevelSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+}>;
+export type RiskLevel = z.infer<typeof RiskLevelSchema>;
+/**
+ * MutationSummary provides a preview of changes before execution
+ * Every mutation must produce this summary for user review
+ */
+export declare const MutationSummarySchema: z.ZodObject<{
+    action: z.ZodString;
+    affectedFiles: z.ZodArray<z.ZodString>;
+    commandsToRun: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    migrations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    riskLevel: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    reversible: z.ZodBoolean;
+    rollbackHints: z.ZodArray<z.ZodString>;
+    diffId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MutationSummary = z.infer<typeof MutationSummarySchema>;

package/dist/context.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import * as nodePath from "node:path";
+/**
+ * Execution mode determines which tools are available
+ * - plan: Read-only mode, no mutations allowed
+ * - build: Normal mode, mutations allowed with confirmation
+ */
+export const ExecutionModeSchema = z.enum(["plan", "build"]);
+/**
+ * ExecutionContext is passed to all commands and tools
+ * Enforces safety boundaries and execution mode
+ */
+export const ExecutionContextSchema = z.object({
+    projectRoot: z.string().refine((path) => nodePath.isAbsolute(path), {
+        message: "projectRoot must be absolute path",
+    }),
+    sessionId: z.string().uuid(),
+    provider: z.string(),
+    model: z.string(),
+    mode: ExecutionModeSchema.default("build"),
+    dryRun: z.boolean().default(false),
+    assumeYes: z.boolean().default(false),
+    maxIterations: z.number().int().positive().default(25),
+    timeoutSeconds: z.number().int().positive().default(120),
+});
+/**
+ * Risk level for mutations
+ */
+export const RiskLevelSchema = z.enum(["low", "medium", "high"]);
+/**
+ * MutationSummary provides a preview of changes before execution
+ * Every mutation must produce this summary for user review
+ */
+export const MutationSummarySchema = z.object({
+    action: z.string(),
+    affectedFiles: z.array(z.string()),
+    commandsToRun: z.array(z.string()).default([]),
+    migrations: z.array(z.string()).default([]),
+    riskLevel: RiskLevelSchema,
+    reversible: z.boolean(),
+    rollbackHints: z.array(z.string()),
+    diffId: z.string().optional(),
+});
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAG7D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EACnC;QACE,OAAO,EAAE,mCAAmC;KAC7C,CACF;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CACzD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAGjE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CLI argument parsing and validation — extracted for testability.
+ * This module has no side effects and does not call process.exit directly.
+ */
+export interface ParsedArgs {
+    command: string | null;
+    question?: string;
+    goal?: string;
+    description?: string;
+    dryRun: boolean;
+    assumeYes: boolean;
+    session?: string;
+    quiet: boolean;
+    format: "text" | "json";
+    maxTokens?: number;
+    output?: string;
+    unstaged?: boolean;
+    branch?: string;
+    depth?: number;
+    save?: boolean;
+    limit?: number;
+    tree?: boolean;
+    configSubcommand?: "get" | "set" | "path" | "init";
+    configKey?: string;
+    configValue?: string;
+}
+export declare const GLOBAL_USAGE: string;
+export declare const COMMAND_USAGE: Record<string, string>;
+/**
+ * Parse an argv array into a typed ParsedArgs object.
+ * Requirements: 2.1, 2.2, 2.3, 2.4, 2.7, 2.8
+ */
+export declare function parseCLI(argv?: string[]): ParsedArgs;
+/**
+ * Validate parsed arguments.
+ * Calls process.exit(2) on invalid arguments.
+ * Requirements: 2.5, 2.6
+ */
+export declare function validateArgs(args: ParsedArgs): void;