@rcrsr/rill-cli 0.11.0 → 0.12.0

package/dist/cli-run.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * rill-run: Extension-aware rill script runner.
+ * Loads extensions from rill-config.json, generates bindings, and executes scripts.
+ */
+import type { RunCliOptions } from './run/types.js';
+export declare function parseCliArgs(argv?: string[]): RunCliOptions;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli-run.d.ts.map

package/dist/cli-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-run.d.ts","sourceRoot":"","sources":["../src/cli-run.ts"],"names":[],"mappings":";AACA;;;GAGG;AAyBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAsCpD,wBAAgB,YAAY,CAC1B,IAAI,GAAE,MAAM,EAA0B,GACrC,aAAa,CA6Cf;AAqCD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA0L1C"}

package/dist/cli-run.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+/**
+ * rill-run: Extension-aware rill script runner.
+ * Loads extensions from rill-config.json, generates bindings, and executes scripts.
+ */
+import { readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { config as dotenvConfig } from 'dotenv';
+import { parse, execute, createRuntimeContext, invokeCallable, isScriptCallable, VERSION, } from '@rcrsr/rill';
+import { resolveConfigPath, loadProject, parseMainField, introspectHandler, marshalCliArgs, ConfigError, } from '@rcrsr/rill-config';
+import { explainError } from './cli-explain.js';
+import { runScript } from './run/runner.js';
+// ============================================================
+// HELP TEXT
+// ============================================================
+const USAGE = `\
+Usage: rill-run [args...]
+
+Options:
+  --config <path>           Config file path (default: search from cwd)
+  --format <mode>           Output format: human, json, compact (default: human)
+  --verbose                 Show full error details (default: false)
+  --max-stack-depth <n>     Error stack frame limit (default: 10)
+  --create-bindings           Write bindings source to config-defined file and exit
+  --explain <code>          Print error code documentation
+  --help                    Print this help message and exit
+  --version                 Print version and exit`.trimEnd();
+// ============================================================
+// BASE OPTIONS (used to separate known flags from handler args)
+// ============================================================
+const BASE_OPTIONS = {
+    config: { type: 'string' },
+    format: { type: 'string' },
+    verbose: { type: 'boolean' },
+    'max-stack-depth': { type: 'string' },
+    'create-bindings': { type: 'boolean' },
+    help: { type: 'boolean' },
+    version: { type: 'boolean' },
+    explain: { type: 'string' },
+};
+// ============================================================
+// PARSE ARGS
+// ============================================================
+export function parseCliArgs(argv = process.argv.slice(2)) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: BASE_OPTIONS,
+        allowPositionals: true,
+        strict: false,
+    });
+    if (values['help'] === true) {
+        process.stdout.write(USAGE + '\n');
+        process.exit(0);
+    }
+    if (values['version'] === true) {
+        process.stdout.write(`rill-run ${VERSION}\n`);
+        process.exit(0);
+    }
+    if (positionals.length === 0 && values['create-bindings'] === undefined) {
+        process.stderr.write('Error: no script path provided\n\n' + USAGE + '\n');
+        process.exit(1);
+    }
+    const scriptPath = positionals[0];
+    const scriptArgs = positionals.slice(1);
+    const rawFormat = values['format'];
+    const format = rawFormat === 'json' || rawFormat === 'compact' ? rawFormat : 'human';
+    const rawDepth = values['max-stack-depth'];
+    const parsedDepth = rawDepth !== undefined ? parseInt(rawDepth, 10) : NaN;
+    const maxStackDepth = !isNaN(parsedDepth) && parsedDepth >= 0 ? parsedDepth : 10;
+    return {
+        scriptPath,
+        scriptArgs,
+        config: values['config'] ?? './rill-config.json',
+        format,
+        verbose: values['verbose'] === true,
+        maxStackDepth,
+        explain: values['explain'],
+        createBindings: values['create-bindings'] === true,
+    };
+}
+// ============================================================
+// HANDLER ARG EXTRACTION
+// ============================================================
+/**
+ * Extract unknown flags from argv as handler parameter strings.
+ * Filters out known base options and their values.
+ */
+function extractHandlerArgs(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: BASE_OPTIONS,
+        allowPositionals: true,
+        strict: false,
+    });
+    const knownKeys = new Set(Object.keys(BASE_OPTIONS));
+    const handlerArgs = {};
+    for (const [key, value] of Object.entries(values)) {
+        if (knownKeys.has(key))
+            continue;
+        if (typeof value === 'string') {
+            handlerArgs[key] = value;
+        }
+        else if (value === true) {
+            handlerArgs[key] = '';
+        }
+    }
+    return handlerArgs;
+}
+// ============================================================
+// MAIN
+// ============================================================
+export async function main() {
+    dotenvConfig({ quiet: true });
+    const argv = process.argv.slice(2);
+    const opts = parseCliArgs(argv);
+    if (opts.explain !== undefined) {
+        const doc = explainError(opts.explain);
+        if (doc !== null) {
+            process.stdout.write(doc + '\n');
+        }
+        else {
+            process.stdout.write(`${opts.explain}: No documentation available.\n`);
+        }
+        process.exit(0);
+    }
+    const hasExplicitConfig = opts.config !== './rill-config.json';
+    let configPath;
+    try {
+        configPath = resolveConfigPath({
+            ...(hasExplicitConfig ? { configFlag: opts.config } : {}),
+            cwd: process.cwd(),
+        });
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            process.stderr.write(err.message + '\n');
+            process.exit(1);
+        }
+        throw err;
+    }
+    let project;
+    try {
+        project = await loadProject({
+            configPath,
+            env: process.env,
+            rillVersion: VERSION,
+        });
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            process.stderr.write(err.message + '\n');
+            process.exit(1);
+        }
+        throw err;
+    }
+    // Create bindings and exit early if --create-bindings was set
+    if (opts.createBindings === true) {
+        const extBindingsPath = resolve(process.cwd(), project.config.extensions?.bindings ?? 'bindings/ext.rill');
+        const ctxBindingsPath = resolve(process.cwd(), project.config.context?.bindings ?? 'bindings/context.rill');
+        mkdirSync(dirname(extBindingsPath), { recursive: true });
+        writeFileSync(extBindingsPath, project.extensionBindings + '\n');
+        mkdirSync(dirname(ctxBindingsPath), { recursive: true });
+        writeFileSync(ctxBindingsPath, project.contextBindings + '\n');
+        process.exit(0);
+    }
+    // Handler mode: main field contains "file.rill:handlerName"
+    const mainField = project.config.main;
+    if (mainField !== undefined && mainField.includes(':')) {
+        const { filePath, handlerName } = parseMainField(mainField);
+        const absolutePath = resolve(process.cwd(), filePath);
+        let source;
+        try {
+            source = readFileSync(absolutePath, 'utf-8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(message + '\n');
+            process.exit(1);
+        }
+        let ast;
+        try {
+            ast = parse(source);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(message + '\n');
+            process.exit(1);
+        }
+        const runtimeOptions = {
+            ...project.resolverConfig,
+            parseSource: parse,
+            callbacks: {
+                onLog: (msg) => {
+                    process.stdout.write(msg + '\n');
+                },
+            },
+            maxCallStackDepth: opts.maxStackDepth,
+        };
+        const ctx = createRuntimeContext(runtimeOptions);
+        try {
+            await execute(ast, ctx);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(message + '\n');
+            process.exit(1);
+        }
+        const handlerValue = handlerName !== undefined ? ctx.variables.get(handlerName) : undefined;
+        if (handlerValue === undefined || !isScriptCallable(handlerValue)) {
+            process.stderr.write(`Handler not found: $${handlerName ?? '(none)'} is not a closure\n`);
+            process.exit(1);
+        }
+        const introspection = introspectHandler(handlerValue);
+        const rawHandlerArgs = extractHandlerArgs(argv);
+        let handlerArgs;
+        try {
+            handlerArgs = marshalCliArgs(rawHandlerArgs, introspection.params);
+        }
+        catch (err) {
+            if (err instanceof ConfigError) {
+                process.stderr.write(err.message + '\n');
+                process.exit(1);
+            }
+            throw err;
+        }
+        ctx.pipeValue = handlerArgs;
+        let handlerResult;
+        try {
+            handlerResult = await invokeCallable(handlerValue, [], ctx);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(message + '\n');
+            process.exit(1);
+        }
+        finally {
+            for (const dispose of project.disposes) {
+                try {
+                    await dispose();
+                }
+                catch {
+                    // Ignore dispose errors
+                }
+            }
+        }
+        if (typeof handlerResult === 'string' && handlerResult.length > 0) {
+            process.stdout.write(handlerResult + '\n');
+        }
+        process.exit(0);
+    }
+    // Module mode: use main field as script path, or use CLI positional
+    const scriptPath = mainField !== undefined
+        ? resolve(process.cwd(), mainField)
+        : opts.scriptPath;
+    const runOpts = {
+        ...opts,
+        scriptPath,
+    };
+    const runResult = await runScript(runOpts, project.config, project.extTree, project.extensionBindings, [...project.disposes]);
+    if (runResult.output !== undefined) {
+        process.stdout.write(runResult.output + '\n');
+    }
+    if (runResult.errorOutput !== undefined) {
+        process.stderr.write(runResult.errorOutput + '\n');
+    }
+    process.exit(runResult.exitCode);
+}
+// ============================================================
+// ENTRY
+// ============================================================
+const shouldRunMain = process.env['NODE_ENV'] !== 'test' &&
+    !process.env['VITEST'] &&
+    !process.env['VITEST_WORKER_ID'];
+if (shouldRunMain) {
+    main().catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Fatal error: ${message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli-run.js.map

package/dist/cli-run.js.map

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

package/dist/run/runner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Script runner for rill-run.
+ * Builds runtime options, executes rill scripts, and maps results to exit codes.
+ */
+import { type SchemeResolver } from '@rcrsr/rill';
+import type { NestedExtConfig, RillConfigFile } from '@rcrsr/rill-config';
+import type { RunCliOptions } from './types.js';
+export interface RunResult {
+    readonly exitCode: number;
+    readonly output?: string | undefined;
+    readonly errorOutput?: string | undefined;
+}
+/**
+ * Build a custom module scheme resolver.
+ * - ID 'ext' → returns generated bindings source
+ * - ID 'ext.*' → drills into extTree subtree and returns bindings for that node
+ * - All other IDs → delegates to moduleResolver with the modules config
+ */
+export declare function buildModuleResolver(bindingsSource: string, modulesConfig: Record<string, string>, extTree: NestedExtConfig): SchemeResolver;
+/**
+ * Run a rill script file with the given extension tree and config.
+ */
+export declare function runScript(opts: RunCliOptions, config: RillConfigFile, extTree: NestedExtConfig, bindingsSrc: string, disposes: Array<() => void | Promise<void>>): Promise<RunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/run/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/run/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAWL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AA4CD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,OAAO,EAAE,eAAe,GACvB,cAAc,CAwChB;AA6ID;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAC1C,OAAO,CAAC,SAAS,CAAC,CA4FpB"}

package/dist/run/runner.js

@@ -0,0 +1,258 @@
+/**
+ * Script runner for rill-run.
+ * Builds runtime options, executes rill scripts, and maps results to exit codes.
+ */
+import { readFileSync } from 'node:fs';
+import { parse, execute, createRuntimeContext, extResolver, moduleResolver, toNative, isTuple, } from '@rcrsr/rill';
+import { ParseError, RillError, getCallStack } from '@rcrsr/rill';
+import { buildExtensionBindings, isLeafFunction } from '@rcrsr/rill-config';
+// ============================================================
+// TREE CONVERSION
+// ============================================================
+function convertTreeToRillValues(tree) {
+    const result = {};
+    for (const [key, value] of Object.entries(tree)) {
+        if (typeof value === 'object' &&
+            value !== null &&
+            'fn' in value &&
+            typeof value.fn === 'function' &&
+            'params' in value) {
+            const rillFn = value;
+            result[key] = {
+                __type: 'callable',
+                kind: 'application',
+                isProperty: false,
+                fn: rillFn.fn,
+                params: rillFn.params,
+            };
+        }
+        else {
+            result[key] = convertTreeToRillValues(value);
+        }
+    }
+    return result;
+}
+// ============================================================
+// MODULE RESOLVER
+// ============================================================
+/**
+ * Build a custom module scheme resolver.
+ * - ID 'ext' → returns generated bindings source
+ * - ID 'ext.*' → drills into extTree subtree and returns bindings for that node
+ * - All other IDs → delegates to moduleResolver with the modules config
+ */
+export function buildModuleResolver(bindingsSource, modulesConfig, extTree) {
+    const moduleConfig = {};
+    for (const [id, path] of Object.entries(modulesConfig)) {
+        if (id !== 'ext') {
+            moduleConfig[id] = path;
+        }
+    }
+    const resolver = (resource) => {
+        if (resource === 'ext') {
+            return { kind: 'source', text: bindingsSource };
+        }
+        if (resource.startsWith('ext.')) {
+            const suffix = resource.slice('ext.'.length);
+            const segments = suffix.split('.');
+            let node = extTree;
+            let fullyResolved = true;
+            for (const segment of segments) {
+                const child = node[segment];
+                if (child === undefined) {
+                    fullyResolved = false;
+                    break;
+                }
+                if (isLeafFunction(child)) {
+                    fullyResolved = false;
+                    break;
+                }
+                node = child;
+            }
+            if (fullyResolved && node !== extTree) {
+                const subtreeSource = buildExtensionBindings(node, suffix);
+                return { kind: 'source', text: subtreeSource };
+            }
+        }
+        return moduleResolver(resource, moduleConfig);
+    };
+    return resolver;
+}
+// ============================================================
+// EXIT CODE MAPPING
+// ============================================================
+function mapResultToRunResult(result, format) {
+    if (isTuple(result)) {
+        const tuple = result;
+        if (tuple.entries.length === 2) {
+            const code = tuple.entries[0];
+            const message = tuple.entries[1];
+            if (typeof code === 'number' && typeof message === 'string') {
+                return {
+                    exitCode: code,
+                    output: message.length > 0 ? message : undefined,
+                };
+            }
+        }
+    }
+    if (result === false || result === '') {
+        return { exitCode: 1 };
+    }
+    const formatted = formatOutput(result, format);
+    return { exitCode: 0, output: formatted };
+}
+function formatOutput(value, format) {
+    const native = toNative(value);
+    if (format === 'json' || format === 'compact') {
+        return JSON.stringify(native.value);
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return JSON.stringify(native.value, null, 2);
+}
+// ============================================================
+// ERROR FORMATTING
+// ============================================================
+function resolveSourceSnippet(location, sources, filePath) {
+    if (sources.script !== undefined) {
+        const lines = sources.script.split('\n');
+        const idx = location.line - 1;
+        if (idx >= 0 &&
+            idx < lines.length &&
+            location.column <= lines[idx].length + 1) {
+            return {
+                label: filePath ?? '<script>',
+                ...(lines[idx] !== undefined ? { sourceLine: lines[idx] } : {}),
+            };
+        }
+    }
+    if (sources.bindings !== undefined) {
+        const lines = sources.bindings.split('\n');
+        const idx = location.line - 1;
+        if (idx >= 0 && idx < lines.length) {
+            return {
+                label: '<generated bindings>',
+                ...(lines[idx] !== undefined ? { sourceLine: lines[idx] } : {}),
+            };
+        }
+    }
+    return { label: filePath ?? '<unknown>' };
+}
+function formatRillError(error, verbose, maxStackDepth, filePath, sources) {
+    const data = error.toData();
+    const parts = [];
+    parts.push(`${data.errorId}: ${data.message}`);
+    if (data.location !== undefined && sources !== undefined) {
+        const match = resolveSourceSnippet(data.location, sources, filePath);
+        parts.push(`  at ${match.label}:${data.location.line}:${data.location.column}`);
+        if (match.sourceLine !== undefined) {
+            parts.push('');
+            const lineNum = String(data.location.line);
+            parts.push(`  ${lineNum} | ${match.sourceLine}`);
+            const caretCol = Math.max(0, data.location.column - 1);
+            parts.push(`  ${' '.repeat(lineNum.length)} | ${' '.repeat(caretCol)}^`);
+        }
+    }
+    else if (data.location !== undefined) {
+        parts.push(`  at line ${data.location.line}, column ${data.location.column}`);
+    }
+    if (verbose &&
+        data.context !== undefined &&
+        Object.keys(data.context).length > 0) {
+        parts.push(`  context: ${JSON.stringify(data.context, null, 2)}`);
+    }
+    if (verbose && data.helpUrl !== undefined) {
+        parts.push(`  help: ${data.helpUrl}`);
+    }
+    const frames = getCallStack(error);
+    const visibleFrames = frames.slice(0, maxStackDepth);
+    for (const frame of visibleFrames) {
+        const loc = `${frame.location.start.line}:${frame.location.start.column}`;
+        const name = frame.functionName !== undefined ? ` in ${frame.functionName}` : '';
+        const ctx = frame.context !== undefined ? ` (${frame.context})` : '';
+        parts.push(`  at ${loc}${name}${ctx}`);
+    }
+    return parts.join('\n');
+}
+// ============================================================
+// RUNNER
+// ============================================================
+/**
+ * Run a rill script file with the given extension tree and config.
+ */
+export async function runScript(opts, config, extTree, bindingsSrc, disposes) {
+    if (!opts.scriptPath) {
+        return { exitCode: 1, errorOutput: 'no script path provided' };
+    }
+    let source;
+    try {
+        source = readFileSync(opts.scriptPath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { exitCode: 1, errorOutput: message };
+    }
+    const extConfig = convertTreeToRillValues(extTree);
+    const modulesConfig = config.modules ?? {};
+    const customModuleResolver = buildModuleResolver(bindingsSrc, modulesConfig, extTree);
+    const runtimeOptions = {
+        resolvers: {
+            ext: extResolver,
+            module: customModuleResolver,
+        },
+        configurations: {
+            resolvers: {
+                ext: extConfig,
+            },
+        },
+        parseSource: parse,
+        callbacks: {
+            onLog: (msg) => {
+                process.stdout.write(msg + '\n');
+            },
+        },
+        maxCallStackDepth: opts.maxStackDepth,
+    };
+    const ctx = createRuntimeContext(runtimeOptions);
+    if (opts.scriptArgs.length > 0) {
+        ctx.pipeValue = opts.scriptArgs.join(' ');
+    }
+    let ast;
+    try {
+        ast = parse(source);
+    }
+    catch (err) {
+        if (err instanceof ParseError) {
+            const formatted = formatRillError(err, opts.verbose, opts.maxStackDepth, opts.scriptPath, { script: source });
+            return { exitCode: 1, errorOutput: formatted };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { exitCode: 1, errorOutput: message };
+    }
+    let result;
+    try {
+        const execResult = await execute(ast, ctx);
+        result = execResult.result;
+    }
+    catch (err) {
+        if (err instanceof RillError) {
+            const formatted = formatRillError(err, opts.verbose, opts.maxStackDepth, opts.scriptPath, { script: source, bindings: bindingsSrc });
+            return { exitCode: 1, errorOutput: formatted };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { exitCode: 1, errorOutput: message };
+    }
+    finally {
+        for (const dispose of disposes) {
+            try {
+                await dispose();
+            }
+            catch {
+                // Ignore dispose errors
+            }
+        }
+    }
+    return mapResultToRunResult(result, opts.format);
+}
+//# sourceMappingURL=runner.js.map

package/dist/run/runner.js.map

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

package/dist/run/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type definitions for rill-run.
+ */
+/**
+ * Parsed CLI options from process.argv.
+ */
+export interface RunCliOptions {
+    readonly scriptPath?: string | undefined;
+    readonly scriptArgs: string[];
+    readonly config: string;
+    readonly format: 'human' | 'json' | 'compact';
+    readonly verbose: boolean;
+    readonly maxStackDepth: number;
+    readonly explain?: string | undefined;
+    readonly createBindings?: boolean | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/run/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/run/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/C"}

package/dist/run/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for rill-run.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/run/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill-cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "CLI tools for the rill scripting language",
   "license": "MIT",
   "author": "Andre Bremer",
@@ -15,11 +15,14 @@
   "bin": {
     "rill-exec": "./dist/cli-exec.js",
     "rill-eval": "./dist/cli-eval.js",
-    "rill-check": "./dist/cli-check.js"
+    "rill-check": "./dist/cli-check.js",
+    "rill-run": "./dist/cli-run.js"
   },
   "dependencies": {
+    "dotenv": "^16.0.0",
     "yaml": "^2.8.2",
-    "@rcrsr/rill": "^0.11.0"
+    "@rcrsr/rill": "^0.12.0",
+    "@rcrsr/rill-config": "^0.12.0"
   },
   "files": [
     "dist"