py-backlight 0.1.0__tar.gz

py_backlight-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.egg-info/
+.venv/
+gui/node_modules/
+gui/dist/
+src/backlight/_gui/
+dist/
+.claude/worktrees/
+*.tmp

py_backlight-0.1.0/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.5
+Name: py-backlight
+Version: 0.1.0
+Summary: Backtest, paper trade and live trade stock and option strategies built from pipelines of nodes
+Project-URL: Homepage, https://gitlab.com/JasonBerger/backlight
+Project-URL: Documentation, https://gitlab.com/JasonBerger/backlight/-/blob/main/README.md
+Project-URL: Repository, https://gitlab.com/JasonBerger/backlight
+Project-URL: Issues, https://gitlab.com/JasonBerger/backlight/-/issues
+Project-URL: Source, https://gitlab.com/JasonBerger/backlight
+Author-email: Jason Berger <berge472@gmail.com>
+License: MIT
+Keywords: algorithmic-trading,backtesting,options,paper-trading,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx>=0.27
+Requires-Dist: numpy>=1.26
+Requires-Dist: pyarrow>=15
+Requires-Dist: pydantic>=2.5
+Requires-Dist: pywebview>=5.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn>=0.27
+Requires-Dist: websockets>=12
+Provides-Extra: agent
+Requires-Dist: anthropic>=1.0; extra == 'agent'
+Requires-Dist: openai>=1.40; extra == 'agent'
+Provides-Extra: databento
+Requires-Dist: databento-dbn>=0.20; extra == 'databento'
+Provides-Extra: dev
+Requires-Dist: pytest-timeout>=2; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Backlight
+
+Automated stock and options trading platform: pipelines of parameterized nodes
+pick securities, decide how to trade them through tagged decision trees, refine
+those decisions, and hand orders to a connector. One runner drives the same
+pipeline in backtest, paper, or live mode. Built on the same stack as proxer:
+pywebview + FastAPI + Vue 3 (Vuetify).
+
+## Quick start
+
+```sh
+pip install py-backlight     # or, from a checkout: make install (pip install -e .[dev] + build the UI)
+backlight hub                # opens the desktop window (or: backlight hub --headless)
+```
+
+The PyPI distribution is `py-backlight` (`backlight` there is an old, empty
+project); the package, the import and the command are all `backlight`. Extras:
+`py-backlight[agent]` (the pipeline agent) and `py-backlight[databento]`.
+`make check` builds the wheel with the UI bundled and runs `twine check`;
+`make deploy` uploads it.
+
+Upgrading from `trader`, the old name: the first run moves `~/.config/trader`,
+`~/.trader` (and `trader.db` in it) and `~/.cache/trader` to their `backlight`
+names, `TRADER_*` environment variables still work where no `BACKLIGHT_*`
+one is set, and agent nodes are rewritten to import `backlight`.
+
+Without the window, the API is at `http://127.0.0.1:8770/docs`.
+
+Deployed on a cluster, headless, behind a Cloudflare tunnel and with sign-in
+on: see [docs/deploy.md](docs/deploy.md) (Dockerfile, Helm chart in
+`charts/backlight`). Sign-in is optional — off on the desktop unless you add a
+user with `backlight auth add-user NAME`.
+
+From the command line:
+
+```sh
+backlight catalog                                   # node types and connectors
+backlight backtest preset-sma-cross --symbols SPY,QQQ --start 2022-01-01 --end 2023-12-31
+backlight runs --mode backtest
+backlight report <run_id>                           # markdown run report
+backlight report <run_id_a> <run_id_b>              # compare
+backlight purge --older-than-days 30 --vacuum       # delete old backtest runs
+backlight fetch --provider massive --symbols SPY --start 2020-01-01 --end 2024-12-31
+backlight flatfiles --start 2024-01-01 --end 2024-12-31   # Massive option minute files, once
+backlight backtest preset-opt-0dte-condor --symbols SPY --provider alpaca --option-provider massive_files
+```
+
+The first launch seeds fifteen preset pipelines (stock, options, and two branching
+examples) and four decision trees into
+`~/.config/backlight/`, and the `synthetic` data connector needs no network, so
+the Backtest Lab works out of the box.
+
+## Layout
+
+| Path | What |
+| --- | --- |
+| `src/backlight/types.py` | The objects that cross node ports: `SecurityId`, `Bar`, `Quote`, `OptionContract`, `Universe`, `Signal`, `Intent`, `OrderRequest`, `OrderEvent`, `Position`. |
+| `src/backlight/pipeline/` | `params.py` (parameter schemas, from proxer), `nodes/` (trigger, universe, selector, strategy, refiner, sizer, execution, output, flow), `tree/` (decision tree model, safe expression language, action templates), `graph/` (pipeline docs, validation, compile, catalog, plugins, stores, presets), `engine.py` (the tick). |
+| `src/backlight/connectors/` | `base.py` (the three interfaces), `sim` (fill model, brackets, option expiry), `synthetic` (offline random-walk bars, Black-Scholes chains, paper-mode market data), `csv`, `schwab`, `alpaca`, `massive`, `massive_files` (option flat files over S3), `kalshi` (plan only). |
+| `src/backlight/runner/` | `portfolio.py` (ledger), `feed.py` (bar views for nodes and the sim), `backtest.py`, `live.py` (paper and live), `recorder.py`. |
+| `src/backlight/db/` | SQLite schema (every run-scoped table cascades from `runs`, which carries a `mode` column), migrations, run repo with purge, batched record writer, report queries and metrics. |
+| `src/backlight/hub/` | FastAPI routers (`api/`), background jobs, WebSocket event bus, hub config, secrets, pywebview shell. |
+| `gui/` | Vue 3 + Vuetify + VueFlow UI: Dashboard, Pipelines workbench, Decision Trees, Backtest Lab, Runs, Live, Data, Settings (with the Connectors tab), and an in-app illustrated guide (`gui/public/guide.html`). |
+| `charts/backlight/`, `Dockerfile` | Container image and Helm chart: one hub pod on a PVC, optional sign-in, optional cloudflared tunnel. |
+| `docs/` | The proposal, architecture notes, connector setup, Kalshi plan. |
+
+## How a tick works
+
+```
+trigger -> universe -> selector -> strategy (decision tree) -> refiners -> sizer -> execution -> final
+```
+
+Every node has `PARAMETERS` rendered by the GUI, typed ports checked at compile
+time, and tags. A strategy emits `Signal`s carrying the `DecisionPath` that
+produced them; refiners veto or reshape and leave a note; the sizer turns the
+signal into an `Intent`; execution builds `OrderRequest`s (with bracket
+children); `output.final` applies buying power and per-underlying caps. Every
+hop is recorded, so a fill walks back to the tree leaf and selector rule that
+caused it, and reports attribute P&L per tag, per leaf, and per tree edge.
+
+## Modes
+
+| Mode | Clock | Data | Execution |
+| --- | --- | --- | --- |
+| backtest | bar iterator | historical connector + Parquet cache | `sim` |
+| paper | wall clock | market connector | `sim` or a venue's paper account |
+| live | wall clock | market connector | venue (Schwab) |
+
+Backtest runs can be purged from the Runs view or with `backlight purge`; paper
+and live runs are kept unless purged by mode explicitly.
+
+## Writing a node
+
+```python
+from backlight.pipeline.nodes.base import RefinerNode, register_node
+from backlight.pipeline.params import Parameter
+
+@register_node
+class NoFridays(RefinerNode):
+    """Veto new entries on Fridays."""
+    kind = "refiner.no-fridays"
+    label = "No Fridays"
+    PARAMETERS = [Parameter("enabled_days", "number", "Days", default=4, min=0, max=6, step=1)]
+
+    def applies(self, signal, ctx):
+        return signal.action.value.startswith("open")
+
+    def apply(self, signal, ctx):
+        return self.veto("friday") if ctx.now.weekday() == 4 else signal
+```
+
+The docstring is the node's documentation in the workbench: its first
+paragraph is the palette description, the whole of it shows under **More**.
+`PORT_DOCS = {"port": "..."}` says what a port means on this node. Text is
+plain: blank lines split paragraphs, `- ` starts a list item, backticks mark
+code.
+
+Port types (`run`, `universe`, `signal`, `intent`, `order`) live in a registry
+in `backlight.pipeline.ports`; clicking a port in the workbench opens its
+documentation. A plugin registers its own from the same module:
+
+```python
+from backlight.pipeline.ports import PortType, register_port_type
+
+register_port_type(PortType(
+    "alert", "Alert", "A message for the operator.",
+    doc="Longer explanation for the port-type dialog.",
+    carries=Alert,                       # a dataclass: its fields are listed
+    field_docs={"text": "What to say."}, color="#e11d48"))
+```
+
+The engine only moves values along the ports each node category handles, so
+a plugin type is documented and wired in the editor, but nothing produces or
+consumes it yet.
+
+Drop the file in `~/.config/backlight/plugins/nodes/` or register it under the
+`backlight.nodes` entry-point group. Connectors work the same way under
+`plugins/connectors/` and the `backlight.connectors` group.
+
+## Pipeline agent
+
+In the pipeline editor, **Agent** opens a chat that builds and edits the open
+pipeline: it reads the node catalog and other pipelines, adds and wires nodes,
+sets parameters and validates, and the canvas follows each edit (nothing is
+saved until you press Save). Chats are per user and kept per pipeline.
+
+When no node fits, the agent can write one. A written node loads only after:
+a static check (allowed imports and calls, no private attributes or routes to
+connectors, never an execution or output node), an import test in a separate
+process with an empty environment, and approval by a reviewer agent. Approved
+nodes live in `~/.config/backlight/plugins/agent-nodes/` and are listed (with
+their code and review) under Admin → Settings → Agent, where an admin can
+remove them.
+
+Setup: `pip install -e ".[agent]"` (the Docker image includes it), then Admin →
+Settings → Agent: provider (OpenAI or Anthropic), its API key, model, Enable.
+OpenAI also covers any OpenAI-compatible endpoint through the base URL.
+Anthropic is spoken natively (Claude's thinking is kept across turns, an
+effort setting, prompt caching, and on Anthropic's own API a declined request
+is retried on Anthropic's recommended fallback model). One hub-wide key per
+provider; every signed-in user's chats use the active one.
+
+The tools (`backlight.agent.tools`) are plain name + JSON schema + handler over a
+server-side working pipeline, so another front end (an MCP server) can expose
+the same set.
+
+## Paths
+
+| What | Where | Override |
+| --- | --- | --- |
+| pipelines, trees, hub config, secrets, plugins | `~/.config/backlight/` | `BACKLIGHT_CONFIG_DIR` |
+| SQLite database | `~/.backlight/backlight.db` | `BACKLIGHT_DATA_DIR`, `BACKLIGHT_DB` |
+| Parquet bar cache, logs | `~/.cache/backlight/` | `BACKLIGHT_CACHE_DIR` |
+
+### Moving a cache to another instance
+
+A provider's cached bars, option blocks and downloaded store (Massive flat
+files, Databento's dataset) export to one tar and import anywhere, from the
+Data tab (Export / import cache) or the CLI:
+
+```sh
+backlight cache list                                          # what each provider holds
+backlight cache export --provider massive --provider massive_files -o massive.tar
+backlight cache export --provider massive_files --timeframe 1d -o day.tar   # only some timeframes
+backlight cache import massive.tar                            # on the other instance
+ssh a backlight cache export --provider massive -o - | backlight cache import -   # or piped
+```
+
+An import never deletes. Files already there are kept unless the archive's
+copy is newer (`--mode newer`, the default; bar files merge instead), or
+always replaced (`--mode replace`), or always kept (`--mode skip`). Store
+files land in the importing instance's own `data_dir` for that connector.
+The Data tab uploads in 32 MB pieces, so a proxy's body limit (Cloudflare:
+100 MB) doesn't get in the way.
+
+## Development
+
+```sh
+make test      # pytest
+make smoke     # every preset through a two-year synthetic backtest
+make gui       # rebuild the UI after editing gui/src
+BACKLIGHT_HUB_DEBUG=1 backlight hub   # WebKit inspector in the window
+```

