msts-trader 0.1.0__tar.gz

msts_trader-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+Copyright 2026 markudevelop
+
+Full text: https://www.apache.org/licenses/LICENSE-2.0.txt

msts_trader-0.1.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: msts-trader
+Version: 0.1.0
+Summary: Paste a target-weights CSV, preview the rebalance, execute it on your Tastytrade account.
+Author: markudevelop
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/markudevelop/msts-trader
+Project-URL: Issues, https://github.com/markudevelop/msts-trader/issues
+Keywords: trading,tastytrade,rebalance,portfolio,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tastytrade==11.0.4
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.7
+Requires-Dist: keyring>=24
+Requires-Dist: pydantic>=2.5
+Requires-Dist: python-dateutil>=2.9
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# msts-trader
+
+Paste a target-weights CSV, preview the rebalance, execute it on your Tastytrade account.
+
+```
+$ msts-trader
+Paste CSV (ticker,weight), then Ctrl+D:
+ticker,weight
+SPY,0.42
+GLD,0.18
+SHV,0.20
+EEM,0.20
+^D
+✓ loaded 4 targets.
+
+Account 5W******  ·  NAV $48,213.42  ·  cash $2,150.00  ·  BP $46,290.00
+Market: open  ·  closes in 23 min
+
+           Rebalance preview
+┃ Symbol ┃ Current % ┃ Target % ┃   Δ $ ┃ Action                  ┃ Note ┃
+┃ SPY    ┃    18.2%  ┃   42.0%  ┃ +$11k ┃ BUY  22.00 @ ~$521.34   ┃      ┃
+┃ EEM    ┃    31.5%  ┃   20.0%  ┃  -$5k ┃ SELL 119.00 @ ~$47.21   ┃      ┃
+...
+
+Execute 4 orders? [y/N]: y
+[1/4] SPY  BUY  22.00 @ MKT ...  ROUTED  id=4f8...
+...
+
+Done.  sent: 4  ·  failed: 0  ·  log: ~/.msts-trader/fills/
+```
+
+## Install
+
+```bash
+pip install msts-trader
+```
+
+Python ≥3.11 required.
+
+Install from source (until a PyPI release lands):
+
+```bash
+git clone https://github.com/markudevelop/msts-trader.git
+cd msts-trader
+pip install -e .
+```
+
+## One-time setup
+
+You need Tastytrade OAuth credentials. **This is your app, not ours** — we never see your keys.
+
+1. Sign in at https://developer.tastytrade.com → **My Apps**
+2. Create an OAuth application — copy the **provider secret**
+3. Run their OAuth authorization flow to obtain a **refresh token**
+4. Look up your **account number** in the Tastytrade web dashboard (optional — leave blank to auto-pick your first account)
+5. Run:
+
+```bash
+msts-trader login
+```
+
+Paste the three values when prompted. They are stored in your OS keychain
+(macOS Keychain / Windows Credential Manager / libsecret). The app never
+writes them to disk in plaintext.
+
+## Daily usage
+
+1. Get your CSV. On a supported weights site, click **Copy CSV**. Or build one yourself:
+
+   ```csv
+   ticker,weight
+   SPY,0.42
+   GLD,0.18
+   EEM,0.20
+   SHV,0.20
+   ```
+
+   - `weight` is a fraction (0–1), not a percent.
+   - Sum should be ≤ 1.0 (the remainder is held as cash).
+   - Comments starting with `#` are ignored.
+
+2. Run:
+
+   ```bash
+   msts-trader
+   ```
+
+3. Paste the CSV, hit `Ctrl+D` (`Ctrl+Z` then Enter on Windows).
+4. Review the preview table carefully.
+5. Type `y` to execute, anything else to cancel.
+
+### Useful flags
+
+```bash
+msts-trader rebalance --dry-run               # preview only, never sends
+msts-trader rebalance --yes                   # skip the confirm prompt
+msts-trader rebalance --threshold 0.02        # tighter rebalance (default 4%)
+msts-trader rebalance --csv-file targets.csv  # read from a file instead of stdin
+```
+
+### Other commands
+
+```bash
+msts-trader status     # show NAV, positions, market status
+msts-trader logout     # clear stored creds
+msts-trader --version  # print version
+```
+
+## What it does
+
+- Parses your CSV into `{ticker: target_weight}`.
+- Pulls live NAV, cash, buying power, and current positions from Tastytrade.
+- Quotes every relevant symbol via the Tastytrade market-data API.
+- Computes the dollar delta per ticker, skips anything within the drift
+  threshold (default 4% of NAV).
+- Sells tickers no longer in your targets.
+- Sizes buys at the current quote, rounded to 2 decimals (Tastytrade
+  fractional shares on MARKET orders).
+- Shows the full plan and waits for `y` before sending anything.
+- Submits MARKET DAY orders. Logs results to `~/.msts-trader/fills/`.
+
+## What it does NOT do (v1)
+
+- Pre-market or after-hours execution — refuses to send outside 09:30–16:00 ET.
+- Shorting — negative weights are rejected.
+- Options, futures, crypto.
+- Multi-account or per-strategy ledger.
+- Margin-aware uniform scaling (warns instead; Tastytrade's own BP
+  pre-flight will scale down at submit if needed).
+- Automatic CSV polling. You paste each rebalance manually.
+
+## Security
+
+- Your Tastytrade OAuth credentials live only in your OS keychain on your
+  own machine. The app does not phone home, does not log credentials, and
+  is not connected to any service operated by the author.
+- The author of this app cannot view, recover, or revoke your
+  Tastytrade access. Revoke via your own Tastytrade OAuth app dashboard
+  if a refresh token leaks.
+- Trades are user-initiated: every execution requires you to paste a CSV
+  and confirm with `y`. There is no background trading loop.
+
+## Disclaimer
+
+This tool sends real orders to your live brokerage account. You are
+responsible for the CSV you paste and the rebalance you confirm. Past
+performance of any signal source is not indicative of future results.
+The author makes no warranty of any kind; use at your own risk.
+
+## License
+
+Apache-2.0.

