Site: invert draft default — publish-by-opt-in

RuitingMa · claude · RuitingMa · commit e85599fea1ad · 2026-05-05T00:26:06.000+10:00
Rename the schema field `draft: boolean` → `published: boolean` (default
false) so every essay and sketch starts unpublished. To ship, set
`published: true` in the entry's frontmatter (or in the SKETCHES row).

Why the rename: `draft: false` is a double-negative for what's
conceptually "I've polished this and it's official"; `published: true`
reads as the affirmative act of publishing, matching the new mental
model where draft is the resting state and publication is the
deliberate gesture.

Filter sites flip from `!e.data.draft` to `e.data.published`. The
per-page `isDraft(slug)` helper survives unchanged at call sites
(clinamen / hello-world / smoke / shi PROD redirects); internally it
now returns `!sketch.published`.

Existing entries:
- zhui-guang.md: gain `published: true` (only currently-shipped essay)
- clinamen, smoke (already-shipped sketches): gain `published: true`
- hello-world, shi (drafted sketches): drop the now-redundant `draft: true`
- jeux-deau-test + 5 score-themed essay drafts: drop `draft: true`

Co-Authored-By: Claude Opus 4.7 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/src/content.config.ts b/src/content.config.ts
@@ -19,8 +19,9 @@ const essays = defineCollection({
     // Name of a stage component in the STAGES registry inside
     // src/pages/essays/[...slug].astro. Omit for a prose-only essay.
     stage: z.string().optional(),
-    // Hide from the listing and skip building in PROD. Dev still renders.
-    draft: z.boolean().default(false),
+    // Publish-by-opt-in: every essay starts as a draft (hidden in PROD,
+    // dev still renders). Set `published: true` to ship.
+    published: z.boolean().default(false),
   }),
 });
 
diff --git a/src/content/essays/dong-jie-de-bao-tou.mdx b/src/content/essays/dong-jie-de-bao-tou.mdx
@@ -4,7 +4,6 @@ date: "2026-05-04"
 kind: ESSAY
 summary: 谱面在动，谱号、调号、拍号永远在最左边——这块小区域比看上去复杂。
 tint: rust
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/gun-pu-de-zha-fa.mdx b/src/content/essays/gun-pu-de-zha-fa.mdx
@@ -4,7 +4,6 @@ date: "2026-05-04"
 kind: ESSAY
 summary: 从 MEI 到一个能在网页里横向滚动、声音同步的乐谱组件。
 tint: dune
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/jeux-deau-test.mdx b/src/content/essays/jeux-deau-test.mdx
@@ -3,7 +3,6 @@ title: Score 组件测试页
 date: "2026-04-26"
 kind: NOTE
 summary: 全部 5 个 Score 实例集中在一页，用于回归 / 压力测试。永久 dev-only。
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/pei-pu.mdx b/src/content/essays/pei-pu.mdx
@@ -4,7 +4,6 @@ date: "2026-05-04"
 kind: NOTE
 summary: 一种横向滚动的乐谱。它不替你看，它陪你看。
 tint: plum
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/shui-zhi-xi-xi.mdx b/src/content/essays/shui-zhi-xi-xi.mdx
@@ -4,7 +4,6 @@ date: "2026-05-04"
 kind: NOTE
 summary: 拉威尔 1901 年的水。从一个 Eadd9 落下来。
 tint: mist
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/xi-tong-pai-zhun.mdx b/src/content/essays/xi-tong-pai-zhun.mdx
@@ -4,7 +4,6 @@ date: "2026-05-04"
 kind: ESSAY
 summary: 谱面要滚得准，声音要响得准，两边对的是同一个时间——但它们用的不是同一只钟。
 tint: moss
-draft: true
 ---
 
 import Score from '../../components/Score.astro';
diff --git a/src/content/essays/zhui-guang.md b/src/content/essays/zhui-guang.md
@@ -5,6 +5,7 @@ kind: NOTE
 summary: 关于注视、追光，以及阅读位置。
 tint: moss
 stage: begin
+published: true
 ---
 
 <section data-cue="empty">
diff --git a/src/lib/sketches.ts b/src/lib/sketches.ts
@@ -3,9 +3,10 @@
 // here via the page's `slug` prop, so each sketch page only declares which
 // sketch it is — no duplicated title/date/kind/tint.
 //
