stock-analysis-plugin 0.2.11 → 0.2.12

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.
Files changed (47) hide show
  1. package/README.md +231 -381
  2. package/docs/mcp.md +60 -0
  3. package/hermes/__init__.py +35 -0
  4. package/hermes/plugin.yaml +131 -0
  5. package/hermes/schemas.py +6 -0
  6. package/hermes/tools.py +630 -0
  7. package/mcp_host/__init__.py +1 -0
  8. package/mcp_host/__main__.py +3 -0
  9. package/mcp_host/server.py +222 -0
  10. package/package.json +7 -1
  11. package/pi/index.ts +52 -2906
  12. package/scripts/cli-json.mjs +23 -0
  13. package/scripts/exec-process.mjs +89 -0
  14. package/scripts/setup-python.mjs +37 -4
  15. package/scripts/tool-calls.mjs +489 -0
  16. package/skills/event-driven/SKILL.md +2 -2
  17. package/skills/growth-quality/SKILL.md +1 -1
  18. package/skills/stock-analysis/SKILL.md +8 -6
  19. package/skills/stock-analysis/references/stateless-analysis.md +9 -1
  20. package/tools/_cache.py +13 -0
  21. package/tools/_subproc.py +46 -0
  22. package/tools/alert_rules.py +2 -2
  23. package/tools/backtest.py +3 -3
  24. package/tools/capabilities.py +32 -9
  25. package/tools/cli_budgets.json +2 -0
  26. package/tools/diagnostics.py +3 -4
  27. package/tools/gather.py +2 -6
  28. package/tools/import_parser.py +3 -4
  29. package/tools/lixinger.py +119 -27
  30. package/tools/market_regime.py +5 -2
  31. package/tools/market_review.py +5 -6
  32. package/tools/name_resolver.py +66 -7
  33. package/tools/report_renderer.py +3 -3
  34. package/tools/requirements.txt +5 -4
  35. package/tools/risk_screening.py +3 -2
  36. package/tools/screener.py +6 -4
  37. package/tools/search_intel.py +79 -10
  38. package/tools/sec_edgar.py +266 -0
  39. package/tools/sec_holders.py +6 -0
  40. package/tools/signal_tracker.py +5 -5
  41. package/tools/stateless_analysis.py +115 -0
  42. package/tools/stock_data.py +455 -201
  43. package/tools/tiaa_disclosures.py +4 -0
  44. package/tools/tool_schemas.json +2704 -0
  45. package/tools/trading_calendar.py +65 -30
  46. package/tools/value_data.py +366 -134
  47. package/tools/watchlist.py +43 -5
@@ -282,6 +282,272 @@ def form4(cik, filing):
282
282
  return rows
283
283
 
284
284
 
285
+ # Announcement categories mapped to SEC form types; categories without an SEC equivalent are rejected.
286
+ FILING_FORMS = {
287
+ "annual": {"10-K", "10-K/A", "20-F", "20-F/A", "40-F", "40-F/A"},
288
+ "quarterly": {"10-Q", "10-Q/A"},
289
+ "current": {"8-K", "8-K/A", "6-K", "6-K/A"},
290
+ "issuance": {"S-1", "S-1/A", "S-3", "S-3/A", "F-1", "F-1/A", "F-3", "F-3/A", "424B2", "424B3", "424B4", "424B5"},
291
+ "reduction": {"144"},
292
+ "inquiry": {"UPLOAD", "CORRESP"},
293
+ }
294
+ FILING_FORMS["all"] = set().union(*FILING_FORMS.values()) | {"DEF 14A", "DEFA14A"}
295
+
296
+
297
+ DCF_CONCEPTS = {
298
+ "revenue": ("Revenues", "RevenueFromContractWithCustomerExcludingAssessedTax", "SalesRevenueNet"),
299
+ "operating_income": ("OperatingIncomeLoss",),
300
+ "pretax_income": (
301
+ "IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest",
302
+ "IncomeLossFromContinuingOperationsBeforeIncomeTaxesMinorityInterestAndIncomeLossFromEquityMethodInvestments",
303
+ ),
304
+ "income_tax": ("IncomeTaxExpenseBenefit",),
305
+ "operating_cash_flow": ("NetCashProvidedByUsedInOperatingActivities",),
306
+ "capital_expenditure": ("PaymentsToAcquirePropertyPlantAndEquipment",),
307
+ "depreciation_amortization": ("DepreciationDepletionAndAmortization", "DepreciationAndAmortization"),
308
+ "diluted_shares": ("WeightedAverageNumberOfDilutedSharesOutstanding",),
309
+ }
310
+ DCF_INSTANTS = {
311
+ "cash": ("CashAndCashEquivalentsAtCarryingValue",),
312
+ "minority_interest": ("MinorityInterest",),
313
+ }
314
+ DEBT_CONCEPTS = (
315
+ "LongTermDebt",
316
+ "LongTermDebtCurrent",
317
+ "LongTermDebtNoncurrent",
318
+ "ShortTermBorrowings",
319
+ "CommercialPaper",
320
+ )
321
+ # Each lease kind: the total tag, else its current + noncurrent parts.
322
+ LEASE_CONCEPTS = {
323
+ "OperatingLeaseLiability": ("OperatingLeaseLiabilityCurrent", "OperatingLeaseLiabilityNoncurrent"),
324
+ "FinanceLeaseLiability": ("FinanceLeaseLiabilityCurrent", "FinanceLeaseLiabilityNoncurrent"),
325
+ }
326
+
327
+
328
+ def annual_fact(row):
329
+ if row.get("fp") != "FY" or row.get("form") not in {"10-K", "10-K/A", "20-F", "20-F/A", "40-F", "40-F/A"}:
330
+ return False
331
+ if "start" not in row:
332
+ return True
333
+ days = (date.fromisoformat(row["end"]) - date.fromisoformat(row["start"])).days
334
+ return 300 <= days <= 400
335
+
336
+
337
+ def latest_facts(facts, names, unit):
338
+ values = {}
339
+ for name in names:
340
+ concept = {}
341
+ for row in facts.get(name, {}).get("units", {}).get(unit, []):
342
+ if annual_fact(row) and (row["end"] not in concept or row.get("filed", "") > concept[row["end"]]["filed"]):
343
+ concept[row["end"]] = row
344
+ values.update({end: row for end, row in concept.items() if end not in values})
345
+ return values
346
+
347
+
348
+ def company_facts(symbol):
349
+ cik = resolve_cik(symbol)
350
+ return cached(
351
+ f"sec-companyfacts:{cik}", DAY, lambda: sec_get(f"https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json")
352
+ )
353
+
354
+
355
+ def dcf_inputs(symbol, periods):
356
+ data = company_facts(symbol)
357
+ gaap = data.get("facts", {}).get("us-gaap", {})
358
+ rows = {
359
+ key: latest_facts(gaap, names, "shares" if key == "diluted_shares" else "USD")
360
+ for key, names in {**DCF_CONCEPTS, **DCF_INSTANTS}.items()
361
+ }
362
+ lease_names = [name for total, parts in LEASE_CONCEPTS.items() for name in (total, *parts)]
363
+ debt = {name: latest_facts(gaap, (name,), "USD") for name in (*DEBT_CONCEPTS, *lease_names)}
364
+ # Values keep the latest (restated) filing; labels and cover shares come from each period's original report.
365
+ originals = {}
366
+ for name in DCF_CONCEPTS["revenue"] + DCF_CONCEPTS["operating_income"]:
367
+ for row in gaap.get(name, {}).get("units", {}).get("USD", []):
368
+ if annual_fact(row) and (row["end"] not in originals or row["filed"] < originals[row["end"]]["filed"]):
369
+ originals[row["end"]] = row
370
+ ends = sorted(originals, reverse=True)[:periods]
371
+ outstanding = (
372
+ data.get("facts", {})
373
+ .get("dei", {})
374
+ .get("EntityCommonStockSharesOutstanding", {})
375
+ .get("units", {})
376
+ .get("shares", [])
377
+ )
378
+ result = []
379
+ for end in ends:
380
+ entry = {key: rows[key].get(end, {}).get("val") for key in rows}
381
+ source = originals[end]
382
+ if (date.fromisoformat(source["filed"]) - date.fromisoformat(end)).days > 365:
383
+ # Only a later year's comparative exists (e.g. pre-XBRL years); its labels would be wrong.
384
+ source = {}
385
+ parts = [debt["LongTermDebt"].get(end, {}).get("val")]
386
+ if parts[0] is None:
387
+ parts = [debt[name].get(end, {}).get("val") for name in ("LongTermDebtCurrent", "LongTermDebtNoncurrent")]
388
+ parts += [debt[name].get(end, {}).get("val") for name in ("ShortTermBorrowings", "CommercialPaper")]
389
+ leases = []
390
+ for total, split in LEASE_CONCEPTS.items():
391
+ names = (total,) if end in debt[total] else split
392
+ if all(end in debt[name] for name in names):
393
+ leases += [debt[name][end]["val"] for name in names]
394
+ # Multi-class issuers report one cover row per class in the same filing; sum them.
395
+ cover = [
396
+ row
397
+ for row in outstanding
398
+ if source and (row.get("accn"), row.get("filed")) == (source.get("accn"), source.get("filed"))
399
+ ]
400
+ entry.update(
401
+ {
402
+ "period_end": end,
403
+ "currency": "USD",
404
+ "total_debt": sum(value for value in parts if value is not None)
405
+ if any(value is not None for value in parts)
406
+ else None,
407
+ "lease_liabilities": sum(leases) if leases else None,
408
+ "shares_outstanding": sum(row["val"] for row in cover) if cover else None,
409
+ "shares_outstanding_date": max(row["end"] for row in cover) if cover else None,
410
+ "form": source.get("form"),
411
+ "filed": source.get("filed"),
412
+ "fiscal_year": source.get("fy"),
413
+ }
414
+ )
415
+ result.append(entry)
416
+ if not result:
417
+ raise ValueError("SEC annual DCF facts unavailable")
418
+ return {
419
+ "source": "sec_companyfacts",
420
+ "name": data.get("entityName"),
421
+ "periods": result,
422
+ "warnings": [
423
+ "SEC XBRL tags vary by issuer; null fields are filled from Yahoo for the same period when available. "
424
+ "total_debt sums reported debt/borrowing tags and excludes leases; lease_liabilities is operating + finance "
425
+ "leases. Amounts use the latest filed (possibly restated) value; form/filed/shares_outstanding come from "
426
+ "the period's original annual report."
427
+ ],
428
+ }
429
+
430
+
431
+ def first_filed(rows, forms=("10-Q", "10-Q/A", "10-K", "10-K/A")):
432
+ """Earliest filing per (start, end): the value the market could see then, not a later restatement."""
433
+ kept = {}
434
+ for row in rows:
435
+ key = (row.get("start"), row["end"])
436
+ if row.get("form") in forms and row.get("filed") and (key not in kept or row["filed"] < kept[key]["filed"]):
437
+ kept[key] = row
438
+ return list(kept.values())
439
+
440
+
441
+ def valuation_facts(symbol):
442
+ """Point-in-time TTM net income, equity and share count events, each dated by its SEC filing date."""
443
+ data = company_facts(symbol)
444
+ gaap = data.get("facts", {}).get("us-gaap", {})
445
+ income = first_filed(gaap.get("NetIncomeLoss", {}).get("units", {}).get("USD", []))
446
+
447
+ def days(row):
448
+ return (date.fromisoformat(row["end"]) - date.fromisoformat(row["start"])).days
449
+
450
+ quarters = {row["end"]: row for row in income if "start" in row and 80 <= days(row) <= 100}
451
+ for year in (row for row in income if "start" in row and 350 <= days(row) <= 380):
452
+ inside = [q for q in quarters.values() if year["start"] <= q["start"] and q["end"] <= year["end"]]
453
+ if year["end"] not in quarters and len(inside) == 3:
454
+ quarters[year["end"]] = {
455
+ "start": max(q["end"] for q in inside),
456
+ "end": year["end"],
457
+ "val": year["val"] - sum(q["val"] for q in inside),
458
+ "filed": year["filed"],
459
+ }
460
+ ordered = sorted(quarters.values(), key=lambda row: row["end"])
461
+ ttm = []
462
+ for index in range(3, len(ordered)):
463
+ window = ordered[index - 3 : index + 1]
464
+ span = (date.fromisoformat(window[-1]["end"]) - date.fromisoformat(window[0]["start"])).days
465
+ if 350 <= span <= 380:
466
+ ttm.append(
467
+ {
468
+ "filed": max(q["filed"] for q in window),
469
+ "end": window[-1]["end"],
470
+ "val": sum(q["val"] for q in window),
471
+ }
472
+ )
473
+ equity = [
474
+ {"filed": row["filed"], "end": row["end"], "val": row["val"]}
475
+ for row in first_filed(gaap.get("StockholdersEquity", {}).get("units", {}).get("USD", []))
476
+ ]
477
+ shares = {}
478
+ for row in (
479
+ data.get("facts", {})
480
+ .get("dei", {})
481
+ .get("EntityCommonStockSharesOutstanding", {})
482
+ .get("units", {})
483
+ .get("shares", [])
484
+ ):
485
+ if row.get("form") in ("10-Q", "10-Q/A", "10-K", "10-K/A") and row.get("filed"):
486
+ # Multi-class issuers report one row per class under the same filing; sum them.
487
+ entry = shares.setdefault(
488
+ (row.get("accn"), row["end"]), {"filed": row["filed"], "end": row["end"], "val": 0}
489
+ )
490
+ entry["val"] += row["val"]
491
+ basis = "cover_shares_outstanding"
492
+ if not shares:
493
+ # Some multi-class filers (e.g. Alphabet) omit dei cover shares; weighted diluted shares are the fallback.
494
+ basis = "weighted_diluted_shares"
495
+ diluted = gaap.get("WeightedAverageNumberOfDilutedSharesOutstanding", {}).get("units", {}).get("shares", [])
496
+ shares = {row["end"]: row for row in first_filed(diluted) if "start" in row and 80 <= days(row) <= 100}
497
+ if not ttm or not equity or not shares:
498
+ raise ValueError("SEC net income, equity or share count facts unavailable")
499
+ return {
500
+ "name": data.get("entityName"),
501
+ "ttm_net_income": ttm,
502
+ "equity": equity,
503
+ "shares": list(shares.values()),
504
+ "share_basis": basis,
505
+ }
506
+
507
+
508
+ def filings(symbol, category, start, end, top):
509
+ forms = FILING_FORMS.get(category)
510
+ if forms is None:
511
+ raise ValueError(
512
+ f"category {category} has no SEC form equivalent; use all/annual/quarterly/issuance/reduction/inquiry"
513
+ )
514
+ identity()
515
+ cik = resolve_cik(symbol)
516
+ _, rows, incomplete = submissions(cik, forms, start.isoformat())
517
+ rows = [r for r in rows if r.get("filingDate", "") <= end.isoformat()]
518
+ items = []
519
+ for row in rows[:top]:
520
+ base = archive_base(cik, row)
521
+ document = row.get("primaryDocument") or ""
522
+ form = row["form"]
523
+ items.append(
524
+ {
525
+ "title": f"{form} {row.get('primaryDocDescription') or ''}".strip(),
526
+ "date": row.get("filingDate"),
527
+ "report_date": row.get("reportDate") or None,
528
+ "form": form,
529
+ "category": next((k for k, v in FILING_FORMS.items() if k != "all" and form in v), "other"),
530
+ "accession": row["accessionNumber"],
531
+ "document_url": f"{base}/{document}" if re.fullmatch(r"[\w.-]+", document) else None,
532
+ "filing_url": f"{base}/{row['accessionNumber']}-index.html",
533
+ "pdf_url": None,
534
+ }
535
+ )
536
+ return {
537
+ "symbol": symbol,
538
+ "cik": cik,
539
+ "market": "US",
540
+ "source": "sec_edgar",
541
+ "start_date": start.isoformat(),
542
+ "end_date": end.isoformat(),
543
+ "total": len(rows),
544
+ "announcements": items,
545
+ "truncated": incomplete or len(rows) > top,
546
+ "body_extracted": False,
547
+ "requested_category": category,
548
+ }
549
+
550
+
285
551
  def insider_trades(args):
