npm - @ascendkit/cli - Versions diffs - 0.1.10 → 0.1.11 - Mend

@ascendkit/cli 0.1.10 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/api/client.d.ts +4 -0
package/dist/api/client.js +38 -2
package/dist/cli.js +238 -163
package/dist/commands/platform.d.ts +6 -0
package/dist/commands/platform.js +82 -55
package/dist/constants.d.ts +2 -0
package/dist/constants.js +2 -0
package/dist/mcp.js +3 -2
package/dist/tools/platform.js +82 -8
package/package.json +10 -4

package/dist/api/client.d.ts CHANGED Viewed

@@ -1,10 +1,12 @@
 /**
  * REST client for AscendKit API.
  */
+export declare const CLI_VERSION: string;
 export declare class AscendKitClient {
     private baseUrl;
     private publicKey;
     private platformToken;
+    private upgradeWarned;
     constructor(options?: {
         apiUrl?: string;
         publicKey?: string;
@@ -14,10 +16,12 @@ export declare class AscendKitClient {
     get platformConfigured(): boolean;
     configure(publicKey: string, apiUrl?: string): void;
     configurePlatform(token: string, apiUrl?: string): void;
+    private get versionHeader();
     private get headers();
     private get platformHeaders();
     /** Headers with both public key and Bearer token for management write operations. */
     private get managedHeaders();
+    private checkUpgradeHeader;
     request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
     platformRequest<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
     /** Unauthenticated request (for login). */

package/dist/api/client.js CHANGED Viewed

@@ -1,12 +1,29 @@
 /**
  * REST client for AscendKit API.
  */
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { DEFAULT_API_URL } from "../constants.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function readPackageVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(resolve(__dirname, "../../package.json"), "utf-8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export const CLI_VERSION = readPackageVersion();
 export class AscendKitClient {
     baseUrl;
     publicKey;
     platformToken;
+    upgradeWarned = false;
     constructor(options) {
-        this.baseUrl = options?.apiUrl ?? "https://api.ascendkit.com";
+        this.baseUrl = options?.apiUrl ?? DEFAULT_API_URL;
         this.publicKey = options?.publicKey ?? null;
         this.platformToken = null;
     }
@@ -29,6 +46,9 @@ export class AscendKitClient {
         if (apiUrl)
             this.baseUrl = apiUrl;
     }
+    get versionHeader() {
+        return { "X-AscendKit-Client-Version": `cli/${CLI_VERSION}` };
+    }
     get headers() {
         if (!this.publicKey) {
             throw new Error("Not configured. Call ascendkit_configure with your public key first.");
@@ -36,6 +56,7 @@ export class AscendKitClient {
         return {
             "Content-Type": "application/json",
             "X-AscendKit-Public-Key": this.publicKey,
+            ...this.versionHeader,
         };
     }
     get platformHeaders() {
@@ -45,6 +66,7 @@ export class AscendKitClient {
         return {
             "Content-Type": "application/json",
             "Authorization": `Bearer ${this.platformToken}`,
+            ...this.versionHeader,
         };
     }
     /** Headers with both public key and Bearer token for management write operations. */
@@ -59,8 +81,18 @@ export class AscendKitClient {
             "Content-Type": "application/json",
             "X-AscendKit-Public-Key": this.publicKey,
             "Authorization": `Bearer ${this.platformToken}`,
+            ...this.versionHeader,
         };
     }
+    checkUpgradeHeader(response) {
+        const upgrade = response.headers.get("X-AscendKit-Upgrade");
+        if (upgrade === "recommended" && !this.upgradeWarned) {
+            const latest = response.headers.get("X-AscendKit-Latest-Version") ?? "latest";
+            console.error(`[ascendkit] A newer CLI version (v${latest}) is available. ` +
+                `You are running v${CLI_VERSION}. Run "npm update -g @ascendkit/cli" to upgrade.`);
+            this.upgradeWarned = true;
+        }
+    }
     async request(method, path, body) {
         const url = `${this.baseUrl}${path}`;
         const init = {
@@ -71,6 +103,7 @@ export class AscendKitClient {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url, init);
+        this.checkUpgradeHeader(response);
         if (!response.ok) {
             const text = await response.text();
             throw new Error(`AscendKit API error ${response.status}: ${text}`);
@@ -88,6 +121,7 @@ export class AscendKitClient {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url, init);
+        this.checkUpgradeHeader(response);
         if (!response.ok) {
             const text = await response.text();
             throw new Error(`AscendKit API error ${response.status}: ${text}`);
@@ -100,12 +134,13 @@ export class AscendKitClient {
         const url = `${this.baseUrl}${path}`;
         const init = {
             method,
-            headers: { "Content-Type": "application/json" },
+            headers: { "Content-Type": "application/json", ...this.versionHeader },
         };
         if (body !== undefined) {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url, init);
+        this.checkUpgradeHeader(response);
         if (!response.ok) {
             const text = await response.text();
             throw new Error(`AscendKit API error ${response.status}: ${text}`);
@@ -136,6 +171,7 @@ export class AscendKitClient {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url, init);
+        this.checkUpgradeHeader(response);
         if (!response.ok) {
             const text = await response.text();
             throw new Error(`AscendKit API error ${response.status}: ${text}`);

package/dist/cli.js CHANGED Viewed

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { readFileSync, writeFileSync } from "fs";
+import { createRequire } from "module";
 import { AscendKitClient } from "./api/client.js";
+import { DEFAULT_API_URL } from "./constants.js";
 import { loadAuth, loadEnvContext } from "./utils/credentials.js";
 import * as auth from "./commands/auth.js";
 import * as content from "./commands/content.js";
@@ -8,154 +10,36 @@ import * as surveys from "./commands/surveys.js";
 import * as platform from "./commands/platform.js";
 import * as journeys from "./commands/journeys.js";
 import * as email from "./commands/email.js";
+import * as webhooks from "./commands/webhooks.js";
 import { parseDelay } from "./utils/duration.js";
-const HELP = `ascendkit - AscendKit CLI
+const require = createRequire(import.meta.url);
+const { version: CLI_VERSION } = require("../package.json");
+const HELP = `ascendkit v${CLI_VERSION} - AscendKit CLI
 Usage: ascendkit <command> [options]
-       ascendkit help [section]
+       ascendkit help <section>
-Platform Commands:
-  init                                   Initialize AscendKit in this directory (login via browser)
-    --backend <url>                        API URL (default: https://api.ascendkit.com)
-    --portal <url>                         Portal URL (default: http://localhost:3000)
-  logout                                 Clear local credentials
-  set-env <public-key>                   Set active environment by public key
-  projects list                          List your projects
-  env list --project <project-id>        List environments for a project
-  env use <tier> --project <project-id>  Set active environment by tier
+Getting Started:
+  init             Initialize AscendKit in this directory (login via browser)
+  set-env <key>    Set active environment by public key
+  status           Show current login and environment state
+  logout           Clear local credentials
-Service Commands (require 'ascendkit init' AND 'ascendkit set-env'):
-  auth settings                        Get auth settings
-  auth settings update                 Update auth settings
-    --providers <p1,p2,...>               Comma-separated provider list
-    --email-verification <true|false>    Toggle email verification
-    --waitlist <true|false>              Toggle waitlist
-    --password-reset <true|false>        Toggle password reset
-    --session-duration <duration>        e.g. "7d", "24h"
-  auth providers <p1,p2,...>           Set enabled providers
-  auth oauth <provider>                Open browser to configure OAuth credentials
-  auth oauth set <provider>            Set OAuth credentials from CLI
-    --client-id <id>
-    --client-secret <secret>             (not recommended; appears in shell history)
-    --client-secret-stdin                Read secret from stdin
-    --callback-url <url>                 Auth callback URL for this provider
-  auth users                           List project users
+Services:
+  auth             Authentication, providers, OAuth, users
+  templates        Email templates and versioning
+  survey           Surveys, questions, distribution, analytics
+  journey          Lifecycle journeys, nodes, transitions
+  email            Email settings, domain verification, DNS
+  webhook          Webhook endpoints and testing
-  content create                       Create a content template
-    --name <name>
-    --subject <subject>
-    --body-html <html>
-    --body-text <text>
-    --slug <slug>                        URL-safe identifier
-    --description <description>          Template description
-  content list                         List all templates
-    --query <search>                     Search by name/slug/description
-    --system true                        Show only system templates
-    --custom true                        Show only custom templates
-  content get <template-id>            Get a template
-  content update <template-id>         Update a template (creates new version)
-    --subject <subject>
-    --body-html <html>
-    --body-text <text>
-    --change-note <note>
-  content delete <template-id>         Delete a template
-  content versions <template-id>       List template versions
-  content version <template-id> <n>    Get specific version
+Project Management:
+  projects         List and create projects
+  env              List, switch, and promote environments
+  verify           Check all services in the active environment
-  survey create                        Create a survey
-    --name <name>
-    --type <nps|csat|custom>
-    --definition <json>
-  survey list                          List all surveys
-  survey get <survey-id>               Get a survey
-  survey update <survey-id>            Update a survey
-    --name <name>
-    --status <draft|active|paused>
-    --definition <json>
-  survey delete <survey-id>            Delete a survey
-  survey distribute <survey-id>        Distribute to users
-    --users <usr_id1,usr_id2,...>
-  survey invitations <survey-id>       List invitations
-  survey analytics <survey-id>         Get analytics
-  survey export-definition <survey-id> Export survey definition JSON
-    --out <file>                         Optional output file path (prints to stdout if omitted)
-  survey import-definition <survey-id> Import survey definition JSON (definition only; slug unchanged)
-    --in <file>                          Input JSON file (accepts raw definition or {definition: ...})
-  journey create                       Create a journey
-    --name <name>
-    --entry-event <event>                e.g. "user.created"
-    --entry-node <node>                  First node name
-    --nodes <json>                       Node definitions (JSON, optional)
-    --transitions <json>                 Transition definitions (JSON)
-    --description <description>
-    --entry-conditions <json>            Filter on entry event payload
-    --re-entry-policy <skip|restart>     Default: skip
-  journey list                         List all journeys
-    --status <draft|active|paused|archived>
-  journey get <journey-id>             Get a journey
-  journey update <journey-id>          Update a journey
-    --name <name>
-    --nodes <json>
-    --transitions <json>
-    --description <description>
-    --entry-event <event>
-    --entry-node <node>
-    --entry-conditions <json>
-    --re-entry-policy <skip|restart>
-  journey delete <journey-id>          Delete a journey
-  journey activate <journey-id>        Activate a draft journey
-  journey pause <journey-id>           Pause an active journey
-  journey archive <journey-id>         Archive a journey (permanent)
-  journey analytics <journey-id>       Get journey analytics
-  journey list-nodes <journey-id>      List nodes with action and transition counts
-  journey add-node <journey-id>        Add a node
-    --name <node-name>
-    --action <json>                      Optional action JSON (default: {"type":"none"})
-    --terminal <true|false>              Optional terminal flag (default: false)
-  journey edit-node <journey-id> <node-name>
-    --action <json>                      Optional action JSON
-    --terminal <true|false>              Optional terminal flag
-  journey remove-node <journey-id> <node-name>
-  journey list-transitions <journey-id>
-    --from <node-name>                   Optional source node filter
-    --to <node-name>                     Optional target node filter
-  journey add-transition <journey-id>
-    --from <node-name>
-    --to <node-name>
-    --trigger <json>                     Trigger JSON, e.g. {"type":"event","event":"user.login"}
-    --priority <n>                       Optional numeric priority
-    --name <transition-name>             Optional transition name
-  journey edit-transition <journey-id> <transition-name>
-    --trigger <json>                     Optional trigger JSON
-    --priority <n>                       Optional numeric priority
-  journey remove-transition <journey-id> <transition-name>
-  email settings                       Get email settings
-  email settings update                Update email settings
-    --from-email <email>                 Sender email address
-    --from-name <name>                   Sender display name
-  email identity                       Show current identity mode and next steps
-  email use-default                    Switch to AscendKit default sender
-  email use-custom <domain>            Switch to customer-owned identity (starts DNS setup)
-    --from-email <email>                 Optional sender after domain setup
-    --from-name <name>                   Optional display name after domain setup
-  email setup-domain <domain>          Start domain verification
-  email domain-status                  Check domain verification status
-    --watch                              Poll until verified/failed
-    --interval <seconds>                 Poll interval for --watch (default: 15)
-  email open-dns                       Show DNS provider URL for current domain
-    --domain <domain>                    Optional override domain
-    --open                               Open URL in browser
-  email remove-domain                  Remove domain and reset to default
-  status                               Show current login and environment state
-  verify                               Check all services in the active environment
-Environment:
-  ASCENDKIT_PUBLIC_KEY    Environment public key (overrides stored credentials)
-  ASCENDKIT_API_URL       API URL (default: https://api.ascendkit.com)
-`;
+Run "ascendkit help <section>" for detailed command usage.
+e.g. ascendkit help auth, ascendkit help journey`;
 const HELP_SECTION = {
     auth: `Usage: ascendkit auth <command>
@@ -166,16 +50,16 @@ Commands:
   auth oauth <provider>
   auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin] [--callback-url <url>]
   auth users`,
-    content: `Usage: ascendkit content <command>
+    templates: `Usage: ascendkit templates <command>
 Commands:
-  content create --name <name> --subject <subject> --body-html <html> --body-text <text> [--slug <slug>] [--description <description>]
-  content list [--query <search>] [--system true|--custom true]
-  content get <template-id>
-  content update <template-id> [--subject <subject>] [--body-html <html>] [--body-text <text>] [--change-note <note>]
-  content delete <template-id>
-  content versions <template-id>
-  content version <template-id> <n>`,
+  templates create --name <name> --subject <subject> --body-html <html> --body-text <text> [--slug <slug>] [--description <description>]
+  templates list [--query <search>] [--system true|--custom true]
+  templates get <template-id>
+  templates update <template-id> [--subject <subject>] [--body-html <html>] [--body-text <text>] [--change-note <note>]
+  templates delete <template-id>
+  templates versions <template-id>
+  templates version <template-id> <n>`,
     survey: `Usage: ascendkit survey <command>
 Commands:
@@ -191,7 +75,6 @@ Commands:
   survey import-definition <survey-id> --in <file>
 Notes:
-  - Question-level editing commands are available via MCP tools, not this terminal CLI.
   - import-definition only updates the survey definition. It does not mutate slug/name/status.`,
     journey: `Usage: ascendkit journey <command>
@@ -225,17 +108,33 @@ Commands:
   email domain-status [--watch] [--interval <seconds>]
   email open-dns [--domain <domain>] [--open]
   email remove-domain`,
+    webhook: `Usage: ascendkit webhook <command>
+Commands:
+  webhook create --url <url> [--events <e1,e2,...>]
+  webhook list
+  webhook get <webhook-id>
+  webhook update <webhook-id> [--url <url>] [--events <e1,e2,...>] [--status <active|inactive>]
+  webhook delete <webhook-id>
+  webhook test <webhook-id> [--event <event-type>]`,
     env: `Usage: ascendkit env <command>
 Commands:
   env list --project <project-id>
-  env use <tier> --project <project-id>`,
-    projects: `Usage: ascendkit projects list`,
+  env use <tier> --project <project-id>
+  env promote <env-id> --target <tier>`,
+    projects: `Usage: ascendkit projects <command>
+Commands:
+  projects list
+  projects create --name <name> [--description <description>] [--services <s1,s2,...>]`,
 };
 function printSectionHelp(section) {
     if (!section)
         return false;
-    const key = section.toLowerCase();
+    let key = section.toLowerCase();
+    if (key === "content")
+        key = "templates";
     const text = HELP_SECTION[key];
     if (!text)
         return false;
@@ -263,7 +162,7 @@ function getClient() {
         process.exit(1);
     }
     const client = new AscendKitClient({
-        apiUrl: apiUrl ?? "https://api.ascendkit.com",
+        apiUrl: apiUrl ?? DEFAULT_API_URL,
         publicKey,
     });
     if (auth?.token) {
@@ -333,6 +232,10 @@ function table(rows, columns) {
 }
 async function run() {
     const args = process.argv.slice(2);
+    if (args[0] === "--version" || args[0] === "-v" || args[0] === "-V") {
+        console.log(CLI_VERSION);
+        return;
+    }
     if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
         console.log(HELP);
         return;
@@ -381,8 +284,34 @@ async function run() {
                     { key: "enabledServices", label: "Services", width: 30 },
                 ]);
             }
+            else if (action === "create") {
+                const flags = parseFlags(args.slice(2));
+                if (!flags.name) {
+                    console.error("Usage: ascendkit projects create --name <name> [--description <description>] [--services <s1,s2,...>]");
+                    process.exit(1);
+                }
+                try {
+                    output(await platform.createProject(flags.name, flags.description, flags.services?.split(",")));
+                }
+                catch (err) {
+                    let message = err instanceof Error ? err.message : String(err);
+                    const jsonMatch = message.match(/\{.*\}/s);
+                    if (jsonMatch) {
+                        try {
+                            const parsed = JSON.parse(jsonMatch[0]);
+                            if (parsed.error)
+                                message = parsed.error;
+                            else if (parsed.detail)
+                                message = parsed.detail;
+                        }
+                        catch { /* use raw message */ }
+                    }
+                    console.error(message);
+                    process.exit(1);
+                }
+            }
             else {
-                console.error('Usage: ascendkit projects list');
+                console.error('Usage: ascendkit projects list|create');
                 process.exit(1);
             }
             return;
@@ -409,6 +338,7 @@ async function run() {
         case "auth":
             await runAuth(client, action, args.slice(2));
             break;
+        case "templates":
         case "content":
             await runContent(client, action, args.slice(2));
             break;
@@ -421,6 +351,9 @@ async function run() {
         case "email":
             await runEmail(client, action, args.slice(2));
             break;
+        case "webhook":
+            await runWebhook(client, action, args.slice(2));
+            break;
         default:
             console.error(`Unknown command: ${domain}`);
             console.error('Run "ascendkit --help" for usage');
@@ -448,9 +381,39 @@ async function runEnv(action, rest) {
             }
             await platform.useEnvironment(rest[0], flags.project);
             break;
+        case "promote": {
+            const envId = rest[0];
+            const target = flags.target;
+            if (!envId || !target) {
+                console.error("Usage: ascendkit env promote <env-id> --target <tier>");
+                process.exit(1);
+            }
+            try {
+                const result = await platform.promoteEnvironment(envId, target);
+                console.log("Promotion successful:");
+                console.log(JSON.stringify(result, null, 2));
+            }
+            catch (err) {
+                let message = err instanceof Error ? err.message : String(err);
+                const jsonMatch = message.match(/\{.*\}/s);
+                if (jsonMatch) {
+                    try {
+                        const parsed = JSON.parse(jsonMatch[0]);
+                        if (parsed.error)
+                            message = parsed.error;
+                        else if (parsed.detail)
+                            message = parsed.detail;
+                    }
+                    catch { /* use raw message */ }
+                }
+                console.error(message);
+                process.exit(1);
+            }
+            break;
+        }
         default:
             console.error(`Unknown env command: ${action}`);
-            console.error("Usage: ascendkit env list|use");
+            console.error("Usage: ascendkit env list|use|promote");
             process.exit(1);
     }
 }
@@ -541,7 +504,7 @@ async function runContent(client, action, rest) {
     switch (action) {
         case "create":
             if (!flags.name || !flags.subject || !flags["body-html"] || !flags["body-text"]) {
-                console.error("Usage: ascendkit content create --name <n> --subject <s> --body-html <h> --body-text <t> [--slug <slug>] [--description <desc>]");
+                console.error("Usage: ascendkit templates create --name <n> --subject <s> --body-html <h> --body-text <t> [--slug <slug>] [--description <desc>]");
                 process.exit(1);
             }
             output(await content.createTemplate(client, {
@@ -569,14 +532,14 @@ async function runContent(client, action, rest) {
         }
         case "get":
             if (!rest[0]) {
-                console.error("Usage: ascendkit content get <template-id>");
+                console.error("Usage: ascendkit templates get <template-id>");
                 process.exit(1);
             }
             output(await content.getTemplate(client, rest[0]));
             break;
         case "update":
             if (!rest[0]) {
-                console.error("Usage: ascendkit content update <template-id> [--flags]");
+                console.error("Usage: ascendkit templates update <template-id> [--flags]");
                 process.exit(1);
             }
             output(await content.updateTemplate(client, rest[0], {
@@ -588,27 +551,27 @@ async function runContent(client, action, rest) {
             break;
         case "delete":
             if (!rest[0]) {
-                console.error("Usage: ascendkit content delete <template-id>");
+                console.error("Usage: ascendkit templates delete <template-id>");
                 process.exit(1);
             }
             output(await content.deleteTemplate(client, rest[0]));
             break;
         case "versions":
             if (!rest[0]) {
-                console.error("Usage: ascendkit content versions <template-id>");
+                console.error("Usage: ascendkit templates versions <template-id>");
                 process.exit(1);
             }
             output(await content.listVersions(client, rest[0]));
             break;
         case "version":
             if (!rest[0] || !rest[1]) {
-                console.error("Usage: ascendkit content version <template-id> <n>");
+                console.error("Usage: ascendkit templates version <template-id> <n>");
                 process.exit(1);
             }
             output(await content.getVersion(client, rest[0], parseInt(rest[1], 10)));
             break;
         default:
-            console.error(`Unknown content command: ${action}`);
+            console.error(`Unknown templates command: ${action}`);
             process.exit(1);
     }
 }
@@ -721,6 +684,59 @@ async function runSurvey(client, action, rest) {
             }));
             break;
         }
+        case "list-questions":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey list-questions <survey-id>");
+                process.exit(1);
+            }
+            output(await surveys.listQuestions(client, rest[0]));
+            break;
+        case "add-question": {
+            if (!rest[0] || !flags.type || !flags.title) {
+                console.error("Usage: ascendkit survey add-question <survey-id> --type <type> --title <title> [--name <name>] [--required <true|false>] [--choices <c1,c2,...>] [--position <n>]");
+                process.exit(1);
+            }
+            const params = { type: flags.type, title: flags.title };
+            if (flags.name)
+                params.name = flags.name;
+            if (flags.required)
+                params.isRequired = flags.required === "true";
+            if (flags.choices)
+                params.choices = flags.choices.split(",");
+            if (flags.position != null)
+                params.position = Number(flags.position);
+            output(await surveys.addQuestion(client, rest[0], params));
+            break;
+        }
+        case "edit-question": {
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit survey edit-question <survey-id> <question-name> [--title <title>] [--required <true|false>] [--choices <c1,c2,...>]");
+                process.exit(1);
+            }
+            const params = {};
+            if (flags.title)
+                params.title = flags.title;
+            if (flags.required)
+                params.isRequired = flags.required === "true";
+            if (flags.choices)
+                params.choices = flags.choices.split(",");
+            output(await surveys.editQuestion(client, rest[0], rest[1], params));
+            break;
+        }
+        case "remove-question":
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit survey remove-question <survey-id> <question-name>");
+                process.exit(1);
+            }
+            output(await surveys.removeQuestion(client, rest[0], rest[1]));
+            break;
+        case "reorder-questions":
+            if (!rest[0] || !flags.order) {
+                console.error("Usage: ascendkit survey reorder-questions <survey-id> --order <name1,name2,...>");
+                process.exit(1);
+            }
+            output(await surveys.reorderQuestions(client, rest[0], flags.order.split(",")));
+            break;
         default:
             console.error(`Unknown survey command: ${action}`);
             console.error('Run "ascendkit survey --help" for usage');
@@ -1009,6 +1025,65 @@ async function runJourney(client, action, rest) {
             process.exit(1);
     }
 }
+async function runWebhook(client, action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "create":
+            if (!flags.url) {
+                console.error("Usage: ascendkit webhook create --url <url> [--events <e1,e2,...>]");
+                process.exit(1);
+            }
+            output(await webhooks.createWebhook(client, {
+                url: flags.url,
+                events: flags.events ? flags.events.split(",") : undefined,
+            }));
+            break;
+        case "list":
+            table(await webhooks.listWebhooks(client), [
+                { key: "id", label: "ID" },
+                { key: "url", label: "URL", width: 40 },
+                { key: "status", label: "Status" },
+                { key: "events", label: "Events", width: 30 },
+            ]);
+            break;
+        case "get":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit webhook get <webhook-id>");
+                process.exit(1);
+            }
+            output(await webhooks.getWebhook(client, rest[0]));
+            break;
+        case "update":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit webhook update <webhook-id> [--flags]");
+                process.exit(1);
+            }
+            output(await webhooks.updateWebhook(client, rest[0], {
+                url: flags.url,
+                events: flags.events ? flags.events.split(",") : undefined,
+                status: flags.status,
+            }));
+            break;
+        case "delete":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit webhook delete <webhook-id>");
+                process.exit(1);
+            }
+            output(await webhooks.deleteWebhook(client, rest[0]));
+            break;
+        case "test":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit webhook test <webhook-id> [--event <event-type>]");
+                process.exit(1);
+            }
+            output(await webhooks.testWebhook(client, rest[0], flags.event));
+            break;
+        default:
+            console.error(`Unknown webhook command: ${action}`);
+            console.error('Run "ascendkit webhook --help" for usage');
+            process.exit(1);
+    }
+}
 async function runEmail(client, action, rest) {
     const flags = parseFlags(rest);
     switch (action) {

package/dist/commands/platform.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 export declare function init(apiUrl?: string, portalUrl?: string): Promise<void>;
 export declare function logout(): void;
 export declare function listProjects(): Promise<unknown>;
+export declare function createProject(name: string, description?: string, enabledServices?: string[]): Promise<unknown>;
 export declare function listEnvironments(projectId: string): Promise<unknown>;
 export declare function useEnvironment(tier: string, projectId: string): Promise<void>;
 export declare function setEnv(publicKey: string): Promise<void>;
@@ -33,3 +34,8 @@ export declare function mcpListProjects(client: AscendKitClient): Promise<unknow
 export declare function mcpCreateProject(client: AscendKitClient, params: McpCreateProjectParams): Promise<unknown>;
 export declare function mcpListEnvironments(client: AscendKitClient, projectId: string): Promise<unknown>;
 export declare function mcpCreateEnvironment(client: AscendKitClient, params: McpCreateEnvironmentParams): Promise<unknown>;
+export declare function promoteEnvironment(environmentId: string, targetTier: string): Promise<unknown>;
+export declare function mcpPromoteEnvironment(client: AscendKitClient, params: {
+    environmentId: string;
+    targetTier: string;
+}): Promise<unknown>;

package/dist/commands/platform.js CHANGED Viewed

@@ -2,8 +2,7 @@ import { hostname, platform as osPlatform, release } from "node:os";
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { loadAuth, saveAuth, deleteAuth, saveEnvContext, ensureGitignore } from "../utils/credentials.js";
-const DEFAULT_API_URL = "https://api.ascendkit.com";
-const DEFAULT_PORTAL_URL = "http://localhost:3000";
+import { DEFAULT_API_URL, DEFAULT_PORTAL_URL } from "../constants.js";
 const POLL_INTERVAL_MS = 2000;
 const DEVICE_CODE_EXPIRY_MS = 300_000; // 5 minutes
 const IGNORE_DIRS = new Set([".git", "node_modules", ".next", "dist", "build"]);
@@ -66,9 +65,8 @@ async function promptChoice(question, options) {
         rl.close();
     }
 }
-async function findEnvFiles(root) {
-    const examples = [];
-    const runtime = [];
+async function findEnvFolders(root) {
+    const byDir = new Map();
     async function walk(dir) {
         const entries = await readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
@@ -81,18 +79,34 @@ async function findEnvFiles(root) {
             }
             if (!entry.isFile())
                 continue;
-            if (entry.name === ".env.example") {
-                examples.push(fullPath);
-            }
-            else if (entry.name === ".env" || entry.name === ".env.local") {
-                runtime.push(fullPath);
+            const isExample = entry.name === ".env.example";
+            const isRuntime = entry.name === ".env" || entry.name === ".env.local";
+            if (!isExample && !isRuntime)
+                continue;
+            let bucket = byDir.get(dir);
+            if (!bucket) {
+                bucket = { examples: [], runtime: [] };
+                byDir.set(dir, bucket);
             }
+            if (isExample)
+                bucket.examples.push(fullPath);
+            else
+                bucket.runtime.push(fullPath);
         }
     }
     await walk(root);
-    examples.sort();
-    runtime.sort();
-    return { examples, runtime };
+    const folders = [];
+    for (const [dir, bucket] of byDir) {
+        const rel = path.relative(root, dir) || ".";
+        folders.push({
+            dir,
+            label: rel === "." ? "(project root)" : `${rel}/`,
+            examples: bucket.examples.sort(),
+            runtime: bucket.runtime.sort(),
+        });
+    }
+    folders.sort((a, b) => a.dir.localeCompare(b.dir));
+    return folders;
 }
 function readEnvValue(content, key) {
     const match = content.match(new RegExp(`^\\s*${key}=(.*)$`, "m"));
@@ -263,28 +277,26 @@ export async function init(apiUrl, portalUrl) {
                 console.log(`\nInitialized as ${result.email ?? "unknown"}`);
                 // Seed .env files with API URL and empty key placeholders
                 const cwd = process.cwd();
-                const discovered = await findEnvFiles(cwd);
-                if (discovered.examples.length > 0) {
-                    console.log(`\nFound ${discovered.examples.length} .env.example file(s).`);
-                    const updateExamples = await promptYesNo("Update with AscendKit env placeholders?", true);
-                    if (updateExamples) {
-                        for (const filePath of discovered.examples) {
+                const folders = await findEnvFolders(cwd);
+                if (folders.length > 0) {
+                    console.log(`\nFound env files in ${folders.length} folder(s).`);
+                    for (const folder of folders) {
+                        const fileNames = [...folder.examples, ...folder.runtime]
+                            .map(f => path.basename(f)).join(", ");
+                        const update = await promptYesNo(`  ${folder.label} (${fileNames}) — update?`, true);
+                        if (!update)
+                            continue;
+                        for (const filePath of folder.examples) {
                             const changed = await updateEnvExampleFile(filePath);
                             if (changed)
-                                console.log(`  Updated ${path.relative(cwd, filePath)}`);
+                                console.log(`    Updated ${path.relative(cwd, filePath)}`);
                         }
-                    }
-                }
-                if (discovered.runtime.length > 0) {
-                    console.log(`\nFound ${discovered.runtime.length} .env/.env.local file(s).`);
-                    const updateRuntime = await promptYesNo("Seed with AscendKit API URL?", true);
-                    if (updateRuntime) {
-                        for (const filePath of discovered.runtime) {
+                        for (const filePath of folder.runtime) {
                             const changed = await updateRuntimeEnvFile(filePath, api, "", "", {
                                 preserveExistingKeys: true,
                             });
                             if (changed)
-                                console.log(`  Updated ${path.relative(cwd, filePath)}`);
+                                console.log(`    Updated ${path.relative(cwd, filePath)}`);
                         }
                     }
                 }
@@ -318,6 +330,14 @@ export async function listProjects() {
     const auth = requireAuth();
     return apiRequest(auth.apiUrl, "GET", "/api/platform/projects", undefined, auth.token);
 }
+export async function createProject(name, description, enabledServices) {
+    const auth = requireAuth();
+    return apiRequest(auth.apiUrl, "POST", "/api/platform/projects", {
+        name,
+        description: description ?? "",
+        enabledServices: enabledServices ?? [],
+    }, auth.token);
+}
 export async function listEnvironments(projectId) {
     const auth = requireAuth();
     return apiRequest(auth.apiUrl, "GET", `/api/platform/projects/${projectId}/environments`, undefined, auth.token);
@@ -426,40 +446,38 @@ export async function setEnv(publicKey) {
     console.log(`  → Environment: ${result.environment.name}`);
     console.log(`  → Role: ${result.role}`);
     const cwd = process.cwd();
-    const discovered = await findEnvFiles(cwd);
-    const updatedExamples = [];
-    const updatedRuntime = [];
-    console.log(`\nFound ${discovered.examples.length} .env.example file(s).`);
-    if (discovered.examples.length > 0) {
-        const updateExamples = await promptYesNo("Update with env placeholders?", true);
-        if (updateExamples) {
-            for (const filePath of discovered.examples) {
+    const folders = await findEnvFolders(cwd);
+    const updatedFiles = [];
+    const consentedRuntimeFolders = [];
+    if (folders.length > 0) {
+        console.log(`\nFound env files in ${folders.length} folder(s).`);
+        for (const folder of folders) {
+            const fileNames = [...folder.examples, ...folder.runtime]
+                .map(f => path.basename(f)).join(", ");
+            const update = await promptYesNo(`  ${folder.label} (${fileNames}) — update?`, true);
+            if (!update)
+                continue;
+            for (const filePath of folder.examples) {
                 const changed = await updateEnvExampleFile(filePath);
                 if (changed)
-                    updatedExamples.push(path.relative(cwd, filePath));
+                    updatedFiles.push(path.relative(cwd, filePath));
             }
-        }
-    }
-    console.log(`\nFound ${discovered.runtime.length} .env/.env.local file(s).`);
-    let runtimeConsent = false;
-    if (discovered.runtime.length > 0) {
-        runtimeConsent = await promptYesNo("Update with actual env and secret values?", false);
-        if (runtimeConsent) {
-            for (const filePath of discovered.runtime) {
-                const changed = await updateRuntimeEnvFile(filePath, auth.apiUrl, result.environment.publicKey, result.environment.secretKey ?? "");
-                if (changed)
-                    updatedRuntime.push(path.relative(cwd, filePath));
+            if (folder.runtime.length > 0) {
+                consentedRuntimeFolders.push(folder);
+                for (const filePath of folder.runtime) {
+                    const changed = await updateRuntimeEnvFile(filePath, auth.apiUrl, result.environment.publicKey, result.environment.secretKey ?? "");
+                    if (changed)
+                        updatedFiles.push(path.relative(cwd, filePath));
+                }
             }
         }
     }
     console.log("\nUpdated files:");
-    if (updatedExamples.length === 0 && updatedRuntime.length === 0) {
+    if (updatedFiles.length === 0) {
         console.log("  (none)");
     }
     else {
-        for (const filePath of updatedExamples)
-            console.log(`  - ${filePath}`);
-        for (const filePath of updatedRuntime)
+        for (const filePath of updatedFiles)
             console.log(`  - ${filePath}`);
     }
     if (!result.environment.secretKey) {
@@ -468,9 +486,11 @@ export async function setEnv(publicKey) {
     // --- Webhook setup ---
     const webhookSecret = await setupWebhook(auth, result.environment.publicKey);
     if (webhookSecret) {
-        if (runtimeConsent && discovered.runtime.length > 0) {
-            for (const filePath of discovered.runtime) {
-                await updateRuntimeEnvFile(filePath, auth.apiUrl, result.environment.publicKey, result.environment.secretKey ?? "", { preserveExistingKeys: true, webhookSecret });
+        if (consentedRuntimeFolders.length > 0) {
+            for (const folder of consentedRuntimeFolders) {
+                for (const filePath of folder.runtime) {
+                    await updateRuntimeEnvFile(filePath, auth.apiUrl, result.environment.publicKey, result.environment.secretKey ?? "", { preserveExistingKeys: true, webhookSecret });
+                }
             }
             console.log("\nWebhook secret written to .env file(s).");
         }
@@ -515,3 +535,10 @@ export async function mcpListEnvironments(client, projectId) {
 export async function mcpCreateEnvironment(client, params) {
     return client.platformRequest("POST", `/api/platform/projects/${params.projectId}/environments`, { name: params.name, description: params.description ?? "", tier: params.tier });
 }
+export async function promoteEnvironment(environmentId, targetTier) {
+    const auth = requireAuth();
+    return apiRequest(auth.apiUrl, "POST", `/api/platform/environments/${environmentId}/promote`, { targetTier, dryRun: false }, auth.token);
+}
+export async function mcpPromoteEnvironment(client, params) {
+    return client.platformRequest("POST", `/api/platform/environments/${params.environmentId}/promote`, { targetTier: params.targetTier, dryRun: false });
+}

package/dist/constants.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare const DEFAULT_API_URL = "https://api.ascendkit.dev";
2	+ export declare const DEFAULT_PORTAL_URL = "https://ascendkit.dev";

package/dist/constants.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export const DEFAULT_API_URL = "https://api.ascendkit.dev";
2	+ export const DEFAULT_PORTAL_URL = "https://ascendkit.dev";

package/dist/mcp.js CHANGED Viewed

@@ -10,8 +10,9 @@ import { registerPlatformTools } from "./tools/platform.js";
 import { registerEmailTools } from "./tools/email.js";
 import { registerJourneyTools } from "./tools/journeys.js";
 import { registerWebhookTools } from "./tools/webhooks.js";
+import { DEFAULT_API_URL } from "./constants.js";
 const client = new AscendKitClient({
-    apiUrl: process.env.ASCENDKIT_API_URL ?? "https://api.ascendkit.com",
+    apiUrl: process.env.ASCENDKIT_API_URL ?? DEFAULT_API_URL,
 });
 const server = new McpServer({
     name: "ascendkit",
@@ -19,7 +20,7 @@ const server = new McpServer({
 });
 server.tool("ascendkit_configure", "Configure AscendKit with your project's public key. Must be called before using any other AscendKit tools.", {
     publicKey: z.string().describe("Your project's public key (pk_dev_..., pk_beta_..., or pk_prod_...)"),
-    apiUrl: z.string().optional().describe("AscendKit API URL (default: https://api.ascendkit.com)"),
+    apiUrl: z.string().optional().describe("AscendKit API URL (default: https://api.ascendkit.dev)"),
 }, async (params) => {
     client.configure(params.publicKey, params.apiUrl);
     return {

package/dist/tools/platform.js CHANGED Viewed

@@ -29,10 +29,30 @@ export function registerPlatformTools(server, client) {
             .optional()
             .describe('Services to enable, e.g. ["auth", "content", "surveys"]'),
     }, async (params) => {
-        const data = await platform.mcpCreateProject(client, params);
-        return {
-            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-        };
+        try {
+            const data = await platform.mcpCreateProject(client, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            let message = err instanceof Error ? err.message : String(err);
+            const jsonMatch = message.match(/\{.*\}/s);
+            if (jsonMatch) {
+                try {
+                    const parsed = JSON.parse(jsonMatch[0]);
+                    if (parsed.error)
+                        message = parsed.error;
+                    else if (parsed.detail)
+                        message = parsed.detail;
+                }
+                catch { /* use raw message */ }
+            }
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
     });
     server.tool("platform_list_environments", "List environments for a project", {
         projectId: z.string().describe("Project ID (prj_ prefixed)"),
@@ -55,9 +75,63 @@ export function registerPlatformTools(server, client) {
             .string()
             .describe('Environment tier: "dev", "beta", or "prod"'),
     }, async (params) => {
-        const data = await platform.mcpCreateEnvironment(client, params);
-        return {
-            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-        };
+        try {
+            const data = await platform.mcpCreateEnvironment(client, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            let message = err instanceof Error ? err.message : String(err);
+            const jsonMatch = message.match(/\{.*\}/s);
+            if (jsonMatch) {
+                try {
+                    const parsed = JSON.parse(jsonMatch[0]);
+                    if (parsed.error)
+                        message = parsed.error;
+                    else if (parsed.detail)
+                        message = parsed.detail;
+                }
+                catch { /* use raw message */ }
+            }
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("platform_promote_environment", "Promote an environment's configuration to a higher tier (dev → beta → prod).", {
+        environmentId: z.string().describe("Environment ID to promote"),
+        targetTier: z
+            .string()
+            .describe('Target tier: "beta" or "prod"'),
+    }, async (params) => {
+        try {
+            const data = await platform.mcpPromoteEnvironment(client, {
+                environmentId: params.environmentId,
+                targetTier: params.targetTier,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            let message = err instanceof Error ? err.message : String(err);
+            const jsonMatch = message.match(/\{.*\}/s);
+            if (jsonMatch) {
+                try {
+                    const parsed = JSON.parse(jsonMatch[0]);
+                    if (parsed.error)
+                        message = parsed.error;
+                    else if (parsed.detail)
+                        message = parsed.detail;
+                }
+                catch { /* use raw message */ }
+            }
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
     });
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ascendkit/cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "AscendKit CLI and MCP server",
   "author": "ascendkit.dev",
   "license": "MIT",
@@ -8,7 +8,14 @@
   "publishConfig": {
     "access": "public"
   },
-  "keywords": ["ascendkit", "cli", "mcp", "model-context-protocol", "b2b", "saas"],
+  "keywords": [
+    "ascendkit",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "b2b",
+    "saas"
+  ],
   "type": "module",
   "main": "dist/cli.js",
   "files": [
@@ -23,8 +30,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "start": "node dist/cli.js",
-    "release:local": "./scripts/release-local.sh"
+    "start": "node dist/cli.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",