@micropage-sh/cli 2.0.8 → 2.6.1

package/README.md

@@ -19,7 +19,7 @@ brew install micropage
 ### npm
 
 ```bash
-npm install -g micropage
+npm install -g @micropage-sh/cli
 ```
 
 ## Authentication
@@ -63,6 +63,40 @@ micropage copy-link
 
 When you create a project without `-d`, the API assigns `projects.domain` as the initial host for your site (for example `my-site.micropage.sh`). You can optionally attach a custom domain (such as `www.example.com`) in the web editor; when present, the CLI shows that custom domain as the site URL (otherwise the default host).
 
+### Authoring posts
+
+Posts live in the project's `posts/` folder as Markdown files with YAML front-matter:
+
+```markdown
+---
+title: Hello, world
+slug: hello
+description: A short summary for the archive, meta description, and og tags.
+visibility: listed
+hero: ./hello.jpg
+list: newsletter
+subject: Hello, world!
+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`.
+
+```bash
+# Save posts/hello.md as a draft
+micropage posts push
+
+# Publish it (and email the `list:` target, if set)
+micropage posts publish hello
+
+# Take it back down (stays as a draft)
+micropage posts unpublish hello
+```
+
+See [`micropage posts`](#posts) below for the full command set.
+
 ## Commands reference
 
 ### Auth
@@ -116,6 +150,19 @@ When you create a new project, the CLI also scaffolds:
 | `micropage copy-link` | Copy the live URL to clipboard |
 | `micropage open-pricing` | Open the pricing page in the browser |
 
+### Posts
+
+| Command | Description |
+|---|---|
+| `micropage posts push` | Save local `posts/*.md` files as post drafts (or update already-published posts, which go live immediately) |
+| `micropage posts publish [slug] [-w]` | Publish a post (or all local posts) to the web; sends the newsletter email if the post has a `list:`. Re-running re-sends the email. Auto-queues a rebuild of the site so the `/content` archive updates — no separate `micropage publish` needed. Use `-w` to stream the rebuild's deploy events until it's live. |
+| `micropage posts unpublish <slug>` | Remove a post's `/content/<slug>` page; the post remains as a draft |
+| `micropage posts pull` | Pull remote posts down to local `posts/*.md` files |
+| `micropage posts list` | List the project's posts (slug, title, visibility, published/draft, emailed, send status, created). "Send status" is the newsletter send lifecycle and shows only for email posts — it does not reflect deploy state. |
+| `micropage posts rm <slug>` | Delete a post entirely (remote) |
+
+**Note:** `micropage posts publish` publishes a single *post* and automatically rebuilds the site so the post appears on the `/content` archive — you do **not** need to run `micropage publish` afterward. `micropage publish` is for deploying changes to the *site* content (`.page` files) itself.
+
 ### Files
 
 | Command | Description |
@@ -128,9 +175,9 @@ When you create a new project, the CLI also scaffolds:
 
 | Command | Description |
 |---|---|
-| `micropage submissions list [--json]` | List form submissions for the project |
-| `micropage submissions show <id> [--json]` | Show a single submission in detail |
-| `micropage submissions export [--format csv|json] [-o file]` | Export all form submissions for the current project |
+| `micropage submissions list [--json] [--spam]` | List form submissions for the project. Spam is excluded; `--spam` lists only submissions flagged as spam, with the reason |
+| `micropage submissions show <id> [--json]` | Show a single submission in detail, including a `Spam:` line with the reason when it was flagged |
+| `micropage submissions export [--format csv|json] [-o file] [--spam]` | Export form submissions for the current project. Spam is excluded; `--spam` exports only flagged submissions (default file `submissions-spam.<format>`, CSV gets a trailing `spam_reason` column) |
 
 **Examples:**
 
@@ -152,6 +199,12 @@ When you create a new project, the CLI also scaffolds:
   micropage submissions export --format json --output submissions.json
   ```
 
+- Export only submissions flagged as spam:
+
+  ```bash
+  micropage submissions export --spam
+  ```
+
 ## Local content model
 
 The CLI uses one or more `*.page` files in the working directory as the source of truth for project content.
@@ -163,6 +216,10 @@ The CLI uses one or more `*.page` files in the working directory as the source o
 
 **Pulling** always writes to `landing.page` only.
 
+### `llms.txt`
+
+If the project folder contains a root-level `llms.txt`, its contents are published verbatim and served at `/llms.txt` (a curated map of the site for LLM agents). Remove the local file and re-publish to take it down.
+
 ## Project configuration
 
 Each project folder has a `.micropage/project.json` file that stores:

package/bin/micropage.js

@@ -1,3 +1,18 @@
 #!/usr/bin/env node
 
+// Suppress Node's "buffer.File is an experimental feature" warning that fires
+// when undici's FormData serializes a Blob upload. Stabilized in Node 22.
+const origEmit = process.emit;
+process.emit = function (name, data, ...rest) {
+  if (
+    name === 'warning' &&
+    data &&
+    data.name === 'ExperimentalWarning' &&
+    /buffer\.File/.test(String(data.message))
+  ) {
+    return false;
+  }
+  return origEmit.call(this, name, data, ...rest);
+};
+
 require('../src/index.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micropage-sh/cli",
-  "version": "2.0.8",
+  "version": "2.6.1",
   "description": "CLI for micropage.sh - create, sync, and publish microsites",
   "main": "src/index.js",
   "bin": {
@@ -13,7 +13,7 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node -e \"require('./src/index.js')\"",
+    "test": "node -e \"require('./src/index.js')\"; node --test test/*.test.js test/*_test.mjs",
     "build:bin": "pkg . --targets node18-linux-x64,node18-macos-x64,node18-macos-arm64 --output dist/micropage",
     "build:linux": "pkg . --target node18-linux-x64 --output dist/micropage-linux-amd64",
     "build:macos-amd64": "pkg . --target node18-macos-x64 --output dist/micropage-darwin-amd64",
@@ -57,6 +57,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
+    "gray-matter": "^4.0.3",
     "open": "^10.1.0"
   },
   "devDependencies": {

package/src/commands/builds.js

@@ -14,7 +14,7 @@ const {
   uploadAssetsWithToken,
 } = require('../supabase');
 const { getProjectConfig, setProjectConfig } = require('../auth');
-const { readPageFilesFromDir } = require('../parser');
+const { readPageFilesFromDir, readLlmsTxtFromDir } = require('../parser');
 const { BUILD_COMPILER_URL } = require('../config');
 const { formatTable, formatDate } = require('../utils');
 
@@ -167,6 +167,13 @@ async function push(options = {}) {
     process.exit(1);
   }
 
+  const llmsTxt = readLlmsTxtFromDir(cwd);
+  if (llmsTxt != null) {
+    jsonContent.site = jsonContent.site || {};
+    jsonContent.site.llms_txt = llmsTxt;
+    console.log(`Including llms.txt (${Buffer.byteLength(llmsTxt, 'utf8')} bytes).`);
+  }
+
   // Decide whether to update existing draft or create new build
   let existingBuild = null;
   if (config.buildId) {

package/src/commands/forms.js

@@ -4,6 +4,25 @@ const { db, handleAuthError } = require('../supabase');
 const { getProjectConfig } = require('../auth');
 const { formatTable, formatDate } = require('../utils');
 
+const FORM_COLUMNS = 'id,form_name,page_url,is_footer,created_at';
+
+/** Occurrence number among same-named forms on the same page, 1-based. */
+function formLabel(form) {
+  const ordinal = Number(form.form_ordinal) || 0;
+  return ordinal > 0 ? `${form.form_name} (${ordinal + 1})` : form.form_name;
+}
+
+function fetchForms(projectId, withOrdinal) {
+  const q = db
+    .from('forms')
+    .select(withOrdinal ? `${FORM_COLUMNS},form_ordinal` : FORM_COLUMNS)
+    .eq('project_id', projectId);
+
+  return withOrdinal
+    ? q.order('page_url,form_ordinal', 'asc').get()
+    : q.order('created_at', 'asc').get();
+}
+
 async function list(options = {}) {
   const cwd = process.cwd();
   const config = getProjectConfig(cwd);
@@ -14,16 +33,18 @@ async function list(options = {}) {
 
   let forms;
   try {
-    forms = await db
-      .from('forms')
-      .select('id,form_name,page_url,is_footer,created_at')
-      .eq('project_id', config.projectId)
-      .order('created_at', 'asc')
-      .get();
+    forms = await fetchForms(config.projectId, true);
   } catch (err) {
     handleAuthError(err);
-    console.error('Failed to list forms:', err.message);
-    process.exit(1);
+    // form_ordinal is newer than some deployed databases; selecting a column
+    // that does not exist fails the whole request, so retry the older shape.
+    try {
+      forms = await fetchForms(config.projectId, false);
+    } catch (retryErr) {
+      handleAuthError(retryErr);
+      console.error('Failed to list forms:', retryErr.message);
+      process.exit(1);
+    }
   }
 
   if (!Array.isArray(forms) || forms.length === 0) {
@@ -31,13 +52,14 @@ async function list(options = {}) {
     return;
   }
 
-  // Count submissions per form_id
+  // Count non-spam submissions per form_id
   let submissions;
   try {
     submissions = await db
       .from('form_submissions')
       .select('form_id')
       .eq('project_id', config.projectId)
+      .is('flagged_at', 'null')
       .get();
   } catch (err) {
     handleAuthError(err);
@@ -53,13 +75,17 @@ async function list(options = {}) {
   }
 
   if (options.json) {
-    const out = forms.map((f) => ({ ...f, submission_count: counts[f.id] || 0 }));
+    const out = forms.map((f) => ({
+      ...f,
+      form_ordinal: Number(f.form_ordinal) || 0,
+      submission_count: counts[f.id] || 0,
+    }));
     console.log(JSON.stringify(out, null, 2));
     return;
   }
 
   const rows = forms.map((f) => [
-    f.form_name,
+    formLabel(f),
     f.page_url,
     f.is_footer ? 'footer' : 'inline',
     String(counts[f.id] || 0),