@developers-homelab/runestone-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cymondez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# Runestone
+
+English | [繁體中文](https://github.com/cymondez/runestone/blob/main/docs/README/README.zh-TW.md) | [日本語](https://github.com/cymondez/runestone/blob/main/docs/README/README.ja-JP.md)
+
+![logo](https://raw.githubusercontent.com/cymondez/runestone/main/logos/runestone_icon_gray_large.png)
+
+This project was forked from [druidfi/stonehenge 5.2](https://github.com/druidfi/stonehenge).
+The main change is replacing Makefile-based installation and management with an npm global tool that is easier to use across platforms.
+If you like this project, please also support the original idea by starring [druidfi/stonehenge 5.2](https://github.com/druidfi/stonehenge).
+
+## Introduction
+
+1. Local frontend and backend projects can be tested with `SSL certificates` and a `local domain`, avoiding many localhost-related issues.
+2. Ports 80 and 443 can be reused, reducing port conflicts between multiple local projects.
+3. You do not need to edit the hosts file just to use a `local domain`.
+
+## Core Components
+
+- traefik: Reverse proxy that routes requests to the matching project.
+- mailpit: SMTP testing tool that captures and displays sent emails.
+- npm tool: Command line tool for managing and running Runestone.
+- @mkcert/node: Generates locally trusted SSL certificates.
+
+## Requirements
+
+- Latest Ubuntu LTS, or Windows 10/11 with WSL2 installed.
+- Docker 29.0+ with Docker Compose V2.
+- Node.js 22.0+.
+
+## Installation And Usage
+
+### Install
+
+```bash
+npm install -g @developers-homelab/runestone-cli
+```
+
+### Start
+
+The first time you run it, an interactive setup wizard will appear. To change settings later, run `runestone setup`.
+
+```bash
+runestone up
+```
+
+### Stop Or Shut Down
+
+Note: If Runestone was not stopped before shutting down your system, it will start automatically on the next boot.
+
+Stop:
+
+```bash
+runestone stop
+```
+
+Shut down (stop and remove containers):
+
+```bash
+runestone down
+```
+
+## Certificate Management
+
+### List Certificates
+
+Shows the certificate list from the `.runestone/certs` directory.
+
+```bash
+runestone certs list
+```
+
+### Add Certificate
+
+Adds a certificate generated by `@mkcert/node` to the `.runestone/certs` directory and creates the dynamic Traefik configuration.
+
+```bash
+runestone certs create <domain>
+```
+
+### Remove Certificate
+
+Removes the certificate from the `.runestone/certs` directory and deletes the matching dynamic configuration.
+
+```bash
+runestone certs remove <domain>
+```
+
+## More Help
+
+```bash
+runestone --help
+```
+
+## Todo
+
+- [ ] Test on macOS (M1/M2/M3/M4/M5).
+
+## References
+
+- [druidfi/stonehenge](https://github.com/druidfi/stonehenge)
+- [axllent/mailpit](https://github.com/axllent/mailpit)
+- [FiloSottile/mkcert](https://github.com/FiloSottile/mkcert)
+- [traefik.io](https://traefik.io/)
+
+## License
+
+[MIT License](LICENSE)

package/bin/runestone

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const { resolve } = require('path');
+
+// Suppress experimental warnings
+process.env.NODE_ENV = process.env.NODE_ENV || 'production';
+
+try {
+  require(resolve(__dirname, '../dist/cli.js')).run();
+} catch (error) {
+  if (error.code === 'MODULE_NOT_FOUND') {
+    console.error('Error: dist/ directory not found. Run `npm run build` first.');
+  } else {
+    console.error('Error:', error.message);
+  }
+  process.exit(1);
+}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+export declare function run(argv?: string[]): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,aAAa,IAAI,OAAO,CAYvC;AAED,wBAAgB,GAAG,CAAC,IAAI,WAAe,GAAG,IAAI,CAE7C"}

package/dist/cli.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const certs_1 = require("./commands/certs");
+const down_1 = require("./commands/down");
+const keys_1 = require("./commands/keys");
+const setup_1 = require("./commands/setup");
+const status_1 = require("./commands/status");
+const stop_1 = require("./commands/stop");
+const up_1 = require("./commands/up");
+const i18n_1 = require("./i18n");
+const command_1 = require("./utils/command");
+function packageVersion() {
+    try {
+        const packagePath = path.resolve(__dirname, '..', 'package.json');
+        const parsed = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+        return parsed.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function createProgram() {
+    return (0, command_1.createCommand)()
+        .name('runestone')
+        .description((0, i18n_1.t)('cli.description'))
+        .version(packageVersion())
+        .addCommand((0, setup_1.createSetupCommand)())
+        .addCommand((0, up_1.createUpCommand)())
+        .addCommand((0, stop_1.createStopCommand)())
+        .addCommand((0, down_1.createDownCommand)())
+        .addCommand((0, status_1.createStatusCommand)())
+        .addCommand((0, certs_1.createCertsCommand)())
+        .addCommand((0, keys_1.createKeysCommand)());
+}
+function run(argv = process.argv) {
+    createProgram().parse(argv);
+}
+if (require.main === module) {
+    run();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,sCAYC;AAED,kBAEC;AAtCD,uCAAyB;AACzB,2CAA6B;AAC7B,4CAAsD;AACtD,0CAAoD;AACpD,0CAAoD;AACpD,4CAAsD;AACtD,8CAAwD;AACxD,0CAAoD;AACpD,sCAAgD;AAChD,iCAA2B;AAC3B,6CAAgD;AAEhD,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAyB,CAAC;QACxF,OAAO,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,IAAA,uBAAa,GAAE;SACnB,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,IAAA,QAAC,EAAC,iBAAiB,CAAC,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,CAAC;SACzB,UAAU,CAAC,IAAA,0BAAkB,GAAE,CAAC;SAChC,UAAU,CAAC,IAAA,oBAAe,GAAE,CAAC;SAC7B,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC;SAC/B,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC;SAC/B,UAAU,CAAC,IAAA,4BAAmB,GAAE,CAAC;SACjC,UAAU,CAAC,IAAA,0BAAkB,GAAE,CAAC;SAChC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IACrC,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,CAAC;AACR,CAAC"}

package/dist/commands/certs.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCertsCommand(): Command;
+//# sourceMappingURL=certs.d.ts.map

package/dist/commands/certs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certs.d.ts","sourceRoot":"","sources":["../../src/commands/certs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+CpC,wBAAgB,kBAAkB,IAAI,OAAO,CA2E5C"}

package/dist/commands/certs.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCertsCommand = createCertsCommand;
+const cert_manager_1 = require("../services/cert-manager");
+const docker_compose_1 = require("../services/docker-compose");
+const env_loader_1 = require("../utils/env-loader");
+const logger_1 = require("../utils/logger");
+const i18n_1 = require("../i18n");
+const command_1 = require("../utils/command");
+function shouldRestartOnWindows(changed) {
+    return changed && process.platform === 'win32';
+}
+function restartIfRunningOnWindows(composePath, changed) {
+    if (!shouldRestartOnWindows(changed)) {
+        return;
+    }
+    const running = docker_compose_1.composeService.ps(composePath).some((container) => container.State === 'running');
+    if (!running) {
+        logger_1.logger.warn('Certificate files changed, but no runestone container is running to restart.');
+        return;
+    }
+    logger_1.logger.info('Restarting runestone container so Docker Desktop picks up certificate/config changes');
+    docker_compose_1.composeService.restart(composePath);
+}
+function formatCertificateTable(items, options) {
+    const rows = items.map((item) => [
+        item.status,
+        item.sans.length > 0 ? item.sans.join(', ') : '-',
+        item.issuer || '-',
+        item.validUntil || '-',
+        item.expiry || '-'
+    ]);
+    const allRows = options.header ? [['Status', 'SANs', 'Issuer', 'Valid Until', 'Expiry'], ...rows] : rows;
+    const widths = allRows.reduce((next, row) => row.map((cell, index) => Math.max(next[index] ?? 0, cell.length)), []);
+    return allRows
+        .map((row) => row.map((cell, index) => cell.padEnd(widths[index])).join('  ').trimEnd())
+        .join('\n');
+}
+function createCertsCommand() {
+    const command = (0, command_1.createCommand)('certs')
+        .alias('cert')
+        .description((0, i18n_1.t)('commands.certs.description'));
+    command
+        .addCommand((0, command_1.createCommand)('create')
+        .alias('c')
+        .description((0, i18n_1.t)('commands.certs.create.description'))
+        .argument('<domain>', (0, i18n_1.t)('arguments.domain.create'))
+        .action(async (domain) => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            const result = await (0, cert_manager_1.createDomainCertificate)(config.PROJECT_DIR, domain);
+            restartIfRunningOnWindows(config.COMPOSE_FILE_PATH, result.certificateChanged || result.dynamicConfigChanged);
+            logger_1.logger.success(`Certificate configuration ready for '${result.artifacts.domain}'`);
+            console.log(`  Certificate: ${result.artifacts.certFile}`);
+            console.log(`  Key: ${result.artifacts.keyFile}`);
+            console.log(`  Traefik TLS config: ${result.artifacts.dynamicConfigFile}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to create certificate: ${message}`);
+            process.exit(1);
+        }
+    }));
+    command
+        .addCommand((0, command_1.createCommand)('list')
+        .alias('ls')
+        .description((0, i18n_1.t)('commands.certs.list.description'))
+        .option('--no-header', (0, i18n_1.t)('options.noHeader.description'))
+        .action((options) => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            const table = formatCertificateTable((0, cert_manager_1.listDomainCertificates)(config.PROJECT_DIR), { header: options.header });
+            if (table) {
+                console.log(table);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to list certificates: ${message}`);
+            process.exit(1);
+        }
+    }));
+    command
+        .addCommand((0, command_1.createCommand)('remove')
+        .alias('rm')
+        .alias('del')
+        .description((0, i18n_1.t)('commands.certs.remove.description'))
+        .argument('<domain>', (0, i18n_1.t)('arguments.domain.remove'))
+        .action((domain) => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            const result = (0, cert_manager_1.removeDomainCertificate)(config.PROJECT_DIR, domain);
+            const changed = result.certificateChanged || result.dynamicConfigChanged;
+            restartIfRunningOnWindows(config.COMPOSE_FILE_PATH, changed);
+            if (changed) {
+                logger_1.logger.success(`Certificate configuration removed for '${result.artifacts.domain}'`);
+            }
+            else {
+                logger_1.logger.warn(`No certificate configuration found for '${result.artifacts.domain}'`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to remove certificate: ${message}`);
+            process.exit(1);
+        }
+    }));
+    return command;
+}
+//# sourceMappingURL=certs.js.map

package/dist/commands/certs.js.map

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

package/dist/commands/down.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createDownCommand(): Command;
+//# sourceMappingURL=down.d.ts.map

package/dist/commands/down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,iBAAiB,IAAI,OAAO,CA4C3C"}

package/dist/commands/down.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDownCommand = createDownCommand;
+const docker_compose_1 = require("../services/docker-compose");
+const docker_network_1 = require("../services/docker-network");
+const docker_volume_1 = require("../services/docker-volume");
+const env_loader_1 = require("../utils/env-loader");
+const logger_1 = require("../utils/logger");
+const i18n_1 = require("../i18n");
+const command_1 = require("../utils/command");
+function ignoreMissingResource(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /not found|no such/i.test(message);
+}
+function createDownCommand() {
+    return (0, command_1.createCommand)('down')
+        .description((0, i18n_1.t)('commands.down.description'))
+        .option('--remove-network', (0, i18n_1.t)('options.removeNetwork.description'))
+        .option('--remove-volumes', (0, i18n_1.t)('options.removeVolumes.description'))
+        .option('--purge', (0, i18n_1.t)('options.purge.description'))
+        .action((options) => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            const removeVolumes = Boolean(options.removeVolumes || options.purge);
+            const removeNetwork = Boolean(options.removeNetwork || options.purge);
+            docker_compose_1.composeService.down(config.COMPOSE_FILE_PATH, {
+                removeVolumes,
+                removeImages: Boolean(options.purge)
+            });
+            if (removeNetwork) {
+                try {
+                    docker_network_1.networkService.removeNetwork(config.NETWORK_NAME);
+                }
+                catch (error) {
+                    if (!ignoreMissingResource(error)) {
+                        throw error;
+                    }
+                }
+            }
+            if (removeVolumes) {
+                try {
+                    docker_volume_1.volumeService.removeVolume(config.SSH_VOLUME_NAME);
+                }
+                catch (error) {
+                    if (!ignoreMissingResource(error)) {
+                        throw error;
+                    }
+                }
+            }
+            logger_1.logger.success(options.purge ? 'Full purge complete.' : 'Teardown complete.');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to tear down environment: ${message}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=down.js.map

package/dist/commands/down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":";;AAoBA,8CA4CC;AA/DD,+DAA4D;AAC5D,+DAA4D;AAC5D,6DAA0D;AAC1D,oDAAgD;AAChD,4CAAyC;AACzC,kCAA4B;AAC5B,8CAAiD;AAQjD,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,iBAAiB;IAC/B,OAAO,IAAA,uBAAa,EAAC,MAAM,CAAC;SACzB,WAAW,CAAC,IAAA,QAAC,EAAC,2BAA2B,CAAC,CAAC;SAC3C,MAAM,CAAC,kBAAkB,EAAE,IAAA,QAAC,EAAC,mCAAmC,CAAC,CAAC;SAClE,MAAM,CAAC,kBAAkB,EAAE,IAAA,QAAC,EAAC,mCAAmC,CAAC,CAAC;SAClE,MAAM,CAAC,SAAS,EAAE,IAAA,QAAC,EAAC,2BAA2B,CAAC,CAAC;SACjD,MAAM,CAAC,CAAC,OAAoB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,sBAAS,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;YAEtE,+BAAc,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE;gBAC5C,aAAa;gBACb,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;aACrC,CAAC,CAAC;YAEH,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,+BAAc,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBACpD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;wBAClC,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,6BAAa,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;gBACrD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;wBAClC,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;YAED,eAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,eAAM,CAAC,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/keys.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createKeysCommand(): Command;
+//# sourceMappingURL=keys.d.ts.map

package/dist/commands/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/commands/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,iBAAiB,IAAI,OAAO,CA0C3C"}

package/dist/commands/keys.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKeysCommand = createKeysCommand;
+const kleur_1 = require("kleur");
+const ssh_manager_1 = require("../services/ssh-manager");
+const env_loader_1 = require("../utils/env-loader");
+const logger_1 = require("../utils/logger");
+const i18n_1 = require("../i18n");
+const command_1 = require("../utils/command");
+function createKeysCommand() {
+    const command = (0, command_1.createCommand)('keys')
+        .description((0, i18n_1.t)('commands.keys.description'));
+    command
+        .addCommand((0, command_1.createCommand)('ls')
+        .alias('list')
+        .description((0, i18n_1.t)('commands.keys.ls.description'))
+        .action(() => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            const keys = ssh_manager_1.sshManager.listKeys(config.SSH_VOLUME_NAME);
+            if (keys.length === 0) {
+                logger_1.logger.warn('No injected SSH keys found.');
+                return;
+            }
+            keys.forEach((key) => console.log(`  ${(0, kleur_1.green)('+')} ${key}`));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to list SSH keys: ${message}`);
+            process.exit(1);
+        }
+    }));
+    command
+        .addCommand((0, command_1.createCommand)('add')
+        .description((0, i18n_1.t)('commands.keys.add.description'))
+        .argument('<path>', (0, i18n_1.t)('arguments.keyPath'))
+        .action((keyPath) => {
+        try {
+            const config = env_loader_1.envLoader.load();
+            ssh_manager_1.sshManager.addKey(keyPath, config.SSH_VOLUME_NAME);
+            logger_1.logger.success('SSH key added successfully.');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error(`Failed to add SSH key: ${message}`);
+            process.exit(1);
+        }
+    }));
+    return command;
+}
+//# sourceMappingURL=keys.js.map

package/dist/commands/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/commands/keys.ts"],"names":[],"mappings":";;AAQA,8CA0CC;AAjDD,iCAA8B;AAC9B,yDAAqD;AACrD,oDAAgD;AAChD,4CAAyC;AACzC,kCAA4B;AAC5B,8CAAiD;AAEjD,SAAgB,iBAAiB;IAC/B,MAAM,OAAO,GAAG,IAAA,uBAAa,EAAC,MAAM,CAAC;SAClC,WAAW,CAAC,IAAA,QAAC,EAAC,2BAA2B,CAAC,CAAC,CAAC;IAE/C,OAAO;SACJ,UAAU,CAAC,IAAA,uBAAa,EAAC,IAAI,CAAC;SAC9B,KAAK,CAAC,MAAM,CAAC;SACb,WAAW,CAAC,IAAA,QAAC,EAAC,8BAA8B,CAAC,CAAC;SAC9C,MAAM,CAAC,GAAG,EAAE;QACX,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,sBAAS,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,wBAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACzD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,eAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBAC3C,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAA,aAAK,EAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,eAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO;SACJ,UAAU,CAAC,IAAA,uBAAa,EAAC,KAAK,CAAC;SAC/B,WAAW,CAAC,IAAA,QAAC,EAAC,+BAA+B,CAAC,CAAC;SAC/C,QAAQ,CAAC,QAAQ,EAAE,IAAA,QAAC,EAAC,mBAAmB,CAAC,CAAC;SAC1C,MAAM,CAAC,CAAC,OAAe,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,sBAAS,CAAC,IAAI,EAAE,CAAC;YAChC,wBAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;YACnD,eAAM,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,eAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import { RunestoneEnv } from '../utils/env-loader';
+export interface SetupOptions {
+    envPath?: string;
+    project?: string;
+}
+declare function enableBackHotkey(prompt: unknown, canBack: boolean): void;
+export declare const setupPromptTestHooks: {
+    enableBackHotkey: typeof enableBackHotkey;
+    STEP_BACK: symbol;
+};
+export declare function runSetup(options?: SetupOptions): Promise<RunestoneEnv>;
+export declare function createSetupCommand(): Command;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAAyB,YAAY,EAAa,MAAM,qBAAqB,CAAC;AAYrF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8GD,iBAAS,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAmBjE;AAED,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAiVF,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoShF;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAY5C"}