fundamentals

Produce normalized fundamentals factors and deltas for one symbol.

Scripted execution

• Runner: skills/fundamentals/scripts/fundamentals_run.py
• Shared lifecycle client: skills/market-context/scripts/market_context_run_api.py
• Shared validator: skills/market-context/scripts/validate_market_context_payload.py

Use fundamentals_run.py to:

1. open run lifecycle (start + progress),
2. validate payload contract,
3. optionally submit parsed evidence rows,
4. finalize to Jangar so DB persistence happens server-side.

Output contract

Return JSON keys:

• context_version
• as_of_utc
• symbol
• freshness_seconds
• source_count
• quality_score
• payload.factors
• citations

Rules

• Include filing freshness or next expected filing date when known.
• Mark unsupported factors in payload with null values.