@reneturcios/greenlight 0.0.0-stage → 0.3.2

package/dist/index.js

@@ -0,0 +1,173 @@
+/**
+ * Greenlight MCP server (stdio). Same engine as the CLI, exposed as tools
+ * so coding agents (Claude, Cursor, Cline) can pre-flight an issue before
+ * spending tokens on code for a taken or gated issue.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { parseIssueUrl, buildIssueSnapshot, scanCandidates, fetchContributing, countStarterIssues, detectRepoPolicy, } from "./github.js";
+import { scoreIssue } from "./verdict.js";
+import { parseGates } from "./gates.js";
+import { scoreFriction } from "./friction.js";
+import { createRestClient, claimIssue, prepIssue, openPr, AutomationRefusal, } from "./automate.js";
+const server = new McpServer({ name: "greenlight", version: "0.3.2" });
+const text = (obj) => ({
+    content: [{ type: "text", text: JSON.stringify(obj, null, 2) }],
+});
+server.tool("check_issue", "Verdict on whether a GitHub issue is actually landable for an outside contributor. Returns GO, RISKY, TAKEN, GATED, or STALE with reasons, claim signals, and detected repo gates. Call this before writing code for an issue.", {
+    issue_url: z.string().describe("Full GitHub issue URL, e.g. https://github.com/owner/repo/issues/123"),
+}, async ({ issue_url }) => {
+    try {
+        const { owner, repo, number } = parseIssueUrl(issue_url);
+        const snapshot = await buildIssueSnapshot(owner, repo, number);
+        const result = scoreIssue(snapshot);
+        return text({ issue: snapshot.sourceUrl, title: snapshot.title, verdict: result.verdict, reasons: result.reasons, flags: result.flags, claims: result.claims, gates: result.gates });
+    }
+    catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+server.tool("scan_repo", "Rank a repo's open issues by verdict, GO first. Starts with label-tagged good-first-issue / help-wanted issues; when the repo does not use those labels, falls back to the most recent open unassigned issues (flagged as fallback). Use this to pick a winnable issue instead of a taken one.", {
+    repo: z.string().describe("owner/repo, e.g. PrefectHQ/fastmcp"),
+}, async ({ repo }) => {
+    try {
+        const m = /^([^/]+)\/([^/]+)$/.exec(repo.trim());
+        if (!m)
+            return text({ error: `Expected owner/repo, got: ${repo}` });
+        const { issues, fallbackUsed } = await scanCandidates(m[1], m[2], { limit: 10 });
+        const results = [];
+        for (const issue of issues) {
+            try {
+                const snapshot = await buildIssueSnapshot(m[1], m[2], issue.number);
+                const scored = scoreIssue(snapshot);
+                results.push({ url: issue.url, title: issue.title, verdict: scored.verdict, reasons: scored.reasons, flags: scored.flags });
+            }
+            catch (err) {
+                results.push({ url: issue.url, title: issue.title, verdict: "ERROR", reasons: [err instanceof Error ? err.message : String(err)], flags: [] });
+            }
+        }
+        const rank = { GO: 0, RISKY: 1, GATED: 2, STALE: 3, TAKEN: 4, ERROR: 5 };
+        results.sort((a, b) => (rank[a.verdict] ?? 9) - (rank[b.verdict] ?? 9));
+        return text({ repo, fallback: fallbackUsed, results });
+    }
+    catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+server.tool("repo_friction", "Friction score 0-100 for a repo (100 = easiest to land an outside PR). Based on detected contribution gates and computed outcome signals.", {
+    repo: z.string().describe("owner/repo, e.g. PrefectHQ/fastmcp"),
+}, async ({ repo }) => {
+    try {
+        const m = /^([^/]+)\/([^/]+)$/.exec(repo.trim());
+        if (!m)
+            return text({ error: `Expected owner/repo, got: ${repo}` });
+        const [contributing, policy, starterCount] = await Promise.all([
+            fetchContributing(m[1], m[2]),
+            detectRepoPolicy(m[1], m[2]),
+            countStarterIssues(m[1], m[2]),
+        ]);
+        const gates = parseGates(contributing, { collaboratorsOnlyPolicy: policy.collaboratorsOnly });
+        const report = scoreFriction({
+            owner: m[1],
+            repo: m[2],
+            gates,
+            externalPRMergeRate: null,
+            medianFirstReviewHours: null,
+            maintainerIssueResponseHours: null,
+            openGoodFirstIssueCount: starterCount,
+            note: "live",
+        });
+        return text(report);
+    }
+    catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+server.tool("claim_issue", "Post a claim comment on a GitHub issue, shaped by the repo's contribution gates. Runs the verdict pipeline first and refuses on TAKEN/STALE verdicts or vouch-gated repos. DRY RUN BY DEFAULT: returns the comment plan without posting unless execute is true, and posting requires GITHUB_TOKEN.", {
+    issue_url: z.string().describe("Full GitHub issue URL, e.g. https://github.com/owner/repo/issues/123"),
+    execute: z.boolean().default(false).describe("Post the comment for real. Defaults to false: dry run returns the plan only."),
+    force: z.boolean().default(false).describe("Claim even on a TAKEN or STALE verdict."),
+}, async ({ issue_url, execute, force }) => {
+    try {
+        const { owner, repo, number } = parseIssueUrl(issue_url);
+        const snapshot = await buildIssueSnapshot(owner, repo, number);
+        const plan = await claimIssue(createRestClient(), snapshot, { yes: execute, force });
+        return text({
+            issue: snapshot.sourceUrl,
+            verdict: plan.verdict.verdict,
+            reasons: plan.verdict.reasons,
+            commentBody: plan.commentBody,
+            commentUrl: plan.commentUrl,
+            executed: plan.executed,
+        });
+    }
+    catch (err) {
+        if (err instanceof AutomationRefusal)
+            return text({ refused: true, reason: err.message });
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+server.tool("prep_issue", "Prepare to work an issue: check/create your fork and a branch named from the issue title (learning the repo's branch convention from recent PRs when detectable), and write a local PREP.md checklist (verdict, gates, DCO reminders, next commands). Never clones. DRY RUN BY DEFAULT: no fork or branch is created unless execute is true; creating them requires GITHUB_TOKEN.", {
+    issue_url: z.string().describe("Full GitHub issue URL, e.g. https://github.com/owner/repo/issues/123"),
+    execute: z.boolean().default(false).describe("Actually create the fork/branch. Defaults to false: dry run returns the plan only."),
+    dir: z.string().optional().describe("Directory for PREP.md. Defaults to ./greenlight-prep/<repo>-<number>/"),
+}, async ({ issue_url, execute, dir }) => {
+    try {
+        const { owner, repo, number } = parseIssueUrl(issue_url);
+        const snapshot = await buildIssueSnapshot(owner, repo, number);
+        const plan = await prepIssue(createRestClient(), snapshot, { yes: execute, dir });
+        return text({
+            issue: snapshot.sourceUrl,
+            verdict: plan.verdict.verdict,
+            reasons: plan.verdict.reasons,
+            branch: plan.branch,
+            branchDefault: plan.branchDefault,
+            branchPatternNote: plan.branchPatternNote,
+            forkReady: plan.forkReady,
+            forkCreated: plan.forkCreated,
+            branchReady: plan.branchReady,
+            branchCreated: plan.branchCreated,
+            prepFile: plan.prepFile,
+            nextCommands: plan.nextCommands,
+            conventions: plan.conventions ?? null,
+        });
+    }
+    catch (err) {
+        if (err instanceof AutomationRefusal)
+            return text({ refused: true, reason: err.message });
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+server.tool("open_pr", "Open a pull request for an issue from your fork branch. Verifies the branch exists, is ahead of upstream, and (on DCO repos) that every commit carries a Signed-off-by line. Composes the PR title and body (Closes #N plus verdict and gates at open time). DRY RUN BY DEFAULT: returns the composed PR without opening it unless execute is true; opening requires GITHUB_TOKEN.", {
+    issue_url: z.string().describe("Full GitHub issue URL, e.g. https://github.com/owner/repo/issues/123"),
+    branch: z.string().describe("Fork branch to open the PR from, e.g. feat/resume-61"),
+    execute: z.boolean().default(false).describe("Open the PR for real. Defaults to false: dry run returns the plan only."),
+    title: z.string().optional().describe("PR title override. Defaults to the branch's latest commit subject or the issue title."),
+}, async ({ issue_url, branch, execute, title }) => {
+    try {
+        const { owner, repo, number } = parseIssueUrl(issue_url);
+        const snapshot = await buildIssueSnapshot(owner, repo, number);
+        const plan = await openPr(createRestClient(), snapshot, { branch, title, yes: execute });
+        return text({
+            issue: snapshot.sourceUrl,
+            branch: plan.branch,
+            head: plan.head,
+            base: plan.base,
+            title: plan.title,
+            body: plan.body,
+            checks: plan.checks,
+            prUrl: plan.prUrl,
+            executed: plan.executed,
+        });
+    }
+    catch (err) {
+        if (err instanceof AutomationRefusal)
+            return text({ refused: true, reason: err.message });
+        return text({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("greenlight MCP server running on stdio");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/linkstrength.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Link strength: how strongly a PR is tied to an issue.
+ *
+ * Issue #1 (2026-10-13): a plain text search for "#N" in PR bodies produced
+ * false positives. shadcn-labs/pdfcn PR #91 closes issue #70 but lists sibling
+ * issues #60-#65 in its body, which wrongly marked #61 and #71 as TAKEN.
+ *
+ * Two levels only:
+ *  - "closing": the PR is this issue's PR. Closing keywords in title/body
+ *    ("Closes #61"), the issue number in the PR title, or the issue number
+ *    as a standalone token in the branch name ("feat/61-resume").
+ *  - "mention": anything else. Bare "#61" in the body, a timeline-only
+ *    cross-reference, or a search hit with no closing evidence.
+ */
+import type { LinkedPR } from "./types.js";
+export type LinkStrength = "closing" | "mention";
+export interface LinkInput {
+    title: string;
+    body: string;
+    branch: string;
+    issueNumber: number;
+}
+export declare function classifyLinkStrength({ title, body, branch, issueNumber }: LinkInput): LinkStrength;
+/** A PR counts as the issue's PR only when its link strength is "closing". */
+export declare function isClosingPR(pr: Pick<LinkedPR, "linkStrength"> & {
+    linkStrength?: LinkStrength;
+}): boolean;