-// Mark `draft: true` to hide an entry from the listing and redirect direct
-// visits to /404 in production builds. Dev still serves them normally so you
-// can preview. (The redirect target relies on src/pages/404.astro existing;
+// Publish-by-opt-in: every entry starts as a draft. Set `published: true`
+// to ship — drafts are hidden from the listing and redirect direct visits
+// to /404 in production. Dev still serves them normally so you can
+// preview. (The redirect target relies on src/pages/404.astro existing;
 // if you ever rename or remove it, drafts will fall through to the host's
 // default 404 page.)
 import type { Kind } from './kinds';
@@ -20,20 +21,22 @@ export type Sketch = {
   kind: Kind;
   summary: string;
   tint?: Tint;
-  draft?: boolean;
+  published?: boolean;
 };
 
 export const SKETCHES: Sketch[] = [
-  { slug: 'shi',         href: '/sketches/shi/',         title: '识',          date: '2026-04-22', kind: 'AI · INTERACTIVE',   summary: '机器识字。',     tint: 'moss', draft: true },
-  { slug: 'clinamen',    href: '/sketches/clinamen/',    title: 'Clinamen',   date: '2026-04-20', kind: 'AUDIO · GENERATIVE', summary: '河灯散布于水面。', tint: 'rust' },
-  { slug: 'smoke',       href: '/sketches/smoke/',       title: 'Smoke',      date: '2026-04-19', kind: 'GENERATIVE',         summary: '烟。',           tint: 'plum' },
-  { slug: 'hello-world', href: '/sketches/hello-world/', title: 'Flow Field', date: '2026-04-18', kind: 'GENERATIVE',         summary: '漂流点阵。',     tint: 'mist', draft: true },
+  { slug: 'shi',         href: '/sketches/shi/',         title: '识',          date: '2026-04-22', kind: 'AI · INTERACTIVE',   summary: '机器识字。',     tint: 'moss' },
+  { slug: 'clinamen',    href: '/sketches/clinamen/',    title: 'Clinamen',   date: '2026-04-20', kind: 'AUDIO · GENERATIVE', summary: '河灯散布于水面。', tint: 'rust', published: true },
+  { slug: 'smoke',       href: '/sketches/smoke/',       title: 'Smoke',      date: '2026-04-19', kind: 'GENERATIVE',         summary: '烟。',           tint: 'plum', published: true },
+  { slug: 'hello-world', href: '/sketches/hello-world/', title: 'Flow Field', date: '2026-04-18', kind: 'GENERATIVE',         summary: '漂流点阵。',     tint: 'mist' },
 ];
 
 export function getSketch(slug: string): Sketch | undefined {
   return SKETCHES.find((s) => s.slug === slug);
 }
 
+/** Per-page guard for draft sketches. Each sketch page imports this
+ *  and redirects to /404 in PROD when its slug is unpublished. */
 export function isDraft(slug: string): boolean {
-  return getSketch(slug)?.draft === true;
+  return !getSketch(slug)?.published;
 }
diff --git a/src/pages/essays/[...slug].astro b/src/pages/essays/[...slug].astro
@@ -4,7 +4,7 @@ import EssayLayout from '../../layouts/EssayLayout.astro';
 import BeginSketch from '../../components/BeginSketch.astro';
 
 export async function getStaticPaths() {
-  const essays = await getCollection('essays', (e) => import.meta.env.DEV || !e.data.draft);
+  const essays = await getCollection('essays', (e) => import.meta.env.DEV || e.data.published);
   return essays.map((entry) => ({
     params: { slug: entry.id },
     props: { entry },
diff --git a/src/pages/index.astro b/src/pages/index.astro
@@ -7,10 +7,10 @@ import { SKETCHES } from '../lib/sketches';
 // Sketches remain hand-authored .astro pages (their layouts are bespoke,
 // so a shared template fights them). The registry lives in src/lib/sketches.ts
 // so each sketch page can import `isDraft` and gate itself in PROD.
-const sketches = SKETCHES.filter((s) => import.meta.env.DEV || !s.draft);
+const sketches = SKETCHES.filter((s) => import.meta.env.DEV || s.published);
 
 // Long-form essays come from the content collection.
-const essayEntries = await getCollection('essays', (e) => import.meta.env.DEV || !e.data.draft);
+const essayEntries = await getCollection('essays', (e) => import.meta.env.DEV || e.data.published);
 const essays = essayEntries.map((e) => ({
   href: `/essays/${e.id}/`,
   title: e.data.title,
