@mtndev/cli 1.1.0 → 2.0.1

package/esm/commands/aws/iam/remove-admin/handler.js

@@ -0,0 +1,117 @@
+import { promptYesNo } from "../../utils/tty.js";
+import { requireCommands } from "../../utils/exec-aws.js";
+import { ADMIN_GROUP_NAME, resolveAdminScanProfiles, resolveProfileScan } from "../admin-group.js";
+import { removeAdminOptionsSchema } from "./schema.js";
+import chalk from "chalk";
+import { ZodError } from "zod";
+//#region src/commands/aws/iam/remove-admin/handler.js
+/**
+* `aws iam remove-admin` handler: remove users from the break-glass
+* acl-admin-do-not-use group, either for one profile or every aws-vault profile.
+* @param {unknown} options
+*/
+async function removeAdminCommand(options) {
+	try {
+		const { profile, all, user, yes, dryRun, verbose } = removeAdminOptionsSchema.parse(options);
+		requireCommands(["aws"]);
+		const userFilter = new Set(user);
+		if (all || !(profile ?? process.env.AWS_PROFILE)) requireCommands(["aws-vault"]);
+		/** @type {string[]} */
+		let profiles;
+		try {
+			profiles = resolveAdminScanProfiles({
+				profile,
+				all
+			});
+		} catch (resolveError) {
+			if (resolveError instanceof Error && resolveError.message === "No aws-vault profiles with credentials found.") {
+				console.error(chalk.red(resolveError.message));
+				process.exit(1);
+			}
+			throw resolveError;
+		}
+		console.log(chalk.blue(`\n==> Removing break-glass access (${ADMIN_GROUP_NAME}) across ${profiles.length} profile(s)\n`));
+		if (dryRun) console.log(chalk.yellow("[dry-run] No changes will be made.\n"));
+		let removed = 0;
+		let cleaned = 0;
+		let skipped = 0;
+		for (const candidate of profiles) {
+			const scan = resolveProfileScan({
+				profile: candidate,
+				verbose
+			});
+			if (!scan) {
+				skipped += 1;
+				continue;
+			}
+			if (scan.users.length === 0) {
+				if (verbose) console.log(chalk.green(`OK     ${candidate} (${scan.accountId}) — 0 users`));
+				cleaned += 1;
+				continue;
+			}
+			const targets = userFilter.size > 0 ? scan.users.filter((name) => userFilter.has(name)) : scan.users;
+			if (targets.length === 0) {
+				console.log(chalk.dim(`--     ${candidate} (${scan.accountId}) — has users but none match --user`));
+				skipped += 1;
+				continue;
+			}
+			console.log(chalk.red(`FOUND  ${candidate} (${scan.accountId}) — ${targets.length} user(s): ${targets.join(", ")}`));
+			if (dryRun) {
+				for (const name of targets) console.log(chalk.yellow(`  [dry-run] would remove ${name} from ${ADMIN_GROUP_NAME}`));
+				continue;
+			}
+			let confirmed = yes;
+			if (!confirmed) confirmed = await promptYesNo({
+				message: `  Remove ${targets.length} user(s) from ${ADMIN_GROUP_NAME} in ${candidate}?`,
+				defaultYes: false
+			});
+			if (!confirmed) {
+				console.log(chalk.dim("  skipped (not confirmed)"));
+				skipped += 1;
+				continue;
+			}
+			for (const name of targets) try {
+				scan.run([
+					"iam",
+					"remove-user-from-group",
+					"--group-name",
+					ADMIN_GROUP_NAME,
+					"--user-name",
+					name
+				], { expectJson: false });
+				console.log(chalk.green(`  removed ${name}`));
+				removed += 1;
+			} catch (removeError) {
+				const reason = removeError instanceof Error ? removeError.message.split("\n")[0] ?? "" : String(removeError);
+				console.log(chalk.red(`  failed to remove ${name}: ${reason}`));
+			}
+		}
+		console.log(chalk.blue("\n==> Summary"));
+		console.log(`  Profiles scanned:  ${profiles.length}`);
+		console.log(`  Users removed:     ${removed}`);
+		console.log(`  Already clean:     ${cleaned}`);
+		console.log(`  Skipped:           ${skipped}`);
+		if (dryRun) console.log(chalk.yellow("\n[dry-run] Re-run without --dry-run to apply changes."));
+	} catch (error) {
+		if (error instanceof ZodError) {
+			console.error(chalk.red("\n❌ Invalid command options:"));
+			error.errors.forEach((err) => {
+				console.error(chalk.red(`   ${err.path.join(".")}: ${err.message}`));
+			});
+			process.exit(1);
+		}
+		const verbose = options?.verbose || false;
+		console.error(chalk.red("\n❌ remove-admin failed:"));
+		if (error instanceof Error) {
+			console.error(chalk.red(`   ${error.message}`));
+			if (verbose && error.stack) {
+				console.error(chalk.gray("\nStack trace:"));
+				console.error(chalk.gray(error.stack));
+			}
+		} else console.error(chalk.red(`   ${String(error)}`));
+		console.error(chalk.yellow("\n💡 Requires the AWS CLI (and aws-vault when scanning multiple profiles) and iam:RemoveUserFromGroup.\n"));
+		process.exit(1);
+	}
+}
+//#endregion
+export { removeAdminCommand };

