@catapultjs/deploy 0.10.0 → 0.11.0

package/build/recipes/astro.js

@@ -1,15 +1,11 @@
-import { task, desc, local, upload, get, set, before } from "../index.js";
-import { resolveHostStringValue } from "../src/utils.js";
-set('astro_mode', 'production');
-desc('Builds the Astro application locally');
-task('deploy:build', async ({ host }) => {
-    const mode = resolveHostStringValue(get('astro_mode'), host, 'astro_mode');
-    await local(`astro build --mode ${mode}`);
+import { task, desc, cd, run, get, set, after, pmExec } from "../index.js";
+set('astro_path', get('source_path', ''));
+desc('Builds the Astro application on the remote server');
+task('deploy:build', () => {
+    const astroPath = get('astro_path');
+    cd(`{{release_path}}/${astroPath}`);
+    run(`${pmExec('astro')} build`);
 });
-desc('Uploads local artifacts to the release directory');
-task('deploy:update_code', async ({ paths }) => {
-    const source = get('source_path', './dist/.');
-    await upload(source, paths.release);
-});
-before('deploy:lock', 'deploy:build');
+after('deploy:update_code', 'deploy:install');
+after('deploy:shared', 'deploy:build');
 //# sourceMappingURL=astro.js.map

package/build/recipes/astro.js.map

@@ -1 +1 @@
-{"version":3,"file":"astro.js","sourceRoot":"","sources":["../../recipes/astro.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;AAE/B,IAAI,CAAC,sCAAsC,CAAC,CAAA;AAC5C,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,IAAI,EAAe,EAAE,EAAE;IACnD,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;IAC1E,MAAM,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,kDAAkD,CAAC,CAAA;AACxD,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAe,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;IAC7C,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;AACrC,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA"}
+{"version":3,"file":"astro.js","sourceRoot":"","sources":["../../recipes/astro.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1E,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAA;AAEzC,IAAI,CAAC,mDAAmD,CAAC,CAAA;AACzD,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE;IACxB,MAAM,SAAS,GAAG,GAAG,CAAS,YAAY,CAAC,CAAA;IAC3C,EAAE,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAA;IACnC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC,CAAC,CAAA;AAEF,KAAK,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;AAC7C,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/astro_static.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/astro_static.js

@@ -0,0 +1,11 @@
+import { task, desc, local, get, set, before } from "../index.js";
+import { resolveHostStringValue } from "../src/utils.js";
+set('astro_mode', 'production');
+set('source_path', './dist/.');
+desc('Builds the Astro application locally');
+task('deploy:build', async ({ host }) => {
+    const mode = resolveHostStringValue(get('astro_mode'), host, 'astro_mode');
+    await local(`astro build --mode ${mode}`);
+});
+before('deploy:lock', 'deploy:build');
+//# sourceMappingURL=astro_static.js.map

package/build/recipes/astro_static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro_static.js","sourceRoot":"","sources":["../../recipes/astro_static.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;AAC/B,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;AAE9B,IAAI,CAAC,sCAAsC,CAAC,CAAA;AAC5C,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,IAAI,EAAe,EAAE,EAAE;IACnD,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;IAC1E,MAAM,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/deploy/update_code.js

@@ -1,6 +1,7 @@
-import { task, desc } from "../../index.js";
-desc('Method for updating code');
-task('deploy:update_code', () => {
-    throw new Error('Please implement this task');
+import { task, desc, get, upload } from "../../index.js";
+desc('Uploads local artifacts to the release directory');
+task('deploy:update_code', async ({ paths }) => {
+    const source = get('source_path', './.');
+    await upload(source, paths.release);
 });
 //# sourceMappingURL=update_code.js.map

package/build/recipes/deploy/update_code.js.map

@@ -1 +1 @@
-{"version":3,"file":"update_code.js","sourceRoot":"","sources":["../../../recipes/deploy/update_code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAQ3C,IAAI,CAAC,0BAA0B,CAAC,CAAA;AAChC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;AAC/C,CAAC,CAAC,CAAA"}
+{"version":3,"file":"update_code.js","sourceRoot":"","sources":["../../../recipes/deploy/update_code.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAQ1E,IAAI,CAAC,kDAAkD,CAAC,CAAA;AACxD,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAe,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IACxC,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;AACrC,CAAC,CAAC,CAAA"}

package/build/recipes/nestjs.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/nestjs.js

@@ -0,0 +1,5 @@
+import { set, after } from "../index.js";
+set('shared_files', ['.env']);
+after('deploy:update_code', 'deploy:install');
+after('deploy:install', 'deploy:build');
+//# sourceMappingURL=nestjs.js.map

package/build/recipes/nestjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.js","sourceRoot":"","sources":["../../recipes/nestjs.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAE7B,KAAK,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;AAC7C,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/nextjs.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/nextjs.js

@@ -0,0 +1,20 @@
+import { task, desc, run, get, set, cd, after, pmExec } from "../index.js";
+set('shared_files', ['.env']);
+set('nextjs_path', get('source_path', ''));
+set('nextjs_out_path', '.next/standalone/');
+desc('Builds the Next.js app');
+task('deploy:build', () => {
+    const nextjsPath = get('nextjs_path');
+    cd(`{{release_path}}/${nextjsPath}`);
+    run(`${pmExec('next')} build`);
+    const nextjsOutPath = get('nextjs_out_path');
+    run(`
+    if [ -d {{release_path}}/${nextjsOutPath} ]; then
+      ln -sfn {{release_path}}/public {{release_path}}/${nextjsOutPath}
+      ln -sfn {{release_path}}/.next/static {{release_path}}/${nextjsOutPath}.next/
+    fi
+  `);
+});
+after('deploy:update_code', 'deploy:install');
+after('deploy:shared', 'deploy:build');
+//# sourceMappingURL=nextjs.js.map

package/build/recipes/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.js","sourceRoot":"","sources":["../../recipes/nextjs.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1E,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7B,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1C,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAA;AAE3C,IAAI,CAAC,wBAAwB,CAAC,CAAA;AAC9B,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE;IACxB,MAAM,UAAU,GAAG,GAAG,CAAS,aAAa,CAAC,CAAA;IAC7C,EAAE,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAA;IACpC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAE9B,MAAM,aAAa,GAAG,GAAG,CAAS,iBAAiB,CAAC,CAAA;IACpD,GAAG,CAAC;+BACyB,aAAa;yDACa,aAAa;+DACP,aAAa;;GAEzE,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,KAAK,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;AAC7C,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/nextjs_static.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/nextjs_static.js

@@ -0,0 +1,8 @@
+import { task, desc, set, before, local } from "../index.js";
+set('source_path', './out/.');
+desc('Builds the Next.js application locally');
+task('deploy:build', async () => {
+    await local('next build');
+});
+before('deploy:lock', 'deploy:build');
+//# sourceMappingURL=nextjs_static.js.map

package/build/recipes/nextjs_static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs_static.js","sourceRoot":"","sources":["../../recipes/nextjs_static.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE5D,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;AAE7B,IAAI,CAAC,wCAAwC,CAAC,CAAA;AAC9C,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,KAAK,CAAC,YAAY,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/nuxt_static.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/nuxt_static.js

@@ -0,0 +1,8 @@
+import { task, desc, set, before, local } from "../index.js";
+set('source_path', './.output/public/.');
+desc('Builds the Nuxt application locally');
+task('deploy:build', async () => {
+    await local(`nuxt generate`);
+});
+before('deploy:lock', 'deploy:build');
+//# sourceMappingURL=nuxt_static.js.map

package/build/recipes/nuxt_static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt_static.js","sourceRoot":"","sources":["../../recipes/nuxt_static.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE5D,GAAG,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAA;AAExC,IAAI,CAAC,qCAAqC,CAAC,CAAA;AAC3C,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,KAAK,CAAC,eAAe,CAAC,CAAA;AAC9B,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA"}

package/build/recipes/pm2.js

@@ -1,4 +1,3 @@
-import { createRequire } from 'node:module';
 import { task, desc, cd, run, after, onStatus, bin } from "../index.js";
 import { ssh, q } from "../src/utils.js";
 onStatus(async (_ctx, host) => {
@@ -42,10 +41,12 @@ task('pm2:delete', async () => {
 });
 desc('Displays the last 50 lines of logs for all apps');
 task('pm2:logs', async ({ host, paths, logger }) => {
-    const require = createRequire(import.meta.url);
-    const ecosystem = require(process.cwd() + '/ecosystem.config.cjs');
-    const names = (ecosystem?.apps ?? []).map((a) => a.name).join(' ');
-    const { stdout } = await ssh(host, `set -e\ncd ${q(paths.current)}\n${bin('pm2')} logs ${names} --nostream --lines 50`, { color: true });
+    const { stdout } = await ssh(host, `
+    set -e
+    cd ${q(paths.current)}
+    names=$(${bin('node')} -e "const e=require('./ecosystem.config.cjs'); console.log((e.apps||[]).map((a)=>a.name).join(' '))")
+    ${bin('pm2')} logs $names --nostream --lines 50
+  `, { color: true });
     logger.log(stdout.trim());
 });
 desc('Lists all PM2 processes');
@@ -57,15 +58,15 @@ task('pm2:list', async ({ host, paths, logger }) => {
 });
 desc('Shows detailed info for each app in ecosystem.config.cjs');
 task('pm2:show', async ({ host, paths, logger }) => {
-    const require = createRequire(import.meta.url);
-    const ecosystem = require(process.cwd() + '/ecosystem.config.cjs');
-    const names = (ecosystem?.apps ?? []).map((a) => a.name);
-    for (const name of names) {
-        const { stdout } = await ssh(host, `set -e\ncd ${q(paths.current)}\n${bin('pm2')} show ${q(name)}`, {
-            color: true,
-        });
-        logger.log(stdout.trim());
-    }
+    const { stdout } = await ssh(host, `
+    set -e
+    cd ${q(paths.current)}
+    names=$(${bin('node')} -e "const e=require('./ecosystem.config.cjs'); console.log((e.apps||[]).map((a)=>a.name).join(' '))")
+    for name in $names; do
+      ${bin('pm2')} show "$name"
+    done
+  `, { color: true });
+    logger.log(stdout.trim());
 });
 after('deploy:publish', 'pm2:startOrReload');
 after('pm2:startOrReload', 'pm2:save');

package/build/recipes/pm2.js.map

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

package/build/recipes/tanstack.d.ts

@@ -0,0 +1 @@
+export {};

package/build/recipes/tanstack.js

@@ -0,0 +1,5 @@
+import { set, after } from "../index.js";
+set('shared_files', ['.env']);
+after('deploy:update_code', 'deploy:install');
+after('deploy:install', 'deploy:build');
+//# sourceMappingURL=tanstack.js.map

package/build/recipes/tanstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.js","sourceRoot":"","sources":["../../recipes/tanstack.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAE7B,KAAK,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;AAC7C,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catapultjs/deploy",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "main": "build/index.js",
   "bin": {
@@ -42,6 +42,10 @@
     "deployment",
     "ssh",
     "nodejs",
+    "capistrano",
+    "deployer",
+    "release",
+    "rollback",
     "adonisjs",
     "pm2",
     "rsync",

package/skills/catapultjs/SKILL.md

@@ -9,7 +9,7 @@ Capistrano-style SSH deployment for Node.js: versioned releases under `releases/
 
 ## Critical rule
 
-`defineConfig()` does not impose a deployment mode: exactly one recipe (or a custom task) must provide the `deploy:update_code` pipeline task. Providers: `recipes/git`, `recipes/rsync`, `recipes/adonisjs_local`, `recipes/astro`, `recipes/vitepress`, or your own `task('deploy:update_code', …)`. A config without one fails at deploy time.
+`deploy:update_code` uploads `source_path` by SCP by default. Import `recipes/git` or `recipes/rsync` only when you want to replace that delivery behavior. Do not combine delivery providers such as `git` and `rsync` unless the user explicitly defines the pipeline.
 
 ## References
 
@@ -19,9 +19,23 @@ 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, astro, vitepress, adonisjs, nuxt, 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): 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) |
 
 When a change spans several areas (e.g. a config plus a custom recipe), read every matching reference.
+
+## Interactive config workflow
+
+When the user asks to create, initialize, or configure a Catapult deployment and the required facts are not already present in the repo or prompt, ask focused questions before writing `deploy.ts`.
+
+Do not invent production values. At minimum, determine:
+
+- app stack/recipe (`nextjs`, `nextjs_static`, `nuxt`, `astro`, `nestjs`, `tanstack`, `adonisjs`, etc.)
+- code delivery mode (default SCP via `source_path`, `git`, `rsync`, local-build/static recipe, or custom)
+- host name, SSH target, deploy path, and branch if using `git`
+- process manager (`pm2` or none) and whether an `ecosystem.config.cjs` should be created
+- `.env`/shared paths and optional healthcheck URL
+
+Prefer one compact question group over a long interview. If the project files already answer some items, state the inferred values and ask only for the missing or ambiguous ones. After the user answers, generate the config and include the setup/deploy commands.

package/skills/catapultjs/references/config.md

@@ -2,6 +2,27 @@
 
 The config file is auto-detected as `deploy.ts`, `deploy.js`, `deploy.config.ts` or `deploy.config.js` at the project root (override with `cata --config <path>`). It must default-export `defineConfig()`. Full reference: https://catapultjs.com/guide/api
 
+## Before creating a config
+
+If the user asks to create or configure a deployment and the repo/prompt does not provide enough information, ask for the missing deployment facts before writing files. Do not guess real production values such as SSH hostnames, deploy paths, domains, branches, or healthcheck URLs.
+
+Use project inspection first:
+
+- `package.json` scripts and dependencies identify the stack and package manager.
+- Framework config files identify variants: `next.config.*` (`standalone` vs `export`), `nuxt.config.*`, `astro.config.*`, `vite.config.*`, `adonisrc.ts`, `nest-cli.json`.
+- Existing `ecosystem.config.cjs` means `recipes/pm2` is likely wanted.
+- Existing `.env.example`, `storage/`, `uploads/`, `public/`, or app-specific folders can suggest shared paths, but confirm anything destructive or production-specific.
+
+Ask a compact set of questions for missing values:
+
+1. Which environment and server? Need host name, SSH target (`user@host`), and absolute `deployPath`.
+2. How should code reach the server? Use default SCP when uploading `source_path` is enough; choose `git` when the server can access the repository; choose `rsync` when rsync-based sync/delete behavior is preferred.
+3. Which branch or source path should deploy?
+4. Should PM2 be configured? If yes, confirm app name, start entry, port, and whether to create `ecosystem.config.cjs`.
+5. Is there a healthcheck URL and any extra shared files or directories?
+
+When the user answers, generate `deploy.ts` with the selected recipes and put `set(...)` calls before the recipe imports they configure.
+
 ```typescript
 import { defineConfig } from '@catapultjs/deploy'
 import '@catapultjs/deploy/recipes/git'
@@ -19,25 +40,32 @@ export default defineConfig({
 })
 ```
 
-## Critical rule: code delivery
+## Code delivery
 
-`defineConfig()` does not impose a deployment mode. The pipeline task `deploy:update_code` MUST be provided by exactly one recipe (or a custom task), otherwise the deploy fails. Pick one:
+Catapult registers a default `deploy:update_code` task that uploads `source_path` via SCP. Recipes can override that task when a different delivery mechanism is needed. Pick one delivery mode:
 
 | Recipe | Delivery | Use for |
 | --- | --- | --- |
+| default `deploy:update_code` | Uploads `source_path` via SCP | Simple local upload, static recipes that set `source_path` |
 | `recipes/git` | Clones the repo on the server (bare mirror in `.catapult/repo`) | Server can reach the repo, build on server |
 | `recipes/rsync` | Pushes a local directory into the release | Local builds, no repo access from server |
 | `recipes/adonisjs_local` | Builds AdonisJS locally, uploads the artifact | AdonisJS without building on the server |
-| `recipes/astro` / `recipes/vitepress` | Builds locally, uploads the static output | Static sites |
+| `recipes/vitepress` | Builds locally, uploads the static output | VitePress static sites |
 | custom `task('deploy:update_code', …)` | Whatever you implement | Anything else |
 
+Avoid combining providers that override `deploy:update_code` (`git`, `rsync`, `adonisjs_local`, `vitepress`, custom) unless intentionally replacing task behavior.
+
 ## Picking recipes by stack
 
 Inspect the project (`package.json`, lock file, config files) before choosing:
 
-- **AdonisJS**: `adonisjs` (installs and builds on the server, exposes `ace:*` migration tasks) or `adonisjs_local` (build locally, upload). Both need a delivery recipe only in the `adonisjs` case (pair it with `git`).
-- **Nuxt**: `nuxt` (exposes `deploy:build` and `nuxt:generate`), pair with `git`.
-- **Astro / VitePress**: `astro` / `vitepress` alone (they handle delivery).
+- **Next.js**: `nextjs` for standalone server builds on the server (pair with `git` or `rsync`); `nextjs_static` for static export built locally and uploaded from `./out/.` using default SCP unless `rsync` is imported.
+- **Nuxt**: `nuxt` for server builds on the server (pair with `git` or `rsync`); `nuxt_static` for local static generation uploaded from `./.output/public/.` using default SCP unless `rsync` is imported.
+- **Astro**: `astro` for standalone server builds on the server (pair with `git` or `rsync`); `astro_static` for static sites built locally and uploaded from `./dist/.` using default SCP unless `rsync` is imported.
+- **TanStack Start**: `tanstack` for server builds on the server (pair with `git` or `rsync`); configure Vite with Nitro `node-server`.
+- **NestJS**: `nestjs` wires standard install/build on the server (pair with `git` or `rsync`).
+- **AdonisJS**: `adonisjs` (installs and builds on the server, exposes `ace:*` migration tasks; pair with `git` or `rsync`) or `adonisjs_local` (build locally, upload).
+- **VitePress**: `vitepress` builds locally and uploads the static output.
 - **Process manager**: add `pm2` if the app runs under PM2 (`ecosystem.config.cjs` expected in the project). It wires restart after publish and adds `pm2:*` tasks plus a status report.
 - **Extras**: `directus` (DB migrations and schema snapshots), `redis` (`redis:db:flush*` tasks, configure with `set('redis_db', n)`).
 
@@ -159,7 +187,7 @@ Rules:
 ## Checklist
 
 1. `defineConfig()` is the default export.
-2. Exactly one provider for `deploy:update_code` is imported (or defined).
+2. Delivery mode is intentional: default SCP, or one overriding provider such as `git`, `rsync`, `adonisjs_local`, `vitepress`, or a custom `deploy:update_code`.
 3. Recipe store options (`set(…)`) match the imported recipes.
 4. Healthcheck URLs point to an endpoint reachable from the server itself.
 5. Pin the package version in `package.json` (the API is still in beta).

package/skills/catapultjs/references/recipes.md

@@ -10,14 +10,20 @@ Full docs: https://catapultjs.com/guide/recipes
 | --- | --- | --- |
 | `recipes/git` | Yes | Server can reach the repo; build runs on the server |
 | `recipes/rsync` | Yes | Local build, push artifacts via rsync |
-| `recipes/astro` | Yes | Astro site, build locally, upload dist |
+| `recipes/astro` | No (pair with `git` or `rsync`) | Astro, build on the server |
+| `recipes/astro_static` | Uses default SCP; `rsync` optional | Static Astro site, build locally |
 | `recipes/vitepress` | Yes | VitePress site, build locally, upload dist |
 | `recipes/adonisjs_local` | Yes | AdonisJS, build locally, upload artifact |
 | `recipes/adonisjs` | No (pair with `git` or `rsync`) | AdonisJS, build on the server |
+| `recipes/nestjs` | No (pair with `git` or `rsync`) | NestJS, build on the server |
+| `recipes/nextjs` | No (pair with `git` or `rsync`) | Next.js, build on the server |
+| `recipes/nextjs_static` | Uses default SCP; `rsync` optional | Static Next.js export, build locally |
 | `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/pm2` | No | Process management (add to any stack) |
 | `recipes/redis` | No | Redis cache flush (add to any stack) |
+| `recipes/tanstack` | No (pair with `git` or `rsync`) | TanStack Start, build on the server |
 
 ---
 
@@ -71,25 +77,70 @@ import '@catapultjs/deploy/recipes/rsync'
 import '@catapultjs/deploy/recipes/astro'
 ```
 
-Builds locally before the lock step, then uploads the output via SCP. Does not run `astro build` on the server.
+Remote build. Does not override `deploy:update_code` — pair with `git` or `rsync`.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:install` | after `deploy:update_code` | Installs dependencies in the release |
+| `deploy:build` | after `deploy:shared` | Runs `astro build` on the server |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `astro_path` | `string` | `''` | Sub-path to the Astro app (monorepo) |
+| `source_path` | `string` | `''` | Used as default for `astro_path` |
+
+```typescript
+set('astro_path', 'apps/web')
+import '@catapultjs/deploy/recipes/astro'
+```
+
+Enable standalone server output in `astro.config.mjs`:
+
+```typescript
+import { defineConfig } from 'astro/config'
+import node from '@astrojs/node'
+
+export default defineConfig({
+  output: 'server',
+  adapter: node({
+    mode: 'standalone',
+  }),
+})
+```
+
+---
+
+## `recipes/astro_static`
+
+```typescript
+import '@catapultjs/deploy/recipes/astro_static'
+```
+
+Local build for static Astro sites. Sets `source_path` to `./dist/.` and runs `astro build --mode <astro_mode>` before the remote lock step.
+
+Uses the built-in `deploy:update_code` task by default, which transfers `source_path` via SCP. Import `rsync` only if rsync-based transfers are preferred. Do not combine with `git`.
 
 | Task | Inserted | Description |
 | --- | --- | --- |
 | `deploy:build` | before `deploy:lock` | Runs `astro build --mode <astro_mode>` locally |
-| `deploy:update_code` | — | Uploads the generated directory to `releases/<release>` via SCP |
 
 | Key | Type | Default | Description |
 | --- | --- | --- | --- |
 | `astro_mode` | `string \| Record<string, string>` | `'production'` | Build mode. String = same for all hosts; object = per host name |
-| `source_path` | `string` | `'./dist/.'` | Local directory uploaded after the build |
+| `source_path` | `string` | `'./dist/.'` | Local static output directory to transfer |
 
 ```typescript
 // Per-host modes
 set('astro_mode', { production: 'production', staging: 'staging' })
-import '@catapultjs/deploy/recipes/astro'
+import '@catapultjs/deploy/recipes/astro_static'
 ```
 
-To use rsync instead of SCP for the upload, import both `astro` and `rsync` — `astro` provides `deploy:build`, `rsync` overrides `deploy:update_code`. Do not combine with `git`.
+Optional rsync transfer:
+
+```typescript
+import '@catapultjs/deploy/recipes/astro_static'
+import '@catapultjs/deploy/recipes/rsync'
+```
 
 ---
 
@@ -176,6 +227,103 @@ Local build + artifact upload. Same `ace:*` tasks as `adonisjs`. Copies `package
 
 ---
 
+## `recipes/nestjs`
+
+```typescript
+import '@catapultjs/deploy/recipes/nestjs'
+```
+
+Remote build for NestJS applications. Does not override `deploy:update_code` — pair with `git` or `rsync`.
+
+Uses the default Node.js install/build tasks: install dependencies in `{{release_path}}`, then run the package manager build script.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:install` | after `deploy:update_code` | Installs dependencies in the release |
+| `deploy:build` | after `deploy:install` | Runs the default `deploy:build` task (`<pm> run build`) |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `shared_files` | `string[]` | `['.env']` | Symlinked into each release |
+
+```typescript
+import '@catapultjs/deploy/recipes/git'
+import '@catapultjs/deploy/recipes/nestjs'
+import '@catapultjs/deploy/recipes/pm2'
+```
+
+PM2 entry:
+
+```javascript
+{
+  name: 'nest',
+  cwd: path.join(deployPath, 'current'),
+  script: 'node',
+  args: 'dist/main.js',
+}
+```
+
+---
+
+## `recipes/tanstack`
+
+```typescript
+import '@catapultjs/deploy/recipes/tanstack'
+```
+
+Remote build for TanStack Start applications. Does not override `deploy:update_code` — pair with `git` or `rsync`.
+
+Uses the default Node.js install/build tasks: install dependencies in `{{release_path}}`, then run the package manager build script. `.env` is shared by default.
+
+For Vite-based TanStack Start deployments on Node.js, use Nitro with the `node-server` preset and start the generated `.output/server/index.mjs` file.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:install` | after `deploy:update_code` | Installs dependencies in the release |
+| `deploy:build` | after `deploy:install` | Runs the default `deploy:build` task (`<pm> run build`) |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `shared_files` | `string[]` | `['.env']` | Symlinked into each release |
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import { nitro } from 'nitro/vite'
+import viteReact from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [tanstackStart(), nitro({ preset: 'node-server' }), viteReact()],
+})
+```
+
+```json
+{
+  "scripts": {
+    "build": "vite build",
+    "start": "node .output/server/index.mjs"
+  }
+}
+```
+
+PM2 environment should pass host/port explicitly:
+
+```javascript
+env: {
+  NODE_ENV: 'production',
+  HOST: '0.0.0.0',
+  HOSTNAME: '0.0.0.0',
+  NITRO_HOST: '0.0.0.0',
+  PORT: 3000,
+  NITRO_PORT: 3000,
+}
+```
+
+Upstream hosting docs: https://tanstack.com/start/latest/docs/framework/react/guide/hosting#nodejs--docker
+
+---
+
 ## `recipes/nuxt`
 
 ```typescript
@@ -200,6 +348,138 @@ set('nuxt_path', 'apps/web')
 import '@catapultjs/deploy/recipes/nuxt'
 ```
 
+PM2 entry:
+
+```javascript
+{
+  name: 'nuxt',
+  cwd: path.join(deployPath, 'current'),
+  script: '.output/server/index.mjs',
+}
+```
+
+For static Nuxt sites generated locally, use `recipes/nuxt_static`.
+
+---
+
+## `recipes/nuxt_static`
+
+```typescript
+import '@catapultjs/deploy/recipes/nuxt_static'
+```
+
+Local generation for static Nuxt sites. Sets `source_path` to `./.output/public/.` and runs `nuxt generate` before the remote lock step.
+
+Uses the built-in `deploy:update_code` task by default, which transfers `source_path` via SCP. Import `rsync` only if rsync-based transfers are preferred. Do not combine with `git`.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:build` | before `deploy:lock` | Runs `nuxt generate` locally |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `source_path` | `string` | `'./.output/public/.'` | Local generated output directory to transfer |
+
+```typescript
+import '@catapultjs/deploy/recipes/nuxt_static'
+```
+
+Optional rsync transfer:
+
+```typescript
+import '@catapultjs/deploy/recipes/nuxt_static'
+import '@catapultjs/deploy/recipes/rsync'
+```
+
+---
+
+## `recipes/nextjs`
+
+```typescript
+import '@catapultjs/deploy/recipes/nextjs'
+```
+
+Remote build. Does not override `deploy:update_code` — pair with `git` or `rsync`.
+
+After `next build`, the recipe symlinks `public` and `.next/static` into `.next/standalone/` when the standalone output directory exists.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:build` | after `deploy:shared` | Runs `next build` and prepares standalone output symlinks |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `shared_files` | `string[]` | `['.env']` | Symlinked into each release |
+| `nextjs_path` | `string` | `''` | Sub-path to the Next.js app (monorepo) |
+| `nextjs_out_path` | `string` | `'.next/standalone/'` | Standalone output path receiving `public` and `.next/static` symlinks |
+| `source_path` | `string` | `''` | Used as default for `nextjs_path` |
+
+```typescript
+set('nextjs_path', 'apps/web')
+import '@catapultjs/deploy/recipes/nextjs'
+```
+
+Enable standalone output in `next.config.*`:
+
+```typescript
+export default {
+  output: 'standalone',
+}
+```
+
+Next.js creates `.next/standalone/server.js` for standalone deployments. It does not copy `public` or `.next/static` into the standalone directory by default; this recipe links them into the standalone output after the build.
+
+PM2 entry:
+
+```javascript
+{
+  name: 'next',
+  cwd: path.join(deployPath, 'current'),
+  script: '.next/standalone/server.js',
+}
+```
+
+Upstream output docs: https://nextjs.org/docs/pages/api-reference/config/next-config-js/output
+
+---
+
+## `recipes/nextjs_static`
+
+```typescript
+import '@catapultjs/deploy/recipes/nextjs_static'
+```
+
+Local build for static Next.js export. Sets `source_path` to `./out/.` and runs `next build` before the remote lock step.
+
+Uses the built-in `deploy:update_code` task by default, which transfers `source_path` via SCP. Import `rsync` only if rsync-based transfers are preferred.
+
+| Task | Inserted | Description |
+| --- | --- | --- |
+| `deploy:build` | before `deploy:lock` | Runs `next build` locally |
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `source_path` | `string` | `'./out/.'` | Local static export directory to transfer |
+
+```typescript
+import '@catapultjs/deploy/recipes/nextjs_static'
+```
+
+Optional rsync transfer:
+
+```typescript
+import '@catapultjs/deploy/recipes/nextjs_static'
+import '@catapultjs/deploy/recipes/rsync'
+```
+
+Enable static export in `next.config.*`:
+
+```typescript
+export default {
+  output: 'export',
+}
+```
+
 ---
 
 ## `recipes/directus`