package/dist/linkstrength.js

@@ -0,0 +1,25 @@
+export function classifyLinkStrength({ title, body, branch, issueNumber }) {
+    const n = String(Math.trunc(Math.abs(issueNumber)));
+    // Closing keywords aimed at this issue: "Closes #61", "fixes #61", "Resolved: #61".
+    const closingRe = new RegExp(`(close[sd]?|closing|fix(e[sd])?|fixes|resolve[sd]?|resolves)\\s*:?\\s*#${n}\\b`, "i");
+    if (closingRe.test(title) || closingRe.test(body))
+        return "closing";
+    // Issue number in the PR title ("#61: add resume block") is author intent.
+    const titleRe = new RegExp(`#${n}\\b`, "i");
+    if (titleRe.test(title))
+        return "closing";
+    // Issue number as a standalone token in the branch name ("61-resume-block",
+    // "feat/61-x", "issue-61", "fix-61"). The token test keeps "feat/610-x"
+    // from matching issue 61.
+    if (branch) {
+        const branchRe = new RegExp(`(^|[^0-9])${n}([^0-9]|$)`);
+        if (branchRe.test(branch))
+            return "closing";
+    }
+    return "mention";
+}
+/** A PR counts as the issue's PR only when its link strength is "closing". */
+export function isClosingPR(pr) {
+    return (pr.linkStrength ?? "mention") === "closing";
+}
+//# sourceMappingURL=linkstrength.js.map

