github-weekly-reporter 0.3.0 → 0.3.1

package/dist/cli/commands/setup/github-api.js

@@ -0,0 +1,133 @@
+// GitHub API helpers and repository management
+const ghHeaders = (token) => ({
+    Authorization: `Bearer ${token}`,
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28",
+    "Content-Type": "application/json",
+});
+const ghFetch = async (token, method, path, body) => fetch(`https://api.github.com${path}`, {
+    method,
+    headers: ghHeaders(token),
+    ...(body ? { body: JSON.stringify(body) } : {}),
+});
+export const ghGet = (token, path) => ghFetch(token, "GET", path);
+export const ghPost = (token, path, body) => ghFetch(token, "POST", path, body);
+export const ghPut = (token, path, body) => ghFetch(token, "PUT", path, body);
+// ── Token validation ─────────────────────────────────────────
+export const validateToken = async (token) => {
+    const res = await ghGet(token, "/user");
+    if (res.status === 401) {
+        throw new Error("Invalid or expired token.\n\n" +
+            "  Create a token at: https://github.com/settings/tokens\n\n" +
+            "  Classic PAT scopes needed: repo, workflow\n" +
+            "  Fine-grained PAT:\n" +
+            "    Repository access: All repositories\n" +
+            "    Permissions: Actions, Administration, Contents,\n" +
+            "                 Pages, Secrets, Workflows (all Read & Write)");
+    }
+    if (!res.ok)
+        throw new Error(`GitHub API error: ${res.status}`);
+    const { login } = (await res.json());
+    const scopeHeader = res.headers.get("x-oauth-scopes");
+    // Fine-grained tokens do not return x-oauth-scopes header.
+    // We cannot validate permissions upfront, so we validate lazily
+    // when each API call is made and provide clear error messages.
+    if (scopeHeader === null) {
+        return { login, tokenType: "fine-grained" };
+    }
+    // Classic PAT: validate scopes
+    const scopes = scopeHeader.split(",").map((s) => s.trim());
+    const missing = ["repo", "workflow"].filter((s) => !scopes.includes(s));
+    if (missing.length > 0) {
+        throw new Error(`Token is missing required scopes: ${missing.join(", ")}\n\n` +
+            "  Create a new token at: https://github.com/settings/tokens/new?scopes=repo,workflow\n" +
+            "  Required scopes: repo, workflow");
+    }
+    return { login, tokenType: "classic" };
+};
+// ── Secret encryption (sealed box via libsodium) ────────────
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export const setRepoSecret = async (token, repo, name, value) => {
+    const { default: _sodium } = await import("libsodium-wrappers");
+    await _sodium.ready;
+    // Retry up to 3 times with backoff (new repos may need time to propagate)
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const keyRes = await ghGet(token, `/repos/${repo}/actions/secrets/public-key`);
+        if (!keyRes.ok) {
+            if (attempt < 2) {
+                await sleep(3000 * (attempt + 1));
+                continue;
+            }
+            return false;
+        }
+        const { key, key_id } = (await keyRes.json());
+        const keyBytes = _sodium.from_base64(key, _sodium.base64_variants.ORIGINAL);
+        const encrypted = _sodium.crypto_box_seal(new TextEncoder().encode(value), keyBytes);
+        const encryptedB64 = _sodium.to_base64(encrypted, _sodium.base64_variants.ORIGINAL);
+        const res = await ghPut(token, `/repos/${repo}/actions/secrets/${name}`, {
+            encrypted_value: encryptedB64,
+            key_id,
+        });
+        if (res.ok)
+            return true;
+        const body = await res.text().catch(() => "");
+        console.log(`      Attempt ${attempt + 1}/3 failed: ${res.status} ${body.slice(0, 200)}`);
+        if (attempt < 2) {
+            await sleep(3000 * (attempt + 1));
+            continue;
+        }
+        return false;
+    }
+    return false;
+};
+// ── Repository management ────────────────────────────────────
+export const ensureRepo = async (token, fullRepo) => {
+    const res = await ghGet(token, `/repos/${fullRepo}`);
+    if (res.ok)
+        return false;
+    const [owner, name] = fullRepo.split("/");
+    const { login } = (await (await ghGet(token, "/user")).json());
+    const createRes = owner === login
+        ? await ghPost(token, "/user/repos", {
+            name,
+            auto_init: true,
+            private: false,
+            description: "Weekly GitHub activity reports",
+        })
+        : await ghPost(token, `/orgs/${owner}/repos`, {
+            name,
+            auto_init: true,
+            private: false,
+            description: "Weekly GitHub activity reports",
+        });
+    if (!createRes.ok) {
+        const body = await createRes.text();
+        throw new Error(`Failed to create ${fullRepo}: ${createRes.status}\n  ${body}`);
+    }
+    // Wait for repo to be ready
+    await new Promise((r) => setTimeout(r, 2000));
+    return true;
+};
+export const addFileToRepo = async (token, repo, path, content, message) => {
+    const existing = await ghGet(token, `/repos/${repo}/contents/${path}`);
+    const sha = existing.ok
+        ? (await existing.json()).sha
+        : undefined;
+    const res = await ghPut(token, `/repos/${repo}/contents/${path}`, {
+        message,
+        content: btoa(unescape(encodeURIComponent(content))),
+        ...(sha ? { sha } : {}),
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to add ${path}: ${res.status}`);
+    }
+};
+export const enablePages = async (token, repo) => {
+    // Enable Pages from main branch, /output directory (may already be enabled)
+    await ghPost(token, `/repos/${repo}/pages`, {
+        source: { branch: "gh-pages", path: "/" },
+    });
+    const [owner, name] = repo.split("/");
+    return `https://${owner}.github.io/${name}`;
+};
+//# sourceMappingURL=github-api.js.map

package/dist/cli/commands/setup/github-api.js.map

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

package/dist/cli/commands/setup/validate-model.d.ts

@@ -0,0 +1,6 @@
+import type { LLMProvider } from "../../../types.js";
+export declare const validateModel: (provider: LLMProvider, apiKey: string, model: string) => Promise<{
+    valid: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=validate-model.d.ts.map

package/dist/cli/commands/setup/validate-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-model.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/setup/validate-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,GACxB,UAAU,WAAW,EACrB,QAAQ,MAAM,EACd,OAAO,MAAM,KACZ,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2E5C,CAAC"}

package/dist/cli/commands/setup/validate-model.js

@@ -0,0 +1,74 @@
+// Validate model by making a minimal API call
+export const validateModel = async (provider, apiKey, model) => {
+    const openaiCompatible = (baseURL) => fetch(`${baseURL}/chat/completions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model,
+            messages: [{ role: "user", content: "hi" }],
+            max_tokens: 1,
+        }),
+    });
+    try {
+        let res;
+        switch (provider) {
+            case "openai":
+                res = await openaiCompatible("https://api.openai.com/v1");
+                break;
+            case "groq":
+                res = await openaiCompatible("https://api.groq.com/openai/v1");
+                break;
+            case "openrouter":
+                res = await openaiCompatible("https://openrouter.ai/api/v1");
+                break;
+            case "grok":
+                res = await openaiCompatible("https://api.x.ai/v1");
+                break;
+            case "anthropic":
+                res = await fetch("https://api.anthropic.com/v1/messages", {
+                    method: "POST",
+                    headers: {
+                        "x-api-key": apiKey,
+                        "anthropic-version": "2023-06-01",
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        model,
+                        messages: [{ role: "user", content: "hi" }],
+                        max_tokens: 1,
+                    }),
+                });
+                break;
+            case "gemini":
+                res = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        contents: [{ parts: [{ text: "hi" }] }],
+                        generationConfig: { maxOutputTokens: 1 },
+                    }),
+                });
+                break;
+            default:
+                return { valid: true };
+        }
+        if (res.ok)
+            return { valid: true };
+        const body = await res.text();
+        // 404 or "model not found" means wrong model name
+        if (res.status === 404 || body.toLowerCase().includes("model")) {
+            return { valid: false, error: `Model "${model}" not found (${res.status})` };
+        }
+        // Rate limit or other non-model errors are fine (model exists)
+        if (res.status === 429)
+            return { valid: true };
+        return { valid: false, error: `API error: ${res.status} ${body.slice(0, 200)}` };
+    }
+    catch (e) {
+        return { valid: false, error: `Connection error: ${e instanceof Error ? e.message : String(e)}` };
+    }
+};
+//# sourceMappingURL=validate-model.js.map

package/dist/cli/commands/setup/validate-model.js.map

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

package/dist/cli/commands/setup/workflows.d.ts

@@ -0,0 +1,25 @@
+import type { LLMProvider, Language } from "../../../types.js";
+export declare const LLM_SECRET_NAMES: Record<string, string>;
+export declare const midnightCronUTC: (timezone: string) => string;
+export type WorkflowOpts = {
+    username: string;
+    language: Language;
+    timezone: string;
+    siteTitle: string;
+    llmProvider?: LLMProvider;
+    llmModel?: string;
+    llmSecretName?: string;
+};
+export declare const buildDailyWorkflow: (opts: WorkflowOpts) => string;
+export declare const buildWeeklyWorkflow: (opts: WorkflowOpts) => string;
+export declare const buildReadme: (opts: {
+    siteTitle: string;
+    username: string;
+    repo: string;
+    pagesUrl: string;
+    language: Language;
+    timezone: string;
+    llmProvider?: LLMProvider;
+    llmModel?: string;
+}) => string;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/cli/commands/setup/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/setup/workflows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI/D,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOnD,CAAC;AAeF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,KAAG,MAclD,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,YAAY,KAAG,MA8BvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,KAAG,MAoDxD,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,MAAM;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,MAwDH,CAAC"}

package/dist/cli/commands/setup/workflows.js

@@ -0,0 +1,169 @@
+// Workflow YAML templates and README generation
+// ── Constants ────────────────────────────────────────────────
+export const LLM_SECRET_NAMES = {
+    openai: "OPENAI_API_KEY",
+    anthropic: "ANTHROPIC_API_KEY",
+    gemini: "GEMINI_API_KEY",
+    openrouter: "OPENROUTER_API_KEY",
+    groq: "GROQ_API_KEY",
+    grok: "GROK_API_KEY",
+};
+const LLM_API_KEY_INPUT_NAMES = {
+    openai: "openai-api-key",
+    anthropic: "anthropic-api-key",
+    gemini: "gemini-api-key",
+    openrouter: "openrouter-api-key",
+    groq: "groq-api-key",
+    grok: "grok-api-key",
+};
+// ── Cron calculation from timezone ───────────────────────────
+// Daily fetch should run at midnight in the user's timezone.
+// GitHub Actions cron is always UTC, so we calculate the offset.
+export const midnightCronUTC = (timezone) => {
+    const now = new Date();
+    const utcMidnight = new Date(now.toLocaleString("en-US", { timeZone: "UTC" }));
+    const localMidnight = new Date(now.toLocaleString("en-US", { timeZone: timezone }));
+    const offsetMinutes = Math.round((utcMidnight.getTime() - localMidnight.getTime()) / 60000);
+    const utcHour = ((offsetMinutes / 60 + 24) % 24) | 0;
+    const utcMinute = ((offsetMinutes % 60) + 60) % 60;
+    return `${utcMinute} ${utcHour} * * *`;
+};
+export const buildDailyWorkflow = (opts) => {
+    const cron = midnightCronUTC(opts.timezone);
+    return `# Generated by: github-weekly-reporter setup
+# Docs: https://github.com/deariary/github-weekly-reporter
+
+name: Daily Fetch
+
+on:
+  schedule:
+    - cron: '${cron}'  # midnight ${opts.timezone}
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  daily:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: deariary/github-weekly-reporter@main
+        with:
+          github-token: \${{ secrets.GH_PAT }}
+          username: '${opts.username}'
+          mode: 'daily'
+          language: '${opts.language}'
+          timezone: '${opts.timezone}'
+`;
+};
+export const buildWeeklyWorkflow = (opts) => {
+    // Run 1 hour after daily fetch, Monday only
+    const dailyCron = midnightCronUTC(opts.timezone);
+    const [minute, hour] = dailyCron.split(" ").map(Number);
+    const weeklyHour = (hour + 1) % 24;
+    const weeklyCron = `${minute} ${weeklyHour} * * 1`;
+    const llmInputs = opts.llmProvider && opts.llmModel && opts.llmSecretName
+        ? `          llm-provider: '${opts.llmProvider}'
+          llm-model: '${opts.llmModel}'
+          ${LLM_API_KEY_INPUT_NAMES[opts.llmProvider]}: \${{ secrets.${opts.llmSecretName} }}`
+        : "";
+    return `# Generated by: github-weekly-reporter setup
+# Docs: https://github.com/deariary/github-weekly-reporter
+
+name: Weekly Report
+
+on:
+  schedule:
+    - cron: '${weeklyCron}'  # Monday, 1 hour after daily fetch (${opts.timezone})
+  workflow_dispatch:
+    inputs:
+      date:
+        description: 'Target date (YYYY-MM-DD, default: today)'
+        required: false
+        type: string
+
+permissions:
+  contents: write
+  pages: write
+
+env:
+  SITE_TITLE: '${opts.siteTitle}'
+
+jobs:
+  weekly:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: deariary/github-weekly-reporter@main
+        with:
+          github-token: \${{ secrets.GH_PAT }}
+          username: '${opts.username}'
+          mode: 'weekly'
+          language: '${opts.language}'
+          timezone: '${opts.timezone}'
+          date: \${{ inputs.date }}
+${llmInputs}
+`;
+};
+// ── README template ──────────────────────────────────────────
+export const buildReadme = (opts) => `# ${opts.siteTitle}
+
+Weekly GitHub activity reports for [@${opts.username}](https://github.com/${opts.username}), powered by [github-weekly-reporter](https://github.com/deariary/github-weekly-reporter).
+
+## Live Reports
+
+${opts.pagesUrl}
+
+## How It Works
+
+1. **Daily** (automatic): A scheduled workflow collects your GitHub events at midnight (${opts.timezone}).
+2. **Weekly** (manual): Trigger the workflow with \`mode: weekly\` from the [Actions tab](https://github.com/${opts.repo}/actions) to generate a full report${opts.llmProvider ? " with AI narrative" : ""}.
+3. The report is deployed to GitHub Pages automatically.
+
+## Configuration
+
+Edit \`.github/workflows/weekly-report.yml\` to change:
+
+| Setting | Current | Description |
+|---------|---------|-------------|
+| \`username\` | \`${opts.username}\` | GitHub user to report on |
+| \`language\` | \`${opts.language}\` | Report language (en, ja, zh-CN, zh-TW, ko, es, fr, de, pt, ru) |
+| \`timezone\` | \`${opts.timezone}\` | IANA timezone for date calculations |
+| \`SITE_TITLE\` | \`${opts.siteTitle}\` | Site title in the header and hero |
+${opts.llmProvider ? `| \`llm-provider\` | \`${opts.llmProvider}\` | LLM provider for AI narrative |\n| \`llm-model\` | \`${opts.llmModel}\` | Model name |\n` : ""}
+## Base URL
+
+The report's canonical URL, OG images, and sitemap are generated using \`BASE_URL\`.
+By default this is derived automatically from the repository name:
+
+\`\`\`
+https://${opts.repo.split("/")[0]}.github.io/${opts.repo.split("/")[1]}
+\`\`\`
+
+If you use a **custom domain**, add \`BASE_URL\` to the workflow env:
+
+\`\`\`yaml
+env:
+  SITE_TITLE: '${opts.siteTitle}'
+  BASE_URL: 'https://your-custom-domain.com'
+\`\`\`
+
+Then configure the custom domain in **Settings > Pages > Custom domain**.
+
+## Changing the LLM API Key
+
+1. Go to **Settings > Secrets and variables > Actions**
+2. Update the \`${opts.llmProvider ? LLM_SECRET_NAMES[opts.llmProvider] : "LLM_API_KEY"}\` secret
+
+## Manual Report Generation
+
+Go to [Actions](https://github.com/${opts.repo}/actions), click **Weekly Report**, then **Run workflow** with \`mode: weekly\`.
+
+---
+
+Supported by [deariary](https://deariary.com)
+`;
+//# sourceMappingURL=workflows.js.map

package/dist/cli/commands/setup/workflows.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -1,3 +1,5 @@
 import { Command } from "commander";
+export { midnightCronUTC, buildDailyWorkflow, buildWeeklyWorkflow } from "./setup/workflows.js";
+export type { WorkflowOpts } from "./setup/workflows.js";
 export declare const registerSetup: (program: Command) => void;
 //# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAm3BpC,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,IAmBhD,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAkWzD,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,IAmBhD,CAAC"}