quartz-remove-drafts-customization

---

name: quartz-remove-drafts-customization title: "quartz-remove-drafts-customization — Quartz RemoveDrafts plugin의 status: draft 미인식 fix + default-draft strict hardening (2026-06-02)" description: "Quartz 빌드 시스템의 Plugin.RemoveDrafts()는 frontmatter의 draft: true만 체크함. status: draft나 다른 키로 draft를 표시하는 경우 (Obsidian vault + Quartz 셋업의 흔한 패턴), draft가 public/에 그대로 빌드되어 site에 게시됨. quartz.config.ts의 filters: [Plugin.RemoveDrafts()]를 customized filter로 교체해 status === draft도 인식하게 만드는 절차. {{AGENT_NAME}} YOUR_DOMAIN 포함 Quartz 4.x 사용자 모두 영향. 2026-06-02 patch: default-draft strict mode (status field가 없거나 unknown이면 자동 EXCLUDE) + 5-state machine (draft/in_review/polished/published/archived) + wikilink post-EXCLUDE caveat + 'publish' 단수 trap." type: skill space: growth tags: [skill, quartz, draft, content-pipeline, obsidian, YOUR_SITE, state-machine, default-draft-strict] created: 2026-06-01 updated: 2026-06-02 links:

• "[[skills/content-pipeline/SKILL]]"
• "[[skills/YOUR_SITE]]"
• "[[skills/YOUR_PREFIX-content-status-enforcement]]"
• "[[skills/site-spec-audit]]"
• "[[skills/filesystem-truth-audit]]"
• "[[skills/patch-secret-safety]]"
• "[[@action/gateway/{{AGENT_NAME_LOWER}}-architecture-dataflow]]"
• "[[@identity/brain/rules]]"---

quartz-remove-drafts-customization

Quartz Plugin.RemoveDrafts() 필터가 custom frontmatter 키 (e.g. status: draft)를 인식하지 못하는 문제의 진단 + fix 절차.

문제 — 2026-06-01 ~ 2026-06-02 incident (2 rounds)

Round 1 (6/1): 명시적 status: draft 누수

content-pipeline이 만든 status: draft 초안 파일들이 검토 없이 YOUR_DOMAIN에 자동 게시됨.

Round 2 (6/2): default-include의 함정 — status field가 없는 파일이 통과됨

6/1 fix 후에도 5/23~5/26 자동 생성 article 4개가 계속 노출됨. status: draft도 아니고 status: publish도 아닌, status field 자체가 없는 파일들이었음. v1 filter의 "default-include (status field 없으면 통과)" 정책이 이 케이스를 못 잡음. Hardening: default-draft strict (status field 없으면 자동 EXCLUDE) — 모든 콘텐트는 pipeline을 거쳐서 publish 명시되어야 라이브.

진짜 원인

Quartz 4.x 기본 RemoveDrafts plugin:

// quartz/plugins/filters/draft.ts (Quartz 4.5.2)
export const RemoveDrafts: QuartzFilterPlugin<{}> = () => ({
  name: "RemoveDrafts",
  shouldPublish(_ctx, [_tree, vfile]) {
    const draftFlag: boolean =
      vfile.data?.frontmatter?.draft === true ||
      vfile.data?.frontmatter?.draft === "true"
    return !draftFlag
  },
})