@oss-autopilot/core 0.44.18 → 0.45.0

package/dist/core/utils.js

@@ -444,3 +444,48 @@ export async function getGitHubTokenAsync() {
     }
     return null;
 }
+/**
+ * GitHub username validation pattern.
+ * Usernames must start with an alphanumeric character, can contain hyphens
+ * (but not consecutive ones and not at the end), and be 1-39 characters.
+ */
+const GITHUB_USERNAME_RE = /^[a-zA-Z0-9](?:[a-zA-Z0-9]|-(?=[a-zA-Z0-9])){0,38}$/;
+/**
+ * Detect the authenticated GitHub username via the `gh` CLI.
+ *
+ * Runs `gh api user --jq '.login'` asynchronously and validates the result
+ * against GitHub's username rules. Never throws — returns `null` on any failure
+ * (gh not installed, not authenticated, invalid output, etc.).
+ *
+ * @returns The GitHub username string, or `null` if detection fails
+ *
+ * @example
+ * const username = await detectGitHubUsername();
+ * if (username) {
+ *   console.log(`Logged in as ${username}`);
+ * }
+ */
+export async function detectGitHubUsername() {
+    try {
+        const login = await new Promise((resolve, reject) => {
+            execFile('gh', ['api', 'user', '--jq', '.login'], { encoding: 'utf-8', timeout: 5000 }, (error, stdout) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(stdout.trim());
+                }
+            });
+        });
+        if (login && GITHUB_USERNAME_RE.test(login)) {
+            debug(MODULE, `Detected GitHub username: ${login}`);
+            return login;
+        }
+        debug(MODULE, `gh api user returned invalid username: "${login}"`);
+        return null;
+    }
+    catch (err) {
+        debug(MODULE, 'detectGitHubUsername failed', err);
+        return null;
+    }
+}

package/dist/formatters/json.d.ts

@@ -3,6 +3,7 @@
  * Provides structured output that can be consumed by scripts and plugins
  */
 import type { FetchedPR, DailyDigest, AgentState, RepoGroup, CommentedIssue, ShelvedPRRef } from '../core/types.js';
+import type { ContributionStats } from '../core/stats.js';
 import type { PRCheckFailure } from '../core/pr-monitor.js';
 import type { SearchPriority } from '../core/issue-discovery.js';
 export interface JsonOutput<T = unknown> {
@@ -193,6 +194,8 @@ export interface IssueListInfo {
 export interface StartupOutput {
     version: string;
     setupComplete: boolean;
+    /** True when username was auto-detected on first run (zero-config). */
+    autoDetected?: boolean;
     authError?: string;
     daily?: DailyOutput;
     /** URL of the interactive SPA dashboard server, when running (e.g., "http://localhost:3000") */
@@ -299,6 +302,11 @@ export interface LocalReposOutput {
     cachedAt: string;
     fromCache: boolean;
 }
+/** Output of the stats command */
+export interface StatsOutput extends ContributionStats {
+    mergeRateFormatted: string;
+    username: string;
+}
 /**
  * Wrap data in a standard JSON output envelope
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "0.44.18",
+  "version": "0.45.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {