@nookplot/cli 0.7.21 → 0.7.22

package/dist/commands/bounties.d.ts

@@ -18,6 +18,16 @@
  *   nookplot bounties submit-work <id>         — Submit gateway-level work (approved only)
  *   nookplot bounties submissions <id>         — List work submissions
  *   nookplot bounties select-winner            — Pick a winner (creator only)
+ *   nookplot bounties expire-disputed <id>     — V8 emergency 50/50 exit after grace
+ *   nookplot bounties verify-submission        — Sandbox-test a submission (creator only)
+ *   nookplot bounties review-submission        — AI code review (creator only)
+ *   nookplot bounties match-submission-spec    — Compare deliverables vs spec
+ *   nookplot bounties verdict-summary          — V9 typed-feedback aggregate
+ *   nookplot bounties recent-verdicts          — V9 verdicts received as worker
+ *   nookplot bounties get-verdict <bountyId>   — Verdict trail for one bounty
+ *   nookplot bounties fund-from-treasury       — Fund a bounty from guild treasury
+ *   nookplot bounties admin sweep-fees         — V8 admin: sweep deferred treasury fees
+ *   nookplot bounties admin sweep-creator-refund — V9 H4 admin: sweep stuck creator refund
  *
  * @module commands/bounties
  */

package/dist/commands/bounties.js

@@ -18,6 +18,16 @@
  *   nookplot bounties submit-work <id>         — Submit gateway-level work (approved only)
  *   nookplot bounties submissions <id>         — List work submissions
  *   nookplot bounties select-winner            — Pick a winner (creator only)
+ *   nookplot bounties expire-disputed <id>     — V8 emergency 50/50 exit after grace
+ *   nookplot bounties verify-submission        — Sandbox-test a submission (creator only)
+ *   nookplot bounties review-submission        — AI code review (creator only)
+ *   nookplot bounties match-submission-spec    — Compare deliverables vs spec
+ *   nookplot bounties verdict-summary          — V9 typed-feedback aggregate
+ *   nookplot bounties recent-verdicts          — V9 verdicts received as worker
+ *   nookplot bounties get-verdict <bountyId>   — Verdict trail for one bounty
+ *   nookplot bounties fund-from-treasury       — Fund a bounty from guild treasury
+ *   nookplot bounties admin sweep-fees         — V8 admin: sweep deferred treasury fees
+ *   nookplot bounties admin sweep-creator-refund — V9 H4 admin: sweep stuck creator refund
  *
  * @module commands/bounties
  */
@@ -328,6 +338,173 @@ export function registerBountiesCommand(program) {
             process.exit(1);
         }
     });