package/esm/commands/aws/iam/remove-admin/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./handler.js";
+export * from "./schema.js";

package/esm/commands/aws/iam/remove-admin/index.js

@@ -0,0 +1,4 @@
+import { ADMIN_GROUP_NAME } from "../admin-group.js";
+import { removeAdminOptionsSchema } from "./schema.js";
+import { removeAdminCommand } from "./handler.js";
+export { ADMIN_GROUP_NAME, removeAdminCommand, removeAdminOptionsSchema };

package/esm/commands/aws/iam/remove-admin/schema.d.ts

@@ -0,0 +1,28 @@
+export { ADMIN_GROUP_NAME } from "../admin-group.js";
+/**
+ * Zod schema for `aws iam remove-admin` options.
+ */
+export const removeAdminOptionsSchema: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    user: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    yes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    verbose: boolean;
+    yes: boolean;
+    all: boolean;
+    user: string[];
+    dryRun: boolean;
+    profile?: string | undefined;
+}, {
+    profile?: string | undefined;
+    verbose?: boolean | undefined;
+    yes?: boolean | undefined;
+    all?: boolean | undefined;
+    user?: string[] | undefined;
+    dryRun?: boolean | undefined;
+}>;
+export type RemoveAdminOptions = z.infer<typeof removeAdminOptionsSchema>;
+import { z } from "zod";

package/esm/commands/aws/iam/remove-admin/schema.js

@@ -0,0 +1,20 @@
+import { profileField, verboseField } from "../../schema.js";
+import { ADMIN_GROUP_NAME } from "../admin-group.js";
+import { z } from "zod";
+//#region src/commands/aws/iam/remove-admin/schema.js
+/**
+* Zod schema for `aws iam remove-admin` options.
+*/
+const removeAdminOptionsSchema = z.object({
+	profile: profileField,
+	all: z.boolean().optional().default(false).describe("Scan every aws-vault profile (default only when --profile and AWS_PROFILE are unset)"),
+	user: z.array(z.string()).optional().default([]).describe("Only remove these user(s); repeatable. Default: every user in the group"),
+	yes: z.boolean().optional().default(false).describe("Skip the per-profile confirmation prompt"),
+	dryRun: z.boolean().optional().default(false).describe("Preview removals without changing anything"),
+	verbose: verboseField
+});
+/**
+* @typedef {z.infer<typeof removeAdminOptionsSchema>} RemoveAdminOptions
+*/
+//#endregion
+export { ADMIN_GROUP_NAME, removeAdminOptionsSchema };

