@catapultjs/deploy 0.11.0 → 0.12.0

package/build/bin/run.js

@@ -15,19 +15,19 @@ import { Context } from "../src/context.js";
 import { logger } from "../src/logger.js";
 import { Verbose } from "../src/enums.js";
 import { Kernel, ListLoader, HelpCommand } from '@adonisjs/ace';
-import Version from '../commands/version.js';
-import Init from '../commands/init.js';
-import Setup from '../commands/setup.js';
-import Deploy from '../commands/deploy.js';
-import Rollback from '../commands/rollback.js';
-import Status from '../commands/status.js';
-import ListReleases from '../commands/list_releases.js';
-import ListRevisions from '../commands/list_revisions.js';
-import ListTasks from '../commands/list_tasks.js';
-import Pipeline from '../commands/pipeline.js';
-import RunTask from '../commands/run_task.js';
-import Ssh from '../commands/ssh.js';
-import Run from '../commands/run.js';
+import Version from "../commands/version.js";
+import Init from "../commands/init.js";
+import Setup from "../commands/setup.js";
+import Deploy from "../commands/deploy.js";
+import Rollback from "../commands/rollback.js";
+import Status from "../commands/status.js";
+import ListReleases from "../commands/list_releases.js";
+import ListRevisions from "../commands/list_revisions.js";
+import ListTasks from "../commands/list_tasks.js";
+import Pipeline from "../commands/pipeline.js";
+import RunTask from "../commands/run_task.js";
+import Ssh from "../commands/ssh.js";
+import Run from "../commands/run.js";
 function parseVerboseLevel(argv) {
     let count = 0;
     for (const arg of argv) {

package/build/commands/init.js

@@ -35,10 +35,10 @@ export default class Init extends BaseCommand {
             return;
         }
         const lang = await this.prompt.choice('Which language do you want to use?', [
-            { name: 'ts', message: 'TypeScript (deploy.ts)' },
-            { name: 'js', message: 'JavaScript (deploy.js)' },
+            { name: 'ts', message: 'TypeScript (deploy.config.ts)' },
+            { name: 'js', message: 'JavaScript (deploy.config.js)' },
         ]);
-        const filename = lang === 'ts' ? 'deploy.ts' : 'deploy.js';
+        const filename = lang === 'ts' ? 'deploy.config.ts' : 'deploy.config.js';
         const dest = resolve(process.cwd(), filename);
         await writeFile(dest, TEMPLATE);
         this.logger.action(`create ${filename}`).succeeded();

package/build/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../commands/init.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtE,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYhB,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAA;IAC3B,MAAM,CAAC,WAAW,GAAG,oCAAoC,CAAA;IAKzD,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAA;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,iBAAiB,CAAC,CAAA;YACjD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,oCAAoC,EAAE;YAC1E,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE;YACjD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE;SAClD,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAA;QAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAA;QAE7C,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;QAEpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAA;QACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QACpD,MAAM,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,oBAAoB,CAAC,EAAE;YACvD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAA;QACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,SAAS,EAAE,CAAA;IAC9D,CAAC;;AAhCO;IADP,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;;yCACnE"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../commands/init.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtE,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYhB,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAA;IAC3B,MAAM,CAAC,WAAW,GAAG,oCAAoC,CAAA;IAKzD,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAA;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,iBAAiB,CAAC,CAAA;YACjD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,oCAAoC,EAAE;YAC1E,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE;YACxD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE;SACzD,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAA;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAA;QAE7C,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;QAEpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAA;QACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QACpD,MAAM,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,oBAAoB,CAAC,EAAE;YACvD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAA;QACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,SAAS,EAAE,CAAA;IAC9D,CAAC;;AAhCO;IADP,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;;yCACnE"}

package/build/recipes/caddy.d.ts

@@ -0,0 +1,10 @@
+declare module '../src/types.ts' {
+    interface TaskRegistry {
+        'caddy:validate': true;
+        'caddy:fmt': true;
+        'caddy:reload': true;
+        'caddy:config:show': true;
+        'caddy:config:upload': true;
+    }
+}
+export {};

package/build/recipes/caddy.js

@@ -0,0 +1,64 @@
+import { task, desc, after, get, bin, upload, onStatus } from "../index.js";
+import { ssh, q } from "../src/utils.js";
+function sudo() {
+    return get('caddy_use_sudo', true) ? 'sudo ' : '';
+}
+function configPath() {
+    return get('caddy_config_path', '/etc/caddy/Caddyfile');
+}
+function localConfigPath() {
+    return get('caddy_local_config_path', './Caddyfile');
+}
+function validateCommand() {
+    return `${sudo()}${bin('caddy')} validate --config ${q(configPath())}`;
+}
+function reloadCommand() {
+    return `${sudo()}${bin('caddy')} reload --config ${q(configPath())}`;
+}
+onStatus(async (_ctx, host) => {
+    const { stdout } = await ssh(host, `set +e\n${bin('caddy')} version || true`);
+    const version = stdout.trim().split(/\s+/)[0];
+    return { caddy: version || 'unavailable' };
+});
+desc('Validates the Caddy configuration');
+task('caddy:validate', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set -e\n${validateCommand()}`, { color: true });
+    logger.log(stdout.trim());
+});
+desc('Formats the configured Caddyfile');
+task('caddy:fmt', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set -e\n${sudo()}${bin('caddy')} fmt --overwrite ${q(configPath())}`, { color: true });
+    logger.log(stdout.trim());
+});
+desc('Reloads Caddy with the configured Caddyfile');
+task('caddy:reload', async ({ host, logger }) => {
+    const validateBeforeReload = get('caddy_validate_before_reload', true);
+    const commands = [
+        'set -e',
+        validateBeforeReload ? validateCommand() : '',
+        reloadCommand(),
+    ].filter(Boolean);
+    const { stdout } = await ssh(host, commands.join('\n'), { color: true });
+    logger.log(stdout.trim());
+});
+desc('Displays the configured Caddyfile');
+task('caddy:config:show', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set -e\n${sudo()}cat ${q(configPath())}`, { color: true });
+    logger.log(stdout.trim());
+});
+desc('Uploads and validates a local Caddyfile');
+task('caddy:config:upload', async ({ host, paths, logger }) => {
+    const remoteTmp = `${paths.cataConfig}/Caddyfile.upload`;
+    await ssh(host, `set -e\nmkdir -p ${q(paths.cataConfig)}`);
+    await upload(localConfigPath(), remoteTmp);
+    const { stdout } = await ssh(host, [
+        'set -e',
+        `${sudo()}install -m 0644 ${q(remoteTmp)} ${q(configPath())}`,
+        validateCommand(),
+    ].join('\n'), { color: true });
+    logger.log(stdout.trim());
+});
+if (get('caddy_reload_after_publish', false)) {
+    after('deploy:publish', 'caddy:reload');
+}
+//# sourceMappingURL=caddy.js.map

package/build/recipes/caddy.js.map

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

package/build/recipes/systemd.d.ts

@@ -0,0 +1,9 @@
+declare module '../src/types.ts' {
+    interface TaskRegistry {
+        'systemd:restart': true;
+        'systemd:reload': true;
+        'systemd:status': true;
+        'systemd:logs': true;
+    }
+}
+export {};

package/build/recipes/systemd.js

@@ -0,0 +1,37 @@
+import { task, desc, get } from "../index.js";
+import { ssh, q } from "../src/utils.js";
+function sudo() {
+    return get('systemd_use_sudo', true) ? 'sudo ' : '';
+}
+function service() {
+    return get('systemd_service', 'app');
+}
+function logLines() {
+    const lines = Number(get('systemd_logs_lines', 100));
+    return Number.isFinite(lines) && lines > 0 ? Math.floor(lines) : 100;
+}
+desc('Restarts the configured systemd service');
+task('systemd:restart', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set -e\n${sudo()}systemctl restart ${q(service())}`, {
+        color: true,
+    });
+    logger.log(stdout.trim());
+});
+desc('Reloads the configured systemd service');
+task('systemd:reload', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set -e\n${sudo()}systemctl reload ${q(service())}`, {
+        color: true,
+    });
+    logger.log(stdout.trim());
+});
+desc('Displays the configured systemd service status');
+task('systemd:status', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set +e\n${sudo()}systemctl status ${q(service())} --no-pager`, { color: true });
+    logger.log(stdout.trim());
+});
+desc('Displays journal logs for the configured systemd service');
+task('systemd:logs', async ({ host, logger }) => {
+    const { stdout } = await ssh(host, `set +e\n${sudo()}journalctl -u ${q(service())} -n ${q(String(logLines()))} --no-pager`, { color: true });
+    logger.log(stdout.trim());
+});
+//# sourceMappingURL=systemd.js.map