msts_trader-0.1.0/README.md

@@ -0,0 +1,152 @@
+# msts-trader
+
+Paste a target-weights CSV, preview the rebalance, execute it on your Tastytrade account.
+
+```
+$ msts-trader
+Paste CSV (ticker,weight), then Ctrl+D:
+ticker,weight
+SPY,0.42
+GLD,0.18
+SHV,0.20
+EEM,0.20
+^D
+✓ loaded 4 targets.
+
+Account 5W******  ·  NAV $48,213.42  ·  cash $2,150.00  ·  BP $46,290.00
+Market: open  ·  closes in 23 min
+
+           Rebalance preview
+┃ Symbol ┃ Current % ┃ Target % ┃   Δ $ ┃ Action                  ┃ Note ┃
+┃ SPY    ┃    18.2%  ┃   42.0%  ┃ +$11k ┃ BUY  22.00 @ ~$521.34   ┃      ┃
+┃ EEM    ┃    31.5%  ┃   20.0%  ┃  -$5k ┃ SELL 119.00 @ ~$47.21   ┃      ┃
+...
+
+Execute 4 orders? [y/N]: y
+[1/4] SPY  BUY  22.00 @ MKT ...  ROUTED  id=4f8...
+...
+
+Done.  sent: 4  ·  failed: 0  ·  log: ~/.msts-trader/fills/
+```
+
+## Install
+
+```bash
+pip install msts-trader
+```
+
+Python ≥3.11 required.
+
+Install from source (until a PyPI release lands):
+
+```bash
+git clone https://github.com/markudevelop/msts-trader.git
+cd msts-trader
+pip install -e .
+```
+
+## One-time setup
+
+You need Tastytrade OAuth credentials. **This is your app, not ours** — we never see your keys.
+
+1. Sign in at https://developer.tastytrade.com → **My Apps**
+2. Create an OAuth application — copy the **provider secret**
+3. Run their OAuth authorization flow to obtain a **refresh token**
+4. Look up your **account number** in the Tastytrade web dashboard (optional — leave blank to auto-pick your first account)
+5. Run:
+
+```bash
+msts-trader login
+```
+
+Paste the three values when prompted. They are stored in your OS keychain
+(macOS Keychain / Windows Credential Manager / libsecret). The app never
+writes them to disk in plaintext.
+
+## Daily usage
+
+1. Get your CSV. On a supported weights site, click **Copy CSV**. Or build one yourself:
+
+   ```csv
+   ticker,weight
+   SPY,0.42
+   GLD,0.18
+   EEM,0.20
+   SHV,0.20
+   ```
+
+   - `weight` is a fraction (0–1), not a percent.
+   - Sum should be ≤ 1.0 (the remainder is held as cash).
+   - Comments starting with `#` are ignored.
+
+2. Run:
+
+   ```bash
+   msts-trader
+   ```
+
+3. Paste the CSV, hit `Ctrl+D` (`Ctrl+Z` then Enter on Windows).
+4. Review the preview table carefully.
+5. Type `y` to execute, anything else to cancel.
+
+### Useful flags
+
+```bash
+msts-trader rebalance --dry-run               # preview only, never sends
+msts-trader rebalance --yes                   # skip the confirm prompt
+msts-trader rebalance --threshold 0.02        # tighter rebalance (default 4%)
+msts-trader rebalance --csv-file targets.csv  # read from a file instead of stdin
+```
+
+### Other commands
+
+```bash
+msts-trader status     # show NAV, positions, market status
+msts-trader logout     # clear stored creds
+msts-trader --version  # print version
+```
+
+## What it does
+
+- Parses your CSV into `{ticker: target_weight}`.
+- Pulls live NAV, cash, buying power, and current positions from Tastytrade.
+- Quotes every relevant symbol via the Tastytrade market-data API.
+- Computes the dollar delta per ticker, skips anything within the drift
+  threshold (default 4% of NAV).
+- Sells tickers no longer in your targets.
+- Sizes buys at the current quote, rounded to 2 decimals (Tastytrade
+  fractional shares on MARKET orders).
+- Shows the full plan and waits for `y` before sending anything.
+- Submits MARKET DAY orders. Logs results to `~/.msts-trader/fills/`.
+
+## What it does NOT do (v1)
+
+- Pre-market or after-hours execution — refuses to send outside 09:30–16:00 ET.
+- Shorting — negative weights are rejected.
+- Options, futures, crypto.
+- Multi-account or per-strategy ledger.
+- Margin-aware uniform scaling (warns instead; Tastytrade's own BP
+  pre-flight will scale down at submit if needed).
+- Automatic CSV polling. You paste each rebalance manually.
+
+## Security
+
+- Your Tastytrade OAuth credentials live only in your OS keychain on your
+  own machine. The app does not phone home, does not log credentials, and
+  is not connected to any service operated by the author.
+- The author of this app cannot view, recover, or revoke your
+  Tastytrade access. Revoke via your own Tastytrade OAuth app dashboard
+  if a refresh token leaks.
+- Trades are user-initiated: every execution requires you to paste a CSV
+  and confirm with `y`. There is no background trading loop.
+
+## Disclaimer
+
+This tool sends real orders to your live brokerage account. You are
+responsible for the CSV you paste and the rebalance you confirm. Past
+performance of any signal source is not indicative of future results.
+The author makes no warranty of any kind; use at your own risk.
+
+## License
+
+Apache-2.0.

