markform 0.1.6 → 0.1.8

package/examples/simple/simple.schema.json

@@ -0,0 +1,374 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "simple_test",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "title": "Name",
+      "minLength": 2,
+      "maxLength": 50,
+      "x-markform": {
+        "role": "user",
+        "group": "basic_fields",
+        "placeholder": "Enter your name",
+        "examples": ["John Smith", "Jane Doe"]
+      }
+    },
+    "email": {
+      "type": "string",
+      "title": "Email",
+      "pattern": "^[^@]+@[^@]+\\.[^@]+$",
+      "x-markform": {
+        "role": "user",
+        "group": "basic_fields",
+        "placeholder": "email@example.com",
+        "examples": ["alice@company.com", "bob@example.org"]
+      }
+    },
+    "age": {
+      "type": "integer",
+      "title": "Age",
+      "minimum": 0,
+      "maximum": 150,
+      "x-markform": {
+        "role": "user",
+        "group": "basic_fields",
+        "placeholder": "25",
+        "examples": ["18", "30", "45"]
+      }
+    },
+    "score": {
+      "type": "number",
+      "title": "Score",
+      "minimum": 0,
+      "maximum": 100,
+      "x-markform": {
+        "role": "user",
+        "group": "basic_fields",
+        "placeholder": "85.5",
+        "examples": ["75.0", "90.5", "100.0"]
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 2
+      },
+      "title": "Tags",
+      "minItems": 1,
+      "maxItems": 5,
+      "uniqueItems": true,
+      "x-markform": {
+        "role": "user",
+        "group": "list_fields"
+      }
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["low", "medium", "high"],
+      "title": "Priority",
+      "x-markform": {
+        "role": "user",
+        "group": "selection_fields"
+      }
+    },
+    "categories": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["frontend", "backend", "database", "devops"]
+      },
+      "title": "Categories",
+      "minItems": 1,
+      "maxItems": 3,
+      "x-markform": {
+        "role": "user",
+        "group": "selection_fields"
+      }
+    },
+    "tasks_multi": {
+      "type": "object",
+      "properties": {
+        "research": {
+          "type": "string",
+          "enum": ["todo", "done", "incomplete", "active", "na"],
+          "title": "Research"
+        },
+        "design": {
+          "type": "string",
+          "enum": ["todo", "done", "incomplete", "active", "na"],
+          "title": "Design"
+        },
+        "implement": {
+          "type": "string",
+          "enum": ["todo", "done", "incomplete", "active", "na"],
+          "title": "Implement"
+        },
+        "test": {
+          "type": "string",
+          "enum": ["todo", "done", "incomplete", "active", "na"],
+          "title": "Test"
+        }
+      },
+      "title": "Tasks (Multi Mode)",
+      "x-markform": {
+        "role": "user",
+        "group": "checkbox_fields",
+        "checkboxMode": "multi"
+      }
+    },
+    "tasks_simple": {
+      "type": "object",
+      "properties": {
+        "read_guidelines": {
+          "type": "string",
+          "enum": ["todo", "done"],
+          "title": "I have read the guidelines"
+        },
+        "agree_terms": {
+          "type": "string",
+          "enum": ["todo", "done"],
+          "title": "I agree to the terms"
+        }
+      },
+      "title": "Agreements (Simple Mode)",
+      "x-markform": {
+        "role": "user",
+        "group": "checkbox_fields",
+        "checkboxMode": "simple"
+      }
+    },
+    "confirmations": {
+      "type": "object",
+      "properties": {
+        "backed_up": {
+          "type": "string",
+          "enum": ["unfilled", "yes", "no"],
+          "title": "Data has been backed up"
+        },
+        "notified": {
+          "type": "string",
+          "enum": ["unfilled", "yes", "no"],
+          "title": "Stakeholders notified"
+        }
+      },
+      "title": "Confirmations (Explicit Mode)",
+      "x-markform": {
+        "role": "user",
+        "group": "checkbox_fields",
+        "checkboxMode": "explicit"
+      }
+    },
+    "website": {
+      "type": "string",
+      "format": "uri",
+      "title": "Website",
+      "x-markform": {
+        "role": "user",
+        "group": "url_fields",
+        "placeholder": "https://example.com",
+        "examples": ["https://github.com/user/repo", "https://company.com"]
+      }
+    },
+    "references": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "format": "uri"
+      },
+      "title": "References",
+      "minItems": 1,
+      "maxItems": 5,
+      "uniqueItems": true,
+      "x-markform": {
+        "role": "user",
+        "group": "url_fields",
+        "placeholder": "https://docs.example.com",
+        "examples": ["https://wikipedia.org/wiki/Example", "https://docs.github.com/en"]
+      }
+    },
+    "event_date": {
+      "type": "string",
+      "format": "date",
+      "title": "Event Date",
+      "formatMinimum": "2020-01-01",
+      "formatMaximum": "2030-12-31",
+      "x-markform": {
+        "role": "user",
+        "group": "date_fields",
+        "minDate": "2020-01-01",
+        "maxDate": "2030-12-31"
+      }
+    },
+    "founded_year": {
+      "type": "integer",
+      "title": "Founded Year",
+      "minimum": 1900,
+      "maximum": 2030,
+      "x-markform": {
+        "role": "user",
+        "group": "date_fields"
+      }
+    },
+    "team_members": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "title": "Name",
+            "type": "string"
+          },
+          "role": {
+            "title": "Role",
+            "type": "string"
+          },
+          "start_date": {
+            "title": "Start Date",
+            "type": "string",
+            "format": "date"
+          }
+        },
+        "required": ["name"]
+      },
+      "title": "Team Members",
+      "minItems": 0,
+      "maxItems": 5,
+      "x-markform": {
+        "role": "user",
+        "group": "table_fields"
+      }
+    },
+    "project_tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "task": {
+            "title": "Task",
+            "type": "string"
+          },
+          "estimate_hrs": {
+            "title": "Estimate (hrs)",
+            "type": "number"
+          },
+          "link": {
+            "title": "Link",
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "required": ["task"]
+      },
+      "title": "Project Tasks",
+      "minItems": 0,
+      "maxItems": 10,
+      "x-markform": {
+        "role": "user",
+        "group": "table_fields"
+      }
+    },
+    "notes": {
+      "type": "string",
+      "title": "Notes",
+      "x-markform": {
+        "role": "user",
+        "group": "optional_fields"
+      }
+    },
+    "optional_number": {
+      "type": "number",
+      "title": "Optional Number",
+      "x-markform": {
+        "role": "user",
+        "group": "optional_fields"
+      }
+    },
+    "related_url": {
+      "type": "string",
+      "format": "uri",
+      "title": "Related URL",
+      "x-markform": {
+        "role": "user",
+        "group": "optional_fields"
+      }
+    },
+    "optional_date": {
+      "type": "string",
+      "format": "date",
+      "title": "Optional Date",
+      "x-markform": {
+        "role": "user",
+        "group": "optional_fields"
+      }
+    },
+    "optional_year": {
+      "type": "integer",
+      "title": "Optional Year",
+      "x-markform": {
+        "role": "user",
+        "group": "optional_fields"
+      }
+    }
+  },
+  "title": "Simple Test Form",
+  "description": "A fully interactive form demonstrating all Markform v0.1 field types.\nFill all fields using interactive prompts - no LLM API key needed.",
+  "required": [
+    "name",
+    "email",
+    "age",
+    "tags",
+    "priority",
+    "categories",
+    "tasks_multi",
+    "tasks_simple",
+    "confirmations",
+    "website",
+    "event_date",
+    "founded_year"
+  ],
+  "x-markform": {
+    "spec": "MF/0.1",
+    "roles": ["user", "agent"],
+    "roleInstructions": {
+      "user": "Fill in the fields you have direct knowledge of.",
+      "agent": "Complete the remaining fields based on the provided context."
+    },
+    "groups": [
+      {
+        "id": "basic_fields",
+        "title": "Basic Fields"
+      },
+      {
+        "id": "list_fields",
+        "title": "List Fields"
+      },
+      {
+        "id": "selection_fields",
+        "title": "Selection Fields"
+      },
+      {
+        "id": "checkbox_fields",
+        "title": "Checkbox Fields"
+      },
+      {
+        "id": "url_fields",
+        "title": "URL Fields"
+      },
+      {
+        "id": "date_fields",
+        "title": "Date and Year Fields"
+      },
+      {
+        "id": "table_fields",
+        "title": "Table Fields"
+      },
+      {
+        "id": "optional_fields",
+        "title": "Optional Fields"
+      }
+    ]
+  }
+}