package/esm/commands/aws/iam/setup-acl/handler.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `aws iam setup-acl` handler: idempotently create ACL groups, publish policies,
+ * attach/detach them per group, and optionally create IAM users.
+ * @param {unknown} options
+ */
+export function setupAclCommand(options: unknown): Promise<void>;

package/esm/commands/aws/iam/setup-acl/handler.js

@@ -0,0 +1,224 @@
+import { promptYesNo } from "../../utils/tty.js";
+import { getCallerIdentity, requireCommands } from "../../utils/exec-aws.js";
+import { resolveProfile } from "../../utils/resolve-profile.js";
+import { createUsersInteractive } from "../users/utils.js";
+import { setupAclOptionsSchema } from "./schema.js";
+import { ACL_GROUPS, CUSTOM_POLICIES, attach, detach, ensureGroup, printFinalState, publishPolicy } from "./utils.js";
+import chalk from "chalk";
+import { ZodError } from "zod";
+//#region src/commands/aws/iam/setup-acl/handler.js
+/**
+* Decide whether to attach the region restriction policy.
+* @param {{ restrictRegions?: "yes" | "no" }} params
+* @returns {Promise<boolean>}
+*/
+async function resolveRestrictRegions(params) {
+	const { restrictRegions } = params;
+	if (restrictRegions) {
+		console.log(`Region restriction: ${restrictRegions}`);
+		return restrictRegions === "yes";
+	}
+	console.log("Region restriction");
+	console.log("  The policy UserAdminsDenyRegionsList limits acl-power-users to a hard-coded");
+	console.log("  region allowlist. Most accounts should leave this OFF unless you have a strong reason.");
+	const restrict = await promptYesNo({
+		message: "  Attach region restriction to acl-power-users?",
+		defaultYes: false
+	});
+	console.log(`  → ${restrict ? "yes" : "no"}`);
+	console.log("");
+	return restrict;
+}
+/**
+* `aws iam setup-acl` handler: idempotently create ACL groups, publish policies,
+* attach/detach them per group, and optionally create IAM users.
+* @param {unknown} options
+*/
+async function setupAclCommand(options) {
+	try {
+		const { restrictRegions, createUsers, profile: profileOption, region, verbose } = setupAclOptionsSchema.parse(options);
+		requireCommands(["aws"]);
+		const profile = await resolveProfile({ profile: profileOption });
+		const identity = getCallerIdentity({
+			profile,
+			region,
+			verbose
+		});
+		const accountId = identity.Account;
+		console.log("Caller:");
+		console.log(`  Account: ${accountId}`);
+		console.log(`  Arn:     ${identity.Arn}`);
+		console.log("");
+		const restrict = await resolveRestrictRegions({ restrictRegions });
+		console.log("1. Ensure groups exist...");
+		for (const group of ACL_GROUPS) ensureGroup({
+			name: group,
+			profile,
+			verbose
+		});
+		console.log("");
+		console.log("2. Publish custom policies...");
+		for (const policy of CUSTOM_POLICIES) publishPolicy({
+			name: policy.name,
+			fileName: policy.fileName,
+			accountId,
+			profile,
+			verbose
+		});
+		console.log("");
+		const ADMIN = "arn:aws:iam::aws:policy/AdministratorAccess";
+		const IAM_FULL = "arn:aws:iam::aws:policy/IAMFullAccess";
+		const READ_ONLY = "arn:aws:iam::aws:policy/ReadOnlyAccess";
+		const WRITE_LIST = `arn:aws:iam::${accountId}:policy/UserAdminsWriteList`;
+		const DENY_LIST = `arn:aws:iam::${accountId}:policy/UserAdminsDenyList`;
+		const SELF_SERVICE = `arn:aws:iam::${accountId}:policy/UserAdminsSelfServiceIAM`;
+		const DENY_REGIONS = `arn:aws:iam::${accountId}:policy/UserAdminsDenyRegionsList`;
+		const STS_FEDERATION = `arn:aws:iam::${accountId}:policy/sts-federation`;
+		const S3_RESTRICTIONS = `arn:aws:iam::${accountId}:policy/S3RestrictionsDenyNonS3Services`;
+		console.log("3. Attach policies to groups...");
+		attach({
+			group: "acl-admin-do-not-use",
+			arn: ADMIN,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-iam-full-access",
+			arn: IAM_FULL,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-iam-full-access",
+			arn: READ_ONLY,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-iam-full-access",
+			arn: SELF_SERVICE,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-iam-full-access",
+			arn: STS_FEDERATION,
+			profile,
+			verbose
+		});
+		detach({
+			group: "acl-iam-full-access",
+			arn: DENY_LIST,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-power-users",
+			arn: READ_ONLY,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-power-users",
+			arn: WRITE_LIST,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-power-users",
+			arn: DENY_LIST,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-power-users",
+			arn: SELF_SERVICE,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-read-only",
+			arn: READ_ONLY,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-read-only",
+			arn: STS_FEDERATION,
+			profile,
+			verbose
+		});
+		attach({
+			group: "acl-s3-restrictions",
+			arn: S3_RESTRICTIONS,
+			profile,
+			verbose
+		});
+		console.log("");
+		console.log("4. Apply region restriction to acl-power-users...");
+		if (restrict) attach({
+			group: "acl-power-users",
+			arn: DENY_REGIONS,
+			profile,
+			verbose
+		});
+		else detach({
+			group: "acl-power-users",
+			arn: DENY_REGIONS,
+			profile,
+			verbose
+		});
+		console.log("");
+		console.log("5. Detach legacy policies (if present)...");
+		const legacyArns = [
+			"arn:aws:iam::aws:policy/PowerUserAccess",
+			"arn:aws:iam::aws:policy/IAMReadOnlyAccess",
+			`arn:aws:iam::${accountId}:policy/UserAdminsAllowList`,
+			`arn:aws:iam::${accountId}:policy/UserAdminsDenyListServices`,
+			`arn:aws:iam::${accountId}:policy/UserAdminsDenyListGpu`
+		];
+		for (const group of ACL_GROUPS) for (const arn of legacyArns) detach({
+			group,
+			arn,
+			profile,
+			verbose
+		});
+		console.log("");
+		console.log("6. Final state:");
+		printFinalState({
+			profile,
+			verbose
+		});
+		console.log("");
+		if (createUsers) {
+			console.log("7. Create IAM users (optional)");
+			console.log("");
+			await createUsersInteractive({
+				profile,
+				verbose
+			});
+		}
+		console.log(chalk.green("\n✅ ACL setup complete."));
+	} catch (error) {
+		if (error instanceof ZodError) {
+			console.error(chalk.red("\n❌ Invalid command options:"));
+			error.errors.forEach((err) => {
+				console.error(chalk.red(`   ${err.path.join(".")}: ${err.message}`));
+			});
+			process.exit(1);
+		}
+		const verbose = options?.verbose || false;
+		console.error(chalk.red("\n❌ iam setup-acl failed:"));
+		if (error instanceof Error) {
+			console.error(chalk.red(`   ${error.message}`));
+			if (verbose && error.stack) {
+				console.error(chalk.gray("\nStack trace:"));
+				console.error(chalk.gray(error.stack));
+			}
+		} else console.error(chalk.red(`   ${String(error)}`));
+		console.error(chalk.yellow("\n💡 Run with a profile that has IAMFullAccess (e.g. md-*-iam-admin).\n"));
+		process.exit(1);
+	}
+}
+//#endregion
+export { setupAclCommand };

