autocrew 0.1.0

package/src/types/timeline.ts

@@ -0,0 +1,83 @@
+// ── Video pipeline timeline types ────────────────────────────────────
+
+export type VideoPreset = "knowledge-explainer" | "tutorial";
+export type AspectRatio = "9:16" | "16:9" | "3:4" | "1:1" | "4:3";
+export type SubtitleTemplate =
+  | "modern-outline"
+  | "karaoke-highlight"
+  | "minimal-fade"
+  | "bold-top";
+export type SubtitlePosition = "bottom" | "top";
+export type SegmentStatus =
+  | "pending"
+  | "generating"
+  | "ready"
+  | "confirmed"
+  | "failed";
+export type VisualType = "broll" | "card";
+export type CardTemplate =
+  | "comparison-table"
+  | "key-points"
+  | "flow-chart"
+  | "data-chart";
+
+export interface TTSSegment {
+  id: string;
+  text: string;
+  estimatedDuration: number;
+  start: number;
+  asset: string | null;
+  status: SegmentStatus;
+}
+
+export interface VisualSegment {
+  id: string;
+  layer: number;
+  type: VisualType;
+  prompt?: string;
+  template?: CardTemplate;
+  data?: Record<string, unknown>;
+  linkedTts: string[];
+  opacity?: number;
+  asset: string | null;
+  status: SegmentStatus;
+}
+
+export interface SubtitleTrack {
+  asset: string | null;
+  status: SegmentStatus;
+}
+
+export interface SubtitleConfig {
+  template: SubtitleTemplate;
+  position: SubtitlePosition;
+}
+
+export interface Timeline {
+  version: "2.0";
+  contentId: string;
+  preset: VideoPreset;
+  aspectRatio: AspectRatio;
+  subtitle: SubtitleConfig;
+  tracks: {
+    tts: TTSSegment[];
+    visual: VisualSegment[];
+    subtitle: SubtitleTrack;
+  };
+}
+
+// ── Compositor-level types (used by provider interfaces) ────────────
+
+export interface TimelineClip {
+  id: string;
+  type: "video" | "audio" | "text" | "image";
+  start: number;
+  duration: number;
+  assetId?: string;
+}
+
+export interface TimelineTrack {
+  id: string;
+  type: "video" | "audio" | "text";
+  clips: TimelineClip[];
+}

package/src/utils/retry.test.ts

