@wilsong/shiplog 0.1.0

package/src/index.ts

@@ -0,0 +1,266 @@
+/**
+ * ShipLog — Session reports for vibe-coding developers.
+ * "What did your AI build while you were at the gym?"
+ *
+ * Analyzes git commits, generates branded HTML email summaries,
+ * and sends them via Resend. Works with any AI coding tool.
+ */
+
+import simpleGit, { SimpleGit, LogResult } from "simple-git";
+import { Resend } from "resend";
+
+export interface ShipLogConfig {
+  /** Email address to send the report to */
+  email: string;
+  /** CC recipients (team, investors, clients) */
+  cc?: string[];
+  /** Resend API key for email delivery */
+  resendApiKey: string;
+  /** Brand name shown in email header */
+  brandName?: string;
+  /** Brand color (hex) for email accent */
+  brandColor?: string;
+  /** From email address (must be verified in Resend) */
+  fromEmail?: string;
+  /** Git repo path (defaults to cwd) */
+  repoPath?: string;
+  /** Include LinkedIn post draft in email */
+  includeLinkedInDraft?: boolean;
+}
+
+export interface SessionReport {
+  totalCommits: number;
+  filesChanged: number;
+  insertions: number;
+  deletions: number;
+  features: string[];
+  fixes: string[];
+  refactors: string[];
+  other: string[];
+  authors: Record<string, number>;
+  directories: Record<string, number>;
+  timeRange: { from: string; to: string };
+  duration: string;
+  linkedInDraft?: string;
+}
+
+/**
+ * Categorize a commit message into feature/fix/refactor/other
+ */
+function categorizeCommit(message: string): "feature" | "fix" | "refactor" | "other" {
+  const lower = message.toLowerCase();
+  if (lower.startsWith("feat") || lower.includes("add") || lower.includes("implement") || lower.includes("ship")) return "feature";
+  if (lower.startsWith("fix") || lower.includes("bug") || lower.includes("patch") || lower.includes("hotfix")) return "fix";
+  if (lower.startsWith("refactor") || lower.includes("cleanup") || lower.includes("reorganize") || lower.includes("rename")) return "refactor";
+  return "other";
+}
+
+/**
+ * Calculate human-readable duration between two dates
+ */
+function humanDuration(from: Date, to: Date): string {
+  const diffMs = to.getTime() - from.getTime();
+  const hours = Math.floor(diffMs / 3600000);
+  const minutes = Math.floor((diffMs % 3600000) / 60000);
+  if (hours > 0) return `${hours}h ${minutes}m`;
+  return `${minutes}m`;
+}
+
+export class ShipLog {
+  private git: SimpleGit;
+  private resend: Resend;
+  private config: Required<
+    Pick<ShipLogConfig, "email" | "resendApiKey" | "brandName" | "brandColor" | "fromEmail">
+  > & ShipLogConfig;
+
+  constructor(config: ShipLogConfig) {
+    this.config = {
+      brandName: "ShipLog",
+      brandColor: "#0077B5",
+      fromEmail: "ShipLog <updates@shiplog.dev>",
+      ...config,
+    };
+    this.git = simpleGit(config.repoPath || process.cwd());
+    this.resend = new Resend(config.resendApiKey);
+  }
+
+  /**
+   * Analyze git history since a given time and return a structured report
+   */
+  async analyze(options: { since?: string; branch?: string } = {}): Promise<SessionReport> {
+    const since = options.since || "8 hours ago";
+    const branch = options.branch || "HEAD";
+
+    // Get commits since the given time
+    const log: LogResult = await this.git.log({
+      from: "",
+      to: branch,
+      "--since": since,
+      "--stat": null,
+    });
+
+    const features: string[] = [];
+    const fixes: string[] = [];
+    const refactors: string[] = [];
+    const other: string[] = [];
+    const authors: Record<string, number> = {};
+    const directories: Record<string, number> = {};
+    let totalInsertions = 0;
+    let totalDeletions = 0;
+    let totalFilesChanged = 0;
+
+    for (const commit of log.all) {
+      const msg = commit.message.split("\n")[0]; // First line only
+      const category = categorizeCommit(msg);
+
+      switch (category) {
+        case "feature": features.push(msg); break;
+        case "fix": fixes.push(msg); break;
+        case "refactor": refactors.push(msg); break;
+        default: other.push(msg); break;
+      }
+
+      // Track authors
+      const author = commit.author_name || "Unknown";
+      authors[author] = (authors[author] || 0) + 1;
+
+      // Parse diff stat from commit body
+      const diffStat = commit.diff?.changed || 0;
+      const ins = commit.diff?.insertions || 0;
+      const del = commit.diff?.deletions || 0;
+      totalFilesChanged += diffStat;
+      totalInsertions += ins;
+      totalDeletions += del;
+
+      // Track directories from changed files
+      if (commit.diff?.files) {
+        for (const file of commit.diff.files) {
+          const dir = file.file.split("/").slice(0, 2).join("/");
+          directories[dir] = (directories[dir] || 0) + 1;
+        }
+      }
+    }
+
+    const commits = log.all;
+    const from = commits.length > 0 ? commits[commits.length - 1].date : new Date().toISOString();
+    const to = commits.length > 0 ? commits[0].date : new Date().toISOString();
+    const duration = humanDuration(new Date(from), new Date(to));
+
+    const report: SessionReport = {
+      totalCommits: log.total,
+      filesChanged: totalFilesChanged,
+      insertions: totalInsertions,
+      deletions: totalDeletions,
+      features,
+      fixes,
+      refactors,
+      other,
+      authors,
+      directories,
+      timeRange: { from, to },
+      duration,
+    };
+
+    // Generate LinkedIn draft if requested
+    if (this.config.includeLinkedInDraft) {
+      report.linkedInDraft = this.generateLinkedInDraft(report);
+    }
+
+    return report;
+  }
+
+  /**
+   * Generate a branded HTML email from a session report
+   */
+  buildEmail(report: SessionReport): string {
+    const { brandName, brandColor } = this.config;
+    const featureList = report.features.map(f => `<li>${escapeHtml(f)}</li>`).join("");
+    const fixList = report.fixes.map(f => `<li>${escapeHtml(f)}</li>`).join("");
+    const refactorList = report.refactors.map(f => `<li>${escapeHtml(f)}</li>`).join("");
+    const otherList = report.other.map(f => `<li>${escapeHtml(f)}</li>`).join("");
+
+    const sections: string[] = [];
+    if (report.features.length > 0) sections.push(`<h2 style="color:#22c55e;border-bottom:2px solid #22c55e;padding-bottom:4px">✨ Features (${report.features.length})</h2><ul style="font-size:13px">${featureList}</ul>`);
+    if (report.fixes.length > 0) sections.push(`<h2 style="color:#ef4444;border-bottom:2px solid #ef4444;padding-bottom:4px">🔧 Fixes (${report.fixes.length})</h2><ul style="font-size:13px">${fixList}</ul>`);
+    if (report.refactors.length > 0) sections.push(`<h2 style="color:#8b5cf6;border-bottom:2px solid #8b5cf6;padding-bottom:4px">♻️ Refactors (${report.refactors.length})</h2><ul style="font-size:13px">${refactorList}</ul>`);
+    if (report.other.length > 0) sections.push(`<h2 style="color:#6b7280;border-bottom:2px solid #6b7280;padding-bottom:4px">📝 Other (${report.other.length})</h2><ul style="font-size:13px">${otherList}</ul>`);
+
+    const authorRows = Object.entries(report.authors).map(([name, count]) => `<span style="margin-right:12px">${escapeHtml(name)}: <strong>${count}</strong></span>`).join("");
+
+    return `<div style="font-family:system-ui,-apple-system,sans-serif;max-width:600px;margin:0 auto;padding:20px;color:#1a1a2e">
+<div style="background:${brandColor};color:white;padding:16px 20px;border-radius:12px 12px 0 0">
+  <h1 style="margin:0;font-size:20px">${escapeHtml(brandName)} — Session Report</h1>
+  <p style="margin:4px 0 0;opacity:0.85;font-size:13px">${report.timeRange.from.split("T")[0]} • ${report.duration} session</p>
+</div>
+
+<div style="background:#f8fafc;padding:16px 20px;border:1px solid #e2e8f0;border-top:none">
+  <div style="display:flex;gap:20px;text-align:center">
+    <div><div style="font-size:28px;font-weight:bold;color:${brandColor}">${report.totalCommits}</div><div style="font-size:11px;color:#64748b">Commits</div></div>
+    <div><div style="font-size:28px;font-weight:bold;color:#22c55e">${report.features.length}</div><div style="font-size:11px;color:#64748b">Features</div></div>
+    <div><div style="font-size:28px;font-weight:bold;color:#ef4444">${report.fixes.length}</div><div style="font-size:11px;color:#64748b">Fixes</div></div>
+    <div><div style="font-size:28px;font-weight:bold;color:#64748b">+${report.insertions}/-${report.deletions}</div><div style="font-size:11px;color:#64748b">Lines</div></div>
+  </div>
+</div>
+
+<div style="padding:16px 20px;border:1px solid #e2e8f0;border-top:none;border-radius:0 0 12px 12px">
+  ${sections.join("\n")}
+  <div style="margin-top:16px;padding:12px;background:#f1f5f9;border-radius:8px;font-size:12px;color:#475569">
+    <strong>Authors:</strong> ${authorRows}
+  </div>
+</div>
+
+<p style="color:#94a3b8;font-size:10px;text-align:center;margin-top:16px">Powered by <a href="https://shiplog.dev" style="color:${brandColor}">ShipLog</a> — session reports for vibe-coding developers</p>
+</div>`;
+  }
+
+  /**
+   * Analyze git history and send the email report
+   */
+  async analyzeAndSend(options: { since?: string; branch?: string } = {}): Promise<{
+    report: SessionReport;
+    emailId: string;
+  }> {
+    const report = await this.analyze(options);
+
+    if (report.totalCommits === 0) {
+      throw new Error("No commits found in the specified time range");
+    }
+
+    const html = this.buildEmail(report);
+    const subject = `${this.config.brandName}: ${report.totalCommits} commits — ${report.features.length} features, ${report.fixes.length} fixes`;
+
+    const { data, error } = await this.resend.emails.send({
+      from: this.config.fromEmail,
+      to: this.config.email,
+      cc: this.config.cc,
+      subject,
+      html,
+    });
+
+    if (error) throw new Error(`Email send failed: ${error.message}`);
+
+    return { report, emailId: data?.id || "sent" };
+  }
+
+  /**
+   * Generate a LinkedIn post draft from the session report
+   */
+  private generateLinkedInDraft(report: SessionReport): string {
+    const topFeatures = report.features.slice(0, 3).map(f => `→ ${f}`).join("\n");
+    return `Shipped ${report.totalCommits} commits today.
+
+${report.features.length} features. ${report.fixes.length} fixes. ${report.duration} of building.
+
+${topFeatures}
+
+The best developers don't just code — they ship. And they communicate what they shipped.
+
+What did you build today?
+
+#BuildInPublic #ShipLog #FounderLife`;
+  }
+}
+
+function escapeHtml(str: string): string {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}