package/build/recipes/systemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.js","sourceRoot":"","sources":["../../recipes/systemd.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAA;AAWxC,SAAS,IAAI;IACX,OAAO,GAAG,CAAU,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;AAC9D,CAAC;AAED,SAAS,OAAO;IACd,OAAO,GAAG,CAAS,iBAAiB,EAAE,KAAK,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,QAAQ;IACf,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAS,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAA;IAC5D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AACtE,CAAC;AAED,IAAI,CAAC,yCAAyC,CAAC,CAAA;AAC/C,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAe,EAAE,EAAE;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,qBAAqB,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QACvF,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,wCAAwC,CAAC,CAAA;AAC9C,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAe,EAAE,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QACtF,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,gDAAgD,CAAC,CAAA;AACtD,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAe,EAAE,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAC1B,IAAI,EACJ,WAAW,IAAI,EAAE,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,aAAa,EAC9D,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAA;IACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,0DAA0D,CAAC,CAAA;AAChE,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAe,EAAE,EAAE;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAC1B,IAAI,EACJ,WAAW,IAAI,EAAE,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,EACvF,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAA;IACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catapultjs/deploy",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "main": "build/index.js",
   "bin": {
@@ -84,9 +84,9 @@
     "@adonisjs/tsconfig": "^2.0.0",
     "@japa/assert": "^4.2.0",
     "@japa/runner": "^5.3.0",
-    "@types/node": "^25.9.3",
-    "eslint": "^10.4.1",
-    "prettier": "^3.8.4",
+    "@types/node": "^25.9.4",
+    "eslint": "^10.6.0",
+    "prettier": "^3.9.3",
     "typescript": "^6.0.3",
     "vitepress": "^2.0.0-alpha.17"
   },

