@micropage-sh/cli 2.6.3 → 2.6.5

package/README.md

@@ -73,6 +73,7 @@ Posts live in the project's `posts/` folder as Markdown files with YAML front-ma
 ---
 title: Hello, world
 slug: hello
+date: 2026-07-07
 description: A short summary for the archive, meta description, and og tags.
 visibility: listed
 hero: ./hello.jpg
@@ -84,7 +85,7 @@ preview: The first post on this site.
 Body content goes here as standard Markdown.
 ```
 
-`title` is required. `slug` defaults to the filename minus a leading `YYYY-MM-DD-` date prefix. `visibility` is `listed` (default, appears in the site's `/content` index) or `unlisted`. `list` names a newsletter form and is required to email the post on publish. Local image references in the body are auto-uploaded and rewritten to hosted URLs on `push`.
+`title` is required. `slug` defaults to the filename minus a leading `YYYY-MM-DD-` date prefix. `date` is the post's public date: `YYYY-MM-DD` (midnight UTC) or a full ISO timestamp; it sets the published date of a live post, and a draft keeps it until its first publish. Omit it to use the publish time. Future dates are rejected (scheduling isn't supported); `posts pull` writes it back as the UTC day for published posts. `visibility` is `listed` (default, appears in the site's `/content` index) or `unlisted`. `list` names a newsletter form and is required to email the post on publish. Local image references in the body are auto-uploaded and rewritten to hosted URLs on `push`.
 
 ```bash
 # Save posts/hello.md as a draft

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micropage-sh/cli",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "Micropage CLI: keep your .page files in git and publish static sites from the terminal",
   "main": "src/index.js",
   "bin": {

package/src/commands/posts.js

@@ -92,11 +92,89 @@ async function resolveFormId(projectId, listName) {
   return matches[0].id;
 }
 
+const DATE_ONLY_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const ISO_DATETIME_RE =
+  /^(\d{4}-\d{2}-\d{2})[Tt ](\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)\s*([Zz]|[+-]\d{2}(?::?\d{2})?)?$/;
+// Date-only values are midnight UTC server-side; allow "today" anywhere on
+// Earth (UTC+14) so a local-calendar date isn't rejected as future.
+const DATE_ONLY_FUTURE_SLACK_MS = 14 * 60 * 60 * 1000;
+const DATETIME_FUTURE_SLACK_MS = 5 * 60 * 1000;
+
+function utcDateString(d) {
+  return d.toISOString().slice(0, 10);
+}
+
+function isoOffset(raw) {
+  if (!raw || raw === 'z' || raw === 'Z') return 'Z';
+  const digits = raw.slice(1).replace(':', '');
+  return `${raw[0]}${digits.slice(0, 2)}:${digits.slice(2) || '00'}`;
+}
+
+function isMidnightUtc(d) {
+  return (
+    d.getUTCHours() === 0 && d.getUTCMinutes() === 0 && d.getUTCSeconds() === 0 && d.getUTCMilliseconds() === 0
+  );
+}
+
+/**
+ * Normalize a front-matter `date` into what upsert-post accepts: `YYYY-MM-DD`
+ * or a full ISO timestamp. js-yaml turns unquoted dates into Date objects
+ * (UTC), quoted ones stay strings. Returns null when absent; throws on
+ * invalid or future values (scheduling isn't supported).
+ */
+function normalizePostDate(value, now = new Date()) {
+  if (value === undefined || value === null || value === '') return null;
+
+  let normalized;
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) throw new Error('invalid "date" (not a valid date)');
+    normalized = isMidnightUtc(value) ? utcDateString(value) : value.toISOString();
+  } else if (typeof value === 'string') {
+    const s = value.trim();
+    const dateOnly = DATE_ONLY_RE.exec(s);
+    if (dateOnly) {
+      const d = new Date(`${s}T00:00:00.000Z`);
+      if (Number.isNaN(d.getTime()) || utcDateString(d) !== s) {
+        throw new Error(`invalid "date" (${s}); use YYYY-MM-DD or an ISO timestamp`);
+      }
+      normalized = s;
+    } else {
+      const m = ISO_DATETIME_RE.exec(s);
+      // A timestamp without an offset is read as UTC, matching how YAML
+      // resolves unquoted timestamps.
+      const d = m ? new Date(`${m[1]}T${m[2]}${isoOffset(m[3])}`) : null;
+      if (!d || Number.isNaN(d.getTime()) || utcDateString(new Date(`${m[1]}T00:00:00.000Z`)) !== m[1]) {
+        throw new Error(`invalid "date" (${s}); use YYYY-MM-DD or an ISO timestamp`);
+      }
+      normalized = d.toISOString();
+    }
+  } else {
+    throw new Error(`invalid "date" (${String(value)}); use YYYY-MM-DD or an ISO timestamp`);
+  }
+
+  const isFuture = DATE_ONLY_RE.test(normalized)
+    ? Date.parse(`${normalized}T00:00:00Z`) > now.getTime() + DATE_ONLY_FUTURE_SLACK_MS
+    : new Date(normalized).getTime() > now.getTime() + DATETIME_FUTURE_SLACK_MS;
+  if (isFuture) {
+    throw new Error(`"date" ${normalized} is in the future; scheduling posts is not supported`);
+  }
+  return normalized;
+}
+
 function frontMatterFromPost(post) {
   const fmData = {
     title: post.title || '',
   };
   if (post.slug) fmData.slug = post.slug;
+  if (post.published_at) {
+    const published = new Date(post.published_at);
+    if (!Number.isNaN(published.getTime())) fmData.date = utcDateString(published);
+  } else if (post.date_override) {
+    // A draft's held date must round-trip: push sends date: null for files without one,
+    // which clears it.
+    const held = new Date(post.date_override);
+    if (!Number.isNaN(held.getTime())) fmData.date = isMidnightUtc(held) ? utcDateString(held) : held.toISOString();
+  }
   if (post.description) fmData.description = post.description;
   if (post.web_visibility && post.web_visibility !== 'listed') fmData.visibility = post.web_visibility;
   if (post.hero_image) fmData.hero = post.hero_image;
@@ -202,6 +280,15 @@ async function push(options = {}) {
       continue;
     }
 
+    let postDate;
+    try {
+      postDate = normalizePostDate(fm.date);
+    } catch (err) {
+      console.error(`${relName}: ${err.message}`);
+      hadError = true;
+      continue;
+    }
+
     const emailWanted = fm.email === true;
     let formId = null;
     if (emailWanted) {
@@ -270,6 +357,8 @@ async function push(options = {}) {
       subject: fm.subject || null,
       preheader: fm.preview || null,
     };
+    // An explicit null tells the server the file has no date:, so a held draft date is cleared.
+    payload.date = postDate || null;
 
     try {
       const result = await fn.invoke('upsert-post', payload);
@@ -319,7 +408,7 @@ async function pull(options = {}) {
     remotePosts = await db
       .from('posts')
       .select(
-        'id,slug,title,description,body_markdown,web_visibility,email_enabled,status,hero_image,published_at,created_at',
+        'id,slug,title,description,body_markdown,web_visibility,email_enabled,status,hero_image,published_at,date_override,created_at',
       )
       .eq('project_id', config.projectId)
       .order('created_at', 'desc')
@@ -643,4 +732,5 @@ module.exports = {
   slugify,
   defaultSlugFromFilename,
   frontMatterFromPost,
+  normalizePostDate,
 };

package/templates/PROJECT_AGENT.template.md

@@ -23,6 +23,7 @@ Each file in `posts/*.md` is one post: YAML front-matter + a Markdown body, push
 ---
 title: Launching our new dashboard
 slug: launching-new-dashboard   # optional; defaults to the filename minus a leading date prefix and .md
+date: 2026-07-07                # optional; public date, YYYY-MM-DD or ISO timestamp (default: publish time; no future dates)
 description: A quick look at what's new.
 visibility: listed              # listed | unlisted | none (default: listed)
 hero: launch-hero.png           # optional; local file, existing uploaded asset filename, or absolute URL