twentythree-cli 1.0.2 → 1.1.1

package/dist/commands/app/list.cjs

@@ -0,0 +1,87 @@
+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/app/list.ts
+/**
+* App list command — returns paginated list of player design apps on the workspace.
+*/
+var AppList = class AppList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List player design apps on the active workspace";
+	static examples = [
+		"<%= config.bin %> app list",
+		"<%= config.bin %> app list --app-id 42",
+		"<%= config.bin %> app list --page 2 --size 50",
+		"<%= config.bin %> app list --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Name",
+				"Type",
+				"Description"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"app-id": _oclif_core.Flags.integer({
+			description: "Filter results to a specific app ID",
+			required: false
+		}),
+		page: _oclif_core.Flags.integer({
+			description: "Page offset",
+			required: false
+		}),
+		size: _oclif_core.Flags.integer({
+			description: "Number of results per page (default 20, max 100)",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(AppList);
+		this.printWorkspaceHeader();
+		const body = {};
+		if (flags["app-id"] !== void 0) body.app_id = flags["app-id"];
+		if (flags.page !== void 0) body.p = flags.page;
+		if (flags.size !== void 0) body.size = flags.size;
+		const { data, error } = await this.apiClient.POST("/app/list", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		const apps = data?.apps ?? data?.data ?? [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: apps,
+			summary: "App list",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "app" }]
+		});
+		if (apps.length === 0) {
+			this.log("No apps found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Name",
+			"Type",
+			"Description"
+		], apps.map((a) => [
+			String(a.app_id ?? a.id ?? ""),
+			String(a.name ?? ""),
+			String(a.type ?? ""),
+			String(a.description ?? "")
+		]));
+		this.log(table.toString());
+	}
+};
+//#endregion
+module.exports = AppList;

package/dist/commands/app/remove-thumbnail.cjs

@@ -0,0 +1,51 @@
+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/app/remove-thumbnail.ts
+/**
+* App remove-thumbnail command — removes the custom thumbnail for an app, reverting to default.
+*
+* Threat mitigations:
+*   T-08-05: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var AppRemoveThumbnail = class AppRemoveThumbnail extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Remove the custom thumbnail for an app, reverting to the default";
+	static examples = ["<%= config.bin %> app remove-thumbnail 42", "<%= config.bin %> app remove-thumbnail 42 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/remove-thumbnail",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "App ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(AppRemoveThumbnail);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/app/remove-thumbnail", {
+			body: { app_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Thumbnail removed for app ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Thumbnail removed for app ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "app",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = AppRemoveThumbnail;

package/dist/commands/app/set-thumbnail.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);
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+//#region src/commands/app/set-thumbnail.ts
+/**
+* App set-thumbnail command — uploads and sets a custom thumbnail image for an app.
+*
+* Uses direct multipart POST with bodySerializer to create FormData.
+* Per D-3: NOT the chunked engine — thumbnail images use direct multipart upload.
+*
+* Threat mitigations:
+*   T-08-08: Validates file exists via fs.existsSync before reading
+*   T-08-05: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var AppSetThumbnail = class AppSetThumbnail extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Upload and set a custom thumbnail image for an app";
+	static examples = ["<%= config.bin %> app set-thumbnail ./thumbnail.png --app-id 42", "<%= config.bin %> app set-thumbnail ./thumbnail.jpg --app-id 42 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/set-thumbnail",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"app-id": _oclif_core.Flags.integer({
+			description: "App ID to update",
+			required: true
+		})
+	};
+	static args = { file: _oclif_core.Args.string({
+		description: "Path to the thumbnail image file",
+		required: true
+	}) };
+	async run() {
+		const { args, flags } = await this.parse(AppSetThumbnail);
+		this.printWorkspaceHeader();
+		const filePath = node_path.resolve(args.file);
+		if (!node_fs.existsSync(filePath)) this.error(`File not found: ${filePath}`, { exit: 1 });
+		const fileBuffer = node_fs.readFileSync(filePath);
+		const fileName = node_path.basename(filePath);
+		const fileBlob = new Blob([fileBuffer]);
+		const { data, error } = await this.apiClient.POST("/app/set-thumbnail", {
+			body: {
+				app_id: flags["app-id"],
+				file: fileBlob
+			},
+			bodySerializer(body) {
+				const fd = new FormData();
+				for (const [k, v] of Object.entries(body)) if (v !== void 0) if (v instanceof Blob) fd.append(k, v, fileName);
+				else fd.append(k, String(v));
+				return fd;
+			}
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Thumbnail set for app ${flags["app-id"]}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Thumbnail set for app ${flags["app-id"]}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "app",
+				id: String(flags["app-id"])
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = AppSetThumbnail;

package/dist/commands/autocomplete/index.cjs

@@ -1,4 +1,5 @@
 const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_detect_shell = require("../../lib/detect-shell.cjs");
 let _oclif_core = require("@oclif/core");
 let _clack_prompts = require("@clack/prompts");
 _clack_prompts = require_runtime.__toESM(_clack_prompts);
@@ -15,8 +16,7 @@ var Autocomplete = class Autocomplete extends _oclif_core.Command {
 	async run() {
 		await this.parse(Autocomplete);
 		_clack_prompts.intro("Tab completion setup");
-		const rawShell = process.env.SHELL ?? "";
-		const detectedShell = rawShell.endsWith("zsh") ? "zsh" : rawShell.endsWith("bash") ? "bash" : null;
+		const detectedShell = require_lib_detect_shell.detectShell(process.env.SHELL ?? "");
 		let shell;
 		if (detectedShell) {
 			const confirm = await _clack_prompts.confirm({ message: `Detected shell: ${detectedShell}. Set up completion for ${detectedShell}?` });
@@ -70,7 +70,7 @@ var Autocomplete = class Autocomplete extends _oclif_core.Command {
 			return;
 		}
 		const rcFile = shell === "zsh" ? "~/.zshrc" : "~/.bashrc";
-		const evalLine = `printf "$(twentythree autocomplete script ${shell})" >> ${rcFile}; source ${rcFile}`;
+		const evalLine = `grep -qF 'twentythree autocomplete script ${shell}' ${rcFile} || printf "$(twentythree autocomplete script ${shell})" >> ${rcFile}; source ${rcFile}`;
 		_clack_prompts.note(`Add tab completion to your shell by running:\n\n  ${evalLine}\n\nThen restart your terminal or run: source ${rcFile}`, "Setup instructions");
 		_clack_prompts.outro("After setup, try: twentythree video <TAB>");
 	}

package/dist/commands/video/section/generate.cjs

@@ -0,0 +1,54 @@
+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/video/section/generate.ts
+/**
+* Video section generate command — AI-generates sections from a video transcript.
+*
+* Replaces all existing sections. Requires a transcript to be available.
+*/
+var VideoSectionGenerate = class VideoSectionGenerate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Automatically generate sections for a video using AI (requires transcript)";
+	static examples = ["<%= config.bin %> video section generate 12345", "<%= config.bin %> video section generate 12345 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/section/generate",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "creates"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(VideoSectionGenerate);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/photo/section/generate", {
+			body: { photo_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Sections generated for video ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Sections generated for video ${args.id}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{
+					resource: "video",
+					id: args.id
+				},
+				{ resource: "section" }
+			]
+		});
+	}
+};
+//#endregion
+module.exports = VideoSectionGenerate;

