@substrate-ai/factory 0.19.54

package/dist/events.d.ts

@@ -0,0 +1,331 @@
+/**
+ * FactoryEvents — typed event map for factory graph execution events.
+ *
+ * Extends CoreEvents (via intersection) with all factory-specific event types:
+ * graph:started/completed/failed, graph:node-*, graph:edge-*, graph:checkpoint-*,
+ * graph:goal-gate-*, scenario:*, convergence:*
+ *
+ * Payload shapes are sourced from architecture-software-factory.md Section 8.2 and 3.1.
+ *
+ * Every factory-specific event payload includes `runId: string` as its first field.
+ */
+import type { CoreEvents } from '@substrate-ai/core';
+/**
+ * Status of a node handler execution.
+ * Sourced from architecture Section 3.1.
+ */
+export type StageStatus = 'SUCCESS' | 'FAIL' | 'PARTIAL_SUCCESS' | 'RETRY' | 'SKIPPED';
+/**
+ * Result of a node handler execution.
+ * Sourced from architecture Section 3.1.
+ */
+export interface Outcome {
+    status: StageStatus;
+    preferredLabel?: string;
+    suggestedNextIds?: string[];
+    contextUpdates?: Record<string, unknown>;
+    notes?: string;
+    failureReason?: string;
+}
+/**
+ * Result of a single scenario execution.
+ * Sourced from architecture Section 5.1.
+ */
+export interface ScenarioResult {
+    name: string;
+    status: 'pass' | 'fail';
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    /**
+     * Parsed JSON output when the scenario writes valid JSON to stdout.
+     * Omitted (not set to null) when stdout is plain text or empty.
+     * Added in story 44-2.
+     */
+    parsedOutput?: unknown;
+}
+/**
+ * Aggregated result of a scenario validation run.
+ * Sourced from architecture Section 5.1.
+ */
+export interface ScenarioRunResult {
+    scenarios: ScenarioResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+    };
+    durationMs: number;
+}
+/**
+ * Complete typed map of all factory graph execution events.
+ * Intersection with CoreEvents so TypedEventBus<FactoryEvents> includes all core event keys.
+ *
+ * NOTE: Factory graph:* events (graph:started, graph:completed, etc.) are DIFFERENT
+ * from CoreEvents graph:* events (graph:loaded, graph:complete, graph:cancelled).
+ * CoreEvents graph:* = task-graph dispatcher lifecycle.
+ * FactoryEvents graph:* = factory graph execution engine lifecycle.
+ * These are distinct namespaces and do NOT conflict.
+ *
+ * Twin lifecycle events (story 47-2): twin:started, twin:stopped
+ */
+export type FactoryEvents = CoreEvents & {
+    /** Factory graph execution has started */
+    'graph:started': {
+        runId: string;
+        graphFile: string;
+        goal: string;
+        nodeCount: number;
+    };
+    /** Factory graph execution has completed with a final outcome */
+    'graph:completed': {
+        runId: string;
+        finalOutcome: Outcome;
+        totalCostUsd: number;
+        durationMs: number;
+    };
+    /** Factory graph execution has failed */
+    'graph:failed': {
+        runId: string;
+        failureReason: string;
+        lastNodeId: string;
+    };
+    /** A graph node has started execution */
+    'graph:node-started': {
+        runId: string;
+        nodeId: string;
+        nodeType: string;
+    };
+    /** A graph node has completed execution with an outcome */
+    'graph:node-completed': {
+        runId: string;
+        nodeId: string;
+        outcome: Outcome;
+    };
+    /** A graph node is being retried after a failure */
+    'graph:node-retried': {
+        runId: string;
+        nodeId: string;
+        attempt: number;
+        maxAttempts: number;
+        delayMs: number;
+    };
+    /** A graph node has failed */
+    'graph:node-failed': {
+        runId: string;
+        nodeId: string;
+        failureReason: string;
+    };
+    /** An edge was selected during graph traversal */
+    'graph:edge-selected': {
+        runId: string;
+        fromNode: string;
+        toNode: string;
+        step: number;
+        edgeLabel?: string;
+    };
+    /** A graph execution checkpoint has been saved to disk */
+    'graph:checkpoint-saved': {
+        runId: string;
+        nodeId: string;
+        checkpointPath: string;
+    };
+    /** A goal gate was checked for satisfaction */
+    'graph:goal-gate-checked': {
+        runId: string;
+        nodeId: string;
+        satisfied: boolean;
+        score?: number;
+    };
+    /** A goal gate was not satisfied — execution may retry or fail */
+    'graph:goal-gate-unsatisfied': {
+        runId: string;
+        nodeId: string;
+        retryTarget: string | null;
+    };
+    /** Scenario validation run has started */
+    'scenario:started': {
+        runId: string;
+        scenarioCount: number;
+        iteration: number;
+    };
+    /** Scenario validation run has completed */
+    'scenario:completed': {
+        runId: string;
+        results: ScenarioRunResult;
+        iteration: number;
+    };
+    /** Scenario integrity check passed — files unmodified since manifest capture */
+    'scenario:integrity-passed': {
+        runId: string;
+        nodeId: string;
+        scenarioCount: number;
+    };
+    /** Scenario integrity check failed — one or more files were tampered with */
+    'scenario:integrity-failed': {
+        runId: string;
+        nodeId: string;
+        tampered: string[];
+    };
+    /** Dual-signal score computed — code review verdict compared against scenario score — story 46-5 */
+    'scenario:score-computed': {
+        runId: string;
+        score: number;
+        threshold: number;
+        passes: boolean;
+        agreement: 'AGREE' | 'DISAGREE';
+        codeReviewPassed: boolean;
+        scenarioPassed: boolean;
+        authoritativeDecision: string;
+    };
+    /** Code review verdict logged as advisory when scenario is the authoritative decision-maker — story 46-6 */
+    'scenario:advisory-computed': {
+        runId: string;
+        verdict: string;
+        codeReviewPassed: boolean;
+        score: number;
+        threshold: number;
+        agreement: 'AGREE' | 'DISAGREE';
+    };
+    /** A convergence iteration has completed */
+    'convergence:iteration': {
+        runId: string;
+        iteration: number;
+        score: number;
+        threshold: number;
+        passed: boolean;
+    };
+    /** A convergence plateau has been detected — score is not improving */
+    'convergence:plateau-detected': {
+        runId: string;
+        nodeId: string;
+        scores: number[];
+        window: number;
+    };
+    /** Convergence budget has been exhausted at the given level */
+    'convergence:budget-exhausted': {
+        runId: string;
+        level: 'node' | 'pipeline' | 'session';
+        reason: string;
+    };
+    /** Twin container started successfully and health check passed (story 47-2) */
+    'twin:started': {
+        runId?: string;
+        twinName: string;
+        ports: Array<{
+            host: number;
+            container: number;
+        }>;
+        healthStatus: 'healthy' | 'unknown';
+    };
+    /** Twin container stopped and cleaned up (story 47-2) */
+    'twin:stopped': {
+        twinName: string;
+    };
+    /** Twin health check failed mid-run but has not yet exhausted retries (story 47-6) */
+    'twin:health-warning': {
+        runId?: string;
+        twinName: string;
+        error: string;
+        consecutiveFailures: number;
+    };
+    /** Twin confirmed unhealthy — consecutive failure limit exhausted (story 47-6) */
+    'twin:health-failed': {
+        runId?: string;
+        twinName: string;
+        error: string;
+    };
+    /** Factory config value changed during execution via hot-reload */
+    'factory:config-reloaded': {
+        key: string;
+        oldValue: unknown;
+        newValue: unknown;
+    };
+    /** Executor applied fidelity-based context summarization before node dispatch */
+    'graph:context-summarized': {
+        runId: string;
+        nodeId: string;
+        /** SummaryLevel applied: 'high' | 'medium' | 'low' */
+        level: string;
+        /** Estimated token count of the original factory.nodeContext content */
+        originalTokenCount: number;
+        /** Estimated token count of the compressed factory.compressedNodeContext content */
+        summaryTokenCount: number;
+    };
+    /** Parallel node started fan-out execution with N branches (story 50-9) */
+    'graph:parallel-started': {
+        runId: string;
+        nodeId: string;
+        branchCount: number;
+        maxParallel: number;
+        policy: string;
+    };
+    /** A single branch started executing inside a parallel node (story 50-9) */
+    'graph:parallel-branch-started': {
+        runId: string;
+        nodeId: string;
+        branchIndex: number;
+    };
+    /** A single branch completed execution inside a parallel node (story 50-9) */
+    'graph:parallel-branch-completed': {
+        runId: string;
+        nodeId: string;
+        branchIndex: number;
+        status: StageStatus;
+        durationMs: number;
+    };
+    /** Parallel node completed all branches and applied the join policy (story 50-9) */
+    'graph:parallel-completed': {
+        runId: string;
+        nodeId: string;
+        completedCount: number;
+        cancelledCount: number;
+        policy: string;
+    };
+    /** Subgraph handler started executing a nested .dot graph file (story 50-9) */
+    'graph:subgraph-started': {
+        runId: string;
+        nodeId: string;
+        graphFile: string;
+        depth: number;
+    };
+    /** Subgraph handler finished executing a nested .dot graph file (story 50-9) */
+    'graph:subgraph-completed': {
+        runId: string;
+        nodeId: string;
+        graphFile: string;
+        depth: number;
+        status: StageStatus;
+        durationMs: number;
+    };
+    /** An LLM-evaluated edge condition was resolved (story 50-9) */
+    'graph:llm-edge-evaluated': {
+        runId: string;
+        nodeId: string;
+        question: string;
+        result: boolean;
+    };
+    /** Agent tool call started or completed during a direct backend run */
+    'agent:tool-call': {
+        runId: string;
+        nodeId: string;
+        toolName: string;
+        direction: 'call' | 'result';
+        inputSummary?: string;
+    };
+    /** Loop detected in agent session during a direct backend run */
+    'agent:loop-detected': {
+        runId: string;
+        nodeId: string;
+        windowSize: number;
+        pattern: string[];
+    };
+    /** Steering message injected into agent session during a direct backend run */
+    'agent:steering-injected': {
+        runId: string;
+        nodeId: string;
+        message: string;
+    };
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,13 @@
+/**
+ * FactoryEvents — typed event map for factory graph execution events.
+ *
+ * Extends CoreEvents (via intersection) with all factory-specific event types:
+ * graph:started/completed/failed, graph:node-*, graph:edge-*, graph:checkpoint-*,
+ * graph:goal-gate-*, scenario:*, convergence:*
+ *
+ * Payload shapes are sourced from architecture-software-factory.md Section 8.2 and 3.1.
+ *
+ * Every factory-specific event payload includes `runId: string` as its first field.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/factory-command.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Register the `factory` command group on the provided Commander program.
+ *
+ * Subcommand tree:
+ *   factory
+ *     scenarios
+ *       list              — list discovered scenario files with SHA-256 checksums
+ *       run [--format]    — execute all scenarios; text summary or JSON output
+ *     run
+ *       --graph <path>    — execute a DOT graph pipeline
+ *       --events          — emit NDJSON events to stdout
+ *       --config <path>   — path to config.yaml (default: auto-detect)
+ *     twins
+ *       templates         — list available built-in twin templates
+ *       init --template   — initialize a twin definition file from a template
+ *       start             — start all discovered twins via Docker Compose
+ *       stop              — stop all running twins and clean up
+ *       status            — show each twin's name, status, and port mappings
+ *       list              — list all discovered twin definitions
+ *
+ * Story 44-8 (scenarios), Story 44-9 (factory run), Story 46-7 (validate),
+ * Story 47-4 (twins init/templates), Story 47-5 (twins lifecycle).
+ */
+import type { Command } from 'commander';
+import type { DatabaseAdapter } from '@substrate-ai/core';
+/** Options for registerFactoryCommand — allows CLI composition root to inject dependencies. */
+export interface FactoryCommandOptions {
+    /** Optional adapter factory. When provided, used instead of core's createDatabaseAdapter
+     *  to create a Dolt-capable adapter. The monolith CLI injects this with DoltClient. */
+    createAdapter?: (basePath: string) => DatabaseAdapter;
+}
+/**
+ * Register the `factory` command group on the provided Commander program.
+ *
+ * Story 44-8: registers the `scenarios` subcommand.
+ * Story 44-9: registers the `run` subcommand.
+ * Story 46-7: registers the `validate` subcommand.
+ */
+export declare function registerFactoryCommand(program: Command, options?: FactoryCommandOptions): void;
+//# sourceMappingURL=factory-command.d.ts.map

package/dist/factory-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-command.d.ts","sourceRoot":"","sources":["../src/factory-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAyBxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAkEzD,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC;2FACuF;IACvF,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,eAAe,CAAA;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAskB9F"}