markform 0.1.0 → 0.1.1

package/examples/simple/simple-mock-filled.form.md

@@ -114,6 +114,32 @@ Answer yes or no for each confirmation. All must be explicitly answered.
 
 {% /field-group %}
 
+{% field-group id="url_fields" title="URL Fields" %}
+
+{% url-field id="website" label="Website" role="user" required=true %}
+```value
+https://alice.dev
+```
+{% /url-field %}
+
+{% instructions ref="website" %}
+Enter your website URL (must be http or https).
+{% /instructions %}
+
+{% url-list id="references" label="References" role="user" minItems=1 maxItems=5 uniqueItems=true %}
+```value
+https://docs.example.com/guide
+https://github.com/example/project
+https://medium.com/article-about-forms
+```
+{% /url-list %}
+
+{% instructions ref="references" %}
+Add 1-5 unique reference URLs for sources or documentation.
+{% /instructions %}
+
+{% /field-group %}
+
 {% field-group id="optional_fields" title="Optional Fields (Agent)" %}
 
 {% string-field id="notes" label="Notes" role="agent" %}
@@ -128,6 +154,16 @@ Add any relevant notes or observations about this test form.
 
 {% number-field id="optional_number" label="Optional Number" role="agent" %}{% /number-field %}
 
+{% url-field id="related_url" label="Related URL" role="agent" %}
+```value
+https://markform.dev/docs
+```
+{% /url-field %}
+
+{% instructions ref="related_url" %}
+Optionally add a URL to related documentation or resources.
+{% /instructions %}
+
 {% /field-group %}
 
 {% /form %}

package/examples/simple/simple-skipped-filled.form.md

