54 lines
3.9 KiB
YAML
54 lines
3.9 KiB
YAML
{
|
|
"schema_version": 1,
|
|
"module_id": "quant_engine",
|
|
"authority": {"scope": "module_metadata", "subject": "quant_engine", "owner": "quant-engine-owner", "source": "MODULE_SPEC.yaml", "revision": 3, "effective_from": "2026-09-01T00:00:00+08:00"},
|
|
"repository": {"name": "quant_engine", "workspace_id": "researchhub", "type": "research_engine", "maturity": "operational"},
|
|
"bounded_context": {
|
|
"domain": "quantitative-research-engine",
|
|
"responsibility": "Own reusable quantitative research calculations for factors, indicators, execution simulation, backtesting, portfolio decomposition, risk, and performance metrics.",
|
|
"prohibited_responsibilities": [
|
|
"Presenting research calculations, simulations, backtests, or metrics as investment advice or guaranteed performance",
|
|
"Submitting live orders, routing trades, managing brokerage accounts, or claiming transaction execution",
|
|
"Owning market-data source facts, research-result publication, or platform presentation state",
|
|
"Loading provider credentials, brokerage credentials, or production secrets",
|
|
"Changing financial model semantics through module metadata"
|
|
]
|
|
},
|
|
"capabilities": [
|
|
{"id": "factor-and-indicator-calculation", "summary": "Calculate reusable alpha factors and technical indicators from caller-supplied data.", "status": "operational"},
|
|
{"id": "execution-simulation", "summary": "Simulate costs, slippage, market constraints, fills, NAV, and PnL without live order routing.", "status": "operational"},
|
|
{"id": "portfolio-backtesting", "summary": "Run weight-based backtests and benchmark comparisons.", "status": "operational"},
|
|
{"id": "backtest-evidence-contracts", "summary": "Identify governed offline backtest inputs and close existing research artifact evidence without persistence or decision authority.", "status": "operational"},
|
|
{"id": "risk-and-performance-analysis", "summary": "Calculate portfolio decomposition, risk contribution, and performance statistics.", "status": "operational"}
|
|
],
|
|
"data": {"owns": [
|
|
{"asset_id": "quantitative-model-implementations", "kind": "model", "classification": "internal"},
|
|
{"asset_id": "simulation-and-metric-results", "kind": "artifact", "classification": "confidential"}
|
|
]},
|
|
"contracts": {
|
|
"provides": [
|
|
{"contract_id": "researchhub.factor-definition", "version": "1.0.0", "authority": "quant_engine", "path": "src/quant_engine/factor_contracts.py"},
|
|
{"contract_id": "researchhub.factor-set-ref", "version": "1.0.0", "authority": "quant_engine", "path": "src/quant_engine/factor_contracts.py"},
|
|
{"contract_id": "researchhub.backtest-run-ref", "version": "1.0.0", "authority": "quant_engine", "path": "src/quant_engine/governed_pipeline.py"},
|
|
{"contract_id": "researchhub.backtest-evidence-manifest", "version": "1.0.0", "authority": "quant_engine", "path": "src/quant_engine/artifact.py"}
|
|
],
|
|
"consumes": [
|
|
{"contract_id": "researchhub.dataset-snapshot", "version": "1.0.0", "authority": "researchhub.data", "admission": "qualified_immutable_envelope"},
|
|
{"contract_id": "researchhub.data-foundation", "version": "1.0.0", "authority": "researchhub.data", "admission": "content_addressed_selected_views"}
|
|
]
|
|
},
|
|
"dependencies": [],
|
|
"agent_context": {
|
|
"default_entrypoints": [
|
|
{"path": "README.md", "purpose": "Current engine scope, modules, dependencies, and non-live usage examples."},
|
|
{"path": "pyproject.toml", "purpose": "Supported Python version, package version, dependencies, and quality configuration."}
|
|
],
|
|
"excluded_paths": ["graphify-out", ".venv", "build", "dist"],
|
|
"max_default_tokens": 8000
|
|
},
|
|
"verification": {"commands": [
|
|
{"id": "module-metadata", "argv": ["python3", "tests/governance/test_module_spec.py"], "cwd": ".", "network": false, "required": true},
|
|
{"id": "unit-tests", "argv": ["python3", "-m", "pytest"], "cwd": ".", "network": false, "required": true}
|
|
]}
|
|
}
|