@ascendkit/cli 0.1.11 → 0.2.0

package/dist/cli.js

@@ -35,7 +35,7 @@ Services:
 
 Project Management:
   projects         List and create projects
-  env              List, switch, and promote environments
+  env              List, switch, update, and promote environments
   verify           Check all services in the active environment
 
 Run "ascendkit help <section>" for detailed command usage.
@@ -122,6 +122,7 @@ Commands:
 Commands:
   env list --project <project-id>
   env use <tier> --project <project-id>
+  env update <env-id> --project <project-id> [--name <name>] [--description <desc>]
   env promote <env-id> --target <tier>`,
     projects: `Usage: ascendkit projects <command>
 
@@ -411,9 +412,44 @@ async function runEnv(action, rest) {
             }
             break;
         }
+        case "update": {
+            const envId = rest[0];
+            if (!envId || !flags.project) {
+                console.error("Usage: ascendkit env update <env-id> --project <project-id> [--name <name>] [--description <desc>]");
+                process.exit(1);
+            }
+            const name = flags.name;
+            const description = flags.description;
+            if (!name && description === undefined) {
+                console.error("Provide at least --name or --description to update.");
+                process.exit(1);
+            }
+            try {
+                const result = await platform.updateEnvironment(flags.project, envId, name, description);
+                console.log("Environment updated:");
+                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|promote");
+            console.error("Usage: ascendkit env list|use|update|promote");
             process.exit(1);
     }
 }

package/dist/commands/platform.d.ts

@@ -17,7 +17,7 @@ export interface McpCreateProjectParams {
 }
 export interface McpCreateEnvironmentParams {
     projectId: string;
-    name: string;
+    name?: string;
     description?: string;
     tier: string;
 }
@@ -34,7 +34,15 @@ 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 updateEnvironment(projectId: string, envId: string, name?: string, description?: string): Promise<unknown>;
 export declare function promoteEnvironment(environmentId: string, targetTier: string): Promise<unknown>;
+export interface McpUpdateEnvironmentParams {
+    projectId: string;
+    environmentId: string;
+    name?: string;
+    description?: string;
+}
+export declare function mcpUpdateEnvironment(client: AscendKitClient, params: McpUpdateEnvironmentParams): Promise<unknown>;
 export declare function mcpPromoteEnvironment(client: AscendKitClient, params: {
     environmentId: string;
     targetTier: string;

package/dist/commands/platform.js

@@ -535,10 +535,27 @@ 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 updateEnvironment(projectId, envId, name, description) {
+    const auth = requireAuth();
+    const body = {};
+    if (name)
+        body.name = name;
+    if (description !== undefined)
+        body.description = description;
+    return apiRequest(auth.apiUrl, "PATCH", `/api/platform/projects/${projectId}/environments/${envId}`, body, auth.token);
+}
 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 mcpUpdateEnvironment(client, params) {
+    const body = {};
+    if (params.name)
+        body.name = params.name;
+    if (params.description !== undefined)
+        body.description = params.description;
+    return client.platformRequest("PATCH", `/api/platform/projects/${params.projectId}/environments/${params.environmentId}`, body);
+}
 export async function mcpPromoteEnvironment(client, params) {
     return client.platformRequest("POST", `/api/platform/environments/${params.environmentId}/promote`, { targetTier: params.targetTier, dryRun: false });
 }

package/dist/tools/platform.js

@@ -66,7 +66,8 @@ export function registerPlatformTools(server, client) {
         projectId: z.string().describe("Project ID (prj_ prefixed)"),
         name: z
             .string()
-            .describe('Environment name, e.g. "Development", "Production"'),
+            .optional()
+            .describe("Environment name. If omitted, derived from project name + tier."),
         description: z
             .string()
             .optional()
@@ -100,6 +101,43 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
+    server.tool("platform_update_environment", "Update an environment's name or description.", {
+        projectId: z.string().describe("Project ID (prj_ prefixed)"),
+        environmentId: z.string().describe("Environment ID (env_ prefixed)"),
+        name: z.string().optional().describe("New environment name"),
+        description: z.string().optional().describe("New environment description"),
+    }, async (params) => {
+        if (!params.name && !params.description) {
+            return {
+                content: [{ type: "text", text: "At least one of name or description is required." }],
+                isError: true,
+            };
+        }
+        try {
+            const data = await platform.mcpUpdateEnvironment(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

package/package.json

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

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/index.js

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { AscendKitClient } from "./api/client.js";
-import { registerAuthTools } from "./tools/auth.js";
-import { registerContentTools } from "./tools/content.js";
-import { registerSurveyTools } from "./tools/surveys.js";
-const args = process.argv.slice(2);
-const publicKey = args[0];
-const apiUrl = args[1] ?? process.env.ASCENDKIT_API_URL ?? "http://localhost:8000";
-if (!publicKey) {
-    console.error("Usage: ascendkit-mcp <public-key> [api-url]");
-    console.error("  public-key  Your project's public key (pk_live_...)");
-    console.error("  api-url     AscendKit API URL (default: http://localhost:8000)");
-    process.exit(1);
-}
-const client = new AscendKitClient({ apiUrl, publicKey });
-const server = new McpServer({
-    name: "ascendkit",
-    version: "0.1.0",
-});
-registerAuthTools(server, client);
-registerContentTools(server, client);
-registerSurveyTools(server, client);
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-main().catch(console.error);