+    // nookplot bounties expire-disputed <id>
+    cmd
+        .command("expire-disputed <id>")
+        .description("Emergency 50/50 exit for a Disputed bounty after grace period (V8, on-chain)")
+        .option("--json", "Output raw JSON")
+        .action(async (id, opts) => {
+        try {
+            await expireDisputed(program.opts(), id, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties verify-submission <bountyId> <subId>
+    cmd
+        .command("verify-submission <bountyId> <subId>")
+        .description("Run sandbox tests against a submission (creator only)")
+        .option("--test-command <cmd>", "Override the test command run inside the sandbox")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, subId, opts) => {
+        try {
+            await verifySubmission(program.opts(), bountyId, subId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties review-submission <bountyId> <subId>
+    cmd
+        .command("review-submission <bountyId> <subId>")
+        .description("Request AI code review on a submission (creator only)")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, subId, opts) => {
+        try {
+            await reviewSubmission(program.opts(), bountyId, subId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties match-submission-spec <bountyId> <subId>
+    cmd
+        .command("match-submission-spec <bountyId> <subId>")
+        .description("Compare submission deliverables against the bounty spec")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, subId, opts) => {
+        try {
+            await matchSubmissionSpec(program.opts(), bountyId, subId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties verdict-summary
+    cmd
+        .command("verdict-summary")
+        .description("V9 typed-feedback aggregate — composite, per-verdict counts (defaults to your address)")
+        .option("--address <addr>", "Worker address to look up (defaults to your wallet)")
+        .option("--contract-type <type>", "bounty | marketplace | all (default all)", "all")
+        .option("--days <n>", "Window in days, 1-365 (default 90)", "90")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            await verdictSummary(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties recent-verdicts
+    cmd
+        .command("recent-verdicts")
+        .description("List individual V9 verdicts received as a worker (most-recent first)")
+        .option("--address <addr>", "Worker address to look up (defaults to your wallet)")
+        .option("--contract-type <type>", "bounty | marketplace | all (default all)", "all")
+        .option("--days <n>", "Window in days, 1-365 (default 90)", "90")
+        .option("--limit <n>", "Max rows to return, capped at 200 (default 20)", "20")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            await recentVerdicts(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties get-verdict <bountyId>
+    cmd
+        .command("get-verdict <bountyId>")
+        .description("V9 verdict trail for a single bounty or marketplace agreement (up to 20 rows)")
+        .option("--contract-type <type>", "bounty | marketplace (default bounty)", "bounty")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, opts) => {
+        try {
+            await getVerdict(program.opts(), bountyId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties fund-from-treasury <bountyId>
+    cmd
+        .command("fund-from-treasury <bountyId>")
+        .description("Fund a bounty from a guild treasury (off-chain)")
+        .requiredOption("--guild <guildId>", "Guild ID that owns the treasury")
+        .requiredOption("--amount <n>", "Amount in credits (display units, e.g. 5.00)")
+        .option("--proposal <proposalId>", "Optional treasury proposal ID authorising the spend")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, opts) => {
+        try {
+            await fundFromTreasury(program.opts(), bountyId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    // nookplot bounties admin <sweep-fees|sweep-creator-refund>
+    const admin = cmd
+        .command("admin")
+        .description("Admin-only on-chain operations (requires DEFAULT_ADMIN_ROLE)");
+    admin
+        .command("sweep-fees")
+        .description("V8: sweep accumulated deferred treasury fees to a recipient (admin only)")
+        .requiredOption("--token <address>", "Token contract address (use 0x0000…0000 for ETH)")
+        .requiredOption("--recipient <address>", "Address to receive the swept fees")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            await adminSweepFees(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
+    admin
+        .command("sweep-creator-refund <bountyId>")
+        .description("V9 H4: sweep a deferred creator refund for one bounty (admin only)")
+        .requiredOption("--recipient <address>", "Address to receive the swept refund")
+        .option("--json", "Output raw JSON")
+        .action(async (bountyId, opts) => {
+        try {
+            await adminSweepCreatorRefund(program.opts(), bountyId, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed: ${msg}`));
+            process.exit(1);
+        }
+    });
 }
 // ── Helpers ──────────────────────────────────────────────────
 function loadAndValidate(globalOpts) {
@@ -780,4 +957,286 @@ async function selectWinner(globalOpts, bountyId, submissionId, cmdOpts) {
     console.log(`    Submission: ${submissionId.slice(0, 8)}…`);
     console.log("");
 }
+// ── V8 / V9 + treasury parity commands ──────────────────────
+async function expireDisputed(globalOpts, id, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const wallet = requireWallet(config);
+    const spinner = ora(`Expiring disputed bounty #${id}…`).start();
+    const result = await bountyPrepareSignRelay(config, wallet, `/v1/prepare/bounty/${encodeURIComponent(id)}/expire-disputed`, {}, spinner, "expire-disputed");
+    if (cmdOpts.json) {
+        spinner.stop();
+        console.log(JSON.stringify({ bountyId: id, action: "expire-disputed", txHash: result.txHash }, null, 2));
+        return;
+    }
+    spinner.succeed(chalk.green(`Bounty #${id} expired (50/50 split)`));
+    console.log(`    TX: ${result.txHash}`);
+    console.log("");
+}
+function validateUuidLike(id, label) {
+    if (!/^[0-9a-fA-F-]{8,}$/.test(id)) {
+        console.error(chalk.red(`  ✗ ${label} looks invalid: ${id}`));
+        process.exit(1);
+    }
+}
+async function verifySubmission(globalOpts, bountyId, subId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    validateUuidLike(subId, "Submission ID");
+    const spinner = ora(`Verifying submission ${subId.slice(0, 8)}… in sandbox`).start();
+    const body = {};
+    if (cmdOpts.testCommand)
+        body.testCommand = cmdOpts.testCommand;
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/bounties/${encodeURIComponent(bountyId)}/submissions/${encodeURIComponent(subId)}/verify`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Verification failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(chalk.green(`Verification complete`));
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    console.log(JSON.stringify(result.data, null, 2));
+    console.log("");
+}
+async function reviewSubmission(globalOpts, bountyId, subId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    validateUuidLike(subId, "Submission ID");
+    const spinner = ora(`Requesting AI review for submission ${subId.slice(0, 8)}…`).start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/bounties/${encodeURIComponent(bountyId)}/submissions/${encodeURIComponent(subId)}/review`, { apiKey: config.apiKey, body: {} });
+    if (isGatewayError(result)) {
+        spinner.fail("Review failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(chalk.green(`Review complete`));
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    console.log(JSON.stringify(result.data, null, 2));
+    console.log("");
+}
+async function matchSubmissionSpec(globalOpts, bountyId, subId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    validateUuidLike(subId, "Submission ID");
+    const spinner = ora(`Matching submission ${subId.slice(0, 8)}… against bounty spec`).start();
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/bounties/${encodeURIComponent(bountyId)}/submissions/${encodeURIComponent(subId)}/match-spec`, { apiKey: config.apiKey, body: {} });
+    if (isGatewayError(result)) {
+        spinner.fail("Spec match failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(chalk.green(`Spec match complete`));
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    console.log(JSON.stringify(result.data, null, 2));
+    console.log("");
+}
+function resolveVerdictAddress(cmdAddr, config) {
+    if (cmdAddr) {
+        if (!ethers.isAddress(cmdAddr)) {
+            console.error(chalk.red(`  ✗ Invalid address: ${cmdAddr}`));
+            process.exit(1);
+        }
+        return cmdAddr;
+    }
+    if (!config.privateKey) {
+        console.error(chalk.red("  ✗ No --address given and no wallet configured. Set NOOKPLOT_AGENT_PRIVATE_KEY or pass --address."));
+        process.exit(1);
+    }
+    try {
+        return new ethers.Wallet(config.privateKey).address;
+    }
+    catch {
+        console.error(chalk.red("  ✗ Invalid private key in config."));
+        process.exit(1);
+    }
+}
+function parseContractType(raw, allowAll) {
+    const ok = allowAll ? ["all", "bounty", "marketplace"] : ["bounty", "marketplace"];
+    if (!ok.includes(raw)) {
+        throw new Error(`--contract-type must be one of: ${ok.join(", ")}`);
+    }
+    return raw;
+}
+async function verdictSummary(globalOpts, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const addr = resolveVerdictAddress(cmdOpts.address, config);
+    const contractType = parseContractType(cmdOpts.contractType, true);
+    const days = Math.max(1, Math.min(parseInt(cmdOpts.days, 10) || 90, 365));
+    const spinner = ora(`Fetching verdict summary for ${addr.slice(0, 10)}…`).start();
+    const params = new URLSearchParams();
+    params.set("contractType", contractType);
+    params.set("sinceDays", String(days));
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/agents/${encodeURIComponent(addr)}/verdict-summary?${params}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed to fetch verdict summary");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed("Verdict summary retrieved");
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    const { summary, windowDays } = result.data;
+    console.log("");
+    console.log(chalk.bold(`  Verdict summary — ${addr}`));
+    console.log(`    Window:      last ${windowDays} days (${contractType})`);
+    console.log(`    Composite:   ${summary.weightedComposite == null ? chalk.dim("n/a") : chalk.yellow(summary.weightedComposite.toFixed(1))}`);
+    console.log(`    Verdicts:    ${summary.totalVerdicts}`);
+    console.log(`    Creators:    ${summary.distinctCreators}`);
+    if (summary.byVerdict && Object.keys(summary.byVerdict).length > 0) {
+        console.log(`    By verdict:`);
+        for (const [k, v] of Object.entries(summary.byVerdict)) {
+            console.log(`      ${k.padEnd(12)} ${v}`);
+        }
+    }
+    console.log("");
+}
+async function recentVerdicts(globalOpts, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const addr = resolveVerdictAddress(cmdOpts.address, config);
+    const contractType = parseContractType(cmdOpts.contractType, true);
+    const days = Math.max(1, Math.min(parseInt(cmdOpts.days, 10) || 90, 365));
+    const limit = Math.max(1, Math.min(parseInt(cmdOpts.limit, 10) || 20, 200));
+    const spinner = ora(`Fetching recent verdicts for ${addr.slice(0, 10)}…`).start();
+    const params = new URLSearchParams({ includeList: "true" });
+    params.set("contractType", contractType);
+    params.set("sinceDays", String(days));
+    params.set("listLimit", String(limit));
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/agents/${encodeURIComponent(addr)}/verdict-summary?${params}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed to fetch recent verdicts");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    const rows = result.data.list ?? [];
+    spinner.succeed(`${rows.length} verdict(s) for ${addr.slice(0, 10)}…`);
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    if (rows.length === 0) {
+        console.log(chalk.dim("\n  No verdicts in window.\n"));
+        return;
+    }
+    console.log("");
+    for (const v of rows) {
+        const when = new Date(Number(v.block_timestamp) * 1000).toLocaleString();
+        const comp = v.composite == null ? chalk.dim("—") : chalk.yellow(String(v.composite));
+        console.log(`  ${chalk.bold(`${v.contract_type}#${v.entity_id}`)} verdict=${v.verdict} composite=${comp}`);
+        console.log(`    ${chalk.dim(when)} by ${v.emitter.slice(0, 10)}…`);
+        if (v.rubric_cid)
+            console.log(`    rubric: ${v.rubric_cid}`);
+        console.log("");
+    }
+}
+async function getVerdict(globalOpts, bountyId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const contractType = parseContractType(cmdOpts.contractType, false);
+    if (!/^[0-9]+$/.test(bountyId)) {
+        throw new Error("bountyId must be a non-negative integer.");
+    }
+    const spinner = ora(`Fetching verdict trail for ${contractType} #${bountyId}…`).start();
+    const result = await gatewayRequest(config.gateway, "GET", `/v1/index/verdicts/${encodeURIComponent(contractType)}/${encodeURIComponent(bountyId)}`, { apiKey: config.apiKey });
+    if (isGatewayError(result)) {
+        spinner.fail("Failed to fetch verdict trail");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    const verdicts = result.data.verdicts ?? [];
+    spinner.succeed(`${verdicts.length} verdict row(s)`);
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    if (verdicts.length === 0) {
+        console.log(chalk.dim("\n  No verdicts recorded yet.\n"));
+        return;
+    }
+    console.log("");
+    for (const [i, v] of verdicts.entries()) {
+        const when = new Date(Number(v.block_timestamp) * 1000).toLocaleString();
+        const comp = v.composite == null ? chalk.dim("—") : chalk.yellow(String(v.composite));
+        const tag = i === 0 ? chalk.green("HEAD") : chalk.dim("    ");
+        console.log(`  ${tag}  verdict=${v.verdict} composite=${comp} ${chalk.dim(when)}`);
+        if (v.rubric_cid)
+            console.log(`         rubric: ${v.rubric_cid}`);
+    }
+    console.log("");
+}
+async function fundFromTreasury(globalOpts, bountyId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const amount = Number(cmdOpts.amount);
+    if (!Number.isFinite(amount) || amount <= 0) {
+        throw new Error(`--amount must be a positive number (got "${cmdOpts.amount}").`);
+    }
+    const spinner = ora(`Funding bounty ${bountyId} from guild ${cmdOpts.guild} treasury…`).start();
+    const body = { bountyId, amount };
+    if (cmdOpts.proposal)
+        body.proposalId = cmdOpts.proposal;
+    const result = await gatewayRequest(config.gateway, "POST", `/v1/guilds/${encodeURIComponent(cmdOpts.guild)}/treasury/fund-bounty`, { apiKey: config.apiKey, body });
+    if (isGatewayError(result)) {
+        spinner.fail("Treasury funding failed");
+        console.error(chalk.red(`  ${result.error}`));
+        process.exit(1);
+    }
+    spinner.succeed(chalk.green(`Bounty ${bountyId} funded from guild ${cmdOpts.guild}`));
+    if (cmdOpts.json) {
+        console.log(JSON.stringify(result.data, null, 2));
+        return;
+    }
+    console.log(`    Amount: ${amount}`);
+    if (cmdOpts.proposal)
+        console.log(`    Proposal: ${cmdOpts.proposal}`);
+    console.log("");
+}
+// ── Admin sweep commands (DEFAULT_ADMIN_ROLE on BountyContract) ──
+async function adminSweepFees(globalOpts, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const wallet = requireWallet(config);
+    if (!ethers.isAddress(cmdOpts.token)) {
+        throw new Error(`Invalid --token address: ${cmdOpts.token}`);
+    }
+    if (!ethers.isAddress(cmdOpts.recipient) || cmdOpts.recipient === ethers.ZeroAddress) {
+        throw new Error(`Invalid --recipient address: ${cmdOpts.recipient}`);
+    }
+    const spinner = ora(`Sweeping deferred fees for token ${cmdOpts.token.slice(0, 10)}…`).start();
+    const result = await bountyPrepareSignRelay(config, wallet, "/v1/prepare/bounty/admin/sweep-fees", { token: cmdOpts.token, recipient: cmdOpts.recipient }, spinner, "sweep-fees");
+    if (cmdOpts.json) {
+        spinner.stop();
+        console.log(JSON.stringify({ action: "sweep-fees", token: cmdOpts.token, recipient: cmdOpts.recipient, txHash: result.txHash }, null, 2));
+        return;
+    }
+    spinner.succeed(chalk.green("Fees swept"));
+    console.log(`    Token:     ${cmdOpts.token}`);
+    console.log(`    Recipient: ${cmdOpts.recipient}`);
+    console.log(`    TX: ${result.txHash}`);
+    console.log("");
+}
+async function adminSweepCreatorRefund(globalOpts, bountyId, cmdOpts) {
+    const config = loadAndValidate(globalOpts);
+    const wallet = requireWallet(config);
+    if (!/^[0-9]+$/.test(bountyId)) {
+        throw new Error("bountyId must be a non-negative integer.");
+    }
+    if (!ethers.isAddress(cmdOpts.recipient) || cmdOpts.recipient === ethers.ZeroAddress) {
+        throw new Error(`Invalid --recipient address: ${cmdOpts.recipient}`);
+    }
+    const spinner = ora(`Sweeping creator refund for bounty #${bountyId}…`).start();
+    const result = await bountyPrepareSignRelay(config, wallet, "/v1/prepare/bounty/admin/sweep-creator-refund", { bountyId, recipient: cmdOpts.recipient }, spinner, "sweep-creator-refund");
+    if (cmdOpts.json) {
+        spinner.stop();
+        console.log(JSON.stringify({ action: "sweep-creator-refund", bountyId, recipient: cmdOpts.recipient, txHash: result.txHash }, null, 2));
+        return;
+    }
+    spinner.succeed(chalk.green(`Creator refund swept for bounty #${bountyId}`));
+    console.log(`    Recipient: ${cmdOpts.recipient}`);
+    console.log(`    TX: ${result.txHash}`);
+    console.log("");
+}
 //# sourceMappingURL=bounties.js.map