@rcrsr/rill-cli 0.6.0

package/dist/cli-module-loader.js

@@ -0,0 +1,83 @@
+/**
+ * CLI Module Loader
+ *
+ * Implements module loading for the Rill CLI with circular dependency detection.
+ * See docs/integration-modules.md for module convention specification.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { parse } from '@rcrsr/rill';
+import { execute, createRuntimeContext } from '@rcrsr/rill';
+/**
+ * Load a module and its dependencies recursively.
+ *
+ * @param specifier - Module path (relative or absolute)
+ * @param fromPath - Path of the importing file
+ * @param cache - Module cache keyed by canonical path
+ * @param chain - Set of paths in current import chain for circular detection
+ * @returns Dict of exported values
+ * @throws Error if module not found or circular dependency detected
+ */
+export async function loadModule(specifier, fromPath, cache, chain = new Set()) {
+    // Resolve to absolute canonical path
+    const absolutePath = path.resolve(path.dirname(fromPath), specifier);
+    // Check for circular dependency
+    if (chain.has(absolutePath)) {
+        const cycle = [...chain, absolutePath].join(' -> ');
+        throw new Error(`Circular dependency detected: ${cycle}`);
+    }
+    // Return cached module if already loaded
+    if (cache.has(absolutePath)) {
+        return cache.get(absolutePath);
+    }
+    // Check if module file exists
+    try {
+        await fs.access(absolutePath);
+    }
+    catch {
+        throw new Error(`Module not found: ${specifier}`);
+    }
+    // Add to chain to detect cycles in dependencies
+    chain.add(absolutePath);
+    try {
+        // Load and parse module source
+        const source = await fs.readFile(absolutePath, 'utf-8');
+        const ast = parse(source);
+        // Extract frontmatter (yaml.parse returns null for empty content)
+        const frontmatter = ast.frontmatter
+            ? (yaml.parse(ast.frontmatter.content) ?? {})
+            : {};
+        // Resolve dependencies first
+        const imports = {};
+        if (frontmatter['use'] && Array.isArray(frontmatter['use'])) {
+            for (const entry of frontmatter['use']) {
+                if (typeof entry === 'object' && entry !== null) {
+                    const [name, depPath] = Object.entries(entry)[0];
+                    imports[name] = await loadModule(depPath, absolutePath, cache, chain);
+                }
+            }
+        }
+        // Execute module with dependencies
+        const ctx = createRuntimeContext({ variables: imports });
+        const result = await execute(ast, ctx);
+        // Extract exports
+        const exports = {};
+        const exportList = frontmatter['export'];
+        if (Array.isArray(exportList)) {
+            for (const name of exportList) {
+                if (typeof name === 'string' && result.variables[name] !== undefined) {
+                    exports[name] = result.variables[name];
+                }
+            }
+        }
+        // Cache and return
+        cache.set(absolutePath, exports);
+        return exports;
+    }
+    finally {
+        // Remove from chain after processing
+        chain.delete(absolutePath);
+    }
+}
+//# sourceMappingURL=cli-module-loader.js.map

package/dist/cli-module-loader.js.map

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

package/dist/cli-shared.d.ts

