agent-postmortem 0.3.4__tar.gz → 0.3.5__tar.gz

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.5]
+
+### Changed
+
+- The PyPI summary is the positioning line the plugin already uses: it reads the Claude Code
+  logs already on your machine and tells you which agent's "done" you can't trust. The package
+  is classified as Alpha, matching the README's status line, and the README's license badge
+  links to the LICENSE file by full URL, so it also works on the PyPI page. PyPI version and
+  Python version badges join the CI and license badges.
+- Installs come from PyPI now. The README's first command is `uvx agent-postmortem scan`, and
+  Quick start, the plugin README and the `/postmortem` skill say `uv tool install
+  agent-postmortem`. No git is needed.
+- The plugin installs its CLI from PyPI at the plugin's own version. It falls back to the
+  matching GitHub tag only if that install fails, for example in the minutes between a release
+  reaching GitHub and reaching PyPI. Both attempts share the one 60-second deadline the single
+  install had. The missing-CLI hint says `uv tool install agent-postmortem`.
+
 ## [0.3.4]
 
 ### Fixed

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/CONTRIBUTING.md

@@ -70,22 +70,20 @@ sets.
 
 Releases are cut by pushing a `v*` tag, which `.github/workflows/release.yml`
 picks up: it runs the tests, builds the wheel and sdist, runs the privacy
