@growthub/cli 0.6.0 → 0.6.2

package/dist/fleet/types.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Fleet-level fork operations — canonical types.
+ *
+ * Fleet is a pure read/plan composition layer over the Self-Healing Fork
+ * Sync Agent primitives: listKitForkRegistrations, detectKitForkDrift,
+ * readKitForkPolicy, listKitForkSyncJobs, readKitForkTrace, buildKitForkHealPlan.
+ *
+ * It introduces NO new storage, NO new transport, NO new auth surface. Every
+ * field below is derived at read time from already-durable in-fork state.
+ */
+import type { KitForkPolicy } from "../kits/fork-policy.js";
+import type { KitForkDriftReport, KitForkHealPlan, KitForkSyncJob, KitForkRegistration, KitDriftSeverity } from "../kits/fork-types.js";
+export type ForkHealthLevel = "clean" | "drift-minor" | "drift-major" | "awaiting-confirmation" | "error" | "unknown";
+export interface ForkSummary {
+    forkId: string;
+    kitId: string;
+    label?: string;
+    forkPath: string;
+    baseVersion: string;
+    upstreamVersion?: string;
+    lastSyncedAt?: string;
+    driftSeverity: KitDriftSeverity;
+    hasUpstreamUpdate: boolean;
+    fileDriftCount: number;
+    packageDriftCount: number;
+    customSkillCount: number;
+    /** policy.remoteSyncMode surfaced for at-a-glance fleet review */
+    remoteSyncMode: KitForkPolicy["remoteSyncMode"];
+    autoApprove: KitForkPolicy["autoApprove"];
+    autoApproveDepUpdates: KitForkPolicy["autoApproveDepUpdates"];
+    untouchableCount: number;
+    /** Last heal job status + timestamps */
+    lastJob?: {
+        jobId: string;
+        status: KitForkSyncJob["status"];
+        createdAt: string;
+        completedAt?: string;
+        appliedCount?: number;
+        skippedCount?: number;
+        errorCount?: number;
+    };
+    /** Number of jobs currently parked awaiting_confirmation */
+    pendingConfirmationJobs: number;
+    /** Most recent remote event type from trace, when applicable */
+    lastRemoteEvent?: "remote_connected" | "remote_pushed" | "remote_pr_opened" | "conflict_encountered" | null;
+    lastRemoteEventAt?: string;
+    /** Remote binding at-a-glance */
+    remote?: {
+        owner: string;
+        repo: string;
+        defaultBranch: string;
+        lastPushedAt?: string;
+        lastHealPr?: {
+            number: number;
+            htmlUrl: string;
+        };
+    };
+    health: ForkHealthLevel;
+}
+export interface FleetSummary {
+    generatedAt: string;
+    totalForks: number;
+    byHealth: Record<ForkHealthLevel, number>;
+    bySeverity: Record<KitDriftSeverity, number>;
+    byKit: Record<string, number>;
+    forksWithRemote: number;
+    forksAwaitingConfirmation: number;
+    pendingApprovalCount: number;
+    forks: ForkSummary[];
+}
+/**
+ * Human-readable drift breakdown for a single fork. Produced by projecting
+ * a KitForkDriftReport through the fork's KitForkPolicy so operators can
+ * quickly distinguish:
+ *   - what changed upstream (new files we can safely add)
+ *   - what upstream modified but is safe because we can align (manifest)
+ *   - what was skipped because the user modified or protected it
+ *   - what remains unresolved (deleted upstream, user customizations, etc.)
+ */
+export interface DriftArtifactSummary {
+    forkId: string;
+    kitId: string;
+    fromVersion: string;
+    toVersion: string;
+    severity: KitDriftSeverity;
+    buckets: {
+        /** Upstream-added scaffold the heal can safely add. */
+        safeAdditions: DriftEntry[];
+        /** Upstream-modified files the heal can align (manifest, deps). */
+        safeUpdates: DriftEntry[];
+        /** User-modified files the heal will skip (preservedPaths). */
+        skippedUserModified: DriftEntry[];
+        /** Files declared untouchable by policy — never modified. */
+        skippedUntouchable: DriftEntry[];
+        /** Files flagged for explicit confirmation per policy. */
+        needsConfirmation: DriftEntry[];
+        /** Detected user-authored custom skills — noted, never mutated. */
+        customSkills: DriftEntry[];
+        /** Upstream deleted the file — user must decide. */
+        unresolvedUpstreamDeletion: DriftEntry[];
+        /** Package dep additions. */
+        packageAdditions: PackageDriftEntry[];
+        /** Package dep upgrades (additive-only by default). */
+        packageUpgrades: PackageDriftEntry[];
+    };
+    packageDriftCount: number;
+    fileDriftCount: number;
+}
+export interface DriftEntry {
+    path: string;
+    note: string;
+}
+export interface PackageDriftEntry {
+    packageName: string;
+    fromVersion: string | null;
+    toVersion: string;
+    changeType: "added" | "updated" | "removed";
+}
+export interface ApprovalQueueEntry {
+    jobId: string;
+    forkId: string;
+    kitId: string;
+    forkLabel?: string;
+    createdAt: string;
+    pendingPaths: string[];
+    plan: KitForkHealPlan;
+}
+/**
+ * A durable, human-reviewable plan document produced by an agent.
+ * The document is materialised as a trace event and optionally rendered to
+ * the user; it is NEVER applied automatically — the operator must explicitly
+ * resume via `growthub kit fork heal <fork-id>` or `fleet heal`.
+ */
+export interface AgentHealPlanDocument {
+    forkId: string;
+    kitId: string;
+    generatedAt: string;
+    summary: string;
+    driftReport: KitForkDriftReport;
+    plan: KitForkHealPlan;
+    artifactBreakdown: DriftArtifactSummary;
+    policySnapshot: KitForkPolicy;
+    /** Paths the agent wants the operator to confirm before applying. */
+    awaitsConfirmation: string[];
+    /** What the agent would do, in narrative form, suitable for reading aloud. */
+    narrative: string[];
+    registrationAtDraftTime: KitForkRegistration;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fleet/types.d.ts.map

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

package/dist/fleet/types.js

@@ -0,0 +1,12 @@
+/**
+ * Fleet-level fork operations — canonical types.
+ *
+ * Fleet is a pure read/plan composition layer over the Self-Healing Fork
+ * Sync Agent primitives: listKitForkRegistrations, detectKitForkDrift,
+ * readKitForkPolicy, listKitForkSyncJobs, readKitForkTrace, buildKitForkHealPlan.
+ *
+ * It introduces NO new storage, NO new transport, NO new auth surface. Every
+ * field below is derived at read time from already-durable in-fork state.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/fleet/types.js.map

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

package/dist/github/client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GitHub REST + device-flow client
+ *
+ * Thin, dependency-free wrapper around the GitHub REST API and OAuth device
+ * flow endpoints. Enough surface to power:
+ *   - `growthub github login`    (device flow + PAT fallback)
+ *   - `growthub github whoami`
+ *   - `growthub kit fork create` (one-click fork)
+ *   - `growthub kit fork push`   (push heal branch + open PR)
+ */
+import type { CliGithubProfile, GithubDeviceFlowStart, GithubDeviceFlowPoll, GithubForkResult, GithubRepoRef } from "./types.js";
+/** Default OAuth client ID for the CLI. Override via GROWTHUB_GITHUB_CLIENT_ID. */
+export declare const DEFAULT_GITHUB_CLIENT_ID = "growthub-cli-public";
+export declare function resolveGithubClientId(): string;
+export declare function startDeviceFlow(opts?: {
+    clientId?: string;
+    scope?: string[];
+}): Promise<GithubDeviceFlowStart>;
+export declare function pollDeviceFlow(deviceCode: string, opts?: {
+    clientId?: string;
+}): Promise<GithubDeviceFlowPoll>;
+export declare function fetchAuthenticatedUser(accessToken: string): Promise<CliGithubProfile>;
+export declare function createFork(accessToken: string, opts: {
+    upstream: GithubRepoRef;
+    destinationOrg?: string;
+    forkName?: string;
+    defaultBranchOnly?: boolean;
+}): Promise<GithubForkResult>;
+export declare function openPullRequest(accessToken: string, opts: {
+    repo: GithubRepoRef;
+    head: string;
+    base: string;
+    title: string;
+    body?: string;
+    draft?: boolean;
+}): Promise<{
+    number: number;
+    htmlUrl: string;
+}>;
+/** Parse "owner/repo" or a full GitHub URL into a GithubRepoRef. */
+export declare function parseRepoRef(raw: string): GithubRepoRef;
+//# sourceMappingURL=client.d.ts.map

package/dist/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAeD,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwBjC;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuChC;AAMD,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc3F;AAMD,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB9C;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAOvD"}

package/dist/github/client.js

@@ -0,0 +1,174 @@
+/**
+ * GitHub REST + device-flow client
+ *
+ * Thin, dependency-free wrapper around the GitHub REST API and OAuth device
+ * flow endpoints. Enough surface to power:
+ *   - `growthub github login`    (device flow + PAT fallback)
+ *   - `growthub github whoami`
+ *   - `growthub kit fork create` (one-click fork)
+ *   - `growthub kit fork push`   (push heal branch + open PR)
+ */
+const GITHUB_API_BASE = "https://api.github.com";
+const GITHUB_OAUTH_BASE = "https://github.com";
+/** Default OAuth client ID for the CLI. Override via GROWTHUB_GITHUB_CLIENT_ID. */
+export const DEFAULT_GITHUB_CLIENT_ID = "growthub-cli-public";
+export function resolveGithubClientId() {
+    return process.env.GROWTHUB_GITHUB_CLIENT_ID?.trim() || DEFAULT_GITHUB_CLIENT_ID;
+}
+function authHeader(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        "User-Agent": "growthub-cli",
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+    };
+}
+// ---------------------------------------------------------------------------
+// OAuth device flow
+// ---------------------------------------------------------------------------
+export async function startDeviceFlow(opts) {
+    const clientId = opts?.clientId ?? resolveGithubClientId();
+    const scope = (opts?.scope ?? ["repo", "read:user", "user:email"]).join(" ");
+    const res = await fetch(`${GITHUB_OAUTH_BASE}/login/device/code`, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": "growthub-cli",
+        },
+        body: JSON.stringify({ client_id: clientId, scope }),
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub device flow init failed: ${res.status} ${res.statusText}`);
+    }
+    const body = (await res.json());
+    return {
+        deviceCode: String(body.device_code ?? ""),
+        userCode: String(body.user_code ?? ""),
+        verificationUri: String(body.verification_uri ?? ""),
+        expiresInSec: Number(body.expires_in ?? 900),
+        pollIntervalSec: Number(body.interval ?? 5),
+    };
+}
+export async function pollDeviceFlow(deviceCode, opts) {
+    const clientId = opts?.clientId ?? resolveGithubClientId();
+    const res = await fetch(`${GITHUB_OAUTH_BASE}/login/oauth/access_token`, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": "growthub-cli",
+        },
+        body: JSON.stringify({
+            client_id: clientId,
+            device_code: deviceCode,
+            grant_type: "urn:ietf:params:oauth:grant-type:device_code",
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub device flow poll failed: ${res.status} ${res.statusText}`);
+    }
+    const body = (await res.json());
+    const error = typeof body.error === "string" ? body.error : null;
+    if (error === "authorization_pending")
+        return { status: "pending" };
+    if (error === "slow_down") {
+        return { status: "slow_down", nextPollIntervalSec: Number(body.interval ?? 10) };
+    }
+    if (error === "expired_token")
+        return { status: "expired" };
+    if (error === "access_denied")
+        return { status: "denied" };
+    const accessToken = typeof body.access_token === "string" ? body.access_token : null;
+    if (!accessToken)
+        return { status: "pending" };
+    const scopes = typeof body.scope === "string" ? body.scope.split(/[,\s]+/).filter(Boolean) : [];
+    const token = {
+        version: 1,
+        accessToken,
+        authMode: "device-flow",
+        scopes,
+        issuedAt: new Date().toISOString(),
+    };
+    return { status: "authorized", token };
+}
+// ---------------------------------------------------------------------------
+// Authenticated user
+// ---------------------------------------------------------------------------
+export async function fetchAuthenticatedUser(accessToken) {
+    const res = await fetch(`${GITHUB_API_BASE}/user`, { headers: authHeader(accessToken) });
+    if (!res.ok) {
+        throw new Error(`GET /user failed: ${res.status} ${res.statusText}`);
+    }
+    const body = (await res.json());
+    return {
+        login: String(body.login ?? ""),
+        userId: Number(body.id ?? 0),
+        name: typeof body.name === "string" ? body.name : undefined,
+        email: typeof body.email === "string" ? body.email : undefined,
+        avatarUrl: typeof body.avatar_url === "string" ? body.avatar_url : undefined,
+        refreshedAt: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Repo / fork operations
+// ---------------------------------------------------------------------------
+export async function createFork(accessToken, opts) {
+    const body = {};
+    if (opts.destinationOrg)
+        body.organization = opts.destinationOrg;
+    if (opts.forkName)
+        body.name = opts.forkName;
+    if (opts.defaultBranchOnly)
+        body.default_branch_only = true;
+    const res = await fetch(`${GITHUB_API_BASE}/repos/${opts.upstream.owner}/${opts.upstream.repo}/forks`, {
+        method: "POST",
+        headers: { ...authHeader(accessToken), "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok && res.status !== 202) {
+        throw new Error(`Fork create failed: ${res.status} ${res.statusText}`);
+    }
+    const parsed = (await res.json());
+    const owner = parsed.owner?.login;
+    const name = parsed.name;
+    return {
+        fork: { owner, repo: name },
+        cloneUrl: String(parsed.clone_url ?? `https://github.com/${owner}/${name}.git`),
+        htmlUrl: String(parsed.html_url ?? `https://github.com/${owner}/${name}`),
+        defaultBranch: String(parsed.default_branch ?? "main"),
+    };
+}
+export async function openPullRequest(accessToken, opts) {
+    const res = await fetch(`${GITHUB_API_BASE}/repos/${opts.repo.owner}/${opts.repo.repo}/pulls`, {
+        method: "POST",
+        headers: { ...authHeader(accessToken), "Content-Type": "application/json" },
+        body: JSON.stringify({
+            title: opts.title,
+            head: opts.head,
+            base: opts.base,
+            body: opts.body ?? "",
+            draft: opts.draft ?? true,
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`Open PR failed: ${res.status} ${res.statusText}`);
+    }
+    const body = (await res.json());
+    return {
+        number: Number(body.number ?? 0),
+        htmlUrl: String(body.html_url ?? ""),
+    };
+}
+/** Parse "owner/repo" or a full GitHub URL into a GithubRepoRef. */
+export function parseRepoRef(raw) {
+    const s = raw.trim();
+    const urlMatch = s.match(/github\.com[\/:]([^\/]+)\/([^\/\.]+)(?:\.git)?$/i);
+    if (urlMatch)
+        return { owner: urlMatch[1], repo: urlMatch[2].replace(/\.git$/, "") };
+    const slashMatch = s.match(/^([^\/\s]+)\/([^\/\s]+)$/);
+    if (slashMatch)
+        return { owner: slashMatch[1], repo: slashMatch[2].replace(/\.git$/, "") };
+    throw new Error(`Unable to parse GitHub repo reference: ${raw}`);
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

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

package/dist/github/token-store.d.ts

@@ -0,0 +1,11 @@
+import type { CliGithubToken, CliGithubProfile } from "./types.js";
+export declare function readGithubToken(): CliGithubToken | null;
+export declare function writeGithubToken(token: CliGithubToken): void;
+export declare function clearGithubToken(): void;
+export declare function isGithubTokenExpired(token: CliGithubToken | null): boolean;
+export declare function readGithubProfile(): CliGithubProfile | null;
+export declare function writeGithubProfile(profile: CliGithubProfile): void;
+export declare function clearGithubProfile(): void;
+/** Describe where the token is persisted on disk (for whoami / status output). */
+export declare function describeGithubTokenPath(): string;
+//# sourceMappingURL=token-store.d.ts.map

package/dist/github/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../../src/github/token-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiBnE,wBAAgB,eAAe,IAAI,cAAc,GAAG,IAAI,CAUvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAG5D;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAM1E;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,GAAG,IAAI,CAQ3D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGlE;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/github/token-store.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import { resolveGithubHomeDir, resolveGithubTokenPath, resolveGithubProfilePath } from "../config/github-home.js";
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+function atomicWrite(filePath, body) {
+    const tmp = `${filePath}.tmp`;
+    fs.writeFileSync(tmp, body, { encoding: "utf8", mode: 0o600 });
+    fs.renameSync(tmp, filePath);
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch {
+        /* best-effort on platforms where chmod is unavailable */
+    }
+}
+export function readGithubToken() {
+    const p = resolveGithubTokenPath();
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(p, "utf8"));
+        if (!parsed?.accessToken)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeGithubToken(token) {
+    ensureDir(resolveGithubHomeDir());
+    atomicWrite(resolveGithubTokenPath(), JSON.stringify(token, null, 2) + "\n");
+}
+export function clearGithubToken() {
+    const p = resolveGithubTokenPath();
+    if (fs.existsSync(p))
+        fs.rmSync(p, { force: true });
+}
+export function isGithubTokenExpired(token) {
+    if (!token)
+        return true;
+    if (!token.expiresAt)
+        return false;
+    const expiresAtMs = new Date(token.expiresAt).getTime();
+    if (!Number.isFinite(expiresAtMs))
+        return false;
+    return Date.now() >= expiresAtMs;
+}
+export function readGithubProfile() {
+    const p = resolveGithubProfilePath();
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeGithubProfile(profile) {
+    ensureDir(resolveGithubHomeDir());
+    atomicWrite(resolveGithubProfilePath(), JSON.stringify(profile, null, 2) + "\n");
+}
+export function clearGithubProfile() {
+    const p = resolveGithubProfilePath();
+    if (fs.existsSync(p))
+        fs.rmSync(p, { force: true });
+}
+/** Describe where the token is persisted on disk (for whoami / status output). */
+export function describeGithubTokenPath() {
+    return resolveGithubTokenPath();
+}
+//# sourceMappingURL=token-store.js.map

package/dist/github/token-store.js.map

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

package/dist/github/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * GitHub integration — canonical types.
+ *
+ * First-party native GitHub surface powering one-click fork creation, remote
+ * synchronisation, and PR-based heal publication for the Fork Sync Agent.
+ */
+export type GithubAuthMode = "device-flow" | "pat" | "env";
+export interface CliGithubToken {
+    version: 1;
+    /** OAuth access token or personal access token. */
+    accessToken: string;
+    /** How the token was obtained — informational only. */
+    authMode: GithubAuthMode;
+    /** OAuth scopes granted (when known). */
+    scopes: string[];
+    /** Authenticated login (e.g. "octocat"). */
+    login?: string;
+    /** Numeric GitHub user id, if resolved at auth time. */
+    userId?: number;
+    /** ISO issuance timestamp. */
+    issuedAt: string;
+    /** ISO expiration, when known. GitHub PATs can be infinite. */
+    expiresAt?: string;
+}
+export interface CliGithubProfile {
+    login: string;
+    userId: number;
+    name?: string;
+    email?: string;
+    avatarUrl?: string;
+    defaultOrg?: string;
+    refreshedAt: string;
+}
+export interface GithubRepoRef {
+    owner: string;
+    repo: string;
+}
+export interface GithubForkSpec {
+    /** Upstream repo we are forking from. */
+    upstream: GithubRepoRef;
+    /** Override destination (defaults to auth user's account). */
+    destinationOrg?: string;
+    /** Rename the fork at creation time. */
+    forkName?: string;
+    /** Fork only the default branch if true (GitHub option). */
+    defaultBranchOnly?: boolean;
+}
+export interface GithubForkResult {
+    fork: GithubRepoRef;
+    /** Git clone URL of the fork. */
+    cloneUrl: string;
+    /** HTML URL for browser view. */
+    htmlUrl: string;
+    /** Default branch name on the fork. */
+    defaultBranch: string;
+}
+export interface GithubDeviceFlowStart {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    expiresInSec: number;
+    pollIntervalSec: number;
+}
+export interface GithubDeviceFlowPoll {
+    status: "pending" | "slow_down" | "authorized" | "expired" | "denied";
+    token?: CliGithubToken;
+    nextPollIntervalSec?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/github/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/github/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,cAAc,CAAC;IACzB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,EAAE,aAAa,CAAC;IACxB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/github/types.js

@@ -0,0 +1,8 @@
+/**
+ * GitHub integration — canonical types.
+ *
+ * First-party native GitHub surface powering one-click fork creation, remote
+ * synchronisation, and PR-based heal publication for the Fork Sync Agent.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/github/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { Command } from "commander";
 import * as p from "@clack/prompts";
 import pc from "picocolors";