open-agreements 0.1.0

package/external/README.md

@@ -0,0 +1,38 @@
+# External Templates
+
+This directory contains third-party standard-form legal documents that are redistributable under **CC BY-ND 4.0** but must not be modified. The `template.docx` files here are unmodified copies of the originals published by their respective authors.
+
+## How It Works
+
+Unlike templates in `templates/` (which contain pre-baked `{tag}` placeholders), external templates store the original document as-is. At fill time, the CLI applies bracket-to-tag replacement in a temporary directory, fills the values, and produces an output file. The committed source is never altered.
+
+## Contents
+
+| Directory | Document | Publisher |
+|-----------|----------|-----------|
+| `yc-safe-valuation-cap/` | Post-Money SAFE — Valuation Cap | Y Combinator |
+| `yc-safe-discount/` | Post-Money SAFE — Discount | Y Combinator |
+| `yc-safe-mfn/` | Post-Money SAFE — MFN | Y Combinator |
+| `yc-safe-pro-rata-side-letter/` | Pro Rata Side Letter | Y Combinator |
+
+## Each Directory Contains
+
+- `template.docx` — Unmodified original DOCX from the publisher
+- `metadata.yaml` — Zod-validated schema with fields, source URL, license info, and `source_sha256` integrity hash
+- `replacements.json` — Bracket-to-tag mapping used at fill time
+- `clean.json` — Optional cleanup config (footnotes, notes to drafter)
+- `README.md` — Attribution, source link, usage notes
+
+## Updating External Templates
+
+When a publisher releases a new version:
+
+1. Re-download the DOCX from the official `source_url` (never re-save through Microsoft Word)
+2. Update `source_sha256` in `metadata.yaml` with the new file's SHA-256 hash
+3. Update `version` in `metadata.yaml`
+4. Re-test the replacement mappings with `open-agreements scan` and a test fill
+5. Run `open-agreements validate` to confirm integrity
+
+## License
+
+See [LICENSE](./LICENSE) for full attribution and license details.

package/external/yc-safe-discount/README.md

@@ -0,0 +1,16 @@
+# YC Post-Money SAFE — Discount
+
+Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a discount rate and no valuation cap.
+
+## Source
+
+- **Document**: Post-Money SAFE — Discount Only
+- **Publisher**: Y Combinator
+- **URL**: https://www.ycombinator.com/documents
+- **License**: CC BY-ND 4.0
+
+## License Notice
+
+This document is redistributed under the Creative Commons Attribution-NoDerivatives 4.0 International license (CC BY-ND 4.0). The `template.docx` file in this directory is an unmodified copy of the original as published by Y Combinator.
+
+You may fill in the blanks for your own use. Do not redistribute modified versions of the document itself. See https://creativecommons.org/licenses/by-nd/4.0/ for full license terms.

package/external/yc-safe-discount/clean.json

@@ -0,0 +1,4 @@
+{
+  "removeFootnotes": false,
+  "removeParagraphPatterns": []
+}

package/external/yc-safe-discount/metadata.yaml