package/skills/catapultjs/SKILL.md

@@ -19,7 +19,7 @@ Read the file matching the task before writing code:
 | --- | --- |
 | Create or update `deploy.ts`: hosts, recipe selection, healthchecks, lifecycle hooks, pipeline tuning, `setPipeline()` | [references/config.md](references/config.md) |
 | Write or modify a recipe or deployment task: task DSL, `onSetup`/`onStatus` hooks, store options, `TaskRegistry` | [references/recipe.md](references/recipe.md) |
-| Use an official recipe (git, rsync, nextjs, nuxt, astro, tanstack, nestjs, adonisjs, vitepress, directus, pm2, redis): tasks added, store keys, monorepo patterns | [references/recipes.md](references/recipes.md) |
+| Use an official recipe (git, rsync, nextjs, nuxt, astro, tanstack, nestjs, adonisjs, vitepress, directus, pm2, redis, caddy, systemd): tasks added, store keys, monorepo patterns | [references/recipes.md](references/recipes.md) |
 | Script deployments from Node.js (scripts, CI, bots, dashboards) with the `Catapult` class | [references/api.md](references/api.md) |
 | Set up a GitHub Actions workflow with `catapultjs/deploy-action`: inputs, SSH secrets, env vars | [references/github-actions.md](references/github-actions.md) |
 | Use the `cata` CLI: deploy, rollback, task, status, run, ssh, list commands and their options | [references/cli.md](references/cli.md) |