py_backlight-0.1.0/README.md

@@ -0,0 +1,203 @@
+# Backlight
+
+Automated stock and options trading platform: pipelines of parameterized nodes
+pick securities, decide how to trade them through tagged decision trees, refine
+those decisions, and hand orders to a connector. One runner drives the same
+pipeline in backtest, paper, or live mode. Built on the same stack as proxer:
+pywebview + FastAPI + Vue 3 (Vuetify).
+
+## Quick start
+
+```sh
+pip install py-backlight     # or, from a checkout: make install (pip install -e .[dev] + build the UI)
+backlight hub                # opens the desktop window (or: backlight hub --headless)
+```
+
+The PyPI distribution is `py-backlight` (`backlight` there is an old, empty
+project); the package, the import and the command are all `backlight`. Extras:
+`py-backlight[agent]` (the pipeline agent) and `py-backlight[databento]`.
+`make check` builds the wheel with the UI bundled and runs `twine check`;
+`make deploy` uploads it.
+
+Upgrading from `trader`, the old name: the first run moves `~/.config/trader`,
+`~/.trader` (and `trader.db` in it) and `~/.cache/trader` to their `backlight`
+names, `TRADER_*` environment variables still work where no `BACKLIGHT_*`
+one is set, and agent nodes are rewritten to import `backlight`.
+
+Without the window, the API is at `http://127.0.0.1:8770/docs`.
+
+Deployed on a cluster, headless, behind a Cloudflare tunnel and with sign-in
+on: see [docs/deploy.md](docs/deploy.md) (Dockerfile, Helm chart in
+`charts/backlight`). Sign-in is optional — off on the desktop unless you add a
+user with `backlight auth add-user NAME`.
+
+From the command line:
+
+```sh
+backlight catalog                                   # node types and connectors
+backlight backtest preset-sma-cross --symbols SPY,QQQ --start 2022-01-01 --end 2023-12-31
+backlight runs --mode backtest
+backlight report <run_id>                           # markdown run report
+backlight report <run_id_a> <run_id_b>              # compare
+backlight purge --older-than-days 30 --vacuum       # delete old backtest runs
+backlight fetch --provider massive --symbols SPY --start 2020-01-01 --end 2024-12-31
+backlight flatfiles --start 2024-01-01 --end 2024-12-31   # Massive option minute files, once
+backlight backtest preset-opt-0dte-condor --symbols SPY --provider alpaca --option-provider massive_files
+```
+
+The first launch seeds fifteen preset pipelines (stock, options, and two branching
+examples) and four decision trees into
+`~/.config/backlight/`, and the `synthetic` data connector needs no network, so
+the Backtest Lab works out of the box.
+
+## Layout
+
+| Path | What |
+| --- | --- |
+| `src/backlight/types.py` | The objects that cross node ports: `SecurityId`, `Bar`, `Quote`, `OptionContract`, `Universe`, `Signal`, `Intent`, `OrderRequest`, `OrderEvent`, `Position`. |
+| `src/backlight/pipeline/` | `params.py` (parameter schemas, from proxer), `nodes/` (trigger, universe, selector, strategy, refiner, sizer, execution, output, flow), `tree/` (decision tree model, safe expression language, action templates), `graph/` (pipeline docs, validation, compile, catalog, plugins, stores, presets), `engine.py` (the tick). |
+| `src/backlight/connectors/` | `base.py` (the three interfaces), `sim` (fill model, brackets, option expiry), `synthetic` (offline random-walk bars, Black-Scholes chains, paper-mode market data), `csv`, `schwab`, `alpaca`, `massive`, `massive_files` (option flat files over S3), `kalshi` (plan only). |
+| `src/backlight/runner/` | `portfolio.py` (ledger), `feed.py` (bar views for nodes and the sim), `backtest.py`, `live.py` (paper and live), `recorder.py`. |
+| `src/backlight/db/` | SQLite schema (every run-scoped table cascades from `runs`, which carries a `mode` column), migrations, run repo with purge, batched record writer, report queries and metrics. |
+| `src/backlight/hub/` | FastAPI routers (`api/`), background jobs, WebSocket event bus, hub config, secrets, pywebview shell. |
+| `gui/` | Vue 3 + Vuetify + VueFlow UI: Dashboard, Pipelines workbench, Decision Trees, Backtest Lab, Runs, Live, Data, Settings (with the Connectors tab), and an in-app illustrated guide (`gui/public/guide.html`). |
+| `charts/backlight/`, `Dockerfile` | Container image and Helm chart: one hub pod on a PVC, optional sign-in, optional cloudflared tunnel. |
+| `docs/` | The proposal, architecture notes, connector setup, Kalshi plan. |
+
+## How a tick works
+
+```
+trigger -> universe -> selector -> strategy (decision tree) -> refiners -> sizer -> execution -> final
+```
+
+Every node has `PARAMETERS` rendered by the GUI, typed ports checked at compile
+time, and tags. A strategy emits `Signal`s carrying the `DecisionPath` that
+produced them; refiners veto or reshape and leave a note; the sizer turns the
+signal into an `Intent`; execution builds `OrderRequest`s (with bracket
+children); `output.final` applies buying power and per-underlying caps. Every
+hop is recorded, so a fill walks back to the tree leaf and selector rule that
+caused it, and reports attribute P&L per tag, per leaf, and per tree edge.
+
+## Modes
+
+| Mode | Clock | Data | Execution |
+| --- | --- | --- | --- |
+| backtest | bar iterator | historical connector + Parquet cache | `sim` |
+| paper | wall clock | market connector | `sim` or a venue's paper account |
+| live | wall clock | market connector | venue (Schwab) |
+
+Backtest runs can be purged from the Runs view or with `backlight purge`; paper
+and live runs are kept unless purged by mode explicitly.
+
+## Writing a node
+
+```python
+from backlight.pipeline.nodes.base import RefinerNode, register_node
+from backlight.pipeline.params import Parameter
+
+@register_node
+class NoFridays(RefinerNode):
+    """Veto new entries on Fridays."""
+    kind = "refiner.no-fridays"
+    label = "No Fridays"
+    PARAMETERS = [Parameter("enabled_days", "number", "Days", default=4, min=0, max=6, step=1)]
+
+    def applies(self, signal, ctx):
+        return signal.action.value.startswith("open")
+
+    def apply(self, signal, ctx):
+        return self.veto("friday") if ctx.now.weekday() == 4 else signal
+```
+
+The docstring is the node's documentation in the workbench: its first
+paragraph is the palette description, the whole of it shows under **More**.
+`PORT_DOCS = {"port": "..."}` says what a port means on this node. Text is
+plain: blank lines split paragraphs, `- ` starts a list item, backticks mark
+code.
+
+Port types (`run`, `universe`, `signal`, `intent`, `order`) live in a registry
+in `backlight.pipeline.ports`; clicking a port in the workbench opens its
+documentation. A plugin registers its own from the same module:
+
+```python
+from backlight.pipeline.ports import PortType, register_port_type
+
+register_port_type(PortType(
+    "alert", "Alert", "A message for the operator.",
+    doc="Longer explanation for the port-type dialog.",
+    carries=Alert,                       # a dataclass: its fields are listed
+    field_docs={"text": "What to say."}, color="#e11d48"))
+```
+
+The engine only moves values along the ports each node category handles, so
+a plugin type is documented and wired in the editor, but nothing produces or
+consumes it yet.
+
+Drop the file in `~/.config/backlight/plugins/nodes/` or register it under the
+`backlight.nodes` entry-point group. Connectors work the same way under
+`plugins/connectors/` and the `backlight.connectors` group.
+
+## Pipeline agent
+
+In the pipeline editor, **Agent** opens a chat that builds and edits the open
+pipeline: it reads the node catalog and other pipelines, adds and wires nodes,
+sets parameters and validates, and the canvas follows each edit (nothing is
+saved until you press Save). Chats are per user and kept per pipeline.
+
+When no node fits, the agent can write one. A written node loads only after:
+a static check (allowed imports and calls, no private attributes or routes to
+connectors, never an execution or output node), an import test in a separate
+process with an empty environment, and approval by a reviewer agent. Approved
+nodes live in `~/.config/backlight/plugins/agent-nodes/` and are listed (with
+their code and review) under Admin → Settings → Agent, where an admin can
+remove them.
+
+Setup: `pip install -e ".[agent]"` (the Docker image includes it), then Admin →
+Settings → Agent: provider (OpenAI or Anthropic), its API key, model, Enable.
+OpenAI also covers any OpenAI-compatible endpoint through the base URL.
+Anthropic is spoken natively (Claude's thinking is kept across turns, an
+effort setting, prompt caching, and on Anthropic's own API a declined request
+is retried on Anthropic's recommended fallback model). One hub-wide key per
+provider; every signed-in user's chats use the active one.
+
+The tools (`backlight.agent.tools`) are plain name + JSON schema + handler over a
+server-side working pipeline, so another front end (an MCP server) can expose
+the same set.
+
+## Paths
+
+| What | Where | Override |
+| --- | --- | --- |
+| pipelines, trees, hub config, secrets, plugins | `~/.config/backlight/` | `BACKLIGHT_CONFIG_DIR` |
+| SQLite database | `~/.backlight/backlight.db` | `BACKLIGHT_DATA_DIR`, `BACKLIGHT_DB` |
+| Parquet bar cache, logs | `~/.cache/backlight/` | `BACKLIGHT_CACHE_DIR` |
+
+### Moving a cache to another instance
+
+A provider's cached bars, option blocks and downloaded store (Massive flat
+files, Databento's dataset) export to one tar and import anywhere, from the
+Data tab (Export / import cache) or the CLI:
+
+```sh
+backlight cache list                                          # what each provider holds
+backlight cache export --provider massive --provider massive_files -o massive.tar
+backlight cache export --provider massive_files --timeframe 1d -o day.tar   # only some timeframes
+backlight cache import massive.tar                            # on the other instance
+ssh a backlight cache export --provider massive -o - | backlight cache import -   # or piped
+```
+
+An import never deletes. Files already there are kept unless the archive's
+copy is newer (`--mode newer`, the default; bar files merge instead), or
+always replaced (`--mode replace`), or always kept (`--mode skip`). Store
+files land in the importing instance's own `data_dir` for that connector.
+The Data tab uploads in 32 MB pieces, so a proxy's body limit (Cloudflare:
+100 MB) doesn't get in the way.
+
+## Development
+
+```sh
+make test      # pytest
+make smoke     # every preset through a two-year synthetic backtest
+make gui       # rebuild the UI after editing gui/src
+BACKLIGHT_HUB_DEBUG=1 backlight hub   # WebKit inspector in the window
+```

