standup-mr 0.1.0

package/dist/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import {
+  ConfigError,
+  GitLabProvider,
+  buildReport,
+  glabHosts,
+  glabToken,
+  postWebhook,
+  resolveHost,
+  resolveToken,
+  toMarkdown
+} from "./chunk-SKCJT2AY.js";
+
+// src/cli/cli.ts
+import { pathToFileURL } from "url";
+import { parseArgs } from "util";
+
+// src/cli/cli.constants.ts
+var USAGE = `standup \u2014 standup notes from merge request state
+
+Usage:
+  standup fetch [--host H] [--token T] [--lang en|tr] [--markdown]
+  standup post (--slack URL | --discord URL) [--text TEXT]
+
+Credentials resolve as: flag, then GITLAB_HOST / GITLAB_TOKEN, then glab config.
+--text defaults to '-', meaning read stdin.`;
+
+// src/cli/cli.ts
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(Buffer.from(chunk));
+  return Buffer.concat(chunks).toString("utf8");
+}
+function connect(values) {
+  const host = resolveHost(values.host, process.env.GITLAB_HOST, glabHosts());
+  const token = resolveToken(host, values.token, process.env.GITLAB_TOKEN, glabToken);
+  return new GitLabProvider(host, token);
+}
+async function main(argv) {
+  const [command, ...rest] = argv;
+  if (!command || command === "--help" || command === "-h") {
+    process.stdout.write(`${USAGE}
+`);
+    return command ? 0 : 1;
+  }
+  try {
+    if (command === "fetch") {
+      const { values } = parseArgs({
+        args: rest,
+        options: {
+          host: { type: "string" },
+          token: { type: "string" },
+          lang: { type: "string", default: "en" },
+          markdown: { type: "boolean", default: false }
+        }
+      });
+      const report = await buildReport(connect(values), /* @__PURE__ */ new Date(), values.lang);
+      const output = values.markdown ? toMarkdown(report, values.lang) : JSON.stringify(report, null, 1);
+      process.stdout.write(`${output}
+`);
+      return 0;
+    }
+    if (command === "post") {
+      const { values } = parseArgs({
+        args: rest,
+        options: {
+          slack: { type: "string" },
+          discord: { type: "string" },
+          text: { type: "string", default: "-" }
+        }
+      });
+      const url = values.slack ?? values.discord;
+      if (!url) {
+        process.stderr.write("Pass --slack URL or --discord URL.\n");
+        return 1;
+      }
+      const text = values.text === "-" ? await readStdin() : values.text;
+      if (!text.trim()) {
+        process.stderr.write("Nothing to post: empty text.\n");
+        return 1;
+      }
+      await postWebhook(url, text, values.slack ? "slack" : "discord");
+      return 0;
+    }
+    process.stderr.write(`Unknown command: ${command}
+
+${USAGE}
+`);
+    return 1;
+  } catch (error) {
+    const message = error instanceof ConfigError || error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}
+`);
+    return 1;
+  }
+}
+var entry = process.argv[1];
+if (entry && import.meta.url === pathToFileURL(entry).href) {
+  main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+  });
+}
+export {
+  main
+};

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+interface BucketInput {
+    draft: boolean;
+    pipeline: string | null;
+    unresolved: number;
+    updated: string;
+}
+interface PipelineInput {
+    project: string;
+    pipeline: string | null;
+    pipelineMissing?: boolean;
+}
+
+type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
+type Bucket = 'ready' | 'blocked' | 'draft' | 'stale';
+interface Identity {
+    id: number;
+    username: string;
+}
+interface ActivityEvent {
+    at: string;
+    action: string;
+    project: string;
+    targetType: string;
+    title: string;
+    branch: string;
+    commits: number;
+    commitTitle: string;
+}
+interface MergeRequest {
+    project: string;
+    projectId: number;
+    iid: number;
+    title: string;
+    draft: boolean;
+    branch: string;
+    target: string;
+    updated: string;
+    url: string;
+    mergeStatus: string | null;
+    pipeline: string | null;
+    pipelineId: number | null;
+    unresolved: number;
+    pipelineMissing: boolean;
+    bucket: Bucket;
+}
+interface Review {
+    project: string;
+    iid: number;
+    title: string;
+    author: string;
+    updated: string;
+    draft: boolean;
+    url: string;
+    fresh: boolean;
+    approvedByMe: boolean;
+}
+interface Blocker {
+    project: string;
+    mr: number;
+    title: string;
+    job: string;
+    stage: string;
+    url: string;
+    errors: string[];
+}
+interface StandupReport {
+    user: string;
+    today: {
+        date: string;
+        label: string;
+    };
+    previous: {
+        date: string | null;
+        label: string | null;
+        gapDays: number | null;
+        eventCount: number;
+    };
+    previousEvents: ActivityEvent[];
+    todayEvents: ActivityEvent[];
+    myMrs: MergeRequest[];
+    reviews: Review[];
+    reviewPendingCount: number;
+    blockers: Blocker[];
+}
+
+declare function classify(mr: BucketInput, today: Date, staleDays?: number): Bucket;
+declare function markMissingPipelines(mrs: PipelineInput[]): void;
+
+declare const STALE_DAYS = 14;
+
+declare class ConfigError extends Error {
+    constructor(message: string);
+}
+declare function resolveHost(cliHost?: string, envHost?: string, glabHostList?: string[]): string;
+declare function resolveToken(host: string, cliToken?: string, envToken?: string, glabLookup?: (host: string) => string): string;
+declare function glabHosts(): string[];
+declare function glabToken(host: string): string;
+
+declare function isoDay(day: Date): string;
+declare function label(day: Date, lang?: string): string;
+declare function previousActiveDay(eventDates: Set<string>, today: Date): {
+    date: string | null;
+    gapDays: number | null;
+};
+
+declare const PAYLOAD_FIELD: {
+    readonly slack: "text";
+    readonly discord: "content";
+};
+
+type WebhookKind = keyof typeof PAYLOAD_FIELD;
+
+declare function postWebhook(url: string, text: string, kind?: WebhookKind, fetchImpl?: FetchLike): Promise<void>;
+
+interface Provider {
+    getIdentity(): Promise<Identity>;
+    getEvents(since: Date): Promise<ActivityEvent[]>;
+    getMyMrs(today: Date): Promise<MergeRequest[]>;
+    getReviews(uid: number, today: Date): Promise<Review[]>;
+    getBlockers(mrs: MergeRequest[]): Promise<Blocker[]>;
+}
+
+type Params = Record<string, string | number>;
+declare class GitLabProvider implements Provider {
+    readonly host: string;
+    readonly api: string;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(host: string, token: string, fetchImpl?: FetchLike);
+    private url;
+    getJson<T>(path: string, params?: Params): Promise<T | null>;
+    getText(path: string): Promise<string>;
+    getPaged<T>(path: string, params?: Params, cap?: number): Promise<T[]>;
+    getIdentity(): Promise<Identity>;
+    projectPath(projectId: number): Promise<string>;
+    getEvents(since: Date): Promise<ActivityEvent[]>;
+    private countUnresolved;
+    private shapeMr;
+    getMyMrs(today: Date): Promise<MergeRequest[]>;
+    private approvedByMe;
+    getReviews(uid: number, today: Date): Promise<Review[]>;
+    getBlockers(mrs: MergeRequest[]): Promise<Blocker[]>;
+}
+
+declare function toMarkdown(report: StandupReport, lang?: string): string;
+
+declare function buildReport(provider: Provider, today: Date, lang?: string, lookbackDays?: number): Promise<StandupReport>;
+
+declare function extractErrors(rawTrace: string, limit?: number): string[];
+
+export { type ActivityEvent, type Blocker, type Bucket, ConfigError, type FetchLike, GitLabProvider, type Identity, type MergeRequest, type Provider, type Review, STALE_DAYS, type StandupReport, buildReport, classify, extractErrors, glabHosts, glabToken, isoDay, label, markMissingPipelines, postWebhook, previousActiveDay, resolveHost, resolveToken, toMarkdown };

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import {
+  ConfigError,
+  GitLabProvider,
+  STALE_DAYS,
+  buildReport,
+  classify,
+  extractErrors,
+  glabHosts,
+  glabToken,
+  isoDay,
+  label,
+  markMissingPipelines,
+  postWebhook,
+  previousActiveDay,
+  resolveHost,
+  resolveToken,
+  toMarkdown
+} from "./chunk-SKCJT2AY.js";
+export {
+  ConfigError,
+  GitLabProvider,
+  STALE_DAYS,
+  buildReport,
+  classify,
+  extractErrors,
+  glabHosts,
+  glabToken,
+  isoDay,
+  label,
+  markMissingPipelines,
+  postWebhook,
+  previousActiveDay,
+  resolveHost,
+  resolveToken,
+  toMarkdown
+};