autocrew 0.1.0

package/src/modules/auth/cookie-manager.ts

@@ -0,0 +1,113 @@
+/**
+ * Cookie manager — stores and retrieves platform cookies for AutoCrew.
+ *
+ * Cookies are stored at ~/.autocrew/auth/{platform}.json, encrypted with
+ * a key derived from the machine ID (hostname + username).
+ */
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs/promises";
+import crypto from "node:crypto";
+
+const AUTH_DIR = path.join(os.homedir(), ".autocrew", "auth");
+const ALGORITHM = "aes-256-gcm";
+
+interface StoredCookie {
+  ciphertext: string;
+  iv: string;
+  tag: string;
+  savedAt: string;
+}
+
+function deriveKey(): Buffer {
+  const machineId = `${os.hostname()}:${os.userInfo().username}:autocrew-cookie-v1`;
+  return crypto.createHash("sha256").update(machineId).digest();
+}
+
+function encrypt(plaintext: string): { ciphertext: string; iv: string; tag: string } {
+  const key = deriveKey();
+  const iv = crypto.randomBytes(16);
+  const cipher = crypto.createCipheriv(ALGORITHM, key, iv);
+  let encrypted = cipher.update(plaintext, "utf8", "hex");
+  encrypted += cipher.final("hex");
+  const tag = cipher.getAuthTag();
+  return {
+    ciphertext: encrypted,
+    iv: iv.toString("hex"),
+    tag: tag.toString("hex"),
+  };
+}
+
+function decrypt(data: { ciphertext: string; iv: string; tag: string }): string {
+  const key = deriveKey();
+  const iv = Buffer.from(data.iv, "hex");
+  const decipher = crypto.createDecipheriv(ALGORITHM, key, iv);
+  decipher.setAuthTag(Buffer.from(data.tag, "hex"));
+  let decrypted = decipher.update(data.ciphertext, "hex", "utf8");
+  decrypted += decipher.final("utf8");
+  return decrypted;
+}
+
+function cookieFilePath(platform: string): string {
+  return path.join(AUTH_DIR, `${platform}.json`);
+}
+
+export async function saveCookie(platform: string, cookie: string): Promise<void> {
+  await fs.mkdir(AUTH_DIR, { recursive: true });
+  const encrypted = encrypt(cookie);
+  const stored: StoredCookie = {
+    ...encrypted,
+    savedAt: new Date().toISOString(),
+  };
+  await fs.writeFile(cookieFilePath(platform), JSON.stringify(stored, null, 2), "utf-8");
+}
+
+export async function loadCookie(platform: string): Promise<string | null> {
+  try {
+    const raw = await fs.readFile(cookieFilePath(platform), "utf-8");
+    const stored: StoredCookie = JSON.parse(raw);
+    return decrypt(stored);
+  } catch {
+    return null;
+  }
+}
+
+export type CookieHealthStatus = "valid" | "missing" | "decrypt_failed" | "incomplete";
+
+export interface CookieHealthResult {
+  status: CookieHealthStatus;
+  missingFields?: string[];
+}
+
+const REQUIRED_FIELDS: Record<string, string[]> = {
+  xiaohongshu: ["a1", "web_session"],
+};
+
+export async function checkCookieHealth(platform: string): Promise<CookieHealthResult> {
+  const cookie = await loadCookie(platform);
+  if (cookie === null) {
+    // Distinguish between missing file and decryption failure
+    try {
+      await fs.access(cookieFilePath(platform));
+      return { status: "decrypt_failed" };
+    } catch {
+      return { status: "missing" };
+    }
+  }
+
+  const requiredFields = REQUIRED_FIELDS[platform];
+  if (!requiredFields) {
+    return { status: "valid" };
+  }
+
+  const cookieFields = new Set(
+    cookie.split(";").map((p) => p.trim().split("=")[0]?.trim()).filter(Boolean),
+  );
+
+  const missing = requiredFields.filter((f) => !cookieFields.has(f));
+  if (missing.length > 0) {
+    return { status: "incomplete", missingFields: missing };
+  }
+
+  return { status: "valid" };
+}

package/src/modules/cards/template-engine.ts

