nixelo 0.0.1

package/dist/commands/projects.js

@@ -0,0 +1,749 @@
+import { addProjectMember, createProject, deleteProject, getProject, getProjectStats, getWorkspace, listProjectMembers, listProjects, listProjectWorkflow, listWorkspaces, removeProjectMember, reorderProjectWorkflow, restoreProject, setProjectWorkflow, updateProject, updateProjectMemberRole } from "../lib/convex.js";
+import { parsePositiveIntegerOption, readOptionalText, readRequiredText } from "../lib/options.js";
+import { getActiveOutputFormat, printError, printJson, printOutput, printRows } from "../lib/output.js";
+import { canPrompt, promptText, requireConfirmation } from "../lib/prompt.js";
+import { resolveRequiredUserEmail } from "../lib/user-picker.js";
+import { addOutputOptions } from "./global.js";
+const PROJECT_CREATE_SELECTION_LIMIT = 100;
+const PROJECT_COLUMNS = [
+    { header: "key", value: project => project.key },
+    { header: "name", value: project => project.name },
+    { header: "description", value: project => project.description }
+];
+const PROJECT_WORKFLOW_COLUMNS = [
+    { header: "order", value: state => state.order },
+    { header: "id", value: state => state.id },
+    { header: "name", value: state => state.name },
+    { header: "category", value: state => state.category },
+    { header: "wipLimit", value: state => state.wipLimit }
+];
+const PROJECT_MEMBER_COLUMNS = [
+    { header: "userName", value: member => member.userName },
+    { header: "userEmail", value: member => member.userEmail },
+    { header: "role", value: member => member.role },
+    { header: "userId", value: member => member.userId },
+    { header: "createdAt", value: member => member.createdAt }
+];
+const PROJECT_DELETE_COLUMNS = [
+    { header: "key", value: project => project.key },
+    { header: "name", value: project => project.name },
+    { header: "deleted", value: project => project.deleted }
+];
+const PROJECT_RESTORE_COLUMNS = [
+    { header: "key", value: project => project.key },
+    { header: "name", value: project => project.name },
+    { header: "restored", value: project => project.restored }
+];
+const PROJECT_STATS_COLUMNS = [
+    { header: "category", value: row => row.category },
+    { header: "value", value: row => row.value },
+    { header: "count", value: row => row.count }
+];
+function readProjectRole(value) {
+    const role = readRequiredText(value, "Role", "--role");
+    if (role === "admin" || role === "member" || role === "viewer")
+        return role;
+    throw new Error("Role must be admin, member, or viewer.");
+}
+function readOptionalNonNegativeInteger(value, label, flag) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (Number.isInteger(parsed) && parsed >= 0)
+        return parsed;
+    throw new Error(`${label} must be a non-negative integer. Pass ${flag} <number>.`);
+}
+function readRequiredNonNegativeInteger(value, label, flag) {
+    const parsed = readOptionalNonNegativeInteger(readRequiredText(value, label, flag), label, flag);
+    if (parsed === undefined)
+        throw new Error(`${label} is required. Pass ${flag} <number>.`);
+    return parsed;
+}
+function readProjectWipEnforcement(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === "badge" || trimmed === "block")
+        return trimmed;
+    throw new Error("WIP enforcement must be badge or block.");
+}
+function readProjectBoardType(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === "kanban" || trimmed === "scrum")
+        return trimmed;
+    throw new Error("Board type must be kanban or scrum.");
+}
+function readProjectCreateVisibility(opts) {
+    if (opts.private && opts.public)
+        throw new Error("Pass either --private or --public, not both.");
+    if (opts.public)
+        return true;
+    if (opts.private)
+        return false;
+    return undefined;
+}
+async function resolvePromptedRequiredText(value, label, flag) {
+    const trimmed = value?.trim();
+    if (trimmed)
+        return trimmed;
+    if (canPrompt()) {
+        const prompted = await promptText(label);
+        if (prompted)
+            return prompted;
+    }
+    throw new Error(`${label} is required. Pass ${flag} <value>.`);
+}
+async function resolveProjectCreateWorkspaceSlug(explicitWorkspace) {
+    const trimmed = explicitWorkspace?.trim();
+    if (trimmed)
+        return trimmed;
+    if (!canPrompt())
+        throw new Error("Workspace slug is required. Pass --workspace <value>.");
+    const workspaces = await listWorkspaces({ limit: PROJECT_CREATE_SELECTION_LIMIT });
+    if (workspaces.length === 1) {
+        const workspace = workspaces[0];
+        if (!workspace)
+            throw new Error("Workspace slug is required. Pass --workspace <value>.");
+        printOutput(`Using workspace ${workspace.slug}: ${workspace.name}`);
+        return workspace.slug;
+    }
+    if (workspaces.length > 0) {
+        printOutput("Available workspaces:");
+        for (const workspace of workspaces)
+            printOutput(`  ${workspace.slug}  ${workspace.name}`);
+    }
+    const prompted = await promptText("Workspace slug");
+    if (prompted)
+        return prompted;
+    throw new Error("Workspace slug is required. Pass --workspace <value>.");
+}
+async function resolveProjectCreateTeamSlug(explicitTeam, workspaceSlug) {
+    const team = readOptionalText(explicitTeam, "Team slug", "--team");
+    if (team !== undefined)
+        return team;
+    if (!canPrompt())
+        return undefined;
+    const workspace = await getWorkspace(workspaceSlug, { limit: PROJECT_CREATE_SELECTION_LIMIT });
+    if (workspace?.teams && workspace.teams.length > 0) {
+        printOutput("Available teams:");
+        for (const availableTeam of workspace.teams) {
+            printOutput(`  ${availableTeam.slug}  ${availableTeam.name}`);
+        }
+    }
+    const prompted = await promptText("Team slug (optional)");
+    return prompted || undefined;
+}
+async function readProjectCreateInput(opts) {
+    const workspaceSlug = await resolveProjectCreateWorkspaceSlug(opts.workspace);
+    const teamSlug = await resolveProjectCreateTeamSlug(opts.team, workspaceSlug);
+    const input = {
+        workspaceSlug,
+        key: await resolvePromptedRequiredText(opts.key, "Project key", "--key"),
+        name: await resolvePromptedRequiredText(opts.name, "Project name", "--name")
+    };
+    const boardType = readProjectBoardType(opts.boardType);
+    if (boardType !== undefined)
+        input.boardType = boardType;
+    const description = readOptionalText(opts.description, "Project description", "--description");
+    if (description !== undefined)
+        input.description = description;
+    if (teamSlug !== undefined)
+        input.teamSlug = teamSlug;
+    const isPublic = readProjectCreateVisibility(opts);
+    if (isPublic !== undefined)
+        input.isPublic = isPublic;
+    return input;
+}
+function readProjectUpdateInput(opts) {
+    if (opts.private && opts.public)
+        throw new Error("Pass either --private or --public, not both.");
+    const input = {};
+    const name = readOptionalText(opts.name, "Project name", "--name");
+    if (name !== undefined)
+        input.name = name;
+    const description = readOptionalText(opts.description, "Project description", "--description");
+    if (description !== undefined)
+        input.description = description;
+    if (opts.public)
+        input.isPublic = true;
+    if (opts.private)
+        input.isPublic = false;
+    const autoArchiveDays = readOptionalNonNegativeInteger(opts.autoArchiveDays, "Auto archive days", "--auto-archive-days");
+    if (autoArchiveDays !== undefined)
+        input.autoArchiveDays = autoArchiveDays;
+    const wipEnforcement = readProjectWipEnforcement(opts.wipEnforcement);
+    if (wipEnforcement !== undefined)
+        input.wipEnforcement = wipEnforcement;
+    if (Object.keys(input).length === 0)
+        throw new Error("At least one update flag is required.");
+    return input;
+}
+function isWorkflowCategory(value) {
+    return value === "todo" || value === "inprogress" || value === "done";
+}
+function readWorkflowStateEntry(entry, index) {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+        throw new Error(`Workflow state ${index} must be an object.`);
+    }
+    const state = entry;
+    if (typeof state.id !== "string" || state.id.trim() === "") {
+        throw new Error(`Workflow state ${index} requires a non-empty id.`);
+    }
+    if (typeof state.name !== "string" || state.name.trim() === "") {
+        throw new Error(`Workflow state ${index} requires a non-empty name.`);
+    }
+    if (!isWorkflowCategory(state.category)) {
+        throw new Error(`Workflow state ${index} category must be todo, inprogress, or done.`);
+    }
+    if (typeof state.order !== "number" || !Number.isFinite(state.order)) {
+        throw new Error(`Workflow state ${index} order must be a number.`);
+    }
+    if (state.wipLimit !== undefined &&
+        (typeof state.wipLimit !== "number" || !Number.isFinite(state.wipLimit))) {
+        throw new Error(`Workflow state ${index} wipLimit must be a number.`);
+    }
+    const workflowState = {
+        id: state.id,
+        name: state.name,
+        category: state.category,
+        order: state.order
+    };
+    if (state.wipLimit !== undefined)
+        workflowState.wipLimit = state.wipLimit;
+    return workflowState;
+}
+function readWorkflowStatesJson(value) {
+    const raw = readRequiredText(value, "Workflow states", "--states");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("Workflow states must be valid JSON.");
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new Error("Workflow states must be a non-empty JSON array.");
+    }
+    return parsed.map((entry, index) => readWorkflowStateEntry(entry, index));
+}
+function readProjectWorkflowSetInput(opts) {
+    const input = { workflowStates: readWorkflowStatesJson(opts.states) };
+    const wipEnforcement = readProjectWipEnforcement(opts.wipEnforcement);
+    if (wipEnforcement !== undefined)
+        input.wipEnforcement = wipEnforcement;
+    return input;
+}
+function printEmptyProjectList(format) {
+    if (format === "json") {
+        printJson([]);
+        return;
+    }
+    if (format === "csv") {
+        printRows([], PROJECT_COLUMNS, format);
+        return;
+    }
+    printOutput("No projects found.");
+}
+function printProjectList(projects) {
+    const format = getActiveOutputFormat();
+    if (projects.length === 0) {
+        printEmptyProjectList(format);
+        return;
+    }
+    if (format !== "table") {
+        printRows(projects, PROJECT_COLUMNS, format);
+        return;
+    }
+    for (const p of projects)
+        printOutput(`  ${p.key}  ${p.name}`);
+}
+function printMissingProject(key, format) {
+    if (format === "json") {
+        printJson(null);
+        return;
+    }
+    if (format === "csv") {
+        printRows([], PROJECT_COLUMNS, format);
+        return;
+    }
+    printOutput(`Project ${key} not found.`);
+}
+function printMissingProjectRows(key, format, columns) {
+    if (format === "json") {
+        printJson(null);
+        return;
+    }
+    if (format === "csv") {
+        printRows([], columns, format);
+        return;
+    }
+    printOutput(`Project ${key} not found.`);
+}
+function printProjectWorkflowSection(states) {
+    if (!states || states.length === 0)
+        return;
+    printOutput("Workflow:");
+    for (const state of states) {
+        const wip = state.wipLimit === undefined ? "" : ` wip:${state.wipLimit}`;
+        printOutput(`  ${state.order}. ${state.name} [${state.category}] ${state.id}${wip}`);
+    }
+}
+function printProjectMembersSection(members) {
+    if (!members || members.length === 0)
+        return;
+    printOutput("Members:");
+    for (const member of members) {
+        const email = member.userEmail ? ` <${member.userEmail}>` : "";
+        printOutput(`  ${member.userName}${email} [${member.role}]`);
+    }
+}
+function printProjectView(detail, key) {
+    const format = getActiveOutputFormat();
+    if (!detail) {
+        printMissingProject(key, format);
+        return;
+    }
+    if (format === "json") {
+        printJson(detail);
+        return;
+    }
+    if (format === "csv") {
+        printRows([detail.project], PROJECT_COLUMNS, format);
+        return;
+    }
+    const { project } = detail;
+    printOutput(`${project.key}  ${project.name}`);
+    if (project.description)
+        printOutput(project.description);
+    printProjectWorkflowSection(detail.workflow);
+    printProjectMembersSection(detail.members);
+    printProjectStatsSummary(detail.stats);
+}
+function printProjectMutationResult(project, key, action) {
+    const format = getActiveOutputFormat();
+    if (!project) {
+        if (action === "Created" && format === "table") {
+            printOutput(`Workspace or team for project ${key} not found.`);
+            return;
+        }
+        printMissingProject(key, format);
+        return;
+    }
+    if (format === "json") {
+        printJson(project);
+        return;
+    }
+    if (format === "csv") {
+        printRows([project], PROJECT_COLUMNS, format);
+        return;
+    }
+    printOutput(`${action} project ${project.key}: ${project.name}`);
+}
+function printProjectDeleteResult(result, key) {
+    const format = getActiveOutputFormat();
+    if (!result) {
+        if (format === "json") {
+            printJson(null);
+            return;
+        }
+        if (format === "csv") {
+            printRows([], PROJECT_DELETE_COLUMNS, format);
+            return;
+        }
+        printOutput(`Project ${key} not found.`);
+        return;
+    }
+    if (format === "json") {
+        printJson(result);
+        return;
+    }
+    if (format === "csv") {
+        printRows([result], PROJECT_DELETE_COLUMNS, format);
+        return;
+    }
+    printOutput(`Deleted project ${result.key}: ${result.name}`);
+}
+function printProjectRestoreResult(result, key) {
+    const format = getActiveOutputFormat();
+    if (!result) {
+        if (format === "json") {
+            printJson(null);
+            return;
+        }
+        if (format === "csv") {
+            printRows([], PROJECT_RESTORE_COLUMNS, format);
+            return;
+        }
+        printOutput(`Project ${key} not found.`);
+        return;
+    }
+    if (format === "json") {
+        printJson(result);
+        return;
+    }
+    if (format === "csv") {
+        printRows([result], PROJECT_RESTORE_COLUMNS, format);
+        return;
+    }
+    printOutput(`Restored project ${result.key}: ${result.name}`);
+}
+function printProjectWorkflowResult(states, key) {
+    const format = getActiveOutputFormat();
+    if (!states) {
+        printMissingProjectRows(key, format, PROJECT_WORKFLOW_COLUMNS);
+        return;
+    }
+    if (states.length === 0) {
+        if (format === "json") {
+            printJson([]);
+            return;
+        }
+        if (format === "csv") {
+            printRows(states, PROJECT_WORKFLOW_COLUMNS, format);
+            return;
+        }
+        printOutput("No workflow states found.");
+        return;
+    }
+    if (format !== "table") {
+        printRows(states, PROJECT_WORKFLOW_COLUMNS, format);
+        return;
+    }
+    for (const state of states) {
+        const wip = state.wipLimit === undefined ? "" : ` wip:${state.wipLimit}`;
+        printOutput(`  ${state.order}. ${state.name} [${state.category}] ${state.id}${wip}`);
+    }
+}
+function printProjectMembersResult(members, key) {
+    const format = getActiveOutputFormat();
+    if (!members) {
+        printMissingProjectRows(key, format, PROJECT_MEMBER_COLUMNS);
+        return;
+    }
+    if (members.length === 0) {
+        if (format === "json") {
+            printJson([]);
+            return;
+        }
+        if (format === "csv") {
+            printRows(members, PROJECT_MEMBER_COLUMNS, format);
+            return;
+        }
+        printOutput("No project members found.");
+        return;
+    }
+    if (format !== "table") {
+        printRows(members, PROJECT_MEMBER_COLUMNS, format);
+        return;
+    }
+    for (const member of members) {
+        const email = member.userEmail ? ` <${member.userEmail}>` : "";
+        printOutput(`  ${member.userName}${email} [${member.role}]`);
+    }
+}
+function printProjectMemberMutationResult(result, key, action) {
+    const format = getActiveOutputFormat();
+    if (!result) {
+        printMissingProjectRows(key, format, PROJECT_MEMBER_COLUMNS);
+        return;
+    }
+    if (format === "json") {
+        printJson(result);
+        return;
+    }
+    if (format === "csv") {
+        printRows([result], PROJECT_MEMBER_COLUMNS, format);
+        return;
+    }
+    const email = result.userEmail ? ` <${result.userEmail}>` : "";
+    const suffix = action === "Removed" ? ` from ${result.projectKey}` : ` in ${result.projectKey}`;
+    printOutput(`${action} ${result.userName}${email}${suffix} [${result.role}]`);
+}
+function flattenStatsBucket(category, bucket) {
+    return bucket.map(entry => ({ category, value: entry.value, count: entry.count }));
+}
+function flattenProjectStats(stats) {
+    return [
+        ...flattenStatsBucket("status", stats.byStatus),
+        ...flattenStatsBucket("priority", stats.byPriority),
+        ...flattenStatsBucket("type", stats.byType),
+        ...flattenStatsBucket("assignee", stats.byAssignee)
+    ];
+}
+function printStatsBucket(label, bucket, prefix = "") {
+    printOutput(`${prefix}${label}:`);
+    for (const entry of bucket) {
+        printOutput(`${prefix}  ${entry.value}: ${entry.count}`);
+    }
+}
+function printProjectStatsSummary(stats) {
+    if (!stats)
+        return;
+    const truncated = stats.truncated ? " (truncated)" : "";
+    printOutput("Stats:");
+    printOutput(`  Total issues: ${stats.totalIssues}${truncated}`);
+    printStatsBucket("Status", stats.byStatus, "  ");
+    printStatsBucket("Priority", stats.byPriority, "  ");
+    printStatsBucket("Type", stats.byType, "  ");
+    printStatsBucket("Assignee", stats.byAssignee, "  ");
+}
+export function printProjectStatsResult(stats, key) {
+    const format = getActiveOutputFormat();
+    if (!stats) {
+        printMissingProjectRows(key, format, PROJECT_STATS_COLUMNS);
+        return;
+    }
+    if (format === "json") {
+        printJson(stats);
+        return;
+    }
+    if (format === "csv") {
+        printRows(flattenProjectStats(stats), PROJECT_STATS_COLUMNS, format);
+        return;
+    }
+    const truncated = stats.truncated ? " (truncated)" : "";
+    printOutput(`${stats.key}  ${stats.name}`);
+    printOutput(`Total issues: ${stats.totalIssues}${truncated}`);
+    printStatsBucket("Status", stats.byStatus);
+    printStatsBucket("Priority", stats.byPriority);
+    printStatsBucket("Type", stats.byType);
+    printStatsBucket("Assignee", stats.byAssignee);
+}
+export function registerProjectsCommands(program) {
+    const projectsCmd = program.command("projects").description("Manage projects");
+    addOutputOptions(projectsCmd.command("list").description("List projects")).action(async () => {
+        try {
+            printProjectList(await listProjects());
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd
+        .command("view")
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("-n, --limit <number>", "Max members to show", "20")
+        .description("View project details")).action(async (key, opts) => {
+        try {
+            const project = await getProject(key);
+            if (!project) {
+                printProjectView(null, key);
+                return;
+            }
+            const memberLimit = parsePositiveIntegerOption(opts.limit);
+            const [workflow, members, stats] = await Promise.all([
+                listProjectWorkflow(key),
+                listProjectMembers(key, { limit: memberLimit }),
+                getProjectStats(key)
+            ]);
+            printProjectView({ members, project, stats, workflow }, key);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd.command("create"))
+        .option("--workspace <slug>", "Workspace slug")
+        .option("--team <slug>", "Team slug")
+        .option("--key <key>", "Project key")
+        .option("--name <name>", "Project name")
+        .option("--description <description>", "Project description")
+        .option("--board-type <type>", "Board type: kanban or scrum")
+        .option("--public", "Make project visible to organization members")
+        .option("--private", "Make project private")
+        .description("Create a project")
+        .action(async (opts) => {
+        try {
+            const input = await readProjectCreateInput(opts);
+            printProjectMutationResult(await createProject(input), input.key, "Created");
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd.command("update"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("--name <name>", "Project name")
+        .option("--description <description>", "Project description")
+        .option("--public", "Make project visible to organization members")
+        .option("--private", "Make project private")
+        .option("--auto-archive-days <number>", "Auto-archive completed issues after N days; 0 disables")
+        .option("--wip-enforcement <mode>", "WIP enforcement: badge or block")
+        .description("Update project settings")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectMutationResult(await updateProject(projectKey, readProjectUpdateInput(opts)), projectKey, "Updated");
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd.command("delete"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("-y, --yes", "Confirm project deletion")
+        .description("Delete a project")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            await requireConfirmation(`Delete project ${projectKey}?`, opts.yes === true);
+            printProjectDeleteResult(await deleteProject(projectKey), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd.command("restore"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .description("Restore a deleted project")
+        .action(async (key) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectRestoreResult(await restoreProject(projectKey), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    const workflowCmd = projectsCmd
+        .command("workflow")
+        .argument("[key]", "Project key (e.g. ENG)")
+        .description("Show or manage project workflow states");
+    addOutputOptions(workflowCmd).action(async (key) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectWorkflowResult(await listProjectWorkflow(projectKey), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(workflowCmd.command("set"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .requiredOption("--states <json>", "Workflow states JSON array")
+        .option("--wip-enforcement <mode>", "WIP enforcement: badge or block")
+        .description("Replace project workflow states")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectWorkflowResult(await setProjectWorkflow(projectKey, readProjectWorkflowSetInput(opts)), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(workflowCmd.command("reorder"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .requiredOption("--id <stateId>", "Workflow state id to move")
+        .requiredOption("--position <number>", "Zero-based target position")
+        .description("Move a workflow state to a new position")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectWorkflowResult(await reorderProjectWorkflow(projectKey, {
+                stateId: readRequiredText(opts.id, "Workflow state id", "--id"),
+                position: readRequiredNonNegativeInteger(opts.position, "Position", "--position")
+            }), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    const membersCmd = projectsCmd
+        .command("members")
+        .argument("[key]", "Project key (e.g. ENG)")
+        .option("-n, --limit <number>", "Max members", "20")
+        .description("List or manage project members");
+    addOutputOptions(membersCmd).action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectMembersResult(await listProjectMembers(projectKey, { limit: parsePositiveIntegerOption(opts.limit) }), projectKey);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(membersCmd.command("add"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("--email <email>", "Member email; prompts when omitted")
+        .requiredOption("--role <role>", "Member role: admin, member, or viewer")
+        .description("Add a project member")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectMemberMutationResult(await addProjectMember({
+                projectKey,
+                email: await resolveRequiredUserEmail(opts.email),
+                role: readProjectRole(opts.role)
+            }), projectKey, "Added");
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(membersCmd.command("remove"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("--email <email>", "Member email; prompts when omitted")
+        .option("-y, --yes", "Confirm project member removal")
+        .description("Remove a project member")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            const email = await resolveRequiredUserEmail(opts.email);
+            await requireConfirmation(`Remove ${email} from project ${projectKey}?`, opts.yes === true);
+            printProjectMemberMutationResult(await removeProjectMember({
+                projectKey,
+                email
+            }), projectKey, "Removed");
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(membersCmd.command("role"))
+        .argument("<key>", "Project key (e.g. ENG)")
+        .option("--email <email>", "Member email; prompts when omitted")
+        .requiredOption("--role <role>", "Member role: admin, member, or viewer")
+        .description("Update a project member role")
+        .action(async (key, opts) => {
+        try {
+            const projectKey = readRequiredText(key, "Project key", "<key>");
+            printProjectMemberMutationResult(await updateProjectMemberRole({
+                projectKey,
+                email: await resolveRequiredUserEmail(opts.email),
+                role: readProjectRole(opts.role)
+            }), projectKey, "Updated");
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    addOutputOptions(projectsCmd
+        .command("stats")
+        .argument("<key>", "Project key (e.g. ENG)")
+        .description("Show project issue stats")).action(async (key) => {
+        try {
+            printProjectStatsResult(await getProjectStats(key), key);
+        }
+        catch (error) {
+            printError("Failed:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map