py_backlight-0.1.0/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+# `backlight` on PyPI is an empty 2012 project, so the distribution is
+# py-backlight; the package, the CLI and the import are all `backlight`.
+name = "py-backlight"
+dynamic = ["version"]
+description = "Backtest, paper trade and live trade stock and option strategies built from pipelines of nodes"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Jason Berger", email = "berge472@gmail.com" }]
+keywords = ["trading", "backtesting", "options", "paper-trading", "algorithmic-trading"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn>=0.27",
+    "pydantic>=2.5",
+    "pywebview>=5.0",
+    "pyyaml>=6.0",
+    "httpx>=0.27",
+    "websockets>=12",
+    "numpy>=1.26",
+    "pyarrow>=15",
+]
+
+[project.optional-dependencies]
+# `backlight databento-import`: reads Databento batch downloads (DBN metadata)
+databento = [
+    "databento-dbn>=0.20",
+]
+# the pipeline agent (Pipelines → chat): OpenAI (or an OpenAI-compatible API) or Anthropic
+agent = [
+    "openai>=1.40",
+    "anthropic>=1.0",
+]
+dev = [
+    "pytest>=7",
+    "pytest-timeout>=2",
+    "ruff>=0.4",
+]
+
+[project.scripts]
+backlight = "backlight.cli:main"
+
+[project.urls]
+Homepage = "https://gitlab.com/JasonBerger/backlight"
+Documentation = "https://gitlab.com/JasonBerger/backlight/-/blob/main/README.md"
+Repository = "https://gitlab.com/JasonBerger/backlight"
+Issues = "https://gitlab.com/JasonBerger/backlight/-/issues"
+Source = "https://gitlab.com/JasonBerger/backlight"
+
+[project.entry-points."backlight.nodes"]
+# Third-party node plugins register here: name = "package.module".
+
+[project.entry-points."backlight.connectors"]
+# Third-party connector plugins register here: name = "package.module".
+
+[tool.hatch.version]
+path = "src/backlight/version.py"
+
+[tool.hatch.build]
+# The built UI, copied in by `make dist` (git ignores it, hence an artifact).
+# Absent, the wheel still builds and the hub serves gui/dist from a checkout.
+artifacts = ["src/backlight/_gui/**"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/backlight"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/backlight", "README.md", "pyproject.toml"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "W"]
+per-file-ignores = { "tests/*" = ["E501"], "src/backlight/db/records.py" = ["E501"] }
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