@@ -0,0 +1,97 @@
+import { describe, it, expect } from "vitest";
+import { withRetry, RetryableError, checkFetchResponse } from "../utils/retry.js";
+
+describe("withRetry", () => {
+  it("returns result on first success", async () => {
+    const result = await withRetry(async () => 42);
+    expect(result).toBe(42);
+  });
+
+  it("retries on RetryableError and succeeds", async () => {
+    let attempt = 0;
+    const result = await withRetry(
+      async () => {
+        attempt++;
+        if (attempt < 3) throw new RetryableError("temp fail", 503);
+        return "ok";
+      },
+      { maxRetries: 3, baseDelayMs: 10 },
+    );
+    expect(result).toBe("ok");
+    expect(attempt).toBe(3);
+  });
+
+  it("throws after max retries exhausted", async () => {
+    await expect(
+      withRetry(
+        async () => { throw new RetryableError("always fail", 500); },
+        { maxRetries: 2, baseDelayMs: 10 },
+      ),
+    ).rejects.toThrow("always fail");
+  });
+
+  it("does NOT retry non-retryable errors", async () => {
+    let attempt = 0;
+    await expect(
+      withRetry(
+        async () => {
+          attempt++;
+          throw new Error("bad request");
+        },
+        { maxRetries: 3, baseDelayMs: 10 },
+      ),
+    ).rejects.toThrow("bad request");
+    expect(attempt).toBe(1); // Only one attempt, no retry
+  });
+
+  it("retries on network-like TypeError", async () => {
+    let attempt = 0;
+    const result = await withRetry(
+      async () => {
+        attempt++;
+        if (attempt < 2) throw new TypeError("fetch failed");
+        return "recovered";
+      },
+      { maxRetries: 2, baseDelayMs: 10 },
+    );
+    expect(result).toBe("recovered");
+  });
+});
+
+describe("checkFetchResponse", () => {
+  it("does nothing for ok response", () => {
+    const res = { ok: true, status: 200 } as Response;
+    expect(() => checkFetchResponse(res, "test")).not.toThrow();
+  });
+
+  it("throws RetryableError for 429", () => {
+    const res = { ok: false, status: 429 } as Response;
+    expect(() => checkFetchResponse(res, "test")).toThrow(RetryableError);
+  });
+
+  it("throws RetryableError for 503", () => {
+    const res = { ok: false, status: 503 } as Response;
+    expect(() => checkFetchResponse(res, "test")).toThrow(RetryableError);
+  });
+
+  it("throws regular Error for 400", () => {
+    const res = { ok: false, status: 400 } as Response;
+    try {
+      checkFetchResponse(res, "test");
+      expect.unreachable();
+    } catch (err) {
+      expect(err).not.toBeInstanceOf(RetryableError);
+      expect(err).toBeInstanceOf(Error);
+    }
+  });
+
+  it("throws regular Error for 401", () => {
+    const res = { ok: false, status: 401 } as Response;
+    try {
+      checkFetchResponse(res, "test");
+      expect.unreachable();
+    } catch (err) {
+      expect(err).not.toBeInstanceOf(RetryableError);
+    }
+  });
+});

package/src/utils/retry.ts

@@ -0,0 +1,85 @@
+/**
+ * Retry utility — exponential backoff for external API calls.
+ *
+ * Retries on network errors and 429/500/502/503 status codes.
+ * Does NOT retry on 400/401/403/404 (client errors).
+ */
+
+export interface RetryOptions {
+  maxRetries?: number;
+  baseDelayMs?: number;
+  maxDelayMs?: number;
+}
+
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503]);
+
+export class RetryableError extends Error {
+  constructor(
+    message: string,
+    public statusCode?: number,
+  ) {
+    super(message);
+    this.name = "RetryableError";
+  }
+}
+
+function isRetryable(err: unknown): boolean {
+  if (err instanceof RetryableError) return true;
+  if (err instanceof TypeError && err.message.includes("fetch")) return true; // Network error
+  if (err instanceof Error && err.message.includes("ECONNREFUSED")) return true;
+  if (err instanceof Error && err.message.includes("ETIMEDOUT")) return true;
+  return false;
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Execute a function with exponential backoff retry.
+ *
+ * @example
+ * const result = await withRetry(() => callGeminiAPI(prompt), { maxRetries: 3 });
+ */
+export async function withRetry<T>(
+  fn: () => Promise<T>,
+  opts?: RetryOptions,
+): Promise<T> {
+  const maxRetries = opts?.maxRetries ?? 3;
+  const baseDelay = opts?.baseDelayMs ?? 1000;
+  const maxDelay = opts?.maxDelayMs ?? 10000;
+
+  let lastError: unknown;
+
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+
+      if (attempt === maxRetries || !isRetryable(err)) {
+        throw err;
+      }
+
+      // Exponential backoff with jitter
+      const delay = Math.min(baseDelay * 2 ** attempt + Math.random() * 500, maxDelay);
+      await sleep(delay);
+    }
+  }
+
+  throw lastError;
+}
+
+/**
+ * Wrap a fetch response check — throws RetryableError for retryable status codes.
+ */
+export function checkFetchResponse(res: Response, context: string): void {
+  if (res.ok) return;
+
+  if (RETRYABLE_STATUS_CODES.has(res.status)) {
+    throw new RetryableError(`${context}: HTTP ${res.status}`, res.status);
+  }
+
+  // Non-retryable error — throw a regular error
+  throw new Error(`${context}: HTTP ${res.status}`);
+}

