@getpara/cli 2.15.0

package/dist/commands/orgs/index.js

@@ -0,0 +1,15 @@
+import { registerOrgsListCommand } from "./list.js";
+import { registerOrgsSwitchCommand } from "./switch.js";
+function registerOrgsCommands(program) {
+  const orgs = program.command("orgs").description("Organization management").addHelpText(
+    "after",
+    `
+Select an org before managing projects or keys:
+  $ para orgs switch`
+  );
+  registerOrgsListCommand(orgs);
+  registerOrgsSwitchCommand(orgs);
+}
+export {
+  registerOrgsCommands
+};

package/dist/commands/orgs/list.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerOrgsListCommand(parent: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/orgs/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/orgs/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoD7D"}

package/dist/commands/orgs/list.js

@@ -0,0 +1,53 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+function registerOrgsListCommand(parent) {
+  parent.command("list").description("List your organizations").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para orgs list                Show your orgs with plan tier and active indicator
+  $ para orgs list --json         Output as JSON for scripting`)
+  ).action(async (_, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    let userId = session.userId;
+    if (!userId) {
+      const status = await client.getAuthStatus();
+      if (!status.userId) {
+        throw new CliError("Could not determine user ID. Run `para login` with browser authentication.");
+      }
+      userId = status.userId;
+    }
+    const orgs = await client.getOrganizations(userId);
+    if (opts.json) {
+      formatter.json(orgs);
+    } else {
+      formatter.table(
+        [
+          { key: "name", header: "Name" },
+          { key: "id", header: "ID" },
+          { key: "plan", header: "Plan" },
+          { key: "active", header: "" }
+        ],
+        orgs.map((org) => ({
+          name: org.name,
+          id: org.id,
+          plan: org.activePlanSlug || "free",
+          active: org.id === config.organizationId ? "(active)" : ""
+        }))
+      );
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerOrgsListCommand
+};

package/dist/commands/orgs/switch.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerOrgsSwitchCommand(parent: Command): void;
+//# sourceMappingURL=switch.d.ts.map

package/dist/commands/orgs/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/commands/orgs/switch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA6D/D"}

package/dist/commands/orgs/switch.js

@@ -0,0 +1,61 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+import { updateGlobalConfig } from "../../config/config-store.js";
+import { select } from "../../output/prompts.js";
+function registerOrgsSwitchCommand(parent) {
+  parent.command("switch").description("Set the active organization").argument("[org-id]", "Organization ID to switch to").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para orgs switch              Choose from a list of your organizations
+  $ para orgs switch abc-123      Switch directly by ID (skip the picker)
+
+Required before using projects or keys commands.`)
+  ).action(async (orgId, _, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    let userId = session.userId;
+    if (!userId) {
+      const status = await client.getAuthStatus();
+      if (!status.userId) {
+        throw new CliError("Could not determine user ID. Run `para login` with browser authentication.");
+      }
+      userId = status.userId;
+    }
+    let selectedOrgId = orgId;
+    let selectedOrgName;
+    if (!selectedOrgId) {
+      const orgs = await client.getOrganizations(userId);
+      if (orgs.length === 0) {
+        formatter.warn("No organizations found.");
+        return;
+      }
+      selectedOrgId = await select(
+        "Select organization:",
+        orgs.map((org) => ({
+          value: org.id,
+          label: org.name,
+          hint: org.id === config.organizationId ? "(current)" : void 0
+        }))
+      );
+      selectedOrgName = orgs.find((o) => o.id === selectedOrgId)?.name;
+    }
+    await updateGlobalConfig({ defaultOrganizationId: selectedOrgId });
+    formatter.json({ organizationId: selectedOrgId, name: selectedOrgName });
+    formatter.success(
+      `Switched to organization ${selectedOrgName ? `${selectedOrgName} (${selectedOrgId})` : selectedOrgId}`
+    );
+    formatter.flush();
+  });
+}
+export {
+  registerOrgsSwitchCommand
+};

package/dist/commands/projects/archive.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsArchiveCommand(parent: Command): void;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/projects/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/archive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAqDpE"}

package/dist/commands/projects/archive.js

