@substrate-ai/factory 0.19.54

package/dist/persistence/factory-queries.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Factory persistence query functions for graph runs, node results, and scenario results.
+ *
+ * All functions accept a DatabaseAdapter as first argument, follow the established
+ * pattern from @substrate-ai/core's metrics queries, and use portable SQL patterns
+ * (select-then-delete-then-insert in transactions) compatible with both
+ * InMemoryDatabaseAdapter and DoltDatabaseAdapter.
+ *
+ * Story 46-3: Score Persistence to Database.
+ */
+import type { DatabaseAdapter } from '@substrate-ai/core';
+export interface GraphRunInput {
+    /** Unique run identifier */
+    id: string;
+    /** Path to the DOT graph file */
+    graph_file: string;
+    /** Run goal/objective (optional) */
+    graph_goal?: string;
+    /** Run status: 'running' | 'completed' | 'failed' */
+    status: string;
+    /** ISO timestamp when the run started */
+    started_at: string;
+    /** ISO timestamp when the run completed (optional) */
+    completed_at?: string;
+    /** Total cost in USD (optional) */
+    total_cost_usd?: number;
+    /** Number of nodes in the graph */
+    node_count?: number;
+    /** Final outcome string (optional) */
+    final_outcome?: string;
+    /** Path to checkpoint file (optional) */
+    checkpoint_path?: string;
+}
+export interface GraphRunRow {
+    id: string;
+    graph_file: string;
+    /** Nullable in DB — undefined when column was NULL */
+    graph_goal: string | null;
+    status: string;
+    started_at: string;
+    /** Nullable in DB — null until the run completes */
+    completed_at: string | null;
+    total_cost_usd: number;
+    node_count: number;
+    /** Nullable in DB — null until the run terminates */
+    final_outcome: string | null;
+    /** Nullable in DB — null when no checkpoint was used */
+    checkpoint_path: string | null;
+}
+export interface GraphNodeResultInput {
+    /** Parent run identifier */
+    run_id: string;
+    /** Node identifier */
+    node_id: string;
+    /** Attempt number (1-indexed) */
+    attempt: number;
+    /** Node execution status */
+    status: string;
+    /** ISO timestamp when node started */
+    started_at: string;
+    /** ISO timestamp when node completed (optional) */
+    completed_at?: string;
+    /** Execution duration in milliseconds (optional) */
+    duration_ms?: number;
+    /** Cost in USD for this node (optional, default 0) */
+    cost_usd?: number;
+    /** Failure reason if status is FAIL (optional) */
+    failure_reason?: string;
+    /** JSON snapshot of context at completion (optional) */
+    context_snapshot?: string;
+}
+export interface GraphNodeResultRow {
+    /** Auto-generated row id */
+    id: number;
+    run_id: string;
+    node_id: string;
+    attempt: number;
+    status: string;
+    started_at: string;
+    /** Nullable in DB — null if node was interrupted */
+    completed_at: string | null;
+    /** Nullable in DB — null if not recorded */
+    duration_ms: number | null;
+    cost_usd: number;
+    /** Nullable in DB — null when node succeeded */
+    failure_reason: string | null;
+    /** Nullable in DB — null when not captured */
+    context_snapshot: string | null;
+}
+export interface ScenarioResultInput {
+    /** Parent run identifier */
+    run_id: string;
+    /** Node identifier that triggered the scenario run */
+    node_id: string;
+    /** Convergence iteration number */
+    iteration: number;
+    /** Total number of scenarios */
+    total_scenarios: number;
+    /** Number of scenarios that passed */
+    passed: number;
+    /** Number of scenarios that failed */
+    failed: number;
+    /** Satisfaction score (0.0 – 1.0) */
+    satisfaction_score: number;
+    /** Minimum threshold for passing */
+    threshold: number;
+    /** Whether satisfaction_score >= threshold */
+    passes: boolean;
+    /** JSON-serialized score breakdown (optional) */
+    details?: string;
+    /** ISO timestamp when scenarios were executed (optional) */
+    executed_at?: string;
+}
+export interface ScenarioResultRow {
+    /** Auto-generated row id */
+    id: number;
+    run_id: string;
+    node_id: string;
+    iteration: number;
+    total_scenarios: number;
+    passed: number;
+    failed: number;
+    satisfaction_score: number;
+    threshold: number;
+    passes: boolean;
+    /** Nullable in DB — null when no breakdown details were recorded */
+    details: string | null;
+    executed_at: string;
+}
+/**
+ * Insert or replace a graph_runs row.
+ *
+ * Uses portable select-then-delete-then-insert pattern inside a transaction
+ * (not INSERT OR REPLACE which is SQLite-specific).
+ *
+ * - First call (status: 'running'): inserts the row.
+ * - Second call (status: 'completed'/'failed'): deletes the old row and inserts
+ *   the updated row with completion details.
+ */
+export declare function upsertGraphRun(adapter: DatabaseAdapter, input: GraphRunInput): Promise<void>;
+/**
+ * Append a graph_node_results row for a single node execution attempt.
+ *
+ * Each attempt is a distinct row — no upsert needed since run_id + node_id + attempt
+ * together uniquely identify each record.
+ */
+export declare function insertGraphNodeResult(adapter: DatabaseAdapter, input: GraphNodeResultInput): Promise<void>;
+/**
+ * Append a scenario_results row for a single scenario run iteration.
+ *
+ * The `details` field (score breakdown) should be serialized as JSON string
+ * before calling this function, or passed raw if already serialized.
+ */
+export declare function insertScenarioResult(adapter: DatabaseAdapter, input: ScenarioResultInput): Promise<void>;
+/**
+ * Retrieve all scenario results for a given run, ordered by iteration ascending.
+ *
+ * @returns Array of ScenarioResultRow ordered by iteration. Empty array if none exist.
+ */
+export declare function getScenarioResultsForRun(adapter: DatabaseAdapter, runId: string): Promise<ScenarioResultRow[]>;
+/**
+ * List graph run records in descending started_at order.
+ *
+ * @param limit - Maximum number of rows to return (default 20).
+ */
+export declare function listGraphRuns(adapter: DatabaseAdapter, limit?: number): Promise<GraphRunRow[]>;
+/**
+ * Summarized view of a factory graph run for display in `substrate metrics`.
+ * Combines data from `graph_runs` and `scenario_results`.
+ */
+export interface FactoryRunSummary {
+    /** Unique run identifier */
+    run_id: string;
+    /** Latest satisfaction score (0.0–1.0); null if no scenario results exist */
+    satisfaction_score: number | null;
+    /** Number of scenario result iterations recorded for this run */
+    iterations: number;
+    /** Final outcome of the run (maps to final_outcome in graph_runs); null if not set */
+    convergence_status: string | null;
+    /** ISO timestamp when the run started */
+    started_at: string;
+    /** ISO timestamp when the run completed; null if still running */
+    completed_at: string | null;
+    /** Total cost in USD */
+    total_cost_usd: number;
+    /** Discriminator to distinguish from SDLC runs in JSON output */
+    type: 'factory';
+    /** Whether the latest iteration passed the satisfaction threshold; null if no scenario results */
+    passes: boolean | null;
+}
+/**
+ * Retrieve a summarized list of factory graph runs, enriched with per-run
+ * iteration counts and latest satisfaction scores from `scenario_results`.
+ *
+ * Uses two queries (not a JOIN) for portability across adapters:
+ * 1. SELECT from graph_runs ordered by started_at DESC
+ * 2. GROUP BY aggregation on scenario_results for iteration counts and scores
+ *
+ * @param adapter - Database adapter (already opened)
+ * @param limit   - Maximum number of graph runs to return (default 20)
+ * @returns Array of FactoryRunSummary ordered by started_at DESC; empty array on error
+ */
+export declare function getFactoryRunSummaries(adapter: DatabaseAdapter, limit?: number): Promise<FactoryRunSummary[]>;
+//# sourceMappingURL=factory-queries.d.ts.map