@@ -0,0 +1,62 @@
+/**
+ * CLI Shared Utilities
+ * Common formatting functions for CLI tools
+ */
+import { VERSION } from '@rcrsr/rill';
+import type { RillValue } from '@rcrsr/rill';
+import { type ScopeInfo } from './cli-error-enrichment.js';
+import { type FormatOptions } from './cli-error-formatter.js';
+/**
+ * Convert execution result to human-readable string
+ *
+ * @param value - The value to format
+ * @returns Formatted string representation
+ */
+export declare function formatOutput(value: RillValue): string;
+/**
+ * Format error for stderr output
+ *
+ * When source is available, uses enrichment pipeline to add source snippets and suggestions.
+ * Otherwise, falls back to simple formatting for backward compatibility.
+ *
+ * @param err - The error to format
+ * @param source - Optional source code for enrichment
+ * @param options - Optional format options (defaults to human format)
+ * @param scope - Optional scope information for suggestions
+ * @returns Formatted error message
+ */
+export declare function formatError(err: Error, source?: string, options?: Partial<FormatOptions>, scope?: ScopeInfo): string;
+/**
+ * Determine exit code from script result
+ *
+ * Implements exit code semantics per language spec:
+ * - true / non-empty string: exit 0
+ * - false / empty string: exit 1
+ * - [0, "message"]: exit 0 with message
+ * - [1, "message"]: exit 1 with message
+ *
+ * @param value - The script return value
+ * @returns Exit code and optional message
+ */
+export declare function determineExitCode(value: RillValue): {
+    code: number;
+    message?: string;
+};
+/**
+ * Detect help or version flags in CLI argument array.
+ * Checks for --help, -h, --version, -v in any position.
+ *
+ * @param argv - Command-line arguments (process.argv.slice(2))
+ * @returns Object with mode if flag found, null otherwise
+ */
+export declare function detectHelpVersionFlag(argv: string[]): {
+    mode: 'help' | 'version';
+} | null;
+/**
+ * Package version string (re-exported from version-data.ts)
+ *
+ * This replaces the previous async readVersion() function with a synchronous constant.
+ * The version is now generated at build time by packages/core/scripts/generate-version.ts.
+ */
+export { VERSION };
+//# sourceMappingURL=cli-shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-shared.d.ts","sourceRoot":"","sources":["../src/cli-shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAQrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,KAAK,EACV,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,GAChB,MAAM,CA6DR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAgCA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,GACb;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CASrC;AAED;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli-shared.js

