markform 0.1.7 → 0.1.8

package/examples/rejection-test/rejection-test-mock-filled.report.md

@@ -0,0 +1,15 @@
+# Rejection Test Form
+
+A form to test patch rejection scenarios - verifies that type mismatch
+errors are properly recorded and recovery works.
+
+## Test Fields
+
+**Ratings:**
+| Source | Score | Votes |
+| --- | --- | --- |
+| IMDB | 85 | 12500 |
+| Rotten Tomatoes | 92 | 450 |
+
+**Title:**
+Test Movie

package/examples/rejection-test/rejection-test-mock-filled.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "rejection_test",
+  "type": "object",
+  "properties": {
+    "ratings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "title": "Source",
+            "type": "string"
+          },
+          "score": {
+            "title": "Score",
+            "type": "number"
+          },
+          "votes": {
+            "title": "Votes",
+            "type": "number"
+          }
+        }
+      },
+      "title": "Ratings",
+      "minItems": 1,
+      "maxItems": 5,
+      "x-markform": {
+        "role": "agent",
+        "group": "fields"
+      }
+    },
+    "title": {
+      "type": "string",
+      "title": "Title",
+      "x-markform": {
+        "role": "agent",
+        "group": "fields"
+      }
+    }
+  },
+  "title": "Rejection Test Form",
+  "description": "A form to test patch rejection scenarios - verifies that type mismatch\nerrors are properly recorded and recovery works.",
+  "required": ["ratings", "title"],
+  "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": "fields",
+        "title": "Test Fields"
+      }
+    ]
+  }
+}

package/examples/rejection-test/rejection-test-mock-filled.yml

@@ -0,0 +1,13 @@
+values:
+  ratings:
+    state: answered
+    value:
+      - source: IMDB
+        score: 85
+        votes: 12500
+      - source: Rotten Tomatoes
+        score: 92
+        votes: 450
+  title:
+    state: answered
+    value: Test Movie

package/examples/rejection-test/rejection-test.form.md

@@ -0,0 +1,35 @@
+---
+markform:
+  spec: MF/0.1
+  title: Rejection Test Form
+  description: "Tests type mismatch rejection and recovery behavior"
+  roles:
+    - agent
+---
+
+{% form id="rejection_test" title="Rejection Test Form" %}
+
+{% description ref="rejection_test" %}
+A form to test patch rejection scenarios - verifies that type mismatch
+errors are properly recorded and recovery works.
+{% /description %}
+
+{% group id="fields" title="Test Fields" %}
+
+{% field kind="table" id="ratings" label="Ratings" required=true minRows=1 maxRows=5
+   columnIds=["source", "score", "votes"]
+   columnLabels=["Source", "Score", "Votes"]
+   columnTypes=["string", "number", "number"] %}
+| Source | Score | Votes |
+|--------|-------|-------|
+{% /field %}
+
+{% instructions ref="ratings" %}
+Enter rating data with source name, score (0-100), and vote count.
+{% /instructions %}
+
+{% field kind="string" id="title" label="Title" required=true %}{% /field %}
+
+{% /group %}
+
+{% /form %}

package/examples/rejection-test/rejection-test.session.yaml

@@ -0,0 +1,88 @@
+session_version: 0.1.0
+mode: mock
+form:
+  path: rejection-test.form.md
+mock:
+  completed_mock: rejection-test-mock-filled.form.md
+harness:
+  max_turns: 100
+  max_patches_per_turn: 20
+  max_issues_per_turn: 10
+  target_roles:
+    - '*'
+  fill_mode: continue
+turns:
+  - turn: 1
+    inspect:
+      issues:
+        - ref: ratings
+          scope: field
+          reason: required_missing
+          message: Required field "Ratings" is empty
+          severity: required
+          priority: 1
+        - ref: title
+          scope: field
+          reason: required_missing
+          message: Required field "Title" is empty
+          severity: required
+          priority: 1
+    apply:
+      patches:
+        - op: set_string
+          field_id: ratings
+          value: Intentional type mismatch - testing rejection feedback
+        - op: set_string
+          field_id: title
+          value: Test Movie
+      rejected_patches:
+        - patch_index: 0
+          message: Cannot apply set_string to table field "ratings"
+          field_id: ratings
+          field_kind: table
+          column_ids:
+            - source
+            - score
+            - votes
+    after:
+      required_issue_count: 2
+      markdown_sha256: 4edc8e8f1e858aafa657f32e1c2e56c4bfbe93b37224e1010eb6883c111e1c86
+      answered_field_count: 0
+      skipped_field_count: 0
+  - turn: 2
+    inspect:
+      issues:
+        - ref: ratings
+          scope: field
+          reason: required_missing
+          message: Required field "Ratings" is empty
+          severity: required
+          priority: 1
+        - ref: title
+          scope: field
+          reason: required_missing
+          message: Required field "Title" is empty
+          severity: required
+          priority: 1
+    apply:
+      patches:
+        - op: set_table
+          field_id: ratings
+          rows:
+            - source: IMDB
+              score: 85
+              votes: 12500
+            - source: Rotten Tomatoes
+              score: 92
+              votes: 450
+        - op: set_string
+          field_id: title
+          value: Test Movie
+    after:
+      required_issue_count: 0
+      markdown_sha256: f45e7cd87b036d57564e3340dec33c1dc5c2094d880e52b903f64da19b3b8ec0
+      answered_field_count: 2
+      skipped_field_count: 0
+final:
+  expect_complete: true
+  expected_completed_form: rejection-test-mock-filled.form.md

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

@@ -0,0 +1,96 @@
+# Simple Test Form
+
+A fully interactive form demonstrating all Markform v0.1 field types.
+Fill all fields using interactive prompts - no LLM API key needed.
+
+## Basic Fields
+
+**Name:**
+Alice Johnson
+
+**Email:**
+alice@example.com
+
+**Age:**
+32
+
+**Score:**
+87.5
+
+## List Fields
+
+**Tags:**
+- typescript
+- testing
+- forms
+
+## Selection Fields
+
+**Priority:**
+Medium
+
+**Categories:**
+- Frontend
+- Backend
+
+## Checkbox Fields
+
+**Tasks (Multi Mode):**
+- [x] Research
+- [x] Design
+- [x] Implement
+- [-] Test
+
+**Agreements (Simple Mode):**
+- [x] I have read the guidelines
+- [x] I agree to the terms
+
+**Confirmations (Explicit Mode):**
+- [x] Data has been backed up
+- [ ] Stakeholders notified
+
+## URL Fields
+
+**Website:**
+https://alice.dev
+
+**References:**
+- https://docs.example.com/guide
+- https://github.com/example/project
+- https://medium.com/article-about-forms
+
+## Date and Year Fields
+
+**Event Date:**
+2025-06-15
+
+**Founded Year:**
+2020
+
+## Table Fields
+
+**Team Members:**
+| Name | Role | Start Date |
+| --- | --- | --- |
+| Alice | Engineer | 2024-01-15 |
+| Bob | Designer | 2023-06-01 |
+
+**Project Tasks:**
+_(empty)_
+
+## Optional Fields
+
+**Notes:**
+This is a test note.
+
+**Optional Number:**
+_(empty)_
+
+**Related URL:**
+https://markform.dev/docs
+
+**Optional Date:**
+_(empty)_
+
+**Optional Year:**
+_(empty)_

package/examples/simple/simple-mock-filled.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"
+      }
+    ]
+  }
+}