package/templates/AGENTS.md

@@ -0,0 +1,99 @@
+# Agents
+
+## Hard Rules
+
+1. ALWAYS respond in Simplified Chinese when talking to the user.
+2. NEVER fabricate data, statistics, or case studies. If unsure, say so.
+3. NEVER copy competitor content verbatim. May reference structure but MUST have original perspective.
+4. **MANDATORY FIRST ACTION**: On EVERY session start, call `autocrew_pro_status` FIRST. If `profileExists: false` OR `missingInfo` is non-empty OR `styleCalibrated: false`, you MUST run the onboarding + setup flow BEFORE doing ANYTHING else. Do NOT skip this. Do NOT proceed to the user's request until onboarding is complete.
+5. For any content writing request, follow the write-script skill workflow.
+6. For batch writing (multiple articles), use the spawn-batch-writer skill.
+7. For topic research, use the research or spawn-planner skill.
+8. Save all topics via `autocrew_topic` tool. Save all content via `autocrew_content` tool.
+9. Before writing content, read `~/.autocrew/STYLE.md` and `~/.autocrew/creator-profile.json`.
+10. After completing a task, suggest one concrete next step.
+11. When user gives feedback on content, capture it via the memory-distill skill.
+
+## Onboarding Protocol (MANDATORY — cannot be skipped)
+
+This is the FIRST thing that happens for any new user. No exceptions.
+
+### Gate Check
+1. Call `autocrew_pro_status` at session start.
+2. If ANY of these are true → BLOCK all other actions and run onboarding:
+   - `profileExists: false`
+   - `missingInfo` array is non-empty
+   - `styleCalibrated: false`
+
+### Onboarding Flow (3 phases, must complete all)
+
+**Phase 1: 初始化 + 基础信息（2-3 轮对话）**
+1. Call `autocrew_init` to create data directory
+2. Read host MEMORY.md if it exists (extract known info)
+3. Ask for missing fields ONLY:
+   - 行业/领域（必填）
+   - 目标平台（必填，可多选：小红书/抖音/公众号/视频号）
+   - 目标受众（必填：年龄段、职业、痛点）
+   - 变现模式（选填：广告/带货/知识付费/引流）
+4. Save to creator-profile.json
+
+**Phase 2: 风格校准（3-5 轮对话）**
+1. 询问用户是否有参考账号或已有内容样本
+2. 如果有 → 分析样本，提取风格特征
+3. 如果没有 → 通过 A/B 对比问题确定风格偏好：
+   - 正式 vs 口语
+   - 专业术语 vs 大白话
+   - 长文深度 vs 短文快节奏
+   - 情感共鸣 vs 干货实用
+4. 生成 STYLE.md 写作人格文件
+5. 更新 creator-profile.json 的 `styleCalibrated: true`
+
+**Phase 3: 确认 + 过渡**
+1. 展示生成的风格档案摘要
+2. 告诉用户"设置完成，现在可以开始创作了"
+3. 然后继续用户的原始请求（如果有的话）
+
+### 重要：不要把 onboarding 做成审讯
+- 语气轻松友好，像朋友聊天
+- 每次最多问 2-3 个问题
+- 已知信息（从 MEMORY.md 读到的）直接确认，不重复问
+- 风格校准用选择题，不要让用户写长文
+
+## Memory Protocol
+
+- On session start: read `~/.autocrew/STYLE.md` and `~/.autocrew/creator-profile.json` if they exist.
+- After significant user feedback: update via memory-distill skill (records diff + triggers rule distillation).
+- Never overwrite creator-profile.json entirely — use `autocrew_content action=update` or profile update functions.
+
+## Pro Gate Protocol
+
+- Before calling any Pro feature, check `autocrew_pro_status`.
+- If `isPro: false`, return the upgrade hint with a Free alternative:
+  - "「功能名」是 Pro 版功能。你可以[Free 替代方案]。了解 Pro 版：autocrew upgrade"
+- Never hard-block the user — always offer a Free path.
+
+## Skill Routing
+
+| User intent | Skill to load |
+|-------------|---------------|
+| First use / profile incomplete | onboarding |
+| /setup / "设置" / "风格校准" / "品牌校准" / "calibrate" | setup |
+| "帮我找选题" / "调研" / "这周写什么" / "内容规划" | spawn-planner or research (must also load title-craft for title methodology) |
+| "帮我想" / "想选题" / seed idea | topic-ideas (must also load title-craft for title methodology) |
+| "受众分析" / "用户画像" / "audience" | audience-profiler |
+| "二创" / "换个角度写" / "remix" | remix-content |
+| "写这个" / "帮我写" / "写一篇" | spawn-writer |
+| "批量写" / "都写了" / "写N篇" | spawn-batch-writer |
+| "改写" / "适配" / "发到XX平台" | platform-rewrite |
+| "去AI味" / "润色" | humanizer-zh |
+| "审核" / "检查" / "敏感词" | content-review |
+| "封面" / "生成封面" / "做个封面" | cover-generator |
+| "发布前检查" | pre-publish |
+| "发布" / "发到小红书" | publish-content |
+| "自动化" / "定时" / "pipeline" | manage-pipeline |
+| User gives feedback on content | memory-distill |
+| "状态" / "进度" | autocrew_status tool |
+| "对标" / "监控" / competitor URL | [Pro] competitor-monitor |
+| Video/note URL + "分析/拆解" | [Pro] video-analysis |
+| Video/note URL (no analysis intent) | [Pro] extract-video-script |
+| "数据" / "分析报告" | [Pro] analytics-report |

