markform 0.1.21 → 0.1.22

package/dist/urlFormat-lls7CsEP.mjs

@@ -0,0 +1,71 @@
+
+//#region src/utils/urlFormat.ts
+/**
+* Create a friendly abbreviated display name for a URL.
+* - Drops "www." prefix from domain
+* - Adds first portion of path (up to maxPathChars) if present
+* - Adds ellipsis (…) if path is truncated
+*
+* @param url - The URL to abbreviate
+* @param maxPathChars - Maximum characters to include from the path (default: 12)
+* @returns Friendly abbreviated URL (e.g., "example.com/docs/api…")
+*/
+function friendlyUrlAbbrev(url, maxPathChars = 12) {
+	try {
+		const parsed = new URL(url);
+		let hostname = parsed.hostname;
+		if (hostname.startsWith("www.")) hostname = hostname.slice(4);
+		const path = parsed.pathname.slice(1);
+		if (!path) return hostname;
+		if (path.length <= maxPathChars) return `${hostname}/${path}`;
+		return `${hostname}/${path.slice(0, maxPathChars)}…`;
+	} catch {
+		let result = url;
+		result = result.replace(/^https?:\/\//, "");
+		result = result.replace(/^www\./, "");
+		const maxLen = 30;
+		if (result.length > maxLen) return result.slice(0, maxLen) + "…";
+		return result;
+	}
+}
+/**
+* Format a URL as a markdown link with a friendly abbreviated display text.
+* The full URL is preserved as the link target.
+*
+* @param url - The URL to format
+* @returns Markdown link in format [friendly-abbrev](url)
+*/
+function formatUrlAsMarkdownLink(url) {
+	return `[${friendlyUrlAbbrev(url)}](${url})`;
+}
+/**
+* Format bare URLs in text as HTML links with abbreviated display text.
+* Also handles markdown-style links [text](url) for consistency.
+*
+* Processing order:
+* 1. Escape all HTML to prevent XSS
+* 2. Convert markdown links [text](url) to <a> tags
+* 3. Convert bare URLs (not already in links) to <a> tags with abbreviated display
+*
+* @param text - The raw text containing URLs (will be HTML-escaped)
+* @param escapeHtml - Function to escape HTML entities
+* @returns HTML-safe text with URLs converted to <a> tags
+*/
+function formatBareUrlsAsHtmlLinks(text, escapeHtml) {
+	let result = escapeHtml(text);
+	result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, linkText, url) => {
+		const cleanUrl = url.replace(/&amp;/g, "&");
+		return `<a href="${escapeHtml(cleanUrl)}" target="_blank" class="url-link" data-url="${escapeHtml(cleanUrl)}">${linkText}</a>`;
+	});
+	result = result.replace(/(?<!href="|data-url="|">)(?:https?:\/\/|www\.)[^\s<>"]+(?<![.,;:!?'")])/g, (url) => {
+		const cleanUrl = url.replace(/&amp;/g, "&");
+		const fullUrl = cleanUrl.startsWith("www.") ? `https://${cleanUrl}` : cleanUrl;
+		const display = friendlyUrlAbbrev(fullUrl);
+		return `<a href="${escapeHtml(fullUrl)}" target="_blank" class="url-link" data-url="${escapeHtml(fullUrl)}">${escapeHtml(display)}</a>`;
+	});
+	return result;
+}
+
+//#endregion
+export { formatUrlAsMarkdownLink as n, friendlyUrlAbbrev as r, formatBareUrlsAsHtmlLinks as t };
+//# sourceMappingURL=urlFormat-lls7CsEP.mjs.map

