@reneturcios/greenlight 0.5.0 → 0.7.0

package/dist/passport.js

@@ -0,0 +1,218 @@
+/**
+ * The contributor passport. Reads the Claim Ledger's public API for the
+ * account's protocol claims (held, completed, expired, queued, over-cap)
+ * and the GitHub search API for merged PRs, and renders one honest page.
+ *
+ * If the Ledger has no file for the account, it says so plainly: a
+ * passport starts with your first protocol claim.
+ */
+import { createRequire } from "node:module";
+const GREENLIGHT_VERSION = (() => {
+    try {
+        return createRequire(import.meta.url)("../package.json").version;
+    }
+    catch {
+        return "unknown";
+    }
+})();
+export function ledgerBaseUrl() {
+    const env = process.env["GREENLIGHT_LEDGER_URL"];
+    return (env && env.trim().length > 0 ? env : "https://cloudcorprecords.github.io/claim-ledger").replace(/\/+$/, "");
+}
+/**
+ * Normalize a Ledger account payload defensively: the Ledger is our own
+ * API and its fields can drift, so unknown shapes degrade to empties
+ * rather than crashing. Whatever is normalized is stated as coming from
+ * the Ledger; whatever is absent is stated as absent.
+ */
+export function normalizeAccount(login, raw) {
+    const empty = { login, activeClaims: [], queuedClaims: [], completedCount: null, expiredCount: null, overCap: null };
+    if (!raw || typeof raw !== "object")
+        return empty;
+    const r = raw;
+    const normClaim = (c) => {
+        if (!c || typeof c !== "object")
+            return null;
+        const o = c;
+        const repo = typeof o["repo"] === "string"
+            ? o["repo"]
+            : typeof o["owner"] === "string" && typeof o["repo_name"] === "string"
+                ? `${o["owner"]}/${o["repo_name"]}`
+                : "unknown/unknown";
+        const issue = typeof o["issue"] === "number" ? o["issue"] : typeof o["number"] === "number" ? o["number"] : 0;
+        return {
+            repo,
+            issue,
+            url: typeof o["url"] === "string" && o["url"]
+                ? o["url"]
+                : issue > 0 && repo !== "unknown/unknown"
+                    ? `https://github.com/${repo}/issues/${issue}`
+                    : "",
+            claimedAt: typeof o["claimed_at"] === "string" ? o["claimed_at"] : typeof o["claimedAt"] === "string" ? o["claimedAt"] : "",
+            expiresAt: typeof o["expires_at"] === "string" ? o["expires_at"] : typeof o["expiresAt"] === "string" ? o["expiresAt"] : "",
+            state: typeof o["state"] === "string" ? o["state"] : "active",
+            commentUrl: typeof o["comment_url"] === "string" ? o["comment_url"] : typeof o["commentUrl"] === "string" ? o["commentUrl"] : null,
+        };
+    };
+    const arr = (v) => (Array.isArray(v) ? v.map(normClaim).filter((c) => c !== null) : []);
+    const num = (v) => (typeof v === "number" ? v : null);
+    const bool = (v) => (typeof v === "boolean" ? v : null);
+    return {
+        login,
+        activeClaims: arr(r["active_claims"] ?? r["activeClaims"] ?? r["claims"]),
+        queuedClaims: arr(r["queued_claims"] ?? r["queuedClaims"] ?? r["queue"]),
+        completedCount: num(r["completed_count"] ?? r["completedClaims"]),
+        expiredCount: num(r["expired_count"] ?? r["expiredClaims"]),
+        overCap: bool(r["over_cap"] ?? r["overCap"]),
+    };
+}
+async function defaultFetchAccount(login) {
+    const url = `${ledgerBaseUrl()}/v1/accounts/${encodeURIComponent(login)}.json`;
+    let res;
+    try {
+        res = await fetch(url);
+    }
+    catch {
+        return null;
+    }
+    if (res.status === 404)
+        return null;
+    if (!res.ok)
+        return null;
+    try {
+        return normalizeAccount(login, await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultFetchClaimDetail(repo, issue) {
+    const url = `${ledgerBaseUrl()}/v1/issues/${repo}/${issue}/status.json`;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const claim = data.claim;
+        if (!claim || typeof claim !== "object")
+            return null;
+        return {
+            claimedAt: typeof claim.claimed_at === "string" ? claim.claimed_at : "",
+            expiresAt: typeof claim.expires_at === "string" ? claim.expires_at : "",
+            commentUrl: typeof claim.comment_url === "string" ? claim.comment_url : null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultFetchMergedCount(login) {
+    const q = encodeURIComponent(`author:${login} type:pr is:merged`);
+    try {
+        const res = await fetch(`https://api.github.com/search/issues?q=${q}&per_page=1`, {
+            headers: { "User-Agent": "greenlight", Accept: "application/vnd.github+json" },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.total_count === "number" ? data.total_count : null;
+    }
+    catch {
+        return null;
+    }
+}
+function claimLine(c) {
+    const dates = [c.claimedAt.slice(0, 10), c.expiresAt.slice(0, 10)].filter((d) => d.length > 0).join(" -> ");
+    return `${c.repo}#${c.issue} (${c.state}${dates ? `, ${dates}` : ""}) ${c.commentUrl ? c.commentUrl : c.url}`;
+}
+export async function buildPassport(login, deps = {}, now = new Date()) {
+    const fetchAccount = deps.fetchAccount ?? defaultFetchAccount;
+    const fetchMergedCount = deps.fetchMergedCount ?? defaultFetchMergedCount;
+    const fetchClaimDetail = deps.fetchClaimDetail ?? defaultFetchClaimDetail;
+    const account = await fetchAccount(login).catch(() => null);
+    const mergedPrs = await fetchMergedCount(login).catch(() => null);
+    if (!account) {
+        const markdown = [
+            `# Contributor passport: @${login}`,
+            "",
+            "No passport file for this account in the Claim Ledger yet.",
+            "",
+            "Your passport starts with your first protocol claim: claim an issue with the Greenlight protocol marker " +
+                "(`greenlight claim` drafts it for you) and the Ledger indexes it within 15 minutes.",
+            "",
+            `Ledger: ${ledgerBaseUrl()}. Merged PRs on GitHub: ${mergedPrs === null ? "unknown (lookup failed)" : mergedPrs}.`,
+            "",
+            `_Passport generated by Greenlight v${GREENLIGHT_VERSION}._`,
+        ].join("\n");
+        return {
+            login,
+            found: false,
+            account: null,
+            mergedPrs,
+            honorRatio: "no ledger history",
+            markdown,
+            json: { login, found: false, mergedPrs, ledger: ledgerBaseUrl() },
+        };
+    }
+    // Enrich claims with dates from the per-issue status files. Each
+    // enrichment is independent and best-effort: a missing file leaves the
+    // claim exactly as the account file described it.
+    const enrich = async (claims) => Promise.all(claims.map(async (c) => {
+        if (c.issue <= 0)
+            return c;
+        const detail = await fetchClaimDetail(c.repo, c.issue).catch(() => null);
+        if (!detail)
+            return c;
+        return {
+            ...c,
+            claimedAt: c.claimedAt || detail.claimedAt,
+            expiresAt: c.expiresAt || detail.expiresAt,
+            commentUrl: c.commentUrl ?? detail.commentUrl,
+        };
+    }));
+    account.activeClaims = await enrich(account.activeClaims);
+    account.queuedClaims = await enrich(account.queuedClaims);
+    const completed = account.completedCount ?? account.activeClaims.filter((c) => c.state === "completed").length;
+    const expired = account.expiredCount ?? account.activeClaims.filter((c) => c.state === "expired").length;
+    const historyKnown = account.completedCount !== null || account.expiredCount !== null || account.activeClaims.some((c) => c.state === "completed" || c.state === "expired");
+    const honorRatio = !historyKnown || completed + expired === 0
+        ? "no completed/expired history in the ledger yet"
+        : `${completed} completed vs ${expired} expired (${Math.round((completed / (completed + expired)) * 100)}% completed)`;
+    const lines = [];
+    lines.push(`# Contributor passport: @${login}`);
+    lines.push("");
+    lines.push("## Claim Protocol record");
+    lines.push(`Active protocol claims: ${account.activeClaims.length}`);
+    for (const c of account.activeClaims)
+        lines.push(`- ${claimLine(c)}`);
+    lines.push(`Queued behind others: ${account.queuedClaims.length}`);
+    for (const c of account.queuedClaims)
+        lines.push(`- ${claimLine(c)}`);
+    lines.push(`Claim honor record: ${honorRatio}`);
+    lines.push(`Over the active-claim cap: ${account.overCap === null ? "not reported by the ledger" : account.overCap ? "yes (squatting flag)" : "no"}`);
+    lines.push("");
+    lines.push("## GitHub record");
+    lines.push(`Merged PRs: ${mergedPrs === null ? "unknown (lookup failed)" : mergedPrs}`);
+    lines.push("");
+    lines.push(`Ledger: ${ledgerBaseUrl()}. Checked ${now.toISOString().slice(0, 10)}.`);
+    lines.push(`_Passport generated by Greenlight v${GREENLIGHT_VERSION}._`);
+    return {
+        login,
+        found: true,
+        account,
+        mergedPrs,
+        honorRatio,
+        markdown: lines.join("\n"),
+        json: {
+            login,
+            found: true,
+            ledger: ledgerBaseUrl(),
+            activeClaims: account.activeClaims,
+            queuedClaims: account.queuedClaims,
+            honorRatio,
+            overCap: account.overCap,
+            mergedPrs,
+        },
+    };
+}
+//# sourceMappingURL=passport.js.map

package/dist/passport.js.map

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

package/integrations/README.md

@@ -8,6 +8,18 @@ and never post anything to GitHub without the human's go-ahead.
 
 ## Install per tool
 
+The fastest path is the one-command setup, run in your project:
+
+```bash
+npx @reneturcios/greenlight init --agent claude-code
+```
+
+(use `cursor`, `copilot`, `windsurf`, or `cline` for the other tools). Init
+writes the MCP config and the instruction snippet for you, then tells you
+what to restart. After that, run `greenlight doctor` to verify the setup.
+
+The manual alternative, if you would rather copy files yourself:
+
 | Tool | Copy this file | To this destination |
 |---|---|---|
 | Claude Code | `claude-code/.mcp.json` | your project root as `.mcp.json` |
@@ -29,7 +41,7 @@ without it the tools still work but share the small anonymous budget.
 ## Verify it worked
 
 Ask the agent: "list your MCP tools." You should see the `greenlight`
-server with all 13 tools:
+server with all 15 tools:
 
 - `check_issue` — verdict on whether an issue is landable (GO / RISKY / TAKEN / GATED / STALE)
 - `scan_repo` — find starter issues worth working in a repo
@@ -44,6 +56,8 @@ server with all 13 tools:
 - `claim_status` — Claim Protocol pre-flight for one issue: who holds it, until when, who is queued, competing PRs, gates, whether the repo honors the protocol
 - `preflight` — the one-call answer: claim_status plus the repo friction summary
 - `verify_comment` — draft the verified-finding comment for maintainer-only repos (draft only, never posts)
+- `babysit_prs` — watch your open PRs: one prioritized action list (needs you now, waiting on them, quiet), diffed against stored watermarks
+- `evidence_pack` — the Verified PR evidence pack for one PR: guard verdict, CI triage, review triage, protocol status of linked issues, every claim citing its source
 
 ## Format notes
 

package/integrations/claude-code/CLAUDE.snippet.md

@@ -7,10 +7,11 @@ your project's CLAUDE.md (or keep the file and reference it from CLAUDE.md).
 ## Greenlight: check before you open a PR
 
 You have the Greenlight MCP server connected (server name: greenlight,
-12 tools: check_issue, scan_repo, repo_friction, claim_issue, prep_issue,
+15 tools: check_issue, scan_repo, repo_friction, claim_issue, prep_issue,
 open_pr, ci_triage, review_triage, guard_pr, repo_digest, claim_status,
-preflight). It answers one question at every step:
-is this contribution worth doing, and is the problem mine?
+preflight, verify_comment, babysit_prs, evidence_pack). It answers one
+question at every step: is this contribution worth doing, and is the
+problem mine?
 
 Rules:
 
@@ -22,18 +23,28 @@ Rules:
      start coding.
    - If the verdict is RISKY: explain the risk and ask before continuing.
    - If the verdict is GO: continue.
-2. Before claiming an issue or setting up to work it, call `prep_issue`
-   (dry run) to learn the repo's exact CLA path, house rules, changeset
-   convention, and whether the fix even lives in this repo. Report the
-   plan; do not create forks or branches without being asked.
-3. If the PR's CI goes red: call `ci_triage` BEFORE changing any code, and
+2. Before claiming an issue, run the claim through `preflight` (or
+   `claim_status`): who holds the issue, until when, who is queued. Join
+   the queue rather than duplicating work that is already held. Then call
+   `prep_issue` (dry run) to learn the repo's exact CLA path, house rules,
+   changeset convention, and whether the fix even lives in this repo.
+   Report the plan; do not create forks or branches without being asked.
+3. If the repo takes no outside PRs (the check says the contribution is a
+   verified comment): draft with `verify_comment` from your notes, filling
+   every section you can. Do not open a PR there.
+4. If the PR's CI goes red: call `ci_triage` BEFORE changing any code, and
    tell the human whether each failure is pre-existing, likely yours,
    indeterminate, or an external blocker.
-4. After review comments arrive: call `review_triage`. Fix likely-real
+5. After review comments arrive: call `review_triage`. Fix likely-real
    findings first, present needs-decision items to the human, and push
    back on likely-noise only with the evidence the tool gives you. The
    drafts are yours to adapt; the tool never posts them.
-5. NEVER post claim comments, open PRs, or write anything to GitHub without
+6. When the human asks for proof a PR is sound: assemble `evidence_pack`
+   and present it. Every claim in the pack cites its source.
+7. To check on the human's open PRs without being asked about each one:
+   call `babysit_prs`. Report the needs-you-now items first; summarize
+   the waiting-on-them ones in one line each.
+8. NEVER post claim comments, open PRs, or write anything to GitHub without
    the human's explicit go-ahead. Drafts are output only.
 
 Tip: set GITHUB_TOKEN in your environment for the higher GitHub API rate

package/integrations/cline/README.md

@@ -7,7 +7,7 @@ file form is:
 
 Copy the `cline_mcp_settings.json` file in this folder there (merging with
 any servers you already have), then check the Cline "MCP Servers" panel:
-the `greenlight` server should list 12 tools. The `disabled: false` field is
+the `greenlight` server should list 15 tools. The `disabled: false` field is
 Cline's way of keeping the server enabled without deleting it.
 
 Workflow: see the integrations README — your agent checks Greenlight

package/integrations/copilot/copilot-instructions.snippet.md

@@ -9,7 +9,8 @@ it does not exist).
 
 You have the Greenlight MCP server connected (server `greenlight`, tools:
 check_issue, scan_repo, repo_friction, claim_issue, prep_issue, open_pr,
-ci_triage, review_triage, guard_pr, repo_digest, claim_status, preflight).
+ci_triage, review_triage, guard_pr, repo_digest, claim_status, preflight,
+verify_comment, babysit_prs, evidence_pack).
 Apply these instructions whenever working on a
 pull request to an open source project:
 
@@ -17,14 +18,23 @@ pull request to an open source project:
    issue URL. If the verdict is TAKEN or GATED, stop and tell the user why,
    quoting the reasons. Never start work on a TAKEN or GATED issue without
    being told to.
-2. Before claiming or setting up work, call `prep_issue` (dry run) to learn
-   the repo's exact CLA path, house rules, and changeset convention. Report
-   the plan; do not create forks or branches unasked.
-3. If the PR's CI goes red, call `ci_triage` before changing code, and tell
+2. Before claiming an issue, run it through `preflight` (or
+   `claim_status`): who holds the issue, until when, who is queued. Join
+   the queue instead of duplicating held work. Then call `prep_issue` (dry
+   run) to learn the repo's exact CLA path, house rules, and changeset
+   convention. Report the plan; do not create forks or branches unasked.
+3. If the repo takes no outside PRs (the check says the contribution is a
+   verified comment): draft with `verify_comment` from your notes. Do not
+   open a PR there.
+4. If the PR's CI goes red, call `ci_triage` before changing code, and tell
    the user whether each failure is pre-existing, likely theirs,
    indeterminate, or an external blocker.
-4. After review comments arrive, call `review_triage`. Fix likely-real
+5. After review comments arrive, call `review_triage`. Fix likely-real
    findings first; bring needs-decision items to the user; push back on
    likely-noise only with the tool's evidence. Drafts are output only.
-5. Never post claim comments, open PRs, or write anything to GitHub without
+6. When the user asks for proof a PR is sound, assemble `evidence_pack`
+   and present it.
+7. To check on the user's open PRs, call `babysit_prs` and lead with the
+   needs-you-now items.
+8. Never post claim comments, open PRs, or write anything to GitHub without
    the user's explicit go-ahead.

package/integrations/cursor/greenlight.mdc

@@ -7,7 +7,8 @@ alwaysApply: false
 
 You have the Greenlight MCP server connected (server `greenlight`, tools:
 check_issue, scan_repo, repo_friction, claim_issue, prep_issue, open_pr,
-ci_triage, review_triage, guard_pr, repo_digest, claim_status, preflight).
+ci_triage, review_triage, guard_pr, repo_digest, claim_status, preflight,
+verify_comment, babysit_prs, evidence_pack).
 Apply these rules whenever the user is working on
 a pull request to an open source project:
 
@@ -15,14 +16,23 @@ a pull request to an open source project:
    issue URL. If the verdict is TAKEN or GATED, stop and tell the user why,
    quoting the reasons. Never start work on a TAKEN or GATED issue without
    being told to.
-2. Before claiming or setting up work, call `prep_issue` (dry run) to learn
-   the repo's exact CLA path, house rules, and changeset convention. Report
-   the plan; do not create forks or branches unasked.
-3. If the PR's CI goes red, call `ci_triage` before changing code, and tell
+2. Before claiming an issue, run it through `preflight` (or
+   `claim_status`): who holds the issue, until when, who is queued. Join
+   the queue instead of duplicating held work. Then call `prep_issue` (dry
+   run) to learn the repo's exact CLA path, house rules, and changeset
+   convention. Report the plan; do not create forks or branches unasked.
+3. If the repo takes no outside PRs (the check says the contribution is a
+   verified comment): draft with `verify_comment` from your notes. Do not
+   open a PR there.
+4. If the PR's CI goes red, call `ci_triage` before changing code, and tell
    the user whether each failure is pre-existing, likely theirs,
    indeterminate, or an external blocker.
-4. After review comments arrive, call `review_triage`. Fix likely-real
+5. After review comments arrive, call `review_triage`. Fix likely-real
    findings first; bring needs-decision items to the user; push back on
    likely-noise only with the tool's evidence. Drafts are output only.
-5. Never post claim comments, open PRs, or write anything to GitHub without
+6. When the user asks for proof a PR is sound, assemble `evidence_pack`
+   and present it.
+7. To check on the user's open PRs, call `babysit_prs` and lead with the
+   needs-you-now items.
+8. Never post claim comments, open PRs, or write anything to GitHub without
    the user's explicit go-ahead.

package/integrations/windsurf/README.md

@@ -6,7 +6,7 @@ Windsurf's global MCP config lives at:
 
 Copy the `mcp_config.json` file in this folder there (merging with any
 servers you already have), then restart Windsurf and check its MCP panel:
-the `greenlight` server should list 12 tools. Newer Windsurf versions also
+the `greenlight` server should list 15 tools. Newer Windsurf versions also
 accept a project-level `.windsurf/mcp.json` file using the same
 `mcpServers` format.
 

package/package.json

@@ -25,7 +25,7 @@
     "test": "tsx --test test/*.test.ts"
   },
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "mcpName": "io.github.CloudCorpRecords/greenlight",
   "publishConfig": {
     "access": "public"

package/server.json

@@ -6,13 +6,13 @@
     "url": "https://github.com/CloudCorpRecords/greenlight",
     "source": "github"
   },
-  "version": "0.5.0",
+  "version": "0.7.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@reneturcios/greenlight",
-      "version": "0.5.0",
+      "version": "0.7.0",
       "runtimeHint": "npx",
       "packageArguments": [
         {