@@ -0,0 +1,74 @@
+// Card template engine — renders HTML knowledge cards for video overlay
+
+import type { AspectRatio, CardTemplate } from "../../types/timeline.js";
+import { render as comparisonTable } from "./templates/comparison-table.js";
+import { render as keyPoints } from "./templates/key-points.js";
+import { render as flowChart } from "./templates/flow-chart.js";
+import { render as dataChart } from "./templates/data-chart.js";
+
+const DIMENSIONS: Record<AspectRatio, { width: number; height: number }> = {
+  "9:16": { width: 1080, height: 1920 },
+  "16:9": { width: 1920, height: 1080 },
+  "3:4": { width: 1080, height: 1440 },
+  "1:1": { width: 1080, height: 1080 },
+  "4:3": { width: 1440, height: 1080 },
+};
+
+const renderers: Record<CardTemplate, (data: Record<string, unknown>) => string> = {
+  "comparison-table": comparisonTable,
+  "key-points": keyPoints,
+  "flow-chart": flowChart,
+  "data-chart": dataChart,
+};
+
+export interface RenderCardOptions {
+  aspectRatio?: AspectRatio;
+}
+
+/**
+ * Render a knowledge card as a complete HTML document.
+ * The output is designed to be screenshotted by Puppeteer at the exact
+ * pixel dimensions matching the chosen aspect ratio.
+ */
+export function renderCard(
+  template: CardTemplate,
+  data: Record<string, unknown>,
+  options?: RenderCardOptions
+): string {
+  const renderer = renderers[template];
+  if (!renderer) {
+    throw new Error(`Unknown card template: ${template}`);
+  }
+
+  const ratio = options?.aspectRatio ?? "9:16";
+  const { width, height } = DIMENSIONS[ratio];
+  const body = renderer(data);
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=${width}">
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body {
+    width: ${width}px;
+    height: ${height}px;
+    overflow: hidden;
+  }
+  body {
+    background: #ffffff;
+    font-family: "PingFang SC", "Microsoft YaHei", sans-serif;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 80px;
+    color: #1e293b;
+  }
+</style>
+</head>
+<body>
+${body}
+</body>
+</html>`;
+}

package/src/modules/cards/templates/comparison-table.ts

@@ -0,0 +1,71 @@
+// Comparison table template — renders a table with pros/cons columns
+
+export function render(data: Record<string, unknown>): string {
+  const title = (data.title as string) ?? "";
+  const rows = (data.rows as Array<{ name: string; pros: string; cons: string }>) ?? [];
+
+  const rowsHtml = rows
+    .map(
+      (r) => `
+      <tr>
+        <td class="name">${esc(r.name)}</td>
+        <td class="pros">${esc(r.pros)}</td>
+        <td class="cons">${esc(r.cons)}</td>
+      </tr>`
+    )
+    .join("\n");
+
+  return `
+    <div class="comparison-table">
+      <h1>${esc(title)}</h1>
+      <table>
+        <thead>
+          <tr>
+            <th>Item</th>
+            <th class="pros">Pros</th>
+            <th class="cons">Cons</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rowsHtml}
+        </tbody>
+      </table>
+    </div>
+    <style>
+      .comparison-table h1 {
+        font-size: 48px;
+        margin-bottom: 40px;
+        color: #1a1a2e;
+      }
+      table {
+        width: 100%;
+        border-collapse: collapse;
+        font-size: 28px;
+      }
+      th, td {
+        padding: 20px 24px;
+        text-align: left;
+        border-bottom: 1px solid #e5e7eb;
+      }
+      th {
+        background: #f8fafc;
+        font-weight: 700;
+        color: #475569;
+        font-size: 24px;
+        text-transform: uppercase;
+        letter-spacing: 1px;
+      }
+      th.pros, td.pros { color: #16a34a; }
+      th.cons, td.cons { color: #dc2626; }
+      td.name { font-weight: 600; color: #1e293b; }
+    </style>
+  `;
+}
+
+function esc(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}

package/src/modules/cards/templates/data-chart.ts

@@ -0,0 +1,76 @@
+// Data chart template — horizontal bar chart
+
+export function render(data: Record<string, unknown>): string {
+  const title = (data.title as string) ?? "";
+  const items = (data.items as Array<{ label: string; value: number }>) ?? [];
+  const maxValue = Math.max(...items.map((i) => i.value), 1);
+
+  const barsHtml = items
+    .map((item) => {
+      const pct = Math.round((item.value / maxValue) * 100);
+      return `
+      <div class="bar-row">
+        <span class="label">${esc(item.label)}</span>
+        <div class="bar-track">
+          <div class="bar-fill" style="width: ${pct}%"></div>
+        </div>
+        <span class="value">${item.value}</span>
+      </div>`;
+    })
+    .join("\n");
+
+  return `
+    <div class="data-chart">
+      <h1>${esc(title)}</h1>
+      ${barsHtml}
+    </div>
+    <style>
+      .data-chart h1 {
+        font-size: 48px;
+        margin-bottom: 40px;
+        color: #1a1a2e;
+      }
+      .bar-row {
+        display: flex;
+        align-items: center;
+        gap: 20px;
+        margin-bottom: 24px;
+      }
+      .label {
+        width: 180px;
+        flex-shrink: 0;
+        font-size: 26px;
+        font-weight: 600;
+        color: #334155;
+        text-align: right;
+      }
+      .bar-track {
+        flex: 1;
+        height: 40px;
+        background: #f1f5f9;
+        border-radius: 8px;
+        overflow: hidden;
+      }
+      .bar-fill {
+        height: 100%;
+        background: #3b82f6;
+        border-radius: 8px;
+        transition: width 0.3s;
+      }
+      .value {
+        width: 80px;
+        font-size: 26px;
+        font-weight: 700;
+        color: #3b82f6;
+      }
+    </style>
+  `;
+}
+
+function esc(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}

package/src/modules/cards/templates/flow-chart.ts

@@ -0,0 +1,49 @@
+// Flow chart template — horizontal steps with arrows
+
+export function render(data: Record<string, unknown>): string {
+  const steps = (data.steps as string[]) ?? [];
+
+  const stepsHtml = steps
+    .map((step, i) => {
+      const arrow = i < steps.length - 1 ? '<span class="arrow">\u2192</span>' : "";
+      return `<span class="step">${esc(step)}</span>${arrow}`;
+    })
+    .join("\n");
+
+  return `
+    <div class="flow-chart">
+      ${stepsHtml}
+    </div>
+    <style>
+      .flow-chart {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        flex-wrap: wrap;
+        gap: 24px;
+      }
+      .step {
+        background: #eff6ff;
+        border: 2px solid #3b82f6;
+        border-radius: 16px;
+        padding: 24px 36px;
+        font-size: 28px;
+        font-weight: 600;
+        color: #1e40af;
+      }
+      .arrow {
+        font-size: 40px;
+        color: #3b82f6;
+        font-weight: 700;
+      }
+    </style>
+  `;
+}
+
+function esc(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}

package/src/modules/cards/templates/key-points.ts

@@ -0,0 +1,59 @@
+// Key points template — numbered list with colored circle numbers
+
+export function render(data: Record<string, unknown>): string {
+  const items = (data.items as string[]) ?? [];
+
+  const itemsHtml = items
+    .map(
+      (item, i) => `
+      <div class="point">
+        <span class="num">${i + 1}</span>
+        <span class="text">${esc(item)}</span>
+      </div>`
+    )
+    .join("\n");
+
+  return `
+    <div class="key-points">
+      ${itemsHtml}
+    </div>
+    <style>
+      .key-points {
+        display: flex;
+        flex-direction: column;
+        gap: 32px;
+      }
+      .point {
+        display: flex;
+        align-items: center;
+        gap: 24px;
+      }
+      .num {
+        flex-shrink: 0;
+        width: 56px;
+        height: 56px;
+        border-radius: 50%;
+        background: #3b82f6;
+        color: #fff;
+        font-size: 28px;
+        font-weight: 700;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+      }
+      .text {
+        font-size: 32px;
+        color: #1e293b;
+        line-height: 1.5;
+      }
+    </style>
+  `;
+}
+
+function esc(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}

package/src/modules/cover/prompt-builder.test.ts

@@ -0,0 +1,157 @@
+import { describe, it, expect } from "vitest";
+import {
+  buildCoverPrompts,
+  extractCoverTitle,
+  type PromptBuilderInput,
+} from "../cover/prompt-builder.js";
+
+describe("extractCoverTitle", () => {
+  it("returns custom title when valid length", () => {
+    expect(extractCoverTitle("很长的原始标题", "短标题")).toBe("短标题");
+  });
+
+  it("ignores custom title that is too short", () => {
+    expect(extractCoverTitle("原始标题", "x")).not.toBe("x");
+  });
+
+  it("ignores custom title that is too long", () => {
+    expect(extractCoverTitle("原始标题", "这个标题超过了八个字符的限制")).not.toBe("这个标题超过了八个字符的限制");
+  });
+
+  it("returns short titles as-is", () => {
+    expect(extractCoverTitle("AI赚钱")).toBe("AI赚钱");
+  });
+
+  it("strips brackets and punctuation", () => {
+    const result = extractCoverTitle("【重磅】发布！");
+    expect(result).not.toContain("【");
+    expect(result).not.toContain("】");
+  });
+
+  it("picks a segment from long titles", () => {
+    const result = extractCoverTitle("如何用AI工具，三天做出一个产品，月入过万");
+    expect(result.length).toBeLessThanOrEqual(8);
+    expect(result.length).toBeGreaterThanOrEqual(2);
+  });
+
+  it("falls back to first 6 chars for unsplittable long titles", () => {
+    const result = extractCoverTitle("这是一个完全没有分隔符的超级长标题内容");
+    expect(result.length).toBeLessThanOrEqual(8);
+  });
+});
+
+describe("buildCoverPrompts", () => {
+  const baseInput: PromptBuilderInput = {
+    title: "AI时代如何用工具赚钱",
+    body: "在这个AI快速发展的时代，普通人也可以利用各种AI工具来创造收入。本文将分享三个实战案例。",
+    platform: "xhs",
+    hasReferencePhotos: false,
+  };
+
+  it("returns exactly 3 prompt sets", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    expect(prompts).toHaveLength(3);
+  });
+
+  it("labels are A, B, C", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    expect(prompts.map((p) => p.label)).toEqual(["A", "B", "C"]);
+  });
+
+  it("styles are cinematic, minimalist, bold-impact", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    expect(prompts.map((p) => p.style)).toEqual(["cinematic", "minimalist", "bold-impact"]);
+  });
+
+  it("all prompts contain the title text", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    for (const p of prompts) {
+      expect(p.imagePrompt).toContain(p.titleText);
+    }
+  });
+
+  it("all prompts specify 3:4 vertical orientation", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    for (const p of prompts) {
+      expect(p.imagePrompt).toContain("3:4");
+      expect(p.imagePrompt).toContain("Vertical");
+    }
+  });
+
+  it("all prompts include prohibition rules", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    for (const p of prompts) {
+      expect(p.imagePrompt).toContain("No watermarks");
+      expect(p.imagePrompt).toContain("photorealistic");
+    }
+  });
+
+  it("titleText is 2-8 chars", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    for (const p of prompts) {
+      expect(p.titleText.length).toBeGreaterThanOrEqual(2);
+      expect(p.titleText.length).toBeLessThanOrEqual(8);
+    }
+  });
+
+  it("includes reference photo instruction when hasReferencePhotos is true", () => {
+    const input: PromptBuilderInput = {
+      ...baseInput,
+      title: "我的创业故事",
+      body: "我从零开始创业的经历",
+      hasReferencePhotos: true,
+    };
+    const prompts = buildCoverPrompts(input);
+    // Person-type subject with reference photos should mention reference
+    const hasRef = prompts.some((p) => p.imagePrompt.includes("reference photo"));
+    expect(hasRef).toBe(true);
+  });
+
+  it("does NOT include reference photo instruction when hasReferencePhotos is false", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    for (const p of prompts) {
+      expect(p.imagePrompt).not.toContain("reference photo");
+    }
+  });
+
+  it("detects person subject type", () => {
+    const input: PromptBuilderInput = {
+      ...baseInput,
+      title: "我如何从零到一",
+      body: "我的个人经历分享",
+      hasReferencePhotos: false,
+    };
+    const prompts = buildCoverPrompts(input);
+    // Person subject should use person layout
+    expect(prompts[0].layoutHint).toContain("person");
+  });
+
+  it("detects event subject type", () => {
+    const input: PromptBuilderInput = {
+      ...baseInput,
+      title: "突发！新政策发布",
+      body: "今天刚刚发布的最新政策",
+      hasReferencePhotos: false,
+    };
+    const prompts = buildCoverPrompts(input);
+    expect(prompts[0].layoutHint).toContain("moment");
+  });
+
+  it("uses custom title when provided", () => {
+    const input: PromptBuilderInput = {
+      ...baseInput,
+      customTitle: "AI赚钱",
+    };
+    const prompts = buildCoverPrompts(input);
+    for (const p of prompts) {
+      expect(p.titleText).toBe("AI赚钱");
+    }
+  });
+
+  it("each style has different prompt content", () => {
+    const prompts = buildCoverPrompts(baseInput);
+    const promptTexts = prompts.map((p) => p.imagePrompt);
+    // All 3 should be different
+    expect(new Set(promptTexts).size).toBe(3);
+  });
+});