@micropage-sh/cli 2.6.2 → 2.6.4

package/README.md

@@ -1,6 +1,6 @@
 # micropage CLI
 
-Command-line interface for [micropage.sh](https://app.micropage.sh) — create, edit, publish, and manage microsites from your terminal.
+Command-line interface for [micropage.sh](https://micropage.sh): keep your `.page` files in git and create, edit, publish and manage your sites from the terminal.
 
 ## Requirements
 
@@ -48,7 +48,7 @@ nano landing.page
 # Push local content as a draft build
 micropage push
 
-# Publish the current draft (deploys to Cloudflare Pages)
+# Publish the current draft (deploys it live)
 micropage publish
 
 # Pull the latest remote build content to landing.page
@@ -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
@@ -115,7 +116,7 @@ See [`micropage posts`](#posts) below for the full command set.
 |---|---|
 | `micropage projects list [--json]` | List your projects |
 | `micropage projects show [id] [--json]` | Show project + latest build details |
-| `micropage projects create <name> [-d domain]` | Create a project and init local folder. Omit `-d` to let the API assign `{slugified-name}-{6 hex}` (unique Pages/DNS label, max 58 chars). Use `-d` only to override the slug. |
+| `micropage projects create <name> [-d domain]` | Create a project and init local folder. Omit `-d` to let the API assign `{slugified-name}-{6 hex}` (unique `<slug>.micropage.sh` label, max 58 chars). Use `-d` only to override the slug. |
 | `micropage projects fetch <uuid\|domain>` | Fetch an existing project and init local folder (includes storage → `./assets` sync) |
 | `micropage projects pull` | Pull latest build raw content → `landing.page`, then sync `./assets` with project storage (1:1) |
 | `micropage projects delete [-y]` | Delete project (remote + local `.micropage/`) |
@@ -132,7 +133,7 @@ When you create a new project, the CLI also scaffolds:
 | Command | Description |
 |---|---|
 | `micropage push` | Merge local `.page` files and save as a draft build |
-| `micropage publish` | Push then deploy to Cloudflare Pages |
+| `micropage publish` | Push then deploy the site live |
 | `micropage builds list [--json]` | List builds for the current project |
 | `micropage builds redeploy [version]` | Re-publish an older build as a new deploy |
 | `micropage builds download [version] [-o file]` | Download a deployed build archive as a `.zip` file |
@@ -227,7 +228,7 @@ If the project folder contains a root-level `llms.txt`, its contents are publish
 Each project folder has a `.micropage/project.json` file that stores:
 - `projectId` — the Supabase project ID
 - `buildId` — the ID of the last draft/deployed build (auto-updated by push/pull)
-- `domain` — the Cloudflare Pages domain
+- `domain` — the project slug; the site lives at `<domain>.micropage.sh`
 - `name` — the project name
 
 Add `.micropage/` to your `.gitignore` if you share the content folder.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@micropage-sh/cli",
-  "version": "2.6.2",
-  "description": "CLI for micropage.sh - create, sync, and publish microsites",
+  "version": "2.6.4",
+  "description": "Micropage CLI: keep your .page files in git and publish static sites from the terminal",
   "main": "src/index.js",
   "bin": {
     "micropage": "bin/micropage.js"

package/src/commands/posts.js

@@ -92,11 +92,84 @@ 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);
+  }
   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 +275,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 +352,7 @@ async function push(options = {}) {
       subject: fm.subject || null,
       preheader: fm.preview || null,
     };
+    if (postDate) payload.date = postDate;
 
     try {
       const result = await fn.invoke('upsert-post', payload);
@@ -643,4 +726,5 @@ module.exports = {
   slugify,
   defaultSlugFromFilename,
   frontMatterFromPost,
+  normalizePostDate,
 };

package/src/index.js

@@ -19,7 +19,7 @@ const program = new Command();
 
 program
   .name('micropage')
-  .description('CLI for micropage.sh – create, sync, and publish microsites')
+  .description('Micropage CLI: keep your .page files in git and publish static sites from the terminal')
   .version(version);
 
 // ---------------------------------------------------------------------------
@@ -65,7 +65,7 @@ projectCmd
   .description('Create a new project and init local folder')
   .option(
     '-d, --domain <domain>',
-    'Override Cloudflare Pages project name / slug (default: server generates name-slug + 6 hex, max 58 chars)',
+    'Choose the project slug, which sets its address <domain>.micropage.sh (default: server generates name-slug + 6 hex, max 58 chars)',
   )
   .action((name, opts) => projects.create(name, opts));
 
@@ -87,7 +87,7 @@ projectCmd
 
 projectCmd
   .command('publish')
-  .description('Push local content and publish (deploy to Cloudflare Pages) — alias for `micropage publish`')
+  .description('Push local content and publish it live — alias for `micropage publish`')
   .option('-w, --watch', 'Stream build/deploy events after triggering publish')
   .action((opts) => builds.publish(opts));
 
@@ -152,7 +152,7 @@ program
 
 program
   .command('publish')
-  .description('Push local content and publish (deploy to Cloudflare Pages)')
+  .description('Push local content and publish it live')
   .option('-w, --watch', 'Stream build/deploy events after triggering publish')
   .action((opts) => builds.publish(opts));
 

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