alpha-engine-lib 0.32.0__py3-none-any.whl

alpha_engine_lib/transparency_inventory.yaml

@@ -0,0 +1,260 @@
+# Phase 2 → 3 transparency inventory.
+#
+# Each row is a decision point in the Alpha Engine pipeline that must
+# emit a measurement output. The substrate health checker reads this
+# file, validates that each row's expected artifact exists with the
+# expected cadence and content, and emits per-row CloudWatch metrics
+# the alarm layer fires off.
+#
+# Source of truth for the prose form of these rows is the Phase 2
+# trajectory snippet at
+# alpha-engine-docs/private/presentation-layer-drafts-260505/
+# 01_phase_trajectory_snippet.md. When a row changes meaning (e.g. a
+# new content assertion is added by a downstream PR), update both.
+#
+# `effective_date` is the first date a row is expected to have data.
+# Rows whose instrumentation shipped recently get a forward-dated
+# value so the checker treats them as not-yet-expected until the
+# first relevant event populates the artifact.
+
+version: 1
+
+inventory:
+
+  - id: pipeline_execution
+    cadence: weekly
+    effective_date: 2026-04-01
+    description: >-
+      SF success rate ≥ 99% across Saturday + weekday + EOD pipelines,
+      with per-stage durations recorded.
+    sources:
+      - kind: cloudwatch
+        namespace: AWS/States
+        metric: ExecutionsSucceeded
+        # Validated against ExecutionsFailed for ratio. Per-state machine
+        # success rate computed over a 7-day trailing window.
+        #
+        # AWS/States dimension Value is the full state machine ARN, not
+        # just the SF name — GetMetricStatistics filters by exact
+        # dimension-value match, so short names return zero datapoints.
+        # Verified via `aws cloudwatch list-metrics --namespace AWS/States`
+        # 2026-05-08 after the lib v0.5.3 Period fix unmasked this drift.
+        dimensions:
+          StateMachineArn:
+            - arn:aws:states:us-east-1:711398986525:stateMachine:alpha-engine-saturday-pipeline
+            - arn:aws:states:us-east-1:711398986525:stateMachine:alpha-engine-weekday-pipeline
+            - arn:aws:states:us-east-1:711398986525:stateMachine:alpha-engine-eod-pipeline
+        window_days: 7
+        assert:
+          op: success_rate_pct_gte
+          value: 99
+
+  - id: agent_decisions
+    cadence: weekly
+    # First Saturday SF observation after backtester #146 (decision
+    # capture coverage % published from evaluator).
+    effective_date: 2026-05-09
+    description: >-
+      Per-call artifact: prompt version + decision-capture record + cost
+      telemetry + judge rubric scores. Coverage ≥ 99%.
+    sources:
+      - kind: s3_json
+        bucket: alpha-engine-research
+        # The backtester writes the per-run JSON to backtest/{date}/.
+        # The most recent date's artifact is the authoritative one.
+        key_pattern: backtest/{date}/decision_capture_coverage.json
+        max_age_days: 8
+        assert:
+          - path: coverage_pct
+            op: gte
+            value: 99
+
+  - id: predictor_decisions
+    cadence: daily
+    effective_date: 2026-04-01
+    description: >-
+      Per-L1-component IC + L2 IC + confidence calibration + feature
+      contributions.
+    sources:
+      - kind: s3_json
+        bucket: alpha-engine-research
+        key: predictor/metrics/latest.json
+        max_age_days: 8
+        assert_keys_present:
+          - l1_ic
+          - l2_ic
+          - confidence_calibration
+
+  - id: trade_execution_lineage
+    cadence: daily
+    # First ENTER fill after executor #138 (signal_date + prediction_date
+    # lineage columns shipped 2026-05-06).
+    effective_date: 2026-05-07
+    description: >-
+      Per-fill: entry trigger + sizing breakdown + signal_date and
+      prediction_date lineage columns populated on every ENTER row.
+    sources:
+      - kind: s3_csv
+        bucket: alpha-engine-research
+        key: trades/trades_full.csv
+        max_age_days: 4
+        assert_columns_present:
+          - signal_date
+          - prediction_date
+          - entry_trigger
+        assert_columns_non_null_for_rows_after:
+          date_column: date
+          rows_after: 2026-05-07
+          action_filter:
+            column: action
+            equals: BUY
+          columns:
+            - signal_date
+            - prediction_date
+
+  - id: risk_events
+    cadence: daily
+    # First veto after executor #139 (structured risk_events table
+    # shipped 2026-05-06).
+    effective_date: 2026-05-07
+    description: >-
+      Per-event log of risk decisions (veto / override / halt) with
+      rule + reason + value at threshold.
+    sources:
+      # The risk_events table lives inside trades.db, mirrored to S3
+      # at trades/trades_latest.db after each EOD reconcile. The check
+      # downloads the DB, queries the table, and validates schema +
+      # presence (no daily-row-count assertion — vetoes may not fire
+      # every day, the contract is "the table exists and the rule
+      # captures any event that happens").
+      - kind: sqlite_via_s3
+        bucket: alpha-engine-research
+        key: trades/trades_latest.db
+        max_age_days: 4
+        table: risk_events
+        assert_columns_present:
+          - rule
+          - reason
+          - value
+          - threshold
+
+  - id: pnl_attribution
+    cadence: daily
+    # First EOD reconcile after executor #140 (unattributed_residual_pct
+    # + 5 attribution columns shipped 2026-05-06).
+    effective_date: 2026-05-07
+    description: >-
+      Per-day attributed dollars (research / predictor / sizing / market)
+      + unattributed residual ≤ 1% of NAV.
+    sources:
+      - kind: s3_csv
+        bucket: alpha-engine-research
+        key: trades/eod_pnl.csv
+        max_age_days: 4
+        assert_columns_present:
+          - unattributed_residual_pct
+          - position_pnl_usd
+          - interest_usd
+          - dividend_usd
+          - unattributed_usd
+        assert_value_on_latest_row:
+          column: unattributed_residual_pct
+          op: lte
+          value: 1.0
+
+  - id: config_changes
+    cadence: weekly
+    effective_date: 2026-04-01
+    description: >-
+      Per-change diff log + rationale + subsequent-week behavioral delta
+      for autonomous-loop config updates (scoring weights, executor
+      params, predictor veto threshold, research boost params).
+    sources:
+      # Backtester optimizers write per-run change records under
+      # backtest/{date}/. The aggregate changelog under config/ is the
+      # canonical history; the per-run record is what the checker
+      # validates for the most-recent run.
+      - kind: s3_json
+        bucket: alpha-engine-research
+        key_pattern: backtest/{date}/optimizer_changes.json
+        max_age_days: 8
+        # Optional artifact — a quiet week with no config changes is
+        # valid; the check passes if the file exists OR if the file
+        # is absent AND the most recent backtest run completed (signal
+        # via metrics.json presence).
+        treat_absent_as: ok_if_companion_present
+        companion_key_pattern: backtest/{date}/metrics.json
+
+  - id: data_quality
+    cadence: daily
+    # data #159 stamped per-row source attribution on daily_closes
+    # 2026-05-05; first weekday-SF run with the column populated was
+    # 2026-05-06.
+    effective_date: 2026-05-06
+    description: >-
+      Per-row source attribution + per-feature NaN/outlier rates +
+      freshness on the daily_closes intermediate parquet.
+    sources:
+      - kind: s3_parquet
+        bucket: alpha-engine-research
+        key_pattern: staging/daily_closes/{date}.parquet
+        max_age_days: 4
+        # daily_closes parquet has ``ticker`` as the index (not a column)
+        # and uses capital-C ``Close`` for the close price. The earlier
+        # ``ticker`` + ``close`` entries were inventory drift — not
+        # producer bugs. The producer contract has been stable since
+        # the staging-prefix migration (data #112, 2026-04-29).
+        assert_columns_present:
+          - source
+          - Close
+        assert_column_non_null:
+          - source
+
+  - id: agent_quality
+    cadence: weekly
+    effective_date: 2026-04-01
+    description: >-
+      Rolling 4-week mean of LLM-as-judge rubric scores per
+      (judged_agent_id, criterion, judge_model) combo. The min across
+      all combos is the alarm-bearing metric; the substrate check
+      validates the metric is being emitted weekly.
+    sources:
+      - kind: cloudwatch
+        namespace: AlphaEngine/Eval
+        metric: agent_quality_score_4w_mean_min
+        window_days: 14
+        # Presence check — alarm threshold (mean < 3.0 emits SNS) lives
+        # in CloudWatch alarm config, not here. Substrate check just
+        # validates the derived metric is being emitted weekly.
+        assert:
+          op: datapoints_gte
+          value: 1
+
+  - id: cost_telemetry
+    cadence: weekly
+    # Per-run LLM cost telemetry workstream shipped via alpha-engine-
+    # research PR #73 (merged 2026-05-01). The first Saturday SF run
+    # that captured a ``cost.parquet`` was 2026-05-02. Consumers
+    # (backtester ``analysis/cost_report.detect_anomaly``) read this
+    # field as the floor of the rolling baseline window so pre-launch
+    # Saturdays are not classified as "capture-flag-off" gaps.
+    effective_date: 2026-05-02
+    description: >-
+      Per-Saturday LLM cost capture parquet aggregating per-call
+      JSONL writes. One row per agent invocation with token totals
+      (input / output / cache_read / cache_create) and computed
+      ``cost_usd``. Consumed by the evaluator's anomaly detector +
+      the cost report section of the Saturday SF email.
+    sources:
+      - kind: s3_parquet
+        bucket: alpha-engine-research
+        key_pattern: decision_artifacts/_cost/{date}/cost.parquet
+        max_age_days: 8
+        assert_columns_present:
+          - schema_version
+          - run_id
+          - agent_id
+          - model_name
+          - cost_usd
+        assert_column_non_null:
+          - cost_usd