py_backlight-0.1.0/src/backlight/__init__.py

@@ -0,0 +1,14 @@
+"""Backlight: automated stock and options trading platform.
+
+Pipelines of parameterized nodes pick securities, decide how to trade them
+through tagged decision trees, refine those decisions, and hand orders to a
+connector. One runner drives the same pipeline in backtest, paper, or live
+mode. See ``docs/`` for the proposal this implements.
+"""
+
+from backlight.paths import adopt_legacy_env
+from backlight.version import __version__
+
+adopt_legacy_env()
+
+__all__ = ["__version__"]

py_backlight-0.1.0/src/backlight/_gui/assets/AccountView-CbigG0KS.js

@@ -0,0 +1 @@
+import{_ as N,aR as T,c as m,d as s,s as k,u as v,F as U,e as t,w as o,h as x,f as n,l as V,k as u,j as q,a3 as L,m as R,n as r,a4 as g,t as h,i as C,H as W}from"./index-BfAt6891.js";import{C as D,S as F,W as j}from"./WebKeysPanel-C63Vkpqw.js";import"./SymbolsInput-BZQQUVay.js";const E={class:"page"},H={class:"page-head"},I={class:"muted"},K={key:0,class:"card muted"},M={key:0,class:"apanel"},Y={key:3,class:"agrid"},G={class:"card"},J={class:"card-title"},O={class:"card"},Q={class:"card-title"},X={__name:"AccountView",setup(Z){const w=T(),c=L(),P=R(),d=V({get:()=>["brokers","symbols","webkeys"].includes(c.query.tab)?c.query.tab:"profile",set:l=>P.replace({query:{...c.query,tab:l==="profile"?void 0:l}})});async function S(l){w.global.name.value=l,await h(()=>C.putSettings({ui:{theme:l}}))}const a=q({current:"",next:"",again:"",busy:!1}),b=V(()=>a.value.next?a.value.next.length<8?"at least 8 characters":a.value.again&&a.value.again!==a.value.next?"the two new passwords differ":"":"");async function z(){a.value.busy=!0;const l=await h(()=>C.changePassword(a.value.current,a.value.next),null);a.value.busy=!1,l&&(W("password changed: sign in again with the new one","success"),setTimeout(()=>location.assign("/login"),1200))}return(l,e)=>{const p=u("v-tab"),A=u("v-tabs"),_=u("v-icon"),y=u("v-btn"),B=u("v-btn-toggle"),f=u("v-text-field");return r(),m("div",E,[s("div",H,[e[4]||(e[4]=s("h1",null,"Account",-1)),s("span",I,k(v(g).name)+" · "+k(v(g).role),1)]),v(g).auth?(r(),m(U,{key:1},[t(A,{modelValue:d.value,"onUpdate:modelValue":e[0]||(e[0]=i=>d.value=i),density:"compact",color:"primary",class:"mb-4 atabs"},{default:o(()=>[t(p,{value:"profile","prepend-icon":"mdi-account-outline"},{default:o(()=>[...e[5]||(e[5]=[n("Profile",-1)])]),_:1}),t(p,{value:"brokers","prepend-icon":"mdi-bank-outline"},{default:o(()=>[...e[6]||(e[6]=[n("My brokers",-1)])]),_:1}),t(p,{value:"symbols","prepend-icon":"mdi-format-list-group"},{default:o(()=>[...e[7]||(e[7]=[n("Symbol sets",-1)])]),_:1}),t(p,{value:"webkeys","prepend-icon":"mdi-key-chain-variant"},{default:o(()=>[...e[8]||(e[8]=[n("Web keys",-1)])]),_:1})]),_:1},8,["modelValue"]),d.value==="brokers"?(r(),m("div",M,[t(D,{mine:""})])):d.value==="symbols"?(r(),x(F,{key:1})):d.value==="webkeys"?(r(),x(j,{key:2})):(r(),m("div",Y,[s("div",G,[s("div",J,[t(_,{icon:"mdi-theme-light-dark",size:"14"}),e[9]||(e[9]=n("Theme",-1))]),t(B,{"model-value":v(w).global.name.value,mandatory:"",density:"compact",variant:"outlined",divided:"","onUpdate:modelValue":S},{default:o(()=>[t(y,{value:"dark",size:"small","prepend-icon":"mdi-weather-night"},{default:o(()=>[...e[10]||(e[10]=[n("Dark",-1)])]),_:1}),t(y,{value:"light",size:"small","prepend-icon":"mdi-white-balance-sunny"},{default:o(()=>[...e[11]||(e[11]=[n("Light",-1)])]),_:1})]),_:1},8,["model-value"]),e[12]||(e[12]=s("div",{class:"muted mt-3",style:{"font-size":"11.5px"}}," Your own: the theme, Backtest Lab and Live form values, and campaign defaults are kept for you alone. ",-1))]),s("div",O,[s("div",Q,[t(_,{icon:"mdi-form-textbox-password",size:"14"}),e[13]||(e[13]=n("Password",-1))]),t(f,{modelValue:a.value.current,"onUpdate:modelValue":e[1]||(e[1]=i=>a.value.current=i),type:"password",label:"Current password",autocomplete:"current-password",class:"mb-2"},null,8,["modelValue"]),t(f,{modelValue:a.value.next,"onUpdate:modelValue":e[2]||(e[2]=i=>a.value.next=i),type:"password",label:"New password",autocomplete:"new-password",class:"mb-2"},null,8,["modelValue"]),t(f,{modelValue:a.value.again,"onUpdate:modelValue":e[3]||(e[3]=i=>a.value.again=i),type:"password",label:"New password again",autocomplete:"new-password","error-messages":b.value?[b.value]:[]},null,8,["modelValue","error-messages"]),t(y,{color:"primary",variant:"flat",class:"mt-2",loading:a.value.busy,disabled:!a.value.current||!a.value.next||a.value.next!==a.value.again||!!b.value,onClick:z},{default:o(()=>[...e[14]||(e[14]=[n("Change password",-1)])]),_:1},8,["loading","disabled"]),e[15]||(e[15]=s("div",{class:"muted mt-2",style:{"font-size":"11.5px"}},"Changing it signs you out everywhere.",-1))])]))],64)):(r(),m("div",K,"Sign-in is off on this hub: there is one local admin, and everything is in Admin."))])}}},te=N(X,[["__scopeId","data-v-e180d83b"]]);export{te as default};

