markform 0.1.1 → 0.1.3

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

@@ -1,12 +1,19 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: "MF/0.1"
+  title: Simple Test Form
+  description: "Fully interactive demo - no LLM required. Demonstrates all Markform field types."
+  roles:
+    - user
+  role_instructions:
+    user: "Fill in all fields in this form."
 ---
 
 {% 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.
+A fully interactive form demonstrating all Markform v0.1 field types.
+Fill all fields using interactive prompts - no LLM API key needed.
 {% /description %}
 
 {% field-group id="basic_fields" title="Basic Fields" %}
@@ -33,10 +40,14 @@ test@example.com
 ```
 {% /number-field %}
 
-{% number-field id="score" label="Score" max=100 min=0 %}{% /number-field %}
+{% number-field id="score" label="Score" max=100 min=0 role="user" state="skipped" %}
+```value
+%SKIP% (Not needed for this test)
+```
+{% /number-field %}
 
 {% instructions ref="score" %}
-Assign a score between 0 and 100 based on form completeness.
+Enter a score between 0 and 100 (optional).
 {% /instructions %}
 
 {% /field-group %}
@@ -126,17 +137,25 @@ Add 1-5 unique reference URLs for sources or documentation.
 
 {% /field-group %}
 
-{% field-group id="optional_fields" title="Optional Fields (Agent)" %}
+{% field-group id="optional_fields" title="Optional Fields" %}
 
-{% string-field id="notes" label="Notes" %}{% /string-field %}
+{% string-field id="notes" label="Notes" role="user" state="skipped" %}
+```value
+%SKIP% (No notes required)
+```
+{% /string-field %}
 
 {% instructions ref="notes" %}
-Add any relevant notes or observations about this test form.
+Add any relevant notes or observations (optional).
 {% /instructions %}
 
-{% number-field id="optional_number" label="Optional Number" %}{% /number-field %}
+{% number-field id="optional_number" label="Optional Number" role="user" state="skipped" %}{% /number-field %}
 
-{% url-field id="related_url" label="Related URL" %}{% /url-field %}
+{% url-field id="related_url" label="Related URL" role="user" state="skipped" %}
+```value
+%SKIP% (No related URL needed)
+```
+{% /url-field %}
 
 {% instructions ref="related_url" %}
 Optionally add a URL to related documentation or resources.
@@ -144,4 +163,8 @@ Optionally add a URL to related documentation or resources.
 
 {% /field-group %}
 
+{% note id="note-summary" ref="simple_test" role="user" %}
+All required fields completed successfully. Optional fields skipped.
+{% /note %}
+
 {% /form %}

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

@@ -5,14 +5,13 @@ form:
 mock:
   completed_mock: simple-skipped-filled.form.md
 harness:
-  max_turns: 50
+  max_turns: 100
   max_patches_per_turn: 20
-  max_issues: 20
+  max_issues_per_turn: 10
   target_roles:
-    - user
-    - agent
+    - '*'
+  fill_mode: continue
 turns:
-  # Turn 1: Fill basic user fields (name, email, age)
   - turn: 1
     inspect:
       issues:
@@ -22,85 +21,52 @@ turns:
           message: Required field "Age" is empty
           severity: required
           priority: 1
-        - ref: email
+        - ref: categories
           scope: field
           reason: required_missing
-          message: Required field "Email" is empty
+          message: Required field "Categories" has no selections
           severity: required
           priority: 1
-        - ref: name
+        - ref: confirmations
           scope: field
           reason: required_missing
-          message: Required field "Name" is empty
+          message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
           severity: required
           priority: 1
-        - ref: tags
+        - ref: email
           scope: field
           reason: required_missing
-          message: Required field "Tags" is empty
+          message: Required field "Email" is empty
           severity: required
           priority: 1
-        - ref: website
+        - ref: name
           scope: field
           reason: required_missing
-          message: Required field "Website" is empty
+          message: Required field "Name" 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
+          reason: required_missing
           message: Required field "Priority" has no selection
           severity: required
-          priority: 2
+          priority: 1
+        - ref: tags
+          scope: field
+          reason: required_missing
+          message: Required field "Tags" is empty
+          severity: required
+          priority: 1
         - ref: tasks_multi
           scope: field
-          reason: validation_error
+          reason: required_missing
           message: All items in "Tasks (Multi Mode)" must be completed
           severity: required
-          priority: 2
+          priority: 1
         - 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
+          message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
           severity: required
           priority: 1
         - ref: website
@@ -109,88 +75,35 @@ turns:
           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_number
+          field_id: age
+          value: 25
         - 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
+        - op: set_checkboxes
+          field_id: confirmations
+          values:
+            backed_up: yes
+            notified: no
+        - op: set_string
+          field_id: email
+          value: test@example.com
+        - op: set_string
+          field_id: name
+          value: Test User
+        - op: set_single_select
+          field_id: priority
+          selected: high
+        - op: set_string_list
+          field_id: tags
           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:
+            - typescript
+            - testing
         - op: set_checkboxes
           field_id: tasks_multi
           values:
@@ -203,26 +116,72 @@ turns:
           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: set_url
+          field_id: website
+          value: https://test.example.com
+    after:
+      required_issue_count: 0
+      markdown_sha256: 62c9aad095c2ea5c2947c308c5e4b3c4cbc677a7e481971871c5091d5ca27b02
+      answered_field_count: 10
+      skipped_field_count: 0
+  - turn: 2
+    inspect:
+      issues:
+        - ref: notes
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          priority: 3
+        - ref: optional_number
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          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: 3
+    apply:
+      patches:
         - op: skip_field
           field_id: notes
-          reason: No notes required
+          role: agent
+          reason: No value in mock form
         - op: skip_field
           field_id: optional_number
+          role: agent
+          reason: No value in mock form
+        - op: set_url_list
+          field_id: references
+          items:
+            - https://docs.example.com
         - op: skip_field
           field_id: related_url
-          reason: No related URL needed
+          role: agent
+          reason: No value in mock form
+        - op: skip_field
+          field_id: score
+          role: agent
+          reason: No value in mock form
     after:
       required_issue_count: 0
-      markdown_sha256: 474cfdab3f98dbd0852e104ccc7f9dc28115de52975df5104629a9cc5dec5c67
+      markdown_sha256: 5ca306e53bdb0213b0558f6132c7a5af491c40c8765f25bc7047efa0478b7876
       answered_field_count: 11
       skipped_field_count: 4
 final:

package/examples/simple/simple.form.md

@@ -1,19 +1,19 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: MF/0.1
+  title: Simple Test Form
+  description: "Fully interactive demo - no LLM required. Demonstrates all Markform field types."
   roles:
     - user
-    - agent
   role_instructions:
-    user: "Fill in the required fields in this form."
-    agent: "Fill in the optional fields with reasonable test values."
+    user: "Fill in all fields in this form."
 ---
 
 {% 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.
+A fully interactive form demonstrating all Markform v0.1 field types.
+Fill all fields using interactive prompts - no LLM API key needed.
 {% /description %}
 
 {% field-group id="basic_fields" title="Basic Fields" %}
@@ -28,10 +28,10 @@ Enter your full name (2-50 characters).
 
 {% number-field id="age" label="Age" role="user" required=true min=0 max=150 integer=true %}{% /number-field %}
 
-{% number-field id="score" label="Score" role="agent" min=0.0 max=100.0 %}{% /number-field %}
+{% number-field id="score" label="Score" role="user" min=0.0 max=100.0 %}{% /number-field %}
 
 {% instructions ref="score" %}
-Assign a score between 0 and 100 based on form completeness.
+Enter a score between 0 and 100 (optional).
 {% /instructions %}
 
 {% /field-group %}
@@ -108,17 +108,17 @@ Add 1-5 unique reference URLs for sources or documentation.
 
 {% /field-group %}
 
-{% field-group id="optional_fields" title="Optional Fields (Agent)" %}
+{% field-group id="optional_fields" title="Optional Fields" %}
 
-{% string-field id="notes" label="Notes" role="agent" %}{% /string-field %}
+{% string-field id="notes" label="Notes" role="user" %}{% /string-field %}
 
 {% instructions ref="notes" %}
-Add any relevant notes or observations about this test form.
+Add any relevant notes or observations (optional).
 {% /instructions %}
 
-{% number-field id="optional_number" label="Optional Number" role="agent" %}{% /number-field %}
+{% number-field id="optional_number" label="Optional Number" role="user" %}{% /number-field %}
 
-{% url-field id="related_url" label="Related URL" role="agent" %}{% /url-field %}
+{% url-field id="related_url" label="Related URL" role="user" %}{% /url-field %}
 
 {% instructions ref="related_url" %}
 Optionally add a URL to related documentation or resources.

package/examples/simple/simple.session.yaml

@@ -5,12 +5,12 @@ form:
 mock:
   completed_mock: simple-mock-filled.form.md
 harness:
-  max_turns: 50
+  max_turns: 100
   max_patches_per_turn: 20
-  max_issues: 20
+  max_issues_per_turn: 10
   target_roles:
-    - user
-    - agent
+    - '*'
+  fill_mode: continue
 turns:
   - turn: 1
     inspect:
@@ -21,90 +21,60 @@ turns:
           message: Required field "Age" is empty
           severity: required
           priority: 1
-        - ref: email
+        - ref: categories
           scope: field
           reason: required_missing
-          message: Required field "Email" is empty
+          message: Required field "Categories" has no selections
           severity: required
           priority: 1
-        - ref: name
+        - ref: confirmations
           scope: field
           reason: required_missing
-          message: Required field "Name" is empty
+          message: All items in "Confirmations (Explicit Mode)" must be answered (2 unfilled)
           severity: required
           priority: 1
-        - ref: tags
+        - ref: email
           scope: field
           reason: required_missing
-          message: Required field "Tags" is empty
+          message: Required field "Email" is empty
           severity: required
           priority: 1
-        - ref: website
+        - ref: name
           scope: field
           reason: required_missing
-          message: Required field "Website" is empty
+          message: Required field "Name" 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
+          reason: required_missing
           message: Required field "Priority" has no selection
           severity: required
-          priority: 2
+          priority: 1
+        - ref: tags
+          scope: field
+          reason: required_missing
+          message: Required field "Tags" is empty
+          severity: required
+          priority: 1
         - ref: tasks_multi
           scope: field
-          reason: validation_error
+          reason: required_missing
           message: All items in "Tasks (Multi Mode)" must be completed
           severity: required
-          priority: 2
+          priority: 1
         - ref: tasks_simple
           scope: field
-          reason: validation_error
+          reason: required_missing
           message: All items in "Agreements (Simple Mode)" must be checked (2 unchecked)
           severity: required
-          priority: 2
-        - ref: notes
-          scope: field
-          reason: optional_empty
-          message: Optional field has no value
-          severity: recommended
-          priority: 3
-        - ref: optional_number
-          scope: field
-          reason: optional_empty
-          message: Optional field has no value
-          severity: recommended
-          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
+          priority: 1
+        - ref: website
           scope: field
-          reason: optional_empty
-          message: Optional field has no value
-          severity: recommended
-          priority: 3
+          reason: required_missing
+          message: Required field "Website" is empty
+          severity: required
+          priority: 1
     apply:
       patches:
         - op: set_number
@@ -150,27 +120,68 @@ turns:
         - op: set_url
           field_id: website
           value: https://alice.dev
+    after:
+      required_issue_count: 0
+      markdown_sha256: 82ebecc97db1321838d47491c23ab951525e1fa5fd14590cd306565faa00b05f
+      answered_field_count: 10
+      skipped_field_count: 0
+  - turn: 2
+    inspect:
+      issues:
+        - ref: notes
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          priority: 3
+        - ref: optional_number
+          scope: field
+          reason: optional_empty
+          message: Optional field has no value
+          severity: recommended
+          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: 3
+    apply:
+      patches:
+        - op: set_string
+          field_id: notes
+          value: This is a test note.
+        - op: skip_field
+          field_id: optional_number
+          role: agent
+          reason: No value in mock form
         - 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: skip_field
-          field_id: optional_number
-          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
+        - op: set_number
+          field_id: score
+          value: 87.5
     after:
       required_issue_count: 0
-      markdown_sha256: f2eaf91bd0cefccfca4ae116683626ab9735e00274095373174045527344a8e6
+      markdown_sha256: 09ad2c0b12f3b27505ea3fbcfd35e025e94d906c1cb9701322b793b233db54dd
       answered_field_count: 14
       skipped_field_count: 1
 final: