markform 0.1.8 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,801 +0,0 @@
1
-
2
- > markform-workspace@ markform /Users/levy/wrk/aisw/markform
3
- > node packages/markform/dist/bin.mjs export packages/markform/examples/earnings-analysis/earnings-analysis.form.md --format markdown
4
-
5
- # Company Quarterly Analysis Worksheet
6
-
7
- This worksheet supports systematic research on a company for a given quarter.It has two parts: a relatively static company profile, and a period-specific analysis section.
8
-
9
- Part 1: Company Profile — Foundational information that changes slowly.Update as needed but expect most content to persist quarter-to-quarter.Part 2: Quarterly Analysis — Period-specific analysis.Complete fresh each quarter.
10
-
11
- ## 1. Identity and Structure
12
-
13
- **Company legal name:**
14
- _(empty)_
15
-
16
- **Ticker(s):**
17
- _(empty)_
18
-
19
- List at least one ticker symbol. Add multiple if the company trades on different exchanges.
20
-
21
- **HQ / key operating regions:**
22
- _(empty)_
23
-
24
- **Fiscal year end:**
25
- _(empty)_
26
-
27
- Enter month name (e.g., December) or MM-DD format (e.g., 12-31).
28
-
29
- **Reporting cadence:**
30
- _(none selected)_
31
-
32
- **Business model type:**
33
- _(none selected)_
34
-
35
- Check all that apply. At least one is required.
36
-
37
- **Other business model (if applicable):**
38
- _(empty)_
39
-
40
- Describe any other business model types not covered above.
41
-
42
- **Subsidiaries / key entities:**
43
- _(empty)_
44
-
45
- **One-paragraph summary (plain English):**
46
- _(empty)_
47
-
48
- Provide a plain-English summary of what the company does. Minimum 100 words (approximately 400 characters).
49
-
50
- ## 2. History and Evolution
51
-
52
- **Timeline (key pivots):**
53
- _(empty)_
54
-
55
- List 8-12 key pivotal moments in the company's history. One event per line.
56
-
57
- **Transformative acquisitions / divestitures:**
58
- _(empty)_
59
-
60
- **Leadership changes that mattered:**
61
- _(empty)_
62
-
63
- **Past crises and responses:**
64
- _(empty)_
65
-
66
- **What single strategic move best explains the current model?:**
67
- _(empty)_
68
-
69
- Analyst prompt: Explain the strategic move that best explains the current business model. Minimum 50 words.
70
-
71
- ## 3. Operations and Distribution
72
-
73
- **Core operating activities (R&D, manufacturing, distribution):**
74
- _(empty)_
75
-
76
- **Key locations (R&D hubs, manufacturing, data centers):**
77
- _(empty)_
78
-
79
- **Distribution model:**
80
- _(none selected)_
81
-
82
- **Other distribution model (if applicable):**
83
- _(empty)_
84
-
85
- **Mix of direct vs indirect (if disclosed):**
86
- _(empty)_
87
-
88
- Enter percentages that should sum to 100% (e.g., "Direct: 60%, Indirect: 40%").
89
-
90
- **Key partners required to deliver the product:**
91
- _(empty)_
92
-
93
- **Capacity constraints / bottlenecks:**
94
- _(empty)_
95
-
96
- ## 4.1 Offerings - Primary Family
97
-
98
- Tie every revenue line to something someone buys. Use "families," not SKUs.This section ideally uses repeating groups (future feature). For now, model one offering family.
99
-
100
- **Offering family name:**
101
- _(empty)_
102
-
103
- **Value proposition (1 sentence):**
104
- _(empty)_
105
-
106
- Maximum 50 words. Describe the core value in one sentence.
107
-
108
- **Delivery type:**
109
- _(none selected)_
110
-
111
- **Revenue type:**
112
- _(none selected)_
113
-
114
- **Primary KPIs:**
115
- _(empty)_
116
-
117
- ## 4.2 Offerings - Bundles and Cross-Sell
118
-
119
- **What is bundled?:**
120
- _(empty)_
121
-
122
- **Attach paths (what gets added after first purchase):**
123
- _(empty)_
124
-
125
- **Cannibalization risks:**
126
- _(empty)_
127
-
128
- ## 5.1 Pricing Structure
129
-
130
- Make "pricing power" concrete.
131
-
132
- **Offering family:**
133
- _(empty)_
134
-
135
- **List price / typical range:**
136
- _(empty)_
137
-
138
- Include currency and range (e.g., "$99-$499 USD" or "€50/month").
139
-
140
- **Discounting norms:**
141
- _(none selected)_
142
-
143
- **Contract length (B2B):**
144
- _(empty)_
145
-
146
- **Renewal terms:**
147
- _(empty)_
148
-
149
- **Price escalators:**
150
- _(empty)_
151
-
152
- **Who pays vs who uses:**
153
- _(empty)_
154
-
155
- **ARPU/ASP drivers:**
156
- _(empty)_
157
-
158
- **Pricing changes last 12-18 months:**
159
- _(empty)_
160
-
161
- ## 5.2 Margin and Cost Structure
162
-
163
- **Primary cost drivers (COGS, hosting, labor, content, etc.):**
164
- _(empty)_
165
-
166
- **Gross margin drivers (pricing, mix, utilization, scale, FX):**
167
- _(empty)_
168
-
169
- **Contribution margin framework (if applicable):**
170
- _(empty)_
171
-
172
- **Customer Acquisition Cost (CAC):**
173
- _(empty)_
174
-
175
- **Payback period:**
176
- _(empty)_
177
-
178
- **Lifetime Value (LTV):**
179
- _(empty)_
180
-
181
- **Churn rate (%):**
182
- _(empty)_
183
-
184
- **Operating leverage (fixed vs variable costs):**
185
- _(empty)_
186
-
187
- **Biggest margin risks:**
188
- _(empty)_
189
-
190
- ## 6.1 Customer Segmentation
191
-
192
- **Segment 1 (size, needs, willingness to pay):**
193
- _(empty)_
194
-
195
- **Segment 2:**
196
- _(empty)_
197
-
198
- **Segment 3:**
199
- _(empty)_
200
-
201
- **Geography mix:**
202
- _(empty)_
203
-
204
- Enter percentages that should sum to 100% (e.g., "Americas: 55%, EMEA: 30%, APAC: 15%").
205
-
206
- **Buyer vs user vs influencer:**
207
- _(empty)_
208
-
209
- ## 6.2 Buying Motion
210
-
211
- **What triggers purchase?:**
212
- _(empty)_
213
-
214
- **Decision cycle length:**
215
- _(empty)_
216
-
217
- **Replacement/upgrade cycle (if relevant):**
218
- _(empty)_
219
-
220
- **Retention/churn drivers (if recurring):**
221
- _(empty)_
222
-
223
- ## 6.3 Concentration and Notable Customers
224
-
225
- **Customer concentration risk (top customer %):**
226
- _(empty)_
227
-
228
- **Notable customers / logos (B2B):**
229
- _(empty)_
230
-
231
- **Channel partner dependencies:**
232
- _(empty)_
233
-
234
- ## 7. Market and Competition
235
-
236
- **Primary markets competed in:**
237
- _(empty)_
238
-
239
- **TAM/SAM/SOM (and confidence):**
240
- _(empty)_
241
-
242
- Include currency values with confidence level (e.g., "TAM: $50B (high), SAM: $10B (medium), SOM: $500M (low)").
243
-
244
- **Market growth rate and cyclicality:**
245
- _(empty)_
246
-
247
- **Competitors by category (direct + substitutes):**
248
- _(empty)_
249
-
250
- **Basis of competition (ranked top 5):**
251
- _(empty)_
252
-
253
- List exactly 5 competitive factors, ranked by importance. First item is most important.
254
-
255
- **Moat diagnosis:**
256
- _(none selected)_
257
-
258
- **Moat explanation:**
259
- _(empty)_
260
-
261
- Required if any moat is checked above. Explain why these moats apply. Minimum 25 words.
262
-
263
- **Competitive risks (price wars, bundling, platform shifts):**
264
- _(empty)_
265
-
266
- ## 8.1 Supply Constraints
267
-
268
- **Key inputs / suppliers / single-source dependencies:**
269
- _(empty)_
270
-
271
- **Manufacturing/fulfillment model:**
272
- _(empty)_
273
-
274
- **Critical commodities / bottlenecks:**
275
- _(empty)_
276
-
277
- **Logistics and inventory risks:**
278
- _(empty)_
279
-
280
- **Geopolitical choke points:**
281
- _(empty)_
282
-
283
- ## 8.2 Macro Sensitivity
284
-
285
- **Top 5 macro variables that historically mattered:**
286
- _(empty)_
287
-
288
- List exactly 5 macro variables, ranked by importance.
289
-
290
- **Transmission mechanism (how each impacts revenue/margin/cash):**
291
- _(empty)_
292
-
293
- Minimum 50 words. Explain how each macro variable impacts the business.
294
-
295
- **Historical episodes (recession/inflation/FX/supply shock):**
296
- _(empty)_
297
-
298
- **Leading indicators to monitor pre-earnings:**
299
- _(empty)_
300
-
301
- ## 9. Financial History
302
-
303
- **3-5 year trend summary (revenue, margin, EPS, FCF):**
304
- _(empty)_
305
-
306
- Minimum 75 words. Cover revenue, margin, EPS, and free cash flow trends.
307
-
308
- **Capital return policy (buybacks/dividends):**
309
- _(empty)_
310
-
311
- **Major inflection points (product cycles, pricing shifts, regulation):**
312
- _(empty)_
313
-
314
- **Stock performance context (vs index/peers):**
315
- _(empty)_
316
-
317
- **Multiples context vs history:**
318
- _(empty)_
319
-
320
- ## 10. Open Questions
321
-
322
- **Top unanswered questions (ranked by impact):**
323
- _(empty)_
324
-
325
- **How to answer (data / calls / sources):**
326
- _(empty)_
327
-
328
- **Deadline (before earnings, next quarter, etc.):**
329
- _(empty)_
330
-
331
- Enter a date (YYYY-MM-DD format) or descriptive text (e.g., "Before Q2 earnings").
332
-
333
- ## Q1. Cover Sheet
334
-
335
- This section is period-specific. Complete fresh each quarter.
336
-
337
- Recommended Operating Cadence:T-21 to T-14: Refresh model + read filings; pick "what matters this quarter"T-14 to T-7: Build expectations stack; peer read-across; gather alt data / checksT-7 to T-2: Base/Bull/Bear scenarios + probabilities; pre-mortem; draft trade structureT-1: Confirm options pricing + positioning; finalize risks and stopsEarnings day: Watchlist + rapid interpretation planT+1 to T+2: Post-mortem; update model; document learnings
338
-
339
- **One-sentence thesis (pre-earnings):**
340
- _(empty)_
341
-
342
- Maximum 50 words. State your core thesis before the earnings release.
343
-
344
- **What matters this quarter (top 3 drivers):**
345
- _(empty)_
346
-
347
- ## Q2.1 Sourcing Log
348
-
349
- Check what you actually used. Fill the log as you go.
350
-
351
- Maintain a log of sources accessed. Record: Date accessed, Source name, Type/tier, Link or file path, Key takeaways. At least 3 sources required.
352
-
353
- **Sources accessed (Date | Source | Type | Link | Takeaways):**
354
- _(empty)_
355
-
356
- ## Q2.2 SEC / Regulatory Documents
357
-
358
- **SEC documents reviewed:**
359
- - [ ] 10-K (latest)
360
- - [ ] 10-Q (latest)
361
- - [ ] 8-K earnings release (current quarter)
362
- - [ ] Prior quarter 8-K earnings release
363
- - [ ] Proxy (DEF 14A)
364
- - [ ] S-1 / 20-F / 6-K (if applicable)
365
- - [ ] Insider trading filings (Forms 3/4/5)
366
- - [ ] 13D/13G
367
- - [ ] 13F read-through (if relevant)
368
-
369
- ## Q2.3 Company Communications
370
-
371
- **Company communications reviewed:**
372
- - [ ] Earnings press release
373
- - [ ] Earnings call webcast/transcript
374
- - [ ] Prepared remarks + Q&A notes
375
- - [ ] Investor presentation / slide deck
376
- - [ ] Investor day materials (last 18 months)
377
- - [ ] Product announcements / pricing updates
378
- - [ ] Guidance updates / pre-announcements
379
-
380
- ## Q2.4 External / Market Sources
381
-
382
- **External sources reviewed:**
383
- - [ ] Sell-side consensus snapshot
384
- - [ ] Key sell-side notes
385
- - [ ] Relevant news (top 3 links)
386
- - [ ] Industry data
387
- - [ ] Peer earnings read-across
388
- - [ ] Options market data (implied move/IV/skew)
389
- - [ ] Short interest / borrow / CTB
390
- - [ ] Alternative data (traffic/app downloads/card spend)
391
-
392
- **Sell-side consensus source:**
393
- _(empty)_
394
-
395
- **Key sell-side analyst names:**
396
- _(empty)_
397
-
398
- **Relevant news links (top 3):**
399
- _(empty)_
400
-
401
- **Industry data source:**
402
- _(empty)_
403
-
404
- **Peer earnings tickers:**
405
- _(empty)_
406
-
407
- **Options market data source:**
408
- _(empty)_
409
-
410
- **Short interest data source:**
411
- _(empty)_
412
-
413
- **Alternative data source:**
414
- _(empty)_
415
-
416
- **Other sources used:**
417
- _(empty)_
418
-
419
- ## Q2.5 Key Experts and Analysts
420
-
421
- **Key experts (Name | Angle | Lead time | Hit rate | Tier):**
422
- _(empty)_
423
-
424
- Format each entry as: Name | Angle | Typical lead time | Hit rate assessment | Tier
425
-
426
- ## Q3. Business Model Snapshot
427
-
428
- **How the company makes money:**
429
- _(empty)_
430
-
431
- 2-4 sentences; 25-75 words explaining how the company generates revenue.
432
-
433
- **Revenue segments (Segment: X%):**
434
- _(empty)_
435
-
436
- List each segment with percentage of revenue. Format: "Segment Name: XX%". Percentages should sum to 100%.
437
-
438
- **Price changes recently?:**
439
- _(none selected)_
440
-
441
- **Price change details (if Yes):**
442
- _(empty)_
443
-
444
- **Volume/demand indicators:**
445
- _(empty)_
446
-
447
- **Mix shift risk:**
448
- _(empty)_
449
-
450
- **Key KPIs to track this quarter (KPI: why it matters):**
451
- _(empty)_
452
-
453
- Format: "KPI Name: Why it matters this quarter". 3-8 KPIs required.
454
-
455
- ## Q4.1 Income Statement
456
-
457
- **Revenue:**
458
- _(empty)_
459
-
460
- **Revenue YoY %:**
461
- _(empty)_
462
-
463
- **Revenue QoQ %:**
464
- _(empty)_
465
-
466
- **Gross margin %:**
467
- _(empty)_
468
-
469
- **Gross margin YoY (bps):**
470
- _(empty)_
471
-
472
- **Gross margin QoQ (bps):**
473
- _(empty)_
474
-
475
- **Operating margin %:**
476
- _(empty)_
477
-
478
- **Diluted EPS:**
479
- _(empty)_
480
-
481
- **Key expense drivers (R&D, SG&A):**
482
- _(empty)_
483
-
484
- **One-time items / adjustments:**
485
- _(empty)_
486
-
487
- ## Q4.2 Balance Sheet / Liquidity
488
-
489
- **Cash & equivalents:**
490
- _(empty)_
491
-
492
- **Net debt (negative for net cash):**
493
- _(empty)_
494
-
495
- **Working capital changes affecting earnings quality:**
496
- _(empty)_
497
-
498
- **Covenant / refinancing / maturity wall:**
499
- _(empty)_
500
-
501
- ## Q4.3 Cash Flow and Capital Return
502
-
503
- **Operating cash flow:**
504
- _(empty)_
505
-
506
- **Free cash flow:**
507
- _(empty)_
508
-
509
- **FCF definition used:**
510
- _(empty)_
511
-
512
- **Buybacks (amount or share count):**
513
- _(empty)_
514
-
515
- **Dividends (amount or per-share):**
516
- _(empty)_
517
-
518
- **Stock-based comp trend:**
519
- _(empty)_
520
-
521
- ## Q4.4 Quality Checks
522
-
523
- **Unusual accruals / reserve releases?:**
524
- _(none selected)_
525
-
526
- **Working capital pull-forward?:**
527
- _(none selected)_
528
-
529
- **Margin change drivers:**
530
- _(none selected)_
531
-
532
- **Margin change notes:**
533
- _(empty)_
534
-
535
- ## Q5.1 Company Guidance
536
-
537
- **Revenue guidance:**
538
- _(empty)_
539
-
540
- **Margin guidance:**
541
- _(empty)_
542
-
543
- **EPS/Op income guidance:**
544
- _(empty)_
545
-
546
- **KPI guidance:**
547
- _(empty)_
548
-
549
- **Qualitative guidance:**
550
- _(empty)_
551
-
552
- ## Q5.2 Street Consensus
553
-
554
- **Consensus as-of date:**
555
- _(empty)_
556
-
557
- **Consensus source:**
558
- _(empty)_
559
-
560
- **Consensus revenue:**
561
- _(empty)_
562
-
563
- **Consensus EPS:**
564
- _(empty)_
565
-
566
- **Consensus key KPIs:**
567
- _(empty)_
568
-
569
- ## Q5.3 Your Estimate (Base)
570
-
571
- **Your revenue estimate:**
572
- _(empty)_
573
-
574
- **Your EPS estimate:**
575
- _(empty)_
576
-
577
- **Your KPI estimates:**
578
- _(empty)_
579
-
580
- **Variance vs consensus (%):**
581
- _(empty)_
582
-
583
- ## Q5.4 Whisper / Buyside Bar
584
-
585
- Only fill if evidence-based.
586
-
587
- **Whisper revenue:**
588
- _(empty)_
589
-
590
- **Whisper EPS:**
591
- _(empty)_
592
-
593
- **Whisper evidence:**
594
- _(empty)_
595
-
596
- Required if whisper values are provided. Explain the source of whisper estimates.
597
-
598
- ## Q5.5 Market-Implied
599
-
600
- **Options implied move 1-day (%):**
601
- _(empty)_
602
-
603
- **Skew indicates:**
604
- _(none selected)_
605
-
606
- **Unusual open interest / flows:**
607
- _(empty)_
608
-
609
- ## Q6.1 Driver Model - Driver 1
610
-
611
- Simple, explicit, testable assumptions. At least 2 drivers required.
612
-
613
- **Driver name:**
614
- _(empty)_
615
-
616
- **Leading indicators observed (what/when/source):**
617
- _(empty)_
618
-
619
- **Assumption (base):**
620
- _(empty)_
621
-
622
- **Sensitivity: if +/-X%, EPS impact = Y:**
623
- _(empty)_
624
-
625
- **What breaks this assumption:**
626
- _(empty)_
627
-
628
- ## Q6.2 Driver Model - Driver 2
629
-
630
- **Driver name:**
631
- _(empty)_
632
-
633
- **Leading indicators observed:**
634
- _(empty)_
635
-
636
- **Assumption (base):**
637
- _(empty)_
638
-
639
- **Sensitivity:**
640
- _(empty)_
641
-
642
- **What breaks this assumption:**
643
- _(empty)_
644
-
645
- ## Q6.3 Driver Model - Driver 3 (optional)
646
-
647
- **Driver name:**
648
- _(empty)_
649
-
650
- **Leading indicators observed:**
651
- _(empty)_
652
-
653
- **Assumption (base):**
654
- _(empty)_
655
-
656
- **Sensitivity:**
657
- _(empty)_
658
-
659
- **What breaks this assumption:**
660
- _(empty)_
661
-
662
- ## Q6.4 Margin Bridge
663
-
664
- All margin impacts should sum to total margin change.
665
-
666
- **Mix impact (bps):**
667
- _(empty)_
668
-
669
- **Pricing impact (bps):**
670
- _(empty)_
671
-
672
- **Input costs impact (bps):**
673
- _(empty)_
674
-
675
- **FX impact (bps):**
676
- _(empty)_
677
-
678
- **One-offs impact (bps):**
679
- _(empty)_
680
-
681
- ## Q7.1 Scenarios - Base Case
682
-
683
- Probabilities across Base/Bull/Bear should sum to 100%.
684
-
685
- **Probability (%):**
686
- _(empty)_
687
-
688
- **Revenue:**
689
- _(empty)_
690
-
691
- **EPS:**
692
- _(empty)_
693
-
694
- **Key KPI:**
695
- _(empty)_
696
-
697
- **Narrative (1-2 sentences):**
698
- _(empty)_
699
-
700
- **Expected stock reaction and why:**
701
- _(empty)_
702
-
703
- ## Q7.2 Scenarios - Bull Case
704
-
705
- **Probability (%):**
706
- _(empty)_
707
-
708
- **Revenue:**
709
- _(empty)_
710
-
711
- **EPS:**
712
- _(empty)_
713
-
714
- **Key KPI:**
715
- _(empty)_
716
-
717
- **What surprises?:**
718
- _(empty)_
719
-
720
- **Expected reaction:**
721
- _(empty)_
722
-
723
- ## Q7.3 Scenarios - Bear Case
724
-
725
- **Probability (%):**
726
- _(empty)_
727
-
728
- **Revenue:**
729
- _(empty)_
730
-
731
- **EPS:**
732
- _(empty)_
733
-
734
- **Key KPI:**
735
- _(empty)_
736
-
737
- **What breaks?:**
738
- _(empty)_
739
-
740
- **Expected reaction:**
741
- _(empty)_
742
-
743
- ## Q7.4 Surprise Triggers
744
-
745
- **Key surprise triggers (ranked):**
746
- _(empty)_
747
-
748
- ## Q8. Management and Risks
749
-
750
- **Management tone last quarter:**
751
- _(none selected)_
752
-
753
- **Key commitments/promises to track:**
754
- _(empty)_
755
-
756
- **Top 5 risks into this print (specific, not generic):**
757
- _(empty)_
758
-
759
- **Regulatory/legal watch items:**
760
- _(empty)_
761
-
762
- **Competitive threats / share shifts:**
763
- _(empty)_
764
-
765
- **Macro sensitivities (rates, FX, commodities, consumer):**
766
- _(empty)_
767
-
768
- ## Q9. Valuation and Reaction
769
-
770
- **Valuation metrics used:**
771
- _(none selected)_
772
-
773
- **Other valuation metric:**
774
- _(empty)_
775
-
776
- **Current vs historical range:**
777
- _(none selected)_
778
-
779
- **Why (valuation rationale):**
780
- _(empty)_
781
-
782
- Required. Explain your valuation assessment. Minimum 15 words.
783
-
784
- **Avg earnings move last 8 quarters (%):**
785
- _(empty)_
786
-
787
- **What typically drives reaction:**
788
- _(none selected)_
789
-
790
- **Reaction pattern notes:**
791
- _(empty)_
792
-
793
- **Short interest trend:**
794
- _(empty)_
795
-
796
- **Flow / sentiment:**
797
- _(empty)_
798
-
799
- **Crowded factor exposure:**
800
- _(empty)_
801
-