twentythree-cli 1.0.0

package/dist/commands/spot/check.cjs

@@ -0,0 +1,52 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/spot/check.ts
+/**
+* Spot check command — retrieves details of a single spot.
+*
+* Maps to the GET /spot/check API endpoint.
+* Outputs key-value pairs of the spot's properties.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotCheck = class SpotCheck extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get details of a specific spot";
+	static examples = ["<%= config.bin %> spot check 12345", "<%= config.bin %> spot check 12345 --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Spot ID",
+		required: true
+	}) };
+	static agentMetadata = {
+		api_endpoint: "GET /spot/check",
+		auth_scope: "read",
+		output_shape: { type: "key-value" },
+		side_effects: "none"
+	};
+	async run() {
+		const { args } = await this.parse(SpotCheck);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/spot/check", { params: { query: { spot_id: Number(args.id) } } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const obj = resp?.data ?? resp;
+		if (!obj) this.error("No data returned", { exit: 1 });
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: obj,
+			summary: `Spot ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: args.id
+			}]
+		});
+		for (const [k, v] of Object.entries(obj)) this.log(`${k}: ${require_lib_term_map.applyCliTerms(String(v ?? ""))}`);
+	}
+};
+//#endregion
+module.exports = SpotCheck;

package/dist/commands/spot/create.cjs

@@ -0,0 +1,79 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/spot/create.ts
+/**
+* Spot create command — creates a new spot in the active workspace.
+*
+* Maps to the POST /spot/create API endpoint.
+* Spots are embed containers in TwentyThree.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotCreate = class SpotCreate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Create a new spot";
+	static examples = [
+		"<%= config.bin %> spot create --spot-name \"My Spot\"",
+		"<%= config.bin %> spot create --spot-name \"My Spot\" --spot-type \"video\"",
+		"<%= config.bin %> spot create --spot-name \"My Spot\" --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"spot-name": _oclif_core.Flags.string({
+			description: "Name for the new spot",
+			required: true
+		}),
+		"spot-type": _oclif_core.Flags.string({
+			description: "Type of spot",
+			required: false
+		}),
+		"spot-design": _oclif_core.Flags.string({
+			description: "Design for the spot",
+			required: false
+		}),
+		"spot-layout": _oclif_core.Flags.string({
+			description: "Layout for the spot",
+			required: false
+		})
+	};
+	static args = {};
+	static agentMetadata = {
+		api_endpoint: "POST /spot/create",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "creates"
+	};
+	async run() {
+		const { flags } = await this.parse(SpotCreate);
+		this.printWorkspaceHeader();
+		const body = { spot_name: flags["spot-name"] };
+		if (flags["spot-type"] !== void 0) body.spot_type = flags["spot-type"];
+		if (flags["spot-design"] !== void 0) body.spot_design = flags["spot-design"];
+		if (flags["spot-layout"] !== void 0) body.spot_layout = flags["spot-layout"];
+		const { data: createData, error: createError } = await this.apiClient.POST("/spot/create", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (createError) this.error(require_lib_term_map.applyCliTerms(formatApiError(createError)), { exit: 1 });
+		const spotId = createData?.data?.spot_id;
+		this.log(chalk.default.green("Spot created"));
+		this.log(`ID: ${spotId}`);
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: createData,
+			summary: "Spot created",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: String(spotId)
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = SpotCreate;

package/dist/commands/spot/delete.cjs

@@ -0,0 +1,68 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+let _clack_prompts = require("@clack/prompts");
+//#region src/commands/spot/delete.ts
+/**
+* Spot delete command — deletes a spot after confirmation.
+*
+* Maps to the POST /spot/delete API endpoint.
+* Prompts user to confirm deletion showing the workspace domain so they know
+* which workspace they are deleting from (T-08-01 repudiation mitigation).
+*
+* --json flag skips the confirmation prompt (scripting mode — assume confirmed).
+*
+* Exit codes:
+*   0 — success
+*   1 — error (spot not found, API error)
+*   2 — cancelled (user declined confirmation)
+*
+* Threat mitigations:
+*   T-08-01: Confirmation prompt includes workspace domain
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotDelete = class SpotDelete extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Delete a spot from the active workspace";
+	static examples = ["<%= config.bin %> spot delete 12345", "<%= config.bin %> spot delete 12345 --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Spot ID",
+		required: true
+	}) };
+	static agentMetadata = {
+		api_endpoint: "POST /spot/delete",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "destructive"
+	};
+	async run() {
+		const { args } = await this.parse(SpotDelete);
+		this.printWorkspaceHeader();
+		if (!this.jsonEnabled()) {
+			const confirmed = await (0, _clack_prompts.confirm)({ message: `Delete spot ${args.id} from ${this.activeWorkspace.domain}? This cannot be undone.` });
+			if ((0, _clack_prompts.isCancel)(confirmed) || !confirmed) process.exit(2);
+		}
+		const { data: deleteData, error: deleteError } = await this.apiClient.POST("/spot/delete", {
+			body: { spot_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (deleteError) this.error(require_lib_term_map.applyCliTerms(formatApiError(deleteError)), { exit: 1 });
+		this.log(chalk.default.green(`Spot ${args.id} deleted`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: deleteData,
+			summary: `Spot ${args.id} deleted`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = SpotDelete;

package/dist/commands/spot/list.cjs

@@ -0,0 +1,120 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/spot/list.ts
+/**
+* Spot list command — lists all spots in the active workspace.
+*
+* Maps to the GET /spot/list API endpoint.
+* Spots are embed containers in TwentyThree.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotList = class SpotList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List spots in the active workspace";
+	static examples = [
+		"<%= config.bin %> spot list",
+		"<%= config.bin %> spot list --search \"my spot\"",
+		"<%= config.bin %> spot list --active",
+		"<%= config.bin %> spot list --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		page: _oclif_core.Flags.integer({
+			description: "Page number",
+			required: false
+		}),
+		size: _oclif_core.Flags.integer({
+			description: "Number of results per page",
+			required: false
+		}),
+		search: _oclif_core.Flags.string({
+			description: "Search term",
+			required: false
+		}),
+		"spot-type": _oclif_core.Flags.string({
+			description: "Filter by spot type",
+			required: false
+		}),
+		active: _oclif_core.Flags.boolean({
+			description: "Filter by active status",
+			allowNo: true,
+			required: false
+		}),
+		"active-p": _oclif_core.Flags.string({
+			hidden: true,
+			required: false
+		}),
+		orderby: _oclif_core.Flags.string({
+			description: "Field to order results by",
+			required: false
+		}),
+		order: _oclif_core.Flags.string({
+			description: "Sort order (asc or desc)",
+			required: false
+		})
+	};
+	static args = {};
+	static agentMetadata = {
+		api_endpoint: "GET /spot/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Name",
+				"Type",
+				"Active"
+			]
+		},
+		side_effects: "none"
+	};
+	async run() {
+		const { flags } = await this.parse(SpotList);
+		this.printWorkspaceHeader();
+		const activeVal = parseBoolParam(flags.active, flags["active-p"]);
+		const { data, error } = await this.apiClient.GET("/spot/list", { params: { query: {
+			search: flags.search,
+			spot_type: flags["spot-type"],
+			active_p: activeVal !== void 0 ? activeVal : void 0,
+			p: flags.page,
+			size: flags.size,
+			orderby: flags.orderby,
+			order: flags.order
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const rows = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: rows,
+			summary: `${rows.length} spot(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "spot" }]
+		});
+		if (rows.length === 0) {
+			this.log("No spots found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Name",
+			"Type",
+			"Active"
+		], rows.map((r) => [
+			String(r.spot_id ?? ""),
+			String(r.spot_name ?? ""),
+			String(r.spot_type ?? ""),
+			String(r.active_p ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} spot(s)`));
+	}
+};
+//#endregion
+module.exports = SpotList;

package/dist/commands/spot/reset-version.cjs

@@ -0,0 +1,53 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/spot/reset-version.ts
+/**
+* Spot reset-version command — resets the version of a spot.
+*
+* Maps to the POST /spot/reset-version API endpoint.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotResetVersion = class SpotResetVersion extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Reset the version of a spot";
+	static examples = ["<%= config.bin %> spot reset-version 12345", "<%= config.bin %> spot reset-version 12345 --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Spot ID",
+		required: true
+	}) };
+	static agentMetadata = {
+		api_endpoint: "POST /spot/reset-version",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	async run() {
+		const { args } = await this.parse(SpotResetVersion);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/spot/reset-version", {
+			body: { spot_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Spot ${args.id} version reset`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Spot ${args.id} version reset`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = SpotResetVersion;

package/dist/commands/spot/set-videos.cjs

@@ -0,0 +1,64 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/spot/set-videos.ts
+/**
+* Spot set-videos command — assigns videos to a spot.
+*
+* Maps to the POST /spot/set-videos API endpoint.
+* Accepts comma-separated video IDs to assign to the specified spot.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*   T-08-03: Video IDs passed as comma-separated string; server-side validation enforces valid IDs
+*/
+var SpotSetVideos = class SpotSetVideos extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Assign videos to a spot";
+	static examples = ["<%= config.bin %> spot set-videos 12345 --videos \"111,222,333\"", "<%= config.bin %> spot set-videos 12345 --videos \"111\" --json"];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		videos: _oclif_core.Flags.string({
+			description: "Comma-separated video IDs to assign to the spot",
+			required: true
+		})
+	};
+	static args = { id: _oclif_core.Args.string({
+		description: "Spot ID",
+		required: true
+	}) };
+	static agentMetadata = {
+		api_endpoint: "POST /spot/set-videos",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	async run() {
+		const { args, flags } = await this.parse(SpotSetVideos);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/spot/set-videos", {
+			body: {
+				spot_id: Number(args.id),
+				videos: flags.videos
+			},
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Videos set for spot ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Videos set for spot ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = SpotSetVideos;

package/dist/commands/spot/update.cjs

@@ -0,0 +1,78 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/spot/update.ts
+/**
+* Spot update command — updates metadata for an existing spot.
+*
+* Maps to the POST /spot/update API endpoint.
+* Flag mode only: only flags explicitly provided are sent to the API.
+*
+* Threat mitigations:
+*   T-08-02: extends AuthenticatedCommand — anonymous mode rejected with AUTH-10 error
+*/
+var SpotUpdate = class SpotUpdate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Update a spot";
+	static examples = [
+		"<%= config.bin %> spot update 12345 --spot-name \"New Name\"",
+		"<%= config.bin %> spot update 12345 --active",
+		"<%= config.bin %> spot update 12345 --no-active",
+		"<%= config.bin %> spot update 12345 --spot-name \"New Name\" --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"spot-name": _oclif_core.Flags.string({
+			description: "New name for the spot",
+			required: false
+		}),
+		active: _oclif_core.Flags.boolean({
+			description: "Set active status",
+			allowNo: true,
+			required: false
+		}),
+		"active-p": _oclif_core.Flags.string({
+			hidden: true,
+			required: false
+		})
+	};
+	static args = { id: _oclif_core.Args.string({
+		description: "Spot ID",
+		required: true
+	}) };
+	static agentMetadata = {
+		api_endpoint: "POST /spot/update",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	async run() {
+		const { args, flags } = await this.parse(SpotUpdate);
+		this.printWorkspaceHeader();
+		const body = { spot_id: Number(args.id) };
+		if (flags["spot-name"] !== void 0) body.spot_name = flags["spot-name"];
+		const activeVal = parseBoolParam(flags.active, flags["active-p"]);
+		if (activeVal !== void 0) body.active_p = activeVal ? 1 : 0;
+		const { data: updateData, error: updateError } = await this.apiClient.POST("/spot/update", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (updateError) this.error(require_lib_term_map.applyCliTerms(formatApiError(updateError)), { exit: 1 });
+		this.log(chalk.default.green(`Spot ${args.id} updated`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: updateData,
+			summary: `Spot ${args.id} updated`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "spot",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = SpotUpdate;

package/dist/commands/tag/list.cjs

@@ -0,0 +1,98 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+const require_lib_pagination = require("../../lib/pagination.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/tag/list.ts
+/**
+* Tag list command — lists all tags in the active workspace with auto-pagination.
+*/
+var TagList = class TagList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List tags in the active workspace";
+	static agentMetadata = {
+		api_endpoint: "GET /tag/list",
+		auth_scope: "anonymous",
+		output_shape: {
+			type: "table",
+			columns: ["Tag", "Count"]
+		},
+		side_effects: "none"
+	};
+	static examples = [
+		"<%= config.bin %> tag list",
+		"<%= config.bin %> tag list --search marketing",
+		"<%= config.bin %> tag list --orderby count --order desc",
+		"<%= config.bin %> tag list --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		search: _oclif_core.Flags.string({
+			description: "Filter tags by a search string",
+			required: false
+		}),
+		"exclude-machine-tags": _oclif_core.Flags.boolean({
+			description: "Exclude machine tags from the results",
+			required: false
+		}),
+		"only-machine-tags": _oclif_core.Flags.boolean({
+			description: "Return only machine tags (overrides --exclude-machine-tags)",
+			required: false
+		}),
+		"only-published": _oclif_core.Flags.boolean({
+			description: "Return only tags from published videos",
+			required: false
+		}),
+		orderby: _oclif_core.Flags.string({
+			description: "Order tags by this value",
+			options: ["tag", "count"],
+			required: false
+		}),
+		order: _oclif_core.Flags.string({
+			description: "Sort order for the results",
+			options: ["asc", "desc"],
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(TagList);
+		this.printWorkspaceHeader();
+		const tags = await require_lib_pagination.fetchAllPages(async (page, size) => {
+			const { data, error } = await this.apiClient.GET("/tag/list", { params: { query: {
+				p: page,
+				size,
+				search: flags.search,
+				exclude_machine_tags_p: flags["exclude-machine-tags"] ? true : void 0,
+				only_machine_tags_p: flags["only-machine-tags"] ? true : void 0,
+				only_published_p: flags["only-published"] ? true : void 0,
+				orderby: flags.orderby,
+				order: flags.order
+			} } });
+			if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+			const resp = data;
+			return {
+				data: Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [],
+				total_count: resp?.total_count
+			};
+		});
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: tags,
+			summary: `${tags.length} tag${tags.length === 1 ? "" : "s"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "tag" }]
+		});
+		if (tags.length === 0) {
+			this.log("No tags found.");
+			return;
+		}
+		const table = require_lib_output.renderTable(["Tag", "Count"], tags.map((t) => [String(t.tag ?? ""), String(t.count ?? "")]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${tags.length} tag${tags.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = TagList;

package/dist/commands/tag/related.cjs

@@ -0,0 +1,57 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/tag/related.ts
+/**
+* Tag related command — returns related tags for a given tag in the active workspace.
+*/
+var TagRelated = class TagRelated extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List tags related to a given tag";
+	static agentMetadata = {
+		api_endpoint: "GET /tag/related",
+		auth_scope: "anonymous",
+		output_shape: {
+			type: "table",
+			columns: ["Tag"]
+		},
+		side_effects: "none"
+	};
+	static examples = ["<%= config.bin %> tag related marketing", "<%= config.bin %> tag related marketing --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { tag: _oclif_core.Args.string({
+		description: "Tag to find related tags for",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(TagRelated);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/tag/related", { params: { query: { tag: args.tag } } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const tags = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: tags,
+			summary: `${tags.length} related tag${tags.length === 1 ? "" : "s"}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{ resource: "tag" },
+				{ id: args.tag }
+			]
+		});
+		if (tags.length === 0) {
+			this.log("No related tags found.");
+			return;
+		}
+		const table = require_lib_output.renderTable(["Tag"], tags.map((t) => [String(t.tag ?? "")]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${tags.length} related tag${tags.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = TagRelated;