Skip to content

docs(changelog): reconcile [0.1.0] with what actually shipped #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
trouze merged 1 commit into from
Apr 24, 2026
Merged

docs(changelog): reconcile [0.1.0] with what actually shipped #5

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 6 additions & 14 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,6 @@ All notable changes to this project will be documented in this file. The format

## [Unreleased]

### Added

- `dbt-dag-opt replay` subcommand: reconstructs the observed schedule from `run_results.json`'s `thread_id` + per-phase `timing` data, joined against `manifest.json`'s `parent_map`. Reports per-thread utilization, observed critical path (walked backwards from the last-completing node), and top idle gaps with parent-node attribution.
- Output formats for `replay`: `text` (rich terminal summary, default) and `json` (full replay report, including raw events).
- Integration fixture at `tests/fixtures/dbt_dugout/` — a real Snowflake dbt run (57 nodes, 4 threads) used to smoke-test `replay` end-to-end.
- `analyze --show-path`: render the full chain of node ids for each longest path in the table output.
- `analyze` table now includes a **Bottleneck** column naming the slowest model on each path. A bottleneck that appears across multiple rows is a shared-node optimization target.

## [0.1.0] - 2026-04-24

Initial PyPI release. Complete rewrite of the pre-release prototype.
Expand All @@ -21,10 +13,14 @@ Initial PyPI release. Complete rewrite of the pre-release prototype.
- `dbt-dag-opt analyze` CLI (Typer) with two input modes:
- File mode: `--manifest` and `--run-results` point at local dbt artifacts.
- Cloud mode: `--account-id`, `--job-id`, optional `--run-id`, and `DBT_CLOUD_TOKEN` env var (or `--token`) pull artifacts from the dbt Cloud Admin API.
- Output formats: `table` (rich terminal), `json` (valid, `jq`-friendly), `jsonl`.
- `--top N` to limit results; `--output` to write to a file.
- `analyze --show-path` to render the full chain of node ids for each longest path in the table output.
- `analyze` table includes a **Bottleneck** column naming the slowest model on each path. A bottleneck that appears across multiple rows is a shared-node optimization target.
- `dbt-dag-opt replay` subcommand: reconstructs the observed schedule from `run_results.json`'s `thread_id` + per-phase `timing` data, joined against `manifest.json`'s `parent_map`. Reports per-thread utilization, observed critical path (walked backwards from the last-completing node), and top idle gaps with parent-node attribution.
- Output formats: `analyze` → `table` (rich terminal, default), `json` (valid, `jq`-friendly), `jsonl`. `replay` → `text` (rich terminal summary, default), `json` (full replay report including raw events).
- `--top N` to limit `analyze` results; `--top-idle-gaps N` for `replay`; `--output` to write any command to a file.
- Typed exceptions (`ArtifactLoadError`, `DbtCloudAPIError`, `InvalidArtifactError`, `GraphError`).
- Package ships with `py.typed` (PEP 561).
- Integration fixture at `tests/fixtures/dbt_dugout/` — a real Snowflake dbt run (57 nodes, 4 threads) used to smoke-test `replay` end-to-end.
- CI matrix across Python 3.10 / 3.11 / 3.12.
- PyPI publishing via Trusted Publishers (OIDC) on tag push.

Expand All @@ -34,7 +30,3 @@ Initial PyPI release. Complete rewrite of the pre-release prototype.
- Node weights are now attached to the *target* node of each path hop (fixes a bug where parent weights were assigned to outgoing edges).
- Adjacency list replaces full-edge-list rescan on every DFS step.
- Output is valid JSON by default (prototype's `longest_paths.json` was a stream of comma-separated fragments opened in append mode — not parseable).

### Notes for PyPI Trusted Publishing

Before the first `v*` tag is pushed, configure PyPI: Project settings → Publishing → Add GitHub publisher with `trouze/dbt-dag-opt` / workflow `publish.yml` / environment `pypi`.
Loading