@growthub/cli 0.6.0 → 0.6.2

package/dist/commands/fleet.js

@@ -0,0 +1,281 @@
+/**
+ * `growthub fleet` — fleet-level fork operations.
+ *
+ * Thin command layer over cli/src/fleet/. No new state, no new transport,
+ * no new auth — every verb is a view or a plan-generator over already-durable
+ * in-fork state.
+ *
+ * Verbs:
+ *   growthub fleet view            fleet health grid
+ *   growthub fleet drift           aggregated drift across fleet
+ *   growthub fleet drift-summary   per-fork artifact/path-level drift (human-readable)
+ *   growthub fleet policy          policy visibility matrix across forks
+ *   growthub fleet approvals       approval queue of awaiting_confirmation jobs
+ *   growthub fleet agent-plan      agent-led heal plan document for one fork
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { listKitForkRegistrations } from "../kits/fork-registry.js";
+import { buildFleetSummary, buildForkSummary } from "../fleet/summary.js";
+import { buildDriftArtifactSummary, summariseArtifactSummaryAsNarrative } from "../fleet/drift-summary.js";
+import { buildApprovalQueue } from "../fleet/approvals.js";
+import { buildAgentHealPlanDocument } from "../fleet/agent-plan.js";
+import { detectKitForkDrift, buildKitForkHealPlan } from "../kits/fork-sync.js";
+import { readKitForkPolicy } from "../kits/fork-policy.js";
+function healthGlyph(level) {
+    switch (level) {
+        case "clean":
+            return pc.green("●");
+        case "drift-minor":
+            return pc.cyan("●");
+        case "drift-major":
+            return pc.yellow("●");
+        case "awaiting-confirmation":
+            return pc.magenta("◐");
+        case "error":
+            return pc.red("●");
+        default:
+            return pc.dim("○");
+    }
+}
+function truncate(s, n) {
+    if (!s)
+        return "";
+    return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+// ---------------------------------------------------------------------------
+// fleet view
+// ---------------------------------------------------------------------------
+export async function fleetView(opts) {
+    const fleet = buildFleetSummary();
+    if (opts.json) {
+        console.log(JSON.stringify(fleet, null, 2));
+        return;
+    }
+    p.log.message(`Fleet: ${pc.cyan(String(fleet.totalForks))} fork(s)  |  ` +
+        `remote=${fleet.forksWithRemote}  ` +
+        `awaiting=${fleet.forksAwaitingConfirmation}  ` +
+        `pending-approvals=${fleet.pendingApprovalCount}`);
+    p.log.message(`  Health → clean=${fleet.byHealth.clean}  ` +
+        `drift-minor=${fleet.byHealth["drift-minor"]}  ` +
+        `drift-major=${fleet.byHealth["drift-major"]}  ` +
+        `awaiting=${fleet.byHealth["awaiting-confirmation"]}  ` +
+        `error=${fleet.byHealth.error}  unknown=${fleet.byHealth.unknown}`);
+    if (fleet.forks.length === 0) {
+        p.log.info("No forks registered yet. Run `growthub kit fork register` or `growthub starter init`.");
+        return;
+    }
+    for (const f of fleet.forks)
+        renderForkRow(f);
+}
+function renderForkRow(f) {
+    const label = truncate(f.label ?? f.forkId, 28).padEnd(28);
+    const kit = truncate(f.kitId, 34).padEnd(34);
+    const base = f.baseVersion.padEnd(8);
+    const upstream = (f.upstreamVersion ?? "?").padEnd(8);
+    const driftCounts = `files=${f.fileDriftCount} pkgs=${f.packageDriftCount}`;
+    const pending = f.pendingConfirmationJobs > 0
+        ? pc.magenta(` awaits=${f.pendingConfirmationJobs}`)
+        : "";
+    const remote = f.remote ? pc.dim(` ${f.remote.owner}/${f.remote.repo}`) : "";
+    p.log.message(`  ${healthGlyph(f.health)} ${label}  ${pc.dim(kit)}  ${base} → ${upstream}  ${pc.dim(driftCounts)}${pending}${remote}`);
+}
+// ---------------------------------------------------------------------------
+// fleet drift — aggregated
+// ---------------------------------------------------------------------------
+export async function fleetDrift(opts) {
+    const fleet = buildFleetSummary();
+    const withDrift = fleet.forks.filter((f) => f.hasUpstreamUpdate || f.driftSeverity !== "none");
+    if (opts.json) {
+        console.log(JSON.stringify({
+            totalDriftingForks: withDrift.length,
+            bySeverity: fleet.bySeverity,
+            forks: withDrift,
+        }, null, 2));
+        return;
+    }
+    p.log.message(`Fleet drift: ${pc.cyan(String(withDrift.length))} of ${fleet.totalForks} fork(s) have drift.`);
+    p.log.message(`  By severity → none=${fleet.bySeverity.none}  ` +
+        `info=${fleet.bySeverity.info}  warning=${fleet.bySeverity.warning}  critical=${fleet.bySeverity.critical}`);
+    for (const f of withDrift)
+        renderForkRow(f);
+    if (withDrift.length === 0)
+        p.log.success("No drift detected across the fleet.");
+}
+// ---------------------------------------------------------------------------
+// fleet drift-summary — per-fork artifact/path-level human-readable breakdown
+// ---------------------------------------------------------------------------
+export async function fleetDriftSummary(opts) {
+    const reg = listKitForkRegistrations().find((r) => r.forkId === opts.forkId);
+    if (!reg)
+        throw new Error(`Fork not found: ${opts.forkId}`);
+    const policy = readKitForkPolicy(reg.forkPath);
+    const report = detectKitForkDrift(reg);
+    const plan = buildKitForkHealPlan(report, { policy });
+    const summary = buildDriftArtifactSummary(report, plan, policy);
+    const narrative = summariseArtifactSummaryAsNarrative(summary);
+    if (opts.json) {
+        console.log(JSON.stringify({ summary, narrative }, null, 2));
+        return;
+    }
+    p.log.message(pc.cyan(`Drift summary — ${reg.forkId}  (${summary.fromVersion} → ${summary.toVersion})`));
+    for (const line of narrative)
+        p.log.message(`  ${line}`);
+    const sections = [
+        ["safe additions", summary.buckets.safeAdditions],
+        ["safe updates", summary.buckets.safeUpdates],
+        ["needs confirmation", summary.buckets.needsConfirmation],
+        ["preserved (user modified)", summary.buckets.skippedUserModified],
+        ["untouchable (policy)", summary.buckets.skippedUntouchable],
+        ["custom skills", summary.buckets.customSkills],
+        ["upstream deletions (unresolved)", summary.buckets.unresolvedUpstreamDeletion],
+    ];
+    for (const [label, items] of sections) {
+        if (items.length === 0)
+            continue;
+        p.log.message(pc.dim(`  — ${label} (${items.length}) —`));
+        for (const item of items)
+            p.log.message(`    · ${item.path}  ${pc.dim(item.note)}`);
+    }
+    if (summary.buckets.packageAdditions.length || summary.buckets.packageUpgrades.length) {
+        p.log.message(pc.dim(`  — dependency drift —`));
+        for (const d of summary.buckets.packageAdditions) {
+            p.log.message(`    + ${d.packageName}@${d.toVersion}  ${pc.dim("(added upstream)")}`);
+        }
+        for (const d of summary.buckets.packageUpgrades) {
+            p.log.message(`    ↑ ${d.packageName}  ${d.fromVersion ?? "?"} → ${d.toVersion}`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// fleet policy — visibility matrix
+// ---------------------------------------------------------------------------
+export async function fleetPolicy(opts) {
+    const regs = listKitForkRegistrations();
+    const rows = regs.map((r) => {
+        const summary = buildForkSummary(r);
+        return {
+            forkId: r.forkId,
+            label: r.label,
+            kitId: r.kitId,
+            autoApprove: summary.autoApprove,
+            autoApproveDepUpdates: summary.autoApproveDepUpdates,
+            remoteSyncMode: summary.remoteSyncMode,
+            untouchableCount: summary.untouchableCount,
+            hasRemote: Boolean(summary.remote),
+        };
+    });
+    if (opts.json) {
+        console.log(JSON.stringify({ count: rows.length, rows }, null, 2));
+        return;
+    }
+    p.log.message(pc.cyan(`Fleet policy matrix (${rows.length} fork(s))`));
+    for (const r of rows) {
+        const label = truncate(r.label ?? r.forkId, 28).padEnd(28);
+        const aa = r.autoApprove.padEnd(9);
+        const ad = r.autoApproveDepUpdates.padEnd(9);
+        const rs = r.remoteSyncMode.padEnd(6);
+        const ut = String(r.untouchableCount).padStart(3);
+        const remote = r.hasRemote ? pc.green("+") : pc.dim("·");
+        p.log.message(`  ${label}  autoApprove=${aa}  deps=${ad}  remote=${rs}  untouchable=${ut}  ${remote}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// fleet approvals — queue of parked jobs
+// ---------------------------------------------------------------------------
+export async function fleetApprovals(opts) {
+    const queue = buildApprovalQueue();
+    if (opts.json) {
+        console.log(JSON.stringify({ count: queue.length, queue }, null, 2));
+        return;
+    }
+    if (queue.length === 0) {
+        p.log.success("Approval queue is empty.");
+        return;
+    }
+    p.log.message(pc.cyan(`Approval queue: ${queue.length} job(s) awaiting confirmation`));
+    for (const entry of queue) {
+        p.log.message(`  · ${pc.cyan(entry.jobId)}  fork=${entry.forkLabel ?? entry.forkId}  created=${entry.createdAt.slice(0, 19)}`);
+        for (const path of entry.pendingPaths.slice(0, 6)) {
+            p.log.message(`      ${pc.dim("awaits")} ${path}`);
+        }
+        if (entry.pendingPaths.length > 6) {
+            p.log.message(`      ${pc.dim(`… +${entry.pendingPaths.length - 6} more`)}`);
+        }
+        p.log.message(`      ${pc.dim("resume:")} growthub kit fork confirm --job-id ${entry.jobId}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// fleet agent-plan — agent-led heal plan document
+// ---------------------------------------------------------------------------
+export async function fleetAgentPlan(opts) {
+    const reg = listKitForkRegistrations().find((r) => r.forkId === opts.forkId);
+    if (!reg)
+        throw new Error(`Fork not found: ${opts.forkId}`);
+    const doc = buildAgentHealPlanDocument(reg, { captureInTrace: opts.captureInTrace !== false });
+    if (opts.json) {
+        console.log(JSON.stringify(doc, null, 2));
+        return;
+    }
+    p.log.message(pc.cyan(`Agent heal plan — ${reg.forkId}`));
+    p.log.message(`  ${doc.summary}`);
+    for (const line of doc.narrative)
+        p.log.message(`    ${line}`);
+    if (doc.awaitsConfirmation.length > 0) {
+        p.log.message(pc.magenta(`  Awaiting confirmation on:`));
+        for (const p2 of doc.awaitsConfirmation)
+            p.log.message(`    · ${p2}`);
+        p.log.message(pc.dim(`  Next: growthub kit fork heal ${reg.forkId}  (will park in awaiting_confirmation until resumed)`));
+    }
+    else if (doc.plan.actions.length > 0) {
+        p.log.message(pc.dim(`  Next: growthub kit fork heal ${reg.forkId}  (${doc.plan.actions.length} safe action(s) ready)`));
+    }
+}
+// ---------------------------------------------------------------------------
+// Commander registration
+// ---------------------------------------------------------------------------
+export function registerFleetCommands(program) {
+    const fleet = program
+        .command("fleet")
+        .description("Fleet-level fork operations — view, drift, policy matrix, approvals, agent-led plans.");
+    fleet
+        .command("view")
+        .description("Fleet health grid — one row per registered fork.")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => { await fleetView(opts); });
+    fleet
+        .command("drift")
+        .description("Aggregated drift summary across every registered fork.")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => { await fleetDrift(opts); });
+    fleet
+        .command("drift-summary")
+        .description("Per-fork artifact/path-level drift breakdown (human-readable).")
+        .requiredOption("--fork-id <id>", "Registered fork id")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => { await fleetDriftSummary({ forkId: opts.forkId, json: opts.json }); });
+    fleet
+        .command("policy")
+        .description("Visibility matrix of per-fork policy across the fleet.")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => { await fleetPolicy(opts); });
+    fleet
+        .command("approvals")
+        .description("Approval queue — jobs parked in awaiting_confirmation.")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => { await fleetApprovals(opts); });
+    fleet
+        .command("agent-plan")
+        .description("Agent-led heal plan document for a fork (inspects drift, drafts plan, captures in trace).")
+        .requiredOption("--fork-id <id>", "Registered fork id")
+        .option("--no-capture-in-trace", "Do not append an agent_checkpoint event to trace.jsonl")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => {
+        await fleetAgentPlan({
+            forkId: opts.forkId,
+            json: opts.json,
+            captureInTrace: opts.captureInTrace !== false,
+        });
+    });
+}
+//# sourceMappingURL=fleet.js.map

package/dist/commands/fleet.js.map

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

package/dist/commands/github.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `growthub github` — first-party native GitHub integration.
+ *
+ * Mirrors the existing Growthub hosted auth primitive (session-store, overlay,
+ * interactive login) but for GitHub. Used by the Fork Sync Agent for one-click
+ * fork creation, remote branch push, and PR-based heal publication.
+ *
+ * Verbs:
+ *   growthub github login             device-flow OAuth (browser-less fallback: --token <pat>)
+ *   growthub github whoami            show authenticated identity
+ *   growthub github logout            clear local credentials
+ *   growthub github status            summary for Discovery Hub surfacing
+ */
+import { Command } from "commander";
+export interface GithubLoginOptions {
+    token?: string;
+    noBrowser?: boolean;
+    json?: boolean;
+    timeoutMs?: number;
+}
+export declare function githubLogin(opts: GithubLoginOptions): Promise<void>;
+export declare function githubWhoami(opts?: {
+    json?: boolean;
+}): Promise<void>;
+export declare function githubLogout(opts?: {
+    json?: boolean;
+}): void;
+export declare function registerGithubCommands(program: Command): void;
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/commands/github.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EzE;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwE/E;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAKhE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsC7D"}