py_backlight-0.1.0/src/backlight/_gui/assets/AccountView-DnAwP8fS.css

@@ -0,0 +1 @@
+.agrid[data-v-e180d83b]{display:grid;grid-template-columns:1fr 1fr;gap:12px;align-items:start;max-width:900px}.apanel[data-v-e180d83b]{max-width:1100px}.atabs[data-v-e180d83b]{border-bottom:1px solid var(--line)}@media(max-width:800px){.agrid[data-v-e180d83b]{grid-template-columns:1fr}}

py_backlight-0.1.0/src/backlight/_gui/assets/BacktestLabView-DRPXydD8.css

@@ -0,0 +1 @@
+.g2[data-v-de158446]{display:grid;grid-template-columns:1fr 1fr;gap:16px 12px;padding-top:6px}.g4[data-v-de158446]{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:16px 10px;padding-top:6px}.g6[data-v-de158446]{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:18px 10px;padding-top:6px;margin-bottom:12px}.g4+.muted[data-v-de158446]{margin-top:16px}.sets[data-v-de158446]{display:flex;flex-direction:column;gap:6px}.set[data-v-de158446]{border:1px solid var(--line);border-radius:8px;padding:8px 10px;cursor:pointer;font-size:12.5px}.set[data-v-de158446]:hover{background:var(--panel-2)}.set.on[data-v-de158446]{border-color:var(--accent);background:#4f8cff14}.chips[data-v-de158446]{display:flex;flex-wrap:wrap;gap:4px;align-items:center;margin-top:4px}.small[data-v-de158446]{font-size:11.5px}.newset[data-v-de158446]{border:1px dashed var(--line);border-radius:8px;padding:10px}.small[data-v-f109decf]{font-size:11.5px}.plist[data-v-f109decf]{display:flex;flex-direction:column;gap:3px}.pitem[data-v-f109decf]{display:flex;align-items:center;gap:8px;padding:5px 8px;border-radius:6px;cursor:pointer;border:1px solid transparent;font-size:12.5px}.pitem[data-v-f109decf]:hover{background:var(--panel-2)}.pitem.on[data-v-f109decf]{border-color:#4f8cff80;background:#4f8cff14}.bandchart[data-v-ccd75fcf]{position:relative}svg[data-v-ccd75fcf]{width:100%;display:block}.grid line[data-v-ccd75fcf]{stroke:var(--line);stroke-width:1;vector-effect:non-scaling-stroke}.one[data-v-ccd75fcf]{stroke:var(--muted);stroke-dasharray:3 3;vector-effect:non-scaling-stroke;opacity:.6}.cross[data-v-ccd75fcf]{stroke:var(--muted);vector-effect:non-scaling-stroke}.axis text[data-v-ccd75fcf]{fill:var(--muted);font-size:11px}.readout[data-v-ccd75fcf]{position:absolute;top:8px;right:24px;background:var(--panel);border:1px solid var(--line);border-radius:6px;padding:6px 8px;font-size:11.5px;pointer-events:none;width:430px;opacity:.96}.readout[data-v-ccd75fcf]:not(.right){right:auto;left:64px}.rr[data-v-ccd75fcf]{display:flex;gap:6px;align-items:center}.rr .nm[data-v-ccd75fcf]{flex:1}.sw[data-v-ccd75fcf]{width:10px;height:10px;border-radius:2px;display:inline-block;flex:0 0 auto}.legend[data-v-ccd75fcf]{display:flex;flex-wrap:wrap;gap:4px 14px;font-size:11.5px;margin-top:6px}.lg[data-v-ccd75fcf]{display:inline-flex;align-items:center;gap:6px;cursor:default;padding:1px 4px;border-radius:4px}.lg.on[data-v-ccd75fcf]{background:var(--panel-2)}.lg.dim[data-v-ccd75fcf]{opacity:.45}.hm-tools[data-v-5cc040ef]{display:flex;align-items:center;flex-wrap:wrap;gap:4px;margin-bottom:8px;font-size:12px}.hm-wrap[data-v-5cc040ef]{overflow-x:auto}.hm[data-v-5cc040ef]{border-collapse:separate;border-spacing:2px;font-size:11.5px}.hm th.fam[data-v-5cc040ef]{font-size:10.5px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted);font-weight:500;border-bottom:1px solid var(--line);padding:2px 4px}.hm th.colh[data-v-5cc040ef]{font-weight:500;color:var(--muted);padding:2px 4px;max-width:90px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.hm th.rowh[data-v-5cc040ef]{text-align:left;font-weight:400;min-width:180px;max-width:220px;padding-right:8px}.hm td[data-v-5cc040ef]{min-width:64px;height:34px;text-align:center;border-radius:4px;cursor:pointer;font-variant-numeric:tabular-nums}.hm td.empty[data-v-5cc040ef]{cursor:default;background:var(--panel-2)!important}.hm td.sel[data-v-5cc040ef]{outline:2px solid var(--accent)}.hm-note[data-v-5cc040ef]{font-size:11px;margin-top:6px}.ev-grid[data-v-c525c5bd]{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:12px}.ev[data-v-c525c5bd]{border:1px solid var(--line);border-radius:8px;padding:8px}.ev-h[data-v-c525c5bd]{font-size:12px;margin-bottom:4px}svg[data-v-c525c5bd]{width:100%;display:block}.zero[data-v-c525c5bd]{stroke:var(--line)}.day0[data-v-c525c5bd]{stroke:var(--muted);stroke-dasharray:2 3}.bench[data-v-c525c5bd]{stroke:var(--muted);stroke-dasharray:5 4;fill:none;stroke-width:1.2}.ax[data-v-c525c5bd]{fill:var(--muted);font-size:10px}.ev-row[data-v-c525c5bd]{display:flex;gap:6px;align-items:center;font-size:11.5px}.ev-row .clip[data-v-c525c5bd]{flex:1}.sw[data-v-c525c5bd]{width:10px;height:10px;border-radius:2px;flex:0 0 auto}.ev-note[data-v-c525c5bd]{font-size:11px;margin-top:6px}.br[data-v-861b6cb9]{fill:#f59e0b2e}.one[data-v-861b6cb9]{stroke:var(--muted);stroke-dasharray:3 3;vector-effect:non-scaling-stroke;opacity:.6}.ax[data-v-861b6cb9]{fill:var(--muted);font-size:11px}.runs-n[data-v-e1cd547d]{font-size:11px;opacity:.8}.vis-pick[data-v-e1cd547d]{flex:0 0 160px}.lab-grid[data-v-e1cd547d]{display:grid;grid-template-columns:300px minmax(0,1fr);gap:12px;align-items:start}.rail[data-v-e1cd547d]{display:flex;flex-direction:column;gap:10px}.rail .card[data-v-e1cd547d]{margin:0}.results[data-v-e1cd547d]{min-height:520px}.rhead[data-v-e1cd547d]{display:flex;align-items:center;border-bottom:1px solid var(--line);margin:-4px 0 8px}.tabbody[data-v-e1cd547d]{padding:4px 2px}.manage[data-v-e1cd547d]{font-size:11px;color:var(--accent);text-decoration:none;cursor:pointer}.manage[data-v-e1cd547d]:hover{text-decoration:underline}.src[data-v-e1cd547d]{display:flex;align-items:center;gap:6px;font-size:12.5px;flex-wrap:wrap}.dot[data-v-e1cd547d]{display:inline-block;width:8px;height:8px;border-radius:50%;background:#ef4444}.dot.ok[data-v-e1cd547d]{background:#22c55e}.g2[data-v-e1cd547d]{display:grid;grid-template-columns:1fr 1fr;gap:8px}.small[data-v-e1cd547d]{font-size:11.5px}.note[data-v-e1cd547d]{font-size:11.5px;color:var(--muted);display:flex;gap:4px;align-items:flex-start;flex-wrap:wrap}.chips[data-v-e1cd547d]{display:flex;flex-wrap:wrap;gap:4px;align-items:center}.tray[data-v-e1cd547d]{display:flex;flex-direction:column;gap:4px}.tchip[data-v-e1cd547d]{display:flex;align-items:center;gap:6px;padding:4px 8px;border:1px solid var(--line);border-radius:999px;font-size:12.5px}.tchip .clip[data-v-e1cd547d]{flex:1}.tchip.missing[data-v-e1cd547d]{border-style:dashed;opacity:.7}.tchip .mx[data-v-e1cd547d]{cursor:pointer;opacity:.5}.tchip .mx[data-v-e1cd547d]:hover{opacity:1}.sympv[data-v-e1cd547d]{font-size:12px;display:flex;flex-direction:column;gap:3px}.symchips[data-v-e1cd547d]{display:flex;flex-wrap:wrap;gap:3px}.symchip[data-v-e1cd547d]{font-size:11px;padding:1px 6px;border-radius:4px;background:var(--panel-2);border:1px solid var(--line)}.prog[data-v-e1cd547d]{padding:6px 2px 10px;border-bottom:1px solid var(--line);margin-bottom:10px}.prow[data-v-e1cd547d]{display:grid;grid-template-columns:minmax(0,1.6fr) 74px minmax(0,1fr) 100px 100px;gap:10px;align-items:center;font-size:12px;padding:3px 0}.prow-data[data-v-e1cd547d]{grid-column:1 / -1;display:flex;align-items:center;gap:6px;font-size:11px;color:var(--muted)}.empty[data-v-e1cd547d]{text-align:center;padding:70px 40px;display:flex;flex-direction:column;gap:8px;align-items:center;max-width:620px;margin:0 auto}.sum[data-v-e1cd547d]{width:100%;border-collapse:collapse;font-size:12.5px}.sum th[data-v-e1cd547d]{text-align:left;font-weight:500;color:var(--muted);font-size:11.5px;padding:6px 8px;border-bottom:1px solid var(--line)}.sum td[data-v-e1cd547d]{padding:6px 8px;border-bottom:1px solid var(--line);vertical-align:top}.sum .r[data-v-e1cd547d]{text-align:right;font-variant-numeric:tabular-nums}.sum tr.clickable[data-v-e1cd547d]{cursor:pointer}.sum tr.clickable:hover td[data-v-e1cd547d]{background:var(--panel-2)}.range[data-v-e1cd547d]{font-size:10.5px}.live i[data-v-e1cd547d]{font-size:10.5px;opacity:.7}.sw[data-v-e1cd547d]{width:10px;height:10px;border-radius:2px;display:inline-block;margin-right:6px}.cell-detail[data-v-e1cd547d]{border:1px solid var(--line);border-radius:8px;padding:8px 10px;font-size:12.5px}.sec-h[data-v-e1cd547d]{font-size:11px;text-transform:uppercase;letter-spacing:.04em;margin:12px 0 6px}.fgrid[data-v-e1cd547d]{display:grid;gap:16px 12px}.fgrid+.fgrid[data-v-e1cd547d]{margin-top:16px}.adv-dlg .sec-h[data-v-e1cd547d]{margin:20px 0 10px}.adv-dlg .sec-h[data-v-e1cd547d]:first-child{margin-top:6px}.adv-dlg .checks[data-v-e1cd547d]{margin-top:8px}.adv-dlg[data-v-e1cd547d] .v-card-text{padding-top:8px!important}.adv-row[data-v-e1cd547d]{display:flex;align-items:center;gap:8px}.adv-row .clip[data-v-e1cd547d]{flex:1;min-width:0}.fgrid.g3[data-v-e1cd547d]{grid-template-columns:repeat(3,minmax(0,1fr))}.fgrid.g4[data-v-e1cd547d]{grid-template-columns:repeat(4,minmax(0,1fr))}.checks[data-v-e1cd547d]{display:flex;flex-wrap:wrap;gap:0 14px}.rcol[data-v-e1cd547d]{min-width:0}.setworlds[data-v-e1cd547d]{display:flex;flex-wrap:wrap;gap:2px 8px;font-size:11.5px}.setworlds .ctl[data-v-e1cd547d]{color:var(--muted)}.batches td.pl[data-v-e1cd547d]{max-width:420px}.batches tr.active td[data-v-e1cd547d]{background:#4f8cff1a}.batches .del[data-v-e1cd547d]{opacity:.45}.batches tr:hover .del[data-v-e1cd547d]{opacity:1}@media(max-width:1100px){.lab-grid[data-v-e1cd547d]{grid-template-columns:1fr}}