@@ -0,0 +1,71 @@
+name: YC Post-Money SAFE — Discount
+description: >-
+  Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a
+  discount rate and no valuation cap.
+source_url: https://www.ycombinator.com/documents
+version: "2024.12"
+license: CC-BY-ND-4.0
+allow_derivatives: false
+attribution_text: >-
+  Based on the Y Combinator Post-Money SAFE, available at
+  https://www.ycombinator.com/documents. Licensed under CC BY-ND 4.0.
+  Copyright Y Combinator.
+source_sha256: 93d606fc568e39673ab96c581850ece30b4f478972b7b4d4d132df695264b5a5
+fields:
+  - name: company_name
+    type: string
+    description: Full legal name of the company
+    required: true
+    section: Parties
+  - name: investor_name
+    type: string
+    description: Full legal name of the investor
+    required: true
+    section: Parties
+  - name: purchase_amount
+    type: string
+    description: Dollar amount of the investment (e.g., "100,000")
+    required: true
+    section: Deal Terms
+  - name: discount_rate
+    type: string
+    description: >-
+      Discount rate as a percentage, expressed as 100 minus the discount
+      (e.g., "80" for a 20% discount)
+    required: true
+    section: Deal Terms
+  - name: date_of_safe
+    type: date
+    description: Date the SAFE is executed
+    required: true
+    section: Deal Terms
+  - name: state_of_incorporation
+    type: string
+    description: State where the company is incorporated (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: governing_law_jurisdiction
+    type: string
+    description: State whose laws govern the agreement (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: company
+    type: string
+    description: Company name as used in the signature block (typically matches company_name)
+    required: true
+    section: Signatures
+  - name: company_name_caps
+    type: string
+    description: Company name in uppercase as used in the header (e.g., "ACME INC.")
+    required: true
+    section: Signatures
+  - name: name
+    type: string
+    description: Name of the company signatory
+    required: true
+    section: Signatures
+  - name: title
+    type: string
+    description: Title of the company signatory (e.g., "CEO")
+    required: true
+    section: Signatures

package/external/yc-safe-discount/replacements.json

@@ -0,0 +1,13 @@
+{
+  "[Company Name]": "{company_name}",
+  "[Investor Name]": "{investor_name}",
+  "[__________]": "{purchase_amount}",
+  "[100 minus the discount]": "{discount_rate}",
+  "[Date of Safe]": "{date_of_safe}",
+  "[State of Incorporation]": "{state_of_incorporation}",
+  "[Governing Law Jurisdiction]": "{governing_law_jurisdiction}",
+  "[COMPANY]": "{company}",
+  "[COMPANY NAME]": "{company_name_caps}",
+  "[name]": "{name}",
+  "[title]": "{title}"
+}

package/external/yc-safe-mfn/README.md

@@ -0,0 +1,16 @@
+# YC Post-Money SAFE — MFN
+
+Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a most favored nation (MFN) provision, no valuation cap, and no discount.
+
+## Source
+
+- **Document**: Post-Money SAFE — MFN Only
+- **Publisher**: Y Combinator
+- **URL**: https://www.ycombinator.com/documents
+- **License**: CC BY-ND 4.0
+
+## License Notice
+
+This document is redistributed under the Creative Commons Attribution-NoDerivatives 4.0 International license (CC BY-ND 4.0). The `template.docx` file in this directory is an unmodified copy of the original as published by Y Combinator.
+
+You may fill in the blanks for your own use. Do not redistribute modified versions of the document itself. See https://creativecommons.org/licenses/by-nd/4.0/ for full license terms.

package/external/yc-safe-mfn/clean.json

@@ -0,0 +1,4 @@
+{
+  "removeFootnotes": false,
+  "removeParagraphPatterns": []
+}

package/external/yc-safe-mfn/metadata.yaml

@@ -0,0 +1,64 @@
+name: YC Post-Money SAFE — MFN
+description: >-
+  Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a
+  most favored nation (MFN) provision, no valuation cap, and no discount.
+source_url: https://www.ycombinator.com/documents
+version: "2024.12"
+license: CC-BY-ND-4.0
+allow_derivatives: false
+attribution_text: >-
+  Based on the Y Combinator Post-Money SAFE, available at
+  https://www.ycombinator.com/documents. Licensed under CC BY-ND 4.0.
+  Copyright Y Combinator.
+source_sha256: d3ad99466059b6f4d838e8e5daeeff5752e9866e6b557c6056df772f8509e727
+fields:
+  - name: company_name
+    type: string
+    description: Full legal name of the company
+    required: true
+    section: Parties
+  - name: investor_name
+    type: string
+    description: Full legal name of the investor
+    required: true
+    section: Parties
+  - name: purchase_amount
+    type: string
+    description: Dollar amount of the investment (e.g., "100,000")
+    required: true
+    section: Deal Terms
+  - name: date_of_safe
+    type: date
+    description: Date the SAFE is executed
+    required: true
+    section: Deal Terms
+  - name: state_of_incorporation
+    type: string
+    description: State where the company is incorporated (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: governing_law_jurisdiction
+    type: string
+    description: State whose laws govern the agreement (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: company
+    type: string
+    description: Company name as used in the signature block (typically matches company_name)
+    required: true
+    section: Signatures
+  - name: company_name_caps
+    type: string
+    description: Company name in uppercase as used in the header (e.g., "ACME INC.")
+    required: true
+    section: Signatures
+  - name: name
+    type: string
+    description: Name of the company signatory
+    required: true
+    section: Signatures
+  - name: title
+    type: string
+    description: Title of the company signatory (e.g., "CEO")
+    required: true
+    section: Signatures

package/external/yc-safe-mfn/replacements.json

@@ -0,0 +1,12 @@
+{
+  "[Company Name]": "{company_name}",
+  "[Investor Name]": "{investor_name}",
+  "[_____________]": "{purchase_amount}",
+  "[Date of Safe]": "{date_of_safe}",
+  "[State of Incorporation]": "{state_of_incorporation}",
+  "[Governing Law Jurisdiction]": "{governing_law_jurisdiction}",
+  "[COMPANY]": "{company}",
+  "[COMPANY NAME]": "{company_name_caps}",
+  "[name]": "{name}",
+  "[title]": "{title}"
+}

package/external/yc-safe-pro-rata-side-letter/README.md

@@ -0,0 +1,16 @@
+# YC Pro Rata Side Letter
+
+Y Combinator's Pro Rata Side Letter, granting the investor pro rata rights in connection with a Post-Money SAFE investment.
+
+## Source
+
+- **Document**: Pro Rata Side Letter
+- **Publisher**: Y Combinator
+- **URL**: https://www.ycombinator.com/documents
+- **License**: CC BY-ND 4.0
+
+## License Notice
+
+This document is redistributed under the Creative Commons Attribution-NoDerivatives 4.0 International license (CC BY-ND 4.0). The `template.docx` file in this directory is an unmodified copy of the original as published by Y Combinator.
+
+You may fill in the blanks for your own use. Do not redistribute modified versions of the document itself. See https://creativecommons.org/licenses/by-nd/4.0/ for full license terms.

package/external/yc-safe-pro-rata-side-letter/clean.json

@@ -0,0 +1,4 @@
+{
+  "removeFootnotes": false,
+  "removeParagraphPatterns": []
+}

package/external/yc-safe-pro-rata-side-letter/metadata.yaml

@@ -0,0 +1,49 @@
+name: YC Pro Rata Side Letter
+description: >-
+  Y Combinator's Pro Rata Side Letter, granting the investor pro rata rights
+  in connection with a Post-Money SAFE investment.
+source_url: https://www.ycombinator.com/documents
+version: "2024.12"
+license: CC-BY-ND-4.0
+allow_derivatives: false
+attribution_text: >-
+  Based on the Y Combinator Pro Rata Side Letter, available at
+  https://www.ycombinator.com/documents. Licensed under CC BY-ND 4.0.
+  Copyright Y Combinator.
+source_sha256: 9b769a6a724da0c40e6649df8c774f49cc20dafe7247cc366ce4b98b4c2a3510
+fields:
+  - name: company_name
+    type: string
+    description: Full legal name of the company
+    required: true
+    section: Parties
+  - name: investor_name
+    type: string
+    description: Full legal name of the investor
+    required: true
+    section: Parties
+  - name: date_of_safe
+    type: date
+    description: Date of the related SAFE agreement
+    required: true
+    section: Deal Terms
+  - name: company_name_caps
+    type: string
+    description: Company name in uppercase as used in the header (e.g., "ACME INC.")
+    required: true
+    section: Signatures
+  - name: investor_name_caps
+    type: string
+    description: Investor name in uppercase as used in the header (e.g., "JANE DOE")
+    required: true
+    section: Signatures
+  - name: name
+    type: string
+    description: Name of the company signatory
+    required: true
+    section: Signatures
+  - name: title
+    type: string
+    description: Title of the company signatory (e.g., "CEO")
+    required: true
+    section: Signatures

package/external/yc-safe-pro-rata-side-letter/replacements.json

@@ -0,0 +1,9 @@
+{
+  "[Company Name]": "{company_name}",
+  "[Investor Name]": "{investor_name}",
+  "[Date of Safe]": "{date_of_safe}",
+  "[COMPANY NAME]": "{company_name_caps}",
+  "[INVESTOR NAME]": "{investor_name_caps}",
+  "[name]": "{name}",
+  "[title]": "{title}"
+}

package/external/yc-safe-valuation-cap/README.md

@@ -0,0 +1,16 @@
+# YC Post-Money SAFE — Valuation Cap
+
+Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a valuation cap and no discount.
+
+## Source
+
+- **Document**: Post-Money SAFE — Valuation Cap Only
+- **Publisher**: Y Combinator
+- **URL**: https://www.ycombinator.com/documents
+- **License**: CC BY-ND 4.0
+
+## License Notice
+
+This document is redistributed under the Creative Commons Attribution-NoDerivatives 4.0 International license (CC BY-ND 4.0). The `template.docx` file in this directory is an unmodified copy of the original as published by Y Combinator.
+
+You may fill in the blanks for your own use. Do not redistribute modified versions of the document itself. See https://creativecommons.org/licenses/by-nd/4.0/ for full license terms.

package/external/yc-safe-valuation-cap/clean.json

@@ -0,0 +1,4 @@
+{
+  "removeFootnotes": false,
+  "removeParagraphPatterns": []
+}

package/external/yc-safe-valuation-cap/metadata.yaml

@@ -0,0 +1,64 @@
+name: YC Post-Money SAFE — Valuation Cap
+description: >-
+  Y Combinator's Post-Money SAFE (Simple Agreement for Future Equity) with a
+  valuation cap and no discount. The most common early-stage investment instrument.
+source_url: https://www.ycombinator.com/documents
+version: "2024.12"
+license: CC-BY-ND-4.0
+allow_derivatives: false
+attribution_text: >-
+  Based on the Y Combinator Post-Money SAFE, available at
+  https://www.ycombinator.com/documents. Licensed under CC BY-ND 4.0.
+  Copyright Y Combinator.
+source_sha256: 185d24f5bcf13acdf1419bf1d420771088da5dea3b3f3e0cdc7fa5df643649c4
+fields:
+  - name: company_name
+    type: string
+    description: Full legal name of the company
+    required: true
+    section: Parties
+  - name: investor_name
+    type: string
+    description: Full legal name of the investor
+    required: true
+    section: Parties
+  - name: purchase_amount
+    type: string
+    description: Dollar amount of the investment (e.g., "100,000")
+    required: true
+    section: Deal Terms
+  - name: valuation_cap
+    type: string
+    description: Post-money valuation cap in dollars (e.g., "10,000,000")
+    required: true
+    section: Deal Terms
+  - name: date_of_safe
+    type: date
+    description: Date the SAFE is executed
+    required: true
+    section: Deal Terms
+  - name: state_of_incorporation
+    type: string
+    description: State where the company is incorporated (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: governing_law_jurisdiction
+    type: string
+    description: State whose laws govern the agreement (e.g., "Delaware")
+    required: true
+    section: Company Details
+  - name: company
+    type: string
+    description: Company name as used in the signature block (typically matches company_name)
+    required: true
+    section: Signatures
+  - name: name
+    type: string
+    description: Name of the company signatory
+    required: true
+    section: Signatures
+  - name: title
+    type: string
+    description: Title of the company signatory (e.g., "CEO")
+    required: true
+    section: Signatures

package/external/yc-safe-valuation-cap/replacements.json

@@ -0,0 +1,12 @@
+{
+  "[Company Name]": "{company_name}",
+  "[Investor Name]": "{investor_name}",
+  "$[_____________] (the \u201cPurchase Amount\u201d)": "${purchase_amount} (the \u201cPurchase Amount\u201d)",
+  "$[_____________].": "${valuation_cap}.",
+  "[Date of Safe]": "{date_of_safe}",
+  "[State of Incorporation]": "{state_of_incorporation}",
+  "[Governing Law Jurisdiction]": "{governing_law_jurisdiction}",
+  "[COMPANY]": "{company}",
+  "[name]": "{name}",
+  "[title]": "{title}"
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "open-agreements",
+  "version": "0.1.0",
+  "description": "Open-source legal template filling CLI and library",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/open-agreements/open-agreements.git"
+  },
+  "homepage": "https://github.com/open-agreements/open-agreements#readme",
+  "bugs": {
+    "url": "https://github.com/open-agreements/open-agreements/issues"
+  },
+  "type": "module",
+  "bin": {
+    "open-agreements": "./bin/open-agreements.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "templates/",
+    "external/",
+    "recipes/",
+    "skills/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint src/",
+    "validate": "node bin/open-agreements.js validate",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "legal",
+    "templates",
+    "nda",
+    "agreements",
+    "docx",
+    "contract"
+  ],
+  "author": "UseJunior <steven@usejunior.com>",
+  "license": "MIT",
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "commander": "^13.1.0",
+    "docx-templates": "^4.13.0",
+    "@xmldom/xmldom": "^0.9.5",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.13.0",
+    "@eslint/js": "^9.39.2",
+    "docx": "^9.5.1",
+    "eslint": "^9.19.0",
+    "globals": "^14.0.0",
+    "typescript-eslint": "^8.54.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/recipes/nvca-certificate-of-incorporation/clean.json

@@ -0,0 +1,8 @@
+{
+  "removeFootnotes": true,
+  "removeParagraphPatterns": [
+    "^Note to Drafter:",
+    "^Preliminary Note\\b",
+    "^Use the following"
+  ]
+}

package/recipes/nvca-certificate-of-incorporation/metadata.yaml

@@ -0,0 +1,43 @@
+name: NVCA Model Certificate of Incorporation
+description: >-
+  Amended and restated certificate of incorporation for venture-backed Delaware
+  corporations, defining preferred stock rights, preferences, and privileges.
+source_url: https://nvca.org/wp-content/uploads/2025/10/NVCA-Model-COI-10-1-2025.docx
+source_version: "10-1-2025"
+license_note: >-
+  NVCA model documents are freely downloadable but not redistributable.
+  This recipe contains only transformation instructions, not the source document.
+source_sha256: d75600769c12724990de48149d7a2bb161f3522daa54b1783672f93697d87d29
+optional: false
+fields:
+  - name: original_issue_price
+    type: string
+    description: Original purchase price per share of Series A Preferred Stock
+    required: true
+  - name: initial_purchase_price
+    type: string
+    description: Initial Series A purchase price per share
+    required: true
+  - name: signature_page_marker
+    type: string
+    description: Signature page marker text
+    required: false
+    default: Signature Page Follows
+  - name: time_zone
+    type: string
+    description: Time zone for notices and deadlines (e.g., Eastern, Pacific)
+    required: true
+    default: Eastern
+  - name: par_value
+    type: string
+    description: Par value per share of common and preferred stock
+    required: true
+    default: "0.001"
+  - name: specify_percentage
+    type: string
+    description: Percentage threshold for specified provisions
+    required: true
+  - name: effective_date
+    type: date
+    description: Effective date of the certificate of incorporation
+    required: true

package/recipes/nvca-certificate-of-incorporation/replacements.json

@@ -0,0 +1,9 @@
+{
+  "[insert original purchase price of Series A Preferred Stock]": "{original_issue_price}",
+  "[insert initial Series A purchase price]": "{initial_purchase_price}",
+  "[Signature Page Follows]": "{signature_page_marker}",
+  "[Eastern/Pacific]": "{time_zone}",
+  "[$0.001]": "${par_value}",
+  "[specify percentage]": "{specify_percentage}",
+  "[________ __, 20__]": "{effective_date}"
+}

package/recipes/nvca-certificate-of-incorporation/schema.json

@@ -0,0 +1,11 @@
+{
+  "fields": [
+    { "name": "original_issue_price", "type": "string", "description": "Original purchase price per share of Series A Preferred Stock" },
+    { "name": "initial_purchase_price", "type": "string", "description": "Initial Series A purchase price per share" },
+    { "name": "signature_page_marker", "type": "string", "description": "Signature page marker text" },
+    { "name": "time_zone", "type": "string", "description": "Time zone for notices and deadlines (e.g., Eastern, Pacific)" },
+    { "name": "par_value", "type": "string", "description": "Par value per share of common and preferred stock" },
+    { "name": "specify_percentage", "type": "string", "description": "Percentage threshold for specified provisions" },
+    { "name": "effective_date", "type": "date", "description": "Effective date of the certificate of incorporation" }
+  ]
+}

package/recipes/nvca-indemnification-agreement/clean.json

@@ -0,0 +1,7 @@
+{
+  "removeFootnotes": false,
+  "removeParagraphPatterns": [
+    "^Comment:",
+    "^NOTE:"
+  ]
+}