package/esm/commands/aws/iam/setup-acl/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./handler.js";
+export * from "./schema.js";
+export * from "./utils.js";

package/esm/commands/aws/iam/setup-acl/index.js

@@ -0,0 +1,4 @@
+import { setupAclOptionsSchema } from "./schema.js";
+import { ACL_GROUPS, CUSTOM_POLICIES, attach, detach, ensureGroup, printFinalState, publishPolicy } from "./utils.js";
+import { setupAclCommand } from "./handler.js";
+export { ACL_GROUPS, CUSTOM_POLICIES, attach, detach, ensureGroup, printFinalState, publishPolicy, setupAclCommand, setupAclOptionsSchema };

package/esm/commands/aws/iam/setup-acl/schema.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for `aws iam setup-acl` options.
+ */
+export const setupAclOptionsSchema: z.ZodObject<{
+    restrictRegions: z.ZodOptional<z.ZodEnum<["yes", "no"]>>;
+    createUsers: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    profile: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    verbose: boolean;
+    createUsers: boolean;
+    profile?: string | undefined;
+    region?: string | undefined;
+    restrictRegions?: "yes" | "no" | undefined;
+}, {
+    profile?: string | undefined;
+    region?: string | undefined;
+    verbose?: boolean | undefined;
+    restrictRegions?: "yes" | "no" | undefined;
+    createUsers?: boolean | undefined;
+}>;
+export type SetupAclOptions = z.infer<typeof setupAclOptionsSchema>;
+import { z } from "zod";