@@ -0,0 +1,158 @@
+/**
+ * CLI Shared Utilities
+ * Common formatting functions for CLI tools
+ */
+import { isCallable, VERSION } from '@rcrsr/rill';
+import { ParseError, RuntimeError } from '@rcrsr/rill';
+import { LexerError } from '@rcrsr/rill';
+import { enrichError } from './cli-error-enrichment.js';
+import { formatError as formatEnrichedError, } from './cli-error-formatter.js';
+/**
+ * Convert execution result to human-readable string
+ *
+ * @param value - The value to format
+ * @returns Formatted string representation
+ */
+export function formatOutput(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (isCallable(value))
+        return '[closure]';
+    return JSON.stringify(value, null, 2);
+}
+/**
+ * Format error for stderr output
+ *
+ * When source is available, uses enrichment pipeline to add source snippets and suggestions.
+ * Otherwise, falls back to simple formatting for backward compatibility.
+ *
+ * @param err - The error to format
+ * @param source - Optional source code for enrichment
+ * @param options - Optional format options (defaults to human format)
+ * @param scope - Optional scope information for suggestions
+ * @returns Formatted error message
+ */
+export function formatError(err, source, options, scope) {
+    // IC-12: Use enrichment pipeline when source is available and error is RillError
+    if (source !== undefined &&
+        (err instanceof LexerError ||
+            err instanceof ParseError ||
+            err instanceof RuntimeError)) {
+        try {
+            const enriched = enrichError(err, source, scope);
+            const formatOpts = {
+                format: options?.format ?? 'human',
+                verbose: options?.verbose ?? false,
+                includeCallStack: options?.includeCallStack ?? false,
+                maxCallStackDepth: options?.maxCallStackDepth ?? 10,
+            };
+            return formatEnrichedError(enriched, formatOpts);
+        }
+        catch {
+            // If enrichment fails, fall back to simple formatting
+        }
+    }
+    // IC-12: Fallback to existing behavior for backward compatibility
+    if (err instanceof LexerError) {
+        const location = err.location;
+        return `Lexer error at line ${location.line}: ${err.message.replace(/ at \d+:\d+$/, '')}`;
+    }
+    if (err instanceof ParseError) {
+        const location = err.location;
+        if (location) {
+            return `Parse error at line ${location.line}: ${err.message.replace(/ at \d+:\d+$/, '')}`;
+        }
+        return `Parse error: ${err.message}`;
+    }
+    if (err instanceof RuntimeError) {
+        const location = err.location;
+        const baseMessage = err.message.replace(/ at \d+:\d+$/, '');
+        if (location) {
+            return `Runtime error at line ${location.line}: ${baseMessage}`;
+        }
+        return `Runtime error: ${baseMessage}`;
+    }
+    // Handle file not found errors (ENOENT)
+    if (err instanceof Error &&
+        'code' in err &&
+        err.code === 'ENOENT' &&
+        'path' in err) {
+        return `File not found: ${err.path}`;
+    }
+    // Handle module errors
+    if (err.message.includes('Cannot find module')) {
+        return `Module error: ${err.message}`;
+    }
+    return err.message;
+}
+/**
+ * Determine exit code from script result
+ *
+ * Implements exit code semantics per language spec:
+ * - true / non-empty string: exit 0
+ * - false / empty string: exit 1
+ * - [0, "message"]: exit 0 with message
+ * - [1, "message"]: exit 1 with message
+ *
+ * @param value - The script return value
+ * @returns Exit code and optional message
+ */
+export function determineExitCode(value) {
+    // Handle tuple format: [code, message]
+    if (Array.isArray(value)) {
+        if (value.length >= 2) {
+            const code = value[0];
+            const message = value[1];
+            // Validate code is 0 or 1
+            if (typeof code === 'number' && (code === 0 || code === 1)) {
+                // Return with message if provided as string
+                if (typeof message === 'string' && message !== '') {
+                    return { code, message };
+                }
+                return { code };
+            }
+        }
+        // Non-conforming array: treat as truthy (exit 0)
+        return { code: 0 };
+    }
+    // Boolean values
+    if (typeof value === 'boolean') {
+        return { code: value ? 0 : 1 };
+    }
+    // String values
+    if (typeof value === 'string') {
+        return { code: value === '' ? 1 : 0 };
+    }
+    // All other values (number, dict, closure, etc.) are truthy: exit 0
+    return { code: 0 };
+}
+/**
+ * Detect help or version flags in CLI argument array.
+ * Checks for --help, -h, --version, -v in any position.
+ *
+ * @param argv - Command-line arguments (process.argv.slice(2))
+ * @returns Object with mode if flag found, null otherwise
+ */
+export function detectHelpVersionFlag(argv) {
+    // Help takes precedence over version
+    if (argv.includes('--help') || argv.includes('-h')) {
+        return { mode: 'help' };
+    }
+    if (argv.includes('--version') || argv.includes('-v')) {
+        return { mode: 'version' };
+    }
+    return null;
+}
+/**
+ * Package version string (re-exported from version-data.ts)
+ *
+ * This replaces the previous async readVersion() function with a synchronous constant.
+ * The version is now generated at build time by packages/core/scripts/generate-version.ts.
+ */
+export { VERSION };
+//# sourceMappingURL=cli-shared.js.map