package/skills/catapultjs/references/recipes.md

@@ -21,8 +21,10 @@ Full docs: https://catapultjs.com/guide/recipes
 | `recipes/nuxt` | No (pair with `git` or `rsync`) | Nuxt, build on the server |
 | `recipes/nuxt_static` | Uses default SCP; `rsync` optional | Static Nuxt site, generate locally |
 | `recipes/directus` | No (pair with `git` or `rsync`) | Directus, migrations and schema snapshots |
+| `recipes/caddy` | No | Caddy validation, reload, and config upload |
 | `recipes/pm2` | No | Process management (add to any stack) |
 | `recipes/redis` | No | Redis cache flush (add to any stack) |
+| `recipes/systemd` | No | systemd service management (add when the host uses systemd) |
 | `recipes/tanstack` | No (pair with `git` or `rsync`) | TanStack Start, build on the server |
 
 ---
@@ -512,6 +514,70 @@ import '@catapultjs/deploy/recipes/directus'
 
 ---
 
+## `recipes/caddy`
+
+```typescript
+import '@catapultjs/deploy/recipes/caddy'
+```
+
+Manages Caddy configuration. Does not deliver application code and does not reload Caddy by default unless `caddy_reload_after_publish` is set before importing the recipe. Service management is intentionally separate; combine with `recipes/systemd` and set `systemd_service` to `caddy` when Caddy is managed by systemd.
+
+> [!WARNING]
+> Caddy must be able to traverse every parent directory of the configured web root and read the published files. Deploying under a private home directory such as `/home/deploy/...` may require extra permissions or ACLs. Prefer a web root under `/var/www/<app>` or `/srv/www/<app>` for static sites. On the server, use `namei -l /path/to/current/index.html` to inspect which directory blocks access.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `caddy:reload` | after `deploy:publish` when `caddy_reload_after_publish` is true | Validates and reloads Caddy |
+| `caddy:validate` | manual | Runs `caddy validate` |
+| `caddy:fmt` | manual | Formats the configured Caddyfile |
+| `caddy:config:show` | manual | Displays the configured Caddyfile |
+| `caddy:config:upload` | manual | Uploads a local Caddyfile, installs it, and validates it |
+
+`onStatus` displays the Caddy version in `cata status`.
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `caddy_config_path` | `string` | `'/etc/caddy/Caddyfile'` | Remote Caddyfile path |
+| `caddy_local_config_path` | `string` | `'./Caddyfile'` | Local Caddyfile for upload |
+| `caddy_use_sudo` | `boolean` | `true` | Prefix privileged commands with `sudo` |
+| `caddy_validate_before_reload` | `boolean` | `true` | Validate before reload |
+| `caddy_reload_after_publish` | `boolean` | `false` | Add reload after publish |
+
+```typescript
+set('caddy_reload_after_publish', true)
+import '@catapultjs/deploy/recipes/caddy'
+```
+
+---
+
+## `recipes/systemd`
+
+```typescript
+import '@catapultjs/deploy/recipes/systemd'
+```
+
+Generic systemd service management. Import only when the target host uses systemd.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `systemd:restart` | manual | Restarts the configured service |
+| `systemd:reload` | manual | Reloads the configured service |
+| `systemd:status` | manual | Shows `systemctl status` for the service |
+| `systemd:logs` | manual | Shows recent `journalctl` lines for the service |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `systemd_service` | `string` | `'app'` | systemd service name |
+| `systemd_use_sudo` | `boolean` | `true` | Prefix privileged commands with `sudo` |
+| `systemd_logs_lines` | `number` | `100` | Number of journal lines shown by `systemd:logs` |
+
+```typescript
+set('systemd_service', 'caddy')
+import '@catapultjs/deploy/recipes/systemd'
+```
+
+---
+
 ## `recipes/pm2`
 
 ```typescript