@zzclub/pipeline 0.3.0 → 0.4.0

package/src/routes.ts

@@ -0,0 +1,287 @@
+/**
+ * routes.ts — Channel routing table
+ *
+ * Replaces the LLM-based zzhub-media-channel-route skill.
+ * All routing rules are deterministic lookup tables.
+ */
+
+import type {
+  RoutePrimary,
+  ContentForm,
+  AccountVisualParams,
+  Route,
+  Target,
+} from "./state";
+import type { PipelineConfig } from "./config";
+import { loadConfig } from "./config";
+
+// ── Route keyword matching ────────────────────────────────────────
+
+/**
+ * Route keyword patterns.
+ * Each entry maps user-facing keywords to a primary route.
+ */
+const ROUTE_PATTERNS: { keywords: string[]; route: RoutePrimary }[] = [
+  {
+    keywords: [
+      "公众号文章",
+      "公众号草稿箱",
+      "草稿箱",
+      "wechat-article",
+      "微信文章",
+    ],
+    route: "wechat-article",
+  },
+  {
+    keywords: [
+      "小绿书",
+      "newspic",
+      "贴图",
+      "公众号贴图",
+      "wechat-newspic",
+    ],
+    route: "wechat-newspic",
+  },
+];
+
+function isAmbiguousPublicRouteIntent(intentText: string): boolean {
+  const text = intentText.toLowerCase();
+  return (
+    text.includes("公众号") &&
+    !text.includes("文章") &&
+    !text.includes("贴图") &&
+    !text.includes("草稿") &&
+    !text.includes("newspic") &&
+    !text.includes("小绿书")
+  );
+}
+
+/**
+ * Resolve primary route from user intent text.
+ * Returns null if ambiguous (e.g. just "发公众号" without specifying article vs newspic).
+ */
+export function resolveRoute(intentText: string): RoutePrimary | null {
+  const text = intentText.toLowerCase();
+
+  for (const { keywords, route } of ROUTE_PATTERNS) {
+    for (const kw of keywords) {
+      if (text.includes(kw.toLowerCase())) {
+        return route;
+      }
+    }
+  }
+
+  // "发公众号" alone is ambiguous — could be article or newspic
+  if (isAmbiguousPublicRouteIntent(text)) {
+    return null; // Ambiguous
+  }
+
+  return null;
+}
+
+// ── Account resolution ────────────────────────────────────────────
+
+/**
+ * Account keyword patterns.
+ */
+const ACCOUNT_PATTERNS: { keywords: string[]; account: string }[] = [
+  {
+    keywords: ["大号", "早早集市", "default"],
+    account: "default",
+  },
+  {
+    keywords: ["古一", "小号", "ancientone", "storytelling", "story"],
+    account: "ancientone",
+  },
+];
+
+/**
+ * Resolve account from user intent text.
+ * Returns "default" if no explicit account specified.
+ */
+export function resolveAccount(intentText: string): string {
+  const text = intentText.toLowerCase();
+
+  for (const { keywords, account } of ACCOUNT_PATTERNS) {
+    for (const kw of keywords) {
+      if (text.toLowerCase().includes(kw.toLowerCase())) {
+        return account;
+      }
+    }
+  }
+
+  return "default";
+}
+
+// ── Content profile registry ──────────────────────────────────────
+
+/**
+ * Account -> content profile mapping.
+ */
+const CONTENT_PROFILES: Record<string, string> = {
+  default: "user",
+  ancientone: "storytelling",
+};
+
+/**
+ * Get content profile for an account.
+ */
+export function getContentProfile(account: string): string {
+  return CONTENT_PROFILES[account] ?? "none";
+}
+
+// ── Account visual params registry ────────────────────────────────
+
+/**
+ * Account visual parameters for imgx rendering.
+ * Only used by poster-3-4 template (newspic).
+ * wechat-cover-split uses its own color scheme.
+ */
+const VISUAL_PARAMS: Record<string, AccountVisualParams> = {
+  default: {
+    footer: "公众号 · 早早集市",
+    bg: "#e6f5ef",
+    highlight: "#22a854",
+    fallback_icon: "assets/icons/logo.png",
+  },
+  ancientone: {
+    footer: "公众号 · 古一软件",
+    bg: "#faf5f8",
+    highlight: "#ca6093",
+    fallback_icon: "assets/icons/logo.png",
+  },
+};
+
+/**
+ * Get visual params for an account.
+ * If config.imgx.icon is set, it overrides the default fallback_icon.
+ * Returns null if account not found.
+ */
+export function getVisualParams(
+  account: string,
+  config?: PipelineConfig,
+): AccountVisualParams | null {
+  const base = VISUAL_PARAMS[account] ?? null;
+  if (!base) return null;
+  if (config?.imgx?.icon) {
+    return { ...base, fallback_icon: config.imgx.icon };
+  }
+  return base;
+}
+
+// ── Theme registry (for longform-3-4) ─────────────────────────────
+
+const LONGFORM_THEMES: Record<string, string> = {
+  default: "paper-sage",
+  ancientone: "linen-news",
+};
+
+/**
+ * Get longform-3-4 theme for an account.
+ */
+export function getLongformTheme(account: string): string {
+  return LONGFORM_THEMES[account] ?? "paper-sage";
+}
+
+// ── Content-form → route mapping ──────────────────────────────────
+
+/**
+ * Derive primary route from content_form when keyword matching fails.
+ * Returns null for "unknown" — caller should fall back to default.
+ */
+const CONTENT_FORM_ROUTE: Record<ContentForm, RoutePrimary | null> = {
+  article: "wechat-article",
+  newspic: "wechat-newspic",
+  unknown: null,
+};
+
+export function routeFromContentForm(form: ContentForm): RoutePrimary | null {
+  return CONTENT_FORM_ROUTE[form] ?? null;
+}
+
+export function routePlanFromTargets(
+  form: ContentForm,
+  targets: Target[],
+): { primary: RoutePrimary; extras: RoutePrimary[] } | null {
+  const uniqueTargets = [...new Set(targets)];
+  const wantsWechat = uniqueTargets.includes("wechat");
+
+  if (form === "article") {
+    if (wantsWechat) {
+      return {
+        primary: "wechat-article",
+        extras: [],
+      };
+    }
+  }
+
+  if (form === "newspic" && wantsWechat) {
+    return {
+      primary: "wechat-newspic",
+      extras: [],
+    };
+  }
+
+  return null;
+}
+
+// ── Full route resolution ─────────────────────────────────────────
+
+/**
+ * Resolve the complete Route object from intent text and explicit overrides.
+ * highlight_words are NOT set here — they come from prepare-finalize after title is known.
+ *
+ * Fallback chain for primary route:
+ *   1. Explicit --route override
+ *   2. Keyword matching from intent text
+ *   3. content_form from state (article→wechat-article, newspic→wechat-newspic)
+ *   4. Default: "wechat-article"
+ */
+export function resolveFullRoute(
+  intentText: string,
+  overrides?: {
+    primary?: RoutePrimary;
+    extras?: RoutePrimary[];
+    account?: string;
+    contentForm?: ContentForm;
+    targets?: Target[];
+  },
+  config?: PipelineConfig,
+): Route {
+  const resolvedConfig = config ?? loadConfig();
+  const routeFromIntent = resolveRoute(intentText);
+  const routePlan = overrides?.contentForm && overrides?.targets
+    ? routePlanFromTargets(overrides.contentForm, overrides.targets)
+    : null;
+  const routeFromForm = overrides?.contentForm
+    ? routeFromContentForm(overrides.contentForm)
+    : null;
+
+  let primary =
+    overrides?.primary ??
+    routeFromIntent ??
+    routePlan?.primary ??
+    routeFromForm;
+  if (!primary) {
+    if (intentText.trim() && isAmbiguousPublicRouteIntent(intentText)) {
+      throw new Error(
+        "Ambiguous route: user requested 公众号 but did not specify article or newspic",
+      );
+    }
+    throw new Error(
+      "Unable to resolve route from intent or content_form; orchestrator must classify first",
+    );
+  }
+  const account = overrides?.account ?? resolveAccount(intentText);
+  const contentProfile = getContentProfile(account);
+  const visualParams = getVisualParams(account, resolvedConfig);
+
+  return {
+    primary,
+    extras: overrides?.extras ?? routePlan?.extras ?? [],
+    account,
+    content_profile: contentProfile,
+    account_visual_params: visualParams,
+    highlight_words: [], // Set later by prepare-finalize
+  };
+}