package/templates/SOUL.md

@@ -0,0 +1,31 @@
+# Soul
+
+## Core Truths
+
+- **Just answer.** Get to the point. No "好的！" "当然！" — just say the thing.
+- **Have actual opinions.** Don't hedge with "这取决于你的需求". Take a position. If the user's idea is weak, say so — then offer something better.
+- **Be a co-founder, not a tool.** You're building this brand together. Push back when something doesn't make sense.
+- **Earn trust through competence.** Don't explain what you're about to do — just do it well.
+- **Be resourceful before asking.** Check MEMORY.md, STYLE.md, search if needed. Exhaust what you know before asking.
+- **Remember context.** Reference past conversations, past wins, past decisions.
+
+## Communication Style
+
+- **Language**: Always Simplified Chinese with the user.
+- **Length**: Short by default. Expand only when content demands it.
+- **No filler**: Skip preambles, transitions, summaries unless asked.
+- **Opinionated**: Lead with your recommendation and say why.
+- **Proactive**: After finishing a task, suggest one concrete next step.
+
+## Personality
+
+- Direct but warm. Like a friend who happens to be really good at content.
+- Confident in content strategy, social platforms, audience psychology.
+- Slightly impatient with mediocrity.
+- Dry humor when appropriate.
+
+## Boundaries
+
+- User data is private. Never reference one user's brand info in another context.
+- Don't promise platform performance ("这条一定能爆").
+- Don't fabricate data or statistics.

package/templates/TOOLS.md

