uitrace 0.1.0__tar.gz

uitrace-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: macos-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .python-version
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Sync
+        run: uv sync --group dev --frozen
+
+      - name: Ruff
+        run: uv run ruff check . --output-format github
+
+      - name: Mypy
+        run: uv run mypy src
+
+      - name: Pytest
+        run: uv run pytest -q
+
+      - name: Build (sdist+wheel)
+        run: uv build --no-sources

uitrace-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,105 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Dry run (skip publish to PyPI)"
+        required: false
+        type: boolean
+        default: true
+
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: macos-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .python-version
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Verify tag matches pyproject.toml version
+        if: github.event_name == 'push'
+        shell: bash
+        run: |
+          set -euo pipefail
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PYPROJECT_VERSION="$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")"
+          if [[ "$TAG_VERSION" != "$PYPROJECT_VERSION" ]]; then
+            echo "::error::Tag version v${TAG_VERSION} does not match pyproject.toml version ${PYPROJECT_VERSION}"
+            exit 1
+          fi
+
+      - name: Sync
+        run: uv sync --group dev --frozen
+
+      - name: Ruff
+        run: uv run ruff check . --output-format github
+
+      - name: Mypy
+        run: uv run mypy src
+
+      - name: Pytest
+        run: uv run pytest -q
+
+      - name: Build (sdist+wheel)
+        run: uv build --no-sources
+
+      - name: Smoke test wheel
+        shell: bash
+        run: |
+          set -euo pipefail
+          shopt -s nullglob
+          wheels=(dist/*.whl)
+          if [ ${#wheels[@]} -ne 1 ]; then
+            echo "Expected exactly 1 wheel in dist/, found: ${wheels[*]}"
+            exit 1
+          fi
+          uvx --from "${wheels[0]}" uitrace --help
+          uvx --from "${wheels[0]}" uitrace play --dry-run tests/fixtures/trace_v1_valid.jsonl
+
+      - name: Upload dists
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.dry_run) }}
+    runs-on: macos-latest
+    needs: build
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Download dists
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Publish
+        run: uv publish --trusted-publishing always dist/*

uitrace-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

uitrace-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.4
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format

uitrace-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

uitrace-0.1.0/.sisyphus/boulder.json

@@ -0,0 +1,10 @@
+{
+  "active_plan": "/Users/mark/MyProjects/uitrace/.sisyphus/plans/publish-to-pypi-oidc.md",
+  "started_at": "2026-03-01T13:23:09.000Z",
+  "session_ids": [
+    "ses_356970422ffeNuJcGYii4CCpI7",
+    "ses_3566bf565ffeIGk5T8T0tjztke"
+  ],
+  "plan_name": "publish-to-pypi-oidc",
+  "worktree_path": "/Users/mark/MyProjects/uitrace"
+}

uitrace-0.1.0/.sisyphus/evidence/task-3-macos-window_from_point.txt

@@ -0,0 +1,2 @@
+.......                                                                  [100%]
+7 passed in 0.04s

uitrace-0.1.0/.sisyphus/evidence/task-6-record-follow-any-regression.txt

@@ -0,0 +1,2 @@
+.....                                                                    [100%]
+5 passed in 0.04s

uitrace-0.1.0/.sisyphus/evidence/task-6-record-follow-any.txt

@@ -0,0 +1,2 @@
+..............                                                           [100%]
+14 passed in 0.05s

uitrace-0.1.0/.sisyphus/evidence/task-8-player-wait_until.txt

@@ -0,0 +1,2 @@
+.....                                                                    [100%]
+5 passed in 0.11s

uitrace-0.1.0/.sisyphus/notepads/2026-02-28-uitrace-mvp/decisions.md

@@ -0,0 +1,3 @@
+- 2026-02-28: Kept exact exit-code mapping from plan, including `UNSUPPORTED_PLATFORM = 11`.
+- 2026-02-28: Used dataclass for `UitError` with typed optional `hint` and `details`.
+- 2026-02-28: Preserved one-line `format_error` contract and wired CLI `main()` to handle `UitError` and `KeyboardInterrupt`.

uitrace-0.1.0/.sisyphus/notepads/2026-02-28-uitrace-mvp/issues.md

@@ -0,0 +1,7 @@
+- 2026-02-28: `@dataclass(slots=True)` + `Exception` with `super().__init__` raised `TypeError` in `__post_init__`.
+- 2026-02-28: Resolved by using `Exception.__init__(self, self.message)` explicitly.
+- 2026-02-28: Full test suite has pre-existing unrelated failures in `tests/test_cli_help.py` and `tests/test_models_roundtrip.py`.
+- 2026-03-01: `Pyright reportMissingImports` still flags `import typer` in LSP diagnostics, while runtime import succeeds via `uv run python -c "import typer"`; treated as environment/indexer mismatch, not a blocker for Task 6 behavior.
+- 2026-03-01: Subagent repeatedly drifted scope; strict session-resume prompts were required to force Task-13-only implementation.
+- 2026-03-01: `show` was repeatedly missed by subagents; direct scoped implementation was required to close final TODO reliably.
+- 2026-03-01: Local `lsp_diagnostics` reports `reportMissingImports` for `typer`/`rich`/package imports in this environment, but `uv run pytest tests/test_show_command.py -q` and `uv run uitrace show --json ...` pass; treated as non-blocking indexer mismatch.

uitrace-0.1.0/.sisyphus/notepads/2026-02-28-uitrace-mvp/learnings.md

@@ -0,0 +1,7 @@
+- 2026-02-28: Task 3 introduces a unified error model via `ErrorCode` + `UitError`.
+- 2026-02-28: `format_error` keeps one-line output with optional hint suffix.
+- 2026-02-28: For TDD red-phase, adding a dataclass assertion on `UitError` exposed the gap correctly.
+- 2026-03-01: Task 6 validate-path fix confirms command-level `except UitError` + `typer.Exit(code=int(e.code))` is the reliable way for `CliRunner.invoke` to surface exit code 40.
+- 2026-03-01: Minimal `play` flow can satisfy acceptance by emitting strict JSONL `step_result` rows in dry-run and a fail-fast permission error row in non-dry-run.
+- 2026-03-01: `show --json` summary is stable with keys `events_total`, `steps_total`, `ts_max`, `types`, and `steps_total` should count only playable event types.
+- 2026-03-01: Task 7 `show` command is covered by CLI tests for both `--json` machine output and default human-readable summary; fixture `trace_v1_valid.jsonl` yields `events_total=7`, `steps_total=4`, `ts_max=1.0`.

uitrace-0.1.0/.sisyphus/notepads/2026-02-28-uitrace-mvp/problems.md

@@ -0,0 +1 @@
+- 2026-02-28: Unrelated repository test failures remain outside Task 3 scope (`test_cli_help`, `test_models_roundtrip`).

uitrace-0.1.0/.sisyphus/notepads/publish-to-pypi-oidc/decisions.md

@@ -0,0 +1,2 @@
+# Decisions
+- F3 disposition: workflow safety posture is acceptable for release readiness; only optional hardening items remain (pin third-party actions by commit SHA, add tag protection for `v*`).

uitrace-0.1.0/.sisyphus/notepads/publish-to-pypi-oidc/issues.md

@@ -0,0 +1,5 @@
+# Issues
+- None encountered during preflight.
+- No issues encountered while adding the CI workflow.
+- No blockers encountered while implementing Task 3 publish workflow and generating evidence files.
+- No issues encountered while documenting the release process in README.md.

uitrace-0.1.0/.sisyphus/notepads/publish-to-pypi-oidc/learnings.md

@@ -0,0 +1,17 @@
+# Learnings
+- Package name `uitrace` is confirmed in `pyproject.toml`.
+- `uv build` successfully generates both wheel and sdist using `hatchling` backend.
+- `uitrace` is not currently on PyPI, so the name is available for this project.
+- Added CI workflow in `.github/workflows/ci.yml` targeting `macos-latest`.
+- CI uses `uv sync --frozen` to ensure lockfile consistency.
+- Added `.github/workflows/publish.yml` with `push` tag trigger `v*`, separate `build`/`publish` jobs, and artifact handoff via `release-dists`.
+- Publish workflow enforces tag-to-`pyproject.toml` version parity via `tomllib` and keeps publish command as `uv publish --trusted-publishing always dist/*`.
+- Smoke-test step uses `nullglob` and single-wheel count guard before `uvx --from "${wheels[0]}" ...` to avoid glob ambiguity.
+- Added `Release` section to `README.md` with concise steps for bumping version, local checks, building, and tagging.
+- Documented PyPI Trusted Publishing setup with owner `mkdir700`, repository `uitrace`, and workflow `publish.yml`.
+- Included a version guard note to ensure tag-to-version parity.
+- F3 review: `ci.yml` uses top-level minimal permission `contents: read`, with no secrets/token/password references.
+- F3 review: `publish.yml` keeps OIDC scope job-local (`publish` job `id-token: write`), and no long-lived PyPI token/secret dependency is present.
+- F3 review: artifact handoff is correct (`upload-artifact` in `build` -> `download-artifact` in `publish`) and publish depends on `needs: build`.
+- F3 review: release race is mitigated by `concurrency.group: publish-${{ github.ref }}` and `cancel-in-progress: false`.
+- Plan bookkeeping synced: all remaining acceptance sub-checkboxes were marked complete after verification evidence review.

uitrace-0.1.0/.sisyphus/notepads/publish-to-pypi-oidc/problems.md

@@ -0,0 +1 @@
+# Problems