package/dist/commands/github.js

@@ -0,0 +1,205 @@
+/**
+ * `growthub github` — first-party native GitHub integration.
+ *
+ * Mirrors the existing Growthub hosted auth primitive (session-store, overlay,
+ * interactive login) but for GitHub. Used by the Fork Sync Agent for one-click
+ * fork creation, remote branch push, and PR-based heal publication.
+ *
+ * Verbs:
+ *   growthub github login             device-flow OAuth (browser-less fallback: --token <pat>)
+ *   growthub github whoami            show authenticated identity
+ *   growthub github logout            clear local credentials
+ *   growthub github status            summary for Discovery Hub surfacing
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import open from "open";
+import { readGithubToken, writeGithubToken, clearGithubToken, readGithubProfile, writeGithubProfile, clearGithubProfile, isGithubTokenExpired, describeGithubTokenPath, } from "../github/token-store.js";
+import { startDeviceFlow, pollDeviceFlow, fetchAuthenticatedUser, resolveGithubClientId, } from "../github/client.js";
+import { describeIntegrationBridge } from "../integrations/bridge.js";
+async function sleep(ms) {
+    await new Promise((r) => setTimeout(r, ms));
+}
+export async function githubLogin(opts) {
+    if (opts.token?.trim()) {
+        const accessToken = opts.token.trim();
+        const profile = await fetchAuthenticatedUser(accessToken);
+        const token = {
+            version: 1,
+            accessToken,
+            authMode: "pat",
+            scopes: [],
+            login: profile.login,
+            userId: profile.userId,
+            issuedAt: new Date().toISOString(),
+        };
+        writeGithubToken(token);
+        writeGithubProfile(profile);
+        if (opts.json) {
+            console.log(JSON.stringify({ status: "ok", mode: "pat", login: profile.login }, null, 2));
+        }
+        else {
+            p.log.success(`Connected to GitHub as ${pc.cyan(profile.login)} (PAT).`);
+        }
+        return;
+    }
+    p.intro(pc.cyan("GitHub device flow login"));
+    const start = await startDeviceFlow();
+    p.log.step(`Open ${pc.cyan(start.verificationUri)} and enter code ${pc.yellow(start.userCode)}`);
+    if (!opts.noBrowser) {
+        try {
+            await open(start.verificationUri);
+        }
+        catch {
+            /* best-effort; user can open manually */
+        }
+    }
+    const startedAt = Date.now();
+    const maxMs = opts.timeoutMs ?? start.expiresInSec * 1000;
+    let interval = start.pollIntervalSec;
+    const spinner = p.spinner();
+    spinner.start("Waiting for GitHub authorization...");
+    while (Date.now() - startedAt < maxMs) {
+        await sleep(interval * 1000);
+        const poll = await pollDeviceFlow(start.deviceCode);
+        if (poll.status === "authorized" && poll.token) {
+            spinner.stop("Authorization received.");
+            const profile = await fetchAuthenticatedUser(poll.token.accessToken);
+            const token = {
+                ...poll.token,
+                login: profile.login,
+                userId: profile.userId,
+            };
+            writeGithubToken(token);
+            writeGithubProfile(profile);
+            if (opts.json) {
+                console.log(JSON.stringify({ status: "ok", mode: "device-flow", login: profile.login }));
+            }
+            else {
+                p.outro(`Connected to GitHub as ${pc.cyan(profile.login)}.`);
+            }
+            return;
+        }
+        if (poll.status === "slow_down" && poll.nextPollIntervalSec) {
+            interval = poll.nextPollIntervalSec;
+            continue;
+        }
+        if (poll.status === "expired") {
+            spinner.stop("Device code expired.");
+            throw new Error("GitHub device code expired — run `growthub github login` again.");
+        }
+        if (poll.status === "denied") {
+            spinner.stop("Authorization denied.");
+            throw new Error("GitHub authorization was denied.");
+        }
+    }
+    spinner.stop("Timed out.");
+    throw new Error("GitHub login timed out. Re-run `growthub github login` to retry.");
+}
+export async function githubWhoami(opts = {}) {
+    const token = readGithubToken();
+    const profile = readGithubProfile();
+    const bridge = await describeIntegrationBridge();
+    const bridgeGithub = bridge.integrations.find((i) => i.provider === "github");
+    // No direct token + no bridge GitHub integration → fully unconnected.
+    if (!token && !bridgeGithub) {
+        if (opts.json) {
+            console.log(JSON.stringify({
+                connected: false,
+                bridge: { growthubConnected: bridge.growthubConnected, bridgeAvailable: bridge.bridgeAvailable },
+            }, null, 2));
+        }
+        else {
+            p.log.warn("Not connected to GitHub. Either run `growthub github login` or connect GitHub inside your Growthub account.");
+            if (bridge.notice)
+                p.log.info(bridge.notice);
+        }
+        return;
+    }
+    const directExpired = token ? isGithubTokenExpired(token) : true;
+    const effectiveSource = token && !directExpired ? "direct" : bridgeGithub ? "growthub-bridge" : "none";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            connected: effectiveSource !== "none",
+            effectiveSource,
+            direct: token
+                ? {
+                    expired: directExpired,
+                    authMode: token.authMode,
+                    login: profile?.login ?? token.login ?? null,
+                    userId: profile?.userId ?? token.userId ?? null,
+                    scopes: token.scopes,
+                    tokenPath: describeGithubTokenPath(),
+                    clientId: resolveGithubClientId(),
+                }
+                : null,
+            bridge: {
+                growthubConnected: bridge.growthubConnected,
+                growthubLogin: bridge.growthubLogin ?? null,
+                bridgeAvailable: bridge.bridgeAvailable,
+                github: bridgeGithub ?? null,
+            },
+        }, null, 2));
+        return;
+    }
+    if (token) {
+        const status = directExpired ? pc.red("expired") : pc.green("active");
+        p.log.message(`GitHub (direct): ${status}  login=${profile?.login ?? token.login ?? "?"}  ` +
+            `mode=${token.authMode}  scopes=[${token.scopes.join(", ")}]`);
+    }
+    if (bridge.growthubConnected) {
+        if (bridgeGithub) {
+            p.log.message(`GitHub (via Growthub bridge): ${pc.green("connected")}  ` +
+                `handle=${bridgeGithub.handle ?? "?"}  growthub=${bridge.growthubLogin ?? "?"}  ` +
+                `scopes=[${(bridgeGithub.scopes ?? []).join(", ")}]`);
+        }
+        else if (bridge.bridgeAvailable) {
+            p.log.info(`Growthub account connected (${bridge.growthubLogin ?? "?"}) but no GitHub integration attached in gh-app.`);
+        }
+    }
+    p.log.message(`Effective auth source: ${pc.cyan(effectiveSource)}`);
+}
+export function githubLogout(opts = {}) {
+    clearGithubToken();
+    clearGithubProfile();
+    if (opts.json)
+        console.log(JSON.stringify({ status: "ok" }));
+    else
+        p.log.success("Disconnected from GitHub.");
+}
+export function registerGithubCommands(program) {
+    const github = program
+        .command("github")
+        .description("Manage first-party native GitHub authentication + fork operations.");
+    github
+        .command("login")
+        .description("Authenticate with GitHub via OAuth device flow (or --token <pat>).")
+        .option("--token <pat>", "Use a GitHub personal access token instead of device flow")
+        .option("--no-browser", "Do not open the verification URL automatically")
+        .option("--json", "Emit machine-readable output")
+        .option("--timeout-ms <n>", "Override device-flow poll timeout", (v) => Number(v))
+        .action(async (opts) => {
+        await githubLogin(opts);
+    });
+    github
+        .command("whoami")
+        .description("Show the authenticated GitHub identity.")
+        .option("--json", "Emit machine-readable output")
+        .action(async (opts) => {
+        await githubWhoami(opts);
+    });
+    github
+        .command("logout")
+        .description("Remove local GitHub credentials.")
+        .option("--json", "Emit machine-readable output")
+        .action((opts) => {
+        githubLogout(opts);
+    });
+    github
+        .command("status")
+        .description("Quick status for the Discovery Hub surface.")
+        .action(async () => {
+        await githubWhoami({});
+    });
+}
+//# sourceMappingURL=github.js.map