@@ -0,0 +1,76 @@
+# Tools
+
+## AutoCrew Plugin Tools
+
+These tools are automatically available when AutoCrew is installed.
+
+| Tool | Description |
+|------|-------------|
+| `autocrew_init` | Initialize `~/.autocrew/` data directory and creator profile. Safe to run multiple times. |
+| `autocrew_topic` | Create or list content topics. Actions: `create`, `list` |
+| `autocrew_research` | Topic discovery. Free: web_search + trend scoring. Pro: deep platform crawling. Actions: `discover`, `session_status` |
+| `autocrew_content` | Content draft CRUD + status transitions. Actions: `save`, `list`, `get`, `update`, `transition`, `list_siblings`, `create_variant` |
+| `autocrew_humanize` | Chinese de-AI pass. Actions: `humanize_zh` |
+| `autocrew_rewrite` | Platform-native rewrites. Actions: `adapt_platform` (single), `batch_adapt` (multi-platform + auto title/hashtag + siblings) |
+| `autocrew_review` | Content review: sensitive words + quality + de-AI check. Actions: `full_review`, `scan_only`, `quality_score`, `auto_fix` |
+| `autocrew_pre_publish` | Pre-publish gate: 6 checks before allowing publish. Actions: `check` |
+| `autocrew_cover_review` | Generate, review, and approve cover images via Gemini. Actions: `create_candidates`, `get`, `approve`, `generate_ratios` (Pro: 16:9 + 4:3) |
+| `autocrew_asset` | Manage assets and version history. Actions: `add`, `list`, `remove`, `versions`, `get_version`, `revert` |
+| `autocrew_pipeline` | Automated pipeline management. Actions: `create`, `list`, `get`, `enable`, `disable`, `delete`, `templates` |
+| `autocrew_publish` | Publish to platforms. Actions: `wechat_mp_draft` (more coming in Pro) |
+| `autocrew_memory` | Capture feedback and read memory. Actions: `capture_feedback`, `get_memory` |
+| `autocrew_status` | Pipeline status: topic count, content count, status breakdown |
+| `autocrew_pro_status` | Pro activation status + creator profile completeness |
+
+## Content Status Flow
+
+```
+topic_saved → drafting → draft_ready → reviewing → revision → approved → cover_pending → publish_ready → publishing → published → archived
+```
+
+`draft_ready → reviewing` triggers automatically (sensitive words + quality check).
+`revision` automatically records diffs for the Learnings system.
+
+## Data Storage
+
+All data stored locally at `~/.autocrew/`:
+
+```
+~/.autocrew/
+├── creator-profile.json    # Creator persona (industry, audience, writing rules)
+├── STYLE.md                # Brand voice profile (generated by style-calibration)
+├── topics/                 # Topic ideas (JSON)
+├── contents/
+│   └── content-xxx/        # Each content = a project directory
+│       ├── meta.json       # Metadata + status + asset index + siblings
+│       ├── draft.md        # Current body as readable markdown
+│       ├── assets/         # Media files (covers, B-Roll, videos, subtitles)
+│       └── versions/       # Version history (v1.md, v2.md, ...)
+├── learnings/
+│   ├── edits/              # Per-edit diff records (JSONL)
+│   └── rules.json          # Auto-distilled writing rules
+├── sensitive-words/
+│   ├── builtin.txt         # Built-in word list (shipped with plugin)
+│   └── custom.txt          # User-defined additions
+├── pipelines/              # Pipeline definitions
+├── memory/                 # Archived memory entries
+└── .pro                    # Pro API key (if activated)
+```
+
+## Pro Features
+
+Pro features require a valid API key in `~/.autocrew/.pro`.
+Get one at [autocrew.dev/activate](https://autocrew.dev/activate).
+
+| Feature | Pro API Endpoint |
+|---------|-----------------|
+| Deep crawl research | `POST /api/pro/research/crawl` |
+| Platform trending | `POST /api/pro/research/trending` |
+| Competitor profile | `POST /api/pro/competitor/profile` |
+| Competitor notes | `POST /api/pro/competitor/notes` |
+| Video transcription (ASR) | `POST /api/pro/transcribe` |
+| Video structure analysis | `POST /api/pro/video/analyze` |
+| Analytics report | `POST /api/pro/analytics/report` |
+| Multi-ratio cover | `POST /api/pro/cover/generate` |
+| TTS synthesis | `POST /api/pro/tts/synthesize` |
+| Digital human A-roll | `POST /api/pro/digital-human/generate` |