package/dist/lib/base-command.cjs

@@ -7,6 +7,7 @@ let _oclif_core = require("@oclif/core");
 let chalk = require("chalk");
 chalk = require_runtime.__toESM(chalk);
 let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_runtime.__toESM(_clack_prompts);
 //#region src/lib/base-command.ts
 var BaseCommand = class extends _oclif_core.Command {
 	static enableJsonFlag = true;
@@ -71,7 +72,7 @@ var BaseCommand = class extends _oclif_core.Command {
 			const result = require_auth_workspace_config.findWorkspace(workspaceFlagValue, require_auth_workspace_config.getWorkspaces());
 			if (result === null) this.error(`No workspace matching '${workspaceFlagValue}' found — run \`twentythree workspace list\` to see available workspaces`, { exit: 1 });
 			else if (Array.isArray(result)) {
-				const chosen = await (0, _clack_prompts.select)({
+				const chosen = await _clack_prompts.select({
 					message: `Multiple workspaces match '${workspaceFlagValue}'. Select one:`,
 					options: result.map((w) => ({
 						value: w.domain,
@@ -79,7 +80,9 @@ var BaseCommand = class extends _oclif_core.Command {
 					}))
 				});
 				if (typeof chosen === "symbol") this.error("Workspace selection cancelled", { exit: 1 });
-				resolved = require_auth_workspace_config.getWorkspaceForDomain(chosen);
+				const found = require_auth_workspace_config.getWorkspaceForDomain(chosen);
+				if (!found) this.error(`Workspace '${chosen}' could not be resolved — try running \`twentythree workspace list\``, { exit: 1 });
+				resolved = found;
 			} else resolved = result;
 		} else {
 			const activeDomain = require_auth_workspace_config.getActiveWorkspace();
@@ -100,6 +103,31 @@ var BaseCommand = class extends _oclif_core.Command {
 			token: this.activeWorkspace.bearer_token || void 0
 		});
 	}
+	async catch(err) {
+		if (!process.stdin.isTTY) return super.catch(err);
+		if (err.constructor.name !== "FailedFlagValidationError") return super.catch(err);
+		const flagNames = [...err.message.matchAll(/Missing required flag ([^\n]+)/g)].map((m) => m[1]);
+		if (flagNames.length === 0) return super.catch(err);
+		const inputFlags = err.parse?.input?.flags ?? {};
+		_clack_prompts.intro("Missing required input");
+		const extraArgv = [];
+		for (const flagName of flagNames) {
+			const flagDef = inputFlags[flagName];
+			const label = flagDef?.description ?? flagDef?.summary ?? flagName;
+			const value = await _clack_prompts.text({
+				message: label,
+				validate: (v) => !v || v.trim().length === 0 ? "Value is required" : void 0
+			});
+			if (_clack_prompts.isCancel(value)) {
+				_clack_prompts.cancel("Cancelled");
+				throw new _oclif_core.Errors.CLIError("Cancelled", { exit: 0 });
+			}
+			extraArgv.push(`--${flagName}`, value);
+		}
+		_clack_prompts.outro("Running command...");
+		const newArgv = [...this.argv ?? [], ...extraArgv];
+		await this.config.runCommand(this.id, newArgv);
+	}
 	/**
 	* Print the [domain] workspace header in dim style.
 	* Call at the top of every command's run() method (AUTH-04).

package/dist/lib/detect-shell.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/lib/detect-shell.ts
+/**
+* Detect shell from the $SHELL environment variable.
+* Returns 'zsh', 'bash', or null for unrecognized / unset shells.
+*/
+function detectShell(shellEnv) {
+	if (shellEnv.endsWith("zsh")) return "zsh";
+	if (shellEnv.endsWith("bash")) return "bash";
+	return null;
+}
+//#endregion
+exports.detectShell = detectShell;