alpha_engine_lib/universe.py

@@ -0,0 +1,83 @@
+"""Universe membership filtering — canonical predicate for the
+S&P 500+400 constituent check shared by research's incumbent-exit
+evaluator (alpha-engine-research#41) and executor's buy-candidate
+filter (alpha-engine#77).
+
+Design context (2026-04-20): the TSM/ASML incident shipped as a
+two-layer fix with two independent implementations of the same
+predicate — "is ticker in current universe?". Layer 1 drops non-S&P
+incumbents at the population-exit stage; Layer 2 drops non-universe
+buy_candidates at the executor signal reader. The two layers sourced
+the universe from different inputs (Research from in-memory
+``scanner_universe`` derived from ``constituents.json``; Executor
+from ArcticDB library symbols). Independent implementations risk
+silent divergence on universe drift.
+
+This module exposes the membership-test primitive only. It stays
+IO-agnostic: callers supply the universe set however their context
+sources it (``constituents.json``, ArcticDB ``list_symbols()``,
+fixture for tests). The lib makes the SAME predicate available to
+both layers; behavioral context (exit-event emission, log shape,
+caller-side metadata) stays at the call site. Divergence becomes
+impossible by construction: both consumers go through one code path.
+"""
+
+from __future__ import annotations
+
+from typing import AbstractSet, Callable, Iterable, TypeVar
+
+T = TypeVar("T")
+
+
+def _default_key(item: object) -> str | None:
+    """Default ticker extractor — handles plain ``str`` and ``{"ticker": str}`` dicts.
+
+    Returns ``None`` for items that don't look like either shape; the
+    caller's partition logic treats ``None`` as "not in universe" and
+    routes the item to ``dropped``.
+    """
+    if isinstance(item, str):
+        return item
+    if isinstance(item, dict):
+        ticker = item.get("ticker")
+        return ticker if isinstance(ticker, str) else None
+    return None
+
+
+def filter_to_universe(
+    items: Iterable[T],
+    universe: AbstractSet[str],
+    *,
+    key: Callable[[T], str | None] | None = None,
+) -> tuple[list[T], list[T]]:
+    """Partition ``items`` into ``(kept, dropped)`` by universe membership.
+
+    ``items`` may be an iterable of ticker strings, dicts with a
+    ``ticker`` field, or any other type when ``key`` is supplied.
+    The extracted ticker is checked against ``universe``; items whose
+    key is ``None``, empty, or returns a value not in ``universe`` go
+    to ``dropped``.
+
+    Returns the partition without emitting logs or exit events —
+    callers apply their own context-specific behavior to the dropped
+    list (Research emits ``UNIVERSE_DROP`` exit events; Executor logs
+    a warning).
+
+    The universe is a read-only ``AbstractSet[str]`` so either
+    ``set`` or ``frozenset`` is accepted. Membership is O(1) per item.
+    """
+    extract = key or _default_key
+    kept: list[T] = []
+    dropped: list[T] = []
+    for item in items:
+        ticker = extract(item)
+        if ticker and ticker in universe:
+            kept.append(item)
+        else:
+            dropped.append(item)
+    return kept, dropped
+
+
+def in_universe(ticker: str | None, universe: AbstractSet[str]) -> bool:
+    """Predicate — ``True`` iff ``ticker`` is a non-empty string in ``universe``."""
+    return isinstance(ticker, str) and bool(ticker) and ticker in universe

