github-weekly-reporter 0.1.0 → 0.2.0

package/README.md

@@ -1,148 +1,119 @@
 # GitHub Weekly Reporter
 
-Generate beautiful weekly GitHub activity reports with optional AI-powered narratives.
+Generate beautiful weekly GitHub activity reports with AI-powered narratives.
 
-Collect your commits, pull requests, issues, and code reviews from the past week, render them as a polished static HTML page, and deploy to GitHub Pages.
+Collect your commits, pull requests, issues, and code reviews from the past week, render them as a polished static HTML page, and deploy to GitHub Pages automatically.
 
-## Quick Start
-
-```bash
-npx github-weekly-reporter generate \
-  -t $GITHUB_TOKEN \
-  -u your-username
-
-npx github-weekly-reporter deploy \
-  -d ./report \
-  -r https://github.com/your-username/weekly-report.git
-```
-
-## Features
-
-- Weekly stats: commits, PRs opened/merged, issues, reviews
-- Top repositories by activity
-- Language breakdown (CSS-only chart)
-- 7-day contribution heatmap
-- AI-generated narrative summary (optional, supports OpenAI / Anthropic / Gemini)
-- Light and dark themes
-- Self-contained HTML (no external requests, no JavaScript required)
-- Deploys to GitHub Pages with weekly archive
-
-## Installation
-
-```bash
-npm install -g github-weekly-reporter
-```
-
-Or run directly with npx:
-
-```bash
-npx github-weekly-reporter <command>
-```
+## Prerequisites
 
-## Commands
+Before running setup, have these ready:
 
