@profullstack/agenticjobs 0.11.0 → 0.14.0

package/dist/server/routes/inbox.js

@@ -0,0 +1,223 @@
+import { jsx as _jsx } from "hono/jsx/jsx-runtime";
+/**
+ * The inbox pages.
+ *
+ * Every form here works without JavaScript, like the rest of the site, and
+ * every page needs a signed-in person: there is nothing public in an inbox.
+ */
+import { Hono } from 'hono';
+import { counterpartyFrom, getThread, listThreads, markRead, notifyParticipants, sendMessage, startThread, } from "../../core/inbox.js";
+import { cancelInvoice, getInvoice, listInvoicesIn, requestPayment, sendInvoice, syncInvoice, } from "../../core/invoices.js";
+import { getAccount } from "../../core/coinpay.js";
+import { getJobBySlug } from "../../core/jobs.js";
+import { getOrgBySlug, listOrgsForUser } from "../../core/orgs.js";
+import { getPublicResume } from "../../core/resumes.js";
+import { toCandidateSummary } from "../../core/candidates.js";
+import { Layout } from "../../views/layout.js";
+import { InboxPage, NewThreadPage, ThreadPage } from "../../views/inbox.js";
+import { formOf, requireViewer, shell } from "./pages.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function inboxRoutes() {
+    const inbox = new Hono();
+    inbox.get('/inbox', async (c) => {
+        const { pool } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const threads = await listThreads(pool, viewer.id);
+        return c.html(_jsx(Layout, { ...shell(c), title: "Inbox", noindex: true, children: _jsx(InboxPage, { threads: threads }) }));
+    });
+    /**
+     * Who the compose page is to, from its query or its form.
+     *
+     * Resolved to a page the person can see, so the heading can name them, and
+     * so "message" on a private resume is a 404 rather than a way to reach
+     * somebody who did not publish.
+     */
+    async function resolveTarget(c, input) {
+        const { pool } = c.get('deps');
+        const candidate = (input['candidate'] ?? '').trim();
+        const employer = (input['employer'] ?? '').trim();
+        if (candidate !== '') {
+            const resume = await getPublicResume(pool, candidate);
+            if (resume === null)
+                return null;
+            const summary = toCandidateSummary(resume);
+            return {
+                to: { kind: 'candidate', name: summary.name, slug: candidate },
+                target: { candidate },
+            };
+        }
+        if (employer !== '') {
+            const org = await getOrgBySlug(pool, employer);
+            if (org === null)
+                return null;
+            return { to: { kind: 'employer', name: org.name, slug: org.slug }, target: { employer } };
+        }
+        return null;
+    }
+    const composePage = async (c, input, status = 200, error) => {
+        const { pool } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const resolved = await resolveTarget(c, input);
+        if (resolved === null)
+            return c.notFound();
+        const jobSlug = (input['job'] ?? '').trim();
+        const job = jobSlug === '' ? null : await getJobBySlug(pool, jobSlug);
+        const asOrgs = await listOrgsForUser(pool, viewer.id);
+        return c.html(_jsx(Layout, { ...shell(c), title: `Message ${resolved.to.name}`, noindex: true, children: _jsx(NewThreadPage, { to: resolved.to, job: job === null ? null : { slug: job.slug, title: job.title }, asOrgs: asOrgs, values: input, target: resolved.target, ...(error === undefined ? {} : { error }) }) }), status);
+    };
+    inbox.get('/inbox/new', (c) => {
+        const params = new URL(c.req.url).searchParams;
+        return composePage(c, Object.fromEntries(params.entries()));
+    });
+    inbox.post('/inbox/new', async (c) => {
+        const { pool, config, mailer } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const form = await formOf(c);
+        const to = await counterpartyFrom(pool, {
+            candidate: form['candidate'] ?? null,
+            employer: form['employer'] ?? null,
+        });
+        if (to === null)
+            return c.notFound();
+        const jobSlug = (form['job'] ?? '').trim();
+        const job = jobSlug === '' ? null : await getJobBySlug(pool, jobSlug);
+        const asSlug = (form['as'] ?? '').trim();
+        const asOrg = asSlug === '' ? null : await getOrgBySlug(pool, asSlug);
+        if (asSlug !== '' && asOrg === null)
+            return composePage(c, form, 400, 'No such employer.');
+        const started = await startThread(pool, viewer.id, to, {
+            subject: form['subject'],
+            body: form['body'],
+            jobId: job?.id ?? null,
+            as: asOrg?.id ?? null,
+        });
+        if (typeof started === 'string')
+            return composePage(c, form, 400, started);
+        await notifyParticipants(pool, {
+            mailer,
+            boardName: config.boardName,
+            publicUrl: config.publicUrl,
+            threadId: started.threadId,
+            senderId: viewer.id,
+            kind: 'text',
+        });
+        return c.redirect(`/inbox/${started.threadId}`, 303);
+    });
+    const threadPage = async (c, threadId, status = 200, error, values) => {
+        const { pool, coinpay } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        if (!UUID.test(threadId))
+            return c.notFound();
+        const thread = await getThread(pool, threadId, viewer.id);
+        if (thread === null)
+            return c.notFound();
+        // Ask CoinPay about every open quote before rendering, so a payer who paid
+        // and came back sees "paid" rather than a stale button.
+        const invoices = await Promise.all((await listInvoicesIn(pool, coinpay, threadId)).map((invoice) => syncInvoice(pool, coinpay, invoice)));
+        const account = coinpay === null ? null : await getAccount(pool, viewer.id);
+        if (status === 200)
+            await markRead(pool, threadId, viewer.id);
+        return c.html(_jsx(Layout, { ...shell(c), title: thread.subject, noindex: true, children: _jsx(ThreadPage, { thread: thread, invoices: invoices, viewerId: viewer.id, billing: { enabled: coinpay !== null, account }, ...(error === undefined ? {} : { error }), ...(values === undefined ? {} : { values }) }) }), status);
+    };
+    inbox.get('/inbox/:id', (c) => threadPage(c, c.req.param('id')));
+    inbox.post('/inbox/:id', async (c) => {
+        const { pool, config, mailer } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const threadId = c.req.param('id');
+        if (!UUID.test(threadId))
+            return c.notFound();
+        const form = await formOf(c);
+        const sent = await sendMessage(pool, threadId, viewer.id, form['body']);
+        if (typeof sent === 'string')
+            return threadPage(c, threadId, 400, sent, form);
+        await notifyParticipants(pool, {
+            mailer,
+            boardName: config.boardName,
+            publicUrl: config.publicUrl,
+            threadId,
+            senderId: viewer.id,
+            kind: 'text',
+        });
+        return c.redirect(`/inbox/${threadId}#${sent.id}`, 303);
+    });
+    inbox.post('/inbox/:id/invoices', async (c) => {
+        const { pool, config, mailer, coinpay } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const threadId = c.req.param('id');
+        if (!UUID.test(threadId))
+            return c.notFound();
+        const form = await formOf(c);
+        const invoice = await sendInvoice(pool, coinpay, {
+            threadId,
+            payeeId: viewer.id,
+            amount: form['amount'],
+            currency: form['currency'],
+            description: form['description'],
+        });
+        if (typeof invoice === 'string')
+            return threadPage(c, threadId, 400, invoice, form);
+        await notifyParticipants(pool, {
+            mailer,
+            boardName: config.boardName,
+            publicUrl: config.publicUrl,
+            threadId,
+            senderId: viewer.id,
+            kind: 'invoice',
+        });
+        return c.redirect(`/inbox/${threadId}`, 303);
+    });
+    /** Off to CoinPay with a live quote. */
+    inbox.post('/inbox/:id/invoices/:invoiceId/pay', async (c) => {
+        const { pool, config, coinpay } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const threadId = c.req.param('id');
+        const invoiceId = c.req.param('invoiceId');
+        if (!UUID.test(threadId) || !UUID.test(invoiceId))
+            return c.notFound();
+        const result = await requestPayment(pool, coinpay, {
+            invoiceId,
+            payerId: viewer.id,
+            publicUrl: config.publicUrl,
+        });
+        if (typeof result === 'string')
+            return threadPage(c, threadId, 400, result);
+        if (result.status === 'paid' || result.payment === null) {
+            return c.redirect(`/inbox/${threadId}`, 303);
+        }
+        return c.redirect(result.payment.url, 303);
+    });
+    inbox.post('/inbox/:id/invoices/:invoiceId/cancel', async (c) => {
+        const { pool, coinpay } = c.get('deps');
+        const viewer = requireViewer(c);
+        if (viewer instanceof Response)
+            return viewer;
+        const threadId = c.req.param('id');
+        const invoiceId = c.req.param('invoiceId');
+        if (!UUID.test(threadId) || !UUID.test(invoiceId))
+            return c.notFound();
+        const invoice = await getInvoice(pool, coinpay, invoiceId, viewer.id);
+        if (invoice === null || invoice.threadId !== threadId)
+            return c.notFound();
+        const cancelled = await cancelInvoice(pool, invoiceId, viewer.id);
+        if (!cancelled) {
+            return threadPage(c, threadId, 400, 'Only the sender can cancel an invoice, and only while it is unpaid.');
+        }
+        return c.redirect(`/inbox/${threadId}`, 303);
+    });
+    return inbox;
+}
+//# sourceMappingURL=inbox.js.map