package/dist/linkstrength.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkstrength.js","sourceRoot":"","sources":["../src/linkstrength.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAa;IAClF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEpD,oFAAoF;IACpF,MAAM,SAAS,GAAG,IAAI,MAAM,CAC1B,0EAA0E,CAAC,KAAK,EAChF,GAAG,CACJ,CAAC;IACF,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,2EAA2E;IAC3E,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1C,4EAA4E;IAC5E,wEAAwE;IACxE,0BAA0B;IAC1B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,EAAoE;IAC9F,OAAO,CAAC,EAAE,CAAC,YAAY,IAAI,SAAS,CAAC,KAAK,SAAS,CAAC;AACtD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Core data shapes for Greenlight. All scoring runs on these shapes,
+ * whether they came from the live GitHub API or from a fixture file.
+ */
+export type Verdict = "GO" | "RISKY" | "TAKEN" | "GATED" | "STALE";
+/** Minimal comment representation used for claim detection. */
+export interface CommentSignal {
+    author: string;
+    body: string;
+    createdAt: string;
+}
+/** A pull request that references the issue (linked, closes, or mentions). */
+export interface LinkedPR {
+    number: number;
+    state: "open" | "closed" | "merged";
+    title: string;
+    url: string;
+    /** How strongly the PR is tied to the issue. Only "closing" PRs take an issue. */
+    linkStrength: "closing" | "mention";
+}
+/** A pull request referenced in an issue comment, fetched and checked for issue overlap. */
+export interface MentionedPR {
+    number: number;
+    url: string;
+    state: "open" | "closed" | "merged";
+    /** True when the PR title/body references this issue's number. */
+    mentionsIssue: boolean;
+    /**
+     * True when the citing comment came from the issue author. The open-PR
+     * downgrade (rule 11) only trusts non-author heads-ups, but a
+     * maintainer narrating what already shipped (rule 12) is usually the
+     * issue author, so partially-addressed detection reads both.
+     */
+    fromAuthor?: boolean;
+}
+/** A snapshot of one issue: everything the verdict engine needs. */
+export interface IssueSnapshot {
+    sourceUrl: string;
+    owner: string;
+    repo: string;
+    number: number;
+    state: "open" | "closed";
+    title: string;
+    body?: string;
+    /** Per-file policy texts (CONTRIBUTING variants, AGENTS.md, CLAUDE.md). */
+    houseRules?: {
+        file: string;
+        text: string;
+    }[];
+    author: string;
+    assignees: string[];
+    labels: string[];
+    comments: CommentSignal[];
+    linkedPRs: LinkedPR[];
+    /** PRs cited in non-author comments, scored for overlap with this issue. Absent on older fixtures. */
+    commentMentionedPRs?: MentionedPR[];
+    createdAt: string;
+    updatedAt: string;
+    contributing?: string;
+    /** Gates supplied from a gatefile contribution-gates.json, already mapped to Greenlight kinds. */
+    externalGates?: Gate[];
+}
+/** One detected claim signal from a comment. */
+export interface ClaimSignal {
+    author: string;
+    createdAt: string;
+    ageDays: number;
+    strength: "strong" | "soft";
+    phrase: string;
+    /** "full" claims the whole issue; "partial" scopes itself to part of the work. */
+    scope: "full" | "partial";
+    /** The scope word matched for partial claims (e.g. "fallback", "remaining"). */
+    scopeWord?: string;
+}
+/** A contribution gate parsed from CONTRIBUTING / repo policy. */
+export type GateKind = "assignment_required" | "claim_first" | "vouch_required" | "cla_required" | "dco_required" | "discussion_first" | "collaborators_only";
+export interface Gate {
+    kind: GateKind;
+    detected: boolean;
+    evidence: string;
+    /** File the gate evidence came from, e.g. "CONTRIBUTING.md" or "AGENTS.md". */
+    source?: string;
+}
+/** Signals used to score repo friction. Fields that cannot be computed stay null. */
+export interface RepoSignals {
+    owner: string;
+    repo: string;
+    gates: Gate[];
+    externalPRMergeRate?: number | null;
+    medianFirstReviewHours?: number | null;
+    maintainerIssueResponseHours?: number | null;
+    openGoodFirstIssueCount?: number | null;
+    note?: string;
+}
+/** The verdict for one issue, with the reasons in scoring order. */
+export interface VerdictResult {
+    verdict: Verdict;
+    reasons: string[];
+    claims: ClaimSignal[];
+    gates: Gate[];
+    flags: string[];
+}
+/**
+ * Repo conventions learned during prep: the local rituals a contributor
+ * must follow. All fields are best-effort; a repo may provide none.
+ */
+export interface RepoConventions {
+    /** Policy files present at the repo, e.g. ["CONTRIBUTING.md", "AGENTS.md"]. */
+    houseRuleFiles: string[];
+    /** Backticked run commands quoted in the house rules, e.g. ["pnpm verify"]. */
+    verifyCommands: string[];
+    /** True when a .changes/ or .changeset directory exists at the repo root. */
+    changesDir: boolean;
+    /** Which one was found, e.g. ".changes" or ".changeset". */
+    changesDirName?: string;
+    /** Root package.json script names worth running before pushing (subset of test/verify/lint/typecheck/build). */
+    packageScripts: string[];
+    /** True when 60%+ of the last 20 default-branch commits match Conventional Commits. */
+    conventionalCommits: boolean;
+    /** One short example commit subject when conventionalCommits is true. */
+    exampleCommit?: string;
+}
+/** A scored repo, stored in data/friction-index.json. */
+export interface FrictionReport {
+    owner: string;
+    repo: string;
+    score: number;
+    gates: Gate[];
+    reasons: string[];
+    signals: RepoSignals;
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core data shapes for Greenlight. All scoring runs on these shapes,
+ * whether they came from the live GitHub API or from a fixture file.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/verdict.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Deterministic availability verdict.
+ *
+ * Scoring order (first match wins; all checks are deterministic, no LLM):
+ *
+ *  1. Closed issue -> TAKEN (reason: issue closed). A closed issue is never landable.
+ *  2. Any assignee -> TAKEN. Someone officially owns it.
+ *  3. Open linked PR that CLOSES the issue -> TAKEN. Code already exists.
+ *     A PR that merely mentions the issue number (bare #N in the body,
+ *     timeline cross-reference only) does not take it: it only adds the
+ *     "weak-pr-mention" flag (issue #1, seen on shadcn-labs/pdfcn#61 and
+ *     #71, where PR #91 closes #70 but lists sibling issues in its body).
+ *  4. Two or more strong whole-issue claimants -> TAKEN (claim race). Seen on
+ *     langchain-ai/langchain#41185 (3 claimants while still "unassigned").
+ *     Scoped (partial) claims do not count toward a race: part of the work
+ *     stays open by definition.
+ *  5. One strong, fresh (<= 45 days) whole-issue claim -> RISKY, flag "claimed".
+ *     Seen on shadcn-labs/pdfcn#58, claimed the same day we vetted it.
+ *  5b. A fresh strong claim scoped to part of the issue -> RISKY, flags
+ *     "claimed" + "partial-claim", with a reason naming the claimer and the
+ *     scope ("claimed the fallback part ...; the rest may still be open").
+ *     Seen on reticlehq/reticle#691 ("Taking the remaining fallback ask").
+ *  6. Strong whole-issue claim older than 45 days with no closing PR -> RISKY,
+ *     flag "stale_claim". The claimant probably walked away but nobody
+ *     knows for sure (seen on modelcontextprotocol/python-sdk#3287,
+ *     claimed 2026-08-11, never opened a PR). A closing PR, open or not,
+ *     counts as "a PR was opened" here; a mere mention does not. Stale
+ *     partial claims get the same treatment, scoped.
+ *  7. Any hard gate (assignment / vouch / collaborators_only) with no
+ *     assignee -> GATED. The code might be welcome, but the ritual blocks
+ *     you: PrefectHQ/fastmcp#5718 (assignment), triggerdotdev/trigger.dev#5016 (vouch).
+ *  8. No activity for 180+ days -> STALE. The issue is probably abandoned,
+ *     the repro may not even hold on current code.
+ *  9. Soft claim-first gate (comment before starting, shadcn-labs/pdfcn
+ *     style): never GATED. It caps an otherwise-GO verdict at RISKY with a
+ *     note, following the same downgrade shape as the weak-PR-mention rule.
+ *  10. Otherwise -> GO, unless an open PR only mentions the issue, which
+ *     downgrades GO to RISKY ("verify it is not already being worked").
+ *  11. An open PR referenced in a non-author comment that mentions this
+ *     issue number downgrades an otherwise-GO verdict to RISKY, flag
+ *     "comment-mentioned-pr" ("PR #NNN referenced in comments may already
+ *     cover part of this issue"). A merged one is only an informational
+ *     note; neither can produce TAKEN. Seen on reticlehq/reticle#691.
+ *  12. Partially-addressed: merged PRs that reference the issue number
+ *     (comment-mentioned or linked), or maintainer comments signaling part
+ *     of the work already shipped ("Half addressed", "leaving this open
+ *     for ...", "still open", "part of this is shipped in v..."), mean
+ *     part of the issue is done while the rest stays open. A plain GO
+ *     hides that. Add flag "partially-addressed", cap an otherwise-GO
+ *     verdict at RISKY with a scoping reason; never TAKEN. Seen on
+ *     reticlehq/reticle#894 (half A shipped in v3.1.0 via #905/#915,
+ *     half B still open).
+ */
+import type { IssueSnapshot, VerdictResult } from "./types.js";
+declare const FRESH_CLAIM_DAYS = 45;
+declare const STALE_INACTIVITY_DAYS = 180;
+export declare function scoreIssue(snapshot: IssueSnapshot, now?: Date): VerdictResult;
+/** "/shipped in v/i near an issue reference" is the last pattern; the
+ * four above run on every comment, and this one runs below with its
+ * issue-reference guard. */
+export declare function hasShippedInVersionSignal(comments: {
+    body: string;
+}[], issueNumber: number): boolean;
+export { FRESH_CLAIM_DAYS, STALE_INACTIVITY_DAYS };