primitive-admin 1.1.0-alpha.44 → 1.1.0-alpha.45

package/dist/src/commands/workflows.js

@@ -1,7 +1,9 @@
-import { readFileSync, writeFileSync, statSync } from "fs";
+import { readFileSync, writeFileSync, statSync, existsSync, readdirSync, } from "fs";
 import { basename } from "path";
+import * as path from "path";
 import { parseConfigToml, stringifyConfigToml } from "../lib/config-toml.js";
 import { lookup as mimeLookup } from "mime-types";
+import { generateWorkflowTypes, } from "../lib/workflow-codegen/generator.js";
 import { ApiClient } from "../lib/api-client.js";
 import { resolveAppId } from "../lib/config.js";
 import { validateWorkflowToml, formatWorkflowTomlErrors, } from "../lib/workflow-toml-validator.js";
@@ -246,7 +248,7 @@ Examples:
     workflows
         .command("get")
         .description("Get workflow details")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
         .action(async (workflowId, options) => {
@@ -327,7 +329,7 @@ Examples:
     workflows
         .command("update")
         .description("Update workflow metadata, or push a new body with --from-file")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--name <name>", "Display name")
         .option("--description <desc>", "Description")
@@ -506,7 +508,7 @@ Examples:
     workflows
         .command("delete")
         .description("Delete or archive a workflow")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--hard", "Permanently delete instead of archive")
         .option("-y, --yes", "Skip confirmation prompt")
@@ -573,7 +575,7 @@ Examples:
     draft
         .command("update")
         .description("Update workflow draft steps (deprecated; use 'workflows configs' for staged rollouts)")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--from-file <path>", "Load steps from TOML file")
         .option("--json", "Output as JSON")
@@ -642,7 +644,7 @@ Examples:
     workflows
         .command("publish")
         .description("Publish the current draft as a new revision (deprecated for new-model workflows; use 'workflows configs activate')")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
         .action(async (workflowId, options) => {
@@ -686,7 +688,7 @@ Examples:
     workflows
         .command("preview")
         .description("Run a preview execution of the workflow")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--config <config-id>", "Use specific configuration")
         .option("--draft", "Force preview of the draft version, even if active is newer")
@@ -841,7 +843,7 @@ Examples:
     runs
         .command("list")
         .description("List workflow runs")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--status <status>", "Filter by status: pending, running, completed, failed")
         .option("--limit <n>", "Number of runs to show", "20")
@@ -879,7 +881,7 @@ Examples:
     runs
         .command("status")
         .description("Get status of a workflow run")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<run-id>", "Run ID")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
@@ -928,7 +930,7 @@ Examples:
     runs
         .command("steps")
         .description("Show step-level details for a workflow run")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<run-id>", "Run ID")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
@@ -978,7 +980,7 @@ Examples:
     runs
         .command("step-detail")
         .description("Show full details for a single step")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<run-id>", "Run ID")
         .argument("<step-id>", "Step ID")
         .option("--app <app-id>", "App ID")
@@ -1100,7 +1102,7 @@ Examples:
     runs
         .command("error")
         .description("Show error details for a failed workflow run")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<run-id>", "Run ID")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
@@ -1169,7 +1171,7 @@ Examples:
     runs
         .command("failures")
         .description("List recent workflow run failures")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID")
         .option("--limit <n>", "Number of failures to show", "10")
         .option("--json", "Output as JSON")
@@ -1398,7 +1400,7 @@ Examples:
     configs
         .command("list")
         .description("List configurations for a workflow")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
         .action(async (workflowId, options) => {
@@ -1438,7 +1440,7 @@ Examples:
     configs
         .command("get")
         .description("Get configuration details")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<config-id>", "Configuration ID")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
@@ -1474,7 +1476,7 @@ Examples:
     configs
         .command("create")
         .description("Create a new configuration")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--name <name>", "Configuration name (required)")
         .option("--description <desc>", "Description")
@@ -1528,7 +1530,7 @@ Examples:
     configs
         .command("update")
         .description("Update a configuration")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<config-id>", "Configuration ID")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--name <name>", "Configuration name")
@@ -1584,7 +1586,7 @@ Examples:
     configs
         .command("activate")
         .description("Set a configuration as the active (default) configuration")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<config-id>", "Configuration ID")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--json", "Output as JSON")
@@ -1609,7 +1611,7 @@ Examples:
     configs
         .command("duplicate")
         .description("Duplicate a configuration")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<config-id>", "Configuration ID to duplicate")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("--name <name>", "Name for the new configuration")
@@ -1637,7 +1639,7 @@ Examples:
     configs
         .command("archive")
         .description("Archive a configuration")
-        .argument("<workflow-id>", "Workflow ID")
+        .argument("<workflow-id>", "Workflow ID or key")
         .argument("<config-id>", "Configuration ID")
         .option("--app <app-id>", "App ID (uses current app if not specified)")
         .option("-y, --yes", "Skip confirmation prompt")
@@ -2456,6 +2458,169 @@ Examples:
             process.exit(1);
         }
     });
+    // ============================================
+    // Codegen command (issue #1442)
+    // ============================================
+    workflows
+        .command("codegen")
+        .description("Generate typed TypeScript signatures from the local workflows/*.toml schemas. Emits one <key>.generated.ts per workflow (<Key>Input/<Key>Output types + a <key>(client) typed invoker factory returning { runSync?, start }).")
+        .argument("[workflow-key]", "Generate for a single workflow (defaults to every workflows/*.toml found)")
+        .option("--app <app-id>", "App ID")
+        .option("--sync-dir <path>", "Override path to the sync directory (defaults to ./.primitive/sync/<env>/<appId>/)")
+        .option("-o, --output <dir>", "Output directory for the <key>.generated.ts files (defaults to <sync-dir>/workflows/generated/)")
+        .option("--check", "Exit non-zero if generated output is out of date (CI guard); does not write.")
+        .option("--json", "Output the result summary as JSON")
+        .action(async (workflowKey, options) => {
+        try {
+            // 1. Locate the workflows directory. Mirrors `databases codegen`'s
+            //    sync-dir resolution: honor --sync-dir, else search any
+            //    env/appId subtree under ./.primitive/sync that has a workflows/
+            //    directory. When --app is given, restrict the scan to that app's
+            //    subtree (the sync-tree layout is <env>/<appId>/), so a multi-app
+            //    tree generates only the requested app's workflows instead of
+            //    combining every app's and writing into the first one found.
+            const workflowDirs = [];
+            if (options.syncDir) {
+                const candidate = path.join(options.syncDir, "workflows");
+                if (existsSync(candidate)) {
+                    workflowDirs.push(candidate);
+                }
+            }
+            else {
+                const root = path.join(process.cwd(), ".primitive", "sync");
+                if (existsSync(root)) {
+                    for (const env of readdirSync(root)) {
+                        const envDir = path.join(root, env);
+                        try {
+                            for (const app of readdirSync(envDir)) {
+                                if (options.app && app !== options.app)
+                                    continue;
+                                const candidate = path.join(envDir, app, "workflows");
+                                if (existsSync(candidate)) {
+                                    workflowDirs.push(candidate);
+                                }
+                            }
+                        }
+                        catch {
+                            // skip non-dirs
+                        }
+                    }
+                }
+            }
+            if (workflowDirs.length === 0) {
+                error(options.app
+                    ? `No workflows/ directory found for app "${options.app}" under .primitive/sync/. Check the --app id, pass --sync-dir, or run \`primitive sync pull\` first.`
+                    : "No workflows/ directory found. Pass --sync-dir or run `primitive sync pull` first.");
+                process.exit(1);
+            }
+            // Codegen writes one <key>.generated.ts per workflow into a single
+            // output dir derived from the first source dir below. Generating from
+            // more than one discovered workflows/ directory (multiple apps, or the
+            // same app across multiple synced envs) would combine unrelated apps'
+            // workflows into the first one's output dir and write nothing for the
+            // rest. Require the caller to disambiguate rather than combining.
+            if (workflowDirs.length > 1) {
+                const appsFound = [
+                    ...new Set(workflowDirs.map((d) => path.basename(path.dirname(d)))),
+                ];
+                error(`Found workflows/ directories for more than one app/env:\n` +
+                    workflowDirs
+                        .map((d) => `  ${path.relative(process.cwd(), d)}`)
+                        .join("\n") +
+                    `\nCodegen writes into one output dir, so it must run against` +
+                    ` one app. ` +
+                    (options.app
+                        ? `App "${options.app}" resolves to multiple synced envs — pass --sync-dir to pick one.`
+                        : `Pass --app <app-id> (found: ${appsFound.join(", ")}) or` +
+                            ` --sync-dir to select one.`));
+                process.exit(1);
+            }
+            // 2. Collect the source .toml files (one per workflow), filtered to a
+            //    single workflow when an argument is given. Match on the file stem;
+            //    the generator resolves the real key from `[workflow].key`.
+            const inputs = [];
+            const seenStems = new Set();
+            for (const dir of workflowDirs) {
+                for (const fileName of readdirSync(dir)) {
+                    if (!fileName.endsWith(".toml"))
+                        continue;
+                    const stem = fileName.slice(0, -".toml".length);
+                    if (workflowKey && stem !== workflowKey)
+                        continue;
+                    if (seenStems.has(stem))
+                        continue;
+                    seenStems.add(stem);
+                    const tomlPath = path.join(dir, fileName);
+                    inputs.push({
+                        fileStem: stem,
+                        tomlPath,
+                        tomlContent: readFileSync(tomlPath, "utf-8"),
+                    });
+                }
+            }
+            if (inputs.length === 0) {
+                error(workflowKey
+                    ? `No workflows/${workflowKey}.toml found under .primitive/sync/.`
+                    : "No workflows/*.toml files found to generate from.");
+                process.exit(1);
+            }
+            // 3. Resolve the output directory. Default: a `generated/` subdir of
+            //    the first source dir (keeps generated output beside the schema).
+            const outputDir = options.output
+                ? path.resolve(options.output)
+                : path.join(path.dirname(inputs[0].tomlPath), "generated");
+            // 4. Run codegen (or --check).
+            const codegenResult = await generateWorkflowTypes({
+                inputs,
+                outputDir,
+                check: !!options.check,
+                singleWorkflow: !!workflowKey,
+            });
+            if (options.check) {
+                if (codegenResult.mismatches.length > 0) {
+                    if (options.json) {
+                        json({ ok: false, mismatches: codegenResult.mismatches });
+                    }
+                    else {
+                        error(`Check failed: ${codegenResult.mismatches.length} file(s) out of date.`);
+                        for (const m of codegenResult.mismatches) {
+                            error(`  ${m.reason}: ${path.relative(process.cwd(), m.filePath)}`);
+                        }
+                        info("Run `primitive workflows codegen` to regenerate.");
+                    }
+                    process.exit(1);
+                }
+                if (options.json) {
+                    json({ ok: true, checked: codegenResult.writtenFiles.length });
+                }
+                else {
+                    success(`Check passed: ${codegenResult.writtenFiles.length} file(s) up to date.`);
+                }
+                return;
+            }
+            if (options.json) {
+                json({
+                    written: codegenResult.writtenFiles,
+                    deleted: codegenResult.deletedFiles,
+                });
+                return;
+            }
+            success(`Generated ${codegenResult.writtenFiles.length} file(s)` +
+                (codegenResult.deletedFiles.length > 0
+                    ? `, deleted ${codegenResult.deletedFiles.length} stale file(s).`
+                    : "."));
+            for (const f of codegenResult.writtenFiles) {
+                keyValue("  wrote", path.relative(process.cwd(), f));
+            }
+            for (const f of codegenResult.deletedFiles) {
+                keyValue("  deleted", path.relative(process.cwd(), f));
+            }
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
 }
 function formatFileSize(bytes) {
     if (bytes < 1024)