rampway 0.2.1

package/README.md

@@ -0,0 +1,183 @@
+# Rampway Deploy
+
+Rampway is a JavaScript-native release-directory deployment tool: the useful parts of Capistrano, built for Node/Expo/Velocious projects and designed to hand runtime changes to Rollbridge.
+
+Package: `rampway`  
+CLI: `rampway`  
+Config: `rampway.config.mjs`
+
+## Current MVP
+
+This initial scaffold includes:
+
+- ESM config loading and validation
+- deterministic deploy plans
+- local release-directory deploys for tests/dogfooding
+- linked file/dir checks and symlink creation
+- deploy lock acquisition/release
+- release metadata (`REVISION`, `TRESTLE_RELEASE.json`)
+- atomic `current` symlink publishing
+- safe cleanup
+- rollback to previous or selected release
+- JSONL deploy reports at `shared/log/rampway-deployments.jsonl`
+- secret redaction helpers
+- basic runtime adapter interface with `none` and Rollbridge validate/deploy/status/logs/recover helpers
+
+SSH transport command execution supports both local-copy and remote-git deployments. `remote-git` prepares each release checkout on the target host, so the target needs `git` and access to the configured repository.
+
+Full config reference: [docs/config-reference.md](docs/config-reference.md)
+Migrating from Capistrano: [docs/migration-from-capistrano.md](docs/migration-from-capistrano.md)
+
+## Commands
+
+```bash
+rampway init
+rampway validate production
+rampway plan production
+rampway plan production --json
+rampway deploy production
+rampway status production
+rampway releases production
+rampway releases production --json
+rampway rollback production
+rampway doctor production
+rampway doctor production --json
+
+# Rollbridge runtime helpers for the current release
+rampway rollbridge-validate production
+rampway rollbridge-status production
+rampway rollbridge-logs production
+rampway rollbridge-recover production --yes
+```
+
+For local development without installing the package globally:
+
+```bash
+node src/cli.js init
+node src/cli.js validate --config examples/local/rampway.config.mjs local
+node src/cli.js plan --config examples/local/rampway.config.mjs local
+node src/cli.js deploy --config examples/local/rampway.config.mjs local --yes
+
+# Monorepo example with backend + frontend stages
+node src/cli.js validate --config examples/monorepo/rampway.config.mjs local
+node src/cli.js plan --config examples/monorepo/rampway.config.mjs local
+```
+
+## Config example
+
+Reusable Node package install helpers can be imported from `rampway/tasks` when writing `rampway.config.mjs`:
+
+```js
+import {npmInstall, pnpmInstall, checkExpoWebArtifacts, velociousMigrate, onlyIfChanged} from "rampway/tasks"
+```
+
+```js
+// rampway.config.mjs
+export default {
+  application: "routergeist",
+  stages: {
+    production: {
+      repo: "git@github.com:kaspernj/routergeist.git",
+      branch: "master",
+      deployTo: "/home/dev/routergeist",
+      strategy: "remote-git",
+      transport: {type: "ssh"},
+      hosts: [{host: "server.example", user: "dev", roles: ["app", "web", "db"]}],
+      keepReleases: 5,
+      linkedFiles: [
+        {path: "backend/src/config/secrets.js", required: true}
+      ],
+      linkedDirs: ["log", "tmp/pids", "tmp/cache", "storage"],
+      tasks: {
+        install: [
+          npmInstall({cwd: "backend", production: true}),
+          pnpmInstall({cwd: "app", production: true})
+        ],
+        migrate: [
+          velociousMigrate({cwd: "backend", env: {NODE_ENV: "production"}})
+        ],
+        build: [
+          "cd app && npm run web:export",
+          checkExpoWebArtifacts({dir: "app/dist"}),
+          {command: "npm run assets:verify", cwd: "app", env: {NODE_ENV: "production"}}
+        ]
+      },
+      runtime: {
+        type: "rollbridge",
+        command: "npx rollbridge",
+        packageDir: "backend",
+        config: "config/rollbridge.production.mjs",
+        healthPath: "/health",
+        daemonLogPath: "/home/dev/routergeist/shared/log/rollbridge.log",
+        daemonPidPath: "/home/dev/routergeist/shared/tmp/pids/rollbridge.pid",
+        socketPath: "/tmp/rollbridge-routergeist.sock",
+        versionPath: "/home/dev/routergeist/shared/tmp/rollbridge-version"
+      }
+    }
+  }
+}
+```
+
+`npmInstall`, `pnpmInstall`, `yarnInstall`, `bunInstall`, and `nodePackageInstall` return normal task entries with the right install command for common Node package managers. They accept `cwd`, `env`, `optional`, `production`, and lockfile options such as `clean: false` for `npm install` instead of `npm ci`, or `frozenLockfile: false` for package managers that need explicit CI lockfile opt-outs (`--no-frozen-lockfile` for pnpm and `--no-immutable` for Yarn). Yarn production installs are intentionally not guessed; use a custom task command when that project needs a specific Yarn workspace/plugin flow.
+
+`checkExpoWebArtifacts` returns a task entry that fails if the Expo web build directory does not contain an `index.html`. It accepts `dir` (default `"dist"`), `cwd`, and `optional`.
+
+`velociousMigrate` returns a task entry that runs `npx velocious db:migrate`. It accepts `command` (override), `cwd`, `env`, and `optional`.
+
+`onlyIfChanged(paths, task)` wraps a task entry so it is skipped when none of the given relative paths have changed since the previous deploy. On the first deploy (no previous release), all tasks run regardless.
+
+Task entries can be strings or objects.
+
+- `command` — required shell command to run.
+- `cwd` — optional release-relative working directory.
+- `env` — optional environment variables passed to the command.
+- `optional` — when `true`, the deploy records the task failure and continues.
+
+Task groups run in config order. Required task failures stop the deploy before publish. Deploy failures include whether `current` changed and recovery hints for the affected stage, such as rerunning a before-publish failure, inspecting a newly created failed release directory, or inspecting `rampway status`, `rampway releases`, and `rampway rollback` after a failure that happened after publish. Existing release-id collisions do not suggest deleting the release directory.
+
+## Deployment reports
+
+Every successful deploy or rollback appends one JSON object per line to `shared/log/rampway-deployments.jsonl`. Deploy events include:
+
+- `event: "deploy"`
+- `application`, `stage`, `releaseId`, `revision`, and `branch`
+- `deployedAt` and `durationMs`
+- `previousRelease`
+- `healthChecks: "passed"`
+- sanitized runtime status
+- `cleanupRemoved` release IDs
+
+Rollback events include `event: "rollback"`, the target `releaseId`, `rolledBackAt`, and `previousRelease`. Reports intentionally record runtime result summaries, not runtime configuration secrets.
+
+## Releasing
+
+Tag pushes trigger the `.github/workflows/release.yml` workflow, which validates the package, publishes it to npm, and then creates a GitHub Release with auto-generated notes. Bump the version locally and push tags:
+
+```bash
+npm run release:patch   # 0.1.0 → 0.1.1
+npm run release:minor   # 0.1.1 → 0.2.0
+npm run release:major   # 0.2.0 → 1.0.0
+```
+
+Each command runs `npm version` (updating `package.json` and creating a `v`-prefixed tag) and pushes the commit and tag. The workflow picks up the tag, publishes the package, and creates the GitHub Release only after publishing succeeds.
+
+Publishing requires an npm access token stored as the repository secret `NPM_TOKEN`.
+
+## Runtime adapters
+
+Rampway resolves runtimes through a small adapter registry. Built-in adapters are `none` and `rollbridge`; future adapters can register a runtime type without changing the deploy lifecycle core. Runtime adapters implement `plan()` and `deploy(...)`; optional maintenance methods such as `status`, `logs`, and `recover` can be exposed by adapter-specific commands.
+
+Rollbridge runtime options:
+
+- `command` — shell command used to invoke Rollbridge, defaulting to `npx rollbridge`.
+- `packageDir` — release-relative directory where Rollbridge commands run.
+- `config` — optional Rollbridge config path passed as `--config`.
+- `daemonLogPath`, `daemonPidPath`, and `daemonStartTimeoutMs` — optional daemon flags forwarded to `rollbridge deploy`.
+- `versionPath` — optional shared file where Rampway records the deployed Rollbridge package version.
+- `socketPath` — optional Rollbridge socket removed after a version-change shutdown if a stale daemon leaves it behind.
+
+When `versionPath` is configured, Rampway reads the release's installed Rollbridge package version before deploy. If it differs from the recorded version and the current runtime is responsive, Rampway shuts down the current Rollbridge daemon, removes configured stale daemon artifacts, deploys the new release, and records the new version.
+
+## Safety model
+
+Rampway prepares a complete release before flipping `current`. If a deploy fails before publish, `current` remains unchanged. Rollbridge runtime deploys are validated and health-checked with `rollbridge status` before `current` is updated. Cleanup never removes the current release. Rollback changes `current` to a previously prepared release and records a deployment event.