package/esm/commands/aws/iam/setup-acl/schema.js

@@ -0,0 +1,18 @@
+import { profileField, regionField, verboseField } from "../../schema.js";
+import { z } from "zod";
+//#region src/commands/aws/iam/setup-acl/schema.js
+/**
+* Zod schema for `aws iam setup-acl` options.
+*/
+const setupAclOptionsSchema = z.object({
+	restrictRegions: z.enum(["yes", "no"]).optional().describe("Attach the region restriction to acl-power-users (skips the interactive prompt)"),
+	createUsers: z.boolean().optional().default(true).describe("Create IAM users after configuring groups (use --no-create-users to skip)"),
+	profile: profileField,
+	region: regionField,
+	verbose: verboseField
+});
+/**
+* @typedef {z.infer<typeof setupAclOptionsSchema>} SetupAclOptions
+*/
+//#endregion
+export { setupAclOptionsSchema };

package/esm/commands/aws/iam/setup-acl/utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Create an IAM group if it does not already exist.
+ * @param {{ name: string; profile?: string; verbose?: boolean }} params
+ */
+export function ensureGroup(params: {
+    name: string;
+    profile?: string;
+    verbose?: boolean;
+}): void;
+/**
+ * Create or update a customer-managed policy from a bundled JSON document.
+ * Handles the IAM five-version limit by pruning the oldest non-default version.
+ * @param {{ name: string; fileName: string; accountId: string; profile?: string; verbose?: boolean }} params
+ */
+export function publishPolicy(params: {
+    name: string;
+    fileName: string;
+    accountId: string;
+    profile?: string;
+    verbose?: boolean;
+}): void;
+/**
+ * Attach a policy to a group if not already attached.
+ * @param {{ group: string; arn: string; profile?: string; verbose?: boolean }} params
+ */
+export function attach(params: {
+    group: string;
+    arn: string;
+    profile?: string;
+    verbose?: boolean;
+}): void;
+/**
+ * Detach a (legacy) policy from a group if it is currently attached.
+ * @param {{ group: string; arn: string; profile?: string; verbose?: boolean }} params
+ */
+export function detach(params: {
+    group: string;
+    arn: string;
+    profile?: string;
+    verbose?: boolean;
+}): void;
+/**
+ * Print the attached policies for each ACL group.
+ * @param {{ profile?: string; verbose?: boolean }} params
+ */
+export function printFinalState(params: {
+    profile?: string;
+    verbose?: boolean;
+}): void;
+/**
+ * The five ACL groups managed by setup-acl.
+ */
+export const ACL_GROUPS: string[];
+/**
+ * Custom managed policies published from bundled JSON documents.
+ * @type {Array<{ name: string; fileName: string }>}
+ */
+export const CUSTOM_POLICIES: Array<{
+    name: string;
+    fileName: string;
+}>;