286
552
  identity()
287
553
  if not 1 <= args.days <= 365 or not 1 <= args.top <= 20:
@@ -1,5 +1,6 @@
1
1
  """Exact issuer CUSIPs joined to the latest published SEC 13F bulk window."""
2
2
 
3
+ import contextlib
3
4
  import csv
4
5
  import hashlib
5
6
  import io
@@ -129,6 +130,11 @@ def bulk_file(window):
129
130
  raise ValueError("SEC bulk download is not a valid ZIP archive")
130
131
  finally:
131
132
  response.close()
133
+ # Each quarter is a ~100 MB archive; keep only the current window.
134
+ for old in path.parent.glob("sec-13f-*.zip"):
135
+ if old != path:
136
+ with contextlib.suppress(OSError):
137
+ old.unlink()
132
138
  return path
133
139
  except OSError as exc:
134
140
  raise ValueError(f"SEC bulk archive unavailable ({type(exc).__name__})") from None
@@ -24,7 +24,7 @@ from zoneinfo import ZoneInfo
24
24
 
25
25
  sys.path.insert(0, str(Path(__file__).resolve().parent))
26
26
  from _cache import atomic_write, file_lock
27
- from _subproc import command_timeout, run_tool, utf8_stdio # noqa: E402
27
+ from _subproc import command_timeout, error_message, run_tool, utf8_stdio # noqa: E402
28
28
  from stock_data import detect_market # noqa: E402