package/dist/cli-shared.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Run rill scripts from the command line
+ *
+ * @deprecated Use rill-exec or rill-eval commands instead. This file will be removed in v1.0.
+ *
+ * Usage:
+ *   npx tsx src/cli.ts <script.rill>
+ *   npx tsx src/cli.ts -e "code"
+ *   echo "code" | npx tsx src/cli.ts -
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Run rill scripts from the command line
+ *
+ * @deprecated Use rill-exec or rill-eval commands instead. This file will be removed in v1.0.
+ *
+ * Usage:
+ *   npx tsx src/cli.ts <script.rill>
+ *   npx tsx src/cli.ts -e "code"
+ *   echo "code" | npx tsx src/cli.ts -
+ */
+import * as fs from 'fs';
+import { createRuntimeContext, execute, parse } from '@rcrsr/rill';
+import { formatOutput } from './cli-shared.js';
+async function run(source) {
+    const ctx = createRuntimeContext({
+        callbacks: {
+            onLog: (value) => console.log(formatOutput(value)),
+        },
+    });
+    try {
+        const ast = parse(source);
+        const result = await execute(ast, ctx);
+        console.log(formatOutput(result.value));
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.error('Usage: rill <script.rill> | rill -e "code" | rill -');
+        process.exit(1);
+    }
+    let source;
+    const arg0 = args[0];
+    if (arg0 === '-e') {
+        // Inline code: rill -e "code"
+        if (!args[1]) {
+            console.error('Missing code after -e');
+            process.exit(1);
+        }
+        source = args[1];
+    }
+    else if (arg0 === '-') {
+        // Stdin: echo "code" | rill -
+        source = fs.readFileSync(0, 'utf-8');
+    }
+    else {
+        // File: rill script.rill
+        if (!fs.existsSync(arg0)) {
+            console.error(`File not found: ${arg0}`);
+            process.exit(1);
+        }
+        source = fs.readFileSync(arg0, 'utf-8');
+    }
+    await run(source);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,KAAK,UAAU,GAAG,CAAC,MAAc;IAC/B,MAAM,GAAG,GAAG,oBAAoB,CAAC;QAC/B,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IAEtB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,8BAA8B;QAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACxB,8BAA8B;QAC9B,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/test-internal-import.d.ts

@@ -0,0 +1,2 @@
+export declare function testInternalImport(): void;
+//# sourceMappingURL=test-internal-import.d.ts.map

package/dist/test-internal-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-internal-import.d.ts","sourceRoot":"","sources":["../src/test-internal-import.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/test-internal-import.js

@@ -0,0 +1,7 @@
+// VERIFICATION TEST: This file should cause pnpm install to fail
+// Testing EC-1: CLI imports internal core path → pnpm install fails
+import { Parser } from '@rill-lang/core/src/parser/parser.js';
+export function testInternalImport() {
+    console.log('This should not compile or build successfully');
+}
+//# sourceMappingURL=test-internal-import.js.map

package/dist/test-internal-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-internal-import.js","sourceRoot":"","sources":["../src/test-internal-import.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,oEAAoE;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAE9D,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@rcrsr/rill-cli",
+  "version": "0.6.0",
+  "type": "module",
+  "bin": {
+    "rill-exec": "./dist/cli-exec.js",
+    "rill-eval": "./dist/cli-eval.js",
+    "rill-check": "./dist/cli-check.js"
+  },
+  "dependencies": {
+    "yaml": "^2.8.2",
+    "@rcrsr/rill": "^0.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --config ../../eslint.config.js src/",
+    "check": "pnpm run build && pnpm run test && pnpm run lint"
+  }
+}

package/src/check/config.ts