-check against them, and makes the GitHub release with the built files and
-that version's CHANGELOG section. Users install from that tag
-(`uv tool install git+https://github.com/zeyusuntt/agent-postmortem@v<version>`),
-and so does the plugin.
-
-Publishing to PyPI (via a trusted publisher, no API token stored in this
-repository) is switched off until the repository variable `PUBLISH_PYPI` is
-`true`; without it the publish job is skipped, not failed. To turn it on once
-the setup below is done: set the variable (Settings, Secrets and variables,
-Actions, Variables, `PUBLISH_PYPI` = `true`), then re-run the release workflow
-for the existing tag (Actions, Release, the tag's run, Re-run all jobs), and
-check that installing the `agent-postmortem` package from PyPI gives that
-version. After that,
-switch the install lines in README.md, plugin/README.md, the postmortem skill
-and plugin/hooks/run.sh back to PyPI in one release (tests/test_launch_docs.py
-and tests/test_plugin.py pin them).
+check against them, makes the GitHub release with the built files and
+that version's CHANGELOG section, and publishes both files to PyPI through a
+trusted publisher (no API token is stored in this repository). Users install
+from PyPI (`uv tool install agent-postmortem`), and so does the plugin, pinned
+to its own version, with the matching GitHub tag as a fallback for the minutes
+between the tag and the PyPI upload (tests/test_launch_docs.py and
+tests/test_plugin.py pin these install lines).
+
+The publish job runs only while the repository variable `PUBLISH_PYPI` is
+`true` (Settings, Secrets and variables, Actions, Variables); without it the
+job is skipped, not failed. If a release's publish was skipped, set the
+variable, re-run the release workflow for that tag (Actions, Release, the
+tag's run, Re-run all jobs), and check that installing `agent-postmortem`
+from PyPI gives that version.
 
 One-time trusted-publisher setup on pypi.org, before the first tagged
 release:

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.5
 Name: agent-postmortem
-Version: 0.3.4
-Summary: Post-mortem for multi-agent coding runs: prove what silently went wrong, then draft the rule that prevents it.
+Version: 0.3.5
+Summary: Reads the Claude Code logs already on your machine and tells you which agent's 'done' you can't trust, and what to run next.
 Project-URL: Homepage, https://github.com/zeyusuntt/agent-postmortem
 Project-URL: Issues, https://github.com/zeyusuntt/agent-postmortem/issues
 Project-URL: Changelog, https://github.com/zeyusuntt/agent-postmortem/blob/main/CHANGELOG.md
 License: MIT
 License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -30,15 +30,17 @@ agent-postmortem reads the transcripts Claude Code already wrote under `~/.claud
 On the maintainer's machine (scan 2026-10-27, 0.3.2), 13 of 166 workflow runs launched at least one agent's task a second time, and 10.2 hours went to retries and to attempts that ended without a result.
 
 ```
-uvx --from git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4 agent-postmortem scan
+uvx agent-postmortem scan
 ```
 
-That runs the tagged release straight from GitHub (it needs [uv](https://docs.astral.sh/uv/) and git). A PyPI release is coming. On a machine with no runs yet it says where it looked and suggests `agent-postmortem demo`.
+That runs the latest release from PyPI with [uv](https://docs.astral.sh/uv/), which fetches Python 3.11 or later if you don't have it; nothing else to install. On a machine with no runs yet it says where it looked and suggests `agent-postmortem demo`.
 
 The command-line tool is local and read-only: Python standard library only, no LLM, no network access, and it never changes your files, transcripts, commits, or branches. (The Claude Code plugin's one network action, installing that tool, is described under Privacy; Limits notes two rare git index modes in which git's own `status` still updates its bookkeeping.) What it covers, below, lists the run shapes it handles and the ones it does not yet. Status: alpha, used so far on the maintainer's own machines. Claude Code only.
 
 [![CI](https://github.com/zeyusuntt/agent-postmortem/actions/workflows/ci.yml/badge.svg)](https://github.com/zeyusuntt/agent-postmortem/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/agent-postmortem.svg)](https://pypi.org/project/agent-postmortem/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agent-postmortem.svg)](https://pypi.org/project/agent-postmortem/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/zeyusuntt/agent-postmortem/blob/main/LICENSE)
 
 ```
 RUN wf_00000000-d30  DEGRADED  ended 2026-01-06 19:55Z
@@ -96,10 +98,10 @@ If you run one of the partial or not-yet shapes, please open a ["my run shape is
 
 ## Quick start
 
-Install the command-line tool from the tagged GitHub release with [uv](https://docs.astral.sh/uv/) and git (uv fetches Python 3.11 or later if you don't have it), then try it:
+Install the command-line tool from PyPI with [uv](https://docs.astral.sh/uv/) (it fetches Python 3.11 or later if you don't have it), then try it:
 
 ```
-uv tool install git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4
+uv tool install agent-postmortem
 agent-postmortem demo
 agent-postmortem scan
 agent-postmortem run <run-id>
@@ -245,7 +247,7 @@ Paths inside free text (finding titles, diagnostics, error messages, and at `--l
 
 State lives in `$XDG_STATE_HOME/agent-postmortem/`, or `~/.local/state/agent-postmortem/` if that variable is unset: `state.json` (which findings a session already reported, and the rules the 0.1 `apply` command wrote, now read-only history), plus `secret` and `aliases.json` for the aliases. All three are mode 0600. The secret and the registry are never printed; `trend` shows the applied-rule history from `state.json` at the active level. If a command prints `stable aliases unavailable` on stderr, that output named everything `agent-1`, `agent-2`, and so on instead of by alias; nothing is repaired automatically, because a new secret would change every alias. Remove both `secret` and `aliases.json` to start over with new aliases.
 
-The plugin's one network action happens on `SessionStart` only: when it has not installed a CLI into its own data directory and no `agent-postmortem` on `PATH` passes its protocol check, it installs the CLI from the GitHub tag that matches the plugin's version (`v0.3.4`) into that data directory, retrying at most once every 24 hours on failure; opt out by setting `AGENT_POSTMORTEM_NO_AUTO_INSTALL=1`, or by installing the CLI yourself first.
+The plugin's one network action happens on `SessionStart` only: when it has not installed a CLI into its own data directory and no `agent-postmortem` on `PATH` passes its protocol check, it installs the CLI from PyPI at the plugin's own version, or from the matching GitHub tag if that install fails, into that data directory, retrying at most once every 24 hours on failure; opt out by setting `AGENT_POSTMORTEM_NO_AUTO_INSTALL=1`, or by installing the CLI yourself first.
 
 ## How it was built
 

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/README.md

@@ -7,15 +7,17 @@ agent-postmortem reads the transcripts Claude Code already wrote under `~/.claud
 On the maintainer's machine (scan 2026-10-27, 0.3.2), 13 of 166 workflow runs launched at least one agent's task a second time, and 10.2 hours went to retries and to attempts that ended without a result.
 
 ```
-uvx --from git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4 agent-postmortem scan
+uvx agent-postmortem scan
 ```
 
-That runs the tagged release straight from GitHub (it needs [uv](https://docs.astral.sh/uv/) and git). A PyPI release is coming. On a machine with no runs yet it says where it looked and suggests `agent-postmortem demo`.
+That runs the latest release from PyPI with [uv](https://docs.astral.sh/uv/), which fetches Python 3.11 or later if you don't have it; nothing else to install. On a machine with no runs yet it says where it looked and suggests `agent-postmortem demo`.
 
 The command-line tool is local and read-only: Python standard library only, no LLM, no network access, and it never changes your files, transcripts, commits, or branches. (The Claude Code plugin's one network action, installing that tool, is described under Privacy; Limits notes two rare git index modes in which git's own `status` still updates its bookkeeping.) What it covers, below, lists the run shapes it handles and the ones it does not yet. Status: alpha, used so far on the maintainer's own machines. Claude Code only.
 
 [![CI](https://github.com/zeyusuntt/agent-postmortem/actions/workflows/ci.yml/badge.svg)](https://github.com/zeyusuntt/agent-postmortem/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/agent-postmortem.svg)](https://pypi.org/project/agent-postmortem/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agent-postmortem.svg)](https://pypi.org/project/agent-postmortem/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/zeyusuntt/agent-postmortem/blob/main/LICENSE)
 
 ```
 RUN wf_00000000-d30  DEGRADED  ended 2026-01-06 19:55Z
@@ -73,10 +75,10 @@ If you run one of the partial or not-yet shapes, please open a ["my run shape is
 
 ## Quick start
 
-Install the command-line tool from the tagged GitHub release with [uv](https://docs.astral.sh/uv/) and git (uv fetches Python 3.11 or later if you don't have it), then try it:
+Install the command-line tool from PyPI with [uv](https://docs.astral.sh/uv/) (it fetches Python 3.11 or later if you don't have it), then try it:
 
 ```
-uv tool install git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4
+uv tool install agent-postmortem
 agent-postmortem demo
 agent-postmortem scan
 agent-postmortem run <run-id>
@@ -222,7 +224,7 @@ Paths inside free text (finding titles, diagnostics, error messages, and at `--l
 
 State lives in `$XDG_STATE_HOME/agent-postmortem/`, or `~/.local/state/agent-postmortem/` if that variable is unset: `state.json` (which findings a session already reported, and the rules the 0.1 `apply` command wrote, now read-only history), plus `secret` and `aliases.json` for the aliases. All three are mode 0600. The secret and the registry are never printed; `trend` shows the applied-rule history from `state.json` at the active level. If a command prints `stable aliases unavailable` on stderr, that output named everything `agent-1`, `agent-2`, and so on instead of by alias; nothing is repaired automatically, because a new secret would change every alias. Remove both `secret` and `aliases.json` to start over with new aliases.
 
-The plugin's one network action happens on `SessionStart` only: when it has not installed a CLI into its own data directory and no `agent-postmortem` on `PATH` passes its protocol check, it installs the CLI from the GitHub tag that matches the plugin's version (`v0.3.4`) into that data directory, retrying at most once every 24 hours on failure; opt out by setting `AGENT_POSTMORTEM_NO_AUTO_INSTALL=1`, or by installing the CLI yourself first.
+The plugin's one network action happens on `SessionStart` only: when it has not installed a CLI into its own data directory and no `agent-postmortem` on `PATH` passes its protocol check, it installs the CLI from PyPI at the plugin's own version, or from the matching GitHub tag if that install fails, into that data directory, retrying at most once every 24 hours on failure; opt out by setting `AGENT_POSTMORTEM_NO_AUTO_INSTALL=1`, or by installing the CLI yourself first.
 
 ## How it was built
 

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/docs/DESIGN.md

@@ -6377,9 +6377,12 @@ internal deadline as `check`.
 
 On SessionStart, if no compatible CLI resolves and `uv` is on PATH and
 `AGENT_POSTMORTEM_NO_AUTO_INSTALL` is unset, `run.sh` runs `uv tool install
+"agent-postmortem==<version in plugin.json>" --python 3.11+` from PyPI, and only if that
+install fails, `uv tool install
 "git+https://github.com/zeyusuntt/agent-postmortem@v<version in plugin.json>" --python
-3.11+` (Plan B, 2026-10-28: the public repository's tag instead of PyPI until PyPI
-publishing works; it needs git besides uv; the missing-CLI hint names the same source) (`UV_TOOL_DIR`
+3.11+` (0.3.5: PyPI first; the tag covers the minutes between a release reaching GitHub
+and reaching PyPI, and needs git besides uv; both attempts run inside the one 60 s
+deadline below; the missing-CLI hint names `uv tool install agent-postmortem`) (`UV_TOOL_DIR`
 and `UV_TOOL_BIN_DIR` both pointed at `$DATA_DIR`, 7.2's one data
 directory, so the installed shim lands at `$DATA_DIR/bin/agent-postmortem`,
 exactly where resolution step (1) looks) under the same process-group-kill
@@ -6704,7 +6707,7 @@ later events go positional).
 
 ### 8.1 Package
 
-`pyproject.toml`: name `agent-postmortem`, version `0.3.4`, console scripts
+`pyproject.toml`: name `agent-postmortem`, version `0.3.5`, console scripts
 `agent-postmortem` and `postmortem`, `requires-python >= 3.11`, no runtime
 dependencies, `[project.optional-dependencies].dev = ["pytest>=8",
 "ruff>=0.6"]`, classifiers, URLs (Homepage, Issues, Changelog). The wheel
@@ -6754,8 +6757,8 @@ check of the artifacts), then a `github-release` job (`permissions: contents: wr
 `gh release create <tag> dist/* --verify-tag` with that version's CHANGELOG section as
 notes) and a publish job with `environment: pypi`, `permissions: id-token: write`,
 `pypa/gh-action-pypi-publish@release/v1` that runs only when the repository variable
-`PUBLISH_PYPI` is `true` (Plan B, 2026-10-28: until the PyPI trusted publisher works, a
-tag must not turn the release red; a skipped job is not a failure). Both workflows declare a
+`PUBLISH_PYPI` is `true` (a tag must never turn the release red when publishing is
+switched off; a skipped job is not a failure; PyPI publishing is on from 0.3.4). Both workflows declare a
 top-level `permissions: contents: read` so every job is read-only by
 default regardless of the repository's own token-permission setting; the
 publish job's own `id-token: write` is layered on top of that at the job
@@ -6769,14 +6772,14 @@ pypi.org and the TestPyPI dry run.
 First screen, in order (from 0.3.3): name; the question the tool answers
 ("Which 'done' in your last Claude Code run can't you trust?"); one paragraph on
 what it reads, what it reports and that it is local and read-only; one dated number
-from a named version's scan; `uvx --from git+https://github.com/zeyusuntt/agent-postmortem@v<version>
-agent-postmortem scan` (the tagged GitHub release; one line says a PyPI release is coming); the status paragraph; badges (CI, license; PyPI version and Python versions only once a
+from a named version's scan; `uvx agent-postmortem scan` (from PyPI, 0.3.5; 0.3.3 and
+0.3.4 used the tagged GitHub release while PyPI was not yet working); the status paragraph; badges (CI, license; PyPI version and Python versions only once a
 PyPI release exists, since a badge for a missing release renders broken),
 the demo output as a fenced code block (not a screenshot: it must stay text,
 so it can be diffed against a live `agent-postmortem demo` run -- 8.2,
 tests/test_readme.py), the install command that works for the current
-distribution (a GitHub install with `uv tool install git+...` until the
-first PyPI release, then `uvx agent-postmortem scan`), a command table
+distribution (`uv tool install agent-postmortem` from PyPI from 0.3.5; a
+GitHub install with `uv tool install git+...` in 0.3.3 and 0.3.4), a command table
 listing exactly which commands take `--json` and which take `--no-redact`.
 Then "What it covers", before Quick start: one table of run shapes and failure
 kinds, each marked covered, partial or not yet, as checked against the upstream issue

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-postmortem",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Reads the Claude Code logs already on your machine and tells you which agent's 'done' you can't trust, and what to run next.",
   "author": {
     "name": "zeyusuntt",

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/plugin/README.md

@@ -41,15 +41,16 @@ On `SessionStart`, if the plugin has not installed a CLI into its own data
 directory and no `agent-postmortem` on your `PATH` passes its protocol check
 (`agent-postmortem hook capabilities` answers protocol 1), and
 [`uv`](https://docs.astral.sh/uv/) is on your `PATH`, the plugin installs
-the version pinned in the plugin manifest from its GitHub tag (`git` is
-needed too), retrying at most once every 24
+the version pinned in the plugin manifest from PyPI, or from the matching
+GitHub tag if that install fails (that fallback needs `git`), retrying at
+most once every 24
 hours on failure, and writes what happened to a log file instead of your
 terminal. This is the plugin's only network access.
 
 Opt out by setting `AGENT_POSTMORTEM_NO_AUTO_INSTALL=1` (in your shell
 profile, or wherever you set environment variables for Claude Code), or by
 installing the CLI yourself ahead of time with
-`uv tool install git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4`.
+`uv tool install agent-postmortem`.
 
 ## The `/postmortem` skill
 

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/plugin/hooks/run.sh

@@ -40,7 +40,9 @@ fi
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" >/dev/null 2>&1 && pwd)"
 PLUGIN_ROOT="$(cd "$SCRIPT_DIR/.." >/dev/null 2>&1 && pwd)"
 PLUGIN_JSON="$PLUGIN_ROOT/.claude-plugin/plugin.json"
-# The CLI install source (docs/DESIGN.md 7.3): the public repository at the tag v<plugin version>.
+# The CLI install sources (docs/DESIGN.md 7.3): PyPI at the plugin version first, then the
+# public repository at the tag v<plugin version> if that install fails.
+PYPI_PACKAGE="agent-postmortem"
 GIT_SOURCE="git+https://github.com/zeyusuntt/agent-postmortem"
 
 # docs/DESIGN.md 7.2's D9: one data directory, derived once, used for
@@ -325,8 +327,8 @@ _print_missing_cli_hint_if_due() {
     if _modified_within_a_day "$marker"; then
         return 0
     fi
-    printf '{"systemMessage": "agent-postmortem CLI not found; run: uv tool install %s@v%s"}\n' \
-        "$GIT_SOURCE" "$(_plugin_version)"
+    printf '{"systemMessage": "agent-postmortem CLI not found; run: uv tool install %s"}\n' \
+        "$PYPI_PACKAGE"
     : >"$marker" 2>/dev/null
 }
 
@@ -353,16 +355,22 @@ _maybe_install() {
     pinned_version="$(_plugin_version)"
     [ -n "$pinned_version" ] || return 0
 
-    # Plan B (2026-10-28): the git tag that matches the plugin version, until PyPI works.
-    source="$GIT_SOURCE@v$pinned_version"
+    # PyPI at the plugin version first; the matching GitHub tag only if that install fails
+    # (for example in the minutes between a release reaching GitHub and reaching PyPI). Both
+    # run under the one 60-second deadline the single install had, so the hook's time budget
+    # is unchanged.
+    pypi_source="$PYPI_PACKAGE==$pinned_version"
+    git_source="$GIT_SOURCE@v$pinned_version"
     {
-        printf '%s attempting: uv tool install %s\n' \
-            "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$source"
+        printf '%s attempting: uv tool install %s (fallback: %s)\n' \
+            "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$pypi_source" "$git_source"
     } >>"$install_log" 2>/dev/null
 
     mkdir -p "$DATA_DIR/bin" 2>/dev/null
     UV_TOOL_DIR="$DATA_DIR" UV_TOOL_BIN_DIR="$DATA_DIR/bin" \
-        _run_with_deadline 60 uv tool install "$source" --python 3.11+ \
+        _run_with_deadline 60 sh -c \
+        'uv tool install "$1" --python 3.11+ || uv tool install "$2" --python 3.11+' \
+        sh "$pypi_source" "$git_source" \
         </dev/null >>"$install_log" 2>&1
 }
 

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/plugin/skills/postmortem/SKILL.md

@@ -114,5 +114,5 @@ Bash tool.
   `--no-redact` only if the user asks to see raw paths or session ids, and
   say so when you do.
 - If the CLI is missing entirely, tell the user to run
-  `uv tool install git+https://github.com/zeyusuntt/agent-postmortem@v0.3.4` and stop; do not try to install it
+  `uv tool install agent-postmortem` and stop; do not try to install it
   yourself.

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "agent-postmortem"
-version = "0.3.4"
-description = "Post-mortem for multi-agent coding runs: prove what silently went wrong, then draft the rule that prevents it."
+version = "0.3.5"
+description = "Reads the Claude Code logs already on your machine and tells you which agent's 'done' you can't trust, and what to run next."
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.11"
 dependencies = []
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 3 - Alpha",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/src/agent_postmortem/__init__.py

@@ -6,4 +6,4 @@ plugin/.claude-plugin/plugin.json's version (docs/DESIGN.md 7.1's D1,
 enforced by tests/test_plugin.py).
 """
 
-__version__ = "0.3.4"
+__version__ = "0.3.5"

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/tests/test_launch_docs.py

@@ -1,7 +1,6 @@
 """README first screen, coverage table and issue templates for the public launch (DESIGN 8.4).
 
-The first screen asks the question the tool answers and gives the PyPI command with a GitHub
-fallback; "What it covers" states coverage honestly (covered, partial, not yet) before Quick
+The first screen asks the question the tool answers and gives the one-command PyPI run (0.3.5); "What it covers" states coverage honestly (covered, partial, not yet) before Quick
 start; every issue template asks for default-level `--bug-report` output and the Claude Code
 version, and never for a raw transcript.
 """
@@ -32,11 +31,12 @@ def _section(text: str, heading: str) -> str:
     return match.group(1)
 
 
-def test_first_screen_asks_the_question_and_gives_the_tagged_github_command():
+def test_first_screen_asks_the_question_and_gives_the_pypi_command():
     head = "\n".join(README.splitlines()[:16])
     assert 'Which "done" in your last Claude Code run can\'t you trust?' in head
-    assert f"\nuvx --from {GIT_SOURCE}@v{VERSION} agent-postmortem scan\n" in head
-    assert "PyPI" in head and "coming" in head
+    assert "\nuvx agent-postmortem scan\n" in head
+    assert GIT_SOURCE not in head
+    assert "coming" not in head
     assert "13 of 166 workflow runs" in head
 
 
@@ -79,13 +79,18 @@ def test_no_issue_template_asks_for_transcript_lines():
         assert "transcript line that shows" not in text, path.name
 
 
-def test_no_user_facing_text_installs_from_pypi():
-    """Plan B (2026-10-28): until PyPI works, every install line uses the GitHub tag."""
-    bare = re.compile(r"pip install agent-postmortem|uvx agent-postmortem|"
-                      r"uv tool install \"?agent-postmortem(?![\w.-]*@)")
+def test_user_facing_install_lines_use_pypi():
+    """0.3.5: PyPI works, so no install line a stranger reads points at the GitHub tag.
+    The plugin's own fallback to the tag is code in run.sh, tested in test_plugin.py."""
     for path in USER_FACING:
+        if path.name == "run.sh":
+            continue
         text = path.read_text(encoding="utf-8")
-        assert not bare.search(text), f"{path.name}: {bare.search(text).group(0)}"
+        assert f"{GIT_SOURCE}@" not in text, f"{path.name} still installs from the GitHub tag"
+    quick_start = _section(README, "Quick start")
+    assert "\nuv tool install agent-postmortem\n" in quick_start
+    for path in (REPO_ROOT / "plugin" / "README.md", REPO_ROOT / "plugin" / "skills" / "postmortem" / "SKILL.md"):
+        assert "uv tool install agent-postmortem" in path.read_text(encoding="utf-8"), path.name
 
 
 def test_every_github_tag_named_in_user_facing_text_is_the_package_version():

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/tests/test_n9_docs.py

@@ -96,11 +96,11 @@ def test_changelog_unreleased_entry_is_first_and_grouped():
     assert "http" not in entry
 
 
-def test_the_package_version_is_0_3_4():
+def test_the_package_version_is_0_3_5():
     pyproject = (REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8")
     init = (REPO_ROOT / "src" / "agent_postmortem" / "__init__.py").read_text(encoding="utf-8")
-    assert re.search(r'^version = "0\.3\.4"', pyproject, re.M)
-    assert '__version__ = "0.3.4"' in init
+    assert re.search(r'^version = "0\.3\.5"', pyproject, re.M)
+    assert '__version__ = "0.3.5"' in init
 
 
 # ---- DESIGN ----

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/tests/test_plugin.py

@@ -72,6 +72,9 @@ POSITIONING = (
 )
 REPOSITORY_URL = "https://github.com/zeyusuntt/agent-postmortem"
 GIT_SOURCE = f"git+{REPOSITORY_URL}"
+# docs/DESIGN.md 7.3 (0.3.5): the CLI comes from PyPI, pinned to the plugin version; the
+# matching GitHub tag is the fallback when that install fails.
+PYPI_SPEC = "agent-postmortem=="
 
 
 def _manifest_version() -> str:
@@ -107,17 +110,17 @@ def test_plugin_version_equals_package_version():
     assert plugin["version"] == package_version
 
 
-def test_pyproject_plugin_and_package_versions_are_all_0_3_4():
+def test_pyproject_plugin_and_package_versions_are_all_0_3_5():
     """docs/DESIGN.md 7.1's D1: the literal, not just mutual equality --
     a version bump that only kept two of the three in sync would still
     pass a pure-equality check."""
     pyproject = tomllib.loads((REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8"))
-    assert pyproject["project"]["version"] == "0.3.4"
+    assert pyproject["project"]["version"] == "0.3.5"
     plugin = _load_json(PLUGIN_ROOT / ".claude-plugin" / "plugin.json")
-    assert plugin["version"] == "0.3.4"
+    assert plugin["version"] == "0.3.5"
     import agent_postmortem
 
-    assert agent_postmortem.__version__ == "0.3.4"
+    assert agent_postmortem.__version__ == "0.3.5"
 
 
 def test_pyproject_declares_agent_postmortem_as_primary_and_postmortem_as_alias():
@@ -372,10 +375,7 @@ def test_run_sh_prints_the_missing_cli_hint_once_a_day(tmp_path):
     assert second.returncode == 0, second.stderr
     hint = json.loads(first.stdout)
     assert hint == {
-        "systemMessage": (
-            "agent-postmortem CLI not found; run: uv tool install "
-            f"{GIT_SOURCE}@v{_manifest_version()}"
-        )
+        "systemMessage": "agent-postmortem CLI not found; run: uv tool install agent-postmortem"
     }
     assert second.stdout == ""
 
@@ -407,15 +407,46 @@ def test_run_sh_attempts_install_once_on_session_start_when_uv_is_on_path(tmp_pa
     assert second.returncode == 0, second.stderr
     invocations = uv_log.read_text(encoding="utf-8").splitlines() if uv_log.exists() else []
     assert len(invocations) == 1, f"expected exactly one uv invocation, got {invocations!r}"
-    # Plan B (2026-10-28): the CLI comes from the GitHub tag that matches the plugin version,
-    # not from PyPI.
-    pinned = f"{GIT_SOURCE}@v{_manifest_version()}"
+    # 0.3.5: PyPI first, pinned to the plugin version; a PyPI install that succeeds is the
+    # only one attempted.
+    pinned = f"{PYPI_SPEC}{_manifest_version()}"
     assert invocations[0].startswith(f"tool install {pinned} ")
     install_log = plugin_data / "install.log"
     assert install_log.exists()
     assert f"uv tool install {pinned}" in install_log.read_text(encoding="utf-8")
 
 
+_FAKE_UV_FAILS_ON_PYPI = r"""#!/usr/bin/env bash
+echo "$@" >> "$AGENT_POSTMORTEM_TEST_UV_LOG"
+case "$*" in
+    *agent-postmortem==*) exit 1 ;;
+esac
+exit 0
+"""
+
+
+def test_run_sh_falls_back_to_the_matching_github_tag_when_the_pypi_install_fails(tmp_path):
+    uv_bin = tmp_path / "uv-bin"
+    uv_log = tmp_path / "uv-invocations.log"
+    _write_fake_cli(uv_bin, "uv", _FAKE_UV_FAILS_ON_PYPI)
+    plugin_data = tmp_path / "plugin-data"
+
+    result = _run_run_sh(
+        "session-start", path_entries=[str(uv_bin)], plugin_data=plugin_data,
+        stdin='{"source": "startup"}', extra_env={"AGENT_POSTMORTEM_TEST_UV_LOG": str(uv_log)},
+    )
+
+    assert result.returncode == 0, result.stderr
+    invocations = uv_log.read_text(encoding="utf-8").splitlines()
+    version = _manifest_version()
+    assert len(invocations) == 2, f"expected PyPI then the GitHub tag, got {invocations!r}"
+    assert invocations[0].startswith(f"tool install {PYPI_SPEC}{version} ")
+    assert invocations[1].startswith(f"tool install {GIT_SOURCE}@v{version} ")
+    log = (plugin_data / "install.log").read_text(encoding="utf-8")
+    assert f"uv tool install {PYPI_SPEC}{version}" in log
+    assert f"{GIT_SOURCE}@v{version}" in log
+
+
 def test_run_sh_never_installs_when_no_auto_install_is_set(tmp_path):
     uv_bin = tmp_path / "uv-bin"
     uv_log = tmp_path / "uv-invocations.log"

{agent_postmortem-0.3.4 → agent_postmortem-0.3.5}/uv.lock

@@ -4,7 +4,7 @@ requires-python = ">=3.11"
 
 [[package]]
 name = "agent-postmortem"
-version = "0.3.4"
+version = "0.3.5"
 source = { editable = "." }
 
 [package.optional-dependencies]