contrails 0.4.0__tar.gz

contrails-0.4.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto

contrails-0.4.0/.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+updates:
+  # A runtime dependency bump changes what users install, so it has to reach the
+  # changelog and cut a release: `fix` is shown by release-please, `chore` is
+  # hidden by default and would ship the change invisibly. Dev dependencies
+  # affect nobody downstream, so they stay `chore`.
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: fix
+      prefix-development: chore
+      include: scope
+
+  # CI only — nothing here reaches an installed contrail, so it stays hidden.
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: chore
+      include: scope

contrails-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: ruff
+    # Ten minutes against a job that takes ten seconds. The point is a `pip`
+    # fetch that stalls rather than fails, which would otherwise sit until
+    # GitHub's six-hour default.
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+
+  test:
+    # Interpolated, not a fixed string: a matrix job with a static `name:`
+    # produces three checks called the same thing, and the version under test
+    # is the only thing that tells them apart.
+    name: pytest ${{ matrix.python-version }}
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest -q
+      - name: Dry-run against the fixture sources
+        # Catches a broken parser here, before it can reach anyone's production
+        # instance through a version tag. Both importers, since they also have to
+        # agree with each other about which flights are the same one. Needs no
+        # secrets: --dry-run never calls the emissions API, and both importers
+        # accept a local path.
+        env:
+          TRIPIT_ICAL_URL: tests/fixtures/sample_feed.ics
+          FLIGHTY_CSV_PATH: tests/fixtures/sample_flighty.csv
+        run: contrail sync --dry-run --csv-path "${RUNNER_TEMP}/should-not-be-written.csv"
+
+  docs:
+    name: markdown
+    # `npx` fetches Prettier from the registry on every run, and a stalled
+    # fetch hangs rather than failing. The same line in atdr/contrail-gh has
+    # sat silent for exactly 301 seconds, npm's fetch-timeout expiring and the
+    # retry succeeding, in a job that takes twelve seconds when the fetch is
+    # clean. Ten minutes bounds a stall that never recovers.
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      # An action rather than `npx`, so the github-actions dependabot ecosystem
+      # already configured for this repo keeps it current. Prettier has no
+      # first-party action, so its pin below is a hand edit — the same deal as
+      # the `rev:` pins in .pre-commit-config.yaml.
+      - uses: DavidAnson/markdownlint-cli2-action@v24
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+      # Prettier owns table alignment and whitespace; markdownlint owns the
+      # rules it can't express. Neither is redundant.
+      - run: npx prettier@3.9.6 --check "**/*.md"

contrails-0.4.0/.github/workflows/pr-title.yml

@@ -0,0 +1,21 @@
+name: pr-title
+
+on:
+  pull_request_target:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  lint:
+    name: conventional title
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    steps:
+      # On a squash merge the PR title becomes the commit subject, which is what
+      # release-please reads. An unconventional title silently drops the change
+      # from the changelog, so validate it up front.
+      - uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

contrails-0.4.0/.github/workflows/release-please.yml

@@ -0,0 +1,56 @@
+name: release-please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    name: maintain the release PR
+    # This one holds every release behind it, so a hang here is a release that
+    # silently never happens. Ten minutes against a job that takes seconds.
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      # Maintains a rolling release PR from the conventional commits on main.
+      # Merging it bumps the version in pyproject.toml, updates CHANGELOG.md,
+      # tags the release, and publishes it.
+      #
+      # Note: PRs opened by the default GITHUB_TOKEN do not trigger other
+      # workflows, so the release PR itself shows no CI run. The commits it
+      # releases were already tested on main.
+      - uses: googleapis/release-please-action@v5
+        id: release
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  publish:
+    name: publish to PyPI
+    needs: release-please
+    if: needs.release-please.outputs.release_created
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # No API token: PyPI trusts this workflow (owner/repo/environment) to
+      # mint its own short-lived credential via OIDC.
+      id-token: write
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: |
+          pip install build
+          python -m build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

contrails-0.4.0/.gitignore