@@ -0,0 +1,202 @@
+/**
+ * Configuration Loader for rill-check
+ * Loads and validates .rill-check.json configuration files.
+ */
+
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import type { CheckConfig, RuleState, Severity } from './types.js';
+import { VALIDATION_RULES } from './rules/index.js';
+
+// ============================================================
+// CONSTANTS
+// ============================================================
+
+/** Configuration file name */
+const CONFIG_FILE_NAME = '.rill-check.json';
+
+// ============================================================
+// DEFAULT CONFIGURATION
+// ============================================================
+
+/**
+ * Create default configuration with all rules enabled.
+ * Returns configuration where all known rules are set to 'on'.
+ */
+export function createDefaultConfig(): CheckConfig {
+  const rules: Record<string, RuleState> = {};
+  const severity: Record<string, Severity> = {};
+
+  for (const rule of VALIDATION_RULES) {
+    rules[rule.code] = 'on';
+    severity[rule.code] = rule.severity;
+  }
+
+  return { rules, severity };
+}
+
+// ============================================================
+// VALIDATION
+// ============================================================
+
+/**
+ * Validate that a value is a valid RuleState.
+ */
+function isRuleState(value: unknown): value is RuleState {
+  return value === 'on' || value === 'off' || value === 'warn';
+}
+
+/**
+ * Validate that a value is a valid Severity.
+ */
+function isSeverity(value: unknown): value is Severity {
+  return value === 'error' || value === 'warning' || value === 'info';
+}
+
+/**
+ * Validate configuration structure and values.
+ * Throws Error if configuration is invalid.
+ */
+function validateConfig(data: unknown): asserts data is {
+  rules?: Record<string, unknown>;
+  severity?: Record<string, unknown>;
+} {
+  if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+    throw new Error('[RILL-C003] Invalid configuration: must be an object');
+  }
+
+  const config = data as Record<string, unknown>;
+
+  // Validate rules field if present
+  if ('rules' in config) {
+    if (
+      typeof config['rules'] !== 'object' ||
+      config['rules'] === null ||
+      Array.isArray(config['rules'])
+    ) {
+      throw new Error(
+        '[RILL-C003] Invalid configuration: rules must be an object'
+      );
+    }
+
+    const rules = config['rules'] as Record<string, unknown>;
+    for (const [code, state] of Object.entries(rules)) {
+      if (!isRuleState(state)) {
+        throw new Error(
+          `[RILL-C003] Invalid configuration: rule ${code} has invalid state "${state}" (must be 'on', 'off', or 'warn')`
+        );
+      }
+    }
+  }
+
+  // Validate severity field if present
+  if ('severity' in config) {
+    if (
+      typeof config['severity'] !== 'object' ||
+      config['severity'] === null ||
+      Array.isArray(config['severity'])
+    ) {
+      throw new Error(
+        '[RILL-C003] Invalid configuration: severity must be an object'
+      );
+    }
+
+    const severity = config['severity'] as Record<string, unknown>;
+    for (const [code, sev] of Object.entries(severity)) {
+      if (!isSeverity(sev)) {
+        throw new Error(
+          `[RILL-C003] Invalid configuration: rule ${code} has invalid severity "${sev}" (must be 'error', 'warning', or 'info')`
+        );
+      }
+    }
+  }
+}
+
+/**
+ * Validate that all rule codes in config are known rules.
+ * Throws Error if unknown rule code found.
+ */
+function validateRuleCodes(config: CheckConfig): void {
+  const knownRules = new Set(VALIDATION_RULES.map((r) => r.code));
+
+  // Check rules field
+  for (const code of Object.keys(config.rules)) {
+    if (!knownRules.has(code)) {
+      throw new Error(
+        `[RILL-C003] Invalid configuration: unknown rule ${code}`
+      );
+    }
+  }
+
+  // Check severity field
+  for (const code of Object.keys(config.severity)) {
+    if (!knownRules.has(code)) {
+      throw new Error(
+        `[RILL-C003] Invalid configuration: unknown rule ${code}`
+      );
+    }
+  }
+}
+
+// ============================================================
+// CONFIGURATION LOADING
+// ============================================================
+
+/**
+ * Load configuration from .rill-check.json in the specified directory.
+ *
+ * @param cwd - Directory to search for configuration file
+ * @returns CheckConfig object, or null if file not found
+ * @throws Error with "Invalid configuration: {reason}" if JSON is invalid [EC-3]
+ * @throws Error with "Invalid configuration: unknown rule {code}" if unknown rule [EC-4]
+ */
+export function loadConfig(cwd: string): CheckConfig | null {
+  const configPath = join(cwd, CONFIG_FILE_NAME);
+
+  // Return null if file not found (not an error)
+  if (!existsSync(configPath)) {
+    return null;
+  }
+
+  let fileContent: string;
+  try {
+    fileContent = readFileSync(configPath, 'utf-8');
+  } catch (err) {
+    throw new Error(
+      `[RILL-C003] Invalid configuration: failed to read file (${err instanceof Error ? err.message : String(err)})`
+    );
+  }
+
+  // Parse JSON
+  let parsedData: unknown;
+  try {
+    parsedData = JSON.parse(fileContent);
+  } catch (err) {
+    throw new Error(
+      `[RILL-C003] Invalid configuration: invalid JSON (${err instanceof Error ? err.message : String(err)})`
+    );
+  }
+
+  // Validate structure
+  validateConfig(parsedData);
+
+  // Get defaults
+  const defaults = createDefaultConfig();
+
+  // Merge with defaults (parsedData is validated, so we can safely cast)
+  const rules = {
+    ...defaults.rules,
+    ...(parsedData.rules as Record<string, RuleState> | undefined),
+  };
+  const severity = {
+    ...defaults.severity,
+    ...(parsedData.severity as Record<string, Severity> | undefined),
+  };
+
+  const config: CheckConfig = { rules, severity };
+
+  // Validate rule codes
+  validateRuleCodes(config);
+
+  return config;
+}