Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
30 changes: 28 additions & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
name: Release

# Publishes to PyPI via Trusted Publishing (OIDC). No API token is stored
# anywhere in this repository or its secrets.
# Publishes to PyPI via Trusted Publishing (OIDC), then creates the GitHub Release
# for the tag with the CHANGELOG section as its notes and the wheel and sdist
# attached. No API token is stored anywhere in this repository or its secrets.
on:
push:
tags: ["v*"]
Expand All @@ -15,6 +16,11 @@ jobs:
- uses: astral-sh/setup-uv@v5
with:
enable-cache: true
# A tag whose version has no CHANGELOG section stops here, before PyPI: a
# release is not re-publishable, its notes must exist first.
- name: The CHANGELOG has this version's section
if: startsWith(github.ref, 'refs/tags/v')
run: python3 scripts/release_notes.py "${GITHUB_REF_NAME#v}" > /dev/null
- run: uv build
- uses: actions/upload-artifact@v4
with:
Expand All @@ -33,3 +39,23 @@ jobs:
name: dist
path: dist/
- uses: pypa/gh-action-pypi-publish@release/v1

github-release:
needs: publish
if: startsWith(github.ref, 'refs/tags/v')
runs-on: ubuntu-latest
permissions:
contents: write # to create the release
steps:
- uses: actions/checkout@v4
- uses: actions/download-artifact@v4
with:
name: dist
path: dist/
- name: Release notes from CHANGELOG.md
run: python3 scripts/release_notes.py "${GITHUB_REF_NAME#v}" > notes.md
# Idempotent: a re-run of the workflow for a tag that is already released
# (a retried publish, a manual dispatch) leaves the existing release alone.
- run: gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1 || gh release create "$GITHUB_REF_NAME" --verify-tag --title "$GITHUB_REF_NAME" --notes-file notes.md dist/*
env:
GH_TOKEN: ${{ github.token }}
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,28 @@ All notable changes to this project are documented here. The format follows

## [Unreleased]

### Added
- **GitHub Releases.** The release workflow now creates the GitHub Release for each
tag, with the version's CHANGELOG section as its notes (`scripts/release_notes.py`)
and the wheel and sdist attached; the eight earlier tags were released the same way
by hand on 2026-09-17.

### Changed
- **Permission hints.** The TUI's consent question names the `/allow` answers instead
of the terminal's keys; a run that skipped sources because the browser was not
permitted says which setting turns it on (`/config set …` in the TUI,
`proofpath config set …` elsewhere), and a run the network setting stopped says so
in its once-per-run `network: not permitted` note; a page given where a post was
expected says to paste the claim as text; `/allow` with nothing waiting says where
the question appears.
- README screenshots are real runs with the raven (`docs/eval/tui-raven-{rich,plain}.svg`,
method in `docs/eval/2026-09-17-tui-raven.md`).

### Fixed
- **`loading models …` no longer outlives the loading in the TUI.** The note is
transient and is taken back when the `Verifying` stage ends; a finished run no longer
looks like it is still loading.

## [0.4.2] - 2026-09-17

A raven in the terminal, and a website to go with it.
Expand Down
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@ The bird is a raven — the same one as on the website — drawn in Braille cell
`rich` theme and in ASCII in `plain`.

Bare `proofpath` opens the terminal UI ([a recorded session in both themes](docs/eval/2026-09-15-tui-v2-live.md),
with [SVG screenshots](docs/eval/tui-v2-rich.svg)). Each run is one panel in its own
with SVG screenshots of a real run in [`rich`](docs/eval/tui-raven-rich.svg) and
[`plain`](docs/eval/tui-raven-plain.svg)). Each run is one panel in its own
accent: the command on the top border and the run's state at its right, a fixed-column
stage table underneath (`✓` finished, `⏺` still running or finished with something
unverified, a real progress bar on the active stage, the provider that produced each
Expand All @@ -50,7 +51,8 @@ stopped with `/cancel #n` — a stopped run keeps what it had decided. Click (or
`enter` on) a finding to read the whole quoted passage; `⧉` copies it; a finding's
reference is a link to its source. When a publisher blocks the plain fetch, the
permission question is asked **inline, under the stage that hit the wall**, with
`[allow once] [always] [no] [never]`.
`[allow once] [always] [no] [never]` — or, from the bar, `/allow once`, `/allow always`,
`/allow no`, `/allow never`.

**Windows / `NO_COLOR`.** The look above is the `rich` theme, chosen when the terminal
gives evidence of truecolor (`COLORTERM`, Windows Terminal, iTerm2, kitty, WezTerm,
Expand Down Expand Up @@ -110,7 +112,8 @@ unverified 14%
When a quarter or more of the sources could not be read, a further line says so:
`coverage is weak: unread sources may hold more, so this is a lower bound`. When the
browser step was not permitted, a line counts the sources it cost:
`skipped N source(s) because the browser was not permitted`.
`skipped N source(s) because the browser was not permitted — proofpath config set
permissions.install_browser ask`.

**No verdict without its passage.** `SUPPORTED` and `REFUTED` cannot exist without
the quoted sentence they rest on — the cache schema itself refuses to store one.
Expand Down Expand Up @@ -240,6 +243,9 @@ proofpath check --url https://news.ycombinator.com/item?id=8863
proofpath check - # paste the text of a post that cannot be read
```

A page is not a post: paste the claim as text with the address inside it, and the page
is fetched as that claim's source.

Every sentence of the post is checked against the pages its links point to, and the post's
own words are never allowed to stand as their own evidence.

Expand Down
19 changes: 19 additions & 0 deletions docs/eval/2026-09-17-tui-raven.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# TUI screenshots with the raven — 2026-09-17

`tui-raven-rich.svg` and `tui-raven-plain.svg` replace the ferret-era pair the README
linked (`tui-v2-rich.svg`, `tui-v2-plain.svg`, which stay as part of the
[2026-09-15 recording](2026-09-15-tui-v2-live.md)). Same method as that pair:
`ProofpathApp(load_config(), ui.build(force_terminal=True), theme=…)` under
`app.run_test(size=(100, 54))` with the **real `Scheduler`**, `/check
tests/data/draft-live.md`, polled until the run was `done`, then
`app.save_screenshot()`.

- version `0.4.2`, macOS, CoreML; cache warm for the sources, so the network stages
are attributed to `cache` and the footer says `0 API calls`
- OpenAlex answered 429 during the ghost check (`retry after 65567s`); the finding
says so, as it should — the ghost call stood on arXiv and Open Library
- the run: 7 refs, 1 ghost, 2 unsupported, 4 ok; coverage 72/14/14 %

The Braille raven's dots render with whatever glyphs the viewer's fallback font has;
a terminal with a monospace font that carries Braille (Menlo, JetBrains Mono,
Cascadia, Fira Code) draws them evenly.
Loading
Loading