@reumbra/forge 0.1.0

package/README.md

@@ -0,0 +1,165 @@
+# Forge DevKit CLI
+
+**Package:** `@reumbra/forge`
+**Role:** CLI tool for installing and managing Forge plugins for Claude Code
+
+## Ecosystem
+
+Forge DevKit is a commercial product by [Reumbra](https://reumbra.dev) — AI-powered project scaffolding tools for Claude Code.
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                     Forge DevKit Ecosystem                       │
+├──────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  forge-devkit-cli (this repo)        PUBLIC                      │
+│  └─ npm @reumbra/forge                                           │
+│  └─ Commands: activate, install, update, list, status, doctor    │
+│  └─ User-facing tool, distributed via npm                        │
+│                                                                  │
+│  forge-devkit-api                    PRIVATE                     │
+│  └─ License validation, plugin delivery, webhooks                │
+│  └─ Node.js (Fastify) + PostgreSQL (Supabase) + AWS S3          │
+│                                                                  │
+│  forge-devkit-landing                PUBLIC                      │
+│  └─ reumbra.dev/forge — website, pricing, docs                   │
+│  └─ Astro + Tailwind, hosted on Cloudflare Pages                 │
+│                                                                  │
+│  forge-devkit-plugins                PRIVATE (currently public)   │
+│  └─ Plugin source code, tests, design docs                       │
+│  └─ Currently: github.com/maselious/ai-marketplace               │
+│                                                                  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+## Architecture
+
+```
+┌──────────────┐       ┌─────────────────┐
+│  forge CLI   │──────▶│  Forge API      │
+│  (this repo) │       │  (devkit-api)   │
+│              │       │                 │
+│  activate    │       │  /auth/activate │
+│  install     │       │  /plugins/list  │
+│  update      │       │  /plugins/down  │
+│  list        │       │  /license/check │
+└──────────────┘       └────────┬────────┘
+                                │
+                       ┌────────┴─────────┐
+                       │  Plugin Storage   │
+                       │  (AWS S3)        │
+                       └───────────────────┘
+```
+
+## Commands
+
+```
+forge activate <license-key>     # Bind license to machine
+forge deactivate                 # Unbind (for machine transfer)
+forge install <plugin> [version] # Download and install plugin
+forge update [plugin]            # Update all or specific plugin
+forge list                       # Show installed + available
+forge status                     # License: expiry, binding, limits
+forge doctor                     # Diagnostics: Claude Code found? Plugins intact?
+```
+
+## Config Storage
+
+```json
+// ~/.forge/config.json
+{
+  "license_key": "FRG-XXXX-XXXX-XXXX",
+  "machine_id": "a1b2c3...",
+  "api_url": "https://api.reumbra.com/velvet",
+  "installed_plugins": {
+    "forge-core": { "version": "1.5.0", "installed_at": "2026-02-19T..." },
+    "forge-product": { "version": "0.4.0", "installed_at": "2026-02-19T..." }
+  }
+}
+```
+
+## Install Flow
+
+```
+$ forge install core
+
+1. Read config.json -> license_key, machine_id
+2. POST /plugins/download {license_key, machine_id, plugin: "forge-core", version: "latest"}
+3. API validates license, expiry, machine_id, plugin access
+4. Returns signed download URL (R2 presigned, 5 min TTL)
+5. CLI downloads .zip via signed URL
+6. Unpacks to ~/.forge/cache/forge-core@1.5.0/
+7. Links into Claude Code plugin directory
+8. Updates config.json -> installed_plugins
+9. "forge-core@1.5.0 installed. Run /forge:setup in your project"
+```
+
+## Machine ID & Limits
+
+License bound to N devices (default: 3). Machine ID = SHA256 hash of hostname + OS + username.
+
+```
+Activate flow:
+  CLI: POST /auth/activate {license_key, machine_id}
+  API: validate key -> check slots (3 max) -> register machine_id -> 200 OK
+       or 403 "All device slots used. Run forge deactivate on another machine"
+```
+
+## Offline Behavior
+
+- Already installed plugins: work forever (just .md files on disk)
+- Install/update: requires API connection
+- After license expiry: installed versions continue working, updates blocked
+
+## Tech Stack
+
+- **Runtime:** Node.js >=20
+- **Package:** `@reumbra/forge` (public, scoped npm)
+- **Dependencies:** Commander.js (routing), @clack/prompts (interactive UI)
+- **Build:** TypeScript (strict), Biome (lint + format)
+- **Tests:** Vitest (112 tests, 17 suites)
+
+## Installation
+
+```bash
+npm install -g @reumbra/forge
+```
+
+Or run without installing:
+
+```bash
+npx @reumbra/forge doctor
+```
+
+## Development
+
+```bash
+pnpm install          # Install dev dependencies
+pnpm dev -- doctor    # Run any command in dev mode (via tsx)
+pnpm build            # Compile TypeScript → dist/
+pnpm check            # Lint + format (Biome)
+pnpm test             # Run tests
+```
+
+### Project Structure
+
+```
+src/
+├── cli.ts                  # Entry point, arg parser, command dispatch
+├── types.ts                # Shared types (config, API responses)
+├── commands/
+│   ├── activate.ts         # forge activate <key>
+│   ├── deactivate.ts       # forge deactivate
+│   ├── install.ts          # forge install <plugin> [version]
+│   ├── update.ts           # forge update [plugin]
+│   ├── list.ts             # forge list
+│   ├── status.ts           # forge status
+│   └── doctor.ts           # forge doctor (local only)
+└── lib/
+    ├── api.ts              # HTTP client (fetch), ApiError
+    ├── config.ts           # ~/.forge/config.json management
+    ├── logger.ts           # CLI output (colors, tables, icons)
+    ├── machine-id.ts       # SHA256-based device fingerprint
+    ├── paths.ts            # ~/.forge/ path constants
+    └── zip.ts              # ZIP extraction (Node.js built-ins)
+```

package/bin/forge.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli.js";

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function createProgram(): Command;

package/dist/cli.js

@@ -0,0 +1,225 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as p from "@clack/prompts";
+import { Command } from "commander";
+import { activate } from "./commands/activate.js";
+import { showConfig } from "./commands/config.js";
+import { dashboard } from "./commands/dashboard.js";
+import { deactivate } from "./commands/deactivate.js";
+import { doctor } from "./commands/doctor.js";
+import { install } from "./commands/install.js";
+import { list } from "./commands/list.js";
+import { status } from "./commands/status.js";
+import { uninstall } from "./commands/uninstall.js";
+import { update } from "./commands/update.js";
+import { loadConfig } from "./lib/config.js";
+import { log } from "./lib/logger.js";
+import { bold, dim, reset } from "./lib/styles.js";
+import { banner } from "./lib/ui.js";
+function getVersion() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+    return pkg.version;
+}
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("forge")
+        .version(`forge v${getVersion()}`, "-v, --version")
+        .addHelpText("before", `\n${banner()}\n`)
+        .addHelpText("after", `\n${bold}Examples:${reset}\n  ${dim}$${reset} forge activate FRG-XXXX-XXXX-XXXX\n  ${dim}$${reset} forge install core\n  ${dim}$${reset} forge install forge-product@1.2.0\n  ${dim}$${reset} forge list\n`)
+        .usage("[command] [options]")
+        .showHelpAfterError('Run "forge --help" for available commands.');
+    // Catch-all: no command → interactive dashboard (TTY) or help (non-TTY), unknown → error
+    program.argument("[command]").action(async (cmd) => {
+        if (!cmd) {
+            if (process.stdin.isTTY) {
+                await dashboard();
+            }
+            else {
+                program.help();
+            }
+        }
+        else {
+            log.error(`Unknown command: ${cmd}`);
+            log.info('Run "forge --help" for available commands.');
+            process.exit(1);
+        }
+    });
+    program
+        .command("activate")
+        .description("Bind license to this machine")
+        .argument("[license-key]", "Forge license key (FRG-XXXX-XXXX-XXXX)")
+        .action(async (key) => {
+        if (!key) {
+            if (!process.stdin.isTTY) {
+                log.error("Usage: forge activate <license-key>");
+                process.exit(1);
+            }
+            const input = await p.text({
+                message: "Enter your license key:",
+                placeholder: "FRG-XXXX-XXXX-XXXX",
+                validate: (v) => {
+                    if (!v || !/^FRG-[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}$/.test(v)) {
+                        return "Invalid format. Expected: FRG-XXXX-XXXX-XXXX";
+                    }
+                },
+            });
+            if (p.isCancel(input)) {
+                p.cancel("Activation cancelled.");
+                process.exit(0);
+            }
+            key = input;
+        }
+        await activate(key);
+    });
+    program
+        .command("deactivate")
+        .description("Unbind this machine (free a slot)")
+        .action(async () => {
+        if (process.stdin.isTTY) {
+            const confirmed = await p.confirm({
+                message: "Deactivate this machine? This will free up a machine slot.",
+            });
+            if (p.isCancel(confirmed) || !confirmed) {
+                p.cancel("Deactivation cancelled.");
+                return;
+            }
+        }
+        await deactivate();
+    });
+    program
+        .command("install")
+        .description("Download and install a plugin")
+        .argument("[plugin]", "Plugin name (e.g. core, forge-product@1.2.0)")
+        .argument("[version]", "Specific version")
+        .action(async (plugin, version) => {
+        if (!plugin) {
+            if (!process.stdin.isTTY) {
+                log.error("Usage: forge install <plugin> [version]");
+                process.exit(1);
+            }
+            const input = await p.text({
+                message: "Plugin name to install:",
+                placeholder: "e.g. core, forge-product@1.2.0",
+                validate: (v) => {
+                    if (!v?.trim())
+                        return "Plugin name is required";
+                },
+            });
+            if (p.isCancel(input)) {
+                p.cancel("Installation cancelled.");
+                process.exit(0);
+            }
+            plugin = input.trim();
+        }
+        if (plugin.includes("@")) {
+            const [name, ver] = plugin.split("@");
+            await install(name, ver);
+        }
+        else {
+            await install(plugin, version);
+        }
+    });
+    program
+        .command("uninstall")
+        .alias("remove")
+        .description("Remove an installed plugin")
+        .argument("[plugin]", "Plugin name to remove")
+        .action(async (plugin) => {
+        if (!plugin) {
+            if (!process.stdin.isTTY) {
+                log.error("Usage: forge uninstall <plugin>");
+                process.exit(1);
+            }
+            const config = loadConfig();
+            const installed = Object.keys(config.installed_plugins);
+            if (installed.length === 0) {
+                log.warn("No plugins installed.");
+                process.exit(0);
+            }
+            const selected = await p.select({
+                message: "Select plugin to uninstall:",
+                options: installed.map((name) => ({
+                    value: name,
+                    label: name,
+                    hint: `v${config.installed_plugins[name].version}`,
+                })),
+            });
+            if (p.isCancel(selected)) {
+                p.cancel("Uninstall cancelled.");
+                process.exit(0);
+            }
+            plugin = selected;
+        }
+        if (process.stdin.isTTY) {
+            const confirmed = await p.confirm({
+                message: `Uninstall ${bold}${plugin}${reset}?`,
+            });
+            if (p.isCancel(confirmed) || !confirmed) {
+                p.cancel("Uninstall cancelled.");
+                return;
+            }
+        }
+        uninstall(plugin);
+    });
+    program
+        .command("update")
+        .description("Update all or specific plugin")
+        .argument("[plugin]", "Plugin to update (omit for all)")
+        .action(async (plugin) => {
+        await update(plugin);
+    });
+    program
+        .command("list")
+        .alias("ls")
+        .description("Show available plugins")
+        .action(async () => {
+        await list();
+    });
+    program
+        .command("status")
+        .description("License info: plan, expiry, devices")
+        .action(async () => {
+        await status();
+    });
+    program
+        .command("config")
+        .description("Show current configuration")
+        .action(() => {
+        showConfig();
+    });
+    program
+        .command("doctor")
+        .description("Run diagnostics")
+        .action(async () => {
+        const result = await doctor();
+        if (result.issues > 0)
+            process.exit(1);
+    });
+    return program;
+}
+async function main() {
+    const program = createProgram();
+    try {
+        await program.parseAsync();
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            if (err.message.includes("fetch failed") || err.message.includes("ECONNREFUSED")) {
+                log.error("Could not connect to Forge API.");
+                log.info("Check your internet connection or try again later.");
+            }
+            else {
+                log.error(err.message);
+            }
+        }
+        else {
+            log.error("An unexpected error occurred.");
+        }
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,SAAS,UAAU;IACjB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,OAAO,CAAC,UAAU,UAAU,EAAE,EAAE,EAAE,eAAe,CAAC;SAClD,WAAW,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,IAAI,CAAC;SACxC,WAAW,CACV,OAAO,EACP,KAAK,IAAI,YAAY,KAAK,OAAO,GAAG,IAAI,KAAK,yCAAyC,GAAG,IAAI,KAAK,0BAA0B,GAAG,IAAI,KAAK,yCAAyC,GAAG,IAAI,KAAK,eAAe,CAC7M;SACA,KAAK,CAAC,qBAAqB,CAAC;SAC5B,kBAAkB,CAAC,4CAA4C,CAAC,CAAC;IAEpE,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAY,EAAE,EAAE;QAC1D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,SAAS,EAAE,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,QAAQ,CAAC,eAAe,EAAE,wCAAwC,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,GAAY,EAAE,EAAE;QAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACzB,OAAO,EAAE,yBAAyB;gBAClC,WAAW,EAAE,oBAAoB;gBACjC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;oBACd,IAAI,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/D,OAAO,8CAA8C,CAAC;oBACxD,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,GAAG,GAAG,KAAK,CAAC;QACd,CAAC;QACD,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;gBAChC,OAAO,EAAE,4DAA4D;aACtE,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxC,CAAC,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;QACH,CAAC;QACD,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,QAAQ,CAAC,UAAU,EAAE,8CAA8C,CAAC;SACpE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACzB,OAAO,EAAE,yBAAyB;gBAClC,WAAW,EAAE,gCAAgC;gBAC7C,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;oBACd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;wBAAE,OAAO,yBAAyB,CAAC;gBACnD,CAAC;aACF,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,CAAC,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,KAAK,CAAC,QAAQ,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,EAAE;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAExD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;gBAC9B,OAAO,EAAE,6BAA6B;gBACtC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAChC,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE;iBACnD,CAAC,CAAC;aACJ,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,GAAG,QAAQ,CAAC;QACpB,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;gBAChC,OAAO,EAAE,aAAa,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG;aAC/C,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxC,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;QACH,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,QAAQ,CAAC,UAAU,EAAE,iCAAiC,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,EAAE;QAChC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,KAAK,CAAC,IAAI,CAAC;SACX,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,GAAG,EAAE;QACX,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAC7C,GAAG,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/commands/activate.d.ts

@@ -0,0 +1 @@
+export declare function activate(licenseKey: string): Promise<void>;

package/dist/commands/activate.js

@@ -0,0 +1,55 @@
+import { ApiError, apiRequest } from "../lib/api.js";
+import { loadConfig, saveConfig } from "../lib/config.js";
+import { log } from "../lib/logger.js";
+import { bold, dim, green, reset } from "../lib/styles.js";
+import { box, createSpinner, statusBadge } from "../lib/ui.js";
+export async function activate(licenseKey) {
+    if (!/^FRG-[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}$/.test(licenseKey)) {
+        log.error("Invalid license key format. Expected: FRG-XXXX-XXXX-XXXX");
+        process.exit(1);
+    }
+    const config = loadConfig();
+    config.license_key = licenseKey;
+    const spinner = createSpinner("Activating license...");
+    try {
+        const result = await apiRequest(config, {
+            method: "POST",
+            path: "/auth/activate",
+            body: {
+                license_key: licenseKey,
+                machine_id: config.machine_id,
+            },
+        });
+        saveConfig(config);
+        const expires = new Date(result.license.expires_at);
+        spinner.stop(`${green}✓${reset} License activated!`);
+        console.log(box([
+            `${bold}Plan:${reset}     ${result.license.plan}`,
+            `${bold}Expires:${reset}  ${expires.toLocaleDateString()}`,
+            `${bold}Machines:${reset} ${result.license.machines_used}/${result.license.max_machines}`,
+            `${bold}Status:${reset}   ${statusBadge("active")}`,
+        ], { title: "License", borderColor: dim }));
+        log.info(`${dim}Run \`forge install <plugin>\` to get started.${reset}`);
+    }
+    catch (err) {
+        spinner.stop();
+        if (err instanceof ApiError) {
+            if (err.code === "MACHINE_LIMIT") {
+                log.error("All device slots are used.");
+                log.info("Run `forge deactivate` on another machine first.");
+            }
+            else if (err.code === "INVALID_LICENSE") {
+                log.error("Invalid license key. Double-check your key and try again.");
+            }
+            else if (err.code === "LICENSE_EXPIRED") {
+                log.error("This license has expired. Renew at https://reumbra.dev/forge");
+            }
+            else {
+                log.error(err.message);
+            }
+            process.exit(1);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=activate.js.map

package/dist/commands/activate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.js","sourceRoot":"","sources":["../../src/commands/activate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC;IAEhC,MAAM,OAAO,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAmB,MAAM,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE;gBACJ,WAAW,EAAE,UAAU;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;SACF,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,KAAK,qBAAqB,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CACT,GAAG,CACD;YACE,GAAG,IAAI,QAAQ,KAAK,QAAQ,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;YACjD,GAAG,IAAI,WAAW,KAAK,KAAK,OAAO,CAAC,kBAAkB,EAAE,EAAE;YAC1D,GAAG,IAAI,YAAY,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE;YACzF,GAAG,IAAI,UAAU,KAAK,MAAM,WAAW,CAAC,QAAQ,CAAC,EAAE;SACpD,EACD,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,CACvC,CACF,CAAC;QAEF,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,iDAAiD,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjC,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBACxC,GAAG,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC1C,GAAG,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACzE,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC1C,GAAG,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1 @@
+export declare function showConfig(): void;

package/dist/commands/config.js

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import { loadConfig } from "../lib/config.js";
+import { log } from "../lib/logger.js";
+import { CONFIG_PATH } from "../lib/paths.js";
+import { bold, dim, reset } from "../lib/styles.js";
+import { box, table } from "../lib/ui.js";
+export function showConfig() {
+    if (!existsSync(CONFIG_PATH)) {
+        log.warn("No config file found. Run `forge activate <key>` to create one.");
+        return;
+    }
+    const config = loadConfig();
+    const maskedKey = config.license_key
+        ? `${config.license_key.slice(0, 8)}..${config.license_key.slice(-4)}`
+        : "(not set)";
+    console.log(box([
+        `${bold}License:${reset}    ${maskedKey}`,
+        `${bold}Machine ID:${reset} ${config.machine_id}`,
+        `${bold}API URL:${reset}    ${config.api_url}`,
+        `${bold}Config:${reset}     ${dim}${CONFIG_PATH}${reset}`,
+    ], { title: "Forge Config", borderColor: dim }));
+    const plugins = Object.entries(config.installed_plugins);
+    if (plugins.length > 0) {
+        const rows = plugins.map(([name, info]) => [
+            name,
+            `v${info.version}`,
+            dim + new Date(info.installed_at).toLocaleDateString() + reset,
+        ]);
+        console.log(table(rows, { header: ["Plugin", "Version", "Installed"] }));
+    }
+    else {
+        log.info("No plugins installed.");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW;QAClC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QACtE,CAAC,CAAC,WAAW,CAAC;IAEhB,OAAO,CAAC,GAAG,CACT,GAAG,CACD;QACE,GAAG,IAAI,WAAW,KAAK,OAAO,SAAS,EAAE;QACzC,GAAG,IAAI,cAAc,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE;QACjD,GAAG,IAAI,WAAW,KAAK,OAAO,MAAM,CAAC,OAAO,EAAE;QAC9C,GAAG,IAAI,UAAU,KAAK,QAAQ,GAAG,GAAG,WAAW,GAAG,KAAK,EAAE;KAC1D,EACD,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,EAAE,CAC5C,CACF,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI;YACJ,IAAI,IAAI,CAAC,OAAO,EAAE;YAClB,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,kBAAkB,EAAE,GAAG,KAAK;SAC/D,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1 @@
+export declare function dashboard(): Promise<void>;