krexel 0.1.0

package/dist/output.js

@@ -0,0 +1,90 @@
+/**
+ * output.ts — terminal formatting primitives for the Krexel CLI.
+ *
+ * All user-facing output goes through these helpers so we get one consistent
+ * visual language and so `--json` can swap text for a JSON envelope without
+ * touching every subcommand.
+ *
+ * Conventions:
+ *   - success / warn / error are bold + colored
+ *   - dim is for side-notes and context
+ *   - Spinner factory returns a spinner only when the user is expected to
+ *     wait > 500ms; short ops just print and move on.
+ */
+import chalk from "chalk";
+import ora from "ora";
+const isTty = Boolean(process.stdout.isTTY);
+/** Strip ANSI when output is being piped (so logs stay readable). */
+const useColor = isTty && !process.env.NO_COLOR;
+/** Boolean --json: every subcommand respects this for machine-readable output. */
+let jsonMode = false;
+export function setJsonMode(on) {
+    jsonMode = on;
+}
+export function isJsonMode() {
+    return jsonMode;
+}
+/** Print success line. */
+export function success(msg) {
+    // eslint-disable-next-line no-console
+    console.log(useColor ? chalk.bold.green("✓ ") + msg : `✓ ${msg}`);
+}
+/** Print warning line. */
+export function warn(msg) {
+    // eslint-disable-next-line no-console
+    console.log(useColor ? chalk.bold.yellow("! ") + msg : `! ${msg}`);
+}
+/** Print dim/secondary line. */
+export function dim(msg) {
+    // eslint-disable-next-line no-console
+    console.log(useColor ? chalk.dim(msg) : msg);
+}
+/** Print error line on stderr — exits process with code 1. */
+export function error(msg) {
+    // eslint-disable-next-line no-console
+    console.error("Error:", useColor ? chalk.bold.red(msg) : msg);
+    process.exit(1);
+}
+/** Print error without exiting — useful when caller wants to recover. */
+export function printError(msg) {
+    // eslint-disable-next-line no-console
+    console.error("Error:", useColor ? chalk.bold.red(msg) : msg);
+}
+/** Bordered key/value line for account status / deploy summary. */
+export function kv(key, value) {
+    // eslint-disable-next-line no-console
+    console.log(`${useColor ? chalk.dim(key.padEnd(16)) : key.padEnd(16)} ${value ?? ""}`);
+}
+/**
+ * Run an async operation with a spinner iff the operation is expected to take
+ * more than ~500ms. We can't actually measure before we start, so we always
+ * show the spinner when called — subcommands decide whether to bother.
+ *
+ * If --json is set, the spinner is skipped (noise breaks jq pipelines).
+ */
+export async function withSpinner(text, fn, opts = {}) {
+    if (!opts.enabled || jsonMode || !isTty) {
+        return fn();
+    }
+    const spinner = ora({ text, color: "blue" }).start();
+    try {
+        const result = await fn();
+        spinner.succeed();
+        return result;
+    }
+    catch (err) {
+        spinner.fail();
+        throw err;
+    }
+}
+/**
+ * Monospace block if the terminal reports it can render Unicode + color.
+ * Falls back to plain text on dumb pipes (so logs still grep cleanly).
+ */
+export function monospace(block) {
+    const out = useColor ? chalk.cyan(block) : block;
+    // eslint-disable-next-line no-console
+    console.log(out);
+}
+export { chalk };
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,69 @@
+/**
+ * paths.ts — resolve on-disk locations for every AI-client config file
+ * Krexel knows how to patch, plus the user's shell rc file for the master
+ * key. Centralised here so `init.ts`, `paths.ts` consumers, and tests all
+ * agree on one source of truth.
+ *
+ * Override hooks:
+ *   - KREXEL_HOME overrides $HOME for the entire init flow. This is how the
+ *     smoke test runs init in a temp dir without touching real configs.
+ *   - KREXEL_PLATFORM overrides `process.platform` ("darwin" | "linux" |
+ *     "win32") — useful for CI matrices and tests.
+ *
+ * Every function is pure (no fs calls) so it's trivially unit-testable.
+ */
+export type Platform = "darwin" | "linux" | "win32";
+/**
+ * The set of AI clients Krexel can configure. Order matters — `init.ts`
+ * walks them in declaration order so the user sees a predictable checklist.
+ */
+export type ClientId = "claude-code" | "cursor" | "claude-desktop" | "continue" | "codex";
+export interface ClientSpec {
+    readonly id: ClientId;
+    /** Human label printed in the success checklist. */
+    readonly label: string;
+    /** Where the user's config lives on this platform (null = unsupported). */
+    readonly configPath: string | null;
+    /** `true` when the file exists on disk right now. Set by `resolveAll()`. */
+    readonly present?: boolean;
+}
+/** Resolve the "effective" home/platform — honours overrides for tests. */
+export declare function effectiveHome(): string;
+export declare function effectivePlatform(): Platform;
+/**
+ * Claude Code stores its MCP server registry in `~/.claude.json` (note: NOT
+ * the same as Claude Desktop, which lives under `Application Support`).
+ */
+export declare function claudeCodePath(home?: string): string;
+export declare function cursorPath(home?: string): string;
+/**
+ * Claude Desktop config path varies by OS:
+ *   - macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   - Windows: %APPDATA%/Claude/claude_desktop_config.json
+ *   - Linux:   ~/.config/Claude/claude_desktop_config.json
+ */
+export declare function claudeDesktopPath(platform?: Platform, home?: string): string;
+export declare function continuePath(home?: string): string;
+/**
+ * Codex (OpenAI's CLI) stores config as TOML at `~/.codex/config.toml`.
+ * No platform variation.
+ */
+export declare function codexPath(home?: string): string;
+/**
+ * Return the path to the user's shell rc file where we'll persist
+ * `KREXEL_MASTER_KEY`. Order:
+ *   1. $ZDOTDIR/.zshrc     (when on zsh with a custom ZDOTDIR)
+ *   2. ~/.zshrc            (mac default)
+ *   3. ~/.bashrc           (linux default — only consulted if it exists)
+ *
+ * The function returns the FIRST file we'd *prefer* to write. Callers
+ * separately consult `~/.bashrc` for cross-compatibility (see init.ts).
+ */
+export declare function detectShellRc(platform?: Platform, home?: string, opts?: {
+    bashrcExists?: boolean;
+}): string;
+/**
+ * Resolve the full set of clients we'd attempt to patch on this platform.
+ * `present` is filled in by the caller (init.ts) after an fs.existsSync.
+ */
+export declare function resolveAll(platform?: Platform): ClientSpec[];

