markform 0.1.1 → 0.1.3

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

@@ -1,6 +1,8 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: MF/0.1
+  title: Startup Deep Research
+  description: Comprehensive startup intelligence gathering with company info, founders, funding, competitors, social media, and community presence.
   roles:
     - user
     - agent
@@ -18,6 +20,9 @@ markform:
       7. Include source URLs for every piece of information
       8. Leave unknown fields empty - don't guess or fabricate
       9. Keep descriptions concise (50-150 words max)
+  harness_config:
+    max_issues_per_turn: 5
+    max_patches_per_turn: 10
 ---
 
 {% form id="startup_deep_research" title="Startup Deep Research" %}
@@ -101,6 +106,12 @@ Source: linkedin.com/company page, crunchbase.com, or company website.
 Source: Company website About page, crunchbase.com, Wikipedia if notable.
 {% /instructions %}
 
+{% string-list id="basic_info_sources" label="Company Overview Sources" %}{% /string-list %}
+
+{% instructions ref="basic_info_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="founders_section" title="Founders & Key People" %}
@@ -134,6 +145,12 @@ Brief background: prior companies, notable roles, education.
 {% string-field id="founder_4_linkedin" label="Founder 4 LinkedIn URL" %}{% /string-field %}
 {% string-field id="founder_4_background" label="Founder 4 Background" maxLength=500 %}{% /string-field %}
 
+{% string-list id="founders_sources" label="Founders Sources" %}{% /string-list %}
+
+{% instructions ref="founders_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="funding_section" title="Funding History" %}
@@ -161,6 +178,12 @@ Example: "Series B | 2023-06 | $50M | Sequoia Capital | https://techcrunch.com/.
 Source: crunchbase.com funding rounds, pitchbook.com, techcrunch.com, company press releases.
 {% /instructions %}
 
+{% string-list id="funding_sources" label="Funding Sources" %}{% /string-list %}
+
+{% instructions ref="funding_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="competitors_section" title="Competitors & Market Position" %}
@@ -188,6 +211,12 @@ How does this company differentiate? Key advantages/disadvantages vs competitors
 Source: Company website, product pages, press interviews, g2.com reviews.
 {% /instructions %}
 
+{% string-list id="competitors_sources" label="Competitors Sources" %}{% /string-list %}
+
+{% instructions ref="competitors_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="social_media_section" title="Social Media Presence" %}
@@ -256,6 +285,12 @@ Also note if there are significant discussions in related subreddits.
 Source: Search reddit.com for company name, check for official subreddit.
 {% /instructions %}
 
+{% string-list id="social_media_sources" label="Social Media Sources" %}{% /string-list %}
+
+{% instructions ref="social_media_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="hacker_news_section" title="Hacker News Presence" %}
@@ -269,6 +304,12 @@ Include: Show HN launches, funding announcements, major discussions about the co
 Source: Search hn.algolia.com for company name, product name, and founder names.
 {% /instructions %}
 
+{% string-list id="hacker_news_sources" label="Hacker News Sources" %}{% /string-list %}
+
+{% instructions ref="hacker_news_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="product_hunt_section" title="Product Hunt Presence" %}
@@ -282,6 +323,12 @@ Note any badges: Product of the Day/Week/Month, Golden Kitty, etc.
 Source: Search producthunt.com for company name and product names.
 {% /instructions %}
 
+{% string-list id="product_hunt_sources" label="Product Hunt Sources" %}{% /string-list %}
+
+{% instructions ref="product_hunt_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="deep_intel_section" title="Deep Intelligence Sources" %}
@@ -363,6 +410,12 @@ Example: "2019: Originally 'PaymentsAPI' focused on SMB; 2021: Rebranded, pivote
 Source: web.archive.org - search for company domain, review snapshots from different years.
 {% /instructions %}
 
+{% string-list id="deep_intel_sources" label="Deep Intel Sources" %}{% /string-list %}
+
+{% instructions ref="deep_intel_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
+
 {% /field-group %}
 
 {% field-group id="press_section" title="Notable Press Coverage" %}
@@ -376,16 +429,15 @@ Focus on: funding announcements, major product launches, company profiles, notab
 Source: techcrunch.com, theinformation.com, bloomberg.com, forbes.com, wired.com, venturebeat.com, company Press page.
 {% /instructions %}
 
-{% /field-group %}
+{% string-list id="press_sources" label="Press Coverage Sources" %}{% /string-list %}
 
-{% field-group id="sources_section" title="Research Metadata" %}
+{% instructions ref="press_sources" %}
+URLs used as sources for this section. One URL per line.
+{% /instructions %}
 
-{% string-list id="all_sources" label="All Sources Consulted" %}{% /string-list %}
+{% /field-group %}
 
-{% instructions ref="all_sources" %}
-List all URLs and sources used for this research, one per line.
-Group by type: Company site, Crunchbase, LinkedIn, Social media, HN/PH, Reviews, Press, Other.
-{% /instructions %}
+{% field-group id="sources_section" title="Research Metadata" %}
 
 {% string-field id="research_date" label="Research Date" required=true pattern="^\\d{4}-\\d{2}-\\d{2}$" %}{% /string-field %}
 

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

@@ -1,6 +1,6 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: "MF/0.1"
   roles:
     - user
     - agent

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

@@ -1,6 +1,6 @@
 ---
 markform:
-  markform_version: "0.1.0"
+  spec: MF/0.1
   roles:
     - user
     - agent

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "markform",
-  "version": "0.1.1",
-  "description": "Agent-friendly, human-readable, editable forms stored as .form.md files",
+  "version": "0.1.3",
+  "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
   "repository": {
@@ -48,10 +48,12 @@
   "files": [
     "dist",
     "examples",
-    "README.md"
+    "DOCS.md",
+    "README.md",
+    "SPEC.md"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   },
   "dependencies": {
     "@ai-sdk/deepseek": "^2.0.1",
@@ -60,6 +62,7 @@
     "@ai-sdk/xai": "^3.0.1",
     "@clack/prompts": "^0.9.0",
     "@markdoc/markdoc": "^0.5.0",
+    "ai": "^6.0.0",
     "atomically": "^2.0.0",
     "commander": "^13.0.0",
     "dotenv": "^17.2.3",
@@ -69,32 +72,25 @@
     "yaml": "^2.7.0",
     "zod": "^3.24.0"
   },
-  "peerDependencies": {
-    "ai": "^6.0.0"
-  },
-  "peerDependenciesMeta": {
-    "ai": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.1",
     "@types/node": "^24.0.0",
     "@vitest/coverage-v8": "^3.2.4",
-    "ai": "^6.0.3",
     "publint": "^0.3.0",
     "tsdown": "^0.16.0",
     "typescript": "^5.0.0",
     "vitest": "^3.0.0"
   },
   "scripts": {
-    "build": "tsdown",
+    "copy-docs": "cp ../../README.md . && cp ../../SPEC.md .",
+    "build": "pnpm run copy-docs && tsdown",
     "dev": "tsdown --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:unit": "vitest run tests/unit",
     "test:golden": "vitest run tests/golden",
+    "test:golden:regen": "npx tsx scripts/regen-golden-sessions.ts",
     "test:coverage": "vitest run --coverage",
     "test:coverage:html": "vitest run --coverage && open coverage/index.html",
     "publint": "publint"