msts_trader-0.1.0/msts_trader/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

msts_trader-0.1.0/msts_trader/__main__.py

@@ -0,0 +1,258 @@
+"""msts-trader CLI: paste a CSV, preview the rebalance, execute it on Tastytrade.
+
+Subcommands:
+  login       — store provider_secret + refresh_token + account_id in OS keychain
+  status      — show NAV / positions / market status, no orders
+  rebalance   — (default) paste CSV from stdin, preview, prompt, execute
+  logout      — clear stored creds
+"""
+from __future__ import annotations
+
+import sys
+from decimal import Decimal
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
+from rich.table import Table
+
+from . import __version__, fill_log
+from .csv_parser import CSVParseError, parse_csv
+from .diff import build_preview
+from .keychain import CredsMissingError, clear_creds, load_creds, save_creds
+from .market_hours import market_status
+from .models import Side
+from .tasty import Tasty
+
+c = Console()
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(__version__, prog_name="msts-trader")
+@click.pass_context
+def main(ctx: click.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(rebalance)
+
+
+@main.command()
+def login() -> None:
+    """Store Tastytrade OAuth creds (provider_secret + refresh_token) in OS keychain."""
+    c.print(
+        Panel.fit(
+            "[bold]Tastytrade OAuth setup[/bold]\n\n"
+            "1. Sign in at [cyan]https://developer.tastytrade.com[/cyan]\n"
+            "2. Create an OAuth application → copy [bold]provider secret[/bold]\n"
+            "3. Run their authorization flow → copy [bold]refresh token[/bold]\n"
+            "4. Find your [bold]account number[/bold] in Tastytrade dashboard "
+            "(or leave blank to auto-pick first account)",
+            border_style="cyan",
+        )
+    )
+    provider_secret = Prompt.ask("provider secret", password=True)
+    refresh_token = Prompt.ask("refresh token", password=True)
+    account_id = Prompt.ask("account id (optional)", default="").strip() or None
+
+    try:
+        t = Tasty(provider_secret, refresh_token, account_id)
+        bal = t.balances()
+    except Exception as e:
+        c.print(f"[red]✗ login failed:[/red] {e}")
+        sys.exit(1)
+
+    save_creds(provider_secret, refresh_token, account_id or t.account_id)
+    c.print(
+        f"[green]✓ stored.[/green] account [bold]{t.account_id}[/bold]  ·  "
+        f"NAV ${bal.nav:,.2f}  ·  BP ${bal.buying_power:,.2f}"
+    )
+
+
+@main.command()
+def logout() -> None:
+    """Forget stored creds."""
+    clear_creds()
+    c.print("[green]✓ creds cleared from keychain.[/green]")
+
+
+@main.command()
+def status() -> None:
+    """Show account NAV, positions, market status. No orders."""
+    try:
+        ps, rt, aid = load_creds()
+    except CredsMissingError as e:
+        c.print(f"[red]{e}[/red]")
+        sys.exit(1)
+
+    t = Tasty(ps, rt, aid)
+    bal = t.balances()
+    pos = t.positions()
+    ms = market_status()
+
+    c.print(
+        f"\n[bold]Account[/bold] {t.account_id}  ·  "
+        f"NAV [green]${bal.nav:,.2f}[/green]  ·  "
+        f"cash ${bal.cash:,.2f}  ·  BP ${bal.buying_power:,.2f}"
+    )
+    c.print(f"Market: [bold]{ms.status}[/bold]" + (f"  ·  closes in {ms.minutes_to_close} min" if ms.minutes_to_close is not None else ""))
+
+    if not pos:
+        c.print("[yellow]No open positions.[/yellow]")
+        return
+
+    table = Table(show_header=True, header_style="bold", box=None)
+    table.add_column("Symbol")
+    table.add_column("Qty", justify="right")
+    table.add_column("Price", justify="right")
+    table.add_column("Value", justify="right")
+    table.add_column("% NAV", justify="right")
+    for p in sorted(pos.values(), key=lambda x: -x.market_value):
+        pct = (p.market_value / bal.nav * 100) if bal.nav else Decimal(0)
+        table.add_row(p.ticker, f"{p.quantity:.2f}", f"${p.price:,.2f}", f"${p.market_value:,.0f}", f"{pct:.1f}%")
+    c.print(table)
+
+
+@main.command()
+@click.option("--dry-run", is_flag=True, help="Preview only — never sends orders.")
+@click.option("--yes", "-y", is_flag=True, help="Skip the confirm prompt (auto-execute).")
+@click.option("--threshold", default=0.04, type=float, show_default=True, help="Drift threshold (fraction of NAV).")
+@click.option("--csv-file", type=click.Path(exists=True, dir_okay=False), default=None, help="Read CSV from file instead of stdin.")
+def rebalance(dry_run: bool, yes: bool, threshold: float, csv_file: str | None) -> None:
+    """Default command. Paste a ticker,weight CSV → preview → confirm → execute."""
+    try:
+        ps, rt, aid = load_creds()
+    except CredsMissingError as e:
+        c.print(f"[red]{e}[/red]")
+        sys.exit(1)
+
+    ms = market_status()
+    if ms.status == "closed" and not dry_run:
+        c.print(f"[red]Market closed. Next open: {ms.next_open}.[/red]")
+        c.print("[yellow]Re-run with --dry-run to preview, or wait until the next session.[/yellow]")
+        sys.exit(2)
+    if ms.status in ("premarket", "afterhours") and not dry_run:
+        c.print(f"[red]Market in {ms.status} session — v1 only supports RTH market orders.[/red]")
+        c.print("[yellow]Re-run during RTH (09:30–16:00 ET) or pass --dry-run.[/yellow]")
+        sys.exit(2)
+
+    if csv_file:
+        with open(csv_file, encoding="utf-8") as f:
+            csv_text = f.read()
+    else:
+        c.print("\n[bold cyan]Paste CSV (ticker,weight), then Ctrl+D (Unix) or Ctrl+Z+Enter (Windows):[/bold cyan]")
+        csv_text = sys.stdin.read()
+
+    try:
+        targets = parse_csv(csv_text)
+    except CSVParseError as e:
+        c.print(f"[red]✗ CSV parse error:[/red] {e}")
+        sys.exit(1)
+
+    c.print(f"[green]✓ loaded {len(targets)} targets.[/green]")
+
+    t = Tasty(ps, rt, aid)
+    bal = t.balances()
+    pos = t.positions()
+    universe = sorted({tg.ticker for tg in targets} | set(pos.keys()))
+    c.print(f"Quoting {len(universe)} symbols...", style="dim")
+    quotes = t.quote(universe)
+    # supplement with last-known position prices for tickers we already hold
+    for tk, p in pos.items():
+        quotes.setdefault(tk, p.price)
+
+    preview = build_preview(
+        targets=targets,
+        positions=pos,
+        nav=bal.nav,
+        cash=bal.cash,
+        buying_power=bal.buying_power,
+        quotes=quotes,
+        drift_threshold=Decimal(str(threshold)),
+    )
+
+    _render_preview(preview, t.account_id, ms)
+
+    if preview.has_blockers:
+        c.print("[red]✗ blockers present — refusing to execute.[/red]")
+        sys.exit(1)
+
+    if not preview.orders:
+        c.print("[green]Nothing to do — portfolio within drift on every ticker.[/green]")
+        return
+
+    if dry_run:
+        c.print("[yellow]--dry-run set, exiting without sending orders.[/yellow]")
+        return
+
+    if not yes and not Confirm.ask(f"\nExecute [bold]{len(preview.orders)}[/bold] orders?", default=False):
+        c.print("[red]Cancelled.[/red]")
+        sys.exit(0)
+
+    _execute(t, preview)
+
+
+def _render_preview(preview, account_id: str, ms) -> None:
+    c.print(
+        f"\n[bold]Account[/bold] {account_id}  ·  "
+        f"NAV [green]${preview.nav:,.2f}[/green]  ·  "
+        f"cash ${preview.cash:,.2f}  ·  BP ${preview.buying_power:,.2f}"
+    )
+    if ms.minutes_to_close is not None:
+        marker = "[red]" if ms.minutes_to_close < 5 else "[yellow]" if ms.minutes_to_close < 15 else "[green]"
+        c.print(f"Market: open  ·  closes in {marker}{ms.minutes_to_close} min[/]")
+
+    table = Table(show_header=True, header_style="bold", title="Rebalance preview")
+    table.add_column("Symbol")
+    table.add_column("Current %", justify="right")
+    table.add_column("Target %", justify="right")
+    table.add_column("Δ $", justify="right")
+    table.add_column("Action", justify="left")
+    table.add_column("Note", justify="left", style="dim")
+
+    for row in preview.rows:
+        cur = f"{row.current_pct * 100:.1f}%"
+        tgt = f"{row.target_pct * 100:.1f}%"
+        delta = f"${row.delta_dollars:+,.0f}"
+        if row.order:
+            qty = f"{row.order.quantity:.2f}"
+            est_px = row.order.estimated_price or 0
+            action = (
+                f"[green]BUY  {qty} @ ~${est_px:,.2f}[/green]"
+                if row.order.side == Side.BUY
+                else f"[red]SELL {qty} @ ~${est_px:,.2f}[/red]"
+            )
+        else:
+            action = "—"
+        table.add_row(row.ticker, cur, tgt, delta, action, row.note)
+    c.print(table)
+
+    for w in preview.warnings:
+        c.print(f"[yellow]⚠ {w}[/yellow]")
+    for b in preview.blockers:
+        c.print(f"[red]✗ {b}[/red]")
+
+
+def _execute(t: Tasty, preview) -> None:
+    total = len(preview.orders)
+    sent = 0
+    failed = 0
+    for i, o in enumerate(preview.orders, 1):
+        c.print(f"[{i}/{total}] {o.ticker} {o.side.value} {o.quantity:.2f} @ MKT ...", end=" ")
+        try:
+            result = t.place_market(o, dry_run=False)
+        except Exception as e:
+            result = {"status": "error", "reason": str(e), "ticker": o.ticker}
+        status = result.get("status", "?")
+        if status == "error" or status == "skipped":
+            failed += 1
+            c.print(f"[red]{status.upper()}[/red] {result.get('reason', '')}")
+        else:
+            sent += 1
+            c.print(f"[green]{status.upper()}[/green]  id={result.get('order_id', '?')}")
+        fill_log.append({"event": "order", **result, "side": o.side.value, "quantity": float(o.quantity)})
+
+    c.print(f"\n[bold]Done.[/bold]  sent: {sent}  ·  failed: {failed}  ·  log: {fill_log.log_dir()}")
+
+
+if __name__ == "__main__":
+    main()

msts_trader-0.1.0/msts_trader/csv_parser.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import csv
+import io
+from decimal import Decimal, InvalidOperation
+
+from .models import Target
+
+
+class CSVParseError(ValueError):
+    pass
+
+
+REQUIRED_HEADERS = {"ticker", "weight"}
+
+
+def parse_csv(text: str) -> list[Target]:
+    """Parse a `ticker,weight` CSV. Tolerates BOM, blank lines, comments, surrounding whitespace.
+
+    Comment lines start with `#` (e.g. trailing `# sig: ed25519:...`) and are ignored.
+    """
+    text = text.lstrip("").strip()
+    if not text:
+        raise CSVParseError("empty input")
+
+    lines = [ln for ln in text.splitlines() if ln.strip() and not ln.lstrip().startswith("#")]
+    if not lines:
+        raise CSVParseError("no data rows")
+
+    reader = csv.DictReader(io.StringIO("\n".join(lines)))
+    headers = {h.strip().lower() for h in (reader.fieldnames or [])}
+    missing = REQUIRED_HEADERS - headers
+    if missing:
+        raise CSVParseError(f"missing required columns: {sorted(missing)} — got {sorted(headers)}")
+
+    targets: list[Target] = []
+    seen: set[str] = set()
+    for i, row in enumerate(reader, start=2):
+        tkr = (row.get("ticker") or row.get("Ticker") or "").strip().upper()
+        raw_w = (row.get("weight") or row.get("Weight") or "").strip()
+        if not tkr:
+            continue
+        if tkr in seen:
+            raise CSVParseError(f"line {i}: duplicate ticker {tkr}")
+        try:
+            w = Decimal(raw_w)
+        except InvalidOperation:
+            raise CSVParseError(f"line {i}: weight {raw_w!r} is not a number")
+        if w < 0:
+            raise CSVParseError(f"line {i}: negative weight {w} for {tkr} (shorts unsupported in v1)")
+        if w > 1:
+            raise CSVParseError(f"line {i}: weight {w} > 1 for {tkr} (expected fraction, not percent)")
+        seen.add(tkr)
+        targets.append(Target(ticker=tkr, weight=w))
+
+    if not targets:
+        raise CSVParseError("no targets parsed (all rows blank?)")
+    return targets
+
+
+def total_weight(targets: list[Target]) -> Decimal:
+    return sum((t.weight for t in targets), Decimal(0))