hd-garden 0.13.1 → 0.13.2

package/README.en.md

@@ -73,7 +73,7 @@ Ask your Agent to compile the post using the bundled `garden-ui` skill: it runs
 ```bash
 make new SLUG=writing-pace TITLE="Writing Pace" # Create a draft post in content/posts/
 make dev                                        # Sync content and start the local server
-CONTENT_INCLUDE_DRAFTS=1 make dev               # Preview drafts and future publishAt posts
+CONTENT_INCLUDE_DRAFTS=0 make dev              # Preview published posts only (optional)
 make check                                      # Run garden sync and garden build
 make update MESSAGE="Add writing-pace post"     # Check, commit, and push to origin
 npx garden check content/posts/writing-pace.md  # Validate front matter, components, and assets

package/README.md

@@ -75,7 +75,7 @@ Obsidian 插件这一轮不随包安装。
 ```bash
 make new SLUG=writing-pace TITLE="慢慢写"      # 在 content/posts/ 下创建文章草稿
 make dev                                       # 同步内容并启动本地预览
-CONTENT_INCLUDE_DRAFTS=1 make dev              # 连同草稿和未来定时文章一起预览
+CONTENT_INCLUDE_DRAFTS=0 make dev             # 只预览已发布文章（可选）
 make check                                     # 运行 garden sync 与 garden build 验证全站
 make update MESSAGE="新增一篇文章"             # 检查通过后提交并推送到远端仓库
 npx garden check content/posts/writing-pace.md # 单独检查一篇文章的标题、组件与资源路径

package/bin/garden.mjs

