@ascendkit/cli 0.3.1 → 0.3.2

package/dist/cli.js

@@ -338,6 +338,65 @@ function printSurveySummary(data) {
     if (questions != null)
         console.log(`Questions: ${questions}`);
 }
+function printEnvironmentSummary(data) {
+    console.log(`${data.name} (${data.id})`);
+    console.log(`Tier: ${data.tier}`);
+    if (data.description)
+        console.log(`Description: ${data.description}`);
+    console.log(`Public key: ${data.publicKey}`);
+    if (data.secretKey) {
+        const masked = data.secretKey.slice(0, 10) + "****";
+        console.log(`Secret key: ${masked}`);
+    }
+    const vars = data.variables && typeof data.variables === "object" ? Object.entries(data.variables) : [];
+    if (vars.length > 0) {
+        console.log(`Variables:`);
+        for (const [k, v] of vars)
+            console.log(`  ${k}=${v}`);
+    }
+}
+function printPromotionSummary(result) {
+    const src = result.source ?? {};
+    const tgt = result.target ?? {};
+    console.log(`Promoted ${src.tier} → ${tgt.tier} (${tgt.envId})`);
+    console.log("");
+    const changes = result.changes ?? {};
+    const rows = [];
+    for (const [key, val] of Object.entries(changes)) {
+        const label = key.padEnd(14);
+        if (val.action === "unchanged") {
+            rows.push([label, "unchanged"]);
+        }
+        else if (val.action === "skip") {
+            rows.push([label, `skipped — ${val.reason}`]);
+        }
+        else if (val.action === "update" || val.action === "add_only") {
+            const fields = Array.isArray(val.fields) && val.fields.length ? ` (${val.fields.join(", ")})` : "";
+            rows.push([label, `updated${fields}`]);
+        }
+        else if (val.items) {
+            const counts = Object.entries(val.counts ?? {}).map(([k, v]) => `${v} ${k}`).join(", ");
+            rows.push([label, counts || "unchanged"]);
+        }
+        else {
+            rows.push([label, val.action ?? "—"]);
+        }
+    }
+    for (const [label, status] of rows) {
+        console.log(`  ${label} ${status}`);
+    }
+    // Only show warnings not already conveyed by a skipped row in the table
+    const skippedKeys = new Set(Object.entries(changes)
+        .filter(([, v]) => v.action === "skip")
+        .map(([k]) => k.toUpperCase()));
+    const warnings = (Array.isArray(result.warnings) ? result.warnings : [])
+        .filter((w) => !skippedKeys.size || !Array.from(skippedKeys).some(k => w.code?.toUpperCase().includes(k)));
+    if (warnings.length > 0) {
+        console.log("");
+        for (const w of warnings)
+            console.log(`⚠ ${w.message}`);
+    }
+}
 function printProjectSummary(data) {
     console.log(`Project: ${data.id}`);
     console.log(`Name: ${data.name}`);
@@ -756,7 +815,7 @@ async function runEnvironment(action, rest) {
     }
     switch (action) {
         case "show":
-            output(await platform.getEnvironment(ctx.projectId, ctx.environmentId));
+            printEnvironmentSummary(await platform.getEnvironment(ctx.projectId, ctx.environmentId));
             return;
         case "promote": {
             const envId = rest[0] && !rest[0].startsWith("--") ? rest[0] : ctx.environmentId;
@@ -767,8 +826,7 @@ async function runEnvironment(action, rest) {
             }
             try {
                 const result = await platform.promoteEnvironment(envId, target);
-                console.log("Promotion successful:");
-                console.log(JSON.stringify(result, null, 2));
+                printPromotionSummary(result);
             }
             catch (err) {
                 let message = err instanceof Error ? err.message : String(err);
@@ -1895,7 +1953,8 @@ async function runEmail(client, action, rest) {
             break;
         }
         case "remove-domain":
-            output(await email.removeDomain(client));
+            await email.removeDomain(client);
+            console.log("Domain removed.");
             break;
         case "list": {
             const result = await email.listIdentities(client);
@@ -1908,10 +1967,12 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity add <email> [--display-name <name>]");
                 return await exitCli(1);
             }
-            output(await email.createIdentity(client, {
+            const added = await email.createIdentity(client, {
                 email: identityEmail,
                 displayName: flags["display-name"],
-            }));
+            });
+            printEmailIdentities(added.identities ?? []);
+            console.log("Verification email sent.");
             break;
         }
         case "resend": {
@@ -1920,7 +1981,8 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity resend <email>");
                 return await exitCli(1);
             }
-            output(await email.resendIdentityVerification(client, identityEmail));
+            await email.resendIdentityVerification(client, identityEmail);
+            console.log(`Verification email sent to ${identityEmail}.`);
             break;
         }
         case "set-default": {
@@ -1929,10 +1991,11 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity set-default <email> [--display-name <name>]");
                 return await exitCli(1);
             }
-            output(await email.setDefaultIdentity(client, {
+            const updated = await email.setDefaultIdentity(client, {
                 email: identityEmail,
                 displayName: flags["display-name"],
-            }));
+            });
+            printEmailIdentities(updated.identities ?? []);
             break;
         }
         case "remove":
@@ -1942,7 +2005,9 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity remove <email>");
                 return await exitCli(1);
             }