package/dist/paths.js

@@ -0,0 +1,115 @@
+/**
+ * paths.ts — resolve on-disk locations for every AI-client config file
+ * Krexel knows how to patch, plus the user's shell rc file for the master
+ * key. Centralised here so `init.ts`, `paths.ts` consumers, and tests all
+ * agree on one source of truth.
+ *
+ * Override hooks:
+ *   - KREXEL_HOME overrides $HOME for the entire init flow. This is how the
+ *     smoke test runs init in a temp dir without touching real configs.
+ *   - KREXEL_PLATFORM overrides `process.platform` ("darwin" | "linux" |
+ *     "win32") — useful for CI matrices and tests.
+ *
+ * Every function is pure (no fs calls) so it's trivially unit-testable.
+ */
+import * as os from "node:os";
+import * as path from "node:path";
+/** Resolve the "effective" home/platform — honours overrides for tests. */
+export function effectiveHome() {
+    return process.env.KREXEL_HOME ?? os.homedir();
+}
+export function effectivePlatform() {
+    const raw = process.env.KREXEL_PLATFORM ?? process.platform;
+    if (raw === "darwin" || raw === "linux" || raw === "win32")
+        return raw;
+    // Be loud on a truly unknown platform — caller almost certainly has a bug.
+    throw new Error(`Unsupported platform: ${String(raw)}`);
+}
+/**
+ * Claude Code stores its MCP server registry in `~/.claude.json` (note: NOT
+ * the same as Claude Desktop, which lives under `Application Support`).
+ */
+export function claudeCodePath(home = effectiveHome()) {
+    return path.join(home, ".claude.json");
+}
+export function cursorPath(home = effectiveHome()) {
+    return path.join(home, ".cursor", "mcp.json");
+}
+/**
+ * Claude Desktop config path varies by OS:
+ *   - macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   - Windows: %APPDATA%/Claude/claude_desktop_config.json
+ *   - Linux:   ~/.config/Claude/claude_desktop_config.json
+ */
+export function claudeDesktopPath(platform = effectivePlatform(), home = effectiveHome()) {
+    switch (platform) {
+        case "darwin":
+            return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+        case "win32":
+            // On Windows we honour APPDATA first; fall back to the home dir.
+            const appData = process.env.APPDATA ?? home;
+            return path.join(appData, "Claude", "claude_desktop_config.json");
+        case "linux":
+            // XDG_CONFIG_HOME respected; defaults to ~/.config
+            const xdg = process.env.XDG_CONFIG_HOME ?? path.join(home, ".config");
+            return path.join(xdg, "Claude", "claude_desktop_config.json");
+    }
+}
+export function continuePath(home = effectiveHome()) {
+    return path.join(home, ".continue", "config.json");
+}
+/**
+ * Codex (OpenAI's CLI) stores config as TOML at `~/.codex/config.toml`.
+ * No platform variation.
+ */
+export function codexPath(home = effectiveHome()) {
+    return path.join(home, ".codex", "config.toml");
+}
+/**
+ * Return the path to the user's shell rc file where we'll persist
+ * `KREXEL_MASTER_KEY`. Order:
+ *   1. $ZDOTDIR/.zshrc     (when on zsh with a custom ZDOTDIR)
+ *   2. ~/.zshrc            (mac default)
+ *   3. ~/.bashrc           (linux default — only consulted if it exists)
+ *
+ * The function returns the FIRST file we'd *prefer* to write. Callers
+ * separately consult `~/.bashrc` for cross-compatibility (see init.ts).
+ */
+export function detectShellRc(platform = effectivePlatform(), home = effectiveHome(), opts = {}) {
+    // Allow tests to inject whether ~/.bashrc exists; otherwise guess.
+    const bashrcExists = opts.bashrcExists ?? platform === "linux";
+    // zsh first — it's mac default and increasingly the linux default too.
+    const zdotdir = process.env.ZDOTDIR;
+    if (zdotdir) {
+        return path.join(zdotdir, ".zshrc");
+    }
+    const zshrc = path.join(home, ".zshrc");
+    // On mac we always write to zshrc; on linux we fall back to bashrc if
+    // the user doesn't have one. The caller merges both writes anyway.
+    if (platform === "darwin")
+        return zshrc;
+    if (platform === "linux")
+        return bashrcExists ? path.join(home, ".bashrc") : zshrc;
+    // win32 — Git Bash users may have one; default to zshrc anyway and let
+    // init.ts skip if neither exists.
+    return zshrc;
+}
+/**
+ * Resolve the full set of clients we'd attempt to patch on this platform.
+ * `present` is filled in by the caller (init.ts) after an fs.existsSync.
+ */
+export function resolveAll(platform = effectivePlatform()) {
+    const home = effectiveHome();
+    return [
+        { id: "claude-code", label: "Claude Code", configPath: claudeCodePath(home) },
+        { id: "cursor", label: "Cursor", configPath: cursorPath(home) },
+        {
+            id: "claude-desktop",
+            label: platform === "darwin" ? "Claude Desktop (mac)" : `Claude Desktop (${platform})`,
+            configPath: claudeDesktopPath(platform, home),
+        },
+        { id: "continue", label: "Continue", configPath: continuePath(home) },
+        { id: "codex", label: "Codex", configPath: codexPath(home) },
+    ];
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/rollback.d.ts

@@ -0,0 +1,10 @@
+/**
+ * rollback.ts — `krexel rollback <domain> <deploy_id>`
+ *
+ * The MCP server currently records intent (sets last_good[domain]); Phase 2
+ * will actually repoint the alias. We surface whatever the MCP server tells us.
+ */
+export declare function runRollback(opts: {
+    domain: string;
+    deployId: string;
+}): Promise<void>;

package/dist/rollback.js

@@ -0,0 +1,34 @@
+/**
+ * rollback.ts — `krexel rollback <domain> <deploy_id>`
+ *
+ * The MCP server currently records intent (sets last_good[domain]); Phase 2
+ * will actually repoint the alias. We surface whatever the MCP server tells us.
+ */
+import { withSpinner, success, dim, error, isJsonMode } from "./output.js";
+import { getClient } from "./mcp-client.js";
+export async function runRollback(opts) {
+    const domain = opts.domain.trim();
+    const deployId = opts.deployId.trim();
+    if (!domain)
+        error("domain is required (e.g. `krexel rollback mysite.com dep_abc123_xyz`).");
+    if (!deployId)
+        error("deploy_id is required (e.g. `krexel rollback mysite.com dep_abc123_xyz`).");
+    if (!deployId.startsWith("dep_")) {
+        error(`Invalid deploy_id format — must start with "dep_". Got: ${deployId}`);
+    }
+    const client = getClient();
+    const result = await withSpinner(`Rolling back ${domain} to ${deployId}…`, () => client.callTool("rollback", { domain, to: deployId }), { enabled: true });
+    if (!result.ok) {
+        error(`Rollback reported failure for ${deployId} on ${domain}. ` +
+            `Run \`krexel logs ${deployId}\` to investigate.`);
+    }
+    if (isJsonMode()) {
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    success(`Rolled back ${domain} to ${deployId}`);
+    if (result.note)
+        dim(result.note);
+}
+//# sourceMappingURL=rollback.js.map

package/dist/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../src/rollback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAGjC;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC7F,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAClG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,2DAA2D,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,gBAAgB,MAAM,OAAO,QAAQ,GAAG,EACxC,GAAG,EAAE,CACH,MAAM,CAAC,QAAQ,CAKZ,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAC1C,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,CACH,iCAAiC,QAAQ,OAAO,MAAM,IAAI;YACxD,qBAAqB,QAAQ,oBAAoB,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,eAAe,MAAM,OAAO,QAAQ,EAAE,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI;QAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/ship.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ship.ts — `krexel ship <folder> <domain> [--framework=auto|nextjs|astro|vite|static]`
+ *
+ * We pre-validate `folder` exists locally before asking the MCP server, so we
+ * give an immediate, actionable error instead of waiting for a slow upload.
+ * Everything else (zipping, manifest, orchestrator POST) is the MCP server's
+ * job — see mcp-server/src/ship.ts.
+ */
+export declare function runShip(opts: {
+    folder: string;
+    domain: string;
+    framework?: string;
+}): Promise<void>;

package/dist/ship.js

@@ -0,0 +1,49 @@
+/**
+ * ship.ts — `krexel ship <folder> <domain> [--framework=auto|nextjs|astro|vite|static]`
+ *
+ * We pre-validate `folder` exists locally before asking the MCP server, so we
+ * give an immediate, actionable error instead of waiting for a slow upload.
+ * Everything else (zipping, manifest, orchestrator POST) is the MCP server's
+ * job — see mcp-server/src/ship.ts.
+ */
+import { existsSync, statSync } from "node:fs";
+import * as path from "node:path";
+import { error, success, dim, withSpinner, isJsonMode } from "./output.js";
+import { getClient } from "./mcp-client.js";
+const FRAMEWORKS = ["auto", "nextjs", "astro", "vite", "static"];
+export async function runShip(opts) {
+    const folder = path.resolve(opts.folder);
+    if (!existsSync(folder)) {
+        error(`Folder does not exist: ${folder}`);
+    }
+    const stat = statSync(folder);
+    if (!stat.isDirectory()) {
+        error(`Path is not a directory: ${folder}`);
+    }
+    const framework = (opts.framework ?? "auto");
+    if (!FRAMEWORKS.includes(framework)) {
+        error(`Invalid --framework "${opts.framework}". Expected one of: ${FRAMEWORKS.join(", ")}`);
+    }
+    const domain = opts.domain.trim();
+    if (!domain) {
+        error("Domain is required (e.g. `krexel ship ./dist mysite.com`).");
+    }
+    if (!isJsonMode()) {
+        dim(`Folder: ${folder}`);
+        dim(`Domain: ${domain}`);
+        dim(`Framework: ${framework}`);
+    }
+    const client = getClient();
+    const result = await withSpinner(`Shipping ${domain}…`, () => client.callTool("ship_site", { folder, domain, framework }), { enabled: true });
+    if (!result.api_ok) {
+        // MCP server is explicit that failed orchestrator POSTs are reported here
+        // rather than swallowed — we surface that to the user.
+        error(`Ship reported an orchestrator error: ${result.api_error ?? "(unknown)"}. ` +
+            `Check \`krexel logs ${result.deploy_id}\` and \`krexel whoami\` for details.`);
+    }
+    success(`Shipped ${domain}`);
+    dim(`Deploy ID:  ${result.deploy_id}`);
+    if (result.preview_url)
+        dim(`Preview URL: ${result.preview_url}`);
+}
+//# sourceMappingURL=ship.js.map

package/dist/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../src/ship.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAG1E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAI7B;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,SAAS,GAAe,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAe,CAAC;IACvE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,KAAK,CACH,wBAAwB,IAAI,CAAC,SAAS,uBAAuB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,YAAY,MAAM,GAAG,EACrB,GAAG,EAAE,CACH,MAAM,CAAC,QAAQ,CAMZ,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAChD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,0EAA0E;QAC1E,uDAAuD;QACvD,KAAK,CACH,wCAAwC,MAAM,CAAC,SAAS,IAAI,WAAW,IAAI;YACzE,uBAAuB,MAAM,CAAC,SAAS,uCAAuC,CACjF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IAC7B,GAAG,CAAC,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,WAAW;QAAE,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/whoami.d.ts

@@ -0,0 +1,7 @@
+/**
+ * whoami.ts — `krexel whoami`
+ *
+ * Pretty-prints the orchestrator-agnostic account status that the MCP
+ * server's `get_status` tool returns from $KREXEL_HOME/state.json.
+ */
+export declare function runWhoami(): Promise<void>;

package/dist/whoami.js

@@ -0,0 +1,25 @@
+/**
+ * whoami.ts — `krexel whoami`
+ *
+ * Pretty-prints the orchestrator-agnostic account status that the MCP
+ * server's `get_status` tool returns from $KREXEL_HOME/state.json.
+ */
+import { withSpinner, kv, dim, isJsonMode } from "./output.js";
+import { getClient } from "./mcp-client.js";
+export async function runWhoami() {
+    const client = getClient();
+    const result = await withSpinner("Looking up account status…", () => client.callTool("get_status", {}), { enabled: true });
+    if (isJsonMode()) {
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    kv("Account", result.account?.email ?? "(not logged in)");
+    kv("Provider", result.account?.provider ?? "—");
+    kv("Deploys", String(result.deploy_count ?? 0));
+    kv("Platform", result.platform);
+    kv("API URL", result.api_url);
+    kv("State dir", result.state_dir);
+    dim(`MCP server binary: ${client.describeServer()}`);
+}
+//# sourceMappingURL=whoami.js.map

package/dist/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../src/whoami.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAc5C,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,4BAA4B,EAC5B,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAe,YAAY,EAAE,EAAE,CAAC,EACrD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IAEF,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,iBAAiB,CAAC,CAAC;IAC1D,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAC;IAChD,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,GAAG,CAAC,sBAAsB,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "krexel",
+  "version": "0.1.0",
+  "description": "Krexel CLI — login, ship, and manage deploys from the terminal. Spawns the Krexel MCP server over stdio.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Syfer-web/krexel.git"
+  },
+  "homepage": "https://krexel.com",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "krexel": "./bin/krexel"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test --import tsx/esm test/*.test.ts",
+    "lint": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "nanoid": "^5.0.9",
+    "open": "^10.1.0",
+    "ora": "^7.0.1",
+    "smol-toml": "1.7.0",
+    "undici": "^7.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}