package/dist/server/routes/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../src/server/routes/inbox.tsx"],"names":[],"mappings":"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"}

package/dist/server/routes/openapi.js

@@ -37,6 +37,18 @@ export function openApiDocument(config) {
             { name: 'candidates', description: 'People who published a resume here.' },
             { name: 'employers', description: 'The organisations a listing belongs to.' },
             { name: 'updates', description: 'Short posts from employers and candidates, and following them.' },
+            {
+                name: 'recommendations',
+                description: 'What somebody who worked with you says about you, on your page once you approve it. Not a rating: a paragraph with a name on it, in either direction.',
+            },
+            {
+                name: 'inbox',
+                description: 'Private conversations. The only way to reach somebody here; there is no public commenting.',
+            },
+            {
+                name: 'billing',
+                description: "Invoices sent through the inbox, settled on CoinPay to the payee's own wallet.",
+            },
             { name: 'auth', description: 'Device flow for terminals, magic links for browsers.' },
             { name: 'federation', description: 'The directory of instances, and search across them.' },
         ],
@@ -65,8 +77,34 @@ export function openApiDocument(config) {
                 post: {
                     tags: ['jobs'],
                     summary: 'Post a job. Creates a draft unless publish is true.',
+                    description: 'Pay is required to publish. Send `pay` as an array of lines written the way a person says them ("$120k - $150k a year", "$0.25 per task", "$5000 fixed", "10% revenue share", "0.01 SOL per task"), or as objects with type, min, max, currency and unit; `payMethod` says how it is settled (SOL, USDC, bank transfer, PayPal); `unpaid: true` says the role pays nothing. With `publish: true` and no pay the request is refused with `pay_required` and nothing is created.',
                     security: [{ bearer: [] }],
-                    responses: { 201: ok('The job as stored.'), 401: err(), 403: err() },
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    required: ['org', 'title', 'description'],
+                                    properties: {
+                                        org: { type: 'string' },
+                                        title: { type: 'string' },
+                                        description: { type: 'string', description: 'Markdown.' },
+                                        pay: {
+                                            type: 'array',
+                                            items: { oneOf: [{ type: 'string' }, { $ref: '#/components/schemas/PayLine' }] },
+                                        },
+                                        payMethod: { type: 'string' },
+                                        payEquity: { type: 'string' },
+                                        unpaid: { type: 'boolean' },
+                                        agentPolicy: { type: 'string', enum: ['welcome', 'disclose', 'human-only'] },
+                                        publish: { type: 'boolean' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: { 201: ok('The job as stored.'), 400: err(), 401: err(), 403: err() },
                 },
             },
             '/api/v1/jobs/{slug}': {
@@ -321,6 +359,122 @@ export function openApiDocument(config) {
                     responses: { 200: ok('Employers and candidates you follow.'), 401: err() },
                 },
             },
+            '/api/v1/inbox': {
+                get: {
+                    tags: ['inbox'],
+                    summary: 'Your conversations, newest activity first, with unread counts.',
+                    security: [{ bearer: [] }],
+                    responses: { 200: ok('Threads.'), 401: err() },
+                },
+                post: {
+                    tags: ['inbox'],
+                    summary: 'Write to a candidate or an employer. Continues the conversation you already have with them.',
+                    description: 'Send {"candidate": slug} or {"employer": slug}, a "body", and optionally a "subject", a "job" slug the message is about, and "as": an employer slug to write on behalf of (you must belong to it). The same two parties about the same job is one conversation, so a second POST lands as a new message in it and answers 200 rather than 201. Twenty new conversations a day per account. The other side is emailed that there is a message, never the message itself. There is no public commenting on this board: this is how people are reached.',
+                    security: [{ bearer: [] }],
+                    responses: {
+                        200: ok('Added to the existing conversation: threadId, messageId, url.'),
+                        201: ok('A new conversation: threadId, messageId, url.'),
+                        400: err(),
+                        401: err(),
+                        404: err(),
+                        429: err(),
+                    },
+                },
+            },
+            '/api/v1/inbox/{id}': {
+                get: {
+                    tags: ['inbox'],
+                    summary: 'One conversation: its messages and the invoices in it. Opening it marks it read.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 200: ok('The thread and its invoices.'), 401: err(), 404: err() },
+                },
+            },
+            '/api/v1/inbox/{id}/messages': {
+                post: {
+                    tags: ['inbox'],
+                    summary: 'Reply in a conversation you are in.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 201: ok('The message.'), 400: err(), 401: err(), 404: err() },
+                },
+            },
+            '/api/v1/inbox/{id}/invoices': {
+                post: {
+                    tags: ['billing'],
+                    summary: 'Send an invoice into a conversation. You are the payee.',
+                    description: 'Send "amount" in US dollars, "description", and "currency": a chain you hold a wallet for on your connected CoinPay account (BTC, ETH, SOL, USDC_POL ...). Omit currency when you have exactly one wallet. The payment settles on CoinPay straight to that wallet; this board never holds it. Needs a connected CoinPay account with wallet:read, which is done in a browser at /me/coinpay/connect.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 201: ok('The invoice.'), 400: err(), 401: err(), 404: err() },
+                },
+            },
+            '/api/v1/invoices': {
+                get: {
+                    tags: ['billing'],
+                    summary: 'Every invoice you sent or can pay, newest first.',
+                    security: [{ bearer: [] }],
+                    responses: { 200: ok('Invoices.'), 401: err() },
+                },
+            },
+            '/api/v1/invoices/{id}': {
+                get: {
+                    tags: ['billing'],
+                    summary: 'One invoice, with its payment state checked against CoinPay.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 200: ok('The invoice.'), 401: err(), 404: err() },
+                },
+            },
+            '/api/v1/invoices/{id}/pay': {
+                post: {
+                    tags: ['billing'],
+                    summary: 'Get a live quote to pay an invoice you were sent.',
+                    description: 'Returns the invoice with "payment" filled in: "url" is the CoinPay page to pay on, "address" and "amountCrypto" let a wallet pay directly. A quote lasts a few minutes; call again for a fresh one. Paid is reported by the webhook and by reading the invoice.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 200: ok('The invoice with a payment to make.'), 400: err(), 401: err(), 404: err() },
+                },
+            },
+            '/api/v1/invoices/{id}/cancel': {
+                post: {
+                    tags: ['billing'],
+                    summary: 'Take back an unpaid invoice you sent.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('id')],
+                    responses: { 200: ok('Cancelled.'), 401: err(), 404: err(), 409: err() },
+                },
+            },
+            '/api/v1/coinpay': {
+                get: {
+                    tags: ['billing'],
+                    summary: 'Whether this board has billing, and whether your CoinPay account is connected.',
+                    description: '"configured" is the board; "account" is you, with "usable" saying whether the connection can read your wallets (a connection without the wallet:read scope shows here as not usable and has to be reconnected). Connecting is a browser step at "connectUrl".',
+                    security: [{ bearer: [] }],
+                    responses: { 200: ok('Connection state.'), 401: err() },
+                },
+                delete: {
+                    tags: ['billing'],
+                    summary: 'Disconnect your CoinPay account. Invoices already sent keep their wallet.',
+                    security: [{ bearer: [] }],
+                    responses: { 200: ok('Disconnected.'), 401: err() },
+                },
+            },
+            '/api/v1/coinpay/callback': {
+                get: {
+                    tags: ['billing'],
+                    summary: 'Where CoinPay sends a browser back after consent. Not for calling directly.',
+                    parameters: [param('code', 'From CoinPay.'), param('state', 'From CoinPay.')],
+                    responses: { 303: { description: 'Back to the board.' }, 400: err(), 404: err() },
+                },
+            },
+            '/api/v1/coinpay/webhook': {
+                post: {
+                    tags: ['billing'],
+                    summary: 'CoinPay reporting a settled payment. Signed with the business webhook secret.',
+                    responses: { 200: ok('Received.'), 401: err(), 404: err() },
+                },
+            },
             '/api/v1/jobs/import': {
                 post: {
                     tags: ['jobs'],
@@ -386,6 +540,7 @@ export function openApiDocument(config) {
                 post: {
                     tags: ['jobs'],
                     summary: 'publish, close or reopen a listing.',
+                    description: 'Publishing requires the listing to say what it pays: at least one pay line with an amount, or unpaid. Otherwise 400 with code pay_required, and the listing stays as it was.',
                     security: [{ bearer: [] }],
                     parameters: [
                         pathParam('slug'),
@@ -396,7 +551,76 @@ export function openApiDocument(config) {
                             schema: { type: 'string', enum: ['publish', 'close', 'reopen'] },
                         },
                     ],
-                    responses: { 200: ok('The listing.'), 401: err(), 403: err(), 404: err() },
+                    responses: { 200: ok('The listing.'), 400: err(), 401: err(), 403: err(), 404: err() },
+                },
+            },
+            '/api/v1/candidates/{slug}/recommendations': {
+                get: {
+                    tags: ['recommendations'],
+                    summary: "The approved recommendations on a candidate's page.",
+                    parameters: [pathParam('slug')],
+                    responses: { 200: ok('Recommendations.'), 404: err() },
+                },
+                post: {
+                    tags: ['recommendations'],
+                    summary: 'Recommend a candidate.',
+                    description: 'As yourself, which needs a published resume so it is signed by a page, or as an employer you post for ("as"). Pending until the candidate approves it; writing again replaces it. Ten a day.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('slug')],
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    required: ['body'],
+                                    properties: {
+                                        body: { type: 'string', minLength: 20, maxLength: 2000 },
+                                        relationship: { type: 'string', maxLength: 120, description: '"Hired them for a three-month contract".' },
+                                        as: { type: 'string', description: 'An employer slug you post for.' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: { 201: ok('The recommendation, pending.'), 400: err(), 401: err(), 403: err(), 404: err(), 429: err() },
+                },
+            },
+            '/api/v1/orgs/{slug}/recommendations': {
+                get: {
+                    tags: ['recommendations'],
+                    summary: "The approved recommendations on an employer's page.",
+                    parameters: [pathParam('slug')],
+                    responses: { 200: ok('Recommendations.'), 404: err() },
+                },
+                post: {
+                    tags: ['recommendations'],
+                    summary: 'Recommend an employer.',
+                    description: 'The same rules as recommending a candidate. Members cannot recommend their own employer.',
+                    security: [{ bearer: [] }],
+                    parameters: [pathParam('slug')],
+                    responses: { 201: ok('The recommendation, pending.'), 400: err(), 401: err(), 403: err(), 404: err(), 429: err() },
+                },
+            },
+            '/api/v1/me/recommendations': {
+                get: {
+                    tags: ['recommendations'],
+                    summary: 'About you and your employers, every status, and what you wrote.',
+                    security: [{ bearer: [] }],
+                    responses: { 200: ok('received, given, and how many are pending.'), 401: err() },
+                },
+            },
+            '/api/v1/recommendations/{id}/{action}': {
+                post: {
+                    tags: ['recommendations'],
+                    summary: 'approve or reject one written about you, or withdraw one you wrote.',
+                    description: 'The subject decides, and can change their mind later: an approved one can be rejected, which takes it off the page. Withdraw deletes one you wrote.',
+                    security: [{ bearer: [] }],
+                    parameters: [
+                        pathParam('id'),
+                        { name: 'action', in: 'path', required: true, schema: { type: 'string', enum: ['approve', 'reject', 'withdraw'] } },
+                    ],
+                    responses: { 200: ok('The recommendation, or withdrawn: true.'), 401: err(), 404: err() },
                 },
             },
             '/api/v1/auth/magic-link': {
@@ -505,10 +729,44 @@ export function openApiDocument(config) {
                             description: 'Where the employer stands on applications written with an agent. Required on every listing, because the alternative is finding out by silent rejection.',
                         },
                         apply: { type: 'object' },
+                        pay: { $ref: '#/components/schemas/Pay' },
+                        salary: {
+                            type: 'object',
+                            description: 'The first time-based pay line, flattened: min, max, currency, period, equity, unpaid. Kept for readers written before `pay` existed and for the salary filter and sort. A listing that pays per task has a null range here.',
+                        },
                         tags: { type: 'array', items: { type: 'string' } },
                         stack: { type: 'array', items: { type: 'string' } },
                     },
                 },
+                Pay: {
+                    type: 'object',
+                    description: 'What a listing pays, in full. Required to publish: at least one line with an amount, or unpaid.',
+                    properties: {
+                        lines: { type: 'array', items: { $ref: '#/components/schemas/PayLine' } },
+                        method: {
+                            type: 'string',
+                            nullable: true,
+                            description: 'How it is settled: a coin (SOL, USDC, ETH, USDT, POL) or a rail (bank transfer, PayPal, payroll).',
+                        },
+                        equity: { type: 'string', nullable: true },
+                        unpaid: { type: 'boolean' },
+                    },
+                },
+                PayLine: {
+                    type: 'object',
+                    description: 'One price. The same vocabulary as a ugig.net gig budget: a type, a range, what it is denominated in, and for per_task and per_unit what one unit is.',
+                    required: ['type', 'currency'],
+                    properties: {
+                        type: {
+                            type: 'string',
+                            enum: ['hourly', 'daily', 'weekly', 'monthly', 'yearly', 'fixed', 'per_task', 'per_unit', 'revenue_share', 'bounty'],
+                        },
+                        min: { type: 'number', nullable: true },
+                        max: { type: 'number', nullable: true },
+                        currency: { type: 'string', description: 'USD, EUR, or a ticker such as SOL. "%" for a revenue share.' },
+                        unit: { type: 'string', nullable: true, description: 'For per_task and per_unit: "task", "PR that fixes a bug you find".' },
+                    },
+                },
             },
         },
     };