@kud/gh 0.2.0 → 0.4.0

package/dist/inbox.d.ts

@@ -0,0 +1,18 @@
+/** A repo-scoped or account-wide inbox. */
+export type InboxQueryOptions = {
+    /** `owner/name`. Scopes every search to one repository. */
+    repo?: string;
+    /** How far back `recentlyDone` looks. Defaults to 14 days. */
+    doneWithinDays?: number;
+};
+/**
+ * Build the inbox query. Without `repo`, it is account-wide.
+ *
+ * The two qualifiers do NOT compose. `user:@me` means "in repos I own", and
+ * GitHub ANDs search qualifiers — so `user:@me repo:someone-else/x` matches
+ * nothing, and a scoped inbox on a repo you contribute to but do not own would
+ * render empty and read as "nothing to do here". So `repo:` REPLACES
+ * `user:@me` rather than joining it.
+ */
+export declare const buildInboxQuery: ({ repo, doneWithinDays, }?: InboxQueryOptions) => string;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAQA,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAmDD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,4BAG7B,iBAAsB,WAoFxB,CAAA"}

package/dist/inbox.js

@@ -0,0 +1,144 @@
+// The inbox query — one GraphQL round-trip for "what is on my plate": my PRs,
+// review requests, reviews I have given, assigned work, issues and PRs on my
+// repos, and what I closed recently.
+//
+// Query-only by design. Assembling the result into sections is the surface's
+// own vocabulary — cockpit splits home from work, a web dashboard may group by
+// project — so nothing here decides what a section is.
+// computeHealth's precedence needs reviewDecision, mergeable and the check
+// rollup. A fragment that omits them does NOT degrade gracefully — it falls
+// straight through to whatever token is left, so a PR you already sent back
+// renders as "awaiting review" and a failing one renders as quiet. Every PR
+// fragment therefore carries the whole set; none of it is optional.
+const PR_HEALTH = `
+      isDraft reviewDecision mergeable
+      statusCheckRollup { contexts(first: 20) { nodes {
+        ... on CheckRun { name conclusion status }
+        ... on StatusContext { context state }
+      } } }`;
+// Whose turn it is cannot be read off a count, so every comment-bearing edge
+// carries its latest author and timestamp: the conversation, the review bodies,
+// and each thread's last reply. The last commit rides along so a consumer can
+// say whether the author has pushed since being sent back.
+//
+// `__typename` distinguishes a Bot from a User, which a login cannot: GraphQL
+// reports app authors bare (`greptile-apps`), without the `[bot]` suffix REST
+// adds, so there is nothing in the name to match on. A consumer needs it to
+// decide whether a push answers what was said — it does when a machine said it,
+// and does not when a person did. Note it catches GitHub Apps only; a machine
+// ACCOUNT like `raycastbot` is a User and reads as human here.
+const PR_CONVERSATION = `
+      comments(last: 1) { totalCount nodes { author { __typename login } createdAt } }
+      reviews(last: 1) { nodes { author { __typename login } state submittedAt } }
+      reviewThreads(first: 50) { nodes {
+        isResolved
+        comments(last: 1) { totalCount nodes { author { __typename login } createdAt } }
+      } }
+      commits(last: 1) { nodes { commit { committedDate } } }`;
+const ISSUE_CONVERSATION = `
+      comments(last: 1) { totalCount nodes { author { __typename login } createdAt } }`;
+// Fetched so a consumer can tell a `plan` issue from any other — which decides
+// what a delegated session gets handed. Nothing here renders labels.
+const ISSUE_LABELS = `
+      labels(first: 10) { nodes { name } }`;
+/*
+ * Computed per call, never at module scope. A CLI process is short-lived and
+ * would not notice, but a long-running server imports this once and keeps it
+ * for days — a module-level date would freeze "recently done" to the morning
+ * the server booted and quietly stop reporting anything closed since.
+ */
+const sinceDay = (days) => new Date(Date.now() - days * 86400 * 1000).toISOString().slice(0, 10);
+/**
+ * Build the inbox query. Without `repo`, it is account-wide.
+ *
+ * The two qualifiers do NOT compose. `user:@me` means "in repos I own", and
+ * GitHub ANDs search qualifiers — so `user:@me repo:someone-else/x` matches
+ * nothing, and a scoped inbox on a repo you contribute to but do not own would
+ * render empty and read as "nothing to do here". So `repo:` REPLACES
+ * `user:@me` rather than joining it.
+ */
+export const buildInboxQuery = ({ repo, doneWithinDays = 14, } = {}) => {
+    const scope = repo ? `repo:${repo} ` : "";
+    const owned = repo ? "" : "user:@me ";
+    const doneSince = sinceDay(doneWithinDays);
+    return `
+{
+  viewer { login }
+  myPRs: search(query: "${scope}is:pr is:open author:@me", type: ISSUE, first: 100) {
+    nodes { __typename ... on PullRequest {
+      number title createdAt url headRefName
+      repository { nameWithOwner }
+      ${PR_HEALTH}
+      ${PR_CONVERSATION}
+    }}
+  }
+  reviewRequests: search(query: "${scope}is:pr is:open review-requested:@me", type: ISSUE, first: 20) {
+    nodes { __typename ... on PullRequest {
+      number title createdAt url headRefName
+      repository { nameWithOwner }
+      author { login }
+      ${PR_HEALTH}
+      ${PR_CONVERSATION}
+    }}
+  }
+  reviewed: search(query: "${scope}is:pr is:open reviewed-by:@me -author:@me -review-requested:@me", type: ISSUE, first: 20) {
+    nodes { __typename ... on PullRequest {
+      number title createdAt url headRefName
+      repository { nameWithOwner }
+      author { login }
+      ${PR_HEALTH}
+      ${PR_CONVERSATION}
+    }}
+  }
+  assigned: search(query: "${scope}is:open assignee:@me", type: ISSUE, first: 30) {
+    nodes {
+      __typename
+      ... on Issue {
+        number title createdAt url repository { nameWithOwner } author { login }
+        ${ISSUE_CONVERSATION}
+        ${ISSUE_LABELS}
+      }
+      ... on PullRequest {
+        number title createdAt url headRefName repository { nameWithOwner } author { login }
+        ${PR_HEALTH}
+        ${PR_CONVERSATION}
+      }
+    }
+  }
+  repoIssues: search(query: "${scope}${owned}is:issue is:open archived:false", type: ISSUE, first: 30) {
+    nodes { __typename ... on Issue {
+      number title createdAt url
+      repository { nameWithOwner }
+      author { login }
+      ${ISSUE_CONVERSATION}
+      ${ISSUE_LABELS}
+    }}
+  }
+  authoredIssues: search(query: "${scope}is:issue is:open author:@me archived:false", type: ISSUE, first: 30) {
+    nodes { ... on Issue {
+      number title createdAt url
+      repository { nameWithOwner }
+      author { login }
+      ${ISSUE_CONVERSATION}
+      ${ISSUE_LABELS}
+    }}
+  }
+  repoPRs: search(query: "${scope}${owned}is:pr is:open -author:@me archived:false", type: ISSUE, first: 30) {
+    nodes { __typename ... on PullRequest {
+      number title createdAt url headRefName
+      repository { nameWithOwner }
+      author { login }
+      ${PR_HEALTH}
+      ${PR_CONVERSATION}
+    }}
+  }
+  recentlyDone: search(query: "${scope}is:pr author:@me -is:open closed:>=${doneSince}", type: ISSUE, first: 30) {
+    nodes { __typename ... on PullRequest {
+      number title state isDraft createdAt mergedAt closedAt url
+      repository { nameWithOwner }
+    }}
+  }
+}
+`;
+};
+//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,qCAAqC;AACrC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,uDAAuD;AAUvD,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,oEAAoE;AACpE,MAAM,SAAS,GAAG;;;;;YAKN,CAAA;AAEZ,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,2DAA2D;AAC3D,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,+DAA+D;AAC/D,MAAM,eAAe,GAAG;;;;;;;8DAOsC,CAAA;AAE9D,MAAM,kBAAkB,GAAG;uFAC4D,CAAA;AAEvF,+EAA+E;AAC/E,qEAAqE;AACrE,MAAM,YAAY,GAAG;2CACsB,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAChC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAEvE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,IAAI,EACJ,cAAc,GAAG,EAAE,MACE,EAAE,EAAE,EAAE;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAA;IACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;IAE1C,OAAO;;;0BAGiB,KAAK;;;;QAIvB,SAAS;QACT,eAAe;;;mCAGY,KAAK;;;;;QAKhC,SAAS;QACT,eAAe;;;6BAGM,KAAK;;;;;QAK1B,SAAS;QACT,eAAe;;;6BAGM,KAAK;;;;;UAKxB,kBAAkB;UAClB,YAAY;;;;UAIZ,SAAS;UACT,eAAe;;;;+BAIM,KAAK,GAAG,KAAK;;;;;QAKpC,kBAAkB;QAClB,YAAY;;;mCAGe,KAAK;;;;;QAKhC,kBAAkB;QAClB,YAAY;;;4BAGQ,KAAK,GAAG,KAAK;;;;;QAKjC,SAAS;QACT,eAAe;;;iCAGU,KAAK,sCAAsC,SAAS;;;;;;;CAOpF,CAAA;AACD,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./gh.js";
+export * from "./inbox.js";
 export * from "./pr.js";
 export * from "./pr-comments.js";
 export * from "./health.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -12,6 +12,7 @@
 // The deciding test is "is there a query to optimise?": yes → gh api; no →
 // porcelain.
 export * from "./gh.js";
+export * from "./inbox.js";
 export * from "./pr.js";
 export * from "./pr-comments.js";
 export * from "./health.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,mFAAmF;AACnF,2EAA2E;AAC3E,aAAa;AACb,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,mFAAmF;AACnF,2EAA2E;AAC3E,aAAa;AACb,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Surface-agnostic GitHub core — gh CLI primitives, PR review comments, health, and webhook logic.",
   "type": "module",
   "main": "dist/index.js",