@reneturcios/greenlight 0.9.2 → 0.10.0

package/dist/sync.d.ts

@@ -0,0 +1,88 @@
+import { type ClaimsRegistryFile } from "./claims-registry.js";
+export interface CensusPr {
+    owner: string;
+    repo: string;
+    number: number;
+    url: string;
+    title: string;
+    state: "open" | "closed";
+    merged: boolean;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * The authoritative PR census for one author. Paginated; the search API
+ * caps at 1000 results, so maxPages bounds the walk (default 10).
+ */
+export declare function fetchAuthorCensus(author: string, perPage?: number, maxPages?: number): Promise<CensusPr[]>;
+/**
+ * Upsert the census into the registry's known-PRs section. New PRs are
+ * added; known ones get fresh state/title/lastSeen. Returns add/update
+ * counts so callers can report what moved.
+ */
+export declare function upsertKnownPrs(path: string, prs: CensusPr[], nowIso: string): {
+    added: number;
+    updated: number;
+};
+/** One row of an optional tracker file (repo, issue, pr_url, status columns). */
+export interface TrackerRow {
+    repo: string;
+    issue: string;
+    prUrl: string;
+    status: string;
+}
+/**
+ * Parse a tracker file by extension: CSV with a header row, or a JSON
+ * array of objects. Columns/keys: repo, issue, pr_url, status (tolerant
+ * aliases accepted). Throws on an unreadable or unparseable file.
+ */
+export declare function parseTracker(text: string, format: "csv" | "json"): TrackerRow[];
+export declare function loadTrackerFile(path: string): TrackerRow[];
+export interface DriftItem {
+    kind: "unknown-pr" | "state-mismatch" | "stale-claim";
+    repo: string;
+    number: number;
+    url: string;
+    detail: string;
+}
+export interface SyncDrift {
+    unknownPrs: DriftItem[];
+    stateMismatches: DriftItem[];
+    staleClaims: DriftItem[];
+    counts: {
+        census: number;
+        open: number;
+        merged: number;
+        closedUnmerged: number;
+        registryClaims: number;
+        knownPrs: number;
+        trackerRows: number | null;
+    };
+}
+/**
+ * Pure drift computation: census (API truth) vs the local registry and
+ * an optional tracker. A claim counts as linked when its prUrl appears in
+ * the census; a registry PR counts as known when the census confirms it.
+ */
+export declare function computeDrift(census: CensusPr[], registry: ClaimsRegistryFile, tracker: TrackerRow[] | null, staleDays: number, nowMs: number): SyncDrift;
+/** Human drift report: deltas first, counts after. */
+export declare function formatSyncHuman(drift: SyncDrift, author: string): string;
+export declare function syncJson(drift: SyncDrift, author: string): Record<string, unknown>;
+export interface SyncRunOptions {
+    author: string;
+    trackerPath?: string;
+    staleDays?: number;
+    write?: boolean;
+    registryPath?: string;
+    nowMs?: number;
+}
+/** Full sync run: census, drift, optional tracker diff, optional registry write. */
+export declare function runSync(opts: SyncRunOptions): Promise<{
+    drift: SyncDrift;
+    wrote: {
+        added: number;
+        updated: number;
+    } | null;
+    author: string;
+}>;

package/dist/sync.js

@@ -0,0 +1,320 @@
+/**
+ * `greenlight sync`: reconcile the campaign's local memory with the GitHub
+ * API census (v0.10.0).
+ *
+ * Multi-agent field lesson 2026-10-18: several agents now open PRs in
+ * parallel threads, and the local claims registry only knows about PRs
+ * this process created. `sync` pulls the authoritative census
+ * (author:<login> type:pr via the search API) and reports drift:
+ *
+ *   - PRs the registry has never seen (another agent opened them),
+ *   - state mismatches (the registry says open, the API says merged),
+ *   - stale claims (a claim older than --stale-days with no linked PR).
+ *
+ * With --write the census upserts the registry's known-PRs section; with
+ * --tracker <csv|json> it also diffs a tracker file. READS ONLY: sync
+ * never posts, claims, or closes anything on GitHub.
+ */
+import { readFileSync } from "node:fs";
+import { apiGet } from "./github.js";
+import { defaultRegistryPath, loadRegistry, saveRegistry, } from "./claims-registry.js";
+/**
+ * The authoritative PR census for one author. Paginated; the search API
+ * caps at 1000 results, so maxPages bounds the walk (default 10).
+ */
+export async function fetchAuthorCensus(author, perPage = 100, maxPages = 10) {
+    const prs = [];
+    const q = encodeURIComponent(`author:${author} type:pr`);
+    for (let page = 1; page <= maxPages; page++) {
+        const data = (await apiGet(`/search/issues?q=${q}&per_page=${perPage}&page=${page}&sort=updated&order=desc`));
+        const items = data?.items ?? [];
+        for (const i of items) {
+            const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/.exec(i.html_url ?? "");
+            if (!m)
+                continue;
+            prs.push({
+                owner: m[1],
+                repo: m[2],
+                number: Number(m[3]),
+                url: `https://github.com/${m[1]}/${m[2]}/pull/${m[3]}`,
+                title: i.title ?? "",
+                state: i.state === "open" ? "open" : "closed",
+                merged: !!(i.pull_request && i.pull_request.merged_at),
+                author: i.user?.login ?? author,
+                createdAt: i.created_at ?? "",
+                updatedAt: i.updated_at ?? "",
+            });
+        }
+        if (items.length < perPage)
+            break;
+    }
+    return prs;
+}
+/**
+ * Upsert the census into the registry's known-PRs section. New PRs are
+ * added; known ones get fresh state/title/lastSeen. Returns add/update
+ * counts so callers can report what moved.
+ */
+export function upsertKnownPrs(path, prs, nowIso) {
+    const registry = loadRegistry(path);
+    const known = new Map((registry.prs ?? []).map((p) => [p.prUrl.toLowerCase(), p]));
+    let added = 0;
+    let updated = 0;
+    for (const c of prs) {
+        const key = c.url.toLowerCase();
+        const existing = known.get(key);
+        if (existing) {
+            existing.state = c.state;
+            existing.merged = c.merged;
+            existing.title = c.title;
+            existing.lastSeen = nowIso;
+            updated++;
+        }
+        else {
+            known.set(key, {
+                prUrl: c.url,
+                owner: c.owner,
+                repo: c.repo,
+                number: c.number,
+                state: c.state,
+                merged: c.merged,
+                title: c.title,
+                firstSeen: nowIso,
+                lastSeen: nowIso,
+                source: "census",
+            });
+            added++;
+        }
+    }
+    registry.prs = [...known.values()].sort((a, b) => a.repo === b.repo ? a.number - b.number : a.repo.localeCompare(b.repo));
+    saveRegistry(path, registry);
+    return { added, updated };
+}
+const TRACKER_KEYS = {
+    repo: ["repo", "repository"],
+    issue: ["issue", "issue_number", "number"],
+    prUrl: ["pr_url", "prurl", "pr", "pull_request"],
+    status: ["status", "state"],
+};
+function pick(row, keys) {
+    for (const k of keys) {
+        for (const actual of Object.keys(row)) {
+            if (actual.toLowerCase() === k) {
+                const v = row[actual];
+                if (v !== undefined && v !== null)
+                    return String(v);
+            }
+        }
+    }
+    return "";
+}
+/**
+ * Parse a tracker file by extension: CSV with a header row, or a JSON
+ * array of objects. Columns/keys: repo, issue, pr_url, status (tolerant
+ * aliases accepted). Throws on an unreadable or unparseable file.
+ */
+export function parseTracker(text, format) {
+    if (format === "json") {
+        const parsed = JSON.parse(text);
+        if (!Array.isArray(parsed))
+            throw new Error("tracker JSON must be an array of objects");
+        return parsed.map((r) => ({
+            repo: pick(r, TRACKER_KEYS.repo),
+            issue: pick(r, TRACKER_KEYS.issue),
+            prUrl: pick(r, TRACKER_KEYS.prUrl),
+            status: pick(r, TRACKER_KEYS.status),
+        }));
+    }
+    // Minimal CSV: header row, comma-separated, double-quote escaping.
+    const rows = [];
+    let cur = "";
+    let row = [];
+    let inQuotes = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inQuotes) {
+            if (ch === '"' && text[i + 1] === '"') {
+                cur += '"';
+                i++;
+            }
+            else if (ch === '"') {
+                inQuotes = false;
+            }
+            else {
+                cur += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ",") {
+            row.push(cur);
+            cur = "";
+        }
+        else if (ch === "\n" || ch === "\r") {
+            if (ch === "\r" && text[i + 1] === "\n")
+                i++;
+            row.push(cur);
+            cur = "";
+            if (row.some((c) => c.trim().length > 0))
+                rows.push(row);
+            row = [];
+        }
+        else {
+            cur += ch;
+        }
+    }
+    row.push(cur);
+    if (row.some((c) => c.trim().length > 0))
+        rows.push(row);
+    if (rows.length === 0)
+        return [];
+    const header = rows[0].map((h) => h.trim().toLowerCase());
+    const idx = (keys) => {
+        for (const k of keys) {
+            const i = header.indexOf(k);
+            if (i >= 0)
+                return i;
+        }
+        return -1;
+    };
+    const ri = idx(TRACKER_KEYS.repo);
+    const ii = idx(TRACKER_KEYS.issue);
+    const pi = idx(TRACKER_KEYS.prUrl);
+    const si = idx(TRACKER_KEYS.status);
+    return rows.slice(1).map((r) => ({
+        repo: ri >= 0 ? (r[ri] ?? "").trim() : "",
+        issue: ii >= 0 ? (r[ii] ?? "").trim() : "",
+        prUrl: pi >= 0 ? (r[pi] ?? "").trim() : "",
+        status: si >= 0 ? (r[si] ?? "").trim() : "",
+    }));
+}
+export function loadTrackerFile(path) {
+    const text = readFileSync(path, "utf8");
+    const lower = path.toLowerCase();
+    if (lower.endsWith(".json"))
+        return parseTracker(text, "json");
+    if (lower.endsWith(".csv"))
+        return parseTracker(text, "csv");
+    throw new Error(`tracker file must end in .csv or .json: ${path}`);
+}
+/**
+ * Pure drift computation: census (API truth) vs the local registry and
+ * an optional tracker. A claim counts as linked when its prUrl appears in
+ * the census; a registry PR counts as known when the census confirms it.
+ */
+export function computeDrift(census, registry, tracker, staleDays, nowMs) {
+    const censusByUrl = new Map(census.map((c) => [c.url.toLowerCase(), c]));
+    const knownUrls = new Set((registry.prs ?? []).map((p) => p.prUrl.toLowerCase()));
+    const claimPrUrls = new Set(registry.claims.map((c) => (c.prUrl ?? "").toLowerCase()).filter((u) => u.length > 0));
+    const unknownPrs = [];
+    for (const c of census) {
+        const key = c.url.toLowerCase();
+        if (!knownUrls.has(key) && !claimPrUrls.has(key)) {
+            unknownPrs.push({
+                kind: "unknown-pr",
+                repo: `${c.owner}/${c.repo}`,
+                number: c.number,
+                url: c.url,
+                detail: `${c.state}${c.merged ? " (merged)" : ""}: ${c.title}`.trim(),
+            });
+        }
+    }
+    const stateMismatches = [];
+    const checkState = (url, localState, source) => {
+        const c = censusByUrl.get(url.toLowerCase());
+        if (!c)
+            return;
+        const apiState = c.merged ? "merged" : c.state;
+        if (localState.toLowerCase() !== apiState) {
+            stateMismatches.push({
+                kind: "state-mismatch",
+                repo: `${c.owner}/${c.repo}`,
+                number: c.number,
+                url: c.url,
+                detail: `${source} says "${localState}", API says "${apiState}"`,
+            });
+        }
+    };
+    for (const p of registry.prs ?? []) {
+        checkState(p.prUrl, p.merged ? "merged" : p.state, "registry");
+    }
+    if (tracker) {
+        for (const t of tracker) {
+            if (t.prUrl)
+                checkState(t.prUrl, t.status, "tracker");
+        }
+    }
+    const staleClaims = [];
+    const staleMs = staleDays * 24 * 60 * 60 * 1000;
+    for (const cl of registry.claims) {
+        if (cl.prUrl)
+            continue;
+        const age = nowMs - Date.parse(cl.postedAt);
+        if (Number.isFinite(age) && age >= staleMs) {
+            staleClaims.push({
+                kind: "stale-claim",
+                repo: `${cl.owner}/${cl.repo}`,
+                number: cl.number,
+                url: cl.issueUrl,
+                detail: `claimed ${Math.round(age / (24 * 60 * 60 * 1000))}d ago, no linked PR`,
+            });
+        }
+    }
+    return {
+        unknownPrs,
+        stateMismatches,
+        staleClaims,
+        counts: {
+            census: census.length,
+            open: census.filter((c) => c.state === "open").length,
+            merged: census.filter((c) => c.merged).length,
+            closedUnmerged: census.filter((c) => c.state === "closed" && !c.merged).length,
+            registryClaims: registry.claims.length,
+            knownPrs: registry.prs?.length ?? 0,
+            trackerRows: tracker ? tracker.length : null,
+        },
+    };
+}
+/** Human drift report: deltas first, counts after. */
+export function formatSyncHuman(drift, author) {
+    const lines = [];
+    const total = drift.unknownPrs.length + drift.stateMismatches.length + drift.staleClaims.length;
+    lines.push(`**sync: ${total} drift item${total === 1 ? "" : "s"}** (census author:${author})`);
+    const section = (title, items) => {
+        lines.push("");
+        lines.push(`## ${title} (${items.length})`);
+        if (items.length === 0)
+            lines.push("_None._");
+        else
+            for (const i of items)
+                lines.push(`- ${i.repo}#${i.number} — ${i.detail} (${i.url})`);
+    };
+    section("PRs the registry does not know", drift.unknownPrs);
+    section("State mismatches (local vs API truth)", drift.stateMismatches);
+    section("Stale claims (no PR after the window)", drift.staleClaims);
+    lines.push("");
+    const c = drift.counts;
+    lines.push(`_census: ${c.census} PRs (${c.open} open, ${c.merged} merged, ${c.closedUnmerged} closed unmerged); registry: ${c.registryClaims} claims, ${c.knownPrs} known PRs${c.trackerRows === null ? "" : `; tracker: ${c.trackerRows} rows`}._`);
+    return lines.join("\n");
+}
+export function syncJson(drift, author) {
+    return { author, drift };
+}
+/** Full sync run: census, drift, optional tracker diff, optional registry write. */
+export async function runSync(opts) {
+    const registryPath = opts.registryPath ?? defaultRegistryPath();
+    const nowMs = opts.nowMs ?? Date.now();
+    const census = await fetchAuthorCensus(opts.author);
+    let tracker = null;
+    if (opts.trackerPath)
+        tracker = loadTrackerFile(opts.trackerPath);
+    const registry = loadRegistry(registryPath);
+    const drift = computeDrift(census, registry, tracker, opts.staleDays ?? 7, nowMs);
+    let wrote = null;
+    if (opts.write) {
+        wrote = upsertKnownPrs(registryPath, census, new Date(nowMs).toISOString());
+    }
+    return { drift, wrote, author: opts.author };
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/types.d.ts

@@ -181,6 +181,12 @@ export interface RepoSignals {
     repo: string;
     gates: Gate[];
     externalPRMergeRate?: number | null;
+    /**
+     * v0.9.3: the same share as a 0..100 number. Ratio fields in JSON output
+     * always ship both units now (fraction + _pct) so consumers never have
+     * to guess: the fraction keeps its meaning, the _pct is unambiguous.
+     */
+    externalPRMergeRate_pct?: number | null;
     medianFirstReviewHours?: number | null;
     maintainerIssueResponseHours?: number | null;
     openGoodFirstIssueCount?: number | null;
@@ -248,4 +254,13 @@ export interface FrictionReport {
      * median days to merge. Absent when it could not be computed.
      */
     mergeVelocity?: import("./merge-velocity.js").MergeVelocityStats | null;
+    /**
+     * v0.9.3: outsider merge share with an explicit unit contract, because
+     * an implicit fraction was once rendered as a percent downstream.
+     * `outsider_merge_share` is the 0..1 fraction (same meaning as
+     * mergeVelocity.externalShare); `outsider_merge_share_pct` is the same
+     * number on a 0..100 scale, rounded. Both are null when uncomputable.
+     */
+    outsider_merge_share?: number | null;
+    outsider_merge_share_pct?: number | null;
 }

package/package.json

@@ -25,7 +25,7 @@
     "test": "tsx --test test/*.test.ts"
   },
   "type": "module",
-  "version": "0.9.2",
+  "version": "0.10.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.9.2",
+  "version": "0.10.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@reneturcios/greenlight",
-      "version": "0.9.2",
+      "version": "0.10.0",
       "runtimeHint": "npx",
       "packageArguments": [
         {