@siglo/cli 0.0.0-stage → 1.0.1

package/dist/bin.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const index_1 = require("./index");
+function printHelp() {
+    console.log(`
+siglo CLI v1.0.1
+
+USAGE:
+    siglo <command> [arguments] [options]
+
+COMMANDS:
+    init [dir]                     Scaffold a starter siglo project
+    generate workflow <name>       Scaffold a new typed workflow with test
+    generate step <name>           Scaffold a new typed step with test
+    visualize <workflow-file>      Render workflow graph as Mermaid or text diagram
+    export <workflow-file>         Export workflow graph as mermaid, json, or dot
+    validate <workflow-file>       Statically validate workflow definitions for cycles
+    inspect <workflow-file>        Display workflow AST metrics and step summary
+    checkpoint <file>              Inspect a serialized checkpoint state JSON
+    replay <fixture> [workflow]    Replay execution against a recorded test fixture
+    monitor [workflow-file]        Launch live workflow monitoring dashboard
+    reconcile [workflow-file]      Reconcile and compensate abandoned/stuck workflows
+
+OPTIONS:
+    --type=generic|http|crypto|notification|ai  Step template (default: generic)
+    --url=<url> --provider=<provider> --model=<id>  Template configuration
+    --channel=<channel> --interactive=true|false   Notification configuration
+    --format=mermaid|text|dot|json Output format (default: mermaid)
+    --direction=TD|LR|TB           Diagram flow direction (default: TD)
+    --out=<file>                   Write output directly to file instead of stdout
+    --redact=field1,field2         Comma-separated list of fields/nodes to redact
+    --help, -h                     Show this help documentation
+    --version, -v                  Print version
+`);
+}
+async function loadWorkflowFromFile(filePath) {
+    const resolvedPath = path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Workflow file not found: ${resolvedPath}`);
+    }
+    // Dynamic import of target workflow file
+    const mod = await Promise.resolve(`${resolvedPath}`).then(s => __importStar(require(s)));
+    const flowCandidate = mod.default || mod.workflow || mod.pipeline || Object.values(mod).find((v) => v && (v.isFlow || typeof v.run === 'function'));
+    if (!flowCandidate) {
+        throw new Error(`No exported Flow found in ${resolvedPath}. Export a flow as default or named export.`);
+    }
+    if (typeof flowCandidate === 'function' && !flowCandidate.isFlow) {
+        return flowCandidate();
+    }
+    return flowCandidate;
+}
+function getOption(args, prefix) {
+    const arg = args.find(a => a.startsWith(prefix));
+    return arg ? arg.slice(prefix.length) : undefined;
+}
+function writeOutput(content, outPath) {
+    if (outPath) {
+        const resolved = path.resolve(process.cwd(), outPath);
+        fs.mkdirSync(path.dirname(resolved), { recursive: true });
+        fs.writeFileSync(resolved, content, 'utf-8');
+        console.log(`✔ Output written to ${resolved}`);
+    }
+    else {
+        console.log(content);
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        return;
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log('1.0.1');
+        return;
+    }
+    const command = args[0];
+    const target = args[1];
+    const outArg = getOption(args, '--out=');
+    try {
+        switch (command) {
+            case 'init': {
+                const targetDir = target || process.cwd();
+                const res = (0, index_1.initProject)(targetDir);
+                console.log(`\n✔ Initialized siglo workflow project in ${targetDir}`);
+                for (const f of res.filesCreated) {
+                    console.log(`  + ${f}`);
+                }
+                break;
+            }
+            case 'generate': {
+                const subType = target;
+                const name = args[2];
+                if (!subType || !name) {
+                    console.error('Error: specify generator type and name (e.g. siglo generate workflow order)');
+                    process.exit(1);
+                }
+                if (subType === 'workflow') {
+                    const res = (0, index_1.generateWorkflow)(name);
+                    console.log(`✔ Generated workflow in ${res.filePath}`);
+                    console.log(`✔ Generated workflow test in ${res.testPath}`);
+                }
+                else if (subType === 'step') {
+                    const options = {};
+                    for (const arg of args.slice(3)) {
+                        const match = /^--(type|url|provider|model|channel|interactive)=(.*)$/.exec(arg);
+                        if (!match || match[1] in options)
+                            throw new Error(`Invalid or duplicate generator option: ${arg}`);
+                        options[match[1]] = match[1] === 'interactive'
+                            ? match[2] === 'true' ? true : match[2] === 'false' ? false : match[2]
+                            : match[2];
+                    }
+                    const res = (0, index_1.generateStep)(name, process.cwd(), options);
+                    console.log(`✔ Generated step in ${res.filePath}`);
+                    console.log(`✔ Generated step test in ${res.testPath}`);
+                }
+                else {
+                    console.error(`Unknown generator type: '${subType}'. Use 'workflow' or 'step'.`);
+                    process.exit(1);
+                }
+                break;
+            }
+            case 'visualize': {
+                if (!target) {
+                    console.error('Error: specify workflow file path (e.g. siglo visualize src/workflow.ts)');
+                    process.exit(1);
+                }
+                const wf = await loadWorkflowFromFile(target);
+                const format = getOption(args, '--format=') || 'mermaid';
+                const vis = (0, index_1.visualizeWorkflow)(wf);
+                const content = format === 'text' ? vis.text : vis.mermaid;
+                writeOutput(content, outArg);
+                break;
+            }
+            case 'export': {
+                if (!target) {
+                    console.error('Error: specify workflow file path (e.g. siglo export src/workflow.ts)');
+                    process.exit(1);
+                }
+                const wf = await loadWorkflowFromFile(target);
+                const format = (getOption(args, '--format=') || 'mermaid');
+                const direction = (getOption(args, '--direction=') || 'TD');
+                const exported = (0, index_1.exportWorkflow)(wf, { format, direction });
+                writeOutput(exported, outArg);
+                break;
+            }
+            case 'validate': {
+                if (!target) {
+                    console.error('Error: specify workflow file path (e.g. siglo validate src/workflow.ts)');
+                    process.exit(1);
+                }
+                const wf = await loadWorkflowFromFile(target);
+                const val = (0, index_1.validateWorkflow)(wf);
+                if (val.valid) {
+                    console.log('✔ Workflow graph is valid (acyclic, reachable)');
+                }
+                else {
+                    console.error('✖ Workflow validation failed:');
+                    for (const err of val.errors) {
+                        console.error(`  - ${err}`);
+                    }
+                    process.exit(1);
+                }
+                break;
+            }
+            case 'inspect': {
+                if (!target) {
+                    console.error('Error: specify workflow file path (e.g. siglo inspect src/workflow.ts)');
+                    process.exit(1);
+                }
+                const wf = await loadWorkflowFromFile(target);
+                const redactStr = getOption(args, '--redact=');
+                const redactList = redactStr ? redactStr.split(',') : [];
+                const report = (0, index_1.inspectWorkflow)(wf, { redact: redactList });
+                writeOutput(JSON.stringify(report, null, 2), outArg);
+                break;
+            }
+            case 'checkpoint': {
+                if (!target) {
+                    console.error('Error: specify checkpoint JSON file (e.g. siglo checkpoint stack-state.json)');
+                    process.exit(1);
+                }
+                const cpPath = path.resolve(process.cwd(), target);
+                const content = fs.readFileSync(cpPath, 'utf-8');
+                const redactStr = getOption(args, '--redact=');
+                const redactList = redactStr ? redactStr.split(',') : [];
+                const inspected = (0, index_1.inspectCheckpoint)(content, { redact: redactList });
+                writeOutput(JSON.stringify(inspected, null, 2), outArg);
+                break;
+            }
+            case 'replay': {
+                if (!target) {
+                    console.error('Error: specify fixture file (e.g. siglo replay fixture.json [workflow.ts])');
+                    process.exit(1);
+                }
+                const wfPath = args[2] || 'src/workflow.ts';
+                const wf = await loadWorkflowFromFile(wfPath);
+                const fixturePath = path.resolve(process.cwd(), target);
+                const result = await (0, index_1.replayFixture)(wf, fixturePath);
+                if (result.success) {
+                    console.log(`✔ Replay passed in ${result.durationMs}ms`);
+                }
+                else {
+                    console.error('✖ Replay failed with discrepancies:', JSON.stringify(result.diff, null, 2));
+                    process.exit(1);
+                }
+                break;
+            }
+            case 'monitor': {
+                const portStr = getOption(args, '--port=');
+                const port = portStr ? parseInt(portStr, 10) : 4000;
+                const host = getOption(args, '--host=') || '0.0.0.0';
+                const ns = getOption(args, '--namespace=');
+                let wf;
+                if (target && !target.startsWith('--')) {
+                    try {
+                        wf = await loadWorkflowFromFile(target);
+                    }
+                    catch (e) {
+                        console.warn(`Warning: Could not load workflow ${target}: ${e.message}`);
+                    }
+                }
+                const monitor = await (0, index_1.startMonitor)({ port, host, namespace: ns, flow: wf });
+                console.log(`🚀 Siglo Live Monitor running at http://${host === "0.0.0.0" ? "localhost" : host}:${monitor.port}`);
+                console.log(`   - Dashboard: http://localhost:${monitor.port}/`);
+                console.log(`   - SSE Stream: http://localhost:${monitor.port}/events`);
+                console.log(`   - WebSocket: ws://localhost:${monitor.port}/ws`);
+                console.log(`   - Prometheus Metrics: http://localhost:${monitor.port}/metrics`);
+                break;
+            }
+            case 'reconcile': {
+                const staleStr = getOption(args, '--stale-threshold=') || '10m';
+                const actionArg = (getOption(args, '--action=') || 'compensate');
+                const modeArg = (getOption(args, '--mode=') || 'best-effort');
+                const ns = getOption(args, '--namespace=');
+                let wf;
+                if (target && !target.startsWith('--')) {
+                    try {
+                        wf = await loadWorkflowFromFile(target);
+                    }
+                    catch (e) {
+                        console.warn(`Warning: Could not load workflow ${target}: ${e.message}`);
+                    }
+                }
+                const report = await (0, index_1.reconcileCommand)({
+                    staleThreshold: staleStr,
+                    action: actionArg,
+                    mode: modeArg,
+                    namespace: ns,
+                    flow: wf
+                });
+                writeOutput(JSON.stringify(report, null, 2), outArg);
+                break;
+            }
+            default: {
+                console.error(`Unknown command: ${command}`);
+                printHelp();
+                process.exit(1);
+            }
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err?.message || err}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import { GenerateStepOptions } from './step-templates';
+export type { GenerateStepOptions } from './step-templates';
+import { Flow, GraphValidationResult, GraphInspectionResult } from '@siglo/core';
+export interface WorkflowVisualizationResult {
+    mermaid: string;
+    text: string;
+    nodeCount: number;
+    hasCycles: boolean;
+}
+export interface ReplayFixture {
+    name?: string;
+    version?: string;
+    initialParam: Record<string, any>;
+    expectedOutputs?: Record<string, any>;
+    checkpoints?: any[];
+}
+export interface ReplayResult {
+    success: boolean;
+    durationMs: number;
+    finalContext: Record<string, any>;
+    diff?: Record<string, {
+        expected: any;
+        actual: any;
+    }>;
+}
+/**
+ * Renders a GraphInspectionResult as a Mermaid flowchart diagram.
+ */
+export declare function toMermaid(inspection: GraphInspectionResult): string;
+/**
+ * Renders a GraphInspectionResult as an indented ASCII text tree diagram.
+ */
+export declare function toTextGraph(inspection: GraphInspectionResult): string;
+/**
+ * Visualizes a siglo workflow graph as Mermaid and text flowchart representations.
+ */
+export declare function visualizeWorkflow(workflow: Flow): WorkflowVisualizationResult;
+/**
+ * Statically validates a workflow graph definition.
+ */
+export declare function validateWorkflow(workflow: Flow): GraphValidationResult;
+/**
+ * Returns a diagnostic inspection report for a workflow with optional field redaction.
+ */
+export declare function inspectWorkflow(workflow: Flow, options?: {
+    redact?: string[];
+}): GraphInspectionResult & {
+    redactedFields?: string[];
+};
+/**
+ * Replays a workflow execution against a recorded test fixture.
+ */
+export declare function replayFixture(workflow: Flow, fixture: ReplayFixture | string): Promise<ReplayResult>;
+/**
+ * Inspects a serialized checkpoint with optional field redaction.
+ */
+export declare function inspectCheckpoint(checkpoint: any | string, options?: {
+    redact?: string[];
+}): Record<string, any>;
+/**
+ * Scaffolds a new starter siglo project directory.
+ */
+export declare function initProject(targetDir?: string): {
+    filesCreated: string[];
+};
+/**
+ * Scaffolds a new typed workflow file and test.
+ */
+export declare function generateWorkflow(name: string, targetDir?: string): {
+    filePath: string;
+    testPath: string;
+};
+/**
+ * Scaffolds a new typed step file and test.
+ */
+export declare function generateStep(name: string, targetDir?: string, options?: GenerateStepOptions): {
+    filePath: string;
+    testPath: string;
+};
+export interface ExportWorkflowOptions {
+    format?: "mermaid" | "dot" | "json";
+    direction?: "TD" | "LR" | "TB";
+    includeBadges?: boolean;
+}
+/**
+ * Exports a workflow graph to Mermaid, Graphviz DOT, or JSON format.
+ */
+export declare function exportWorkflow(workflow: any, options?: ExportWorkflowOptions): string;
+export interface MonitorOptions {
+    port?: number;
+    host?: string;
+    open?: boolean;
+    namespace?: string;
+    flow?: any;
+}
+/**
+ * Starts the live workflow monitoring dev server and web dashboard.
+ */
+export declare function startMonitor(options?: MonitorOptions): Promise<any>;
+export interface ReconcileCommandOptions {
+    staleThreshold?: string;
+    action?: "compensate" | "fail" | "inspect";
+    mode?: "strict" | "best-effort";
+    namespace?: string;
+    flow?: any;
+    stacks?: any[];
+}
+/**
+ * Reconciles abandoned workflow stacks stuck in RUNNING state past a stale threshold.
+ */
+export declare function reconcileCommand(options?: ReconcileCommandOptions): Promise<any>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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