@@ -522,6 +522,10 @@ async function main() {
       await sync();
       break;
     case "dev":
+      // Preview drafts by default, without overriding an explicit opt-out.
+      // Scoped to this CLI process: sync, Vinext and its watcher inherit it;
+      // later build/check commands do not.
+      process.env.CONTENT_INCLUDE_DRAFTS ??= "1";
       ensureDevGitHubLogin();
       await runVinext(["dev", ...rest]);
       break;

package/docs/handbook/components/file/checklist.md

@@ -14,4 +14,4 @@
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | 检查单篇文章的组件字段、代码对比与图片附件路径 |
 | `make check` | 运行 `npx garden sync && npx garden build` 校验全站构建 |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 在本地连同草稿和定时文章一起预览 |
+| `make dev` | 在本地连同草稿和定时文章一起预览 |

package/docs/handbook/en/components/file/checklist.md

@@ -14,4 +14,4 @@ Before running `make update` to push changes, verify the following items:
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | Checks a single post's component fields, code diffs, and local asset paths |
 | `make check` | Runs `npx garden sync && npx garden build` to validate the full site build |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews drafts and scheduled posts locally |
+| `make dev` | Previews drafts and scheduled posts locally |

package/docs/handbook/en/reference/file/checklist.md

@@ -14,4 +14,4 @@ Before running `make update` to push changes, verify the following items:
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | Checks a single post's component fields, code diffs, and local asset paths |
 | `make check` | Runs `npx garden sync && npx garden build` to validate the full site build |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews drafts and scheduled posts locally |
+| `make dev` | Previews drafts and scheduled posts locally |

package/docs/handbook/en/start.md

@@ -59,10 +59,10 @@ make new DIR=network SLUG=tcp-bbr TITLE="TCP BBR Notes"
 > [!NOTE] Note
 > `SLUG` may only contain lowercase letters, digits, and hyphens (`a-z`, `0-9`, `-`), never `/`; pass subdirectories via `DIR`. `make new` reads only `SLUG`, `TITLE`, and `DIR`.
 
-Newly created files default to `draft: true`. Set `CONTENT_INCLUDE_DRAFTS=1` to preview drafts or future-dated (`publishAt`) posts locally:
+Newly created files default to `draft: true`. `make dev` previews drafts and future-dated (`publishAt`) posts by default. Use `CONTENT_INCLUDE_DRAFTS=0 make dev` to opt out. Production builds still exclude them by default:
 
 ```bash
-CONTENT_INCLUDE_DRAFTS=1 make dev
+make dev
 ```
 
 ### Creating a Thought
@@ -76,7 +76,7 @@ The site `Makefile` and `garden` CLI provide these commands:
 | Command | What It Runs |
 | :--- | :--- |
 | `make dev` | Runs `make prepare` to check dependencies, then runs `npx garden dev` (which syncs content and starts the dev server) |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews `draft: true` drafts and future `publishAt` posts alongside published content |
+| `CONTENT_INCLUDE_DRAFTS=0 make dev` | Optional: preview published posts only, excluding drafts and future posts |
 | `make new SLUG=xxx TITLE="Title" DIR=subdir` | Calls `npx garden new` to create a draft post under `content/posts/` (`DIR` is optional) |
 | `make check` | Runs `npx garden sync && npx garden build` in the site repo to verify content sync and the production build |
 | `npx garden check content/posts/xxx.md` | Checks a single Markdown post's title, component fields, code diffs, and local asset paths |

package/docs/handbook/reference/file/checklist.md

@@ -14,4 +14,4 @@
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | 检查单篇文章的组件字段、代码对比与图片附件路径 |
 | `make check` | 运行 `npx garden sync && npx garden build` 校验全站构建 |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 在本地连同草稿和定时文章一起预览 |
+| `make dev` | 在本地连同草稿和定时文章一起预览 |

package/docs/handbook/start.md

@@ -59,10 +59,10 @@ make new DIR=network SLUG=tcp-bbr TITLE="TCP BBR 拥塞控制笔记"
 > [!NOTE]
 > `SLUG` 只能包含小写字母、数字和连字符（`a-z`、`0-9`、`-`），不能包含 `/`；子目录必须用 `DIR` 参数传入。`make new` 只读取 `SLUG`、`TITLE` 和 `DIR` 三个变量。
 
-新建的文件默认带有 `draft: true`。本地预览草稿或未来定时文章（`publishAt`）时，加上环境变量 `CONTENT_INCLUDE_DRAFTS=1`：
+新建的文件默认带有 `draft: true`。`make dev` 默认预览草稿和未来定时文章（`publishAt`）；用 `CONTENT_INCLUDE_DRAFTS=0 make dev` 可关闭。正式构建仍默认排除它们：
 
 ```bash
-CONTENT_INCLUDE_DRAFTS=1 make dev
+make dev
 ```
 
 ### 新建随想
@@ -76,7 +76,7 @@ CONTENT_INCLUDE_DRAFTS=1 make dev
 | 命令 | 实际执行的操作 |
 | :--- | :--- |
 | `make dev` | 先执行 `make prepare` 检查依赖，再运行 `npx garden dev`（内部自动执行同步并启动开发服务器） |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 连同 `draft: true` 草稿和未到 `publishAt` 时间的文章一起预览 |
+| `CONTENT_INCLUDE_DRAFTS=0 make dev` | 可选：只预览已发布文章，排除草稿和未来定时文章 |
 | `make new SLUG=xxx TITLE="标题" DIR=子目录` | 调用 `npx garden new` 在 `content/posts/` 下生成新文章草稿（`DIR` 可省略） |
 | `make check` | 在站点仓库中运行 `npx garden sync && npx garden build`，验证全站同步与生产构建 |
 | `npx garden check content/posts/xxx.md` | 单独检查某篇 Markdown 文章的标题、组件字段、代码对比与本地附件路径 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "private": false,
   "description": "\u7528 Markdown \u5199\u4f5c\u3001\u7528 GitHub Pages \u53d1\u5e03\u7684\u4e2a\u4eba\u535a\u5ba2\u5f15\u64ce\u3002",
   "license": "MIT",

package/scripts/new-post.mjs

@@ -67,12 +67,12 @@ async function main() {
   if (lang === "en") {
     console.log(`Created draft: ${path.relative(root, destination)}`);
     console.log(`Post URL: /blog/${[...segments, slug].join("/")}/`);
-    console.log("Preview: CONTENT_INCLUDE_DRAFTS=1 make dev");
+    console.log("Preview: make dev");
     console.log("Before publishing, fill in description, tags, and body, set draft to false, then run make update.");
   } else {
     console.log(`已创建草稿：${path.relative(root, destination)}`);
     console.log(`文章路径：/blog/${[...segments, slug].join("/")}/`);
-    console.log("预览：CONTENT_INCLUDE_DRAFTS=1 make dev");
+    console.log("预览：make dev");
     console.log("发布前请完善摘要、标签与正文，并将 draft 改为 false，再运行 make update。");
   }
 }

package/templates/site/README.en.md

@@ -8,6 +8,8 @@ make new TITLE="Hello, World" SLUG=hello
 make dev
 ```
 
+`make dev`, `npm run dev`, and `npx garden dev` preview drafts and future scheduled posts by default. Opt out with `CONTENT_INCLUDE_DRAFTS=0 make dev`. Production builds exclude them by default.
+
 Running `npx garden dev` for the first time fills in any missing `Makefile` or skills and creates `.env.local`. Cursor and Codex read `.agents/skills/` automatically when opening this repository. Run `npx garden skill` anytime to update the bundled skills.
 
 `npx hd-garden init` copies the VS Code / Cursor and Typora Intelligent UI plugins into `.garden/editors/` and asks whether to install them when the terminal is interactive. Run `npx garden editors install` later (`--yes` installs both, `--vscode` or `--typora` installs one). Typora needs typora-community-plugin first; then enable the plugin under Settings, Installed plugins. Use the plugins to insert a plain `garden` brief for the `garden-ui` skill to compile, preview a component, and open the catalog. In Typora, type `/` and choose `/garden` to list each component with a small preview image. Hand `Compile this post:` to the skill when you want it compiled.

package/templates/site/README.md

@@ -8,6 +8,8 @@ make new TITLE="你好，世界" SLUG=hello
 make dev
 ```
 
+`make dev`、`npm run dev` 和 `npx garden dev` 默认预览草稿及未来定时文章。可用 `CONTENT_INCLUDE_DRAFTS=0 make dev` 关闭；正式构建默认排除这些内容。
+
 第一次 `npx garden dev` 会补齐 Makefile 和 skill，并创建 `.env.local`。Cursor / Codex 打开这个仓库后会读到 `.agents/skills/`。要更新 skill，再运行 `npx garden skill`。
 
 `npx hd-garden init` 会把 VS Code / Cursor 与 Typora 的 Intelligent UI 插件放到 `.garden/editors/`，并在交互终端里询问要不要安装。之后可以运行 `npx garden editors install`（加 `--yes` 则直接安装，`--vscode` / `--typora` 只装一个）。Typora 需要先装 typora-community-plugin，再在「设置 → 已安装插件」里勾选。插件用来插入想法（一段给 `garden-ui` skill 编译的 `garden` 围栏，不是写好的 YAML）、预览组件、打开清单，并把「编译这篇」交给 skill。Typora 里输入 `/` 选 `/garden`，再从带小预览图的列表里选。