@jahia/jahia-cli 0.1.3 → 0.2.0

package/oclif.manifest.json

@@ -39,7 +39,862 @@
         "commands",
         "hello.js"
       ]
+    },
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Interactive onboarding wizard that creates a complete Jahia CLI configuration file. Guides you through environment, tests, and workflow setup with sensible defaults — press Enter to accept all defaults for a working setup.",
+      "examples": [
+        "<%= config.bin %> init",
+        "<%= config.bin %> init --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init.js"
+      ]
+    },
+    "config:init": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate an initialized Jahia CLI configuration file. Creates a blank scaffold with environment and tests sections.",
+      "examples": [
+        "<%= config.bin %> config init",
+        "<%= config.bin %> config init --output ./my-config.yml",
+        "<%= config.bin %> config init --force --json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Path to write the configuration YAML file",
+          "name": "output",
+          "default": "jahia-cli.config.yml",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Overwrite output file if it already exists",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:init",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "init.js"
+      ]
+    },
+    "environment:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new Jahia environment. Starts Jahia with embedded Derby database and VictoriaLogs for log aggregation. Use interactive mode (no arguments) or provide a YAML config file.",
+      "examples": [
+        "<%= config.bin %> environment create",
+        "<%= config.bin %> environment create --config ./environment.yml",
+        "<%= config.bin %> environment create --force",
+        "<%= config.bin %> environment create --export-config ./env.yml",
+        "<%= config.bin %> environment create --config ./environment.yml --export-config ./env.yml",
+        "<%= config.bin %> environment create --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "char": "c",
+          "description": "Path to a YAML environment configuration file",
+          "env": "JAHIA_CLI_CONFIG",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Delete existing environment before creating a new one",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "export-config": {
+          "char": "e",
+          "description": "Export the environment configuration to a YAML file after creation",
+          "name": "export-config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:create",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "create.js"
+      ]
+    },
+    "environment:delete": {
+      "aliases": [],
+      "args": {},
+      "description": "Destroy a Jahia environment completely. Removes all containers, networks, and volumes associated with the environment.",
+      "examples": [
+        "<%= config.bin %> environment delete",
+        "<%= config.bin %> environment delete --json",
+        "<%= config.bin %> environment delete --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider to use",
+          "name": "provider",
+          "default": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:delete",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "delete.js"
+      ]
+    },
+    "environment:doctor": {
+      "aliases": [],
+      "args": {},
+      "description": "Check the health status of a Jahia environment. Reports whether containers are running and passing healthchecks. Uses the active environment if --name is not specified.",
+      "examples": [
+        "<%= config.bin %> environment doctor",
+        "<%= config.bin %> environment doctor --name my-env",
+        "<%= config.bin %> environment doctor --json",
+        "<%= config.bin %> environment doctor --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Name of the environment to check (uses active environment if omitted)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider to use (available: docker, jahiacloudv1)",
+          "name": "provider",
+          "default": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:doctor",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "doctor.js"
+      ]
+    },
+    "environment:export": {
+      "aliases": [],
+      "args": {},
+      "description": "Export the active environment configuration to a YAML file. The exported config contains only what is needed to recreate the environment — no runtime state (container IDs, timestamps, network names).",
+      "examples": [
+        "<%= config.bin %> environment export --output ./env.yml",
+        "<%= config.bin %> environment export --stdout",
+        "<%= config.bin %> environment export --output ./env.yml --json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Path to write the YAML configuration file",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stdout": {
+          "description": "Print the YAML configuration to stdout instead of writing to a file",
+          "name": "stdout",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:export",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "export.js"
+      ]
+    },
+    "environment:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all components in the active Jahia environment with their live status. Reconciles persisted state with actual Docker container status.",
+      "examples": [
+        "<%= config.bin %> environment list",
+        "<%= config.bin %> environment list --json",
+        "<%= config.bin %> environment list --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:list",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "list.js"
+      ]
+    },
+    "environment:logs": {
+      "aliases": [],
+      "args": {},
+      "description": "View logs from a component in the active Jahia environment. Shows the most recent log output from the specified container.",
+      "examples": [
+        "<%= config.bin %> environment logs --component jahia",
+        "<%= config.bin %> environment logs --component jahia --tail 50",
+        "<%= config.bin %> environment logs --component jahia --json",
+        "<%= config.bin %> environment logs --component jahia --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "component": {
+          "char": "C",
+          "description": "Component to show logs for (required)",
+          "name": "component",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tail": {
+          "char": "t",
+          "description": "Number of lines to show from the end",
+          "name": "tail",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:logs",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "logs.js"
+      ]
+    },
+    "environment:start": {
+      "aliases": [],
+      "args": {},
+      "description": "Start a previously stopped Jahia environment. Resumes all containers that were stopped with \"environment stop\".",
+      "examples": [
+        "<%= config.bin %> environment start",
+        "<%= config.bin %> environment start --json",
+        "<%= config.bin %> environment start --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider to use",
+          "name": "provider",
+          "default": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:start",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "start.js"
+      ]
+    },
+    "environment:stop": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop a running Jahia environment without destroying it. Containers are stopped but preserved for later restart.",
+      "examples": [
+        "<%= config.bin %> environment stop",
+        "<%= config.bin %> environment stop --json",
+        "<%= config.bin %> environment stop --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider to use",
+          "name": "provider",
+          "default": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "environment:stop",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "environment",
+        "stop.js"
+      ]
+    },
+    "tests:init": {
+      "aliases": [],
+      "args": {},
+      "description": "Initialize local test scaffolding from a remote repository. Syncs missing files from the configured scaffolding source and manages .gitignore so that remotely-sourced files are not accidentally committed.",
+      "examples": [
+        "<%= config.bin %> tests init",
+        "<%= config.bin %> tests init --config ./my-config.yml",
+        "<%= config.bin %> tests init --path ./tests --json"
+      ],
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "Path to config file (default: jahia-cli.config.yml)",
+          "env": "JAHIA_CLI_CONFIG",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "path": {
+          "char": "p",
+          "description": "Override destination directory for scaffolding files",
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tests:init",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tests",
+        "init.js"
+      ]
+    },
+    "jahia:alive": {
+      "aliases": [],
+      "args": {},
+      "description": "Wait until the Jahia environment is fully alive and responding GREEN. Polls the Server Availability Manager (SAM) healthcheck endpoint and requires N consecutive GREEN responses before declaring the environment ready.",
+      "examples": [
+        "<%= config.bin %> jahia alive",
+        "<%= config.bin %> jahia alive --count 10 --timeout 600",
+        "<%= config.bin %> jahia alive --url http://localhost:8080 --json",
+        "<%= config.bin %> jahia alive --state /ci/workspace/state.json"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "Jahia base URL (default: from state, or http://localhost:8080)",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "username": {
+          "char": "u",
+          "description": "Jahia username for SAM authentication (default: from state, or root)",
+          "name": "username",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "char": "P",
+          "description": "Jahia password for SAM authentication (default: from state, or root1234)",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "severity": {
+          "char": "s",
+          "description": "SAM probe severity to evaluate (LOW, MEDIUM, HIGH, CRITICAL)",
+          "name": "severity",
+          "default": "MEDIUM",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "interval": {
+          "char": "i",
+          "description": "Seconds between health checks",
+          "name": "interval",
+          "default": 2,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "char": "t",
+          "description": "Maximum seconds to wait before failing",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "count": {
+          "char": "c",
+          "description": "Number of consecutive GREEN responses required",
+          "name": "count",
+          "default": 5,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "jahia:alive",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "jahia",
+        "alive.js"
+      ]
+    },
+    "jahia:provision": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute a provisioning script against a running Jahia instance. The manifest can be a local YAML file or a public URL (auto-detected). Optional file attachments can be included via --file flags or --assets directory.",
+      "examples": [
+        "<%= config.bin %> jahia provision --manifest ./provisioning/setup.yaml",
+        "<%= config.bin %> jahia provision --manifest https://raw.githubusercontent.com/org/repo/main/provisioning.yaml",
+        "<%= config.bin %> jahia provision --manifest ./setup.yaml --file ./modules/mymodule.jar",
+        "<%= config.bin %> jahia provision --manifest ./setup.yaml --assets ./artifacts",
+        "<%= config.bin %> jahia provision --manifest ./setup.yaml --file ./mod1.jar --file ./mod2.jar --json",
+        "<%= config.bin %> jahia provision --manifest ./setup.yaml --url http://localhost:8080 --username root --password secret"
+      ],
+      "flags": {
+        "state": {
+          "description": "Path to the state JSON file. Overrides JAHIA_CLI_STATE env var. Defaults to ~/.jahia-cli/state.json",
+          "env": "JAHIA_CLI_STATE",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "manifest": {
+          "char": "m",
+          "description": "Path to a local YAML file or a public URL of the provisioning manifest",
+          "name": "manifest",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "Jahia base URL (default: from state, or http://localhost:8080)",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "username": {
+          "char": "u",
+          "description": "Jahia admin username (default: from state, or root)",
+          "name": "username",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "char": "P",
+          "description": "Jahia admin password (default: from state, or root1234)",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "File attachment to include (can be specified multiple times)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "assets": {
+          "char": "a",
+          "description": "Directory whose files are attached to the provisioning request (recursive)",
+          "name": "assets",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "jahia:provision",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "jahia",
+        "provision.js"
+      ]
+    },
+    "workflow:init": {
+      "aliases": [],
+      "args": {},
+      "description": "Add a sample workflow section to a configuration file. Generates ~5 representative steps (init, create, alive, test, cleanup) to help get started. Preserves existing environment and tests sections.",
+      "examples": [
+        "<%= config.bin %> workflow init",
+        "<%= config.bin %> workflow init --config ./my-config.yml",
+        "<%= config.bin %> workflow init --force",
+        "<%= config.bin %> workflow init --json"
+      ],
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "Path to the YAML configuration file",
+          "name": "config",
+          "default": "jahia-cli.config.yml",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing workflow section if already present",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workflow:init",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workflow",
+        "init.js"
+      ]
+    },
+    "workflow:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute a workflow defined in a configuration file. Runs steps sequentially — shell commands via execa, jahia-cli commands via subprocess. Stops on first failure.",
+      "examples": [
+        "<%= config.bin %> workflow run --config jahia-cli.config.yml",
+        "<%= config.bin %> workflow run --config ./my-config.yml --json"
+      ],
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "Path to the YAML configuration file",
+          "name": "config",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output result as structured JSON (for AI agents and scripting)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "state": {
+          "char": "s",
+          "description": "Path to the state file (auto-passed to jahia-cli subcommands)",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workflow:run",
+      "pluginAlias": "@jahia/jahia-cli",
+      "pluginName": "@jahia/jahia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workflow",
+        "run.js"
+      ]
     }
   },
-  "version": "0.1.3"
+  "version": "0.2.0"
 }