package/examples/simple/simple.session.yaml

@@ -120,7 +120,7 @@ turns:
             test: na
     after:
       required_issue_count: 2
-      markdown_sha256: e2bc5c169fc2650828ad870267eeb83c2ed4a219afb38570c5004e753260290d
+      markdown_sha256: e6cb237f40f14343b6616099b1ab4cededabc99e9434c2e72ea600b4473d0048
       answered_field_count: 10
       skipped_field_count: 0
   - turn: 2
@@ -229,7 +229,7 @@ turns:
           value: 87.5
     after:
       required_issue_count: 0
-      markdown_sha256: e508fd266c842961a1fae7cd203be0ab529c71c8c3565d76ca766256ebe4fb44
+      markdown_sha256: 54b5d3fe131f5dd0179a116bf7d25f356ada1eb5cec0df2223a2716e145801ee
       answered_field_count: 16
       skipped_field_count: 4
   - turn: 3
@@ -254,7 +254,7 @@ turns:
               start_date: 2023-06-01
     after:
       required_issue_count: 0
-      markdown_sha256: 0835d5fb6a05a52885e3200fa55584981e73dcd801c05405ddc341d60bdc8b91
+      markdown_sha256: b59a771c156f4391e4fcb352a98cea568aac90660a8b264f8de8390cafb0bc02
       answered_field_count: 17
       skipped_field_count: 4
 final:

package/examples/startup-deep-research/startup-deep-research.form.md

@@ -3,6 +3,7 @@ markform:
   spec: MF/0.1
   title: Startup Deep Research
   description: Comprehensive startup intelligence gathering with company info, founders, funding, competitors, social media, and community presence.
+  run_mode: research
   roles:
     - user
     - agent

package/examples/startup-research/startup-research.form.md

@@ -1,6 +1,7 @@
 ---
 markform:
   spec: MF/0.1
+  run_mode: research
   roles:
     - user
     - agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
@@ -58,27 +58,29 @@
     "@ai-sdk/deepseek": "^2.0.1",
     "@ai-sdk/google": "^3.0.1",
     "@ai-sdk/openai": "^3.0.1",
-    "@ai-sdk/xai": "^3.0.1",
-    "@clack/prompts": "^0.9.1",
+    "@ai-sdk/xai": "^3.0.2",
+    "@clack/prompts": "^0.11.0",
     "@markdoc/markdoc": "^0.5.4",
     "ai": "^6.0.3",
     "atomically": "^2.1.0",
-    "commander": "^13.1.0",
+    "commander": "^14.0.2",
     "dotenv": "^17.2.3",
     "jiti": "^2.6.1",
     "js-sha256": "^0.11.1",
     "picocolors": "^1.1.1",
     "yaml": "^2.8.2",
-    "zod": "^3.25.76"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.1",
-    "@types/node": "^24.10.4",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/node": "^22.15.30",
+    "@vitest/coverage-v8": "^4.0.16",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
     "publint": "^0.3.16",
-    "tsdown": "^0.16.8",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.16"
   },
   "scripts": {
     "copy-docs": "cp ../../README.md . && mkdir -p docs && cp ../../docs/markform-spec.md docs/ && cp ../../docs/markform-reference.md docs/ && cp ../../docs/markform-apis.md docs/",