@grimoirelabs/cli 0.1.0

package/dist/commands/history.js

@@ -0,0 +1,68 @@
+/**
+ * History Command
+ * View execution history for spells
+ */
+import { join } from "node:path";
+import { SqliteStateStore } from "@grimoirelabs/core";
+import chalk from "chalk";
+export async function historyCommand(spellId, options) {
+    const dbPath = options.stateDir ? join(options.stateDir, "grimoire.db") : undefined;
+    const store = new SqliteStateStore({ dbPath });
+    try {
+        if (!spellId) {
+            // List all spells with state
+            const spells = await store.listSpells();
+            if (spells.length === 0) {
+                console.log(chalk.dim("No spell state found. Run a spell first."));
+                return;
+            }
+            if (options.json) {
+                console.log(JSON.stringify(spells, null, 2));
+                return;
+            }
+            console.log(chalk.cyan("Spells with saved state:"));
+            console.log();
+            for (const id of spells) {
+                const runs = await store.getRuns(id, 1);
+                const lastRun = runs[0];
+                if (lastRun) {
+                    const status = lastRun.success ? chalk.green("ok") : chalk.red("fail");
+                    console.log(`  ${chalk.white(id)}  ${status}  ${chalk.dim(lastRun.timestamp)}`);
+                }
+                else {
+                    console.log(`  ${chalk.white(id)}  ${chalk.dim("(no runs)")}`);
+                }
+            }
+        }
+        else {
+            // Show runs for specific spell
+            const limit = options.limit ? Number.parseInt(options.limit, 10) : 20;
+            const runs = await store.getRuns(spellId, limit);
+            if (runs.length === 0) {
+                console.log(chalk.dim(`No runs found for spell "${spellId}".`));
+                return;
+            }
+            if (options.json) {
+                console.log(JSON.stringify(runs, null, 2));
+                return;
+            }
+            console.log(chalk.cyan(`Run history for ${chalk.white(spellId)}:`));
+            console.log();
+            for (const run of runs) {
+                const status = run.success ? chalk.green("ok  ") : chalk.red("FAIL");
+                const duration = chalk.dim(`${run.duration}ms`);
+                const steps = chalk.dim(`${run.metrics.stepsExecuted} steps`);
+                const actions = chalk.dim(`${run.metrics.actionsExecuted} actions`);
+                const errors = run.metrics.errors > 0 ? chalk.red(` ${run.metrics.errors} errors`) : "";
+                console.log(`  ${status}  ${chalk.dim(run.runId.slice(0, 8))}  ${chalk.dim(run.timestamp)}  ${duration}  ${steps}  ${actions}${errors}`);
+                if (run.error) {
+                    console.log(`        ${chalk.red(run.error)}`);
+                }
+            }
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Init Command
+ * Scaffolds a new .grimoire directory
+ */
+interface InitOptions {
+    force?: boolean;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0HD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDrE"}

package/dist/commands/init.js

@@ -0,0 +1,174 @@
+/**
+ * Init Command
+ * Scaffolds a new .grimoire directory
+ */
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+const DEFAULT_CONFIG = `# Grimoire Configuration
+
+# RPC endpoints
+rpc:
+  ethereum: "https://eth.llamarpc.com"
+  arbitrum: "https://arb1.arbitrum.io/rpc"
+  base: "https://mainnet.base.org"
+
+# Wallet configuration
+wallet:
+  mode: approval-required  # read-only | approval-required | limited
+  connector: mcp-wallet    # mcp-wallet | walletconnect | hardware
+
+# Default constraints
+defaults:
+  max_slippage_bps: 50
+  tx_deadline_seconds: 300
+  simulation_required: true
+`;
+const DEFAULT_ALIASES = `# Default Venue Aliases
+
+# Ethereum Mainnet (Chain ID: 1)
+uniswap_v3_eth:
+  chain: 1
+  address: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"
+  label: "Uniswap V3 Router"
+
+aave_v3_eth:
+  chain: 1
+  address: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"
+  label: "Aave V3 Pool"
+
+morpho_eth:
+  chain: 1
+  address: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
+  label: "Morpho Blue"
+
+# Arbitrum (Chain ID: 42161)
+uniswap_v3_arb:
+  chain: 42161
+  address: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"
+  label: "Uniswap V3 Router"
+
+aave_v3_arb:
+  chain: 42161
+  address: "0x794a61358D6845594F94dc1DB02A252b5b4814aD"
+  label: "Aave V3 Pool"
+
+# Base (Chain ID: 8453)
+uniswap_v3_base:
+  chain: 8453
+  address: "0x2626664c2603336E57B271c5C0b26F421741e481"
+  label: "Uniswap V3 Router"
+
+aave_v3_base:
+  chain: 8453
+  address: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5"
+  label: "Aave V3 Pool"
+
+morpho_base:
+  chain: 8453
+  address: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
+  label: "Morpho Blue"
+`;
+const EXAMPLE_SPELL = `# Example: Simple USDC to ETH swap
+
+spell: example-swap
+version: "1.0.0"
+description: "Swap USDC for ETH on Uniswap V3"
+
+venues:
+  uniswap:
+    chain: 1
+    address: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"
+    label: "Uniswap V3 Router"
+
+params:
+  amount: 1000000000  # 1000 USDC (6 decimals)
+
+assets:
+  USDC:
+    chain: 1
+    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+    decimals: 6
+  WETH:
+    chain: 1
+    address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
+    decimals: 18
+
+trigger:
+  manual: true
+
+steps:
+  - id: check_balance
+    compute:
+      usdc_balance: balance(USDC)
+      has_enough: usdc_balance >= params.amount
+
+  - id: do_swap
+    if: has_enough
+    action:
+      type: swap
+      venue: uniswap
+      asset_in: USDC
+      asset_out: WETH
+      amount: params.amount
+      mode: exact_in
+    constraints:
+      max_slippage: 50
+    on_failure: revert
+
+guards:
+  - id: has_usdc
+    check: balance(USDC) >= params.amount
+    severity: halt
+    message: "Insufficient USDC balance"
+`;
+export async function initCommand(options) {
+    const spinner = ora("Initializing Grimoire...").start();
+    const baseDir = ".grimoire";
+    try {
+        const pathExists = async (path) => {
+            try {
+                await access(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        };
+        // Check if already exists
+        if (await pathExists(baseDir)) {
+            if (!options.force) {
+                spinner.fail(chalk.red(`Directory ${baseDir} already exists. Use --force to overwrite.`));
+                process.exit(1);
+            }
+        }
+        // Create directory structure
+        await mkdir(baseDir, { recursive: true });
+        await mkdir(join(baseDir, "aliases"), { recursive: true });
+        await mkdir(join(baseDir, "spells"), { recursive: true });
+        // Write config file
+        await writeFile(join(baseDir, "config.yaml"), DEFAULT_CONFIG, "utf8");
+        // Write default aliases
+        await writeFile(join(baseDir, "aliases", "default.yaml"), DEFAULT_ALIASES, "utf8");
+        // Write example spell
+        await mkdir(join(baseDir, "spells", "example-swap"), { recursive: true });
+        await writeFile(join(baseDir, "spells", "example-swap", "spell.spell"), EXAMPLE_SPELL, "utf8");
+        spinner.succeed(chalk.green("Grimoire initialized successfully!"));
+        console.log();
+        console.log(chalk.dim("Created:"));
+        console.log(chalk.dim(`  ${baseDir}/config.yaml`));
+        console.log(chalk.dim(`  ${baseDir}/aliases/default.yaml`));
+        console.log(chalk.dim(`  ${baseDir}/spells/example-swap/spell.spell`));
+        console.log();
+        console.log(chalk.cyan("Next steps:"));
+        console.log(chalk.white("  1. Edit your spell in .grimoire/spells/example-swap/spell.spell"));
+        console.log(chalk.white("  2. Run: grimoire validate .grimoire/spells/example-swap/spell.spell"));
+        console.log(chalk.white("  3. Run: grimoire simulate .grimoire/spells/example-swap/spell.spell"));
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to initialize: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/log.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Log Command
+ * View ledger events for a specific spell run
+ */
+interface LogOptions {
+    json?: boolean;
+    stateDir?: string;
+}
+export declare function logCommand(spellId: string, runId: string, options: LogOptions): Promise<void>;
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/commands/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/commands/log.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAgGf"}

package/dist/commands/log.js

@@ -0,0 +1,95 @@
+/**
+ * Log Command
+ * View ledger events for a specific spell run
+ */
+import { join } from "node:path";
+import { SqliteStateStore } from "@grimoirelabs/core";
+import chalk from "chalk";
+export async function logCommand(spellId, runId, options) {
+    const dbPath = options.stateDir ? join(options.stateDir, "grimoire.db") : undefined;
+    const store = new SqliteStateStore({ dbPath });
+    try {
+        const entries = await store.loadLedger(spellId, runId);
+        if (!entries) {
+            console.log(chalk.dim(`No ledger found for spell "${spellId}" run "${runId}".`));
+            // Suggest checking history
+            const runs = await store.getRuns(spellId, 5);
+            if (runs.length > 0) {
+                console.log();
+                console.log(chalk.dim("Recent runs:"));
+                for (const run of runs) {
+                    console.log(chalk.dim(`  ${run.runId}`));
+                }
+            }
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(entries, null, 2));
+            return;
+        }
+        console.log(chalk.cyan(`Ledger for ${chalk.white(spellId)} run ${chalk.white(runId.slice(0, 8))}:`));
+        console.log();
+        for (const entry of entries) {
+            const time = new Date(entry.timestamp).toISOString().split("T")[1]?.replace("Z", "");
+            const eventType = chalk.blue(entry.event.type.padEnd(24));
+            let details = "";
+            switch (entry.event.type) {
+                case "run_started":
+                    details = chalk.dim(`spell=${entry.event.spellId}`);
+                    break;
+                case "run_completed":
+                    details = entry.event.success ? chalk.green("success") : chalk.red("failed");
+                    break;
+                case "run_failed":
+                    details = chalk.red(entry.event.error);
+                    break;
+                case "step_started":
+                    details = chalk.dim(`step=${entry.event.stepId} kind=${entry.event.kind}`);
+                    break;
+                case "step_completed":
+                    details = chalk.dim(`step=${entry.event.stepId}`);
+                    break;
+                case "step_failed":
+                    details = chalk.red(`step=${entry.event.stepId} error=${entry.event.error}`);
+                    break;
+                case "step_skipped":
+                    details = chalk.yellow(`step=${entry.event.stepId} reason=${entry.event.reason}`);
+                    break;
+                case "binding_set":
+                    details = chalk.dim(`${entry.event.name}=${JSON.stringify(entry.event.value)}`);
+                    break;
+                case "guard_passed":
+                    details = chalk.dim(`guard=${entry.event.guardId}`);
+                    break;
+                case "guard_failed":
+                    details = chalk.yellow(`guard=${entry.event.guardId} msg=${entry.event.message}`);
+                    break;
+                case "action_simulated":
+                    details = chalk.dim(`venue=${entry.event.venue}`);
+                    break;
+                case "action_submitted":
+                    details = chalk.dim(`tx=${entry.event.txHash}`);
+                    break;
+                case "action_confirmed":
+                    details = chalk.green(`tx=${entry.event.txHash} gas=${entry.event.gasUsed}`);
+                    break;
+                case "action_reverted":
+                    details = chalk.red(`tx=${entry.event.txHash} reason=${entry.event.reason}`);
+                    break;
+                case "event_emitted":
+                    details = chalk.dim(`event=${entry.event.event}`);
+                    break;
+                case "constraint_evaluated":
+                    details = chalk.dim(`step=${entry.event.stepId}`);
+                    break;
+                default:
+                    details = chalk.dim(JSON.stringify(entry.event));
+            }
+            console.log(`  ${chalk.dim(time)} ${eventType} ${details}`);
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/commands/log.js.map

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

package/dist/commands/simulate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simulate Command
+ * Simulates spell execution (dry run)
+ */
+interface SimulateOptions {
+    params?: string;
+    vault?: string;
+    chain?: string;
+    advisorSkillsDir?: string | string[];
+    stateDir?: string;
+    noState?: boolean;
+}
+export declare function simulateCommand(spellPath: string, options: SimulateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=simulate.d.ts.map

package/dist/commands/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA4GhG"}

package/dist/commands/simulate.js

@@ -0,0 +1,110 @@
+/**
+ * Simulate Command
+ * Simulates spell execution (dry run)
+ */
+import { compileFile, execute } from "@grimoirelabs/core";
+import { adapters } from "@grimoirelabs/venues";
+import chalk from "chalk";
+import ora from "ora";
+import { resolveAdvisorSkillsDirs } from "./advisor-skill-helpers.js";
+import { withStatePersistence } from "./state-helpers.js";
+export async function simulateCommand(spellPath, options) {
+    const spinner = ora(`Simulating ${spellPath}...`).start();
+    try {
+        // Parse params
+        let params = {};
+        if (options.params) {
+            try {
+                params = JSON.parse(options.params);
+            }
+            catch {
+                spinner.fail(chalk.red("Invalid params JSON"));
+                process.exit(1);
+            }
+        }
+        // Compile spell
+        spinner.text = "Compiling spell...";
+        const compileResult = await compileFile(spellPath);
+        if (!compileResult.success || !compileResult.ir) {
+            spinner.fail(chalk.red("Compilation failed"));
+            for (const error of compileResult.errors) {
+                console.log(chalk.red(`  [${error.code}] ${error.message}`));
+            }
+            process.exit(1);
+        }
+        // Execute in simulation mode
+        spinner.text = "Executing simulation...";
+        const vault = (options.vault ?? "0x0000000000000000000000000000000000000000");
+        const chain = Number.parseInt(options.chain ?? "1", 10);
+        const spell = compileResult.ir;
+        const advisorSkillsDirs = resolveAdvisorSkillsDirs(options.advisorSkillsDir);
+        const result = await withStatePersistence(spell.id, { stateDir: options.stateDir, noState: options.noState }, async (persistentState) => {
+            return execute({
+                spell,
+                vault,
+                chain,
+                params,
+                persistentState,
+                simulate: true,
+                adapters,
+                advisorSkillsDirs,
+            });
+        });
+        // Report result
+        if (result.success) {
+            spinner.succeed(chalk.green("Simulation completed successfully"));
+        }
+        else {
+            spinner.fail(chalk.red(`Simulation failed: ${result.error}`));
+        }
+        // Show execution summary
+        console.log();
+        console.log(chalk.cyan("Execution Summary:"));
+        console.log(chalk.dim(`  Run ID: ${result.runId}`));
+        console.log(chalk.dim(`  Duration: ${result.duration}ms`));
+        console.log(chalk.dim(`  Steps executed: ${result.metrics.stepsExecuted}`));
+        console.log(chalk.dim(`  Actions executed: ${result.metrics.actionsExecuted}`));
+        console.log(chalk.dim(`  Errors: ${result.metrics.errors}`));
+        // Show final state
+        if (Object.keys(result.finalState).length > 0) {
+            console.log();
+            console.log(chalk.cyan("Final State:"));
+            console.log(chalk.dim(JSON.stringify(result.finalState, null, 2)));
+        }
+        // Show events
+        console.log();
+        console.log(chalk.cyan("Event Log:"));
+        for (const entry of result.ledgerEvents.slice(-10)) {
+            const time = new Date(entry.timestamp).toISOString().split("T")[1]?.replace("Z", "");
+            const eventType = chalk.blue(entry.event.type.padEnd(20));
+            let details = "";
+            if (entry.event.type === "step_started") {
+                details = chalk.dim(`step=${entry.event.stepId}`);
+            }
+            else if (entry.event.type === "step_completed") {
+                details = chalk.dim(`step=${entry.event.stepId}`);
+            }
+            else if (entry.event.type === "step_failed") {
+                details = chalk.red(`step=${entry.event.stepId} error=${entry.event.error}`);
+            }
+            else if (entry.event.type === "binding_set") {
+                details = chalk.dim(`${entry.event.name}=${JSON.stringify(entry.event.value)}`);
+            }
+            else if (entry.event.type === "guard_failed") {
+                details = chalk.yellow(`guard=${entry.event.guardId} msg=${entry.event.message}`);
+            }
+            console.log(`  ${chalk.dim(time)} ${eventType} ${details}`);
+        }
+        if (result.ledgerEvents.length > 10) {
+            console.log(chalk.dim(`  ... and ${result.ledgerEvents.length - 10} more events`));
+        }
+        if (!result.success) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Simulation failed: ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=simulate.js.map

package/dist/commands/simulate.js.map

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

package/dist/commands/state-helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared state persistence helpers for CLI commands
+ */
+import { type ExecutionResult } from "@grimoirelabs/core";
+interface StatePersistenceOptions {
+    stateDir?: string;
+    noState?: boolean;
+}
+/**
+ * Wraps an execution function with state load/save lifecycle.
+ *
+ * 1. Load persistent state from the store
+ * 2. Call executeFn with the loaded state
+ * 3. Save updated state, run record, and ledger
+ */
+export declare function withStatePersistence(spellId: string, options: StatePersistenceOptions, executeFn: (persistentState: Record<string, unknown>) => Promise<ExecutionResult>): Promise<ExecutionResult>;
+export {};
+//# sourceMappingURL=state-helpers.d.ts.map

package/dist/commands/state-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/state-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,oBAAoB,CAAC;AAE7F,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,GAChF,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/commands/state-helpers.js

@@ -0,0 +1,34 @@
+/**
+ * Shared state persistence helpers for CLI commands
+ */
+import { join } from "node:path";
+import { SqliteStateStore, createRunRecord } from "@grimoirelabs/core";
+/**
+ * Wraps an execution function with state load/save lifecycle.
+ *
+ * 1. Load persistent state from the store
+ * 2. Call executeFn with the loaded state
+ * 3. Save updated state, run record, and ledger
+ */
+export async function withStatePersistence(spellId, options, executeFn) {
+    if (options.noState) {
+        return executeFn({});
+    }
+    const dbPath = options.stateDir ? join(options.stateDir, "grimoire.db") : undefined;
+    const store = new SqliteStateStore({ dbPath });
+    try {
+        // Load existing state
+        const persistentState = (await store.load(spellId)) ?? {};
+        // Execute
+        const result = await executeFn(persistentState);
+        // Persist results
+        await store.save(spellId, result.finalState);
+        await store.addRun(spellId, createRunRecord(result));
+        await store.saveLedger(spellId, result.runId, result.ledgerEvents);
+        return result;
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=state-helpers.js.map

package/dist/commands/state-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-helpers.js","sourceRoot":"","sources":["../../src/commands/state-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAwB,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO7F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,OAAgC,EAChC,SAAiF;IAEjF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpF,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,eAAe,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAE1D,UAAU;QACV,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,CAAC;QAEhD,kBAAkB;QAClB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAEnE,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validate Command
+ * Validates a .spell file
+ */
+interface ValidateOptions {
+    strict?: boolean;
+}
+export declare function validateCommand(spellPath: string, options: ValidateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEhG"}