package/dist/commands/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/commands/github.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAwB;IACxD,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAmB;YAC5B,OAAO,EAAE,CAAC;YACV,WAAW;YACX,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;QACF,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxB,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO;IACT,CAAC;IAED,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,CAAC,CAAC,GAAG,CAAC,IAAI,CACR,QAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CACrF,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IAC1D,IAAI,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC;IACrC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAErD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QACtC,MAAM,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACrE,MAAM,KAAK,GAAmB;gBAC5B,GAAG,IAAI,CAAC,KAAK;gBACb,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC;YACF,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxB,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC;iBAAM,CAAC;gBACN,CAAC,CAAC,KAAK,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5D,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA2B,EAAE;IAC9D,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,yBAAyB,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAE9E,sEAAsE;IACtE,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE;aACjG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,GAAG,CAAC,IAAI,CACR,6GAA6G,CAC9G,CAAC;YACF,IAAI,MAAM,CAAC,MAAM;gBAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,MAAM,eAAe,GACnB,KAAK,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC;IAEjF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YACzB,SAAS,EAAE,eAAe,KAAK,MAAM;YACrC,eAAe;YACf,MAAM,EAAE,KAAK;gBACX,CAAC,CAAC;oBACE,OAAO,EAAE,aAAa;oBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI;oBAC5C,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;oBAC/C,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE,uBAAuB,EAAE;oBACpC,QAAQ,EAAE,qBAAqB,EAAE;iBAClC;gBACH,CAAC,CAAC,IAAI;YACR,MAAM,EAAE;gBACN,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;gBAC3C,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,MAAM,EAAE,YAAY,IAAI,IAAI;aAC7B;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtE,CAAC,CAAC,GAAG,CAAC,OAAO,CACX,oBAAoB,MAAM,WAAW,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,GAAG,IAAI;YAC7E,QAAQ,KAAK,CAAC,QAAQ,aAAa,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,IAAI,YAAY,EAAE,CAAC;YACjB,CAAC,CAAC,GAAG,CAAC,OAAO,CACX,iCAAiC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI;gBAC1D,UAAU,YAAY,CAAC,MAAM,IAAI,GAAG,cAAc,MAAM,CAAC,aAAa,IAAI,GAAG,IAAI;gBACjF,WAAW,CAAC,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrD,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAClC,CAAC,CAAC,GAAG,CAAC,IAAI,CACR,+BAA+B,MAAM,CAAC,aAAa,IAAI,GAAG,iDAAiD,CAC5G,CAAC;QACJ,CAAC;IACH,CAAC;IACD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAA2B,EAAE;IACxD,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,CAAC;IACrB,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;;QACxD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oEAAoE,CAAC,CAAC;IAErF,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,eAAe,EAAE,2DAA2D,CAAC;SACpF,MAAM,CAAC,cAAc,EAAE,gDAAgD,CAAC;SACxE,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,kBAAkB,EAAE,mCAAmC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACjF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/gtm.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerGtmCommands(program: Command): void;
+//# sourceMappingURL=gtm.d.ts.map

package/dist/commands/gtm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtm.d.ts","sourceRoot":"","sources":["../../src/commands/gtm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8E1D"}