@@ -0,0 +1,34 @@
+# Local configuration and personal data — never commit these.
+# `contrail sync` writes ./flight_emissions.csv by default, and this repo is public.
+config.json
+config.yaml
+config.yml
+# Glob, not just the default filename: backups and per-account variants
+# (flight_emissions.backup-*.csv, flight_emissions-work.csv) are real flight
+# data too, and this repo is public.
+flight_emissions*.csv
+*.backup-*.csv
+# The raw provider log holds real itineraries too.
+*.raw.jsonl
+last_checked.txt
+.env
+.env.*
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+venv/
+.venv/
+
+# Editors / OS
+.DS_Store
+.idea/
+.vscode/
+
+# Planning notes stay local — this repo is public.
+_planning/

contrails-0.4.0/.markdownlint-cli2.yaml

@@ -0,0 +1,39 @@
+# Prettier owns whitespace and table alignment. These are the rules it cannot
+# express. Kept in step by hand across contrail, contrail-gh and any instance
+# created from it — the three files are copies, not a shared package.
+#
+# .prettierrc.json carries two settings and no room to explain them:
+# `proseWrap: preserve`, because the prose here is wrapped by hand at
+# deliberate points and `always` would rewrap every paragraph in the repo; and
+# `embeddedLanguageFormatting: off`, because the code inside a fence is a
+# worked example or a command someone will paste, not source to be tidied.
+gitignore: true
+
+# Without this, a bare `markdownlint-cli2` finds nothing and reports success.
+globs:
+  - "**/*.md"
+
+config:
+  MD013:
+    # AGENTS.md and docs/ already hold 80. README.md opts up to 100 with a
+    # markdownlint-configure-file comment at the foot of the file.
+    line_length: 80
+    # A padded table row is wider than any prose limit, and a fenced block is
+    # usually a command that must not be broken.
+    tables: false
+    code_blocks: false
+  MD046:
+    # GitHub only syntax-highlights fenced blocks, so an indented one silently
+    # loses the highlighting the author meant to have.
+    style: fenced
+
+ignores:
+  # release-please regenerates this from commit subjects. Anything done to it
+  # here is clobbered on the next release.
+  - CHANGELOG.md
+  # A symlink to AGENTS.md. Linting it reports every line of that file twice.
+  - CLAUDE.md
+  # Local agent scratch, kept out of this public repo via .git/info/exclude —
+  # which `gitignore: true` above does not read, so it needs naming here. CI
+  # never sees the file; a full-tree run on a dev machine does.
+  - .claude/**

contrails-0.4.0/.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+# Optional local convenience: `pre-commit install`. CI is the real gate.
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.3
+    hooks:
+      # `ruff-check`, not `ruff`: the latter is a deprecated alias kept for
+      # compatibility, running the identical `ruff check`. It will be removed
+      # eventually, and the failure would land on an unrelated `rev` bump.
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+
+  # Markdown. Keep these two in step with the pins in .github/workflows/ci.yml —
+  # a hook that lints to a different version than CI is worse than no hook.
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.23.2
+    hooks:
+      - id: markdownlint-cli2
+        # The `globs` in .markdownlint-cli2.yaml already cover every file, and
+        # markdownlint-cli2 adds any filenames it is given to them rather than
+        # replacing them — so passing the staged files just reports each of
+        # them twice.
+        pass_filenames: false
+
+  # The maintained fork; pre-commit/mirrors-prettier is archived.
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.9.6
+    hooks:
+      - id: prettier
+        types_or: [markdown]

contrails-0.4.0/.prettierignore

@@ -0,0 +1,7 @@
+# Regenerated by release-please; see .markdownlint-cli2.yaml for why.
+CHANGELOG.md
+# Symlink to AGENTS.md — formatting it writes through to the same file twice.
+CLAUDE.md
+# Local agent scratch, excluded via .git/info/exclude, which Prettier does not
+# read. See .markdownlint-cli2.yaml.
+.claude/

contrails-0.4.0/.prettierrc.json

@@ -0,0 +1,4 @@
+{
+  "proseWrap": "preserve",
+  "embeddedLanguageFormatting": "off"
+}

contrails-0.4.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.0"
+}

contrails-0.4.0/AGENTS.md

@@ -0,0 +1,161 @@
+# contrail
+
+Estimates the CO2e of flights taken or booked and keeps a log. Reads a TripIt
+iCal feed and Flighty CSV exports, prices each flight with Google's Travel Impact
+Model, writes a CSV.
+
+## Commands
+
+```bash
+python3.12 -m venv venv && ./venv/bin/pip install -e ".[dev]"
+./venv/bin/pytest -q
+./venv/bin/ruff check . && ./venv/bin/ruff format .
+TRIPIT_ICAL_URL=tests/fixtures/sample_feed.ics \
+  FLIGHTY_CSV_PATH=tests/fixtures/sample_flighty.csv ./venv/bin/contrail sync --dry-run
+./venv/bin/python scripts/refresh_airline_codes.py   # needs network; run by hand
+```
+
+Python 3.11+. The default `python3` on this machine is
+3.7 — use `/usr/local/bin/python3.12` explicitly.
+
+## Architecture
+
+Three protocol seams:
+
+| Seam         | Protocol                                                                | Implementations              |
+| ------------ | ----------------------------------------------------------------------- | ---------------------------- |
+| `importers/` | `Importer.fetch(config) -> Iterable[FlightRecord \| UnparsedEvent]`     | `tripit_ical`, `flighty_csv` |
+| `emissions/` | `EmissionsProvider.compute(flights, now) -> dict[key, EmissionsResult]` | `tim`                        |
+| `storage/`   | `Storage.load() -> list[dict]`, `save(rows)`                            | `local_csv`                  |
+
+`cli.py` owns the flow: load config → load storage → collect from every source →
+collapse records that are the same flight → reconcile against what's stored →
+price → build rows → normalize → save.
+
+Two keys, and the difference matters:
+
+- **`f"{source}:{source_id}"`** identifies a _record_. It is the dedup key and
+  what `also_seen_as` stores.
+- **`(flight_date, origin, destination)`** identifies a _flight_, across sources.
+  `resync.identity()`. Never the flight number — see the gotchas.
+
+## Conventions
+
+- Conventional commits. release-please owns versions, tags and `CHANGELOG.md` —
+  never hand-edit the changelog or the version in `pyproject.toml`.
+- `__version__` is read from installed package metadata, so `pyproject.toml` is
+  the single source of truth. Code that needs the version imports `__version__`
+  rather than spelling it out — see the gotcha on version pins for the two
+  literals that remain.
+- **No test may make a real network call.** Mock `requests` in both directions.
+- **Every workflow is named after its own file**, and the description goes on
+  the job. GitHub labels a check `<workflow name> / <job name>` and never shows
+  the filename, so `pr-title / conventional title` names both the file to open
+  and what it did. A matrix job's `name:` has to interpolate the matrix value
+  (`pytest ${{ matrix.python-version }}`) or all three legs produce checks
+  called the same thing. `atdr/contrail-gh` enforces this in CI; here it is
+  convention. The `Analyze (python)` and `Analyze (actions)` checks are the
+  exception and always will be: CodeQL runs from default setup, which is a repo
+  setting rather than a file, so its name and its timeout are GitHub's to
+  choose.
+- **Every job that can carry `timeout-minutes` sets one.** GitHub's default is
+  six hours, and the failure that matters is a stall rather than an error: a
+  `pip` or `npx` fetch that hangs never fails on its own. Ten minutes
+  everywhere except `pr-title.yml`, which gets five. A job whose only key is
+  `uses:` cannot carry it, which is why the setting lives inside a reusable
+  workflow rather than on its callers.
+- **Markdown is formatted, not hand-aligned.** Prettier owns table padding and
+  whitespace; markdownlint-cli2 owns line length and the rest. Run
+  `npx prettier@3.9.6 --write "**/*.md"` rather than lining a table up by
+  hand. Prose wraps at 80, except `README.md`, which wraps at 100 and says so
+  in a `markdownlint-configure-file` comment at its foot.
+- This repo is public. Never commit a real CSV, a raw log, or `config.json` —
+  all are gitignored.
+- **When updating docs at the end of a change, skim the open issues**
+  (`gh issue list`) for any the change touched. Cheap, and it catches both
+  directions: an issue quietly fixed, and one made easier to hit.
+
+  **Findings about your own change belong in the same PR** — that is not two
+  things in one PR, it is one change described accurately. A doc line your change
+  just made wrong, or an issue whose shape it altered, is part of that change; a
+  reviewer needs it in front of them, and splitting it out means `main` is briefly
+  wrong on purpose. Only a finding that stands entirely apart from what you built
+  earns its own PR; note it on the issue either way.
+
+  The one exception is the release PR: `chore(main): release X.Y.Z` is generated
+  by release-please from commit subjects, so anything hand-added there is
+  clobbered on the next regeneration.
+
+## Depth
+
+- [docs/parsing.md](docs/parsing.md) — the ported regexes, local dates,
+  codeshares, why `parse()` is two-pass, reading a Flighty export
+- [docs/emissions.md](docs/emissions.md) — exact vs route average, the past-date
+  400, what gets kept, and the open question about timing
+- [docs/resync.md](docs/resync.md) — what a sync may change, the freeze boundary,
+  cancellation, matching one flight across two sources
+- [docs/storage.md](docs/storage.md) — CSV invariants and why there's no total
+- [docs/tripit-api.md](docs/tripit-api.md) — investigated, not used, and why
+- [docs/contrail-gh.md](docs/contrail-gh.md) — **what a change here obliges in the
+  template repo**
+
+## Gotchas most likely to bite
+
+- **The regexes in `importers/tripit_ical.py` are validated against real TripIt
+  feeds.** They look untidy because real feeds are. Don't rewrite one without a
+  failing test that proves the current form is wrong.
+- **Mutation is confined to flights that haven't departed.** Past rows are never
+  touched — that's what makes "absent from the feed" unambiguous. One exception:
+  `resync.backfill()` fills a _blank_ cabin, aircraft or reason on a row of any
+  age, because a Flighty export is almost entirely past flights and it re-prices
+  nothing.
+- **A flight is identified by route and date, never by flight number.** `BA16` is
+  SYD-SIN-LHR on one day: two legs, two cabins, two rows. Any "dedup by flight
+  number" idea silently merges them and loses a figure.
+- **The file is written only when content actually changed**, or contrail-gh
+  commits every day for nothing.
+- **Every value in a row dict is a string**, so a fresh row compares equal to one
+  loaded from the CSV. Every row builder must set every column.
+- **TIM cannot be asked twice.** It won't price a departed flight, so anything not
+  captured while it was upcoming is gone permanently.
+- **A runtime dependency bump must be `fix(deps):`, not `chore(deps):`.**
+  release-please hides `chore` by default and counts only `feat` and breaking
+  changes toward a bump, so a `chore(deps)` bump of a runtime dependency changes
+  what users install with nothing in the changelog and no release. Dev
+  dependencies stay `chore(deps-dev):`.
+- **The two install pins in `README.md` are rewritten by release-please**, not by
+  hand. They sit inside `<!-- x-release-please-start-version -->` /
+  `<!-- x-release-please-end -->` comments, and `README.md` is listed under
+  `extra-files` in `release-please-config.json` — both halves are needed. Delete
+  a comment and the pin quietly rots to whatever release it was written against,
+  which is exactly how it drifted before. A _new_ literal version anywhere else
+  is a bug: import `__version__`.
+- **release-please needs the repo setting "Allow GitHub Actions to create and
+  approve pull requests"** (Settings → Actions → General). `permissions:
+pull-requests: write` in the workflow is _not_ sufficient on its own, and the
+  API can report the flag as enabled while it is still blocked. Without it the
+  release job fails with "GitHub Actions is not permitted to create or approve
+  pull requests".
+- **`CHANGELOG.md` and `CLAUDE.md` are excluded from both Markdown tools.**
+  release-please regenerates the changelog from commit subjects, so a
+  reformat there is undone on the next release and can desync the manifest;
+  `CLAUDE.md` is a symlink to `AGENTS.md`, so linting it reports every line
+  twice and formatting it writes the same file twice. Both are named in
+  `.markdownlint-cli2.yaml` and `.prettierignore`.
+- **`cli._now()` exists to be monkeypatched.** Tests that use the real clock rot
+  once the fixture's dates fall into the past.
+- **`src/contrail/data/airline_codes.csv` is generated, never hand-edited.** Fix
+  it upstream in Wikidata and re-run the script, or the next refresh reverts you.
+  It must be written with LF: `.gitattributes` normalizes, and the csv module
+  defaults to CRLF.
+- **`tests/fixtures/sample_flighty.csv` is synthetic.** This repo is public and
+  a real export is someone's entire travel history.
+
+## Related repos
+
+- `atdr/contrail-gh` — public GitHub Actions template. Pins a contrail release
+  tag and ships a header-only CSV that has to match it. **A schema or output
+  change here needs a matching change there** — see
+  [docs/contrail-gh.md](docs/contrail-gh.md).
+- A **private instance** created from that template (`octocat/my-contrail` in the
+  docs). Real data and secrets — never referenced by name in anything public.

contrails-0.4.0/CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+## [0.4.0](https://github.com/atdr/contrail/compare/v0.3.1...v0.4.0) (2026-09-05)
+
+
+### Features
+
+* **release:** publish to PyPI as `contrails` ([#34](https://github.com/atdr/contrail/issues/34)) ([b34d65f](https://github.com/atdr/contrail/commit/b34d65ff050dee790bb416d272cc3dad0eb7be9f))
+
+## [0.3.1](https://github.com/atdr/contrail/compare/v0.3.0...v0.3.1) (2026-09-05)
+
+
+### Bug Fixes
+
+* **deps:** Update airportsdata requirement from >=20260803 to >=20260902 ([#31](https://github.com/atdr/contrail/issues/31)) ([24f6c2e](https://github.com/atdr/contrail/commit/24f6c2eac97357a3ae01a4887210f8032b4406d8))
+* **deps:** Update icalendar requirement from >=7.2.2 to >=7.3.0 ([#29](https://github.com/atdr/contrail/issues/29)) ([640788f](https://github.com/atdr/contrail/commit/640788fd2720046957835ea4036d7ae94e8716fb))
+
+
+### Documentation
+
+* a file-reading importer now needs its env var in two workflows ([#20](https://github.com/atdr/contrail/issues/20)) ([353b0c4](https://github.com/atdr/contrail/commit/353b0c4774e0e3cca444623bb437813eff13ad79))
+
+## [0.3.0](https://github.com/atdr/contrail/compare/v0.2.0...v0.3.0) (2026-08-16)
+
+
+### Features
+
+* add a flighty_csv importer and match flights across sources ([ba0d292](https://github.com/atdr/contrail/commit/ba0d2921f04f6e3b92ec4f6c18c7024206cf9c54))
+
+
+### Bug Fixes
+
+* stop version references drifting from the release ([429507c](https://github.com/atdr/contrail/commit/429507c8d3d121c20c62e67b883cdaeb44776ffb))
+
+
+### Documentation
+
+* note the new way to reach the per-source identity gap ([941db88](https://github.com/atdr/contrail/commit/941db88d90a1b203aed0e5e7ce1905df389d4ef0))
+
+## [0.2.0](https://github.com/atdr/contrail/compare/v0.1.0...v0.2.0) (2026-08-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* Python 3.10 is no longer supported. requires-python is now >=3.11.
+
+### Features
+
+* require Python 3.11 ([18cdc6e](https://github.com/atdr/contrail/commit/18cdc6ea6251f10870303a9d17fe20e7f7a26d64))
+
+
+### Bug Fixes
+
+* **deps:** declare the pyyaml floor once and bound ruff ([8790755](https://github.com/atdr/contrail/commit/8790755521ace3cdbaf39e4a4e658762e6a28a0a))
+* **deps:** Update icalendar requirement from >=5.0 to >=7.2.2 ([ee39316](https://github.com/atdr/contrail/commit/ee393167748db7b2cabd5d3667eb50b0837ab6e5))
+* **deps:** Update pyyaml requirement from >=6 to >=6.0.3 ([2ed4484](https://github.com/atdr/contrail/commit/2ed4484142c9ef200c743634d54e286a43ca12b9))
+* release runtime dependency bumps instead of hiding them ([68ff550](https://github.com/atdr/contrail/commit/68ff550a4d14db328fe017c235d5e59539767445))
+
+
+### Documentation
+
+* note the Actions setting release-please needs ([5e1778b](https://github.com/atdr/contrail/commit/5e1778b7c0ffde2475b83b00482d21ac8e843446))
+
+## 0.1.0 (2026-08-15)
+
+
+### Features
+
+* add config resolution and CLI ([ca9f865](https://github.com/atdr/contrail/commit/ca9f86567ec0a223ea8823d75799f5fa79aaadc2))
+* add core data model ([5c7b0b6](https://github.com/atdr/contrail/commit/5c7b0b639853c1f18d8a0f080a638baccd02d6d4))
+* add CSV storage keyed on cumulative_kg_actual ([c633763](https://github.com/atdr/contrail/commit/c63376384d358b8024dd2eb7d6a842dab2695d54))
+* add importer seam and tripit_ical importer ([e52aafd](https://github.com/atdr/contrail/commit/e52aafd810b73730ac003ea2224a39f9069bcddf))
+* add TIM emissions provider with route-average fallback ([9badcc4](https://github.com/atdr/contrail/commit/9badcc4c990d618d6363dbc7b01cea2df9672605))
+* drop the stored cumulative total from the CSV ([0ce92b6](https://github.com/atdr/contrail/commit/0ce92b6bd8f62dc5837c33dd68df0618f69ab4e3))
+* price codeshares as the operating flight ([f456f73](https://github.com/atdr/contrail/commit/f456f73e912d4ae1e1bbac1e3eaaf5bfc5d1d23d))
+* re-sync flights that have not yet departed ([372606f](https://github.com/atdr/contrail/commit/372606f365d19fc3ad2f99cd047c5de617000fb7))
+* resolve departure dates in the origin airport's timezone ([b9032c9](https://github.com/atdr/contrail/commit/b9032c9c0a3572154cb2ddc20427b6d07c01ff40))
+* ship example config files ([17214b8](https://github.com/atdr/contrail/commit/17214b8019f2f47e6e7356951bae029ea62dbf18))
+* store departure times and keep everything TIM returns ([4f8840a](https://github.com/atdr/contrail/commit/4f8840a596dd5f3b65240edda8fa224add24bf89))
+
+
+### Bug Fixes
+
+* **emissions:** keep the TIM key out of URLs and error messages ([6e90e96](https://github.com/atdr/contrail/commit/6e90e968dee6a7b335ca2da6dea7ff655326025a))
+* gitignore flight data backups and variants ([7b61808](https://github.com/atdr/contrail/commit/7b618087d6ecb473b3d998dfec7ebacc5f363ad5))
+* harden re-sync against silent source failures and data loss ([25073ec](https://github.com/atdr/contrail/commit/25073ec4fad7473bed5e58ebb66596fcb67e4f30))
+* **importers:** give UID-less events distinct dedup keys ([4b01c8c](https://github.com/atdr/contrail/commit/4b01c8c8bde1c1cf0353a60edb4586d9e92a5980))
+* stop an upgrade downgrading every open exact figure ([2e618eb](https://github.com/atdr/contrail/commit/2e618eb8cd9094a0f48e8bf318aed2c512d75bc5))
+* **storage:** count hand-edited rows and write the CSV atomically ([625c8a9](https://github.com/atdr/contrail/commit/625c8a9eefc8cab9bd2edd6225351a7e87e40f95))
+
+
+### Documentation
+
+* add README ([f43641d](https://github.com/atdr/contrail/commit/f43641d7f8bdd766dd8398c6e1c148d40df7c8a8))
+* add working notes, status and build plan ([84c42bb](https://github.com/atdr/contrail/commit/84c42bb3f2608c00def9c9b293c0b66493a6fd9d))
+* document the repair workflow and departure-date caveat ([211e7a3](https://github.com/atdr/contrail/commit/211e7a3e263022fffd1c05a01f2582260b6dcb89))
+* record findings from the first real-feed run ([28bebe0](https://github.com/atdr/contrail/commit/28bebe08435d66c21fcc853238a056d31ee921af))
+* record the changed-itinerary and UTC-date open questions ([d01b09a](https://github.com/atdr/contrail/commit/d01b09ae59d939ab0fd270834a50a6c292d37752))
+* record what a change here obliges in contrail-gh ([44eb9e1](https://github.com/atdr/contrail/commit/44eb9e14b09c329c1fbd270814af063c41e023ef))
+* split working notes into AGENTS.md and docs/ ([cdb85f2](https://github.com/atdr/contrail/commit/cdb85f2d49569c503fe14095952111317a6da050))
+* state what is verified, drop the archaeology ([e2b4d49](https://github.com/atdr/contrail/commit/e2b4d496b047773acb646552b570e688dbd46573))
+* use a generic owner for instance repos ([cbfbffd](https://github.com/atdr/contrail/commit/cbfbffde322b37a6a89932c4c258af8e9db414f8))

contrails-0.4.0/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

contrails-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andreas Richardson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.