@get-dx/cli 0.1.6 → 0.1.7

package/README.md

@@ -18,6 +18,26 @@ Interactively login and install the AI agent skill:
 dx init
 ```
 
+The CLI uses `app.getdx.com` as the hostname and `api.getdx.com` as the api base url by default.
+
+### Dedicated or managed deployments
+
+If your organization is on a dedicated or managed DX deployment, pass your custom hostname at init time:
+
+```shell
+# Flag (dedicated instance at mycompany.getdx.io)
+dx init --host mycompany.getdx.io
+
+# Env var — useful for CI or scripted setups
+DX_HOST=mycompany.getdx.io dx init
+```
+
+The `DX_HOST` and `--host` values accept:
+
+- `app.getdx.com` — DX Cloud (default)
+- `<account>.getdx.io` — DX dedicated (derives `https://api.<account>.getdx.io` automatically)
+- Any custom domain — you will be prompted for the separate API base URL
+
 Show help text:
 
 ```shell

package/dist/commands/init.js

@@ -50,12 +50,14 @@ export function initCommand() {
     const init = new Command()
         .name("init")
         .description("Initialize the DX CLI")
-        .action(wrapAction(async (_commandOptions, command) => {
+        .option("--host <hostname>", "DX hostname for dedicated or managed deployments (e.g. mycompany.getdx.io)")
+        .action(wrapAction(async (commandOptions, command) => {
         const context = getContext(command);
         let runtime = buildRuntimeSafe(context);
         ensureInteractive();
         showWelcomeBanner();
-        runtime = await ensureLoggedIn(runtime);
+        const host = commandOptions.host || process.env.DX_HOST;
+        runtime = await ensureLoggedIn(runtime, host);
         await optionallySetupSkill(runtime);
         renderRichText([
             ui.blankLine(),
@@ -72,7 +74,7 @@ function ensureInteractive() {
 function showWelcomeBanner() {
     renderRichText([ui.p(ui.success(WELCOME_BANNER))]);
 }
-async function ensureLoggedIn(runtime) {
+async function ensureLoggedIn(runtime, host) {
     renderRichText([ui.h1(`Checking if you are logged in...`), ui.blankLine()]);
     if (runtime) {
         let authInfo = null;
@@ -88,17 +90,9 @@ async function ensureLoggedIn(runtime) {
         }
     }
     renderRichText([ui.p(`You are not logged in yet.`), ui.blankLine()]);
-    let parsed = { type: "invalid" };
-    while (parsed.type === "invalid") {
-        const raw = await input({
-            message: "What is your DX hostname? (leave blank for app.getdx.com)",
-        });
-        parsed = parseHostname(raw);
-        if (parsed.type === "invalid") {
-            renderRichText([
-                ui.p(ui.error(`Could not recognise that hostname. Please try again.`)),
-            ]);
-        }
+    const parsed = host ? parseHostname(host) : { type: "cloud" };
+    if (parsed.type === "invalid") {
+        throw new CliError(`Could not recognize hostname "${host}". Expected app.getdx.com, <account>.getdx.io, or a custom domain.`);
     }
     switch (parsed.type) {
         case "cloud":

package/dist/commands/teams.js

@@ -32,6 +32,36 @@ export function teamsCommand() {
             renderTeamByMembers(response.team);
         }
     }));
+    teams
+        .command("info")
+        .description("Retrieve details for an individual team")
+        .option("--team-id <id>", "DX team ID")
+        .option("--reference-id <id>", "Team ID that is internal to your organization")
+        .addHelpText("afterAll", createExampleText([
+        {
+            label: "Fetch info for a team by DX team ID",
+            command: "dx teams info --team-id NTA4Nzc",
+        },
+        {
+            label: "Fetch info for a team by your organization's reference ID",
+            command: "dx teams info --reference-id 06BEC4E0-5A61-354E-08A6-C39D756058AB",
+        },
+        {
+            label: "Fetch team info and return JSON",
+            command: "dx --json teams info --team-id NTA4Nzc",
+        },
+    ]))
+        .action(wrapAction(async (options, command) => {
+        const lookup = parseTeamInfoLookup(options);
+        const runtime = buildRuntime(getContext(command));
+        const response = await getTeamInfo(runtime, lookup);
+        if (runtime.context.json) {
+            renderJson(response);
+        }
+        else {
+            renderTeamInfo(response.team);
+        }
+    }));
     teams
         .command("list")
         .description("List all teams in DX")
@@ -72,6 +102,13 @@ async function findTeamByMembers(runtime, teamEmails) {
         throw buildFindByMembersError(error, teamEmails);
     }
 }
+async function getTeamInfo(runtime, lookup) {
+    const response = await request(runtime, "/teams.info", {
+        method: "GET",
+        query: lookup,
+    });
+    return response.body;
+}
 async function listTeams(runtime) {
     const response = await request(runtime, "/teams.list", {
         method: "GET",
@@ -93,6 +130,31 @@ function renderTeamByMembers(team) {
     ];
     renderRichText(blocks);
 }
+function renderTeamInfo(team) {
+    const blocks = [ui.h1("Team Information")];
+    const heading = formatTeamHeading(team);
+    if (heading) {
+        blocks.push(ui.h2(heading));
+    }
+    const details = [];
+    pushDetail(details, "ID", formatText(team.id), team.id !== undefined);
+    pushDetail(details, "Name", team.name ?? ui.dim("(None)"), team.name !== undefined);
+    pushDetail(details, "Reference ID", formatText(team.reference_id), team.reference_id !== undefined);
+    pushDetail(details, "Parent ID", formatText(team.parent_id), team.parent_id !== undefined);
+    pushDetail(details, "Manager ID", formatText(team.manager_id), team.manager_id !== undefined);
+    pushDetail(details, "Parent team", typeof team.parent === "boolean" ? (team.parent ? "Yes" : "No") : "", team.parent !== undefined);
+    pushDetail(details, "Last changed", team.last_changed_at
+        ? ui.timestampSummary(team.last_changed_at)
+        : ui.dim("(None)"), team.last_changed_at !== undefined);
+    pushDetail(details, "Lead", formatTeamMember(team.lead), team.lead !== undefined);
+    pushDetail(details, "Manager", formatTeamMember(team.manager), team.manager !== undefined);
+    if (details.length > 0) {
+        blocks.push(ui.dl(details, { termWidth: 14 }));
+    }
+    blocks.push(ui.h2("Contributors"));
+    blocks.push(formatTeamMemberList(team.contributors));
+    renderRichText(blocks);
+}
 function renderTeams(teams) {
     const blocks = [ui.h1("Teams")];
     blocks.push(ui.p(`Displaying ${ui.bold(teams.length.toString())} teams.`));
@@ -123,12 +185,56 @@ function renderTeams(teams) {
 function formatText(value) {
     return value ? ui.code(value) : ui.dim("(None)");
 }
+function formatTeamHeading(team) {
+    if (team.name && team.id) {
+        return `${team.name} (${ui.code(team.id)})`;
+    }
+    if (team.name) {
+        return team.name;
+    }
+    if (team.id) {
+        return ui.code(team.id);
+    }
+    if (team.reference_id) {
+        return ui.code(team.reference_id);
+    }
+    return null;
+}
 function formatTeamMember(member) {
     if (!member) {
         return ui.dim("(None)");
     }
     return `${member.name} <${member.email}> (${ui.code(member.id)})`;
 }
+function formatTeamMemberList(members) {
+    if (!members || members.length === 0) {
+        return ui.p(ui.dim("(None)"));
+    }
+    return ui.ul(members.map((member) => ui.li(formatTeamMember(member))));
+}
+function pushDetail(details, term, value, shouldInclude) {
+    if (shouldInclude) {
+        details.push(ui.dli(term, value));
+    }
+}
+function parseTeamInfoLookup(options) {
+    const teamId = parseOptionalTextOption(options.teamId);
+    const referenceId = parseOptionalTextOption(options.referenceId);
+    if (!teamId && !referenceId) {
+        throw new CliError("One of --team-id or --reference-id is required", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    if (teamId && referenceId) {
+        throw new CliError("--team-id and --reference-id are mutually exclusive", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    return teamId ? { team_id: teamId } : { reference_id: referenceId };
+}
+function parseOptionalTextOption(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
 function parseTeamEmails(value) {
     if (typeof value !== "string") {
         throw new CliError("--team-emails is required", EXIT_CODES.ARGUMENT_ERROR);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-dx/cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "DX CLI",
   "author": "DX <developers@getdx.com>",
   "bugs": {