-            output(await email.removeIdentity(client, identityEmail));
+            const remaining = await email.removeIdentity(client, identityEmail);
+            console.log("Identity removed.");
+            printEmailIdentities(remaining.identities ?? []);
             break;
         }
         case "test": {
@@ -1951,10 +2016,11 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity test <email> --to <recipient>");
                 return await exitCli(1);
             }
-            output(await email.sendTestEmail(client, {
+            const testResult = await email.sendTestEmail(client, {
                 to: flags.to,
                 fromIdentityEmail: identityEmail,
-            }));
+            });
+            console.log(testResult.message ?? "Test email sent.");
             break;
         }
         default:
@@ -1967,12 +2033,12 @@ run().catch((err) => {
     exitCli(1, err instanceof Error ? err : new Error(String(err)));
 });
 async function printEmailSetup(settings) {
-    output(settings);
     if (!settings.domain)
         return;
     const provider = settings.dnsProvider;
+    console.log(`Domain: ${settings.domain}`);
     if (provider?.name) {
-        console.log(`\nDetected DNS provider: ${provider.name} (${provider.confidence ?? "unknown"})`);
+        console.log(`DNS provider: ${provider.name} (${provider.confidence ?? "unknown"})`);
     }
     if (provider?.portalUrl) {
         console.log(`Provider console: ${provider.portalUrl}`);
@@ -1980,10 +2046,54 @@ async function printEmailSetup(settings) {
     if (provider?.assistantSetupUrl) {
         console.log(`Guided setup: ${provider.assistantSetupUrl}`);
     }
-    if (Array.isArray(settings.dnsRecords) && settings.dnsRecords.length > 0) {
-        console.log("\nAdd these DNS records:");
-        for (const rec of settings.dnsRecords) {
-            console.log(`  ${rec.type}\t${rec.name}\t${rec.value}`);
+    const records = Array.isArray(settings.dnsRecords) ? settings.dnsRecords : [];
+    if (records.length > 0) {
+        console.log("\nDNS records to add:");
+        for (const rec of records) {
+            console.log(`  ${rec.type.padEnd(6)} ${rec.name}  ${rec.value}`);
+        }
+        if (process.stdin.isTTY && process.stdout.isTTY) {
+            const defaultFile = `dns-records-${settings.domain}.txt`;
+            const { createInterface } = await import("node:readline/promises");
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                const answer = (await rl.question(`\nSave records to file [${defaultFile}]: `)).trim();
+                const filename = answer || defaultFile;
+                const { existsSync, writeFileSync } = await import("node:fs");
+                if (existsSync(filename)) {
+                    const overwrite = (await rl.question(`${filename} already exists. Overwrite? [y/N] `)).trim().toLowerCase();
+                    if (overwrite !== "y" && overwrite !== "yes") {
+                        console.log("Skipped.");
+                        return;
+                    }
+                }
+                const lines = [
+                    `; DNS records for ${settings.domain}`,
+                    `; Generated by AscendKit CLI`,
+                    "",
+                    ...records.map(rec => {
+                        let value;
+                        if (rec.type === "TXT") {
+                            value = `"${rec.value}"`;
+                        }
+                        else if (rec.type === "CNAME" || rec.type === "MX") {
+                            // Ensure absolute FQDN with trailing dot to prevent zone-relative expansion
+                            const target = rec.type === "MX" ? rec.value.replace(/^(\d+)\s+/, "$1 ") : rec.value;
+                            value = target.endsWith(".") ? target : `${target}.`;
+                        }
+                        else {
+                            value = rec.value;
+                        }
+                        const name = rec.name.endsWith(".") ? rec.name : `${rec.name}.`;
+                        return `${name}\t3600\tIN\t${rec.type}\t${value} ; cf_tags=cf-proxied:false`;
+                    }),
+                ];
+                writeFileSync(filename, lines.join("\n") + "\n");
+                console.log(`Saved to ${filename}`);
+            }
+            finally {
+                rl.close();
+            }
         }
     }
 }
@@ -2015,8 +2125,20 @@ function printEmailStatusSummary(settings, domainStatus, dnsCheck, identities) {
         return;
     }
     console.log(`Domain:        ${settings.domain} (${domainStatus.status || settings.verificationStatus || "unknown"})`);
-    if (dnsCheck?.summary) {
-        console.log(`DNS:           ${dnsCheck.summary.found}/${dnsCheck.summary.total} verified`);
+    if (dnsCheck) {
+        const { summary, records } = dnsCheck;
+        if (summary.notFound === 0 && summary.mismatch === 0 && summary.errored === 0) {
+            console.log("DNS:           all records verified");
+        }
+        else {
+            console.log(`DNS:           ${summary.found}/${summary.total} verified`);
+            const pending = records.filter(r => !r.found || r.mismatch);
+            if (pending.length > 0) {
+                console.log("Pending:");
+                for (const r of pending)
+                    console.log(`  ${r.type.padEnd(6)} ${r.name}`);
+            }
+        }
     }
     console.log("");
     printEmailIdentities(identities);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ascendkit/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "AscendKit CLI and MCP server",
   "author": "ascendkit.dev",
   "license": "MIT",