@@ -0,0 +1,147 @@
+---
+markform:
+  markform_version: "0.1.0"
+---
+
+{% form id="simple_test" title="Simple Test Form" %}
+
+{% description ref="simple_test" %}
+A form demonstrating user and agent roles. User fills required fields,agent fills optional fields. Demonstrates all Markform v0.1 field types.
+{% /description %}
+
+{% field-group id="basic_fields" title="Basic Fields" %}
+
+{% string-field id="name" label="Name" maxLength=50 minLength=2 required=true role="user" %}
+```value
+Test User
+```
+{% /string-field %}
+
+{% instructions ref="name" %}
+Enter your full name (2-50 characters).
+{% /instructions %}
+
+{% string-field id="email" label="Email" pattern="^[^@]+@[^@]+\\.[^@]+$" required=true role="user" %}
+```value
+test@example.com
+```
+{% /string-field %}
+
+{% number-field id="age" integer=true label="Age" max=150 min=0 required=true role="user" %}
+```value
+25
+```
+{% /number-field %}
+
+{% number-field id="score" label="Score" max=100 min=0 %}{% /number-field %}
+
+{% instructions ref="score" %}
+Assign a score between 0 and 100 based on form completeness.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="list_fields" title="List Fields" %}
+
+{% string-list id="tags" itemMinLength=2 label="Tags" maxItems=5 minItems=1 required=true role="user" uniqueItems=true %}
+```value
+typescript
+testing
+```
+{% /string-list %}
+
+{% instructions ref="tags" %}
+Add 1-5 unique tags (each at least 2 characters).
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="selection_fields" title="Selection Fields" %}
+
+{% single-select id="priority" label="Priority" required=true role="user" %}
+- [ ] Low {% #low %}
+- [ ] Medium {% #medium %}
+- [x] High {% #high %}
+{% /single-select %}
+
+{% multi-select id="categories" label="Categories" maxSelections=3 minSelections=1 required=true role="user" %}
+- [x] Frontend {% #frontend %}
+- [x] Backend {% #backend %}
+- [ ] Database {% #database %}
+- [ ] DevOps {% #devops %}
+{% /multi-select %}
+
+{% /field-group %}
+
+{% field-group id="checkbox_fields" title="Checkbox Fields" %}
+
+{% checkboxes id="tasks_multi" label="Tasks (Multi Mode)" required=true role="user" %}
+- [x] Research {% #research %}
+- [x] Design {% #design %}
+- [x] Implement {% #implement %}
+- [-] Test {% #test %}
+{% /checkboxes %}
+
+{% instructions ref="tasks_multi" %}
+Track task progress. All must reach done or na state to complete.
+{% /instructions %}
+
+{% checkboxes checkboxMode="simple" id="tasks_simple" label="Agreements (Simple Mode)" required=true role="user" %}
+- [x] I have read the guidelines {% #read_guidelines %}
+- [x] I agree to the terms {% #agree_terms %}
+{% /checkboxes %}
+
+{% checkboxes checkboxMode="explicit" id="confirmations" label="Confirmations (Explicit Mode)" required=true role="user" %}
+- [y] Data has been backed up {% #backed_up %}
+- [n] Stakeholders notified {% #notified %}
+{% /checkboxes %}
+
+{% instructions ref="confirmations" %}
+Answer yes or no for each confirmation. All must be explicitly answered.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="url_fields" title="URL Fields" %}
+
+{% url-field id="website" label="Website" required=true role="user" %}
+```value
+https://test.example.com
+```
+{% /url-field %}
+
+{% instructions ref="website" %}
+Enter your website URL (must be http or https).
+{% /instructions %}
+
+{% url-list id="references" label="References" maxItems=5 minItems=1 role="user" uniqueItems=true %}
+```value
+https://docs.example.com
+```
+{% /url-list %}
+
+{% instructions ref="references" %}
+Add 1-5 unique reference URLs for sources or documentation.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="optional_fields" title="Optional Fields (Agent)" %}
+
+{% string-field id="notes" label="Notes" %}{% /string-field %}
+
+{% instructions ref="notes" %}
+Add any relevant notes or observations about this test form.
+{% /instructions %}
+
+{% number-field id="optional_number" label="Optional Number" %}{% /number-field %}
+
+{% url-field id="related_url" label="Related URL" %}{% /url-field %}
+
+{% instructions ref="related_url" %}
+Optionally add a URL to related documentation or resources.
+{% /instructions %}
+
+{% /field-group %}
+
+{% /form %}

package/examples/simple/simple-with-skips.session.yaml

@@ -0,0 +1,230 @@
+session_version: 0.1.0
+mode: mock
+form:
+  path: simple.form.md
+mock:
+  completed_mock: simple-skipped-filled.form.md
+harness:
+  max_turns: 50
+  max_patches_per_turn: 20
+  max_issues: 20
+  target_roles:
+    - user
+    - agent
+turns:
+  # Turn 1: Fill basic user fields (name, email, age)
+  - turn: 1
+    inspect:
+      issues:
+        - ref: age
+          scope: field
+          reason: required_missing
+          message: Required field "Age" is empty
+          severity: required
+          priority: 1
+        - ref: email
+          scope: field
+          reason: required_missing
+          message: Required field "Email" is empty
+          severity: required
+          priority: 1
+        - ref: name
+          scope: field
+          reason: required_missing
+          message: Required field "Name" is empty
+          severity: required
+          priority: 1
+        - ref: tags
+          scope: field
+          reason: required_missing
+          message: Required field "Tags" is empty
+          severity: required
+          priority: 1
+        - ref: website
+          scope: field
+          reason: required_missing
+          message: Required field "Website" is empty
+          severity: required
+          priority: 1
+        - ref: categories
+          scope: field
+          reason: validation_error
+          message: Required field "Categories" has no selections
+          severity: required
+          priority: 2
+        - ref: confirmations
+          scope: field
+          reason: validation_error
+          message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
+          severity: required
+          priority: 2
+        - ref: priority
+          scope: field
+          reason: validation_error
+          message: Required field "Priority" has no selection
+          severity: required
+          priority: 2
+        - ref: tasks_multi
+          scope: field
+          reason: validation_error
+          message: All items in "Tasks (Multi Mode)" must be completed
+          severity: required
+          priority: 2
+        - ref: tasks_simple
+          scope: field
+          reason: validation_error
+          message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
+          severity: required
+          priority: 2
+    apply:
+      patches:
+        - op: set_string
+          field_id: name
+          value: Test User
+        - op: set_string
+          field_id: email
+          value: test@example.com
+        - op: set_number
+          field_id: age
+          value: 25
+    after:
+      required_issue_count: 7
+      markdown_sha256: be317980230ed614221e949a31c950d69e170470882a2e69228044b80392d422
+      answered_field_count: 3
+      skipped_field_count: 0
+
+  # Turn 2: Fill selection fields (tags, priority, categories, website, references)
+  - turn: 2
+    inspect:
+      issues:
+        - ref: tags
+          scope: field
+          reason: required_missing
+          message: Required field "Tags" is empty
+          severity: required
+          priority: 1
+        - ref: website
+          scope: field
+          reason: required_missing
+          message: Required field "Website" is empty
+          severity: required
+          priority: 1
+        - ref: categories
+          scope: field
+          reason: validation_error
+          message: Required field "Categories" has no selections
+          severity: required
+          priority: 2
+        - ref: confirmations
+          scope: field
+          reason: validation_error
+          message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
+          severity: required
+          priority: 2
+        - ref: priority
+          scope: field
+          reason: validation_error
+          message: Required field "Priority" has no selection
+          severity: required
+          priority: 2
+        - ref: tasks_multi
+          scope: field
+          reason: validation_error
+          message: All items in "Tasks (Multi Mode)" must be completed
+          severity: required
+          priority: 2
+        - ref: tasks_simple
+          scope: field
+          reason: validation_error
+          message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
+          severity: required
+          priority: 2
+    apply:
+      patches:
+        - op: set_string_list
+          field_id: tags
+          items:
+            - typescript
+            - testing
+        - op: set_single_select
+          field_id: priority
+          selected: high
+        - op: set_multi_select
+          field_id: categories
+          selected:
+            - frontend
+            - backend
+        - op: set_url
+          field_id: website
+          value: https://test.example.com
+        - op: set_url_list
+          field_id: references
+          items:
+            - https://docs.example.com
+    after:
+      required_issue_count: 3
+      markdown_sha256: f3b491aea22dc2da552c3cbb22aad61a13e90383e2a73e3758def7127c739614
+      answered_field_count: 8
+      skipped_field_count: 0
+
+  # Turn 3: Fill checkboxes + SKIP optional fields (demonstrates skip_field)
+  - turn: 3
+    inspect:
+      issues:
+        - ref: confirmations
+          scope: field
+          reason: validation_error
+          message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
+          severity: required
+          priority: 2
+        - ref: tasks_multi
+          scope: field
+          reason: validation_error
+          message: All items in "Tasks (Multi Mode)" must be completed
+          severity: required
+          priority: 2
+        - ref: tasks_simple
+          scope: field
+          reason: validation_error
+          message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
+          severity: required
+          priority: 2
+    apply:
+      patches:
+        - op: set_checkboxes
+          field_id: tasks_multi
+          values:
+            research: done
+            design: done
+            implement: done
+            test: na
+        - op: set_checkboxes
+          field_id: tasks_simple
+          values:
+            read_guidelines: done
+            agree_terms: done
+        - op: set_checkboxes
+          field_id: confirmations
+          values:
+            backed_up: yes
+            notified: no
+        # Skip optional fields explicitly
+        - op: skip_field
+          field_id: score
+          reason: Not needed for this test
+        - op: skip_field
+          field_id: notes
+          reason: No notes required
+        - op: skip_field
+          field_id: optional_number
+        - op: skip_field
+          field_id: related_url
+          reason: No related URL needed
+    after:
+      required_issue_count: 0
+      markdown_sha256: 474cfdab3f98dbd0852e104ccc7f9dc28115de52975df5104629a9cc5dec5c67
+      answered_field_count: 11
+      skipped_field_count: 4
+final:
+  expect_complete: true
+  expected_completed_form: simple-skipped-filled.form.md

package/examples/simple/simple.form.md

@@ -92,6 +92,22 @@ Answer yes or no for each confirmation. All must be explicitly answered.
 
 {% /field-group %}
 
+{% field-group id="url_fields" title="URL Fields" %}
+
+{% url-field id="website" label="Website" role="user" required=true %}{% /url-field %}
+
+{% instructions ref="website" %}
+Enter your website URL (must be http or https).
+{% /instructions %}
+
+{% url-list id="references" label="References" role="user" minItems=1 maxItems=5 uniqueItems=true %}{% /url-list %}
+
+{% instructions ref="references" %}
+Add 1-5 unique reference URLs for sources or documentation.
+{% /instructions %}
+
+{% /field-group %}
+
 {% field-group id="optional_fields" title="Optional Fields (Agent)" %}
 
 {% string-field id="notes" label="Notes" role="agent" %}{% /string-field %}
@@ -102,6 +118,12 @@ Add any relevant notes or observations about this test form.
 
 {% number-field id="optional_number" label="Optional Number" role="agent" %}{% /number-field %}
 
+{% url-field id="related_url" label="Related URL" role="agent" %}{% /url-field %}
+
+{% instructions ref="related_url" %}
+Optionally add a URL to related documentation or resources.
+{% /instructions %}
+
 {% /field-group %}
 
 {% /form %}

package/examples/simple/simple.session.yaml

@@ -21,6 +21,30 @@ turns:
           message: Required field "Age" is empty
           severity: required
           priority: 1
+        - ref: email
+          scope: field
+          reason: required_missing
+          message: Required field "Email" is empty
+          severity: required
+          priority: 1
+        - ref: name
+          scope: field
+          reason: required_missing
+          message: Required field "Name" is empty
+          severity: required
+          priority: 1
+        - ref: tags
+          scope: field
+          reason: required_missing
+          message: Required field "Tags" is empty
+          severity: required
+          priority: 1
+        - ref: website
+          scope: field
+          reason: required_missing
+          message: Required field "Website" is empty
+          severity: required
+          priority: 1
         - ref: categories
           scope: field
           reason: validation_error
@@ -32,61 +56,55 @@ turns:
           reason: validation_error
           message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
           severity: required
-          priority: 3
-        - ref: email
-          scope: field
-          reason: required_missing
-          message: Required field "Email" is empty
-          severity: required
-          priority: 4
-        - ref: name
-          scope: field
-          reason: required_missing
-          message: Required field "Name" is empty
-          severity: required
-          priority: 5
+          priority: 2
         - ref: priority
           scope: field
           reason: validation_error
           message: Required field "Priority" has no selection
           severity: required
-          priority: 6
-        - ref: tags
-          scope: field
-          reason: required_missing
-          message: Required field "Tags" is empty
-          severity: required
-          priority: 7
+          priority: 2
         - ref: tasks_multi
           scope: field
           reason: validation_error
           message: All items in "Tasks (Multi Mode)" must be completed
           severity: required
-          priority: 8
+          priority: 2
         - ref: tasks_simple
           scope: field
           reason: validation_error
           message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
           severity: required
-          priority: 9
+          priority: 2
         - ref: notes
           scope: field
           reason: optional_empty
           message: Optional field has no value
           severity: recommended
-          priority: 10
+          priority: 3
         - ref: optional_number
           scope: field
           reason: optional_empty
           message: Optional field has no value
           severity: recommended
-          priority: 11
+          priority: 3
+        - ref: references
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          priority: 3
+        - ref: related_url
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          priority: 3
         - ref: score
           scope: field
           reason: optional_empty
           message: Optional field has no value
           severity: recommended
-          priority: 12
+          priority: 3
     apply:
       patches:
         - op: set_number
@@ -129,18 +147,32 @@ turns:
           values:
             read_guidelines: done
             agree_terms: done
+        - op: set_url
+          field_id: website
+          value: https://alice.dev
+        - op: set_url_list
+          field_id: references
+          items:
+            - https://docs.example.com/guide
+            - https://github.com/example/project
+            - https://medium.com/article-about-forms
         - op: set_string
           field_id: notes
           value: This is a test note.
-        - op: set_number
+        - op: skip_field
           field_id: optional_number
-          value: null
+          reason: Optional field not needed for this test
         - op: set_number
           field_id: score
           value: 87.5
+        - op: set_url
+          field_id: related_url
+          value: https://markform.dev/docs
     after:
       required_issue_count: 0
-      markdown_sha256: d633b7eaeb1be08374fd829a9865d476bf16c49292261ab3749b66855f61cdea
+      markdown_sha256: f2eaf91bd0cefccfca4ae116683626ab9735e00274095373174045527344a8e6
+      answered_field_count: 14
+      skipped_field_count: 1
 final:
   expect_complete: true
   expected_completed_form: simple-mock-filled.form.md