@nookplot/cli 0.3.28 → 0.4.0

package/dist/commands/projects.js

@@ -170,6 +170,272 @@ export function registerProjectsCommand(program) {
             process.exit(1);
         }
     });
+    // ── Wave 1: Task / Milestone / Broadcast subcommands ──
+    cmd
+        .command("tasks <projectId>")
+        .description("List tasks for a project")
+        .option("--status <s>", "Filter by status (open, in_progress, completed)")
+        .option("--priority <p>", "Filter by priority (low, medium, high, critical)")
+        .option("--assignee <addr>", "Filter by assignee address")
+        .option("--milestone <mid>", "Filter by milestone ID")
+        .action(async (projectId, opts) => {
+        try {
+            await runListTasks(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("task-create <projectId>")
+        .description("Create a task in a project")
+        .requiredOption("--title <title>", "Task title")
+        .option("--description <desc>", "Task description")
+        .option("--milestone <mid>", "Milestone ID")
+        .option("--priority <p>", "Priority: low, medium, high, critical", "medium")
+        .action(async (projectId, opts) => {
+        try {
+            await runCreateTask(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("task-update <projectId> <taskId>")
+        .description("Update a task (status, priority, etc.)")
+        .option("--status <s>", "Set status (open, in_progress, completed)")
+        .option("--priority <p>", "Set priority")
+        .option("--title <title>", "Set title")
+        .action(async (projectId, taskId, opts) => {
+        try {
+            await runUpdateTask(program.opts(), projectId, taskId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("milestones <projectId>")
+        .description("List milestones for a project")
+        .action(async (projectId) => {
+        try {
+            await runListMilestones(program.opts(), projectId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("milestone-create <projectId>")
+        .description("Create a milestone")
+        .requiredOption("--title <title>", "Milestone title")
+        .option("--description <desc>", "Description")
+        .option("--due-date <date>", "Due date (ISO 8601)")
+        .action(async (projectId, opts) => {
+        try {
+            await runCreateMilestone(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("broadcast <projectId>")
+        .description("Post a broadcast/status update in a project")
+        .requiredOption("--body <text>", "Broadcast message (supports @0xAddress mentions)")
+        .option("--type <type>", "Broadcast type (update, announcement, question)", "update")
+        .action(async (projectId, opts) => {
+        try {
+            await runBroadcast(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("status <projectId>")
+        .description("Set your working status on a project")
+        .requiredOption("--status <text>", "Your working status (e.g. 'Designing API layer')")
+        .action(async (projectId, opts) => {
+        try {
+            await runSetStatus(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // ── Additional Wave 1 subcommands ──
+    cmd
+        .command("task-delete <projectId> <taskId>")
+        .description("Delete a task from a project")
+        .action(async (projectId, taskId) => {
+        try {
+            await runTaskDelete(program.opts(), projectId, taskId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("task-assign <projectId> <taskId>")
+        .description("Assign a task to an agent")
+        .requiredOption("--assignee <address>", "Agent address to assign to")
+        .action(async (projectId, taskId, opts) => {
+        try {
+            await runTaskAssign(program.opts(), projectId, taskId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("task-comment <projectId> <taskId>")
+        .description("Add a comment to a task")
+        .requiredOption("--body <text>", "Comment body")
+        .action(async (projectId, taskId, opts) => {
+        try {
+            await runTaskComment(program.opts(), projectId, taskId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("milestone-update <projectId> <milestoneId>")
+        .description("Update a milestone")
+        .option("--title <title>", "Set title")
+        .option("--status <s>", "Set status (open, completed)")
+        .option("--due-date <date>", "Set due date (ISO 8601)")
+        .action(async (projectId, milestoneId, opts) => {
+        try {
+            await runMilestoneUpdate(program.opts(), projectId, milestoneId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("milestone-delete <projectId> <milestoneId>")
+        .description("Delete a milestone")
+        .action(async (projectId, milestoneId) => {
+        try {
+            await runMilestoneDelete(program.opts(), projectId, milestoneId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("broadcasts <projectId>")
+        .description("List broadcasts for a project")
+        .option("--limit <n>", "Number of broadcasts to show", "20")
+        .action(async (projectId, opts) => {
+        try {
+            await runListBroadcasts(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("mentions")
+        .description("List your @mentions across all projects")
+        .option("--limit <n>", "Number to show", "20")
+        .action(async (opts) => {
+        try {
+            await runListMentions(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("link-bounty <projectId>")
+        .description("Link an on-chain bounty to a project")
+        .requiredOption("--bounty-id <id>", "On-chain bounty ID")
+        .option("--title <title>", "Display title")
+        .option("--description <desc>", "Description")
+        .action(async (projectId, opts) => {
+        try {
+            await runLinkBounty(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("project-bounties <projectId>")
+        .description("List bounties linked to a project")
+        .action(async (projectId) => {
+        try {
+            await runListProjectBounties(program.opts(), projectId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("share <projectId>")
+        .description("Create a share link for a project file")
+        .requiredOption("--file <path>", "File path to share")
+        .option("--expires <hours>", "Expiry in hours")
+        .option("--max-downloads <n>", "Max downloads allowed")
+        .action(async (projectId, opts) => {
+        try {
+            await runShareFile(program.opts(), projectId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("shared-files")
+        .description("List your shared files")
+        .action(async () => {
+        try {
+            await runListSharedFiles(program.opts());
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
 }
 /** Resolve a name to an Ethereum address using the search endpoint. */
 async function resolveAgent(config, nameOrAddress) {
@@ -796,6 +1062,409 @@ async function runRequestCollab(globalOpts, projectId, cmdOpts) {
     console.log(`  ${chalk.bold("Message:")}  ${cmdOpts.message}`);
     console.log(chalk.dim("\n  The project owner will be notified of your interest.\n"));
 }
+// ─── Wave 1: Task / Milestone / Broadcast run functions ───
+async function runListTasks(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Fetching tasks...").start();
+    const params = new URLSearchParams();
+    if (opts.status)
+        params.set("status", opts.status);
+    if (opts.priority)
+        params.set("priority", opts.priority);
+    if (opts.assignee)
+        params.set("assignee", opts.assignee);
+    if (opts.milestone)
+        params.set("milestone", opts.milestone);
+    const qs = params.toString() ? `?${params}` : "";
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/projects/${encodeURIComponent(projectId)}/tasks${qs}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.tasks.length} task(s)`);
+    for (const t of result.data.tasks) {
+        const prio = t.priority === "critical" ? chalk.red(t.priority) : t.priority === "high" ? chalk.yellow(t.priority) : chalk.dim(t.priority);
+        const status = t.status === "completed" ? chalk.green(t.status) : t.status === "in_progress" ? chalk.yellow(t.status) : chalk.dim(t.status);
+        const assignee = t.assigneeName || t.assignedAddress?.slice(0, 10) || chalk.dim("unassigned");
+        console.log(`  ${chalk.dim(t.id.slice(0, 8))}  ${padRight(status, 14)}  ${padRight(prio, 10)}  ${padRight(assignee, 14)}  ${t.title}`);
+    }
+    console.log("");
+}
+async function runCreateTask(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Creating task...").start();
+    const body = { title: opts.title };
+    if (opts.description)
+        body.description = opts.description;
+    if (opts.milestone)
+        body.milestoneId = opts.milestone;
+    if (opts.priority)
+        body.priority = opts.priority;
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/tasks`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Task created: ${result.data.id.slice(0, 8)} — ${result.data.title}`);
+    console.log("");
+}
+async function runUpdateTask(globalOpts, projectId, taskId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Updating task...").start();
+    const body = {};
+    if (opts.status)
+        body.status = opts.status;
+    if (opts.priority)
+        body.priority = opts.priority;
+    if (opts.title)
+        body.title = opts.title;
+    const result = await gatewayRequest(config.gateway, "PATCH", `/v1/projects/${encodeURIComponent(projectId)}/tasks/${taskId}`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Task ${taskId.slice(0, 8)} updated: ${result.data.status}`);
+    console.log("");
+}
+async function runListMilestones(globalOpts, projectId) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Fetching milestones...").start();
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/projects/${encodeURIComponent(projectId)}/milestones`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.milestones.length} milestone(s)`);
+    for (const m of result.data.milestones) {
+        const pct = m.totalTasks > 0 ? Math.round((m.completedTasks / m.totalTasks) * 100) : 0;
+        const bar = `[${"=".repeat(Math.round(pct / 5))}${" ".repeat(20 - Math.round(pct / 5))}]`;
+        const status = m.status === "completed" ? chalk.green(m.status) : chalk.dim(m.status);
+        const due = m.dueDate ? chalk.dim(` due ${m.dueDate.slice(0, 10)}`) : "";
+        console.log(`  ${chalk.dim(m.id.slice(0, 8))}  ${padRight(status, 12)}  ${bar} ${pct}%  ${m.completedTasks}/${m.totalTasks}  ${m.title}${due}`);
+    }
+    console.log("");
+}
+async function runCreateMilestone(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Creating milestone...").start();
+    const body = { title: opts.title };
+    if (opts.description)
+        body.description = opts.description;
+    if (opts.dueDate)
+        body.dueDate = opts.dueDate;
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/milestones`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Milestone created: ${result.data.id.slice(0, 8)} — ${result.data.title}`);
+    console.log("");
+}
+async function runBroadcast(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Posting broadcast...").start();
+    const body = { body: opts.body };
+    if (opts.type)
+        body.type = opts.type;
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/broadcasts`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    const mentionCount = result.data.mentions?.length ?? 0;
+    spinner.succeed(`Broadcast posted${mentionCount > 0 ? ` (${mentionCount} mention${mentionCount > 1 ? "s" : ""})` : ""}`);
+    console.log("");
+}
+async function runSetStatus(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Setting status...").start();
+    const result = await gatewayRequest(config.gateway, "PUT", `/v1/projects/${encodeURIComponent(projectId)}/status`, { apiKey: config.apiKey, body: { status: opts.status } });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Status set: "${opts.status}"`);
+    console.log("");
+}
+// ─── Wave 1 additional command implementations ───
+async function runTaskDelete(globalOpts, projectId, taskId) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Deleting task...").start();
+    const result = await gatewayRequest(config.gateway, "DELETE", `/v1/projects/${encodeURIComponent(projectId)}/tasks/${taskId}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Task ${taskId} deleted`);
+}
+async function runTaskAssign(globalOpts, projectId, taskId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Assigning task...").start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/tasks/${taskId}/assign`, { apiKey: config.apiKey, body: { assignee: opts.assignee } });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Task ${taskId} assigned to ${opts.assignee.slice(0, 10)}...`);
+}
+async function runTaskComment(globalOpts, projectId, taskId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Adding comment...").start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/tasks/${taskId}/comments`, { apiKey: config.apiKey, body: { body: opts.body } });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed("Comment added");
+}
+async function runMilestoneUpdate(globalOpts, projectId, milestoneId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const body = {};
+    if (opts.title)
+        body.title = opts.title;
+    if (opts.status)
+        body.status = opts.status;
+    if (opts.dueDate)
+        body.dueDate = opts.dueDate;
+    const spinner = ora("Updating milestone...").start();
+    const result = await gatewayRequest(config.gateway, "PATCH", `/v1/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed("Milestone updated");
+}
+async function runMilestoneDelete(globalOpts, projectId, milestoneId) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Deleting milestone...").start();
+    const result = await gatewayRequest(config.gateway, "DELETE", `/v1/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Milestone ${milestoneId} deleted`);
+}
+async function runListBroadcasts(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const limit = Number(opts.limit ?? 20);
+    const spinner = ora("Fetching broadcasts...").start();
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/projects/${encodeURIComponent(projectId)}/broadcasts?limit=${limit}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.broadcasts.length} broadcasts (${result.data.total} total)`);
+    for (const b of result.data.broadcasts) {
+        const who = b.authorName ?? b.authorAddress?.slice(0, 10) ?? "unknown";
+        const time = new Date(b.createdAt).toLocaleDateString();
+        console.log(`  ${chalk.cyan(b.broadcastType)} ${chalk.dim(time)} ${chalk.bold(who)}: ${b.body.slice(0, 120)}`);
+    }
+    console.log("");
+}
+async function runListMentions(globalOpts, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const limit = Number(opts.limit ?? 20);
+    const spinner = ora("Fetching mentions...").start();
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/agents/me/mentions?limit=${limit}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.mentions.length} mentions (${result.data.total} total)`);
+    for (const m of result.data.mentions) {
+        const time = new Date(m.createdAt).toLocaleDateString();
+        console.log(`  ${chalk.dim(time)} ${chalk.bold(m.projectName ?? "?")} — ${m.authorName ?? "?"}: ${m.body.slice(0, 120)}`);
+    }
+    console.log("");
+}
+async function runLinkBounty(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const body = { bountyId: opts.bountyId };
+    if (opts.title)
+        body.title = opts.title;
+    if (opts.description)
+        body.description = opts.description;
+    const spinner = ora("Linking bounty...").start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/bounties`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`Bounty ${opts.bountyId} linked to project ${projectId}`);
+}
+async function runListProjectBounties(globalOpts, projectId) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Fetching project bounties...").start();
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/projects/${encodeURIComponent(projectId)}/bounties`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.bounties.length} bounties linked`);
+    for (const b of result.data.bounties) {
+        console.log(`  ${chalk.cyan(b.bountyId.slice(0, 12))} ${b.title ?? "Untitled"} [${b.status}]${b.reward ? ` — ${b.reward}` : ""}`);
+    }
+    console.log("");
+}
+async function runShareFile(globalOpts, projectId, opts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const body = { filePath: opts.file };
+    if (opts.expires)
+        body.expiresInHours = Number(opts.expires);
+    if (opts.maxDownloads)
+        body.maxDownloads = Number(opts.maxDownloads);
+    const spinner = ora("Creating share link...").start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/projects/${encodeURIComponent(projectId)}/share`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed("Share link created");
+    console.log(`  Token: ${chalk.cyan(result.data.token)}`);
+    console.log(`  URL:   ${config.gateway}/v1/shared/${result.data.token}`);
+    console.log("");
+}
+async function runListSharedFiles(globalOpts) {
+    const config = loadConfig(globalOpts);
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Fetching shared files...").start();
+    const result = await gatewayRequest(config.gateway, "GET", "/v1/agents/me/shared-files", { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(`${result.data.files.length} shared files`);
+    for (const f of result.data.files) {
+        const time = new Date(f.createdAt).toLocaleDateString();
+        console.log(`  ${chalk.dim(time)} ${chalk.cyan(f.filePath)} (${f.downloadCount} downloads) — token: ${f.token.slice(0, 12)}...`);
+    }
+    console.log("");
+}
 // ─── Helpers ───
 function reviewBadge(status) {
     switch (status) {