package/dist/urlFormat-lls7CsEP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlFormat-lls7CsEP.mjs","names":[],"sources":["../src/utils/urlFormat.ts"],"sourcesContent":["/**\n * URL formatting utilities for display and markdown output.\n */\n\n/**\n * Extract the domain (hostname) from a URL.\n * Returns the original string if parsing fails.\n *\n * @param url - The URL to extract the domain from\n * @returns The domain (e.g., \"example.com\") or the original string if invalid\n */\nexport function extractDomain(url: string): string {\n  try {\n    const parsed = new URL(url);\n    return parsed.hostname;\n  } catch {\n    // If URL parsing fails, try to extract domain-like pattern\n    const match = /^(?:https?:\\/\\/)?(?:www\\.)?([^/\\s]+)/i.exec(url);\n    if (match?.[1]) {\n      return match[1];\n    }\n    // Return original if we can't extract a domain\n    return url;\n  }\n}\n\n/**\n * Create a friendly abbreviated display name for a URL.\n * - Drops \"www.\" prefix from domain\n * - Adds first portion of path (up to maxPathChars) if present\n * - Adds ellipsis (…) if path is truncated\n *\n * @param url - The URL to abbreviate\n * @param maxPathChars - Maximum characters to include from the path (default: 12)\n * @returns Friendly abbreviated URL (e.g., \"example.com/docs/api…\")\n */\nexport function friendlyUrlAbbrev(url: string, maxPathChars = 12): string {\n  try {\n    const parsed = new URL(url);\n    // Remove www. prefix from hostname\n    let hostname = parsed.hostname;\n    if (hostname.startsWith('www.')) {\n      hostname = hostname.slice(4);\n    }\n\n    // Get path without leading slash, excluding query string and hash\n    const path = parsed.pathname.slice(1);\n    if (!path) {\n      return hostname;\n    }\n\n    // Include path up to maxPathChars\n    if (path.length <= maxPathChars) {\n      return `${hostname}/${path}`;\n    }\n\n    // Truncate path and add ellipsis\n    return `${hostname}/${path.slice(0, maxPathChars)}…`;\n  } catch {\n    // If URL parsing fails, try basic cleanup\n    let result = url;\n    // Remove protocol\n    result = result.replace(/^https?:\\/\\//, '');\n    // Remove www.\n    result = result.replace(/^www\\./, '');\n    // Truncate if too long\n    const maxLen = 30;\n    if (result.length > maxLen) {\n      return result.slice(0, maxLen) + '…';\n    }\n    return result;\n  }\n}\n\n/**\n * Format a URL as a markdown link with a friendly abbreviated display text.\n * The full URL is preserved as the link target.\n *\n * @param url - The URL to format\n * @returns Markdown link in format [friendly-abbrev](url)\n */\nexport function formatUrlAsMarkdownLink(url: string): string {\n  const display = friendlyUrlAbbrev(url);\n  return `[${display}](${url})`;\n}\n\n/**\n * Check if a string looks like a URL.\n *\n * @param str - The string to check\n * @returns true if the string appears to be a URL\n */\nexport function isUrl(str: string): boolean {\n  // Check for common URL patterns\n  if (str.startsWith('http://') || str.startsWith('https://')) {\n    return true;\n  }\n  // Check for www. prefix\n  if (str.startsWith('www.')) {\n    return true;\n  }\n  return false;\n}\n\n/**\n * Format bare URLs in text as HTML links with abbreviated display text.\n * Also handles markdown-style links [text](url) for consistency.\n *\n * Processing order:\n * 1. Escape all HTML to prevent XSS\n * 2. Convert markdown links [text](url) to <a> tags\n * 3. Convert bare URLs (not already in links) to <a> tags with abbreviated display\n *\n * @param text - The raw text containing URLs (will be HTML-escaped)\n * @param escapeHtml - Function to escape HTML entities\n * @returns HTML-safe text with URLs converted to <a> tags\n */\nexport function formatBareUrlsAsHtmlLinks(text: string, escapeHtml: (s: string) => string): string {\n  // SECURITY: Escape the entire text first to prevent XSS\n  let result = escapeHtml(text);\n\n  // Convert markdown links [text](url) to <a> tags\n  // After escaping, we need to unescape &amp; back to & for URLs\n  result = result.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g, (_match, linkText: string, url: string) => {\n    const cleanUrl = url.replace(/&amp;/g, '&');\n    return `<a href=\"${escapeHtml(cleanUrl)}\" target=\"_blank\" class=\"url-link\" data-url=\"${escapeHtml(cleanUrl)}\">${linkText}</a>`;\n  });\n\n  // Convert bare URLs to <a> tags with abbreviated display\n  // Uses negative lookbehind to skip URLs that are:\n  // - Inside href=\"\" or data-url=\"\" attributes\n  // - Inside anchor tag content (preceded by \">)\n  // Pattern matches http://, https://, www. URLs\n  result = result.replace(\n    /(?<!href=\"|data-url=\"|\">)(?:https?:\\/\\/|www\\.)[^\\s<>\"]+(?<![.,;:!?'\")])/g,\n    (url: string) => {\n      // Unescape &amp; back to & for the actual URL\n      const cleanUrl = url.replace(/&amp;/g, '&');\n      // Normalize www. URLs to have https://\n      const fullUrl = cleanUrl.startsWith('www.') ? `https://${cleanUrl}` : cleanUrl;\n      const display = friendlyUrlAbbrev(fullUrl);\n      return `<a href=\"${escapeHtml(fullUrl)}\" target=\"_blank\" class=\"url-link\" data-url=\"${escapeHtml(fullUrl)}\">${escapeHtml(display)}</a>`;\n    },\n  );\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;AAoCA,SAAgB,kBAAkB,KAAa,eAAe,IAAY;AACxE,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,IAAI;EAE3B,IAAI,WAAW,OAAO;AACtB,MAAI,SAAS,WAAW,OAAO,CAC7B,YAAW,SAAS,MAAM,EAAE;EAI9B,MAAM,OAAO,OAAO,SAAS,MAAM,EAAE;AACrC,MAAI,CAAC,KACH,QAAO;AAIT,MAAI,KAAK,UAAU,aACjB,QAAO,GAAG,SAAS,GAAG;AAIxB,SAAO,GAAG,SAAS,GAAG,KAAK,MAAM,GAAG,aAAa,CAAC;SAC5C;EAEN,IAAI,SAAS;AAEb,WAAS,OAAO,QAAQ,gBAAgB,GAAG;AAE3C,WAAS,OAAO,QAAQ,UAAU,GAAG;EAErC,MAAM,SAAS;AACf,MAAI,OAAO,SAAS,OAClB,QAAO,OAAO,MAAM,GAAG,OAAO,GAAG;AAEnC,SAAO;;;;;;;;;;AAWX,SAAgB,wBAAwB,KAAqB;AAE3D,QAAO,IADS,kBAAkB,IAAI,CACnB,IAAI,IAAI;;;;;;;;;;;;;;;AAkC7B,SAAgB,0BAA0B,MAAc,YAA2C;CAEjG,IAAI,SAAS,WAAW,KAAK;AAI7B,UAAS,OAAO,QAAQ,6BAA6B,QAAQ,UAAkB,QAAgB;EAC7F,MAAM,WAAW,IAAI,QAAQ,UAAU,IAAI;AAC3C,SAAO,YAAY,WAAW,SAAS,CAAC,+CAA+C,WAAW,SAAS,CAAC,IAAI,SAAS;GACzH;AAOF,UAAS,OAAO,QACd,6EACC,QAAgB;EAEf,MAAM,WAAW,IAAI,QAAQ,UAAU,IAAI;EAE3C,MAAM,UAAU,SAAS,WAAW,OAAO,GAAG,WAAW,aAAa;EACtE,MAAM,UAAU,kBAAkB,QAAQ;AAC1C,SAAO,YAAY,WAAW,QAAQ,CAAC,+CAA+C,WAAW,QAAQ,CAAC,IAAI,WAAW,QAAQ,CAAC;GAErI;AAED,QAAO"}

package/docs/markform-apis.md

@@ -546,6 +546,59 @@ interface InjectHeaderIdsOptions {
 }
 ```
 
+## Rendering API
+
+Import from the render subpath for HTML rendering functions that produce the same output
+as `markform serve`:
+
+```typescript
+import {
+  renderViewContent,
+  renderSourceContent,
+  renderMarkdownContent,
+  renderYamlContent,
+  renderJsonContent,
+  renderFillRecordContent,
+  FILL_RECORD_STYLES,
+  FILL_RECORD_SCRIPTS,
+  escapeHtml,
+  formatDuration,
+  formatTokens,
+} from 'markform/render';
+```
+
+These functions produce HTML fragments (not full pages), so consumers can embed them in
+their own page shell with their own layout, CSS reset, and surrounding UI.
+
+### Content Renderers
+
+| Function | Input | Description |
+| --- | --- | --- |
+| `renderViewContent(form)` | `ParsedForm` | Render a form as a read-only HTML view |
+| `renderSourceContent(content)` | `string` | Render Jinja-style form source with syntax highlighting |
+| `renderMarkdownContent(content)` | `string` | Render markdown as HTML |
+| `renderYamlContent(content)` | `string` | Render YAML with syntax highlighting |
+| `renderJsonContent(content)` | `string` | Render JSON with syntax highlighting |
+| `renderFillRecordContent(record)` | `FillRecord` | Render a fill record as an interactive dashboard |
+
+### CSS and JavaScript Constants
+
+| Export | Description |
+| --- | --- |
+| `FILL_RECORD_STYLES` | `<style>` block with CSS for the fill record dashboard |
+| `FILL_RECORD_SCRIPTS` | JavaScript providing `frShowTip()`, `frHideTip()`, `frCopyYaml()` for fill record interactivity |
+
+Include `FILL_RECORD_STYLES` in your page `<head>` and `FILL_RECORD_SCRIPTS` in a
+`<script>` tag when using `renderFillRecordContent()`.
+
+### Utility Functions
+
+| Function | Description |
+| --- | --- |
+| `escapeHtml(str)` | Escape HTML special characters |
+| `formatDuration(ms)` | Format milliseconds as human-readable duration (e.g., `"1m 5s"`) |
+| `formatTokens(count)` | Format token counts with k suffix (e.g., `"1.5k"`) |
+
 ## Type Exports
 
 All Zod schemas and TypeScript types are exported from the main package:

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

@@ -19,7 +19,7 @@ test@example.com
 
 **Score:**
 
-_(empty)_
+_(skipped: Not needed for this test)_
 
 ## List Fields
 
@@ -84,30 +84,30 @@ High
 
 **Team Members:**
 
-_(empty)_
+_(skipped)_
 
 **Project Tasks:**
 
-_(empty)_
+_(skipped)_
 
 ## Optional Fields
 
 **Notes:**
 
-_(empty)_
+_(skipped: No notes required)_
 
 **Optional Number:**
 
-_(empty)_
+_(skipped)_
 
 **Related URL:**
 
-_(empty)_
+_(skipped: No related URL needed)_
 
 **Optional Date:**
 
-_(empty)_
+_(skipped)_
 
 **Optional Year:**
 
-_(empty)_
+_(skipped)_

package/examples/twitter-thread/twitter-thread.form.md

@@ -0,0 +1,373 @@
+---
+markform:
+  spec: MF/0.1
+  title: Content to Twitter Thread
+  description: Transform raw content into an engaging Twitter/X thread through structured analysis, prioritization, and iterative refinement.
+  run_mode: fill
+  roles:
+    - user
+    - agent
+  role_instructions:
+    user: |
+      Provide your raw content and any context about your audience and goals.
+      The content can be a transcript, blog draft, notes, or any text.
+      Include as much detail as possible: specific examples, names, links, code.
+    agent: |
+      Transform the input into a compelling Twitter thread. Work through each stage in order—do not skip stages.
+
+      VOICE AND STYLE (CRITICAL):
+      - Write like a smart person talking, not a press release
+      - Be informal: use contractions, conversational phrasing
+      - Be opinionated: take strong positions, not wishy-washy hedging
+      - Be specific: name people, cite sources, link to things
+      - Be novel: each tweet should make the reader pause and think
+      - AVOID: generic "sounds like perfect English" corporate speak
+      - AVOID: vague claims like "improves quality" without showing HOW
+
+      Good example: "LLMs are, first and foremost, fuzzy subgraph matching machines"
+      Bad example: "LLMs have limitations in certain reasoning tasks"
+
+      Good example: "Like Katalin Karikó, for instance" (names a specific person)
+      Bad example: "Like many successful researchers" (generic)
+
+      STAGE 1 - CLEANUP: Edit raw content. PRESERVE specific names, examples, links, code.
+
+      STAGE 2 - EXTRACT INSIGHTS: Find CONCRETE, NOVEL insights worth sharing.
+      Look for:
+      - Specific examples with names/links (people, repos, books, episodes)
+      - Technical details that are precise and memorable
+      - Personal observations ("As a researcher, I find...")
+      - Contrarian or surprising claims
+      - Things that make you go "huh, I never thought of it that way"
+      AVOID: Generic claims that could be in any article on the topic
+
+      STAGE 3 - PRIORITIZE: Rank by NOVELTY and specificity.
+      The hook should be surprising or contrarian, not a generic claim.
+      Include tweets that link to specific things (repos, docs, people, books).
+
+      STAGE 4 - STRUCTURE: Plan the thread. Longer is fine (15-25 tweets) if every
+      tweet has real substance. Include:
+      - Specific examples with links
+      - Technical details that are precise
+      - Personal takes and opinions
+      - At least 2-3 tweets that reference specific things to click/explore
+
+      STAGE 5 - DRAFT: Write informally. Sound like a person, not a brand.
+      - Use contractions (I've, it's, that's)
+      - Use parentheticals for asides (if you're a researcher, you'll have noticed)
+      - Be direct and opinionated
+      - Include specific names, links, code when relevant
+
+      STAGE 6 - REVIEW: Check each tweet:
+      - Does it sound like a person talking? (not corporate)
+      - Is it specific? (names, examples, links)
+      - Is it novel? (makes you think, not just nod)
+      - Would someone quote-tweet this specific insight?
+
+      STAGE 7 - FINAL: Produce polished output. Every tweet should be quotable.
+
+      Key principles:
+      - Generic = worthless. Specific = valuable.
+      - Sound like yourself, not like marketing copy
+      - Each tweet should teach something or make someone think
+      - Include things to click on (links, repos, names to search)
+  harness_config:
+    max_issues_per_turn: 5
+    max_patches_per_turn: 15
+---
+<!-- form id="twitter_thread" title="Content to Twitter Thread" -->
+
+<!-- description ref="twitter_thread" -->
+A rigorous content transformation workflow: raw text → insights → prioritization → structure → drafts → review → final thread. Each stage enforces quality through structured tables and validation.
+<!-- /description -->
+
+<!-- group id="input" title="Input: Raw Content" -->
+
+## Source Content
+
+<!-- field kind="string" id="raw_content" label="Raw Content" role="user" required=true minLength=200 --><!-- /field -->
+
+<!-- instructions ref="raw_content" -->
+Paste your raw content. This can be:
+- A rough transcript (talk, podcast, voice memo)
+- A blog post or article draft
+- Meeting notes, brainstorm, or research notes
+- Any text you want to transform
+
+Aim for at least a few paragraphs. More content = richer thread options.
+<!-- /instructions -->
+
+<!-- field kind="string" id="target_audience" label="Target Audience" role="user" maxLength=200 --><!-- /field -->
+
+<!-- instructions ref="target_audience" -->
+Who is this thread for? Examples:
+- "Startup founders building AI products"
+- "Developers learning system design"
+- "Product managers in B2B SaaS"
+
+Helps tailor tone, examples, and assumed knowledge level.
+<!-- /instructions -->
+
+<!-- field kind="string" id="thread_goal" label="Thread Goal" role="user" maxLength=300 --><!-- /field -->
+
+<!-- instructions ref="thread_goal" -->
+What should readers take away? Examples:
+- "Understand why structured forms improve AI agent reliability"
+- "Learn the 5 key principles of good API design"
+- "See why this approach to X is underrated"
+<!-- /instructions -->
+
+<!-- field kind="number" id="target_length" label="Target Thread Length" role="user" min=5 max=20 integer=true --><!-- /field -->
+
+<!-- instructions ref="target_length" -->
+Desired number of tweets (5-20). Typical threads:
+- 5-7 tweets: Quick insight or single concept
+- 8-12 tweets: Moderate depth, multiple points
+- 12-20 tweets: Deep dive, comprehensive coverage
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="cleanup" title="Stage 1: Content Cleanup" -->
+
+## Cleaned Content
+
+<!-- field kind="string" id="cleaned_content" label="Cleaned Content" role="agent" required=true minLength=100 --><!-- /field -->
+
+<!-- instructions ref="cleaned_content" -->
+Edit the raw content into clean, readable prose:
+- Fix transcription errors, typos, and grammatical issues
+- Remove filler words (um, uh, like, you know, basically)
+- Improve sentence flow and clarity
+- Preserve the author's voice and distinctive phrases
+- Don't add new ideas—just clean what's there
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="insights" title="Stage 2: Extract Insights" -->
+
+## Key Insights
+
+Extract every insight, claim, or idea worth sharing.
+
+<!-- field kind="table" id="insights_table" label="Insights" role="agent" required=true
+   columnIds=["insight", "why_matters", "type"]
+   columnLabels=["Insight/Claim", "Why It Matters", "Type"]
+   columnTypes=["string", "string", "string"]
+   minRows=5 maxRows=20 -->
+
+| Insight/Claim | Why It Matters | Type |
+|---------------|----------------|------|
+
+<!-- /field -->
+
+<!-- instructions ref="insights_table" -->
+For each insight from the cleaned content:
+- **Insight/Claim**: The core idea in one sentence
+- **Why It Matters**: Why should readers care? What's the payoff?
+- **Type**: categorize as one of:
+  - `thesis` - central argument
+  - `supporting` - backs up the thesis
+  - `example` - concrete illustration
+  - `context` - background/setup
+  - `contrarian` - challenges assumptions
+  - `actionable` - something readers can do
+
+Be thorough—extract MORE than you'll use. You'll prioritize in the next stage.
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="prioritize" title="Stage 3: Prioritize & Rank" -->
+
+## Prioritization
+
+Not every insight makes the thread. Rank by impact and assign roles.
+
+<!-- field kind="table" id="priority_table" label="Ranked Insights" role="agent" required=true
+   columnIds=["rank", "insight_summary", "role", "include"]
+   columnLabels=["Rank", "Insight (summary)", "Thread Role", "Include?"]
+   columnTypes=["number", "string", "string", "string"]
+   minRows=5 maxRows=15 -->
+
+| Rank | Insight (summary) | Thread Role | Include? |
+|------|-------------------|-------------|----------|
+
+<!-- /field -->
+
+<!-- instructions ref="priority_table" -->
+Take insights from Stage 2 and prioritize:
+- **Rank**: 1 = highest impact, most compelling
+- **Insight**: Brief summary (reference the insight)
+- **Thread Role**: Where it fits in the thread:
+  - `hook` - attention-grabbing opener (need exactly 1)
+  - `context` - setup/background
+  - `main_point` - core argument support
+  - `example` - concrete illustration
+  - `pivot` - transition or "but here's the thing"
+  - `summary` - ties it together
+  - `cta` - call to action (need exactly 1)
+- **Include?**: `yes` or `no` (cut ruthlessly—not everything fits)
+
+Total "yes" should roughly match target thread length.
+<!-- /instructions -->
+
+<!-- field kind="string" id="hook_strategy" label="Hook Strategy" role="agent" required=true maxLength=400 --><!-- /field -->
+
+<!-- instructions ref="hook_strategy" -->
+What's the hook strategy? Choose one:
+- **Contrarian**: "Most people think X, but actually Y"
+- **Promise**: "Here's how to do X in N steps"
+- **Story**: "Last week I learned something that changed how I think about X"
+- **Bold claim**: "X is the most underrated skill in Y"
+- **Question**: "Why do most X fail at Y?"
+
+Write out your specific hook angle for this thread.
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="structure" title="Stage 4: Thread Structure" -->
+
+## Thread Plan
+
+Map the prioritized insights into a tweet-by-tweet structure.
+
+<!-- field kind="table" id="structure_table" label="Thread Structure" role="agent" required=true
+   columnIds=["tweet_num", "role", "content_plan", "source_insight"]
+   columnLabels=["#", "Role", "Content Plan", "From Insight"]
+   columnTypes=["number", "string", "string", "string"]
+   minRows=5 maxRows=20 -->
+
+| # | Role | Content Plan | From Insight |
+|---|------|--------------|--------------|
+
+<!-- /field -->
+
+<!-- instructions ref="structure_table" -->
+Plan each tweet position:
+- **#**: Tweet number (1, 2, 3...)
+- **Role**: hook, context, main_point, example, pivot, summary, cta
+- **Content Plan**: What this tweet will say (not the final text, just the plan)
+- **From Insight**: Which insight from the priority table this uses (or "new" if synthesized)
+
+This is your blueprint. Drafting should follow this plan.
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="drafts" title="Stage 5: Draft Tweets" -->
+
+## Tweet Drafts
+
+Write each tweet following the structure plan.
+
+<!-- field kind="table" id="drafts_table" label="Tweet Drafts" role="agent" required=true
+   columnIds=["tweet_num", "draft_content", "char_count", "issues"]
+   columnLabels=["#", "Draft Content", "Chars", "Issues"]
+   columnTypes=["number", "string", "number", "string"]
+   minRows=5 maxRows=20 -->
+
+| # | Draft Content | Chars | Issues |
+|---|---------------|-------|--------|
+
+<!-- /field -->
+
+<!-- instructions ref="drafts_table" -->
+Write each tweet:
+- **#**: Tweet number, must include "N/" prefix in the content
+- **Draft Content**: The tweet text (must be ≤280 characters)
+- **Chars**: Character count (be accurate!)
+- **Issues**: Note any problems: "too long", "weak hook", "unclear", "missing link to previous"
+
+Rules:
+- Hard limit: 280 characters per tweet
+- Include thread number prefix (1/, 2/, etc.)
+- Each tweet should make sense if quoted alone
+- Line breaks within tweets are fine for readability
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="review" title="Stage 6: Review & Refine" -->
+
+## Review Checklist
+
+Verify each tweet against quality criteria.
+
+<!-- field kind="table" id="review_table" label="Tweet Review" role="agent" required=true
+   columnIds=["tweet_num", "under_280", "clear", "flows", "standalone", "revision_needed"]
+   columnLabels=["#", "≤280?", "Clear?", "Flows?", "Standalone?", "Revision"]
+   columnTypes=["number", "string", "string", "string", "string", "string"]
+   minRows=5 maxRows=20 -->
+
+| # | ≤280? | Clear? | Flows? | Standalone? | Revision |
+|---|-------|--------|--------|-------------|----------|
+
+<!-- /field -->
+
+<!-- instructions ref="review_table" -->
+Review each tweet:
+- **≤280?**: Is it under 280 characters? (yes/no)
+- **Clear?**: Is the point immediately clear? (yes/no)
+- **Flows?**: Does it connect naturally from the previous tweet? (yes/no/na for #1)
+- **Standalone?**: Would it make sense if someone only saw this tweet? (yes/no)
+- **Revision**: What needs fixing? Leave blank if good, otherwise note the issue.
+
+If any issues exist, address them before finalizing.
+<!-- /instructions -->
+
+<!-- field kind="string" id="revision_notes" label="Revision Notes" role="agent" maxLength=500 --><!-- /field -->
+
+<!-- instructions ref="revision_notes" -->
+If any tweets needed revision based on the review, note what you changed.
+Leave blank if no revisions were needed.
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- group id="final" title="Stage 7: Final Thread" -->
+
+## Final Output
+
+The polished, copy-paste ready thread.
+
+<!-- field kind="string" id="final_thread" label="Final Thread" role="agent" required=true --><!-- /field -->
+
+<!-- instructions ref="final_thread" -->
+Produce the final thread in copy-paste format:
+
+1/ [First tweet]
+
+2/ [Second tweet]
+
+3/ [Third tweet]
+
+...
+
+(Double line break between each tweet for easy copying)
+<!-- /instructions -->
+
+<!-- field kind="number" id="total_tweets" label="Total Tweet Count" role="agent" required=true min=5 max=20 integer=true --><!-- /field -->
+
+<!-- field kind="checkboxes" id="final_checklist" label="Final Quality Checklist" role="agent" checkboxMode="simple" required=true -->
+
+- [ ] Hook grabs attention and is specific to the content <!-- #hook_quality -->
+- [ ] Every tweet is under 280 characters <!-- #char_limit -->
+- [ ] Thread has clear narrative arc (setup → points → conclusion) <!-- #narrative_arc -->
+- [ ] Each tweet flows naturally from the previous one <!-- #flow_quality -->
+- [ ] Each tweet makes sense if read in isolation <!-- #standalone -->
+- [ ] Ends with clear CTA or memorable summary <!-- #ending_quality -->
+- [ ] No filler tweets—every tweet adds value <!-- #no_filler -->
+
+<!-- /field -->
+
+<!-- instructions ref="final_checklist" -->
+Verify ALL quality criteria are met before marking complete.
+Do not check a box unless you've verified it's true.
+<!-- /instructions -->
+
+<!-- /group -->
+
+<!-- /form -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
@@ -40,6 +40,10 @@
       "types": "./dist/ai-sdk.d.mts",
       "default": "./dist/ai-sdk.mjs"
     },
+    "./render": {
+      "types": "./dist/render.d.mts",
+      "default": "./dist/render.mjs"
+    },
     "./package.json": "./package.json"
   },
   "bin": {