package/dist/persistence/factory-queries.d.ts.map

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

package/dist/persistence/factory-queries.js

@@ -0,0 +1,186 @@
+/**
+ * Factory persistence query functions for graph runs, node results, and scenario results.
+ *
+ * All functions accept a DatabaseAdapter as first argument, follow the established
+ * pattern from @substrate-ai/core's metrics queries, and use portable SQL patterns
+ * (select-then-delete-then-insert in transactions) compatible with both
+ * InMemoryDatabaseAdapter and DoltDatabaseAdapter.
+ *
+ * Story 46-3: Score Persistence to Database.
+ */
+// ---------------------------------------------------------------------------
+// upsertGraphRun
+// ---------------------------------------------------------------------------
+/**
+ * Insert or replace a graph_runs row.
+ *
+ * Uses portable select-then-delete-then-insert pattern inside a transaction
+ * (not INSERT OR REPLACE which is SQLite-specific).
+ *
+ * - First call (status: 'running'): inserts the row.
+ * - Second call (status: 'completed'/'failed'): deletes the old row and inserts
+ *   the updated row with completion details.
+ */
+export async function upsertGraphRun(adapter, input) {
+    await adapter.transaction(async (tx) => {
+        const existing = await tx.query('SELECT id FROM graph_runs WHERE id = ?', [input.id]);
+        if (existing.length > 0) {
+            await tx.query('DELETE FROM graph_runs WHERE id = ?', [input.id]);
+        }
+        await tx.query(`INSERT INTO graph_runs (
+        id, graph_file, graph_goal, status, started_at, completed_at,
+        total_cost_usd, node_count, final_outcome, checkpoint_path
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            input.id,
+            input.graph_file,
+            input.graph_goal ?? null,
+            input.status,
+            input.started_at,
+            input.completed_at ?? null,
+            input.total_cost_usd ?? 0,
+            input.node_count ?? 0,
+            input.final_outcome ?? null,
+            input.checkpoint_path ?? null,
+        ]);
+    });
+}
+// ---------------------------------------------------------------------------
+// insertGraphNodeResult
+// ---------------------------------------------------------------------------
+/**
+ * Append a graph_node_results row for a single node execution attempt.
+ *
+ * Each attempt is a distinct row — no upsert needed since run_id + node_id + attempt
+ * together uniquely identify each record.
+ */
+export async function insertGraphNodeResult(adapter, input) {
+    await adapter.transaction(async (tx) => {
+        await tx.query(`INSERT INTO graph_node_results (
+        run_id, node_id, attempt, status, started_at, completed_at,
+        duration_ms, cost_usd, failure_reason, context_snapshot
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            input.run_id,
+            input.node_id,
+            input.attempt,
+            input.status,
+            input.started_at,
+            input.completed_at ?? null,
+            input.duration_ms ?? null,
+            input.cost_usd ?? 0,
+            input.failure_reason ?? null,
+            input.context_snapshot ?? null,
+        ]);
+    });
+}
+// ---------------------------------------------------------------------------
+// insertScenarioResult
+// ---------------------------------------------------------------------------
+/**
+ * Append a scenario_results row for a single scenario run iteration.
+ *
+ * The `details` field (score breakdown) should be serialized as JSON string
+ * before calling this function, or passed raw if already serialized.
+ */
+export async function insertScenarioResult(adapter, input) {
+    await adapter.transaction(async (tx) => {
+        await tx.query(`INSERT INTO scenario_results (
+        run_id, node_id, iteration, total_scenarios, passed, failed,
+        satisfaction_score, threshold, passes, details, executed_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            input.run_id,
+            input.node_id,
+            input.iteration,
+            input.total_scenarios,
+            input.passed,
+            input.failed,
+            input.satisfaction_score,
+            input.threshold,
+            input.passes ? 1 : 0,
+            input.details ?? null,
+            input.executed_at ?? new Date().toISOString(),
+        ]);
+    });
+}
+// ---------------------------------------------------------------------------
+// getScenarioResultsForRun
+// ---------------------------------------------------------------------------
+/**
+ * Retrieve all scenario results for a given run, ordered by iteration ascending.
+ *
+ * @returns Array of ScenarioResultRow ordered by iteration. Empty array if none exist.
+ */
+export async function getScenarioResultsForRun(adapter, runId) {
+    const rows = await adapter.query('SELECT * FROM scenario_results WHERE run_id = ? ORDER BY iteration ASC', [runId]);
+    // Coerce `passes` from integer (0/1) to boolean — adapters store it as an
+    // integer for portability, so `row.passes` may be 0 or 1 on read.
+    return rows.map((row) => ({ ...row, passes: Boolean(row.passes) }));
+}
+// ---------------------------------------------------------------------------
+// listGraphRuns
+// ---------------------------------------------------------------------------
+/**
+ * List graph run records in descending started_at order.
+ *
+ * @param limit - Maximum number of rows to return (default 20).
+ */
+export async function listGraphRuns(adapter, limit = 20) {
+    return adapter.query('SELECT * FROM graph_runs ORDER BY started_at DESC LIMIT ?', [limit]);
+}
+// ---------------------------------------------------------------------------
+// getFactoryRunSummaries
+// ---------------------------------------------------------------------------
+/**
+ * Retrieve a summarized list of factory graph runs, enriched with per-run
+ * iteration counts and latest satisfaction scores from `scenario_results`.
+ *
+ * Uses two queries (not a JOIN) for portability across adapters:
+ * 1. SELECT from graph_runs ordered by started_at DESC
+ * 2. GROUP BY aggregation on scenario_results for iteration counts and scores
+ *
+ * @param adapter - Database adapter (already opened)
+ * @param limit   - Maximum number of graph runs to return (default 20)
+ * @returns Array of FactoryRunSummary ordered by started_at DESC; empty array on error
+ */
+export async function getFactoryRunSummaries(adapter, limit = 20) {
+    // Query 1: fetch run list
+    const runs = await adapter.query('SELECT id, started_at, completed_at, total_cost_usd, final_outcome FROM graph_runs ORDER BY started_at DESC LIMIT ?', [limit]);
+    if (runs.length === 0) {
+        return [];
+    }
+    // Query 2: aggregate scenario_results by run_id (iteration count and max satisfaction score)
+    const scenarioAgg = await adapter.query('SELECT run_id, COUNT(*) as iterations, MAX(satisfaction_score) as satisfaction_score FROM scenario_results GROUP BY run_id', []);
+    // Query 3: get the passes value from the latest iteration for each run_id.
+    // Using a JOIN with a MAX(iteration) subquery is the most portable approach
+    // (works in both SQLite and MySQL/Dolt) and avoids the MAX(passes) pitfall
+    // where any passing iteration would incorrectly show ✓ for a regressed run.
+    const latestPassesRows = await adapter.query('SELECT s.run_id, s.passes FROM scenario_results s INNER JOIN (SELECT run_id, MAX(iteration) AS max_iter FROM scenario_results GROUP BY run_id) latest ON s.run_id = latest.run_id AND s.iteration = latest.max_iter', []);
+    // Build a lookup map from run_id → scenario aggregation
+    const scenarioMap = new Map();
+    for (const row of scenarioAgg) {
+        scenarioMap.set(row.run_id, {
+            iterations: row.iterations,
+            satisfaction_score: row.satisfaction_score,
+        });
+    }
+    // Build a lookup map from run_id → latest-iteration passes (boolean)
+    const latestPassesMap = new Map();
+    for (const row of latestPassesRows) {
+        latestPassesMap.set(row.run_id, row.passes !== 0);
+    }
+    // Combine
+    return runs.map((run) => {
+        const agg = scenarioMap.get(run.id);
+        return {
+            run_id: run.id,
+            satisfaction_score: agg !== undefined ? agg.satisfaction_score : null,
+            iterations: agg !== undefined ? agg.iterations : 0,
+            convergence_status: run.final_outcome,
+            started_at: run.started_at,
+            completed_at: run.completed_at,
+            total_cost_usd: run.total_cost_usd,
+            type: 'factory',
+            passes: latestPassesMap.has(run.id) ? (latestPassesMap.get(run.id) ?? null) : null,
+        };
+    });
+}
+//# sourceMappingURL=factory-queries.js.map

package/dist/persistence/factory-queries.js.map

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

package/dist/persistence/factory-schema.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Factory schema DDL for graph execution and scenario validation tables.
+ * Companion to `@substrate-ai/core`'s `initSchema` — call both during factory initialization.
+ */
+import type { DatabaseAdapter } from '@substrate-ai/core';
+/**
+ * Initialize all factory-specific persistence tables on the given adapter.
+ * Idempotent — safe to call multiple times.
+ *
+ * Creates:
+ *   - graph_runs: top-level graph execution run records
+ *   - graph_node_results: per-node execution results within a run
+ *   - scenario_results: scenario validation outcomes within a run
+ */
+export declare function factorySchema(adapter: DatabaseAdapter): Promise<void>;
+//# sourceMappingURL=factory-schema.d.ts.map

package/dist/persistence/factory-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-schema.d.ts","sourceRoot":"","sources":["../../src/persistence/factory-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgF3E"}

package/dist/persistence/factory-schema.js

@@ -0,0 +1,89 @@
+/**
+ * Factory schema DDL for graph execution and scenario validation tables.
+ * Companion to `@substrate-ai/core`'s `initSchema` — call both during factory initialization.
+ */
+/**
+ * Initialize all factory-specific persistence tables on the given adapter.
+ * Idempotent — safe to call multiple times.
+ *
+ * Creates:
+ *   - graph_runs: top-level graph execution run records
+ *   - graph_node_results: per-node execution results within a run
+ *   - scenario_results: scenario validation outcomes within a run
+ */
+export async function factorySchema(adapter) {
+    // -- graph_runs (AC1) -------------------------------------------------------
+    await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS graph_runs (
+      id              VARCHAR(255) PRIMARY KEY,
+      graph_file      TEXT NOT NULL,
+      graph_goal      TEXT,
+      status          VARCHAR(32) NOT NULL DEFAULT 'running',
+      started_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      completed_at    DATETIME,
+      total_cost_usd  DOUBLE NOT NULL DEFAULT 0.0,
+      node_count      INTEGER NOT NULL DEFAULT 0,
+      final_outcome   VARCHAR(32),
+      checkpoint_path TEXT
+    )
+  `);
+    // -- graph_node_results (AC2, AC4) ------------------------------------------
+    await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS graph_node_results (
+      id               INTEGER PRIMARY KEY AUTO_INCREMENT,
+      run_id           VARCHAR(255) NOT NULL ,
+      node_id          VARCHAR(255) NOT NULL,
+      attempt          INTEGER NOT NULL DEFAULT 1,
+      status           VARCHAR(32) NOT NULL,
+      started_at       DATETIME NOT NULL,
+      completed_at     DATETIME,
+      duration_ms      INTEGER,
+      cost_usd         DOUBLE NOT NULL DEFAULT 0.0,
+      failure_reason   TEXT,
+      context_snapshot TEXT
+    )
+  `);
+    await adapter.exec('CREATE INDEX IF NOT EXISTS idx_graph_node_results_run ON graph_node_results(run_id)');
+    // -- scenario_results (AC3, AC4) --------------------------------------------
+    await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS scenario_results (
+      id                 INTEGER PRIMARY KEY AUTO_INCREMENT,
+      run_id             VARCHAR(255) NOT NULL ,
+      node_id            VARCHAR(255) NOT NULL,
+      iteration          INTEGER NOT NULL DEFAULT 1,
+      total_scenarios    INTEGER NOT NULL,
+      passed             INTEGER NOT NULL,
+      failed             INTEGER NOT NULL,
+      satisfaction_score DOUBLE NOT NULL,
+      threshold          DOUBLE NOT NULL DEFAULT 0.8,
+      passes             BOOLEAN NOT NULL,
+      details            TEXT,
+      executed_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+    )
+  `);
+    await adapter.exec('CREATE INDEX IF NOT EXISTS idx_scenario_results_run ON scenario_results(run_id)');
+    // -- twin_runs (AC1) --------------------------------------------------------
+    await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS twin_runs (
+      id          VARCHAR(255) PRIMARY KEY,
+      run_id      VARCHAR(255),
+      twin_name   VARCHAR(255) NOT NULL,
+      started_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      stopped_at  DATETIME,
+      status      VARCHAR(32) NOT NULL DEFAULT 'running',
+      ports_json  TEXT
+    )
+  `);
+    // -- twin_health_failures (AC2) ---------------------------------------------
+    await adapter.exec(`
+    CREATE TABLE IF NOT EXISTS twin_health_failures (
+      id            INTEGER PRIMARY KEY AUTO_INCREMENT,
+      twin_name     VARCHAR(255) NOT NULL,
+      run_id        VARCHAR(255),
+      checked_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      error_message TEXT NOT NULL
+    )
+  `);
+    await adapter.exec('CREATE INDEX IF NOT EXISTS idx_twin_health_failures_twin ON twin_health_failures(twin_name)');
+}
+//# sourceMappingURL=factory-schema.js.map

package/dist/persistence/factory-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-schema.js","sourceRoot":"","sources":["../../src/persistence/factory-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAwB;IAC1D,8EAA8E;IAC9E,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;GAalB,CAAC,CAAA;IAEF,8EAA8E;IAC9E,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;GAclB,CAAC,CAAA;IACF,MAAM,OAAO,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAA;IAEzG,8EAA8E;IAC9E,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;GAelB,CAAC,CAAA;IACF,MAAM,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAA;IAErG,8EAA8E;IAC9E,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;GAUlB,CAAC,CAAA;IAEF,8EAA8E;IAC9E,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;;;;GAQlB,CAAC,CAAA;IACF,MAAM,OAAO,CAAC,IAAI,CAChB,6FAA6F,CAC9F,CAAA;AACH,CAAC"}

package/dist/scenarios/__tests__/cli-command-list.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for `scenarios list` and `scenarios run` CLI subcommands.
+ *
+ * Tests AC1–AC4 from story 44-8.
+ */
+export {};
+//# sourceMappingURL=cli-command-list.test.d.ts.map

package/dist/scenarios/__tests__/cli-command-list.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-list.test.d.ts","sourceRoot":"","sources":["../../../src/scenarios/__tests__/cli-command-list.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}