open-agreements
Version:
Open-source legal template filling CLI and library
96 lines (73 loc) • 4.23 kB
Markdown
Field-selector for the NVCA Model Voting Agreement (version 10-1-2025).
## Source
The source document is freely downloadable from [NVCA](https://nvca.org) but is not
redistributable. This field-selector contains only transformation instructions.
## Usage
```bash
# Full pipeline (auto-downloads from NVCA)
open-agreements field-selector run nvca-voting-agreement -d values.json -o voting-agreement.docx
# With a local copy of the source document
open-agreements field-selector run nvca-voting-agreement -i NVCA-Voting-Agreement.docx -d values.json -o voting-agreement.docx
# Individual stages
open-agreements field-selector clean source.docx -o cleaned.docx --field-selector nvca-voting-agreement
open-agreements field-selector patch cleaned.docx -o patched.docx --field-selector nvca-voting-agreement
```
## Values File
Create a JSON file with the field values:
```json
{
"company_name": "Acme Corp",
"company_name_upper": "ACME CORP",
"state_of_incorporation": "Delaware",
"investor_1_name": "Sequoia Capital Fund XIV",
"investor_1_designee": "Michael Moritz",
"series_name": "Series A",
"company_counsel": "Wilson Sonsini, 650 Page Mill Road, Palo Alto, CA 94304",
"investor_counsel": "Cooley LLP, 3175 Hanover Street, Palo Alto, CA 94304",
"effective_date": "January 15, 2025",
"drag_along_percentage": "sixty percent (60%)",
"board_size": "five (5)",
"notice_period_days": "120",
"judicial_district": "Northern District of California",
"key_holder_name": "Jane Doe"
}
```
1. **Clean**: Removes explanatory footnotes and drafting notes ("Note to Drafter:", "Preliminary Note")
2. **Patch**: Replaces 33 bracketed placeholders with template tags, handling Word's split-run XML
3. **Fill**: Renders template tags with your values using docx-templates
4. **Verify**: Confirms all values appear, no leftover placeholders or unrendered tags remain
## Option Vesting Policy Computation
The NVCA voting agreement field-selector includes option-vesting policy computation
coverage for deterministic derived values. When option-vesting inputs select a
policy profile, computed outputs reflect the selected vesting treatment and the
exported trace records the rule path used to derive those outputs.
The NVCA option resolution engine applies clause-level policies including
costs-of-enforcement and dispute-resolution, defaulting venue and district
values. Costs-of-enforcement policy retains only the each-party clause. When
dispute-resolution selects arbitration, venue defaults are applied. When courts
are selected, district defaults by state with alignment flags. When no explicit
clause policy is defined for an in-line legal alternative, the alternative text
is preserved unresolved until a policy is added.
## Assumption Validation
Template assumption validation confirms that required NVCA field-selector assumptions
are explicit and machine-checkable. When bundled NVCA field-selector assumptions are
validated, missing or inconsistent assumptions fail validation with actionable
messages rather than silently producing a filled document.
NVCA template processing preserves bracket-prefixed headings while removing
bracketed alternatives during clean, and normalizes heading-leading brackets
during the normalize step.
## Behavioral Scenarios
### [OA-FIL-018] NVCA clause policy resolution
- **WHEN** costs-of-enforcement policy is applied
- **THEN** only the each-party clause is retained
- **AND** when dispute-resolution selects arbitration, venue defaults are applied
- **AND** when courts are selected, district defaults by state with alignment flags
### [OA-FIL-019] Unresolved legal alternatives preserved
- **WHEN** no explicit clause policy is defined for an in-line legal alternative
- **THEN** the alternative text is preserved unresolved until a policy is added
### [OA-TMP-018] NVCA clean and normalize assumptions
- **WHEN** the clean step processes bracket-prefixed headings and bracketed alternatives
- **THEN** bracket-prefixed headings are preserved while bracketed alternatives are removed
- **AND** declarative normalize strips heading-leading brackets and trims unmatched trailing brackets