@openworkflow/cli 0.4.1 → 0.4.3

package/dist/cli.js

@@ -35,6 +35,7 @@ workerCmd
 program
     .command("dashboard")
     .description("start the dashboard to view workflow runs")
+    .option("-p, --port <number>", "custom port for the dashboard server", Number.parseInt)
     .option("--config <path>", "path to OpenWorkflow config file")
     .action(withErrorHandling(dashboard));
 await program.parseAsync(process.argv);

package/dist/commands.d.ts

@@ -2,6 +2,9 @@ import { WorkerConfig } from "./config.js";
 interface CommandOptions {
     config?: string;
 }
+interface DashboardOptions extends CommandOptions {
+    port?: number;
+}
 /**
  * openworkflow -V | --version
  * @returns the version string, or "-" if it cannot be determined
@@ -26,9 +29,30 @@ export declare function workerStart(options?: WorkerStartOptions): Promise<void>
 /**
  * openworkflow dashboard
  * Starts the dashboard by delegating to `@openworkflow/dashboard` via npx.
- * @param options - Command options
+ * @param port - Optional dashboard port.
+ * @returns Spawn configuration for launching the dashboard process.
+ */
+export declare function getDashboardSpawnOptions(port?: number): {
+    command: string;
+    args: string[];
+    spawnOptions: {
+        stdio: "inherit";
+        env?: NodeJS.ProcessEnv;
+    };
+};
+/**
+ * Validate dashboard port option.
+ * @param port - Optional dashboard port.
+ * @returns Validated dashboard port.
+ * @throws {CLIError} If the provided port is not an integer in the 1-65535 range.
+ */
+export declare function validateDashboardPort(port?: number): number | undefined;
+/**
+ * Start the dashboard process.
+ * @param options - Dashboard command options.
+ * @returns Resolves when the dashboard process exits.
  */
