phasefolio

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scenario_id'], 'properties': {'scenario_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the scenario to fetch the asset snapshot payload for.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'description': "Structured asset snapshot payload mirroring the PDF/Excel exports. Top-level keys include verdict, drivers, assumptions, evidence, and (when available) signed_export hashes. See get_methodology('evidence-standards') for the full structure."}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scenario_id'], 'properties': {'scenario_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the scenario whose evidence register entries to fetch.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {}, 'description': 'Array of evidence-register entries. Each entry has fields like assumption_path, source_url, source_date, excerpt, freshness, confidence — see /methodology/evidence-standards for the canonical schema.'}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['section'], 'properties': {'section': {'enum': ['rnpv', 'backtest', 'pos-calibration', 'ira-framework', 'development-paths', 'deal-term-modelling', 'holding-valuation', 'stage-normalization', 'evidence-standards', 'network-benchmarks', 'cogs-benchmark', 'sga-benchmark', 'tax-benchmark', 'sec-deal-terms'], 'type': 'string', 'description': "Which methodology section to fetch. 'rnpv' covers the core risk-adjusted NPV calculation: cumulative PoS, midpoint-discounted risk-adjusted development costs, the S-curve ramp/plateau/LOE revenue lifecycle net of COGS/SG&A/tax, WACC discounting, the rNPV and Unadjusted-NPV equations, Monte Carlo / expected NPV, and one-at-a-time sensitivity; 'backtest' covers the validation methodology and AUC/CI numbers; 'pos-calibration' covers the indication × modality × biomarker matrix, expanded modality normalization into the eight benchmark baselines, the scored multipliers including the model 2.6.0 biomarker_quality drug-specific multiplier (oncology solid tumor, Phase II/III), the Phase 1 ORR extracted-but-not-scored signal with its Phase 0 governance disclosure, and the non-scored drug-specific risk flags; 'ira-framework' covers the Year-9/Year-13 MFP cliff modeling and the separate IRA classification for expanded modalities such as RNA Therapeutics, Protein Degrader, Radioligand, Oncolytic Virus, and Cancer Vaccine; 'development-paths' covers development-path tiers, automatic-effect policy, and the no path-based PoS/default-multiplier rule; 'deal-term-modelling' covers how licensing deal terms map onto a scenario's deal structure (term-model mapping v1): what is modelled, not modelled and refused, the territory restriction and the approximations it names, milestone timing at stage ends, the cost-share rule, and the non-USD conversion-rate refusal; 'holding-valuation' covers how a Workspace holding is valued (scenario, share of asset value, look-through estimate, cost, not valued): each method's inputs, reason codes and completeness, the totals rules (never added across bases or currencies, estimates left out by default) and what the look-through estimate ignores; 'stage-normalization' covers exact clinical labels, work packages, canonical PoS gates, and the no label-only PoS modifier rule for Phase 1b/2a/2b, adaptive, pivotal, expansion, platform, bridging, and related labels; 'evidence-standards' covers source tiers and freshness rules; 'network-benchmarks' covers anonymization and cohort cuts; 'cogs-benchmark' covers the per-modality COGS% default bands and price-sensitivity methodology; 'sga-benchmark' covers the per-commercial-model SG&A% default bands (orphan/specialty/primary-care); 'tax-benchmark' covers the US-statutory-21% default tax rate, effective-rate reality, and the NOL cap; 'sec-deal-terms' is the retirement notice for the SEC EDGAR deal-term source (retired 2026-09-27), with its frozen versions."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['section_id', 'title', 'version', 'citation_url', 'summary'], 'properties': {'title': {'type': 'string'}, 'summary': {'type': 'string', 'description': 'Short summary suitable for inline quoting (≤500 chars).'}, 'version': {'type': 'string', 'description': "Versioned identifier for this section's content, e.g. 'methodology@2026-04'."}, 'section_id': {'enum': ['rnpv', 'backtest', 'pos-calibration', 'ira-framework', 'development-paths', 'deal-term-modelling', 'holding-valuation', 'evidence-standards', 'network-benchmarks', 'cogs-benchmark', 'sga-benchmark', 'tax-benchmark', 'sec-deal-terms'], 'type': 'string', 'description': 'Stable section identifier — reuse as the citation key.'}, 'citation_url': {'type': 'string', 'description': 'Public canonical URL — cite this in analysis output.'}, 'last_updated': {'type': 'string', 'description': 'ISO 8601 date of the last meaningful edit.'}}, 'additionalProperties': {}}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project_id'], 'properties': {'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the PhaseFolio project. Get from the project URL in the dashboard or from a prior list_scenarios call.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['id', 'name', 'indication', 'modality', 'current_stage', 'created_at', 'updated_at'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Stable PhaseFolio project UUID.'}, 'name': {'type': 'string', 'description': 'Display name of the project.'}, 'modality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "Modality, e.g. 'Antibody', 'Small Molecule'. Null for unset."}, 'created_at': {'type': 'string', 'description': 'ISO 8601 timestamp of project creation.'}, 'indication': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "Indication, e.g. 'NSCLC' or 'Rheumatoid Arthritis'. Null for unset."}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 timestamp of last project metadata update.'}, 'current_stage': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "Current development stage, e.g. 'Phase 2'. Null for unset."}}, 'additionalProperties': False}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scenario_id'], 'properties': {'scenario_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the scenario. Get from list_scenarios or the scenario URL in the dashboard.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['id', 'label', 'project_id', 'is_base', 'created_at', 'updated_at', 'inputs', 'result', 'model_version', 'modality', 'mfp_discount'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Scenario UUID. Pass to get_scenario, get_evidence, or get_dossier.'}, 'label': {'type': 'string', 'description': "Human-friendly scenario name, e.g. 'Base Case' or 'Bear Case'."}, 'inputs': {'description': 'Full scenario inputs blob (stages, costs, durations, PoS, commercial assumptions, IRA settings). Schema mirrors the wizard input model.'}, 'result': {'description': 'Full model output blob: eNPV (USD M), rNPV (USD M), cumulative_pos, per_stage_breakdown[], top sensitivity drivers, optional Monte Carlo percentiles.'}, 'is_base': {'type': 'boolean', 'description': 'True if this is the base case scenario for the project.'}, 'modality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Modality from inputs_json (echoed for convenience).'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 timestamp.'}, 'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the parent project.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 timestamp of last scenario edit.'}, 'mfp_discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'IRA Maximum Fair Price discount magnitude (0–1) used in this scenario, if applicable.'}, 'model_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "Model version that produced `result` (the result's own engine_version key). Null when the scenario has not been computed."}}, 'additionalProperties': False}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project_id', 'limit'], 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of scenarios to return (1–200). Defaults to 50; raise for projects with many what-if branches.'}, 'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the parent project whose scenarios to list.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'label', 'project_id', 'is_base', 'created_at', 'updated_at'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Scenario UUID. Pass to get_scenario, get_evidence, or get_dossier.'}, 'label': {'type': 'string', 'description': "Human-friendly scenario name, e.g. 'Base Case' or 'Bear Case'."}, 'is_base': {'type': 'boolean', 'description': 'True if this is the base case scenario for the project.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 timestamp.'}, 'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the parent project.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 timestamp of last scenario edit.'}}, 'additionalProperties': False}, 'description': 'Scenarios in the project, newest first.'}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['indication', 'metric'], 'properties': {'metric': {'enum': ['pos', 'cost', 'duration', 'all'], 'type': 'string', 'description': 'Which benchmark family to request. Cost and duration network benchmarks are currently coming_soon and return no estimate; manual wizard defaults are not returned as benchmarks.'}, 'modality': {'type': 'string', 'description': "Optional modality filter ('Antibody', 'Small Molecule', 'Cell Therapy', 'Gene Therapy', etc.). Omit to return cross-modality stats."}, 'indication': {'type': 'string', 'description': "Indication name (e.g. 'NSCLC', 'Rheumatoid Arthritis', 'Atopic Dermatitis'). Free-form; the model fuzz-matches to the canonical indication taxonomy."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['version', 'available_metrics', 'planning_defaults_excluded', 'note', 'methodology_url'], 'properties': {'note': {'type': 'string', 'description': 'Plain-language benchmark-availability and provenance note.'}, 'version': {'type': 'string', 'description': "Stable version identifier of this benchmark snapshot, e.g. 'preview-2026-04'."}, 'headlines': {'type': 'array', 'items': {'type': 'object', 'required': ['metric', 'value', 'n', 'status'], 'properties': {'n': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': "Sample size behind the value; null when status='coming_soon'."}, 'value': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': "Numeric value; null when status='coming_soon'."}, 'metric': {'type': 'string', 'description': "Metric name, e.g. 'Phase II RA trial cost (median, USD M)'."}, 'status': {'type': 'string', 'description': "Status, e.g. 'live' or 'coming_soon'."}}, 'additionalProperties': False}, 'description': 'Headline aggregates returned at the public tier.'}, 'coming_soon': {'type': 'string', 'description': "Set when this metric family hasn't published yet; explains when it will."}, 'methodology_url': {'type': 'string', 'description': 'Path to the methodology section that explains how these were computed.'}, 'available_metrics': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Network benchmark metric families with published numeric estimates.'}, 'planning_defaults_excluded': {'type': 'boolean', 'description': 'True when manual PhaseFolio planning defaults are intentionally excluded.'}}, 'description': 'L1 (no-auth) returns a versioned headline set; L3 (bearer) will return granular slices once enough orgs are on the network.', 'additionalProperties': False}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project_id'], 'properties': {'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'UUID of the project whose reviewed drug-specific clinical-risk signals should be queried.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['project_id', 'drug_name', 'indication', 'modality', 'reviewed_count', 'pending_count', 'scoring_gate', 'scoring_review_decisions', 'phase1_orr_treatment', 'signals', 'extractor_versions'], 'properties': {'signals': {'type': 'array', 'items': {}, 'description': 'Reviewed signal rows with provenance, extracted values, review state, and OR metadata.'}, 'modality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Project modality, if set.'}, 'drug_name': {'type': 'string', 'description': 'Project asset name used to match reviewed drug-specific signal rows.'}, 'indication': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Project indication, if set.'}, 'project_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Project UUID used to anchor the lookup.'}, 'scoring_gate': {'type': 'string', 'const': 'reviewed_at_not_null', 'description': 'Human-review gate required before a signal can score.'}, 'pending_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Number of matching signal rows still waiting for human review.'}, 'reviewed_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Number of reviewed approved/amended signals returned.'}, 'extractor_versions': {'type': 'array', 'items': {}, 'description': 'Recent extractor prompt versions that produced this signal family.'}, 'phase1_orr_treatment': {'type': 'string', 'const': 'flag_only_engine_2_6_0', 'description': 'Phase 1 ORR is surfaced but not scored in model 2.6.0.'}, 'scoring_review_decisions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Review decisions eligible for scoring or surfacing.'}}, 'description': 'Drug-specific clinical-risk substrate for a project. Returns reviewed signals only; pending rows are counted but excluded from scoring.', 'additionalProperties': False}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'text': {'type': 'string', 'description': 'Unstructured asset text; triggers extraction (inputs_unconfirmed=true).'}, 'fields': {'type': 'object', 'required': ['modality', 'target', 'indication', 'stage', 'comparators', 'biomarker_strategy'], 'properties': {'stage': {'type': 'string'}, 'target': {'type': 'string'}, 'modality': {'type': 'string'}, 'indication': {'type': 'string'}, 'comparators': {'type': 'array', 'items': {'type': 'string'}, 'default': []}, 'biomarker_strategy': {'type': 'string', 'default': 'none'}}, 'description': 'Pre-confirmed structured fields.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': "64-character hex SHA-256 of the signed artifact's content. Embedded in every signed PhaseFolio PDF (footer) and Excel (cover tab)."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'oneOf': [{'type': 'object', 'required': ['status', 'content_hash', 'signed_at', 'methodology_version', 'model_version', 'engine_version', 'benchmark_dataset_versions', 'signals_used', 'format', 'org', 'indication', 'modality', 'evidence_count'], 'properties': {'org': {'type': 'string', 'description': 'Anonymized originating-org identifier, or display name if the org opted into public attribution.'}, 'format': {'type': 'string', 'description': "Export format: 'pdf' or 'xlsx'."}, 'status': {'type': 'string', 'const': 'valid'}, 'modality': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'signed_at': {'type': 'string', 'description': 'ISO 8601 timestamp the artifact was signed at.'}, 'indication': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'content_hash': {'type': 'string'}, 'signals_used': {'description': 'Reviewed drug-specific signal provenance included in the signed content hash; [] for none or legacy rows.'}, 'model_version': {'type': 'string', 'description': "Model version stamp at signing time. Sentinel 'unknown (pre-2026-05)' for legacy rows."}, 'engine_version': {'type': 'string', 'description': 'Deprecated alias of model_version, kept for existing clients.'}, 'evidence_count': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'methodology_version': {'type': 'string', 'description': "Methodology version stamp at signing time, e.g. 'methodology@2026-04'."}, 'benchmark_dataset_versions': {'description': "Array of benchmark dataset versions used; '[]' for legacy rows."}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string', 'const': 'unknown'}, 'message': {'type': 'string'}}, 'additionalProperties': False}]}}, 'description': 'Canonical PhaseFolio envelope. Substantive payload is in `data`.', 'additionalProperties': False}