package/src/runtime-paths.ts

@@ -0,0 +1,179 @@
+/**
+ * Centralized asset path resolution for dev and compiled modes.
+ *
+ * Dev mode:     running via `bun run src/cli.ts` — assets in source tree
+ * Compiled mode: running a `bun build --compile` binary — assets next to binary
+ *
+ * Override: set ZZHUB_PIPELINE_ROOT env var to force a specific root.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// ── Dev mode: resolve from source tree ──────────────────────────
+
+const _filename = fileURLToPath(import.meta.url);
+const _dirname = dirname(_filename);
+
+// In dev mode, this file is at src/runtime-paths.ts, so PACKAGE_ROOT = ..
+const DEV_PACKAGE_ROOT = resolve(_dirname, "..");
+
+// ── Mode detection ──────────────────────────────────────────────
+
+function getBinaryDir(): string | null {
+  const binPath = process.argv[0];
+  if (!binPath || !existsSync(binPath)) return null;
+  return dirname(binPath);
+}
+
+function isCompiledMode(): boolean {
+  if (process.env.ZZHUB_PIPELINE_ROOT) return false;
+  const binDir = getBinaryDir();
+  if (!binDir) return false;
+  // In compiled mode, the binary is standalone — check for assets/ sibling
+  return existsSync(join(binDir, "assets")) && !existsSync(join(binDir, "cli.js"));
+}
+
+// ── Root resolution ─────────────────────────────────────────────
+
+function resolveRoot(): string {
+  const envOverride = process.env.ZZHUB_PIPELINE_ROOT;
+  if (envOverride && envOverride.trim()) {
+    return resolve(envOverride.trim());
+  }
+
+  if (isCompiledMode()) {
+    return getBinaryDir()!;
+  }
+
+  return DEV_PACKAGE_ROOT;
+}
+
+const _root = resolveRoot();
+const _isDistMode = isCompiledMode();
+
+// ── Path exports ────────────────────────────────────────────────
+
+/** Project root (source tree in dev, binary dir in compiled) */
+export const PACKAGE_ROOT = _root;
+
+/** imgx module directory */
+export const IMGX_DIR = join(_root, _isDistMode ? "assets/imgx" : "src/imgx");
+
+/** imgx assets directory */
+export const ASSETS_DIR = join(IMGX_DIR, "assets");
+
+/** imgx templates directory */
+export const TEMPLATES_DIR = join(ASSETS_DIR, "templates");
+
+/** imgx icons directory */
+export const ICONS_DIR = join(ASSETS_DIR, "icons");
+
+/** imgx styles directory */
+export const STYLES_DIR = join(ASSETS_DIR, "styles");
+
+/** wechat-preview module directory */
+export const WECHAT_PREVIEW_DIR = join(_root, _isDistMode ? "assets/wechat-preview" : "src/wechat-preview");
+
+/** wechat-preview template */
+export const TEMPLATE_PATH = join(WECHAT_PREVIEW_DIR, "assets/templates/export-shell.html");
+
+/** wechat-preview browser-dist directory */
+export const DIST_DIR = join(WECHAT_PREVIEW_DIR, "assets/browser-dist");
+
+/** wechat-preview Vite manifest */
+export const MANIFEST_PATH = join(DIST_DIR, ".vite/manifest.json");
+
+/** Vite config path (dev only) */
+export const VITE_CONFIG_PATH = join(PACKAGE_ROOT, "vite.wechat-preview.config.ts");
+
+/** @chenglou/pretext layout.js path */
+export const PRETEXT_MODULE_PATH = join(PACKAGE_ROOT, "node_modules/@chenglou/pretext/dist/layout.js");
+
+/** Helper: read a UTF-8 file */
+export function readUtf8(path: string): string {
+  return readFileSync(path, "utf8");
+}
+
+// ── Font cache ──────────────────────────────────────────────────
+
+const FONT_FILES = [
+  "AlimamaShuHeiTi-Bold.ttf",
+  "LXGWNeoZhiSongPlus.ttf",
+  "LXGWWenKai-Regular.ttf",
+];
+
+function getFontCacheDir(): string {
+  const platform = process.platform;
+  if (platform === "win32") {
+    const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+    return join(appData, "zzhub-pipeline", "fonts");
+  }
+  const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+  return join(base, "zzhub-pipeline", "fonts");
+}
+
+function resolveFontsDir(): string {
+  // Fonts in assets/ (dev/compiled mode) or cache
+  const assetsFonts = join(ASSETS_DIR, "fonts");
+  if (existsSync(join(assetsFonts, "AlimamaShuHeiTi-Bold.ttf"))) {
+    return assetsFonts;
+  }
+  const cacheDir = getFontCacheDir();
+  if (existsSync(join(cacheDir, "AlimamaShuHeiTi-Bold.ttf"))) {
+    return cacheDir;
+  }
+  return cacheDir;
+}
+
+/** imgx fonts directory (assets or cache) */
+export const FONTS_DIR = resolveFontsDir();
+
+/**
+ * Ensure CJK fonts are available locally.
+ * Fonts are in assets/ by default; downloads from CDN if not present and env is set.
+ *
+ * @returns The fonts directory path
+ */
+export async function ensureFonts(): Promise<string> {
+  const dir = FONTS_DIR;
+  const allExist = FONT_FILES.every((f) => existsSync(join(dir, f)));
+  if (allExist) return dir;
+
+  const cdnBase = process.env.ZZHUB_FONT_CDN_BASE_URL;
+  if (!cdnBase) {
+    throw new Error(
+      [
+        "CJK fonts not found and ZZHUB_FONT_CDN_BASE_URL is not set.",
+        "",
+        `Fonts directory: ${dir}`,
+        "",
+        "To fix, either:",
+        "  1. Set ZZHUB_FONT_CDN_BASE_URL to download fonts automatically,",
+        `  2. Manually place these files in ${dir}:`,
+        ...FONT_FILES.map((f) => `     - ${f}`),
+      ].join("\n"),
+    );
+  }
+
+  mkdirSync(dir, { recursive: true });
+
+  for (const file of FONT_FILES) {
+    const dest = join(dir, file);
+    if (existsSync(dest)) continue;
+
+    const url = `${cdnBase.replace(/\/$/, "")}/${file}`;
+    console.error(`[zzhub-pipeline] Downloading ${file}...`);
+    const resp = await fetch(url);
+    if (!resp.ok) {
+      throw new Error(`Failed to download ${url}: HTTP ${resp.status}`);
+    }
+    const buf = Buffer.from(await resp.arrayBuffer());
+    writeFileSync(dest, buf);
+    console.error(`[zzhub-pipeline] Saved ${file} (${(buf.length / 1024 / 1024).toFixed(1)}MB)`);
+  }
+
+  return dir;
+}

package/src/schema/config.ts

@@ -0,0 +1,133 @@
+/**
+ * Zod schemas for PipelineConfig.
+ *
+ * Replaces hand-written interfaces + normalize functions + default values.
+ */
+
+import { z } from "zod";
+
+// ── Helpers ───────────────────────────────────────────────────────
+
+const trimmedNonEmptyString = (fallback: string) =>
+  z.preprocess(
+    (val) => (typeof val === "string" && val.trim().length > 0 ? val.trim() : undefined),
+    z.string().default(fallback),
+  );
+
+const nullableTrimmedString = z.preprocess(
+  (val) => {
+    if (typeof val === "string") {
+      const trimmed = val.trim();
+      return trimmed.length > 0 ? trimmed : null;
+    }
+    return val;
+  },
+  z.string().nullable().default(null),
+);
+
+function withObjectDefault<T extends z.ZodObject<any>>(schema: T) {
+  // All fields in the schema have defaults, so parse({}) always succeeds.
+  return schema.optional().default(() => schema.parse({}) as any);
+}
+
+// ── Sub-schemas ───────────────────────────────────────────────────
+
+const WxAccountConfigSchema = z.object({
+  pat: z.string().default(""),
+  appId: z.string().default(""),
+  appSecret: z.string().default(""),
+  customCss: z.string().nullable().default(null),
+});
+
+const WxConfigSchema = withObjectDefault(
+  z.object({
+    baseUrl: trimmedNonEmptyString(""),
+    timeout: z.preprocess(
+      (val) => {
+        if (typeof val === "number" && Number.isFinite(val) && val > 0) return val;
+        return undefined;
+      },
+      z.number().default(30000),
+    ),
+    defaultAccount: trimmedNonEmptyString("default"),
+    accounts: z
+      .record(z.string(), WxAccountConfigSchema)
+      .default({ default: { pat: "", appId: "", appSecret: "", customCss: null } }),
+  }),
+);
+
+const PipelinePathConfigSchema = withObjectDefault(
+  z.object({
+    workspaceRoot: nullableTrimmedString,
+    postsDirName: trimmedNonEmptyString("posts"),
+    postsPathPattern: trimmedNonEmptyString("{date}-{slug}"),
+    blogRoot: nullableTrimmedString,
+    zotepadExportHtml: nullableTrimmedString,
+  }),
+);
+
+const PipelineServiceConfigSchema = withObjectDefault(
+  z.object({
+    zotepadBaseUrl: trimmedNonEmptyString("http://127.0.0.1:54577"),
+    zotepadToken: z.string().default(""),
+  }),
+);
+
+const PipelineCommandConfigSchema = withObjectDefault(
+  z.object({
+    blogPublish: z
+      .array(z.string())
+      .default(["pnpm", "publish:post"])
+      .pipe(z.array(z.string()).min(1)),
+  }),
+);
+
+const CosConfigSchema = withObjectDefault(
+  z.object({
+    pat: z.string().default(""),
+    baseUrl: nullableTrimmedString,
+    publicBaseUrl: trimmedNonEmptyString(""),
+  }),
+);
+
+const PluginsConfigSchema = withObjectDefault(
+  z.object({
+    imageRenderer: z.string().nullable().default(null),
+    markdownRenderer: z.string().nullable().default(null),
+  }),
+);
+
+const ImgxConfigSchema = withObjectDefault(
+  z.object({
+    icon: z.string().nullable().default(null),
+  }),
+);
+
+// ── Top-level schema ──────────────────────────────────────────────
+
+export const PipelineConfigSchema = z.object({
+  paths: PipelinePathConfigSchema,
+  services: PipelineServiceConfigSchema,
+  commands: PipelineCommandConfigSchema,
+  wx: WxConfigSchema,
+  cos: CosConfigSchema,
+  plugins: PluginsConfigSchema,
+  imgx: ImgxConfigSchema,
+});
+
+export type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
+
+// ── Sub-type exports ──────────────────────────────────────────────
+
+export type WxAccountConfig = z.infer<typeof WxAccountConfigSchema>;
+export type WxConfig = z.infer<typeof WxConfigSchema>;
+export type PipelinePathConfig = z.infer<typeof PipelinePathConfigSchema>;
+export type PipelineServiceConfig = z.infer<typeof PipelineServiceConfigSchema>;
+export type PipelineCommandConfig = z.infer<typeof PipelineCommandConfigSchema>;
+export type CosConfig = z.infer<typeof CosConfigSchema>;
+export type PluginsConfig = z.infer<typeof PluginsConfigSchema>;
+export type ImgxConfig = z.infer<typeof ImgxConfigSchema>;
+
+// ── Schema instances for reuse ────────────────────────────────────
+
+export { WxAccountConfigSchema, WxConfigSchema, PipelinePathConfigSchema };