alpha_engine_lib-0.32.0.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: alpha-engine-lib
+Version: 0.32.0
+Summary: Shared utilities for the Alpha Engine modules: preflight, structured logging with secret-redaction, ArcticDB universe access, NYSE-calendar dates + freshness predicates, decision capture, cost telemetry, RAG, agent output schemas, SSM-backed secrets, Telegram alerts + SNS fan-out, EC2 spot-launch resilience, SSM log-capture chokepoint, and Step-Functions execution-state projection. Full surface documented in README.
+Author: Brian McMahon
+License: Proprietary
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: boto3>=1.34
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.31
+Requires-Dist: eval_type_backport>=0.2.0; python_version < "3.10"
+Provides-Extra: arcticdb
+Requires-Dist: arcticdb>=6.11; extra == "arcticdb"
+Requires-Dist: pandas>=2.0; extra == "arcticdb"
+Provides-Extra: flow-doctor
+Requires-Dist: flow-doctor[diagnosis,s3]<0.5.0,>=0.4.0; extra == "flow-doctor"
+Provides-Extra: rag
+Requires-Dist: psycopg2-binary>=2.9; extra == "rag"
+Requires-Dist: pgvector>=0.2; extra == "rag"
+Requires-Dist: numpy>=1.24; extra == "rag"
+Provides-Extra: rerank
+Requires-Dist: sentence-transformers>=3.0; extra == "rerank"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: moto>=5.0; extra == "dev"
+
+# alpha-engine-lib
+
+> Part of [**Nous Ergon**](https://nousergon.ai) — Autonomous Multi-Agent Trading System. Repo and S3 names use the underlying project name `alpha-engine`.
+
+[![Part of Nous Ergon](https://img.shields.io/badge/Part_of-Nous_Ergon-1a73e8?style=flat-square)](https://nousergon.ai)
+[![Python](https://img.shields.io/badge/python-3.11+-blue?style=flat-square)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
+[![Phase 2 · Reliability](https://img.shields.io/badge/Phase_2-Reliability-e9c46a?style=flat-square)](https://github.com/cipher813/alpha-engine-docs#phase-trajectory)
+
+Shared utility library used by all 6 modules of Nous Ergon. Cross-cutting concerns only — logging, freshness checks, trading-calendar arithmetic, ArcticDB helpers, agent-decision capture, LLM cost tracking. No proprietary trading logic, no model weights, no agent prompts.
+
+The lib's job is to keep the same code from being maintained six times.
+
+---
+
+## Install
+
+```
+# requirements.txt
+alpha-engine-lib @ git+https://github.com/cipher813/alpha-engine-lib@v0.4.0
+```
+
+Tagged releases: `v0.1.0`, `v0.2.0`, `v0.3.0`, `v0.4.0`, etc. Consumers pin to a specific tag. Breaking changes bump the minor version while Alpha Engine is in pre-1.0.
+
+```bash
+# With optional extras
+pip install "alpha-engine-lib[arcticdb] @ git+https://github.com/cipher813/alpha-engine-lib@v0.4.0"
+```
+
+| Extra | Pulls in | When you need it |
+|---|---|---|
+| `[arcticdb]` | `arcticdb`, `pandas` | Anything that calls `check_arcticdb_fresh` or the ArcticDB read/write helpers |
+| `[flow_doctor]` | `flow-doctor` | Logging integration that escalates ERROR-level events to flow-doctor |
+| `[rag]` | `psycopg2-binary`, `pgvector`, `numpy` | The `rag` submodule — Neon pgvector RAG retrieval/ingestion |
+| `[dev]` | `pytest`, lint tooling | Local development |
+
+## Modules
+
+### `logging` — structured logging + flow-doctor attach
+
+Replaces the near-identical `log_config.py` copies that used to live in alpha-engine-data and alpha-engine-executor. Consumers call `setup_logging` once at process startup:
+
+```python
+from alpha_engine_lib.logging import setup_logging
+
+setup_logging("data-collector", flow_doctor_yaml="/path/to/flow-doctor.yaml")
+```
+
+- Text mode by default; JSON via `ALPHA_ENGINE_JSON_LOGS=1`
+- Flow-doctor attaches as an ERROR-level handler when `FLOW_DOCTOR_ENABLED=1` (requires `[flow_doctor]` extra)
+
+### `preflight` — fail-fast connectivity + freshness checks
+
+Runs at the top of every entrypoint, before any real work starts. Primitives live on `BasePreflight`; each consumer subclasses and overrides `run()`:
+
+```python
+from alpha_engine_lib.preflight import BasePreflight
+
+class DataPreflight(BasePreflight):
+    def __init__(self, bucket, mode):
+        super().__init__(bucket)
+        self.mode = mode
+
+    def run(self):
+        self.check_env_vars("AWS_REGION")
+        if self.mode == "phase1":
+            self.check_env_vars("FRED_API_KEY", "POLYGON_API_KEY")
+        self.check_s3_bucket()
+        if self.mode == "daily":
+            self.check_arcticdb_fresh("universe", "SPY", max_stale_days=4)
+```
+
+Failed checks raise `RuntimeError` with an explanatory message. Consumers catch nothing — the raise propagates up through `main()` → non-zero exit → Step Function `HandleFailure` → flow-doctor notification. The point is to fail before paying for any LLM calls or downstream work.
+
+### `arcticdb` — read/write helpers + symbol enumeration
+
+Wrappers around the ArcticDB Python client. Standardizes the URI format, library naming, and read paths so each consumer doesn't reinvent the connection logic.
+
+### `dates` — trading-day arithmetic
+
+`now_dual()` returns a `(calendar_date, trading_day)` pair following the rule `trading_day = last_closed_trading_day(now)`. Strictly backward-looking; never ahead. `session_for_timestamp(ts)` resolves any timestamp to its trading session. Used at every artifact-write site to prevent calendar/trading-day drift between modules.
+
+### `trading_calendar` — NYSE holiday detection
+
+Pure-Python NYSE calendar through 2030. No `pandas-market-calendars` dependency.
+
+### `decision_capture` — agent decision audit logger
+
+Captures every agent decision as a structured artifact: prompt metadata (id + version), input snapshot, agent output, and cost. Each decision becomes replayable, auditable, and attributable to a specific prompt revision. Backbone of the Phase 2 measurement substrate.
+
+### `cost` — LLM cost tracking
+
+Token-aware cost computation following Anthropic's prompt-caching semantics (cache-write vs cache-read pricing). Used by every LLM call site to attach a `cost_usd` to its output.
+
+### `agent_schemas` — canonical LLM-output Pydantic schemas
+
+Shared contract surface for the 14 LLM-output classes used in `with_structured_output(...)` calls across the research pipeline (sector quant + qual + peer review, macro economist + critic, held-stock thesis update, CIO, eval-judge rubric). Lives here so downstream tooling — replay harness in alpha-engine-backtester, future cheap-model-concordance signals — can validate against the canonical contract without a heavy cross-repo dep on research.
+
+```python
+from alpha_engine_lib.agent_schemas import (
+    QuantAnalystOutput,
+    JointFinalizationOutput,
+    CIORawOutput,
+    HeldThesisUpdateLLMOutput,
+    resolve_schema_for_agent,
+)
+
+# Dispatch by captured agent_id (e.g. "sector_quant:technology" → QuantAnalystOutput)
+schema = resolve_schema_for_agent(agent_id)
+```
+
+`SCHEMA_BY_AGENT_ID_BASE` covers the 6 canonical agent families: `sector_quant`, `sector_qual`, `sector_peer_review`, `macro_economist`, `ic_cio`, `thesis_update`. Validators that defend observed LLM failure modes (sector-modifier clamp, JSON-string-as-list parser, `min_length=1` on CIO decisions) move with their classes.
+
+### `pillars` — canonical 6-pillar attractiveness scoring shapes
+
+Pydantic shapes for the institutional / SOTA refactor of research-module composite scoring — replaces the opaque `quant_score + qual_score` two-bucket model with a canonical 6-pillar decomposition: **Quality / Value / Momentum / Growth / Stewardship / Defensiveness**. Pillar set is the AQR Style Premia / Morningstar Economic Moat / Greenblatt / Piotroski / Fama-French / Asness "QMJ" consensus.
+
+```python
+from alpha_engine_lib.pillars import (
+    PILLARS,
+    MoatAssessment,
+    PillarSubscore,
+    QualitativePillarAssessment,
+)
+
+# Qual Analyst emits via with_structured_output(QualitativePillarAssessment).
+# Each of the 6 PillarSubscore fields carries 0-100 + confidence + evidence;
+# the Quality pillar additionally carries a structured MoatAssessment
+# (Morningstar wide/narrow/none + 6-archetype primary moat type + trend) —
+# the qualitative core of Quality, persisted per ticker for time-series
+# trend tracking.
+```
+
+Each `PillarSubscore` decomposes into optional `quant_component` (from the factor substrate) + `qual_component` (from the agent rubric) for traceability through the composite scoring layer. Catalyst is preserved as an orthogonal `catalyst_horizon_modulation: int ∈ [-20, 20]` (a horizon shift on near-term attractiveness), not a 7th pillar weight.
+
+Origin: 2026-05-20 attractiveness-pillars-260520 plan-doc arc. Phase 1 (this module) ships the schema layer; Phases 2-7 wire it through alpha-engine-research, alpha-engine-data, alpha-engine-backtester, and alpha-engine-dashboard.
+
+### `rag` — semantic retrieval over SEC filings, transcripts, and theses
+
+Neon pgvector backbone shared by `alpha-engine-research` (qual analyst's `query_filings` tool) and `alpha-engine-data` (weekly RAGIngestion step). Re-exports a small surface — `retrieve`, `ingest_document`, `document_exists`, `embed_texts`, `get_connection`, `is_available` — and ships the canonical `schema.sql` as package data.
+
+```python
+from alpha_engine_lib.rag import retrieve
+
+results = retrieve(
+    query="competitive risks and market position",
+    tickers=["AAPL"],
+    doc_types=["10-K", "10-Q", "earnings_transcript"],
+    top_k=8,
+)
+```
+
+Requires the `[rag]` extra. Embeddings are Voyage `voyage-3-lite` (512d); the database backend is Neon Postgres with pgvector + HNSW indexes.
+
+## How it's used
+
+All six Nous Ergon module repos depend on this lib:
+
+| Module | Repo | What it imports from here |
+|---|---|---|
+| Data | [`alpha-engine-data`](https://github.com/cipher813/alpha-engine-data) | `logging`, `preflight`, `arcticdb`, `dates`, `trading_calendar`, `rag` (ingestion) |
+| Research | [`alpha-engine-research`](https://github.com/cipher813/alpha-engine-research) | `logging`, `decision_capture`, `cost`, `dates`, `rag` (retrieval), `agent_schemas` (canonical LLM-output contracts) |
+| Predictor | [`alpha-engine-predictor`](https://github.com/cipher813/alpha-engine-predictor) | `logging`, `preflight`, `arcticdb`, `dates` |
+| Executor | [`alpha-engine`](https://github.com/cipher813/alpha-engine) | `logging`, `preflight`, `arcticdb`, `dates`, `trading_calendar` |
+| Backtester | [`alpha-engine-backtester`](https://github.com/cipher813/alpha-engine-backtester) | `logging`, `preflight`, `arcticdb`, `dates`, `agent_schemas` (replay-harness Pydantic validation) |
+| Dashboard | [`alpha-engine-dashboard`](https://github.com/cipher813/alpha-engine-dashboard) | `logging`, `arcticdb`, `dates` |
+
+## Development
+
+```bash
+git clone https://github.com/cipher813/alpha-engine-lib.git
+cd alpha-engine-lib
+pip install -e ".[dev,arcticdb,flow_doctor]"
+pytest
+```
+
+## Scope discipline
+
+This repo is intentionally narrow. Code lands here when **at least two consumers would otherwise maintain their own copy**. New modules land as their own minor release with per-consumer adoption — no lockstep updates.
+
+Code that **does not** belong here:
+- Anything tunable (scoring weights, risk thresholds, sizing parameters) → `alpha-engine-config` (private)
+- Agent prompts → `alpha-engine-config` (private)
+- Module-specific business logic → that module's repo
+
+## License
+
+MIT — see [LICENSE](LICENSE).

alpha_engine_lib-0.32.0.dist-info/RECORD

@@ -0,0 +1,40 @@
+alpha_engine_lib/__init__.py,sha256=KJzr-xNURx2za6VkBE7xMbDKpnNRohzYIuAzErD7fKo,94
+alpha_engine_lib/agent_schemas.py,sha256=imnuRTkFNG6ONv-qtJ_HZ0GijqKMHCDPl03q2NyAQag,29033
+alpha_engine_lib/alerts.py,sha256=_ne4a1lKCKsKPw7NhT3ITicdLOSoH3woiBELHC5DlUY,23635
+alpha_engine_lib/arcticdb.py,sha256=KSuuhs1BPA8XLeLXwBPgFhxW3UiaIpbvImnlU_2jArQ,12906
+alpha_engine_lib/collector_results.py,sha256=XsCUZ1Jz943n7j4__l4Hd79euiH3UKSeNXuXfP62EQc,2788
+alpha_engine_lib/cost.py,sha256=Sj6NKVwT_8-IKSqckrRDnbr89G6co5M4DW_j1zt7E_0,26421
+alpha_engine_lib/dates.py,sha256=Oyzl0JEKWNU0wPt-rHH2AhM4Wv5n8Mbat4EnD8xmw-0,10755
+alpha_engine_lib/decision_capture.py,sha256=xI7kzSqMKgsawZePK3vtR76ImKym_vYrQNRrPxzYKaw,19698
+alpha_engine_lib/ec2_spot.py,sha256=bg9TAY1gDEA97U2Giw4zufQhwXHkmtiVpqtUI47oqgE,12669
+alpha_engine_lib/email_sender.py,sha256=cErXdEfnFAC2DeGWzhCVXePjgFhD3a2EZDKQ7VM2rBE,8303
+alpha_engine_lib/eval_artifacts.py,sha256=xNL-8cWStdiZ-tQVFtc-2iBXWFtJ4iBNXpqLKXFm_Ps,14427
+alpha_engine_lib/logging.py,sha256=B_x1rb8qY7YFexbAU4XJ5x99ubdpd8IAeFbjuTtHS6Y,13162
+alpha_engine_lib/model_pricing.yaml,sha256=VRl7PLwogj9-33UcjPhfXvHwXHs9vksgIky4DZLJnmY,3197
+alpha_engine_lib/pillars.py,sha256=dv6JghtagcxUuox_SbtmO1gATt8ZdSXMAvgZ8wak_80,31322
+alpha_engine_lib/preflight.py,sha256=aoA4rWPJ5it7exV34R_tAqbjvXVReywN_7SJRrA5jrA,18817
+alpha_engine_lib/reconcile.py,sha256=S1NxHeyzPaANZ0--3r6oaxbAlFJMRW7Jr8dT3mdD0aA,7823
+alpha_engine_lib/secrets.py,sha256=wd-ZsrockLLmao3r6aM832JvEfs3XQAk8aX8nLvgnBM,6504
+alpha_engine_lib/ssm_log_capture.py,sha256=pYxm6SjGouSWiyQrevAZXG60gsdPLd8AT6hWOZUJoSU,10631
+alpha_engine_lib/telegram.py,sha256=roJDi28IcAZnk2piJwrJl0STFp4CQUjkqSMbdQ6P6uo,6383
+alpha_engine_lib/trading_calendar.py,sha256=fCtghffX1-WFVP2k8lxUXzusfF-sITn8D2sy4Xe1cfY,8184
+alpha_engine_lib/transparency.py,sha256=XUZ2eqFRURxnTEDCLDNJ8zFaTatHj3U4utSbfJRksZo,25551
+alpha_engine_lib/transparency_inventory.yaml,sha256=dFlTHQ3Kx4Q3RPdBfM_Vu1YR7KZxIQ5etWr4hCOhc_E,9900
+alpha_engine_lib/universe.py,sha256=iMIodMCXfXcnWEdw6lD14aJJVeenQlC__ublxn7J3No,3302
+alpha_engine_lib/pipeline_status/__init__.py,sha256=K7SpAGvpv9X2_Qsn7Ewb6_kgKm0X1cdPZYhVbBgDEs8,2399
+alpha_engine_lib/pipeline_status/read.py,sha256=qBgNE2o6giT0QEd_X8Lfdhz1S1sxLNkU33CaMQ6lSFM,21373
+alpha_engine_lib/pipeline_status/registry.py,sha256=fJbSENb7IsfDfyJM218IdyVLIev6otfOx4CsemkgCsQ,15571
+alpha_engine_lib/pipeline_status/templates.py,sha256=vq_ca3tYaqzGxt9UI51cE1ruN32l31u49vb9oqX_k-s,4444
+alpha_engine_lib/rag/__init__.py,sha256=zdD51ny9ciWr7MM8a9VdobkdLMMSm8aVmV3P5X07xeQ,1332
+alpha_engine_lib/rag/db.py,sha256=0N_08UooNIRi1KlNXGdtWks6nJevlhs7djfmFH6_jmc,3196
+alpha_engine_lib/rag/embeddings.py,sha256=xY41wuUWXbDH5y9qx0qGs9De0L3Kd4sVsgAY55A7VSw,1788
+alpha_engine_lib/rag/rerank.py,sha256=WOZIk82DCXWhGiqVDTMzfbnb8fXHl4hfr1SD4Zz36mo,15357
+alpha_engine_lib/rag/retrieval.py,sha256=_F0-SSvM_9XrV-uXD2_DaJ2DD1XqHZCuNmJDSkflfW0,18342
+alpha_engine_lib/rag/schema.sql,sha256=ob5i43ZioC6KNOg9BHm7i_9QTW9hNkglYlargiHvCAs,2786
+alpha_engine_lib/rag/migrations/0001_content_tsv.sql,sha256=6gvuGyLwxTHWVdYKqix2qmBungGWlJdJqc9CJjF707o,1873
+alpha_engine_lib/sources/__init__.py,sha256=HbYUliD_nS2eBFK2aTu5mruoVRbPa3O2SuD2YbiClEw,1113
+alpha_engine_lib/sources/protocols.py,sha256=NklSPHkpOoz0BSSFN7PQeprULcrvmd3_CJSSPEeJC_4,8436
+alpha_engine_lib-0.32.0.dist-info/METADATA,sha256=92d2yLj6N4vrEDSEKg0eGeSUTxYkZcb1Z39nth9mD5s,11478
+alpha_engine_lib-0.32.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+alpha_engine_lib-0.32.0.dist-info/top_level.txt,sha256=eysr0xbNhj1aDUa1F9U9c36VzVTXXNqeyHrVC-gtgBw,17
+alpha_engine_lib-0.32.0.dist-info/RECORD,,

alpha_engine_lib-0.32.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

alpha_engine_lib-0.32.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+alpha_engine_lib