markform 0.1.1 → 0.1.3

package/examples/earnings-analysis/earnings-analysis.form.md

@@ -1,12 +1,17 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: MF/0.1
+  title: Company Quarterly Analysis
+  description: Financial analysis with one user field (company) and agent-filled quarterly analysis sections.
   roles:
     - user
     - agent
   role_instructions:
     user: "Enter company identification (legal name, ticker, fiscal year) and the quarter you want analyzed."
     agent: "Complete the company profile and quarterly analysis based on the provided company context."
+  harness_config:
+    max_issues_per_turn: 5
+    max_patches_per_turn: 10
 ---
 
 {% form id="company_analysis" title="Company Quarterly Analysis Worksheet" %}

package/examples/earnings-analysis/earnings-analysis.valid.ts

@@ -57,7 +57,14 @@ function getSingleSelectValue(values: Record<string, unknown>, fieldId: string):
 function minWords(ctx: ValidatorContext): ValidationIssue[] {
   const min = ctx.params.min as number;
   if (typeof min !== 'number') {
-    return [{ severity: 'error', message: 'min_words requires "min" parameter', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'min_words requires "min" parameter',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const value = getStringValue(ctx.values, ctx.targetId);
@@ -65,12 +72,14 @@ function minWords(ctx: ValidatorContext): ValidationIssue[] {
 
   const wordCount = countWords(value);
   if (wordCount < min) {
-    return [{
-      severity: 'error',
-      message: `Field requires at least ${min} words (currently ${wordCount})`,
-      ref: ctx.targetId,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'error',
+        message: `Field requires at least ${min} words (currently ${wordCount})`,
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -82,7 +91,14 @@ function minWords(ctx: ValidatorContext): ValidationIssue[] {
 function maxWords(ctx: ValidatorContext): ValidationIssue[] {
   const max = ctx.params.max as number;
   if (typeof max !== 'number') {
-    return [{ severity: 'error', message: 'max_words requires "max" parameter', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'max_words requires "max" parameter',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const value = getStringValue(ctx.values, ctx.targetId);
@@ -90,12 +106,14 @@ function maxWords(ctx: ValidatorContext): ValidationIssue[] {
 
   const wordCount = countWords(value);
   if (wordCount > max) {
-    return [{
-      severity: 'warning',
-      message: `Field exceeds ${max} word limit (currently ${wordCount})`,
-      ref: ctx.targetId,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'warning',
+        message: `Field exceeds ${max} word limit (currently ${wordCount})`,
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -110,22 +128,31 @@ function sumTo(ctx: ValidatorContext): ValidationIssue[] {
   const tolerance = (ctx.params.tolerance as number) ?? 0.1;
 
   if (!Array.isArray(fields)) {
-    return [{ severity: 'error', message: 'sum_to requires "fields" array parameter', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'sum_to requires "fields" array parameter',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
-  const values = fields.map(fieldId => getNumberValue(ctx.values, fieldId) ?? 0);
+  const values = fields.map((fieldId) => getNumberValue(ctx.values, fieldId) ?? 0);
   const sum = values.reduce((a, b) => a + b, 0);
 
   // Only validate if at least one value is set
-  if (values.every(v => v === 0)) return [];
+  if (values.every((v) => v === 0)) return [];
 
   if (Math.abs(sum - target) > tolerance) {
-    return [{
-      severity: 'error',
-      message: `Fields must sum to ${target}% (currently ${sum.toFixed(1)}%)`,
-      ref: fields[0],
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'error',
+        message: `Fields must sum to ${target}% (currently ${sum.toFixed(1)}%)`,
+        ref: fields[0],
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -140,25 +167,31 @@ function sumToPercentList(ctx: ValidatorContext): ValidationIssue[] {
 
   if (items.length === 0) return [];
 
-  const percentages = items.map(item => extractPercentage(item)).filter((p): p is number => p !== null);
+  const percentages = items
+    .map((item) => extractPercentage(item))
+    .filter((p): p is number => p !== null);
 
   if (percentages.length === 0) {
-    return [{
-      severity: 'warning',
-      message: 'Items should include percentages (format: "Label: XX%")',
-      ref: ctx.targetId,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'warning',
+        message: 'Items should include percentages (format: "Label: XX%")',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const sum = percentages.reduce((a, b) => a + b, 0);
   if (Math.abs(sum - target) > 0.1) {
-    return [{
-      severity: 'warning',
-      message: `Items should sum to ${target}% (currently ${sum.toFixed(1)}%)`,
-      ref: ctx.targetId,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'warning',
+        message: `Items should sum to ${target}% (currently ${sum.toFixed(1)}%)`,
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -172,7 +205,14 @@ function requiredIf(ctx: ValidatorContext): ValidationIssue[] {
   const targetField = (ctx.params.then as string) ?? ctx.targetId;
 
   if (!triggerField) {
-    return [{ severity: 'error', message: 'required_if requires "when" parameter', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'required_if requires "when" parameter',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const trigger = ctx.values[triggerField] as Record<string, unknown> | undefined;
@@ -189,12 +229,14 @@ function requiredIf(ctx: ValidatorContext): ValidationIssue[] {
     (target.kind === 'number' && target.value == null);
 
   if (triggerHasValue && targetEmpty) {
-    return [{
-      severity: 'error',
-      message: `This field is required when ${triggerField} has a value`,
-      ref: targetField,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'error',
+        message: `This field is required when ${triggerField} has a value`,
+        ref: targetField,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -209,19 +251,28 @@ function requiredIfEquals(ctx: ValidatorContext): ValidationIssue[] {
   const targetField = (ctx.params.then as string) ?? ctx.targetId;
 
   if (!triggerField || expectedValue === undefined) {
-    return [{ severity: 'error', message: 'required_if_equals requires "when" and "equals" parameters', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'required_if_equals requires "when" and "equals" parameters',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const triggerValue = getSingleSelectValue(ctx.values, triggerField);
   const target = getStringValue(ctx.values, targetField);
 
   if (triggerValue === expectedValue && (!target || target.trim().length === 0)) {
-    return [{
-      severity: 'error',
-      message: `This field is required when ${triggerField} is "${expectedValue}"`,
-      ref: targetField,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'error',
+        message: `This field is required when ${triggerField} is "${expectedValue}"`,
+        ref: targetField,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }
@@ -232,26 +283,35 @@ function requiredIfEquals(ctx: ValidatorContext): ValidationIssue[] {
  */
 function itemFormat(ctx: ValidatorContext): ValidationIssue[] {
   const pattern = ctx.params.pattern as string;
-  const example = ctx.params.example as string ?? '';
+  const example = (ctx.params.example as string) ?? '';
 
   if (!pattern) {
-    return [{ severity: 'error', message: 'item_format requires "pattern" parameter', ref: ctx.targetId, source: 'code' }];
+    return [
+      {
+        severity: 'error',
+        message: 'item_format requires "pattern" parameter',
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
 
   const items = getStringListItems(ctx.values, ctx.targetId);
   if (items.length === 0) return [];
 
   const regex = new RegExp(pattern);
-  const malformed = items.filter(item => !regex.test(item));
+  const malformed = items.filter((item) => !regex.test(item));
 
   if (malformed.length > 0) {
     const hint = example ? ` Expected format: "${example}"` : '';
-    return [{
-      severity: 'warning',
-      message: `${malformed.length} item(s) don't match expected format.${hint}`,
-      ref: ctx.targetId,
-      source: 'code',
-    }];
+    return [
+      {
+        severity: 'warning',
+        message: `${malformed.length} item(s) don't match expected format.${hint}`,
+        ref: ctx.targetId,
+        source: 'code',
+      },
+    ];
   }
   return [];
 }

package/examples/movie-research/movie-research-basic.form.md

@@ -0,0 +1,164 @@
+---
+markform:
+  spec: MF/0.1
+  title: Movie Research (Basic)
+  description: Standard movie research form pulling ratings and key stats from IMDB, Rotten Tomatoes, and Metacritic.
+  roles:
+    - user
+    - agent
+  role_instructions:
+    user: "Enter the movie title and optionally the year for disambiguation."
+    agent: |
+      Research and fill in all fields for the specified movie.
+      Guidelines:
+      1. WORKFLOW - Complete sections in order:
+         - First identify the movie title
+         - Then find all source URLs (verify you have the right movie on each site)
+         - Then fill in details (year, directors, ratings) from those sources
+      2. PRIMARY SOURCES:
+         - IMDB (imdb.com) for ratings, runtime, and technical details
+         - Rotten Tomatoes (rottentomatoes.com) for Tomatometer and Audience Score
+         - Metacritic (metacritic.com) for Metascore
+      3. Use the EXACT numeric scores from each source - don't average or interpret
+      4. Skip fields if any scores are unavailable (older films may lack some metrics)
+      5. Use the tool to add notes if there is missing, confusing, or unclear information
+         in the values you provide.
+  harness_config:
+    max_issues_per_turn: 3
+    max_patches_per_turn: 8
+---
+
+{% form id="movie_research_basic" title="Movie Research (Basic)" %}
+
+{% description ref="movie_research_basic" %}
+Standard research form for gathering ratings and key statistics for any film. Pulls from IMDB, Rotten Tomatoes, and Metacritic.
+{% /description %}
+
+{% field-group id="movie_input" title="Movie Identification" %}
+
+{% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
+
+{% instructions ref="movie" %}
+Enter the movie title (add any details to help identify, like "Barbie 2023" or "the Batman movie with Robert Pattinson")
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="title_identification" title="Title Identification" %}
+
+{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+
+{% instructions ref="full_title" %}
+Look up what film the user had in mind and fill in the official title including subtitle if any (e.g., "The Lord of the Rings: The Fellowship of the Ring").
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="sources" title="Sources" %}
+
+{% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
+
+{% instructions ref="imdb_url" %}
+Direct link to the movie's IMDB page (e.g., https://www.imdb.com/title/tt0111161/).
+{% /instructions %}
+
+{% url-field id="rt_url" label="Rotten Tomatoes URL" role="agent" %}{% /url-field %}
+
+{% instructions ref="rt_url" %}
+Direct link to the movie's Rotten Tomatoes page.
+{% /instructions %}
+
+{% url-field id="metacritic_url" label="Metacritic URL" role="agent" %}{% /url-field %}
+
+{% instructions ref="metacritic_url" %}
+Direct link to the movie's Metacritic page.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="basic_details" title="Basic Details" %}
+
+{% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
+
+{% string-list id="directors" label="Director(s)" role="agent" required=true %}{% /string-list %}
+
+{% instructions ref="directors" %}
+One director per line. Most films have one; some have two or more co-directors.
+{% /instructions %}
+
+{% number-field id="runtime_minutes" label="Runtime (minutes)" role="agent" min=1 max=1000 %}{% /number-field %}
+
+{% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
+- [ ] G {% #g %}
+- [ ] PG {% #pg %}
+- [ ] PG-13 {% #pg_13 %}
+- [ ] R {% #r %}
+- [ ] NC-17 {% #nc_17 %}
+- [ ] NR/Unrated {% #nr %}
+{% /single-select %}
+
+{% /field-group %}
+
+{% field-group id="imdb_ratings" title="IMDB Ratings" %}
+
+{% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
+
+{% instructions ref="imdb_rating" %}
+IMDB user rating (1.0-10.0 scale).
+{% /instructions %}
+
+{% number-field id="imdb_votes" label="IMDB Vote Count" role="agent" min=0 %}{% /number-field %}
+
+{% instructions ref="imdb_votes" %}
+Number of IMDB user votes (e.g., 2800000 for a popular film).
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="rotten_tomatoes_ratings" title="Rotten Tomatoes Ratings" %}
+
+{% number-field id="rt_critics_score" label="Tomatometer (Critics)" role="agent" min=0 max=100 %}{% /number-field %}
+
+{% instructions ref="rt_critics_score" %}
+Tomatometer percentage (0-100).
+{% /instructions %}
+
+{% number-field id="rt_critics_count" label="Critics Review Count" role="agent" min=0 %}{% /number-field %}
+
+{% number-field id="rt_audience_score" label="Audience Score" role="agent" min=0 max=100 %}{% /number-field %}
+
+{% instructions ref="rt_audience_score" %}
+Audience Score percentage (0-100).
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="metacritic_ratings" title="Metacritic Ratings" %}
+
+{% number-field id="metacritic_score" label="Metacritic Score" role="agent" min=0 max=100 %}{% /number-field %}
+
+{% instructions ref="metacritic_score" %}
+Metascore (0-100 scale). Leave empty if not available.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="summary" title="Summary" %}
+
+{% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
+
+{% instructions ref="logline" %}
+Brief plot summary in 1-2 sentences, no spoilers.
+{% /instructions %}
+
+{% string-list id="notable_awards" label="Notable Awards" role="agent" %}{% /string-list %}
+
+{% instructions ref="notable_awards" %}
+Major awards won. One per line.
+Format: Award | Category | Year
+Example: "Oscar | Best Picture | 1995"
+{% /instructions %}
+
+{% /field-group %}
+
+{% /form %}