hd-garden 0.3.0

package/bin/garden.mjs

@@ -0,0 +1,348 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { gardenPackageRoot, gardenSiteRoot } from "../scripts/garden-paths.mjs";
+
+const siteRoot = gardenSiteRoot();
+const args = process.argv.slice(2);
+const command = args[0] ?? "help";
+const rest = args.slice(1);
+
+function siteEnv(extra = {}) {
+  return {
+    ...process.env,
+    ...extra,
+    GARDEN_SITE: siteRoot,
+    WRANGLER_LOG_PATH:
+      process.env.WRANGLER_LOG_PATH ?? path.join(siteRoot, ".wrangler", "wrangler.log"),
+  };
+}
+
+function fail(message) {
+  process.stderr.write(`${message}\n`);
+  process.exit(1);
+}
+
+function runNode(script, scriptArgs = [], { cwd = siteRoot, env } = {}) {
+  const result = spawnSync(process.execPath, [path.join(gardenPackageRoot, script), ...scriptArgs], {
+    cwd,
+    env: env ?? siteEnv(),
+    stdio: "inherit",
+  });
+  if (result.status) process.exit(result.status ?? 1);
+}
+
+function resolveVinext() {
+  const require = createRequire(path.join(gardenPackageRoot, "package.json"));
+  try {
+    const vinextRoot = path.dirname(require.resolve("vinext/package.json"));
+    const manifest = JSON.parse(fs.readFileSync(path.join(vinextRoot, "package.json"), "utf8"));
+    const bin = typeof manifest.bin === "string" ? manifest.bin : manifest.bin.vinext;
+    return path.join(vinextRoot, bin);
+  } catch {
+    for (const candidate of [
+      path.join(siteRoot, "node_modules", "vinext", "dist", "cli.js"),
+      path.join(gardenPackageRoot, "node_modules", "vinext", "dist", "cli.js"),
+    ]) {
+      if (fs.existsSync(candidate)) return candidate;
+    }
+    fail("找不到 vinext。请在站点目录运行 npm install。");
+  }
+}
+
+function samePath(left, right) {
+  return path.resolve(left) === path.resolve(right);
+}
+
+function isPackageSite() {
+  return samePath(siteRoot, gardenPackageRoot);
+}
+
+function ensureLink(from, to) {
+  fs.mkdirSync(path.dirname(to), { recursive: true });
+  try {
+    const stat = fs.lstatSync(to);
+    if (stat.isSymbolicLink() && fs.readlinkSync(to) === from) return;
+    if (stat.isSymbolicLink()) fs.unlinkSync(to);
+    else return;
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  fs.symlinkSync(from, to);
+}
+
+function ensurePublic() {
+  const dest = path.join(siteRoot, "public");
+  fs.mkdirSync(dest, { recursive: true });
+  for (const name of ["favicon.svg", "og.png"]) {
+    const from = path.join(gardenPackageRoot, "public", name);
+    const to = path.join(dest, name);
+    if (fs.existsSync(from) && !fs.existsSync(to)) fs.copyFileSync(from, to);
+  }
+  const imagesFrom = path.join(gardenPackageRoot, "public", "images");
+  const imagesTo = path.join(dest, "images");
+  if (fs.existsSync(imagesFrom) && !fs.existsSync(imagesTo)) {
+    fs.cpSync(imagesFrom, imagesTo, { recursive: true });
+  }
+}
+
+function ensureEnv() {
+  const example = path.join(gardenPackageRoot, ".env.example");
+  const local = path.join(siteRoot, ".env.local");
+  if (!fs.existsSync(local) && fs.existsSync(example)) {
+    fs.copyFileSync(example, local);
+  }
+}
+
+function resolveNodeModules() {
+  const siteModules = path.join(siteRoot, "node_modules");
+  const packageModules = path.join(gardenPackageRoot, "node_modules");
+  if (fs.existsSync(path.join(siteModules, "vinext"))) return siteModules;
+  if (fs.existsSync(path.join(packageModules, "vinext"))) return packageModules;
+  return siteModules;
+}
+
+function vinextRoot() {
+  if (isPackageSite()) return gardenPackageRoot;
+
+  const runtime = path.join(siteRoot, ".garden", "runtime");
+  fs.mkdirSync(runtime, { recursive: true });
+
+  const links = [
+    ["app", path.join(gardenPackageRoot, "app")],
+    ["build", path.join(gardenPackageRoot, "build")],
+    ["worker", path.join(gardenPackageRoot, "worker")],
+    [".openai", path.join(gardenPackageRoot, ".openai")],
+    ["vite.config.ts", path.join(gardenPackageRoot, "vite.config.ts")],
+    ["next.config.ts", path.join(gardenPackageRoot, "next.config.ts")],
+    ["postcss.config.mjs", path.join(gardenPackageRoot, "postcss.config.mjs")],
+    ["tsconfig.json", path.join(gardenPackageRoot, "tsconfig.json")],
+    ["package.json", path.join(gardenPackageRoot, "package.json")],
+    ["node_modules", resolveNodeModules()],
+    ["public", path.join(siteRoot, "public")],
+    ["content", path.join(siteRoot, "content")],
+    ["site.config.yaml", path.join(siteRoot, "site.config.yaml")],
+  ];
+
+  for (const name of [".env", ".env.local"]) {
+    const from = path.join(siteRoot, name);
+    if (fs.existsSync(from)) links.push([name, from]);
+  }
+
+  for (const [name, from] of links) {
+    if (fs.existsSync(from) || name === "public" || name === "content") {
+      if ((name === "public" || name === "content") && !fs.existsSync(from)) {
+        fs.mkdirSync(from, { recursive: true });
+      }
+      ensureLink(from, path.join(runtime, name));
+    }
+  }
+
+  return runtime;
+}
+
+function publishDist(fromRoot) {
+  const from = path.join(fromRoot, "dist");
+  const to = path.join(siteRoot, "dist");
+  if (!fs.existsSync(from) || samePath(from, to)) return;
+  fs.rmSync(to, { recursive: true, force: true });
+  fs.cpSync(from, to, { recursive: true });
+}
+
+function copyIfMissing(from, to) {
+  if (fs.existsSync(to) || !fs.existsSync(from)) return false;
+  fs.mkdirSync(path.dirname(to), { recursive: true });
+  fs.cpSync(from, to, { recursive: true });
+  return true;
+}
+
+function ensureSiteKit(destinationRoot = siteRoot) {
+  if (samePath(destinationRoot, gardenPackageRoot)) return;
+
+  const added = [];
+  if (
+    copyIfMissing(
+      path.join(gardenPackageRoot, "templates", "site", "Makefile"),
+      path.join(destinationRoot, "Makefile"),
+    )
+  ) {
+    added.push("Makefile");
+  }
+  if (
+    copyIfMissing(
+      path.join(gardenPackageRoot, "scripts", "new-post.mjs"),
+      path.join(destinationRoot, "scripts", "new-post.mjs"),
+    )
+  ) {
+    added.push("scripts/new-post.mjs");
+  }
+  if (added.length) {
+    process.stdout.write(`已补齐站点文件：${added.join("、")}\n`);
+  }
+
+  const skillFile = path.join(
+    destinationRoot,
+    ".agents",
+    "skills",
+    "garden-interactive-chart",
+    "SKILL.md",
+  );
+  if (!fs.existsSync(skillFile)) installSkill(destinationRoot);
+}
+
+function prepare() {
+  ensureEnv();
+  ensurePublic();
+  fs.mkdirSync(path.join(siteRoot, "content", "posts"), { recursive: true });
+  fs.mkdirSync(path.join(siteRoot, "content", "thoughts"), { recursive: true });
+  ensureSiteKit();
+}
+
+function sync() {
+  if (!fs.existsSync(path.join(siteRoot, "site.config.yaml"))) {
+    fail(`当前目录不是 Garden 站点（缺少 site.config.yaml）：${siteRoot}`);
+  }
+  prepare();
+  runNode("scripts/build-content.mjs");
+}
+
+function runVinext(vinextArgs, { copyDist = false } = {}) {
+  sync();
+  const cwd = vinextRoot();
+  const result = spawnSync(process.execPath, [resolveVinext(), ...vinextArgs], {
+    cwd,
+    env: siteEnv(),
+    stdio: "inherit",
+  });
+  if (copyDist) publishDist(cwd);
+  if (result.status) process.exit(result.status ?? 1);
+}
+
+function copyTemplate(from, to) {
+  fs.mkdirSync(to, { recursive: true });
+  for (const entry of fs.readdirSync(from, { withFileTypes: true })) {
+    if (entry.name === ".git") continue;
+    const source = path.join(from, entry.name);
+    const destination = path.join(to, entry.name);
+    if (entry.isDirectory()) copyTemplate(source, destination);
+    else if (!fs.existsSync(destination)) fs.copyFileSync(source, destination);
+  }
+}
+
+function writeEngineDependency(destination) {
+  const engine = JSON.parse(fs.readFileSync(path.join(gardenPackageRoot, "package.json"), "utf8"));
+  const sitePkgPath = path.join(destination, "package.json");
+  const sitePkg = JSON.parse(fs.readFileSync(sitePkgPath, "utf8"));
+  const dependencies = { ...(sitePkg.dependencies ?? {}) };
+  if (engine.name !== "garden") delete dependencies.garden;
+  dependencies[engine.name] = `^${engine.version}`;
+  sitePkg.dependencies = dependencies;
+  fs.writeFileSync(sitePkgPath, `${JSON.stringify(sitePkg, null, 2)}\n`);
+}
+
+function initSite() {
+  const destination = path.resolve(rest[0] ?? ".");
+  const template = path.join(gardenPackageRoot, "templates", "site");
+  if (!fs.existsSync(template)) fail("Garden 包里缺少 templates/site。");
+  if (fs.existsSync(path.join(destination, "site.config.yaml"))) {
+    fail(`目录已是 Garden 站点：${destination}`);
+  }
+  copyTemplate(template, destination);
+  writeEngineDependency(destination);
+  fs.mkdirSync(path.join(destination, "scripts"), { recursive: true });
+  fs.copyFileSync(
+    path.join(gardenPackageRoot, "scripts", "new-post.mjs"),
+    path.join(destination, "scripts", "new-post.mjs"),
+  );
+  process.stdout.write(`已创建站点：${destination}\n`);
+  installSkill(destination);
+  process.stdout.write("下一步：\n");
+  process.stdout.write(`  cd ${destination}\n`);
+  process.stdout.write("  npm install\n");
+  process.stdout.write("  make new TITLE=\"你好，世界\" SLUG=hello\n");
+  process.stdout.write("  make dev\n");
+}
+
+function packagedSkillRoot() {
+  return path.join(
+    gardenPackageRoot,
+    ".agents",
+    "skills",
+    "garden-interactive-chart",
+  );
+}
+
+function installSkill(destinationRoot = siteRoot) {
+  const from = packagedSkillRoot();
+  if (!fs.existsSync(path.join(from, "SKILL.md"))) {
+    fail("Garden 包里缺少图表 skill。");
+  }
+  const to = path.join(destinationRoot, ".agents", "skills", "garden-interactive-chart");
+  fs.cpSync(from, to, { recursive: true });
+  const shown = path.relative(destinationRoot, to) || to;
+  process.stdout.write(`已安装图表 skill：${shown}\n`);
+}
+
+function help() {
+  process.stdout.write(`Garden 命令：
+  garden dev              同步内容并本地预览
+  garden build            同步内容并构建静态站点
+  garden start            启动已构建的服务
+  garden sync             只从 Markdown 生成索引
+  garden new              创建文章草稿
+  garden embed            拉取外链摘要
+  garden init [目录]      创建只含稿和配置的新站点
+  garden skill            把可交互图表 skill 装进当前站点
+  garden pages:validate   检查 dist/client
+  garden pages:prepare    写入公开产物仓库
+  garden webmentions      发送 Webmentions
+`);
+}
+
+switch (command) {
+  case "help":
+  case "--help":
+  case "-h":
+    help();
+    break;
+  case "sync":
+    sync();
+    break;
+  case "dev":
+    runVinext(["dev", ...rest]);
+    break;
+  case "build":
+    runVinext(["build", ...rest], { copyDist: true });
+    break;
+  case "start":
+    runVinext(["start", ...rest]);
+    break;
+  case "new":
+    runNode("scripts/new-post.mjs", rest);
+    break;
+  case "embed":
+    runNode("scripts/fetch-embed.mjs", rest);
+    break;
+  case "init":
+    initSite();
+    break;
+  case "skill":
+  case "skills":
+    installSkill();
+    break;
+  case "pages:validate":
+    runNode("scripts/prepare-pages-output.mjs", [
+      rest[0] ?? path.join(siteRoot, "dist", "client"),
+    ]);
+    break;
+  case "pages:prepare":
+    runNode("scripts/prepare-pages-output.mjs", rest);
+    break;
+  case "webmentions":
+    runNode("scripts/send-webmentions.mjs", rest);
+    break;
+  default:
+    fail(`未知命令：${command}`);
+}

package/build/sites-vite-plugin.ts

@@ -0,0 +1,39 @@
+import { access, cp, mkdir, rm } from "node:fs/promises";
+import { resolve } from "node:path";
+import type { Plugin } from "vite";
+
+async function exists(path: string): Promise<boolean> {
+  try {
+    await access(path);
+    return true;
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+// Packages the optional backend hosting metadata after Vite finishes compiling.
+export function sites(): Plugin {
+  let root = process.cwd();
+
+  return {
+    name: "sites",
+    apply: "build",
+    configResolved(config) {
+      root = config.root;
+    },
+    async closeBundle() {
+      const outputDirectory = resolve(root, "dist", ".openai");
+      const hostingConfig = resolve(root, ".openai", "hosting.json");
+
+      await rm(outputDirectory, { recursive: true, force: true });
+      await mkdir(outputDirectory, { recursive: true });
+
+      if (await exists(hostingConfig)) {
+        await cp(hostingConfig, resolve(outputDirectory, "hosting.json"));
+      }
+    },
+  };
+}

package/eslint.config.mjs

@@ -0,0 +1,20 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    ".garden/**",
+    "templates/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/next.config.ts

@@ -0,0 +1,13 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  ...(process.env.STATIC_EXPORT === "1"
+    ? {
+        output: "export",
+        trailingSlash: true,
+        images: { unoptimized: true },
+      }
+    : {}),
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "hd-garden",
+  "version": "0.3.0",
+  "private": false,
+  "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
+  "license": "MIT",
+  "homepage": "https://github.com/hedon954/garden",
+  "bugs": {
+    "url": "https://github.com/hedon954/garden/issues"
+  },
+  "keywords": [
+    "hd-garden",
+    "blog",
+    "markdown",
+    "github-pages",
+    "static-site"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "garden": "bin/garden.mjs",
+    "hd-garden": "bin/garden.mjs"
+  },
+  "files": [
+    "app",
+    "bin",
+    "build",
+    "public/favicon.svg",
+    "public/og.png",
+    "public/images",
+    "scripts",
+    "templates",
+    "worker",
+    ".agents",
+    ".env.example",
+    ".openai",
+    "Makefile",
+    "eslint.config.mjs",
+    "next.config.ts",
+    "postcss.config.mjs",
+    "site.config.yaml",
+    "tsconfig.json",
+    "vite.config.ts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hedon954/garden.git"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "content:sync": "node bin/garden.mjs sync",
+    "pages:validate": "node bin/garden.mjs pages:validate",
+    "webmentions:send": "node bin/garden.mjs webmentions",
+    "predev": "npm run content:sync",
+    "dev": "node bin/garden.mjs dev",
+    "prebuild": "npm run content:sync",
+    "build": "node bin/garden.mjs build",
+    "start": "node bin/garden.mjs start",
+    "admin:local": "npm run start -- --host 0.0.0.0 --port 3000",
+    "admin:cloudflare": "npm run build && wrangler deploy --config dist/server/wrangler.json",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "lint": "node bin/garden.mjs sync && eslint . --ignore-pattern dist --ignore-pattern .next --ignore-pattern .garden --ignore-pattern templates"
+  },
+  "dependencies": {
+    "@cloudflare/vite-plugin": "1.37.1",
+    "@phosphor-icons/react": "^2.1.10",
+    "@tailwindcss/postcss": "4.2.1",
+    "@vitejs/plugin-react": "6.0.4",
+    "@vitejs/plugin-rsc": "0.5.30",
+    "fuse.js": "^7.5.0",
+    "github-slugger": "^2.0.0",
+    "gray-matter": "^4.0.3",
+    "katex": "^0.16.47",
+    "marked": "^16.4.2",
+    "mdast-util-to-string": "^4.0.0",
+    "mermaid": "^11.16.0",
+    "next": "16.3.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "react-markdown": "^10.1.0",
+    "react-server-dom-webpack": "19.2.8",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-highlight": "^7.0.2",
+    "rehype-katex": "^7.0.1",
+    "rehype-raw": "^7.0.0",
+    "rehype-slug": "^6.0.0",
+    "remark-breaks": "^4.0.0",
+    "remark-cjk-friendly": "^2.3.1",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "remark-parse": "^11.0.0",
+    "tailwindcss": "4.2.1",
+    "typescript": "5.9.3",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "vinext": "0.0.50",
+    "vite": "8.0.13",
+    "wrangler": "4.116.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "eslint": "9.39.4",
+    "eslint-config-next": "16.2.12"
+  },
+  "type": "module"
+}

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+  <rect width="256" height="256" fill="#f8f8f6"/>
+  <path fill="#202124" d="M216,208H168V184h4a68.07,68.07,0,0,0,68-68,28,28,0,0,0-56,0,12,12,0,0,1-12,12h-4V56a40,40,0,0,0-80,0V88H84A12,12,0,0,1,72,76a28,28,0,0,0-56,0,68.07,68.07,0,0,0,68,68h4v64H40a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16ZM96,128H84A52.06,52.06,0,0,1,32,76a12,12,0,0,1,24,0,28,28,0,0,0,28,28H96a8,8,0,0,0,8-8V56a24,24,0,0,1,48,0v80a8,8,0,0,0,8,8h12a28,28,0,0,0,28-28,12,12,0,0,1,24,0,52.06,52.06,0,0,1-52,52H160a8,8,0,0,0-8,8v32H104V136A8,8,0,0,0,96,128Z"/>
+</svg>