29
29
 
30
30
  _MARKET_TIMEZONES = {
@@ -183,7 +183,7 @@ def cmd_record(args):
183
183
  _load_records(store, strict=True)
184
184
  _append_record(store, record)
185
185
  except (OSError, ValueError) as e:
186
- return {"error": str(e)}
186
+ return {"error": error_message(e)}
187
187
  return record
188
188
 
189
189
 
@@ -310,7 +310,7 @@ def cmd_evaluate(args):
310
310
  with _store_lock(store):
311
311
  records = _load_records(store, strict=True)
312
312
  except (OSError, ValueError) as e:
313
- return {"error": str(e)}
313
+ return {"error": error_message(e)}
314
314
  results = []
315
315
  evaluated = closed = 0
316
316
  changed = False
@@ -400,7 +400,7 @@ def cmd_evaluate(args):
400
400
  entry.update({key: rec.get(key) for key in ("outcome", "return_pct", "exit_date")})
401
401
  closed += 1
402
402
  except (OSError, ValueError) as e:
403
- return {"error": str(e)}
403
+ return {"error": error_message(e)}
404
404
  return {
405
405
  "evaluated": evaluated,
406
406
  "closed": closed,
@@ -418,7 +418,7 @@ def cmd_summary(args):
418
418
  with _store_lock(store):
419
419
  records = _load_records(store, strict=True)
420
420
  except (OSError, ValueError) as e:
421
- return {"error": str(e)}
421
+ return {"error": error_message(e)}
422
422
  filtered = records
423
423
  if args.source:
424
424
  filtered = [r for r in filtered if r.get("source") == args.source]
@@ -196,6 +196,120 @@ def text(value, name):
196
196
  return value.strip()
197
197
 
198
198
 
199
+ def dcf(p):
200
+ growth = p["revenue_growth"]
201
+ years = len(growth) if isinstance(growth, list) else 0
202
+ if not 1 <= years <= 10:
203
+ raise ValueError("revenue_growth must contain 1..10 years")
204
+
205
+ def series(name, minimum=None, maximum=None):
206
+ values = p[name]
207
+ if not isinstance(values, list) or len(values) != years:
208
+ raise ValueError(f"{name} must match revenue_growth length")
209
+ return [number(value, name, minimum, maximum) for value in values]
210
+
211
+ growth = series("revenue_growth", -0.99, 10)
212
+ margins = series("operating_margin", -10, 1)
213
+ taxes = series("tax_rate", 0, 1)
214
+ waccs = series("wacc", 0, 1)
215
+ revenue = positive(p["base_revenue"], "base_revenue")
216
+ sales_to_capital = positive(p["sales_to_capital"], "sales_to_capital")
217
+ terminal_growth = number(p["terminal_growth"], "terminal_growth", -0.99, 1)
218
+ terminal_wacc = number(p["terminal_wacc"], "terminal_wacc", 0, 1)
219
+ terminal_roic = positive(p["terminal_roic"], "terminal_roic")
220
+ shares = positive(p["diluted_shares"], "diluted_shares")
221
+ if terminal_wacc <= terminal_growth or terminal_growth > terminal_roic:
222
+ raise ValueError("terminal_wacc must exceed terminal_growth and terminal_growth must not exceed terminal_roic")
223
+ claims = {key: number(p.get(key, 0), key, 0) for key in ("cash", "debt", "minority_interests", "other_claims")}
224
+ nonoperating = number(p.get("nonoperating_assets", 0), "nonoperating_assets", 0)
225
+ projections, discount, pv_fcff = [], 1, 0
226
+ for year, (rate, margin, tax, wacc) in enumerate(zip(growth, margins, taxes, waccs), 1):
227
+ previous, revenue = revenue, revenue * (1 + rate)
228
+ ebit = revenue * margin
229
+ nopat = ebit * (1 - tax)
230
+ reinvestment = (revenue - previous) / sales_to_capital
231
+ fcff = nopat - reinvestment
232
+ discount *= 1 + wacc
233
+ present_value = fcff / discount
234
+ pv_fcff += present_value
235
+ projections.append(
236
+ {
237
+ "year": year,
238
+ "revenue": revenue,
239
+ "ebit": ebit,
240
+ "nopat": nopat,
241
+ "reinvestment": reinvestment,
242
+ "fcff": fcff,
243
+ "discount_factor": 1 / discount,
244
+ "present_value": present_value,
245
+ }
246
+ )
247
+
248
+ def value(terminal_wacc_value, terminal_growth_value):
249
+ terminal_nopat = revenue * (1 + terminal_growth_value) * margins[-1] * (1 - taxes[-1])
250
+ reinvestment_rate = terminal_growth_value / terminal_roic
251
+ terminal_fcff = terminal_nopat * (1 - reinvestment_rate)
252
+ terminal_value = terminal_fcff / (terminal_wacc_value - terminal_growth_value)
253
+ enterprise = pv_fcff + terminal_value / discount
254
+ equity = enterprise + claims["cash"] + nonoperating - claims["debt"] - claims["minority_interests"]
255
+ equity -= claims["other_claims"]
256
+ return terminal_nopat, reinvestment_rate, terminal_fcff, terminal_value, enterprise, equity
257
+
258
+ terminal_nopat, reinvestment_rate, terminal_fcff, terminal_value, enterprise, equity = value(
259
+ terminal_wacc, terminal_growth
260
+ )
261
+ per_share = equity / shares
262
+ price = p.get("current_price")
263
+ if price is not None:
264
+ price = positive(price, "current_price")
265
+ sensitivity = []
266
+ for wacc_shift in (-0.01, 0, 0.01):
267
+ for growth_shift in (-0.005, 0, 0.005):
268
+ wacc_value, growth_value = terminal_wacc + wacc_shift, terminal_growth + growth_shift
269
+ valid = 0 <= wacc_value <= 1 and wacc_value > growth_value and growth_value <= terminal_roic
270
+ sensitivity.append(
271
+ {
272
+ "terminal_wacc": wacc_value,
273
+ "terminal_growth": growth_value,
274
+ "value_per_share": value(wacc_value, growth_value)[5] / shares if valid else None,
275
+ }
276
+ )
277
+ return {
278
+ "currency": text(p["currency"], "currency"),
279
+ "units": text(p["units"], "units"),
280
+ "valuation": {
281
+ "enterprise_value": enterprise,
282
+ "equity_value": equity,
283
+ "value_per_share": per_share,
284
+ "upside_pct": (per_share / price - 1) * 100 if price is not None else None,
285
+ "pv_fcff": pv_fcff,
286
+ "pv_terminal_value": terminal_value / discount,
287
+ "terminal_value_pct": terminal_value / discount / enterprise * 100 if enterprise > 0 else None,
288
+ },
289
+ "projections": projections,
290
+ "terminal": {
291
+ "nopat": terminal_nopat,
292
+ "reinvestment_rate": reinvestment_rate,
293
+ "fcff": terminal_fcff,
294
+ "value": terminal_value,
295
+ },
296
+ "sensitivity": sensitivity,
297
+ "assumptions": {
298
+ "model": "FCFF",
299
+ "sales_to_capital": sales_to_capital,
300
+ "terminal_growth": terminal_growth,
301
+ "terminal_wacc": terminal_wacc,
302
+ "terminal_roic": terminal_roic,
303
+ "diluted_shares": shares,
304
+ **claims,
305
+ "nonoperating_assets": nonoperating,
306
+ },
307
+ "warnings": [
308
+ "Input-driven valuation, not a forecast or trade signal. Amounts and shares must use one consistent currency and unit."
309
+ ],
310
+ }
311
+
312
+
199
313
  def rows(value, name, minimum=1, maximum=100):
200
314
  if not isinstance(value, list) or not minimum <= len(value) <= maximum:
201
315
  raise ValueError(f"{name} has invalid row count")
@@ -1136,6 +1250,7 @@ def robustness(p):
1136
1250
 
1137
1251
  COMMANDS = {
1138
1252
  "position_size": position_size,
1253
+ "dcf": dcf,
1139
1254
  "portfolio": portfolio,
1140
1255
  "rebalance": rebalance,
1141
1256
  "peers": peers,