-export declare function dashboard(options?: CommandOptions): Promise<void>;
+export declare function dashboard(options?: DashboardOptions): Promise<void>;
 /**
  * Discover workflow files from directories. Recursively scans directories for
  * workflow files with supported extensions (.ts, .js, .mjs, .cjs).

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAiC3E,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAoBnC;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoItE;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDxE;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,cAAc,CAAC;AAE/D;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuEf;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2D3E;AAwOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAAO,GAC5B,MAAM,EAAE,CA4CV;AA8VD,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAiC3E,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAiB,SAAQ,cAAc;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAoBnC;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoItE;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDxE;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,cAAc,CAAC;AAE/D;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuEf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE;QACZ,KAAK,EAAE,SAAS,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;KACzB,CAAC;CACH,CAYA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAavE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D7E;AAwOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAAO,GAC5B,MAAM,EAAE,CA4CV;AAiWD,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,GACjD,MAAM,CAKR"}

package/dist/commands.js

@@ -247,20 +247,52 @@ export async function workerStart(options = {}) {
 /**
  * openworkflow dashboard
  * Starts the dashboard by delegating to `@openworkflow/dashboard` via npx.
- * @param options - Command options
+ * @param port - Optional dashboard port.
+ * @returns Spawn configuration for launching the dashboard process.
+ */
+export function getDashboardSpawnOptions(port) {
+    return {
+        command: "npx",
+        args: ["@openworkflow/dashboard"],
+        spawnOptions: {
+            stdio: "inherit",
+            env: port === undefined
+                ? process.env
+                : { ...process.env, PORT: String(port) },
+        },
+    };
+}
+/**
+ * Validate dashboard port option.
+ * @param port - Optional dashboard port.
+ * @returns Validated dashboard port.
+ * @throws {CLIError} If the provided port is not an integer in the 1-65535 range.
+ */
+export function validateDashboardPort(port) {
+    if (port === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+        throw new CLIError("Invalid dashboard port.", "Use an integer between 1 and 65535, for example `--port 3001`.");
+    }
+    return port;
+}
+/**
+ * Start the dashboard process.
+ * @param options - Dashboard command options.
+ * @returns Resolves when the dashboard process exits.
  */
 export async function dashboard(options = {}) {
     const configPath = options.config;
+    const port = validateDashboardPort(options.port);
     consola.start("Starting dashboard...");
     const { configFile } = await loadConfigWithEnv(configPath);
     if (!configFile) {
         throw new CLIError("No config file found.", "Run `npx @openworkflow/cli init` to create a config file before starting the dashboard.");
     }
     consola.info(`Using config: ${configFile}`);
-    // eslint-disable-next-line sonarjs/no-os-command-from-path
-    const child = spawn("npx", ["@openworkflow/dashboard"], {
-        stdio: "inherit",
-    });
+    const spawnConfig = getDashboardSpawnOptions(port);
+    const child = spawn(spawnConfig.command, spawnConfig.args, spawnConfig.spawnOptions);
     await new Promise((resolve, reject) => {
         /** remove signal handlers after the child exits */
         function cleanupSignalHandlers() {
@@ -686,10 +718,10 @@ function updateGitignoreForSqlite() {
     const gitignorePath = path.join(process.cwd(), ".gitignore");
     const spinner = p.spinner();
     spinner.start("Updating .gitignore...");
-    const result = ensureGitignoreEntry(gitignorePath, "openworkflow/backend.db");
+    const result = ensureGitignoreEntry(gitignorePath, "openworkflow/backend.db*");
     spinner.stop(result.added
-        ? "Added openworkflow/backend.db to .gitignore"
-        : "openworkflow/backend.db already in .gitignore");
+        ? "Added openworkflow/backend.db* to .gitignore"
+        : "openworkflow/backend.db* already in .gitignore");
 }
 /**
  * Add worker script to package.json.
@@ -717,7 +749,7 @@ function addWorkerScriptToPackageJson() {
  * Ensure a specific entry exists in a .gitignore file. Creates the file if it
  * doesn't exist, appends the entry if not present.
  * @param gitignorePath - Path to the .gitignore file
- * @param entry - The entry to add (e.g. "openworkflow/backend.db")
+ * @param entry - The entry to add (e.g. "openworkflow/backend.db*")
  * @returns Object indicating whether the entry was added or already existed
  */
 function ensureGitignoreEntry(gitignorePath, entry) {

package/dist/templates.d.ts

@@ -3,5 +3,5 @@ export declare const POSTGRES_CLIENT = "import { BackendPostgres } from \"openwo
 export declare const POSTGRES_PROD_SQLITE_DEV_CLIENT = "import { BackendPostgres } from \"openworkflow/postgres\";\nimport { BackendSqlite } from \"openworkflow/sqlite\";\nimport { OpenWorkflow } from \"openworkflow\";\n\nexport const backend =\n  process.env[\"NODE_ENV\"] === \"production\"\n    ? await BackendPostgres.connect(process.env[\"OPENWORKFLOW_POSTGRES_URL\"])\n    : BackendSqlite.connect(\"openworkflow/backend.db\");\nexport const ow = new OpenWorkflow({ backend });\n";
 export declare const CONFIG = "import { backend } from \"./openworkflow/client.js\";\nimport { defineConfig } from \"@openworkflow/cli\";\n\nexport default defineConfig({\n  backend,\n  dirs: \"./openworkflow\",\n  ignorePatterns: [\"**/*.run.*\"],\n});\n";
 export declare const HELLO_WORLD_WORKFLOW = "import { defineWorkflow } from \"openworkflow\";\n\n/**\n * Example workflow that greets the world.\n *\n * This workflow is auto-discovered by the CLI worker.\n * To trigger it, use ow.runWorkflow() from your app:\n * ```ts\n * import { ow } from \"./openworkflow/client.js\";\n * import { helloWorld } from \"./openworkflow/hello-world.js\";\n * const handle = await ow.runWorkflow(helloWorld.spec, {});\n * const result = await handle.result();\n * ```\n */\nexport const helloWorld = defineWorkflow(\n  { name: \"hello-world\" },\n  async ({ step }) => {\n    const greeting = await step.run({ name: \"greet\" }, () => {\n      return \"Hello, World!\";\n    });\n\n    await step.sleep(\"wait-a-bit\", \"1s\");\n\n    return { greeting };\n  },\n);\n";
-export declare const HELLO_WORLD_RUNNER = "import { ow } from \"./client.js\";\nimport { helloWorld } from \"./hello-world.js\";\n\n// Run this file:\n// JS: `node openworkflow/hello-world.run.js`\n// TS: `npx tsx openworkflow/hello-world.run.ts`\n//\n// This file is a temporary dev helper generated by\n// `npx @openworkflow/cli init` so you can quickly run the example workflow.\n//\n// Copy the code anywhere in your app (e.g., an API route or a script) and\n// modify it to run your workflows.\n//\n// You can delete this file once you're done with it.\n\nconsole.log(\"Running hello-world workflow...\");\nconst handle = await ow.runWorkflow(helloWorld.spec, {});\n\nconsole.log(\"Waiting for result...\");\nconst result = await handle.result(); // for very short workflows only\n\nconsole.log(`Workflow result: ${JSON.stringify(result, null, 2)}`);\n";
+export declare const HELLO_WORLD_RUNNER = "import { backend, ow } from \"./client.js\";\nimport { helloWorld } from \"./hello-world.js\";\n\n// Run this file:\n// JS: `node openworkflow/hello-world.run.js`\n// TS: `npx tsx openworkflow/hello-world.run.ts`\n//\n// This file is a temporary dev helper generated by\n// `npx @openworkflow/cli init` so you can quickly run the example workflow.\n//\n// Copy the code anywhere in your app (e.g., an API route or a script) and\n// modify it to run your workflows.\n//\n// You can delete this file once you're done with it.\n\nconsole.log(\"Running hello-world workflow...\");\nconst handle = await ow.runWorkflow(helloWorld.spec, {});\n\nconsole.log(\"Waiting for result...\");\nconst result = await handle.result(); // for very short workflows only\n\nconsole.log(`Workflow result: ${JSON.stringify(result, null, 2)}`);\n\n// Stop backend. Only needed if this is a standalone script that you want to\n// exit after running the workflow.\nawait backend.stop();\n";
 //# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,6OAKzB,CAAC;AAEF,eAAO,MAAM,eAAe,+QAO3B,CAAC;AAEF,eAAO,MAAM,+BAA+B,ibAS3C,CAAC;AAEF,eAAO,MAAM,MAAM,qOAQlB,CAAC;AAEF,eAAO,MAAM,oBAAoB,wvBA0BhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,mzBAsB9B,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,6OAKzB,CAAC;AAEF,eAAO,MAAM,eAAe,+QAO3B,CAAC;AAEF,eAAO,MAAM,+BAA+B,ibAS3C,CAAC;AAEF,eAAO,MAAM,MAAM,qOAQlB,CAAC;AAEF,eAAO,MAAM,oBAAoB,wvBA0BhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,w8BA0B9B,CAAC"}

package/dist/templates.js

@@ -58,7 +58,7 @@ export const helloWorld = defineWorkflow(
   },
 );
 `;
-export const HELLO_WORLD_RUNNER = `import { ow } from "./client.js";
+export const HELLO_WORLD_RUNNER = `import { backend, ow } from "./client.js";
 import { helloWorld } from "./hello-world.js";
 
 // Run this file:
@@ -80,4 +80,8 @@ console.log("Waiting for result...");
 const result = await handle.result(); // for very short workflows only
 
 console.log(\`Workflow result: \${JSON.stringify(result, null, 2)}\`);
+
+// Stop backend. Only needed if this is a standalone script that you want to
+// exit after running the workflow.
+await backend.stop();
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openworkflow/cli",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "exports": {
     ".": {
@@ -22,14 +22,15 @@
     "!*.tsbuildinfo"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "npm run clean && tsc",
+    "clean": "rm -rf dist",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.0",
+    "@clack/prompts": "^1.0.1",
     "commander": "^14.0.3",
     "consola": "^3.4.2",
-    "dotenv": "^17.2.4",
+    "dotenv": "^17.3.1",
     "jiti": "^2.6.1",
     "nypm": "^0.6.5"
   },
@@ -38,6 +39,6 @@
     "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "openworkflow": "^0.6.0 || ^0.7.0"
+    "openworkflow": "^0.6.0 || ^0.7.0 || ^0.8.0"
   }
 }

package/dist/skills.d.ts

@@ -1,61 +0,0 @@
-declare const SUPPORTED_SKILL_AGENTS: readonly ["codex", "claude"];
-export type SkillAgent = (typeof SUPPORTED_SKILL_AGENTS)[number];
-export interface SkillCatalogEntry {
-    name: string;
-    description: string;
-}
-export interface InstallOpenWorkflowSkillsOptions {
-    agent: SkillAgent;
-    force: boolean;
-    requestedSkillNames?: string[];
-    targetDirectory?: string;
-    workspaceDirectory: string;
-}
-export interface InstalledSkill {
-    name: string;
-    overwritten: boolean;
-    path: string;
-}
-export interface InstallOpenWorkflowSkillsResult {
-    installedSkills: InstalledSkill[];
-    targetDirectory: string;
-}
-/**
- * True when the provided value is a supported skill agent.
- * @param value - Agent value from CLI options
- * @returns Whether the value is supported
- */
-export declare function isSkillAgent(value: string): value is SkillAgent;
-/**
- * Returns the default skill directory for an agent.
- * @param agent - Skill agent
- * @returns Relative target directory
- */
-export declare function getDefaultSkillDirectory(agent: SkillAgent): string;
-/**
- * List available OpenWorkflow skills.
- * @returns Skill catalog entries
- */
-export declare function listOpenWorkflowSkills(): SkillCatalogEntry[];
-/**
- * Resolve requested skill names, defaulting to all.
- * @param requestedSkillNames - Skill names from CLI options
- * @returns Unique, validated skill names
- * @throws {Error} When one or more skill names are unknown
- */
-export declare function resolveSkillNames(requestedSkillNames?: string[]): string[];
-/**
- * Install OpenWorkflow skills to an agent skill directory.
- * @param options - Install options
- * @returns Install result metadata
- * @throws {Error} When skill names are invalid or files already exist without force
- */
-export declare function installOpenWorkflowSkills(options: InstallOpenWorkflowSkillsOptions): InstallOpenWorkflowSkillsResult;
-/**
- * Read a skill file from disk. Used by tests.
- * @param skillPath - Path to the skill file
- * @returns File content
- */
-export declare function readSkillFile(skillPath: string): string;
-export {};
-//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../skills.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,sBAAsB,8BAA+B,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,+BAA+B;IAC9C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAyMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAiB1E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CA2CjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/skills.js

@@ -1,286 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
-import path from "node:path";
-const SUPPORTED_SKILL_AGENTS = ["codex", "claude"];
-const DEFAULT_SKILL_DIRECTORIES = {
-    codex: path.join(".agents", "skills"),
-    claude: path.join(".claude", "skills"),
-};
-const OPENWORKFLOW_SKILLS = [
-    {
-        name: "openworkflow-quickstart",
-        description: "Scaffold, implement, and run durable workflows with the OpenWorkflow CLI.",
-        files: {
-            "SKILL.md": `---
-name: openworkflow-quickstart
-description: Use when a user asks to create, run, or update OpenWorkflow workflows in an app codebase.
----
-
-# OpenWorkflow Quickstart
-
-Use this skill when the user wants to build or update a workflow quickly.
-
-## Standard flow
-
-1. Confirm the project has OpenWorkflow set up. If not, run \`npx @openworkflow/cli init\`.
-2. Create or update workflow code in \`openworkflow/\` with \`defineWorkflow\`.
-3. Keep side effects inside \`step.run(...)\` calls, and keep step names stable.
-4. Start a worker with \`npx @openworkflow/cli worker start\`.
-5. Trigger the workflow with \`ow.runWorkflow(workflow.spec, input)\`.
-6. Validate setup with \`npx @openworkflow/cli doctor\`.
-
-## Guardrails
-
-- Keep workflow replay deterministic outside of \`step.run\`.
-- Use explicit, descriptive, stable step names.
-- Use \`step.sleep\` for durable waits instead of process timers.
-- Return JSON-serializable values from steps and workflow output.
-
-## Useful commands
-
-\`\`\`bash
-npx @openworkflow/cli init
-npx @openworkflow/cli worker start
-npx @openworkflow/cli doctor
-npx @openworkflow/cli dashboard
-\`\`\`
-`,
-        },
-    },
-    {
-        name: "openworkflow-patterns",
-        description: "Apply durable workflow patterns for retries, idempotency, and versioning.",
-        files: {
-            "SKILL.md": `---
-name: openworkflow-patterns
-description: Use when a user asks for production workflow design patterns in OpenWorkflow.
----
-
-# OpenWorkflow Patterns
-
-Use this skill for architecture and implementation guidance on durable workflows.
-
-## Patterns to apply
-
-1. Prefer many small \`step.run\` calls over one large step.
-2. Keep external side effects in steps with stable names to preserve memoization.
-3. Use idempotency keys for enqueue endpoints that may be retried.
-4. Use workflow versioning when behavior changes in non-backward-compatible ways.
-5. Use \`step.sleep\` for delays and backoff scheduling.
-
-## Failure handling
-
-- Let transient failures throw from step functions so retries can reschedule runs.
-- Use explicit deadlines for workflows that should fail fast.
-- Add compensation steps for side effects that need rollback behavior.
-
-## Review checklist
-
-- Is workflow code deterministic between checkpoints?
-- Are step names stable across deployments?
-- Are retry expectations documented for each external dependency?
-- Are deadline and workflow cancel paths tested?
-`,
-        },
-    },
-    {
-        name: "openworkflow-sql-inspector",
-        description: "Inspect workflow and step state directly in SQLite or PostgreSQL with read-only SQL.",
-        files: {
-            "SKILL.md": `---
-name: openworkflow-sql-inspector
-description: Use when a user asks why workflows are stuck, slow, failed, or repeatedly retried.
----
-
-# OpenWorkflow SQL Inspector
-
-Use this skill to answer workflow runtime questions from database state.
-
-## Safety rules
-
-1. Use read-only SQL only.
-2. Do not run INSERT, UPDATE, DELETE, ALTER, DROP, TRUNCATE, or CREATE.
-3. Always add \`LIMIT\` to exploratory queries (default 100).
-4. Redact sensitive values before sharing query output.
-
-## Database notes
-
-- SQLite default path from CLI init: \`openworkflow/backend.db\`.
-- PostgreSQL default schema: \`openworkflow\`.
-- Core tables: \`workflow_runs\`, \`step_attempts\`.
-
-Read [references/sql-queries.md](references/sql-queries.md) for practical query templates.
-`,
-            "references/sql-queries.md": `# SQL Query Templates
-
-## PostgreSQL
-
-Use a read-only transaction for ad hoc inspection:
-
-\`\`\`sql
-BEGIN READ ONLY;
-SELECT
-  namespace_id,
-  id,
-  workflow_name,
-  status,
-  attempts,
-  available_at,
-  deadline_at,
-  created_at,
-  updated_at
-FROM openworkflow.workflow_runs
-ORDER BY created_at DESC
-LIMIT 100;
-COMMIT;
-\`\`\`
-
-Recent step attempts for a workflow run:
-
-\`\`\`sql
-SELECT
-  namespace_id,
-  id,
-  workflow_run_id,
-  step_name,
-  kind,
-  status,
-  started_at,
-  finished_at,
-  created_at
-FROM openworkflow.step_attempts
-WHERE workflow_run_id = $1
-ORDER BY created_at DESC
-LIMIT 200;
-\`\`\`
-
-## SQLite
-
-List recent workflow runs:
-
-\`\`\`sql
-SELECT
-  namespace_id,
-  id,
-  workflow_name,
-  status,
-  attempts,
-  available_at,
-  deadline_at,
-  created_at,
-  updated_at
-FROM workflow_runs
-ORDER BY created_at DESC
-LIMIT 100;
-\`\`\`
-
-List step attempts for one run:
-
-\`\`\`sql
-SELECT
-  namespace_id,
-  id,
-  workflow_run_id,
-  step_name,
-  kind,
-  status,
-  started_at,
-  finished_at,
-  created_at
-FROM step_attempts
-WHERE workflow_run_id = ?
-ORDER BY created_at DESC
-LIMIT 200;
-\`\`\`
-`,
-        },
-    },
-];
-/**
- * True when the provided value is a supported skill agent.
- * @param value - Agent value from CLI options
- * @returns Whether the value is supported
- */
-export function isSkillAgent(value) {
-    return SUPPORTED_SKILL_AGENTS.includes(value);
-}
-/**
- * Returns the default skill directory for an agent.
- * @param agent - Skill agent
- * @returns Relative target directory
- */
-export function getDefaultSkillDirectory(agent) {
-    return DEFAULT_SKILL_DIRECTORIES[agent];
-}
-/**
- * List available OpenWorkflow skills.
- * @returns Skill catalog entries
- */
-export function listOpenWorkflowSkills() {
-    return OPENWORKFLOW_SKILLS.map((skill) => ({
-        name: skill.name,
-        description: skill.description,
-    }));
-}
-/**
- * Resolve requested skill names, defaulting to all.
- * @param requestedSkillNames - Skill names from CLI options
- * @returns Unique, validated skill names
- * @throws {Error} When one or more skill names are unknown
- */
-export function resolveSkillNames(requestedSkillNames) {
-    const requested = requestedSkillNames && requestedSkillNames.length > 0
-        ? requestedSkillNames
-        : OPENWORKFLOW_SKILLS.map((skill) => skill.name);
-    const deduped = [...new Set(requested)];
-    const unknownSkills = deduped.filter((name) => OPENWORKFLOW_SKILLS.every((skill) => skill.name !== name));
-    if (unknownSkills.length > 0) {
-        throw new Error(`Unknown skill name${unknownSkills.length === 1 ? "" : "s"}: ${unknownSkills.join(", ")}`);
-    }
-    return deduped;
-}
-/**
- * Install OpenWorkflow skills to an agent skill directory.
- * @param options - Install options
- * @returns Install result metadata
- * @throws {Error} When skill names are invalid or files already exist without force
- */
-export function installOpenWorkflowSkills(options) {
-    const requestedSkillNames = resolveSkillNames(options.requestedSkillNames);
-    const defaultDirectory = getDefaultSkillDirectory(options.agent);
-    const targetDirectory = path.resolve(options.workspaceDirectory, options.targetDirectory ?? defaultDirectory);
-    mkdirSync(targetDirectory, { recursive: true });
-    const installedSkills = [];
-    for (const skillName of requestedSkillNames) {
-        const skill = OPENWORKFLOW_SKILLS.find((item) => item.name === skillName);
-        if (!skill) {
-            continue;
-        }
-        const skillDirectory = path.join(targetDirectory, skill.name);
-        const hadExistingDirectory = existsSync(skillDirectory);
-        if (hadExistingDirectory && !options.force) {
-            throw new Error(`Skill "${skill.name}" already exists at ${skillDirectory}. Use --force to overwrite.`);
-        }
-        if (hadExistingDirectory) {
-            rmSync(skillDirectory, { force: true, recursive: true });
-        }
-        for (const [relativePath, content] of Object.entries(skill.files)) {
-            const destinationPath = path.join(skillDirectory, relativePath);
-            mkdirSync(path.dirname(destinationPath), { recursive: true });
-            writeFileSync(destinationPath, content, "utf8");
-        }
-        installedSkills.push({
-            name: skill.name,
-            overwritten: hadExistingDirectory,
-            path: skillDirectory,
-        });
-    }
-    return { installedSkills, targetDirectory };
-}
-/**
- * Read a skill file from disk. Used by tests.
- * @param skillPath - Path to the skill file
- * @returns File content
- */
-export function readSkillFile(skillPath) {
-    return readFileSync(skillPath, "utf8");
-}