markform 0.1.8 → 0.1.10

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

@@ -58,7 +58,7 @@ The more context you provide, the more accurate and relevant the research will b
 
 {% group id="basic_info" title="Company Overview" %}
 
-{% field kind="string" id="website" label="Website URL" %}{% /field %}
+{% field kind="url" id="website" label="Website URL" %}{% /field %}
 
 {% instructions ref="website" %}
 Primary company website.
@@ -107,7 +107,7 @@ Source: linkedin.com/company page, crunchbase.com, or company website.
 Source: Company website About page, crunchbase.com, Wikipedia if notable.
 {% /instructions %}
 
-{% field kind="string_list" id="basic_info_sources" label="Company Overview Sources" %}{% /field %}
+{% field kind="url_list" id="basic_info_sources" label="Company Overview Sources" %}{% /field %}
 
 {% instructions ref="basic_info_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -117,36 +117,21 @@ URLs used as sources for this section. One URL per line.
 
 {% group id="founders_section" title="Founders & Key People" %}
 
-{% description ref="founders_section" %}
-List up to 4 founders/co-founders. Leave unused slots empty.
-Sources: Company website Team/About page, linkedin.com profiles, crunchbase.com people section.
-{% /description %}
-
-{% field kind="string" id="founder_1_name" label="Founder 1 Name" %}{% /field %}
-{% field kind="string" id="founder_1_title" label="Founder 1 Title" %}{% /field %}
-{% field kind="string" id="founder_1_linkedin" label="Founder 1 LinkedIn URL" %}{% /field %}
-{% field kind="string" id="founder_1_background" label="Founder 1 Background" maxLength=500 %}{% /field %}
+{% field kind="table" id="founders" label="Founders"
+   columnIds=["name", "title", "linkedin", "background"]
+   columnLabels=["Name", "Title", "LinkedIn URL", "Background"]
+   columnTypes=["string", "string", "url", "string"]
+   minRows=1 maxRows=6 %}
+| Name | Title | LinkedIn URL | Background |
+|------|-------|--------------|------------|
+{% /field %}
 
-{% instructions ref="founder_1_background" %}
-Brief background: prior companies, notable roles, education.
+{% instructions ref="founders" %}
+List founders and co-founders. Include name, current title, LinkedIn profile URL, and brief background (prior companies, notable roles, education).
+Sources: Company website Team/About page, linkedin.com profiles, crunchbase.com people section.
 {% /instructions %}
 
-{% field kind="string" id="founder_2_name" label="Founder 2 Name" %}{% /field %}
-{% field kind="string" id="founder_2_title" label="Founder 2 Title" %}{% /field %}
-{% field kind="string" id="founder_2_linkedin" label="Founder 2 LinkedIn URL" %}{% /field %}
-{% field kind="string" id="founder_2_background" label="Founder 2 Background" maxLength=500 %}{% /field %}
-
-{% field kind="string" id="founder_3_name" label="Founder 3 Name" %}{% /field %}
-{% field kind="string" id="founder_3_title" label="Founder 3 Title" %}{% /field %}
-{% field kind="string" id="founder_3_linkedin" label="Founder 3 LinkedIn URL" %}{% /field %}
-{% field kind="string" id="founder_3_background" label="Founder 3 Background" maxLength=500 %}{% /field %}
-
-{% field kind="string" id="founder_4_name" label="Founder 4 Name" %}{% /field %}
-{% field kind="string" id="founder_4_title" label="Founder 4 Title" %}{% /field %}
-{% field kind="string" id="founder_4_linkedin" label="Founder 4 LinkedIn URL" %}{% /field %}
-{% field kind="string" id="founder_4_background" label="Founder 4 Background" maxLength=500 %}{% /field %}
-
-{% field kind="string_list" id="founders_sources" label="Founders Sources" %}{% /field %}
+{% field kind="url_list" id="founders_sources" label="Founders Sources" %}{% /field %}
 
 {% instructions ref="founders_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -183,7 +168,7 @@ Example: Series B | 2023-06 | $50M | Sequoia Capital | https://techcrunch.com/..
 Source: crunchbase.com funding rounds, pitchbook.com, techcrunch.com, company press releases.
 {% /instructions %}
 
-{% field kind="string_list" id="funding_sources" label="Funding Sources" %}{% /field %}
+{% field kind="url_list" id="funding_sources" label="Funding Sources" %}{% /field %}
 
 {% instructions ref="funding_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -220,7 +205,7 @@ How does this company differentiate? Key advantages/disadvantages vs competitors
 Source: Company website, product pages, press interviews, g2.com reviews.
 {% /instructions %}
 
-{% field kind="string_list" id="competitors_sources" label="Competitors Sources" %}{% /field %}
+{% field kind="url_list" id="competitors_sources" label="Competitors Sources" %}{% /field %}
 
 {% instructions ref="competitors_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -294,7 +279,7 @@ Also note if there are significant discussions in related subreddits.
 Source: Search reddit.com for company name, check for official subreddit.
 {% /instructions %}
 
-{% field kind="string_list" id="social_media_sources" label="Social Media Sources" %}{% /field %}
+{% field kind="url_list" id="social_media_sources" label="Social Media Sources" %}{% /field %}
 
 {% instructions ref="social_media_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -317,7 +302,7 @@ 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 %}
 
-{% field kind="string_list" id="hacker_news_sources" label="Hacker News Sources" %}{% /field %}
+{% field kind="url_list" id="hacker_news_sources" label="Hacker News Sources" %}{% /field %}
 
 {% instructions ref="hacker_news_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -339,7 +324,7 @@ Note any badges: Product of the Day/Week/Month, Golden Kitty, etc.
 Source: Search producthunt.com for company name and product names.
 {% /instructions %}
 
-{% field kind="string_list" id="product_hunt_sources" label="Product Hunt Sources" %}{% /field %}
+{% field kind="url_list" id="product_hunt_sources" label="Product Hunt Sources" %}{% /field %}
 
 {% instructions ref="product_hunt_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -434,7 +419,7 @@ Example: "2019: Originally 'PaymentsAPI' focused on SMB; 2021: Rebranded, pivote
 Source: web.archive.org - search for company domain, review snapshots from different years.
 {% /instructions %}
 
-{% field kind="string_list" id="deep_intel_sources" label="Deep Intel Sources" %}{% /field %}
+{% field kind="url_list" id="deep_intel_sources" label="Deep Intel Sources" %}{% /field %}
 
 {% instructions ref="deep_intel_sources" %}
 URLs used as sources for this section. One URL per line.
@@ -457,7 +442,7 @@ 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 kind="string_list" id="press_sources" label="Press Coverage Sources" %}{% /field %}
+{% field kind="url_list" id="press_sources" label="Press Coverage Sources" %}{% /field %}
 
 {% instructions ref="press_sources" %}
 URLs used as sources for this section. One URL per line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",

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

@@ -1,159 +0,0 @@
----
-markform:
-  spec: MF/0.1
-  title: Earnings Analysis
-  description: Company earnings analysis with key metrics, outlook, and custom validators.
-  run_mode: research
-  roles:
-    - user
-    - agent
-  role_instructions:
-    user: "Enter the company name and ticker symbol."
-    agent: |
-      Research the company and fill in the key financial metrics and analysis.
-      Focus on the most recent quarterly results and forward outlook.
----
-{% form id="earnings_analysis" title="Earnings Analysis" %}
-
-## Company Earnings Analysis
-
-{% group id="company_input" title="Company Identification" %}
-
-Which company do you want to analyze? \[*This field is filled in by the user (`role="user"`).*\]
-
-{% field kind="string" id="company" label="Company" role="user" required=true minLength=1 maxLength=300 %}{% /field %}
-{% instructions ref="company" %}Enter the company name and ticker symbol (e.g., "Apple (AAPL)" or "Microsoft MSFT").{% /instructions %}
-
-{% /group %}
-
-## Company Overview
-
-{% group id="company_overview" title="Company Overview" %}
-
-**Company name:**
-
-{% field kind="string" id="company_name" label="Company Name" role="agent" required=true %}{% /field %}
-{% instructions ref="company_name" %}Official company name.{% /instructions %}
-
-**Ticker symbol:**
-
-{% field kind="string" id="ticker" label="Ticker Symbol" role="agent" required=true %}{% /field %}
-
-**Exchange:**
-
-{% field kind="string" id="exchange" label="Exchange" role="agent" %}{% /field %}
-{% instructions ref="exchange" %}Primary stock exchange (e.g., NYSE, NASDAQ).{% /instructions %}
-
-**Sector:**
-
-{% field kind="string" id="sector" label="Sector" role="agent" %}{% /field %}
-
-**Business summary:**
-
-{% field kind="string" id="business_summary" label="Business Summary" role="agent" maxLength=500 validate=[{id: "min_words", min: 20}] %}{% /field %}
-{% instructions ref="business_summary" %}Brief description of what the company does. Minimum 20 words.{% /instructions %}
-
-**Revenue segments:**
-
-{% field kind="string_list" id="revenue_segments" label="Revenue Segments" role="agent" minItems=1 validate=[{id: "sum_to_percent_list", target: 100}] %}{% /field %}
-{% instructions ref="revenue_segments" %}List each segment with percentage of revenue. Format: "Segment Name: XX%". Should sum to 100%.{% /instructions %}
-
-{% /group %}
-
-## Recent Earnings
-
-{% group id="recent_earnings" title="Recent Earnings" %}
-
-**Fiscal quarter:**
-
-{% field kind="string" id="fiscal_quarter" label="Fiscal Quarter" role="agent" required=true %}{% /field %}
-{% instructions ref="fiscal_quarter" %}Most recent reported quarter (e.g., "Q3 FY2024" or "Q4 2024").{% /instructions %}
-
-**Revenue:**
-
-{% field kind="number" id="revenue" label="Revenue (millions)" role="agent" %}{% /field %}
-{% instructions ref="revenue" %}Total revenue in millions USD.{% /instructions %}
-
-**Revenue growth YoY:**
-
-{% field kind="number" id="revenue_growth" label="Revenue Growth YoY (%)" role="agent" min=-100 max=1000 %}{% /field %}
-
-**EPS:**
-
-{% field kind="number" id="eps" label="Earnings Per Share" role="agent" %}{% /field %}
-{% instructions ref="eps" %}Diluted EPS for the quarter.{% /instructions %}
-
-**Beat/miss consensus:**
-
-{% field kind="single_select" id="beat_miss" label="Beat/Miss Consensus" role="agent" %}
-- [ ] Beat {% #beat %}
-- [ ] Met {% #met %}
-- [ ] Missed {% #missed %}
-{% /field %}
-
-**Beat/miss details:**
-
-{% field kind="string" id="beat_miss_details" label="Beat/Miss Details" role="agent" validate=[{id: "required_if_set", when: "beat_miss"}] %}{% /field %}
-{% instructions ref="beat_miss_details" %}Required if beat/miss is selected. Explain the variance from consensus.{% /instructions %}
-
-{% /group %}
-
-## Key Metrics
-
-{% group id="key_metrics" title="Key Metrics" %}
-
-**Gross margin:**
-
-{% field kind="number" id="gross_margin" label="Gross Margin (%)" role="agent" min=0 max=100 %}{% /field %}
-
-**Operating margin:**
-
-{% field kind="number" id="operating_margin" label="Operating Margin (%)" role="agent" min=-100 max=100 %}{% /field %}
-
-**Market cap:**
-
-{% field kind="number" id="market_cap" label="Market Cap (billions)" role="agent" %}{% /field %}
-{% instructions ref="market_cap" %}Current market capitalization in billions USD.{% /instructions %}
-
-**P/E ratio:**
-
-{% field kind="number" id="pe_ratio" label="P/E Ratio" role="agent" %}{% /field %}
-{% instructions ref="pe_ratio" %}Trailing twelve month P/E ratio.{% /instructions %}
-
-{% /group %}
-
-## Outlook
-
-{% group id="outlook" title="Outlook" %}
-
-**Guidance:**
-
-{% field kind="string" id="guidance" label="Forward Guidance" role="agent" maxLength=500 %}{% /field %}
-{% instructions ref="guidance" %}Summary of company's forward guidance for next quarter/year.{% /instructions %}
-
-**Key risks:**
-
-{% field kind="string_list" id="key_risks" label="Key Risks" role="agent" minItems=0 maxItems=5 %}{% /field %}
-{% instructions ref="key_risks" %}Primary risks or concerns (up to 5).{% /instructions %}
-
-**Analyst sentiment:**
-
-{% field kind="single_select" id="analyst_sentiment" label="Analyst Sentiment" role="agent" %}
-- [ ] Bullish {% #bullish %}
-- [ ] Neutral {% #neutral %}
-- [ ] Bearish {% #bearish %}
-{% /field %}
-
-**Sentiment rationale:**
-
-{% field kind="string" id="sentiment_rationale" label="Sentiment Rationale" role="agent" validate=[{id: "required_if_set", when: "analyst_sentiment"}, {id: "min_words", min: 10}] %}{% /field %}
-{% instructions ref="sentiment_rationale" %}Required if sentiment is selected. Explain why (minimum 10 words).{% /instructions %}
-
-**Summary:**
-
-{% field kind="string" id="summary" label="One-Line Summary" role="agent" maxLength=300 validate=[{id: "min_words", min: 10}, {id: "max_words", max: 50}] %}{% /field %}
-{% instructions ref="summary" %}Brief overall assessment (10-50 words).{% /instructions %}
-
-{% /group %}
-
-{% /form %}