markform 0.1.23 → 0.1.25

package/examples/simple/simple.session.yaml

@@ -152,6 +152,19 @@ turns:
         | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
         | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+        ## Incremental Operations (for collections)
+
+        Use these to add/remove items without replacing the entire collection:
+
+        | Type | Example |
+        |------|---------|
+        | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+        | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+        | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+        | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+        | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+        | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
         ## Important: checkboxes vs multi_select
 
         These two types look similar but have DIFFERENT value formats:
@@ -478,6 +491,19 @@ turns:
           | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
           | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+          ## Incremental Operations (for collections)
+
+          Use these to add/remove items without replacing the entire collection:
+
+          | Type | Example |
+          |------|---------|
+          | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+          | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+          | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+          | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+          | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+          | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
           ## Important: checkboxes vs multi_select
 
           These two types look similar but have DIFFERENT value formats:
@@ -980,6 +1006,19 @@ turns:
         | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
         | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+        ## Incremental Operations (for collections)
+
+        Use these to add/remove items without replacing the entire collection:
+
+        | Type | Example |
+        |------|---------|
+        | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+        | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+        | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+        | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+        | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+        | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
         ## Important: checkboxes vs multi_select
 
         These two types look similar but have DIFFERENT value formats:
@@ -1330,6 +1369,19 @@ turns:
           | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
           | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+          ## Incremental Operations (for collections)
+
+          Use these to add/remove items without replacing the entire collection:
+
+          | Type | Example |
+          |------|---------|
+          | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+          | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+          | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+          | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+          | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+          | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
           ## Important: checkboxes vs multi_select
 
           These two types look similar but have DIFFERENT value formats:
@@ -1770,6 +1822,19 @@ turns:
         | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
         | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+        ## Incremental Operations (for collections)
+
+        Use these to add/remove items without replacing the entire collection:
+
+        | Type | Example |
+        |------|---------|
+        | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+        | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+        | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+        | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+        | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+        | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
         ## Important: checkboxes vs multi_select
 
         These two types look similar but have DIFFERENT value formats:
@@ -2095,6 +2160,19 @@ turns:
           | checkboxes | `{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }` |
           | table | `{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }` |
 
+          ## Incremental Operations (for collections)
+
+          Use these to add/remove items without replacing the entire collection:
+
+          | Type | Example |
+          |------|---------|
+          | append_table | `{ op: "append_table", fieldId: "team", value: [{ "name": "Bob", "role": "PM" }] }` |
+          | append_string_list | `{ op: "append_string_list", fieldId: "tags", value: ["new_tag"] }` |
+          | append_url_list | `{ op: "append_url_list", fieldId: "sources", value: ["https://new.com"] }` |
+          | delete_table | `{ op: "delete_table", fieldId: "team", value: 0 }` (0-based row index) |
+          | delete_string_list | `{ op: "delete_string_list", fieldId: "tags", value: 0 }` (0-based item index) |
+          | delete_url_list | `{ op: "delete_url_list", fieldId: "sources", value: 0 }` (0-based item index) |
+
           ## Important: checkboxes vs multi_select
 
           These two types look similar but have DIFFERENT value formats:

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

@@ -154,7 +154,7 @@ 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"]
+   columnTypes=["string", "string", {"type": "string", "enum": ["thesis", "supporting", "example", "context", "contrarian", "actionable"]}]
    minRows=5 maxRows=20 -->
 
 | Insight/Claim | Why It Matters | Type |
@@ -188,7 +188,7 @@ 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"]
+   columnTypes=[{"type": "number", "min": 1, "integer": true}, "string", {"type": "string", "enum": ["hook", "context", "main_point", "example", "pivot", "summary", "cta"]}, {"type": "string", "enum": ["yes", "no"]}]
    minRows=5 maxRows=15 -->
 
 | Rank | Insight (summary) | Thread Role | Include? |
@@ -237,7 +237,7 @@ 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"]
+   columnTypes=[{"type": "number", "min": 1, "integer": true}, {"type": "string", "enum": ["hook", "context", "main_point", "example", "pivot", "summary", "cta"]}, "string", "string"]
    minRows=5 maxRows=20 -->
 
 | # | Role | Content Plan | From Insight |
@@ -266,7 +266,7 @@ 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"]
+   columnTypes=[{"type": "number", "min": 1, "integer": true}, {"type": "string", "maxLength": 280}, {"type": "number", "min": 1, "max": 280, "integer": true}, "string"]
    minRows=5 maxRows=20 -->
 
 | # | Draft Content | Chars | Issues |
@@ -299,7 +299,7 @@ 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"]
+   columnTypes=[{"type": "number", "min": 1, "integer": true}, {"type": "string", "enum": ["yes", "no"]}, {"type": "string", "enum": ["yes", "no"]}, {"type": "string", "enum": ["yes", "no", "na"]}, {"type": "string", "enum": ["yes", "no"]}, "string"]
    minRows=5 maxRows=20 -->
 
 | # | ≤280? | Clear? | Flows? | Standalone? | Revision |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
@@ -92,7 +92,7 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "copy-docs": "cp ../../README.md . && mkdir -p docs && cp ../../docs/markform-spec.md docs/ && cp ../../docs/markform-reference.md docs/ && cp ../../docs/markform-apis.md docs/",
+    "copy-docs": "cp ../../README.md . && mkdir -p docs docs/skill && cp ../../docs/markform-spec.md docs/ && cp ../../docs/markform-reference.md docs/ && cp ../../docs/markform-apis.md docs/ && cp ../../docs/skill/SKILL.md docs/skill/",
     "build": "pnpm run copy-docs && tsdown",
     "dev": "tsdown --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",