-### `generate`
+1. **GitHub fine-grained PAT** with `All repositories` access and these permissions (all Read & Write):
+   `Administration`, `Contents`, `Actions`, `Secrets`, `Pages`, `Workflows`
+   ([Create one](https://github.com/settings/personal-access-tokens/new))
 
-Collect GitHub activity data and generate an HTML report.
+2. **LLM API key** from one of the supported providers.
+   | Provider | Free Tier | Get API Key |
+   |---|---|---|
+   | OpenRouter | Yes | https://openrouter.ai/settings/keys |
+   | Groq | Yes | https://console.groq.com/keys |
+   | Google Gemini | Yes | https://aistudio.google.com/apikey |
+   | OpenAI | No | https://platform.openai.com/api-keys |
+   | Anthropic | No | https://console.anthropic.com/settings/keys |
+   | Grok (xAI) | No | https://console.x.ai |
 
-```bash
-github-weekly-reporter generate [options]
-```
-
-| Option | Env Variable | Config Key | Description |
-|---|---|---|---|
-| `-t, --token` | `GITHUB_TOKEN` | - | GitHub personal access token (required) |
-| `-u, --username` | `GITHUB_USERNAME` | `username` | GitHub username (required) |
-| `-o, --output` | - | `output` | Output directory (default: `./report`) |
-| `--theme` | - | `theme` | `default` or `dark` |
-| `--llm-provider` | `LLM_PROVIDER` | `llm.provider` | `openai`, `anthropic`, or `gemini` |
-| `--llm-api-key` | `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` | - | LLM API key |
-| `--llm-model` | `LLM_MODEL` | `llm.model` | Model name (e.g. `gpt-4o-mini`) |
+3. **LLM model name** for your chosen provider:
 
-Priority: CLI flag > environment variable > config file.
+   | Provider | Models |
+   |---|---|
+   | OpenRouter | https://openrouter.ai/models |
+   | Groq | https://console.groq.com/docs/models |
+   | Google Gemini | https://ai.google.dev/gemini-api/docs/models |
+   | OpenAI | https://platform.openai.com/docs/models |
+   | Anthropic | https://docs.anthropic.com/en/docs/about-claude/models |
+   | Grok (xAI) | https://docs.x.ai/docs/models |
 
-### `deploy`
-
-Push generated report files to the `gh-pages` branch.
+## Quick Start
 
 ```bash
-github-weekly-reporter deploy [options]
+npx github-weekly-reporter setup
 ```
 
-| Option | Description |
-|---|---|
-| `-d, --directory` | Directory containing generated files (default: `./report`) |
-| `-r, --repo` | Repository URL to push to |
+The setup command will walk you through everything:
+- Creates a repository
+- Adds workflow files (daily fetch + weekly report)
+- Configures secrets (PAT and LLM API key)
+- Enables GitHub Pages
+- Triggers your first weekly report
 
-## Config File
+See [Manual Setup](docs/manual-setup.md) if you prefer to configure everything yourself.
 
-Create `.github-weekly-reporter.toml` in your project root:
-
-```toml
-username = "your-username"
-theme = "dark"
-output = "./report"
+## Features
 
-[llm]
-provider = "openai"
-model = "gpt-4o-mini"
-```
+- Weekly stats: commits, PRs opened/merged, issues, reviews
+- Top repositories by activity
+- Language breakdown (CSS-only chart)
+- 7-day contribution heatmap
+- AI-generated narrative summary (6 providers, free tiers available)
+- Dark theme with responsive design
+- Self-contained HTML (no external requests, no JavaScript required)
+- SEO optimized (OG images, JSON-LD, sitemap)
+- Deploys to GitHub Pages with weekly archive
+- Internationalization (10 languages)
 
-Secrets (tokens, API keys) should be set via environment variables or CLI flags, not in the config file.
+## LLM Providers
 
-## Report Contents
+AI narratives are required for report generation. Six providers are supported, including free tiers:
 
-| Section | Requires AI | Description |
+| Provider | Free Tier | Env Variable |
 |---|---|---|
-| Weekly stats | No | Commits, PRs opened/merged, issues, reviews |
-| Highlight repos | No | Most active repositories with counts |
-| Language breakdown | No | CSS-only bar chart of languages used |
-| Contribution graph | No | 7-day heatmap |
-| AI narrative | Yes | Natural language summary of the week |
-| Footer | - | "Powered by deariary" link |
-
-## Themes
+| **OpenRouter** | Yes (25+ free models) | `OPENROUTER_API_KEY` |
+| **Groq** | Yes (generous) | `GROQ_API_KEY` |
+| **Google Gemini** | Yes | `GEMINI_API_KEY` |
+| OpenAI | No | `OPENAI_API_KEY` |
+| Anthropic | No | `ANTHROPIC_API_KEY` |
+| Grok (xAI) | No | `GROK_API_KEY` |
 
-Two built-in themes:
+OpenRouter and Groq are recommended for free usage. Both offer high-quality models at no cost. For model selection, see each provider's documentation:
 
-- `default`: clean light theme
-- `dark`: dark background, GitHub-inspired
+- OpenRouter: https://openrouter.ai/models
+- Groq: https://console.groq.com/docs/models
+- Gemini: https://ai.google.dev/gemini-api/docs/models
+- OpenAI: https://platform.openai.com/docs/models
+- Anthropic: https://docs.anthropic.com/en/docs/about-claude/models
+- Grok: https://docs.x.ai/docs/models
 
-## AI Narrative
+If the LLM call fails, the workflow will stop with an error. Make sure your API key and model name are correct.
 
-When an LLM provider and API key are configured, the report includes an AI-generated summary. All three major providers are supported:
+## Generating a Report Manually
 
-| Provider | Env Variable | Example Model |
-|---|---|---|
-| OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
-| Anthropic | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514` |
-| Google Gemini | `GEMINI_API_KEY` | `gemini-2.0-flash` |
+After setup, daily fetches run automatically. To generate a weekly report anytime:
 
-If the LLM call fails, the report is generated without the AI section. The action never fails due to LLM errors.
+1. Go to your repository's **Actions** tab
+2. Click **Weekly Report**
+3. Click **Run workflow**
 
-## GitHub Action Usage
+The report will be built and deployed to GitHub Pages within a few minutes.
 
-```yaml
-name: Weekly Report
-on:
-  schedule:
-    - cron: '0 9 * * 1'  # Every Monday 9:00 UTC
-  workflow_dispatch:
+## Supported Languages
 
-jobs:
-  report:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
-      - run: npx github-weekly-reporter generate -t ${{ secrets.GITHUB_TOKEN }} -u ${{ github.actor }}
-
-      - run: npx github-weekly-reporter deploy -d ./report -r https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git
-```
+| Code | Language |
+|---|---|
+| `en` | English |
+| `ja` | Japanese |
+| `zh-CN` | Chinese (Simplified) |
+| `zh-TW` | Chinese (Traditional) |
+| `ko` | Korean |
+| `es` | Spanish |
+| `fr` | French |
+| `de` | German |
+| `pt` | Portuguese |
+| `ru` | Russian |
+
+## Documentation
+
+- [Manual Setup](docs/manual-setup.md) - step-by-step guide without the setup command
+- [CLI Reference](docs/cli-reference.md) - all commands and environment variables
 
 ## URL Structure
 

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8CpC,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,IAkBjD,CAAC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDpC,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,IAuBjD,CAAC"}

package/dist/cli/commands/deploy.js

@@ -1,6 +1,7 @@
 // deploy command: push generated report directory to gh-pages branch
 import { deploy } from "../../deployer/index.js";
 import { getWeekId } from "../../deployer/week.js";
+import { parseLocalDate } from "../../collector/date-range.js";
 const env = (key) => process.env[key];
 const buildRepoUrl = (repo) => {
     const repoSlug = repo ?? env("GITHUB_REPOSITORY");
@@ -23,7 +24,7 @@ const buildRepoUrl = (repo) => {
     return `https://github.com/${repoSlug}.git`;
 };
 const run = async (options) => {
-    const weekId = getWeekId();
+    const weekId = getWeekId(options.date, options.timezone);
     console.log(`Deploying ${options.directory} to gh-pages...`);
     await deploy({
         repoUrl: options.repoUrl,
@@ -36,14 +37,19 @@ export const registerDeploy = (program) => {
     program
         .command("deploy")
         .description("Deploy generated report to GitHub Pages (gh-pages branch)")
-        .option("-d, --directory <dir>", "Directory containing generated report files", "./report")
+        .option("-d, --directory <dir>", "Directory containing generated HTML files (env: OUTPUT_DIR, default: ./output)")
         .option("-r, --repo <slug>", "Repository (owner/repo or full URL, env: GITHUB_REPOSITORY)")
+        .option("--timezone <tz>", "IANA timezone (env: TIMEZONE, default: UTC)")
+        .option("--date <date>", "Date within the target week (YYYY-MM-DD, default: today)")
         .action(async (opts) => {
         try {
+            const timezone = opts.timezone ?? env("TIMEZONE") ?? "UTC";
             const repoUrl = buildRepoUrl(opts.repo);
             await run({
-                directory: opts.directory,
+                directory: opts.directory ?? env("OUTPUT_DIR") ?? "./output",
                 repoUrl,
+                timezone,
+                date: opts.date ? parseLocalDate(opts.date, timezone) : undefined,
             });
         }
         catch (error) {

package/dist/cli/commands/deploy.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOnD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElE,MAAM,YAAY,GAAG,CAAC,IAAwB,EAAU,EAAE;IACxD,MAAM,QAAQ,GAAG,IAAI,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,qBAAqB;IACrB,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACxD,OAAO,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,0BAA0B,KAAK,cAAc,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,0BAA0B,KAAK,eAAe,QAAQ,MAAM,CAAC;IACtE,CAAC;IACD,OAAO,sBAAsB,QAAQ,MAAM,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,KAAK,EAAE,OAA6B,EAAiB,EAAE;IACjE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,SAAS,iBAAiB,CAAC,CAAC;IAC7D,MAAM,MAAM,CAAC;QACX,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,EAAE;KAClC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAQ,EAAE;IACvD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,uBAAuB,EAAE,6CAA6C,EAAE,UAAU,CAAC;SAC1F,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;SAC1F,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,GAAG,CAAC;gBACR,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmJpC,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,IA4BhD,CAAC"}

package/dist/cli/commands/fetch.js

@@ -0,0 +1,148 @@
+// fetch commands: daily-fetch (events) and weekly-fetch (full data)
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml, stringify as toYaml } from "yaml";
+import { graphql } from "@octokit/graphql";
+import { buildWeeklyRange, toISODate, parseLocalDate } from "../../collector/date-range.js";
+import { fetchEvents, dedupeEvents } from "../../collector/fetch-events.js";
+import { fetchContributions } from "../../collector/fetch-contributions.js";
+import { fetchPRsByRefs } from "../../collector/fetch-repo-prs.js";
+import { aggregateRepositories } from "../../collector/aggregate.js";
+import { getWeekId } from "../../deployer/week.js";
+const env = (key) => process.env[key];
+const resolveBaseOptions = (cli) => {
+    const token = cli.token ?? env("GITHUB_TOKEN");
+    if (!token)
+        throw new Error("GitHub token required. Pass --token or set GITHUB_TOKEN.");
+    const username = cli.username ?? env("GITHUB_USERNAME");
+    if (!username)
+        throw new Error("GitHub username required. Pass --username or set GITHUB_USERNAME.");
+    const timezone = cli.timezone ?? env("TIMEZONE") ?? "UTC";
+    const date = cli.date ? parseLocalDate(cli.date, timezone) : undefined;
+    return { token, username, dataDir: cli.dataDir ?? env("DATA_DIR") ?? "./data", date, timezone };
+};
+const tryReadYaml = async (path) => {
+    try {
+        const raw = await readFile(path, "utf-8");
+        return parseYaml(raw);
+    }
+    catch {
+        return null;
+    }
+};
+// Extract PR references from events
+const extractPRRefs = (events) => {
+    const refs = [];
+    events.forEach((e) => {
+        const p = e.payload;
+        if (p.kind === "pull_request" && p.number > 0) {
+            refs.push({ repo: e.repo, number: p.number });
+        }
+        if (p.kind === "review" && p.prNumber > 0) {
+            refs.push({ repo: e.repo, number: p.prNumber });
+        }
+    });
+    return refs;
+};
+// daily-fetch: accumulate events
+const runDailyFetch = async (options) => {
+    const weekId = getWeekId(options.date, options.timezone);
+    const range = buildWeeklyRange(options.date, options.timezone);
+    const reportDir = join(options.dataDir, weekId.path);
+    await mkdir(reportDir, { recursive: true });
+    console.log(`Fetching events for ${options.username} (${weekId.path})...`);
+    const newEvents = await fetchEvents(options.token, options.username, range);
+    console.log(`Fetched ${newEvents.length} events.`);
+    const eventsPath = join(reportDir, "events.yaml");
+    const existing = await tryReadYaml(eventsPath) ?? [];
+    const merged = dedupeEvents([...existing, ...newEvents]);
+    await writeFile(eventsPath, toYaml(merged, { lineWidth: 120 }), "utf-8");
+    console.log(`Events accumulated: ${merged.length} total (${eventsPath})`);
+};
+// weekly-fetch: use accumulated events to find PRs, fetch each individually
+const runWeeklyFetch = async (options) => {
+    const weekId = getWeekId(options.date, options.timezone);
+    const range = buildWeeklyRange(options.date, options.timezone);
+    const reportDir = join(options.dataDir, weekId.path);
+    await mkdir(reportDir, { recursive: true });
+    // Load accumulated events
+    const eventsPath = join(reportDir, "events.yaml");
+    const events = await tryReadYaml(eventsPath) ?? [];
+    console.log(`Loaded ${events.length} accumulated events.`);
+    // Extract PR refs from events
+    const prRefs = extractPRRefs(events);
+    console.log(`Found ${prRefs.length} PR references (${new Set(prRefs.map((r) => `${r.repo}#${r.number}`)).size} unique).`);
+    // Fetch individual PRs
+    console.log("Fetching PRs...");
+    const pullRequests = await fetchPRsByRefs(options.token, prRefs);
+    console.log(`Fetched ${pullRequests.length} PRs.`);
+    // Fetch contributions (GraphQL)
+    console.log("Fetching contribution stats...");
+    const gql = graphql.defaults({ headers: { authorization: `token ${options.token}` } });
+    const contributions = await fetchContributions(gql, options.username, range, options.timezone);
+    const repositories = aggregateRepositories(pullRequests, []);
+    const totalAdditions = pullRequests.reduce((sum, pr) => sum + pr.additions, 0);
+    const totalDeletions = pullRequests.reduce((sum, pr) => sum + pr.deletions, 0);
+    const githubData = {
+        username: contributions.username,
+        avatarUrl: contributions.avatarUrl,
+        profile: contributions.profile,
+        dateRange: {
+            from: toISODate(range.from, options.timezone),
+            to: toISODate(range.to, options.timezone),
+        },
+        stats: {
+            totalCommits: contributions.totalCommits,
+            totalAdditions,
+            totalDeletions,
+            prsOpened: pullRequests.filter((pr) => pr.author.toLowerCase() === options.username.toLowerCase()).length,
+            prsMerged: pullRequests.filter((pr) => pr.state === "merged" && pr.author.toLowerCase() === options.username.toLowerCase()).length,
+            prsReviewed: contributions.prsReviewed,
+            issuesOpened: 0,
+            issuesClosed: 0,
+        },
+        dailyCommits: contributions.dailyCommits,
+        repositories,
+        pullRequests,
+        issues: [],
+        events,
+        externalContributions: [],
+    };
+    const dataPath = join(reportDir, "github-data.yaml");
+    await writeFile(dataPath, toYaml(githubData, { lineWidth: 120 }), "utf-8");
+    console.log(`GitHub data written to ${dataPath}`);
+    console.log(`Total: ${pullRequests.length} PRs`);
+};
+const baseOptions = (cmd) => cmd
+    .option("-t, --token <token>", "GitHub token (env: GITHUB_TOKEN)")
+    .option("-u, --username <username>", "GitHub username (env: GITHUB_USERNAME)")
+    .option("--data-dir <dir>", "Data directory (env: DATA_DIR, default: ./data)")
+    .option("--timezone <tz>", "IANA timezone (env: TIMEZONE, default: UTC)")
+    .option("--date <date>", "Date within the target week (YYYY-MM-DD, default: today)");
+export const registerFetch = (program) => {
+    baseOptions(program
+        .command("daily-fetch")
+        .description("Fetch today's GitHub events and accumulate (run daily via cron)")).action(async (opts) => {
+        try {
+            const options = resolveBaseOptions(opts);
+            await runDailyFetch(options);
+        }
+        catch (error) {
+            console.error("Error:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    baseOptions(program
+        .command("weekly-fetch")
+        .description("Build full weekly data from accumulated events + individual PR fetches")).action(async (opts) => {
+        try {
+            const options = resolveBaseOptions(opts);
+            await runWeeklyFetch(options);
+        }
+        catch (error) {
+            console.error("Error:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+};
+//# sourceMappingURL=fetch.js.map

package/dist/cli/commands/fetch.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6GpC,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,IAoBnD,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuFpC,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,IAoBnD,CAAC"}

package/dist/cli/commands/generate.js

@@ -1,100 +1,79 @@
-// generate command: collect data, render HTML, write files to output directory
-import { writeFile, mkdir, readdir } from "node:fs/promises";
+// generate command: read github-data.yaml and generate LLM content
+import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { collectWeeklyData } from "../../collector/index.js";
-import { renderReport } from "../../renderer/index.js";
-import { generateNarrative } from "../../llm/index.js";
-import { renderIndexPage } from "../../deployer/index-page.js";
+import { parse as parseYaml, stringify as toYaml } from "yaml";
+import { generateContent } from "../../llm/index.js";
 import { getWeekId } from "../../deployer/week.js";
-import { loadConfig } from "../config.js";
+import { parseLocalDate } from "../../collector/date-range.js";
 const env = (key) => process.env[key];
-// Priority: CLI flag > env var > config file
-const resolveOptions = async (cli) => {
-    const config = await loadConfig();
-    const token = cli.token ?? env("GITHUB_TOKEN");
-    if (!token) {
-        throw new Error("GitHub token required. Pass --token or set GITHUB_TOKEN.");
-    }
-    const username = cli.username ?? env("GITHUB_USERNAME") ?? config.username;
-    if (!username) {
-        throw new Error("GitHub username required. Pass --username, set GITHUB_USERNAME, or add to config file.");
-    }
-    const llmProvider = (cli.llmProvider ?? env("LLM_PROVIDER") ?? config.llm?.provider);
-    const llmApiKey = cli.llmApiKey
-        ?? env("OPENAI_API_KEY")
-        ?? env("ANTHROPIC_API_KEY")
-        ?? env("GEMINI_API_KEY");
-    const llmModel = cli.llmModel ?? env("LLM_MODEL") ?? config.llm?.model;
+const resolveOptions = (cli) => {
+    const llmProvider = (cli.llmProvider ?? env("LLM_PROVIDER"));
+    if (!llmProvider)
+        throw new Error("LLM provider required. Pass --llm-provider or set LLM_PROVIDER.");
+    const providerKeyMap = {
+        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 envVarName = providerKeyMap[llmProvider];
+    const llmApiKey = cli.llmApiKey ?? (envVarName ? env(envVarName) : undefined);
+    if (!llmApiKey)
+        throw new Error(`LLM API key required. Pass --llm-api-key or set ${envVarName ?? "the provider's API key env var"}.`);
+    const llmModel = cli.llmModel ?? env("LLM_MODEL");
+    if (!llmModel)
+        throw new Error("LLM model required. Pass --llm-model or set LLM_MODEL.");
+    const language = (cli.language ?? env("LANGUAGE") ?? "en");
+    const timezone = cli.timezone ?? env("TIMEZONE") ?? "UTC";
+    const date = cli.date ? parseLocalDate(cli.date, timezone) : undefined;
     return {
-        token,
-        username,
-        output: cli.output ?? config.output ?? "./report",
-        theme: (cli.theme ?? config.theme ?? "default"),
+        dataDir: cli.dataDir ?? env("DATA_DIR") ?? "./data",
         llmProvider,
         llmApiKey,
         llmModel,
+        language,
+        timezone,
+        date,
     };
 };
-const listReportDirs = async (dir) => {
-    const paths = [];
-    let entries = [];
-    try {
-        entries = await readdir(dir);
-    }
-    catch {
-        return paths;
-    }
-    for (const year of entries.filter((n) => /^\d{4}$/.test(n))) {
-        const weeks = await readdir(join(dir, year));
-        weeks
-            .filter((n) => /^W\d{2}$/.test(n))
-            .forEach((w) => paths.push(`${year}/${w}`));
-    }
-    return paths;
-};
 const run = async (options) => {
-    const weekId = getWeekId();
-    console.log(`Collecting data for ${options.username}...`);
-    const data = await collectWeeklyData(options.token, options.username);
-    if (options.llmProvider && options.llmApiKey && options.llmModel) {
-        console.log(`Generating AI narrative (${options.llmProvider}/${options.llmModel})...`);
-        data.aiNarrative = await generateNarrative(data, {
-            provider: options.llmProvider,
-            apiKey: options.llmApiKey,
-            model: options.llmModel,
-        });
+    const weekId = getWeekId(options.date, options.timezone);
+    const dataDir = join(options.dataDir, weekId.path);
+    const dataPath = join(dataDir, "github-data.yaml");
+    console.log(`Reading ${dataPath}...`);
+    const raw = await readFile(dataPath, "utf-8");
+    const data = parseYaml(raw);
+    console.log(`Generating AI content (${options.llmProvider}/${options.llmModel}, lang: ${options.language})...`);
+    const aiContent = await generateContent({ ...data, language: options.language }, {
+        provider: options.llmProvider,
+        apiKey: options.llmApiKey,
+        model: options.llmModel,
+        language: options.language,
+    });
+    if (!aiContent) {
+        console.error("LLM returned no content.");
+        process.exit(1);
     }
-    console.log(`Rendering report (theme: ${options.theme})...`);
-    const html = renderReport(data, options.theme);
-    // Write report to week directory
-    const reportDir = join(options.output, weekId.path);
-    await mkdir(reportDir, { recursive: true });
-    const reportPath = join(reportDir, "index.html");
-    await writeFile(reportPath, html, "utf-8");
-    console.log(`Report written to ${reportPath}`);
-    // Write index page
-    const allReports = await listReportDirs(options.output);
-    if (!allReports.includes(weekId.path))
-        allReports.push(weekId.path);
-    const indexHtml = renderIndexPage(allReports, options.theme);
-    const indexPath = join(options.output, "index.html");
-    await writeFile(indexPath, indexHtml, "utf-8");
-    console.log(`Index written to ${indexPath}`);
+    const llmDataPath = join(dataDir, "llm-data.yaml");
+    await writeFile(llmDataPath, toYaml(aiContent, { lineWidth: 120 }), "utf-8");
+    console.log(`LLM data written to ${llmDataPath}`);
 };
 export const registerGenerate = (program) => {
     program
         .command("generate")
-        .description("Collect GitHub data and generate a weekly report")
-        .option("-t, --token <token>", "GitHub token (env: GITHUB_TOKEN)")
-        .option("-u, --username <username>", "GitHub username (env: GITHUB_USERNAME, config: username)")
-        .option("-o, --output <dir>", "Output directory (config: output)")
-        .option("--theme <theme>", "Report theme (config: theme)")
-        .option("--llm-provider <provider>", "LLM provider (env: LLM_PROVIDER, config: llm.provider)")
-        .option("--llm-api-key <key>", "LLM API key (env: OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY)")
-        .option("--llm-model <model>", "LLM model name (env: LLM_MODEL, config: llm.model)")
+        .description("Generate AI content from fetched GitHub data")
+        .option("--data-dir <dir>", "Data directory (env: DATA_DIR, default: ./data)")
+        .option("--llm-provider <provider>", "LLM provider (env: LLM_PROVIDER)")
+        .option("--llm-api-key <key>", "LLM API key (env: OPENROUTER_API_KEY / GROQ_API_KEY / GEMINI_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY / GROK_API_KEY)")
+        .option("--llm-model <model>", "LLM model name (env: LLM_MODEL)")
+        .option("--language <lang>", "Report language: en, ja, zh-CN, zh-TW, ko, es, fr, de, pt, ru (env: LANGUAGE, default: en)")
+        .option("--timezone <tz>", "IANA timezone (env: TIMEZONE, default: UTC)")
+        .option("--date <date>", "Date within the target week (YYYY-MM-DD, default: today)")
         .action(async (opts) => {
         try {
-            const options = await resolveOptions(opts);
+            const options = resolveOptions(opts);
             await run(options);
         }
         catch (error) {