@@ -0,0 +1,51 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+import { confirm } from "../../output/prompts.js";
+function registerProjectsArchiveCommand(parent) {
+  parent.command("archive").description("Archive a project").argument("[project-id]", "Project ID (uses active project if not given)").option("-y, --yes", "Skip confirmation prompt").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects archive               Archive the active project (asks for confirmation)
+  $ para projects archive abc-123        Archive a specific project
+  $ para projects archive abc-123 -y     Skip confirmation (for scripts)
+
+Archived projects can be restored with "para projects restore".`)
+  ).action(async (projectIdArg, cmdOpts, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    if (!config.organizationId) {
+      throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+    }
+    const projectId = projectIdArg || config.projectId;
+    if (!projectId) {
+      throw new CliError("No project selected. Run `para projects switch` or pass --project <id>.");
+    }
+    if (!cmdOpts.yes) {
+      const confirmed = await confirm("Are you sure you want to archive this project? Its API keys will stop working.");
+      if (!confirmed) {
+        formatter.info("Archive cancelled.");
+        formatter.flush();
+        return;
+      }
+    }
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    await client.deleteProject(config.organizationId, projectId);
+    if (opts.json) {
+      formatter.json({ projectId, archived: true });
+    } else {
+      formatter.success(`Archived project ${projectId}`);
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerProjectsArchiveCommand
+};

package/dist/commands/projects/create.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsCreateCommand(parent: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/projects/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoDnE"}

package/dist/commands/projects/create.js

@@ -0,0 +1,48 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+import { text } from "../../output/prompts.js";
+function registerProjectsCreateCommand(parent) {
+  parent.command("create").description("Create a new project").option("-n, --name <name>", "Project name").option("-d, --description <desc>", "Project description").option("--framework <framework>", "Framework (nextjs, vite, react-native, etc.)").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects create                        Walks you through name, description, framework
+  $ para projects create -n "My App"            Skip the name prompt
+  $ para projects create -n "My App" --framework nextjs  Fully non-interactive
+
+Requires an active organization. Run "para orgs switch" first.`)
+  ).action(async (cmdOpts, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    if (!config.organizationId) {
+      throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+    }
+    const name = cmdOpts.name || await text("Project name:", {
+      validate: (v) => {
+        if (!v.trim()) return "Name is required.";
+      }
+    });
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    const project = await client.createProject(config.organizationId, {
+      name,
+      description: cmdOpts.description,
+      framework: cmdOpts.framework
+    });
+    if (opts.json) {
+      formatter.json(project);
+    } else {
+      formatter.success(`Created project "${project.name}" (${project.id})`);
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerProjectsCreateCommand
+};

package/dist/commands/projects/index.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/projects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB/D"}

package/dist/commands/projects/index.js

@@ -0,0 +1,25 @@
+import { registerProjectsListCommand } from "./list.js";
+import { registerProjectsCreateCommand } from "./create.js";
+import { registerProjectsSwitchCommand } from "./switch.js";
+import { registerProjectsUpdateCommand } from "./update.js";
+import { registerProjectsArchiveCommand } from "./archive.js";
+import { registerProjectsRestoreCommand } from "./restore.js";
+function registerProjectsCommands(program) {
+  const projects = program.command("projects").description("Project management").addHelpText(
+    "after",
+    `
+Select a project before managing API keys:
+  $ para projects switch
+
+Requires an active organization. Run "para orgs switch" first.`
+  );
+  registerProjectsListCommand(projects);
+  registerProjectsCreateCommand(projects);
+  registerProjectsSwitchCommand(projects);
+  registerProjectsUpdateCommand(projects);
+  registerProjectsArchiveCommand(projects);
+  registerProjectsRestoreCommand(projects);
+}
+export {
+  registerProjectsCommands
+};

package/dist/commands/projects/list.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsListCommand(parent: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/projects/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoDjE"}

package/dist/commands/projects/list.js

@@ -0,0 +1,52 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+function registerProjectsListCommand(parent) {
+  parent.command("list").description("List projects in your organization").option("--include-archived", "Include archived projects").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects list                    Show projects in your active org (name, ID, framework)
+  $ para projects list --include-archived Also show archived projects
+  $ para projects list --json             Output as JSON for scripting
+
+Requires an active organization. Run "para orgs switch" first.`)
+  ).action(async (cmdOpts, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    if (!config.organizationId) {
+      throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+    }
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    const projects = await client.getProjects(config.organizationId);
+    const filtered = cmdOpts.includeArchived ? projects : projects.filter((p) => !p.archived);
+    if (opts.json) {
+      formatter.json(filtered);
+    } else {
+      formatter.table(
+        [
+          { key: "name", header: "Name" },
+          { key: "id", header: "ID" },
+          { key: "framework", header: "Framework" },
+          { key: "active", header: "" }
+        ],
+        filtered.map((p) => ({
+          name: p.name,
+          id: p.id,
+          framework: p.framework || "-",
+          active: p.id === config.projectId ? "(active)" : ""
+        }))
+      );
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerProjectsListCommand
+};

package/dist/commands/projects/restore.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsRestoreCommand(parent: Command): void;
+//# sourceMappingURL=restore.d.ts.map

package/dist/commands/projects/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoCpE"}

package/dist/commands/projects/restore.js

@@ -0,0 +1,36 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+function registerProjectsRestoreCommand(parent) {
+  parent.command("restore").description("Restore an archived project").argument("<project-id>", "Project ID to restore").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects restore abc-123        Restore an archived project
+
+Use "para projects list --include-archived" to find archived project IDs.`)
+  ).action(async (projectId, _cmdOpts, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    if (!config.organizationId) {
+      throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+    }
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    await client.restoreProject(config.organizationId, projectId);
+    if (opts.json) {
+      formatter.json({ projectId, restored: true });
+    } else {
+      formatter.success(`Restored project ${projectId}`);
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerProjectsRestoreCommand
+};

package/dist/commands/projects/switch.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsSwitchCommand(parent: Command): void;
+//# sourceMappingURL=switch.d.ts.map

package/dist/commands/projects/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/switch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA0DnE"}

package/dist/commands/projects/switch.js

@@ -0,0 +1,57 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { updateGlobalConfig } from "../../config/config-store.js";
+import { CliError } from "../../core/error-handler.js";
+import { select } from "../../output/prompts.js";
+function registerProjectsSwitchCommand(parent) {
+  parent.command("switch").description("Set the active project").argument("[project-id]", "Project ID to switch to").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects switch              Choose from a list of projects in your org
+  $ para projects switch abc-123      Switch directly by ID (skip the picker)
+
+Required before using keys commands.`)
+  ).action(async (projectId, _, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    if (!config.organizationId) {
+      throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+    }
+    let selectedProjectId = projectId;
+    let selectedProjectName;
+    if (!selectedProjectId) {
+      const client = new ParaApiClient({
+        environment: config.environment,
+        sessionId: session.sessionId
+      });
+      const projects = await client.getProjects(config.organizationId);
+      const active = projects.filter((p) => !p.archived);
+      if (active.length === 0) {
+        formatter.warn("No projects found. Run `para projects create` first.");
+        return;
+      }
+      selectedProjectId = await select(
+        "Select project:",
+        active.map((p) => ({
+          value: p.id,
+          label: p.name,
+          hint: p.id === config.projectId ? "(current)" : void 0
+        }))
+      );
+      selectedProjectName = active.find((p) => p.id === selectedProjectId)?.name;
+    }
+    await updateGlobalConfig({ defaultProjectId: selectedProjectId });
+    formatter.json({ projectId: selectedProjectId, name: selectedProjectName });
+    formatter.success(
+      `Switched to project ${selectedProjectName ? `${selectedProjectName} (${selectedProjectId})` : selectedProjectId}`
+    );
+    formatter.flush();
+  });
+}
+export {
+  registerProjectsSwitchCommand
+};

package/dist/commands/projects/update.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProjectsUpdateCommand(parent: Command): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/projects/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAgFnE"}

package/dist/commands/projects/update.js

@@ -0,0 +1,67 @@
+import { getGlobalOptions, createFormatter, helpText } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { resolveConfig } from "../../config/config-manager.js";
+import { ParaApiClient } from "../../api/client.js";
+import { CliError } from "../../core/error-handler.js";
+import { text } from "../../output/prompts.js";
+function registerProjectsUpdateCommand(parent) {
+  parent.command("update").description("Update a project").argument("[project-id]", "Project ID (uses active project if not given)").option("-n, --name <name>", "New project name").option("-d, --description <desc>", "New description").option("--framework <framework>", "Framework (REACT, NEXT, VITE, etc.)").option("--package-manager <pm>", "Package manager (NPM, YARN, PNPM)").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para projects update -n "New Name"                Rename the active project
+  $ para projects update abc-123 -n "Renamed"         Rename a specific project
+  $ para projects update --framework NEXT              Update framework setting
+  $ para projects update -n "App" --framework NEXT     Update multiple fields at once
+
+Requires an active organization. Pass --project or use "para projects switch" first.`)
+  ).action(
+    async (projectIdArg, cmdOpts, cmd) => {
+      const opts = await getGlobalOptions(cmd);
+      const formatter = createFormatter(opts);
+      const config = await resolveConfig(opts);
+      const session = await ensureAuthenticated(config.environment);
+      if (!config.organizationId) {
+        throw new CliError("No organization selected. Run `para orgs switch` or pass --org <id>.");
+      }
+      const projectId = projectIdArg || config.projectId;
+      if (!projectId) {
+        throw new CliError("No project selected. Run `para projects switch` or pass --project <id>.");
+      }
+      const data = {};
+      if (cmdOpts.name !== void 0) data.name = cmdOpts.name;
+      if (cmdOpts.description !== void 0) data.description = cmdOpts.description;
+      if (cmdOpts.framework !== void 0) data.framework = cmdOpts.framework;
+      if (cmdOpts.packageManager !== void 0) data.packageManager = cmdOpts.packageManager;
+      if (Object.keys(data).length === 0) {
+        const name = await text("Project name:", {
+          placeholder: "Leave empty to keep current"
+        });
+        if (name.trim()) data.name = name.trim();
+        const description = await text("Description:", {
+          placeholder: "Leave empty to keep current"
+        });
+        if (description.trim()) data.description = description.trim();
+      }
+      if (Object.keys(data).length === 0) {
+        formatter.info("No changes specified.");
+        formatter.flush();
+        return;
+      }
+      const client = new ParaApiClient({
+        environment: config.environment,
+        sessionId: session.sessionId
+      });
+      await client.updateProject(config.organizationId, projectId, data);
+      if (opts.json) {
+        formatter.json({ projectId, updated: data });
+      } else {
+        const fields = Object.keys(data).join(", ");
+        formatter.success(`Updated project (${fields})`);
+      }
+      formatter.flush();
+    }
+  );
+}
+export {
+  registerProjectsUpdateCommand
+};

package/dist/commands/whoami.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerWhoamiCommand(program: Command): void;
+//# sourceMappingURL=whoami.d.ts.map

package/dist/commands/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE5D"}

package/dist/commands/whoami.js

@@ -0,0 +1,61 @@
+import { getGlobalOptions, createFormatter, helpText } from "../cli.js";
+import { ensureAuthenticated } from "../auth/session-manager.js";
+import { resolveConfig } from "../config/config-manager.js";
+import { ParaApiClient } from "../api/client.js";
+function registerWhoamiCommand(program) {
+  program.command("whoami").description("Show current authenticated user and context").addHelpText(
+    "after",
+    helpText(`Examples:
+  $ para whoami                   Show your email, active org, project, and environment
+  $ para whoami --json            Machine-readable output (useful in CI scripts)
+  $ para whoami -e PROD           Check who you are on production`)
+  ).action(async (_, cmd) => {
+    const opts = await getGlobalOptions(cmd);
+    const formatter = createFormatter(opts);
+    const config = await resolveConfig(opts);
+    const session = await ensureAuthenticated(config.environment);
+    const client = new ParaApiClient({
+      environment: config.environment,
+      sessionId: session.sessionId
+    });
+    const status = await client.getAuthStatus();
+    if (opts.json) {
+      formatter.json({
+        email: status.email,
+        userId: status.userId,
+        environment: config.environment,
+        organizationId: config.organizationId,
+        projectId: config.projectId,
+        organizations: status.organizations,
+        sessionExpiresAt: status.sessionExpiresAt
+      });
+    } else {
+      const entries = [
+        { label: "Email", value: status.email || "N/A" },
+        { label: "User ID", value: status.userId || "N/A" },
+        { label: "Environment", value: config.environment }
+      ];
+      if (config.organizationId) {
+        const org = status.organizations?.find((o) => o.id === config.organizationId);
+        entries.push({
+          label: "Organization",
+          value: org ? `${org.name} (${org.role})` : config.organizationId
+        });
+      }
+      if (config.projectId) {
+        entries.push({ label: "Project", value: config.projectId });
+      }
+      if (status.sessionExpiresAt) {
+        entries.push({
+          label: "Session Expires",
+          value: new Date(status.sessionExpiresAt).toLocaleString()
+        });
+      }
+      formatter.detail(entries);
+    }
+    formatter.flush();
+  });
+}
+export {
+  registerWhoamiCommand
+};

package/dist/config/config-manager.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalOptions, ResolvedConfig } from '../core/types.js';
+export declare function resolveConfig(opts: GlobalOptions, projectRoot?: string): Promise<ResolvedConfig>;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/config/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config/config-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAItE,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAUtG"}