@agentrhq/webcmd 0.1.2 → 0.2.0

package/scripts/generate-release-notes.ts

@@ -0,0 +1,234 @@
+import { execFileSync } from 'node:child_process';
+import { pathToFileURL } from 'node:url';
+import { GoogleGenAI } from '@google/genai';
+import {
+  buildReleaseNotesPrompt,
+  extractPullRequestNumber,
+  filterReleasePullRequests,
+  normalizeReleaseNotes,
+  type PullRequestDetails,
+  type ReleaseContext,
+} from '../src/release-notes.js';
+
+interface ReleaseSummary {
+  tag_name: string;
+}
+
+interface CompareCommitResponse {
+  sha: string;
+  commit?: {
+    message?: string;
+  };
+  author?: {
+    login?: string;
+  } | null;
+}
+
+interface CompareResponse {
+  commits: CompareCommitResponse[];
+}
+
+interface PullRequestResponse {
+  number: number;
+  title: string;
+  body?: string | null;
+  user?: {
+    login?: string;
+  } | null;
+  labels?: Array<{
+    name?: string;
+  }>;
+  html_url: string;
+  merged_at?: string | null;
+}
+
+interface PullRequestFileResponse {
+  filename: string;
+}
+
+interface Io {
+  writeStdout: (chunk: string) => void;
+  writeStderr: (chunk: string) => void;
+}
+
+interface RunDependencies {
+  loadContext?: (tag: string, env: NodeJS.ProcessEnv) => Promise<ReleaseContext>;
+  generateText?: (prompt: string, model: string, apiKey: string) => Promise<string>;
+}
+
+type GhRunner = (args: readonly string[]) => string;
+
+interface LoadReleaseContextOptions {
+  gh?: GhRunner;
+  maxDiffCharacters?: number;
+}
+
+const DEFAULT_MODEL = 'gemini-2.5-pro';
+const DEFAULT_MAX_DIFF_CHARACTERS = 24_000;
+const DEFAULT_IO: Io = {
+  writeStdout: (chunk) => process.stdout.write(chunk),
+  writeStderr: (chunk) => process.stderr.write(chunk),
+};
+
+function execGh(args: readonly string[]): string {
+  return execFileSync('gh', [...args], {
+    encoding: 'utf8',
+    timeout: 300_000,
+    maxBuffer: 10 * 1024 * 1024,
+  });
+}
+
+function ghJson<T>(args: readonly string[], gh: GhRunner = execGh): T {
+  return JSON.parse(gh(args)) as T;
+}
+
+function normalizeTag(tag: string): string {
+  const value = tag.trim();
+  if (!value) {
+    throw new Error('Release tag is empty');
+  }
+
+  return value;
+}
+
+function resolveRepository(env: NodeJS.ProcessEnv, gh: GhRunner = execGh): string {
+  const repository = env.GITHUB_REPOSITORY?.trim();
+  if (repository) return repository;
+
+  const fallback = gh(['repo', 'view', '--json', 'nameWithOwner', '--jq', '.nameWithOwner']).trim();
+  if (!fallback) {
+    throw new Error('Unable to determine GitHub repository');
+  }
+
+  return fallback;
+}
+
+function getPreviousTag(repository: string, tag: string, gh: GhRunner = execGh): string {
+  const releases = ghJson<ReleaseSummary[]>(['api', `repos/${repository}/releases?per_page=100`], gh);
+  const currentIndex = releases.findIndex((release) => release.tag_name === tag);
+  if (currentIndex === -1) {
+    throw new Error(`Could not find GitHub release for tag ${tag}`);
+  }
+
+  const previousTag = releases.slice(currentIndex + 1).find((release) => release.tag_name !== tag)?.tag_name;
+  if (!previousTag) {
+    throw new Error(`Could not determine previous release tag for ${tag}`);
+  }
+
+  return previousTag;
+}
+
+function collectPullRequestNumbers(commits: CompareCommitResponse[]): number[] {
+  return [...new Set(
+    commits
+      .map((commit) => extractPullRequestNumber(commit.commit?.message ?? ''))
+      .filter((value): value is number => value !== null),
+  )];
+}
+
+function truncateDiff(diff: string, maxCharacters: number): string {
+  const trimmed = diff.trim();
+  if (trimmed.length <= maxCharacters) return trimmed;
+
+  return `${trimmed.slice(0, maxCharacters).trimEnd()}\n[diff truncated]`;
+}
+
+function loadPullRequestDiff(repository: string, number: number, gh: GhRunner, maxCharacters: number): string {
+  try {
+    return truncateDiff(gh(['pr', 'diff', String(number), '--repo', repository]), maxCharacters);
+  } catch {
+    return '';
+  }
+}
+
+function loadPullRequest(repository: string, number: number, gh: GhRunner = execGh, maxDiffCharacters = DEFAULT_MAX_DIFF_CHARACTERS): PullRequestDetails {
+  const details = ghJson<PullRequestResponse>(['api', `repos/${repository}/pulls/${number}`], gh);
+  const files = ghJson<PullRequestFileResponse[]>(['api', `repos/${repository}/pulls/${number}/files?per_page=100`], gh);
+  const diff = loadPullRequestDiff(repository, number, gh, maxDiffCharacters);
+
+  return {
+    number: details.number,
+    title: details.title,
+    body: details.body ?? null,
+    author: details.user?.login ? { login: details.user.login } : null,
+    labels: (details.labels ?? []).flatMap((label) => (label.name ? [{ name: label.name }] : [])),
+    files: files.map((file) => ({ path: file.filename })),
+    diff,
+    url: details.html_url,
+    mergedAt: details.merged_at ?? null,
+  };
+}
+
+export async function loadReleaseContext(tag: string, env: NodeJS.ProcessEnv, options: LoadReleaseContextOptions = {}): Promise<ReleaseContext> {
+  const gh = options.gh ?? execGh;
+  const normalizedTag = normalizeTag(tag);
+  const repository = resolveRepository(env, gh);
+  const previousTag = getPreviousTag(repository, normalizedTag, gh);
+  const compare = ghJson<CompareResponse>(['api', `repos/${repository}/compare/${previousTag}...${normalizedTag}`], gh);
+  const pullRequests = filterReleasePullRequests(
+    collectPullRequestNumbers(compare.commits).map((number) => loadPullRequest(repository, number, gh, options.maxDiffCharacters)),
+  );
+
+  return {
+    tag: normalizedTag,
+    previousTag,
+    currentRef: normalizedTag,
+    pullRequests,
+  };
+}
+
+async function generateText(prompt: string, model: string, apiKey: string): Promise<string> {
+  const client = new GoogleGenAI({ apiKey });
+  const response = await client.models.generateContent({
+    model,
+    contents: prompt,
+  });
+  const text = response.text?.trim();
+  if (!text) {
+    throw new Error('Gemini returned empty content');
+  }
+
+  return text;
+}
+
+function contributorHandles(pullRequests: PullRequestDetails[]): string[] {
+  return pullRequests.flatMap((pr) => (pr.author?.login ? [pr.author.login] : []));
+}
+
+export async function runGenerateReleaseNotes(
+  argv: string[] = process.argv,
+  env: NodeJS.ProcessEnv = process.env,
+  deps: RunDependencies = {},
+  io: Io = DEFAULT_IO,
+): Promise<number> {
+  const tag = argv[2];
+  if (!tag) {
+    io.writeStderr('Usage: generate-release-notes <tag>\n');
+    return 1;
+  }
+
+  const apiKey = env.GEMINI_API_KEY?.trim();
+  if (!apiKey) {
+    io.writeStderr('GEMINI_API_KEY is not set; leaving release-please notes unchanged.\n');
+    return 0;
+  }
+
+  try {
+    const context = await (deps.loadContext ?? loadReleaseContext)(tag, env);
+    const model = env.GEMINI_RELEASE_NOTES_MODEL || DEFAULT_MODEL;
+    const prompt = buildReleaseNotesPrompt(context);
+    const raw = await (deps.generateText ?? generateText)(prompt, model, apiKey);
+    const normalized = normalizeReleaseNotes(raw, contributorHandles(context.pullRequests));
+    io.writeStdout(`${normalized}\n`);
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    io.writeStderr(`Gemini release notes failed: ${message}\n`);
+    return 0;
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const exitCode = await runGenerateReleaseNotes();
+  process.exit(exitCode);
+}

package/scripts/postinstall.js

@@ -162,7 +162,7 @@ function main() {
   // ── Browser runtime setup hint ──────────────────────────────────────
   console.log('');
   console.log('  \x1b[1mNext step — Browser runtime setup\x1b[0m');
-  console.log('  Browser commands (bilibili, zhihu, twitter...) use a webcmd-managed CloakBrowser runtime.');
+  console.log('  Browser commands (youtube, reddit, twitter...) use a webcmd-managed CloakBrowser runtime.');
   console.log('  On first use, CloakBrowser downloads its Chromium binary.');
   console.log('  Existing Chrome logins are not imported, so run the site login command again when needed.');
   console.log('');