package/build/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/build/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.js"],"names":[],"mappings":""}

package/build/src/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { validateCommand } from "./commands/validate.js";
+import { planCommand } from "./commands/plan.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { deployCommand } from "./commands/deploy.js";
+import { releasesCommand, statusCommand } from "./commands/releases.js";
+import { rollbackCommand } from "./commands/rollback.js";
+import { rollbridgeValidateCommand, rollbridgeStatusCommand, rollbridgeLogsCommand, rollbridgeRecoverCommand } from "./commands/rollbridge.js";
+import { initCommand } from "./commands/init.js";
+/** @type {Record<string, Function>} */
+const COMMANDS = {
+    init: initCommand,
+    validate: validateCommand,
+    plan: planCommand,
+    deploy: deployCommand,
+    releases: releasesCommand,
+    status: statusCommand,
+    rollback: rollbackCommand,
+    "rollbridge-validate": rollbridgeValidateCommand,
+    "rollbridge-status": rollbridgeStatusCommand,
+    "rollbridge-logs": rollbridgeLogsCommand,
+    "rollbridge-recover": rollbridgeRecoverCommand,
+    doctor: doctorCommand
+};
+/**
+ * @param {string[]} argv
+ * @returns {Promise<void>}
+ */
+async function main(argv) {
+    let { command, stageName, options } = parseArgs(argv);
+    // Stage-first Capistrano-style invocation: `rampway production deploy`
+    // (the first positional matches a known deploy/<stage>.js file and the second is a valid command)
+    if (command && stageName && !COMMANDS[command] && COMMANDS[stageName] && stageFileExists(command, options.config)) {
+        [command, stageName] = [stageName, command];
+    }
+    if (!COMMANDS[command])
+        throw new Error(`Unknown command '${command}'. Supported: ${Object.keys(COMMANDS).join(", ")}`);
+    if (!stageName && command !== "init")
+        throw new Error(`Usage: rampway <command> <stage>  OR  rampway <stage> <command>  [--config path]`);
+    await COMMANDS[command]({ stageName, options });
+}
+/**
+ * @param {string} stageName
+ * @param {string} [configPath]
+ * @returns {boolean}
+ */
+function stageFileExists(stageName, configPath) {
+    if (configPath)
+        return false;
+    // Capistrano-style: stage configs live in deploy/environments/<stage>.js.
+    // Walk up from cwd to find the project root that contains deploy/config.js.
+    let dir = process.cwd();
+    for (let i = 0; i < 5; i++) {
+        const candidate = path.join(dir, "deploy", "environments", `${stageName}.js`);
+        try {
+            if (fs.statSync(candidate).isFile())
+                return true;
+        }
+        catch { /* continue */ }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return false;
+}
+/**
+ * @param {string[]} argv
+ * @returns {{command: string, stageName: string, options: import('#types').CommandOptions}}
+ */
+function parseArgs(argv) {
+    const positional = [];
+    /** @type {Record<string, string|boolean>} */
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg.startsWith("--")) {
+            const name = arg.slice(2);
+            if (["yes", "dry-run", "force", "allow-dirty", "json"].includes(name))
+                options[toCamel(name)] = true;
+            else {
+                index += 1;
+                options[toCamel(name)] = argv[index];
+            }
+        }
+        else
+            positional.push(arg);
+    }
+    return { command: positional[0], stageName: positional[1], options };
+}
+/**
+ * @param {string} name
+ * @returns {string}
+ */
+function toCamel(name) {
+    return name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+main(process.argv.slice(2)).catch(error => {
+    console.error(error.message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/build/src/cli.js.map

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

package/build/src/commands/context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @param {import('#types').CommandOptions} options
+ * @param {string} stageName
+ * @returns {Promise<{config: object, configPath: string, stage: import('#types').StageConfig, transport: import('#types').Transport}>}
+ */
+export function commandContext(options: import("#types").CommandOptions, stageName: string): Promise<{
+    config: object;
+    configPath: string;
+    stage: import("#types").StageConfig;
+    transport: import("#types").Transport;
+}>;
+//# sourceMappingURL=context.d.ts.map

package/build/src/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/commands/context.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wCAJW,OAAO,QAAQ,EAAE,cAAc,aAC/B,MAAM,GACJ,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAA;CAAC,CAAC,CAOrI"}

package/build/src/commands/context.js

@@ -0,0 +1,16 @@
+import { loadConfig } from "../config/load-config.js";
+import { validateConfig } from "../config/validate-config.js";
+import { LocalTransport } from "../transports/local-transport.js";
+import { SshTransport } from "../transports/ssh-transport.js";
+/**
+ * @param {import('#types').CommandOptions} options
+ * @param {string} stageName
+ * @returns {Promise<{config: object, configPath: string, stage: import('#types').StageConfig, transport: import('#types').Transport}>}
+ */
+export async function commandContext(options, stageName) {
+    const { config, configPath } = await loadConfig(options.config, stageName);
+    const stage = validateConfig(/** @type {Record<string, unknown>} */ (config), stageName);
+    const transport = stage.transport.type === "ssh" ? SshTransport.fromStage(stage) : new LocalTransport();
+    return { config, configPath, stage, transport };
+}
+//# sourceMappingURL=context.js.map

package/build/src/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/commands/context.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAA;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAO,EAAE,SAAS;IACrD,MAAM,EAAC,MAAM,EAAE,UAAU,EAAC,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACxE,MAAM,KAAK,GAAG,cAAc,CAAC,sCAAsC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAA;IACxF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,EAAE,CAAA;IACvG,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAC,CAAA;AAC/C,CAAC"}

package/build/src/commands/deploy.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function deployCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

package/build/src/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,sEAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOzB"}

package/build/src/commands/deploy.js

@@ -0,0 +1,14 @@
+import { commandContext as defaultCommandContext } from "./context.js";
+import { deploy } from "../core/deploy-runner.js";
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export async function deployCommand({ stageName, options, commandContext = defaultCommandContext }) {
+    const { stage, transport } = await commandContext(options, stageName);
+    if (!options.yes && stageName === "production")
+        throw new Error("Refusing production deploy without --yes in non-interactive MVP mode.");
+    const report = await deploy({ transport, stage, sourcePath: options.source ?? process.cwd(), revision: options.revision ?? options.branch ?? stage.revision ?? stage.branch, branch: options.branch ?? stage.branch, dryRun: options.dryRun, force: options.force });
+    console.log(JSON.stringify(report, null, 2));
+}
+//# sourceMappingURL=deploy.js.map

package/build/src/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/commands/deploy.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,IAAI,qBAAqB,EAAC,MAAM,cAAc,CAAA;AACpE,OAAO,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAC,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,qBAAqB,EAAC;IAC9F,MAAM,EAAC,KAAK,EAAE,SAAS,EAAC,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACnE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,SAAS,KAAK,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IACxI,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,EAAC,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAC,CAAC,CAAA;IAClQ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/build/src/commands/doctor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function doctorCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+/**
+ * @param {{configPath: string, stage: import('#types').StageConfig}} opts
+ * @returns {import('#types').DoctorReport}
+ */
+export function doctorReport({ configPath, stage }: {
+    configPath: string;
+    stage: import("#types").StageConfig;
+}): import("#types").DoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/build/src/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,sEAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAyBzB;AAED;;;GAGG;AACH,oDAHW;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAA;CAAC,GACvD,OAAO,QAAQ,EAAE,YAAY,CAqBzC"}

package/build/src/commands/doctor.js

@@ -0,0 +1,54 @@
+import { commandContext as defaultCommandContext } from "./context.js";
+const DEPLOYABLE_STRATEGIES = new Set(["local-copy", "remote-git"]);
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export async function doctorCommand({ stageName, options, commandContext = defaultCommandContext }) {
+    const { configPath, stage } = await commandContext(options, stageName);
+    const report = doctorReport({ configPath, stage });
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log("Rampway doctor");
+    console.log(`Config: ok (${report.configPath})`);
+    console.log(`Application: ${report.application}`);
+    console.log(`Stage: ${report.stage}`);
+    console.log(`Transport: ${report.transport.type}`);
+    console.log(`Strategy: ${report.strategy}`);
+    console.log(`Deploy path: ${report.deployTo}`);
+    console.log(`Runtime: ${report.runtime.type}`);
+    console.log(`Linked files: ${report.linkedFiles}`);
+    console.log(`Linked dirs: ${report.linkedDirs}`);
+    console.log(`Task groups: ${report.taskGroups}`);
+    console.log(`Health checks: ${report.healthChecks}`);
+    console.log(`Result: ${report.ok ? "ok" : "warnings"}`);
+    for (const warning of report.warnings)
+        console.log(`Warning: ${warning}`);
+}
+/**
+ * @param {{configPath: string, stage: import('#types').StageConfig}} opts
+ * @returns {import('#types').DoctorReport}
+ */
+export function doctorReport({ configPath, stage }) {
+    const warnings = [];
+    if (!DEPLOYABLE_STRATEGIES.has(stage.strategy))
+        warnings.push(`Strategy '${stage.strategy}' validates but deploy is not implemented yet`);
+    return {
+        ok: warnings.length === 0,
+        configPath,
+        application: stage.application,
+        stage: stage.stageName,
+        deployTo: stage.deployTo,
+        transport: { type: stage.transport.type },
+        strategy: stage.strategy,
+        runtime: { type: stage.runtime.type },
+        linkedFiles: stage.linkedFiles.length,
+        linkedDirs: stage.linkedDirs.length,
+        taskGroups: Object.keys(stage.tasks).length,
+        healthChecks: stage.healthChecks.length,
+        warnings
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/build/src/commands/doctor.js.map

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

package/build/src/commands/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param {{dir?: string}} [opts]
+ * @returns {Promise<import('#types').InitResult>}
+ */
+export function initCommand({ dir }?: {
+    dir?: string;
+}): Promise<import("#types").InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/build/src/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,sCAHW;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GACZ,OAAO,CAAC,OAAO,QAAQ,EAAE,UAAU,CAAC,CAWhD"}

package/build/src/commands/init.js

@@ -0,0 +1,42 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const TEMPLATE = `export default {
+  application: "my-app",
+  stages: {
+    production: {
+      deployTo: "/home/dev/my-app",
+      strategy: "local-copy",
+      transport: {type: "ssh"},
+      hosts: [{host: "server.example", user: "dev", roles: ["app", "web"]}],
+      keepReleases: 5,
+      linkedFiles: [
+        {path: ".env", required: true}
+      ],
+      linkedDirs: ["log", "tmp/pids", "tmp/cache"],
+      tasks: {
+        install: ["npm ci --omit=dev"],
+        migrate: ["NODE_ENV=production npm run db:migrate"],
+        build: ["npm run build"]
+      },
+      runtime: {type: "none"},
+      healthChecks: [{name: "package", path: "package.json"}]
+    }
+  }
+}
+`;
+/**
+ * @param {{dir?: string}} [opts]
+ * @returns {Promise<import('#types').InitResult>}
+ */
+export async function initCommand({ dir = process.cwd() } = {}) {
+    const configPath = path.join(dir, "rampway.config.mjs");
+    try {
+        await fs.access(configPath);
+        return { created: false, path: configPath };
+    }
+    catch {
+        await fs.writeFile(configPath, TEMPLATE);
+        return { created: true, path: configPath };
+    }
+}
+//# sourceMappingURL=init.js.map

package/build/src/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBhB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAC,GAAG,EAAE;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAA;IACvD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAC3B,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAC,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QACxC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/build/src/commands/plan.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function planCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+//# sourceMappingURL=plan.d.ts.map

package/build/src/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/plan.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,oEAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBzB"}

package/build/src/commands/plan.js

@@ -0,0 +1,24 @@
+import { commandContext as defaultCommandContext } from "./context.js";
+import { createDeployPlanDetails } from "../core/deploy-runner.js";
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export async function planCommand({ stageName, options, commandContext = defaultCommandContext }) {
+    const { stage } = await commandContext(options, stageName);
+    const revision = options.revision ?? options.branch ?? stage.revision ?? stage.branch;
+    const releaseId = options.releaseId ?? "<timestamp>";
+    const steps = createDeployPlanDetails(stage, { revision, releaseId });
+    const payload = { application: stage.application, stage: stage.stageName, revision, releaseId, steps };
+    if (options.json) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log(`Plan for ${stage.application} ${stage.stageName}`);
+    console.log(`Revision: ${revision}`);
+    console.log(`Release: ${releaseId}`);
+    steps.forEach((step, index) => {
+        console.log(`${index + 1}. [${step.phase}] ${step.detail}`);
+    });
+}
+//# sourceMappingURL=plan.js.map

package/build/src/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/commands/plan.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,IAAI,qBAAqB,EAAC,MAAM,cAAc,CAAA;AACpE,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAA;AAEhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAC,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,qBAAqB,EAAC;IAC5F,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAA;IACrF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,aAAa,CAAA;IACpD,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,EAAE,EAAC,QAAQ,EAAE,SAAS,EAAC,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,EAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAC,CAAA;IAEpG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC7C,OAAM;IACR,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;IAC/D,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAA;IACpC,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,EAAE,CAAC,CAAA;IACpC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/src/commands/releases.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function releasesCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+/**
+ * @param {{stage: import('#types').StageConfig, transport: import('#types').Transport}} opts
+ * @returns {Promise<import('#types').ReleasesReport>}
+ */
+export function releasesReport({ stage, transport }: {
+    stage: import("#types").StageConfig;
+    transport: import("#types").Transport;
+}): Promise<import("#types").ReleasesReport>;
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function statusCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+/**
+ * @param {{stage: import('#types').StageConfig, transport: import('#types').Transport}} opts
+ * @returns {Promise<import('#types').StatusReport>}
+ */
+export function statusReport({ stage, transport }: {
+    stage: import("#types").StageConfig;
+    transport: import("#types").Transport;
+}): Promise<import("#types").StatusReport>;
+//# sourceMappingURL=releases.d.ts.map

package/build/src/commands/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../../src/commands/releases.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wEAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiBzB;AAED;;;GAGG;AACH,qDAHW;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAA;CAAC,GAC1E,OAAO,CAAC,OAAO,QAAQ,EAAE,cAAc,CAAC,CAiBpD;AAED;;;GAGG;AACH,sEAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBzB;AAED;;;GAGG;AACH,mDAHW;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAA;CAAC,GAC1E,OAAO,CAAC,OAAO,QAAQ,EAAE,YAAY,CAAC,CAsBlD"}