markform 0.1.27 → 0.1.29

package/docs/markform-reference.md

@@ -415,8 +415,13 @@ Structured tabular data with typed columns. Uses standard markdown table syntax.
 | `columnIds` | string[] | Yes | Array of snake_case column identifiers |
 | `columnLabels` | string[] | No | Display labels (defaults to header row) |
 | `columnTypes` | (string \| object)[] | No | Column types with optional constraints (defaults to all `string`) |
-| `minRows` | number | No | Minimum row count (default: 0) |
-| `maxRows` | number | No | Maximum row count (default: unlimited) |
+| `minRows` | number | No | Minimum number of non-empty rows (default: 0) |
+| `maxRows` | number | No | Maximum number of non-empty rows (default: unlimited) |
+
+**Empty row handling:** Fully-empty rows (where every cell is empty or skipped) are
+silently dropped during normalization.
+They are never counted toward `minRows`/`maxRows` and do not appear in parsed output.
+A row with at least one non-empty cell is retained.
 
 **Column types:**
 
@@ -445,6 +450,11 @@ Structured tabular data with typed columns. Uses standard markdown table syntax.
 | `min` / `max` | `number`, `year`, `date` | Value bounds |
 | `integer` | `number` | Must be integer |
 
+**Row sparseness warning:** When a non-empty row has more than half of its cells empty
+(e.g., 1 of 3 filled, or 1 of 4 filled; even splits like 2 of 4 don’t trigger this), a
+validation warning is emitted.
+This helps catch cases where an agent produced sparse or incomplete data.
+
 **Sentinel values in cells:** Use `%SKIP%` or `%ABORT%` with optional reasons:
 
 ```markdown

package/docs/markform-spec.md

@@ -456,8 +456,13 @@ type.
 | `columnIds` | string[] | Yes | Array of snake_case column identifiers |
 | `columnLabels` | string[] | No | Array of display labels (backfilled from table header row if omitted) |
 | `columnTypes` | (string \| object)[] | No | Array of column types with optional constraints (defaults to all `'string'`) |
-| `minRows` | number | No | Minimum row count (default: 0) |
-| `maxRows` | number | No | Maximum row count (default: unlimited) |
+| `minRows` | number | No | Minimum number of non-empty rows (default: 0) |
+| `maxRows` | number | No | Maximum number of non-empty rows (default: unlimited) |
+
+**Empty row handling:** Fully-empty rows (where every cell is empty or skipped) are
+silently dropped during normalization.
+They are never counted toward `minRows`/`maxRows` and do not appear in parsed output.
+A row with at least one non-empty cell is retained.
 
 **Column types and validation:**
 
@@ -488,6 +493,11 @@ columnTypes=[{type: "string", required: true}, "number", "url"]
 | `max` | `number`, `year`, `date` | Maximum value |
 | `integer` | `number` | Value must be an integer |
 
+**Row sparseness warning:** When a non-empty row has more than half of its cells empty
+(e.g., 1 of 3 filled, or 1 of 4 filled; even splits like 2 of 4 don’t trigger this), a
+validation warning is emitted.
+This helps catch cases where an agent produced sparse or incomplete data.
+
 **Example with per-column constraints:**
 ```md
 {% field kind="table" id="priority_table" label="Ranked Insights"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",