pyoxidize 0.2.0__tar.gz → 0.2.3__tar.gz

pyoxidize-0.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhant Bayas
+
+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.

pyoxidize-0.2.3/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: pyoxidize
+Version: 0.2.3
+Summary: a version control system with semantic awareness built-in undo and interactive shell
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Requires-Dist: deepmerge>=1.1
+Requires-Dist: pathspec>=0.11
+Provides-Extra: semantic
+Requires-Dist: tree-sitter>=0.21; extra == "semantic"
+Requires-Dist: tree-sitter-python>=0.21; extra == "semantic"
+Provides-Extra: notebook
+Requires-Dist: nbformat>=5.9; extra == "notebook"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: mypy>=1.5; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: license-file
+
+# oxidize
+
+a content-addressable, semantic-aware version control system -- built from scratch in a weekend, kept (painfully) honest since.
+
+[![ci](https://github.com/siddhant-bayas/oxidize/actions/workflows/ci.yml/badge.svg)](https://github.com/siddhant-bayas/oxidize/actions/workflows/ci.yml)
+[![pypi](https://img.shields.io/pypi/v/pyoxidize)](https://pypi.org/project/pyoxidize/)
+[![python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/pyoxidize/)
+[![size](https://img.shields.io/badge/pip_install_size-tiny-blue)](#install--dependencies)
+
+## install
+
+```bash
+pip install pyoxidize                       # core
+pip install "pyoxidize[semantic]"           # tree-sitter AST diffs
+pip install "pyoxidize[notebook]"           # jupyter integration
+pip install "pyoxidize[dev]"                # pytest, mypy, ruff
+```
+
+optional extras add `tree-sitter`, `nbformat`, etc. core itself pulls in only `click`, `rich`, `prompt_toolkit`, `deepmerge`, `pathspec` -- no native bindings, no large free-threaded runtime.
+
+## why not just use git?
+
+| need | git | oxidize |
+|------|-----|---------|
+| commit / branch / merge | ✅ | ✅ |
+| real structured merge for json/yaml/toml/inipath | ❌ (line-level) | ✅ |
+| cell-level notebook diffs | ❌ | ✅ |
+| AST-aware diffs (function renames) | ❌ | ✅ (opt-in via the `semantic` extra) |
+| secret scanning before commit | ❌ (out-of-tree tooling) | ✅ 21 patterns |
+| ai-agent provenance per commit | ❌ | ✅ `oxidize log --agent ...` |
+| interactive REPL with status bar | ❌ | ✅ |
+| safe undo of every operation | ❌ | ✅ |
+| local-self-contained footprint | ⚠ git + curl + ssh | ✅ one pip package |
+| push to github | ⚠ requires git | ✅ via REST API |
+| LFS over network | ✅ | ⏳ (filesystem remote only) |
+
+oxidize is **not** a git replacement for big teams or monorepos. it's a focused, single-binary, Python-venv-friendly alternative for personal and small-team projects where the semantic and provenance extras matter more than SSH-authenticated push.
+
+## feature status
+
+| feature | status | since |
+|---------|--------|-------|
+| content-addressable store, blob/tree/commit | stable | v0.1.0 |
+| recursive-tree directories | stable | v0.1.0 |
+| `.oxignore` with full `.gitignore` syntax | stable | v0.1.0 |
+| secret scanner (23 patterns) | stable | v0.1.0 |
+| structured data merge | stable | v0.1.0 |
+| notebook cell-level diff | stable | v0.1.0 |
+| interactive REPL (`oxi`) | stable | v0.1.0 |
+| safe undo (journaled) | stable | v0.1.0 |
+| branches / tags / checkout / 3-way merge | stable | v0.1.0 |
+| conflict resolution UI (`oxidize resolve`) | stable | v0.1.0 |
+| ai-agent provenance + filtering | stable | v0.1.0 |
+| ai-agent detection env-var coverage | stable | v0.1.0 |
+| stash | beta | v0.1.0 |
+| bisect | beta | v0.1.0 |
+| hooks (`pre-commit`, etc) | beta | v0.1.0 |
+| blame (line-level) | beta | v0.1.0 |
+| remote sync (filesystem clone/push/pull) | stable | v0.1.0 |
+| semantic diffs (AST-aware, `tree-sitter`) | alpha | v0.2.1 |
+| ai-agent prose locking + qa | (planning) | -- |
+| network remotes (github REST, push-only) | beta | v0.2.2 |
+| LFS-style large-file extension | not yet | -- |
+| submodule support | not yet | -- |
+
+## quick start
+
+```bash
+oxidize init                            # create .oxidize/ and a starter .oxignore
+oxi add main.py                         # stage a single file (or use the alias)
+oxi add .                               # stage everything (respects .oxignore)
+oxi add -f .env.local                   # force-add an ignored file
+oxi status                              # working tree vs index vs HEAD
+oxi commit -m "first commit" --agent claude-code
+oxi branch create feature               # branch off HEAD
+oxi checkout feature                    # switch branches
+oxi merge main                          # three-way merge
+oxidize remote push file:///backup main # filesystem remote
+oxi bisect start v1.0 broken            # binary-search regressions
+oxi                                     # drop into the interactive REPL
+```
+
+## the REPL
+
+```
+oxi> status
+On branch main
+  staged:
+    hello.py
+  modified:
+    README.md
+    (main) main | staged:1 | HEAD:9ecfb22c | Ctrl-D exit | help for commands
+```
+
+launching `oxi` with no args opens a prompt_toolkit REPL with tab completion, history (`~/.oxidize_history`), and a live status bar showing the current branch, staged count, and short HEAD. every command above also works inside it.
+
+## features (the headline ones)
+
+* **content-addressable object store** -- SHA-256, zlib-compressed, deduplicated
+* **recursive tree objects** -- proper nested directory tracking
+* **interactive REPL** -- `oxi` launches a shell with tab completion, live status bar, command history
+* **secret scanning** -- detects 21 types of API keys, tokens, and credentials before commit
+* **structured data merge** -- JSON/YAML/TOML merge at the key level, not text lines
+* **notebook-aware versioning** -- cell-level diffs for `.ipynb` files
+* **AI agent provenance** -- track which agent/tool wrote what code
+* **built-in undo** -- every operation is safely reversible
+* **branches, tags, checkout, merge, resolve** -- full VCS primitives
+* **stash / bisect / hooks** -- everyday workflow commands
+* **filesystem remote sync** -- bare-repo clone/push/pull with atomic writes
+* **github remote** -- push-only export to github repos via REST API (no git needed)
+* **semantic diffs (alpha)** -- AST-aware diffs via the `semantic` extra
+
+## docs
+
+* [Getting Started](docs/getting-started.md) -- installation, quick start, basic workflow
+* [CLI Reference](docs/cli-reference.md) -- every command, flag, and parameter
+* [Configuration](docs/configuration.md) -- config files, environment variables
+* [Interactive Shell](docs/repl.md) -- the `oxi` REPL
+* [Ignores](docs/ignores.md) -- `.oxignore` patterns, builtins, force usage
+* [Branching & Merging](docs/branching.md) -- branches, checkout, 3-way merge, conflicts
+* [Workflow Commands](docs/workflow.md) -- stash, bisect, hooks, tags, blame, notebook-diff
+* [Remote Sync](docs/remote.md) -- filesystem + github remote (beta)
+* [Undo System](docs/undo.md) -- reversing operations
+* [Semantic Diffs](docs/semantic-diffs.md) -- AST-aware diffs
+* [Notebook Support](docs/notebook-support.md) -- Jupyter notebook versioning
+* [Structured Merge](docs/merge.md) -- key-level data merging
+* [Changelog](CHANGELOG.md)
+* [Agent Provenance](docs/provenance.md) -- AI agent tracking
+* [Object Storage](docs/storage.md) -- storage internals
+* [Python API Reference](docs/api-reference.md) -- complete Python API
+* [Architecture](docs/architecture.md) -- system design and internals
+* [Contributing](docs/CONTRIBUTING.md) -- development setup and guidelines
+
+## how it works
+
+every file you add gets hashed using SHA-256 and stored as a blob inside `.oxidize/objects/`
+
+a commit is just:
+
+* a snapshot of the file tree (with proper subtrees for nested dirs)
+* metadata (author, timestamp, agent provenance)
+* a pointer to the previous commit(s)
+
+```txt
+files -> blobs -> tree -> commit -> commit -> commit
+                                     ^
+                                    HEAD
+```
+
+## structure
+
+```txt
+oxidize/
+  objects/       blob tree commit types and serialization
+  storage/       content-addressable object store
+  index/         staging area
+  core/          repo context refs config ignores
+  diff/          myers diff engine
+  merge/         structured + text merge
+  notebook/      ipynb cell-level support
+  semantic/      ast-aware diffs via tree-sitter
+  security/      secret scanning
+  provenance/    ai agent tracking
+  undo/          operation journal and reversal
+  workflow/      stash, bisect, hooks, blame
+  network/       filesystem + github remote sync
+  staging/       stash
+  cli/           click commands and prompt_toolkit repl
+```
+
+## contributing
+
+see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
+
+## license
+
+MIT
+
+~ written by a guy who discovered hashing yesterday

pyoxidize-0.2.3/README.md

@@ -0,0 +1,179 @@
+# oxidize
+
+a content-addressable, semantic-aware version control system -- built from scratch in a weekend, kept (painfully) honest since.
+
+[![ci](https://github.com/siddhant-bayas/oxidize/actions/workflows/ci.yml/badge.svg)](https://github.com/siddhant-bayas/oxidize/actions/workflows/ci.yml)
+[![pypi](https://img.shields.io/pypi/v/pyoxidize)](https://pypi.org/project/pyoxidize/)
+[![python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/pyoxidize/)
+[![size](https://img.shields.io/badge/pip_install_size-tiny-blue)](#install--dependencies)
+
+## install
+
+```bash
+pip install pyoxidize                       # core
+pip install "pyoxidize[semantic]"           # tree-sitter AST diffs
+pip install "pyoxidize[notebook]"           # jupyter integration
+pip install "pyoxidize[dev]"                # pytest, mypy, ruff
+```
+
+optional extras add `tree-sitter`, `nbformat`, etc. core itself pulls in only `click`, `rich`, `prompt_toolkit`, `deepmerge`, `pathspec` -- no native bindings, no large free-threaded runtime.
+
+## why not just use git?
+
+| need | git | oxidize |
+|------|-----|---------|
+| commit / branch / merge | ✅ | ✅ |
+| real structured merge for json/yaml/toml/inipath | ❌ (line-level) | ✅ |
+| cell-level notebook diffs | ❌ | ✅ |
+| AST-aware diffs (function renames) | ❌ | ✅ (opt-in via the `semantic` extra) |
+| secret scanning before commit | ❌ (out-of-tree tooling) | ✅ 21 patterns |
+| ai-agent provenance per commit | ❌ | ✅ `oxidize log --agent ...` |
+| interactive REPL with status bar | ❌ | ✅ |
+| safe undo of every operation | ❌ | ✅ |
+| local-self-contained footprint | ⚠ git + curl + ssh | ✅ one pip package |
+| push to github | ⚠ requires git | ✅ via REST API |
+| LFS over network | ✅ | ⏳ (filesystem remote only) |
+
+oxidize is **not** a git replacement for big teams or monorepos. it's a focused, single-binary, Python-venv-friendly alternative for personal and small-team projects where the semantic and provenance extras matter more than SSH-authenticated push.
+
+## feature status
+
+| feature | status | since |
+|---------|--------|-------|
+| content-addressable store, blob/tree/commit | stable | v0.1.0 |
+| recursive-tree directories | stable | v0.1.0 |
+| `.oxignore` with full `.gitignore` syntax | stable | v0.1.0 |
+| secret scanner (23 patterns) | stable | v0.1.0 |
+| structured data merge | stable | v0.1.0 |
+| notebook cell-level diff | stable | v0.1.0 |
+| interactive REPL (`oxi`) | stable | v0.1.0 |
+| safe undo (journaled) | stable | v0.1.0 |
+| branches / tags / checkout / 3-way merge | stable | v0.1.0 |
+| conflict resolution UI (`oxidize resolve`) | stable | v0.1.0 |
+| ai-agent provenance + filtering | stable | v0.1.0 |
+| ai-agent detection env-var coverage | stable | v0.1.0 |
+| stash | beta | v0.1.0 |
+| bisect | beta | v0.1.0 |
+| hooks (`pre-commit`, etc) | beta | v0.1.0 |
+| blame (line-level) | beta | v0.1.0 |
+| remote sync (filesystem clone/push/pull) | stable | v0.1.0 |
+| semantic diffs (AST-aware, `tree-sitter`) | alpha | v0.2.1 |
+| ai-agent prose locking + qa | (planning) | -- |
+| network remotes (github REST, push-only) | beta | v0.2.2 |
+| LFS-style large-file extension | not yet | -- |
+| submodule support | not yet | -- |
+
+## quick start
+
+```bash
+oxidize init                            # create .oxidize/ and a starter .oxignore
+oxi add main.py                         # stage a single file (or use the alias)
+oxi add .                               # stage everything (respects .oxignore)
+oxi add -f .env.local                   # force-add an ignored file
+oxi status                              # working tree vs index vs HEAD
+oxi commit -m "first commit" --agent claude-code
+oxi branch create feature               # branch off HEAD
+oxi checkout feature                    # switch branches
+oxi merge main                          # three-way merge
+oxidize remote push file:///backup main # filesystem remote
+oxi bisect start v1.0 broken            # binary-search regressions
+oxi                                     # drop into the interactive REPL
+```
+
+## the REPL
+
+```
+oxi> status
+On branch main
+  staged:
+    hello.py
+  modified:
+    README.md
+    (main) main | staged:1 | HEAD:9ecfb22c | Ctrl-D exit | help for commands
+```
+
+launching `oxi` with no args opens a prompt_toolkit REPL with tab completion, history (`~/.oxidize_history`), and a live status bar showing the current branch, staged count, and short HEAD. every command above also works inside it.
+
+## features (the headline ones)
+
+* **content-addressable object store** -- SHA-256, zlib-compressed, deduplicated
+* **recursive tree objects** -- proper nested directory tracking
+* **interactive REPL** -- `oxi` launches a shell with tab completion, live status bar, command history
+* **secret scanning** -- detects 21 types of API keys, tokens, and credentials before commit
+* **structured data merge** -- JSON/YAML/TOML merge at the key level, not text lines
+* **notebook-aware versioning** -- cell-level diffs for `.ipynb` files
+* **AI agent provenance** -- track which agent/tool wrote what code
+* **built-in undo** -- every operation is safely reversible
+* **branches, tags, checkout, merge, resolve** -- full VCS primitives
+* **stash / bisect / hooks** -- everyday workflow commands
+* **filesystem remote sync** -- bare-repo clone/push/pull with atomic writes
+* **github remote** -- push-only export to github repos via REST API (no git needed)
+* **semantic diffs (alpha)** -- AST-aware diffs via the `semantic` extra
+
+## docs
+
+* [Getting Started](docs/getting-started.md) -- installation, quick start, basic workflow
+* [CLI Reference](docs/cli-reference.md) -- every command, flag, and parameter
+* [Configuration](docs/configuration.md) -- config files, environment variables
+* [Interactive Shell](docs/repl.md) -- the `oxi` REPL
+* [Ignores](docs/ignores.md) -- `.oxignore` patterns, builtins, force usage
+* [Branching & Merging](docs/branching.md) -- branches, checkout, 3-way merge, conflicts
+* [Workflow Commands](docs/workflow.md) -- stash, bisect, hooks, tags, blame, notebook-diff
+* [Remote Sync](docs/remote.md) -- filesystem + github remote (beta)
+* [Undo System](docs/undo.md) -- reversing operations
+* [Semantic Diffs](docs/semantic-diffs.md) -- AST-aware diffs
+* [Notebook Support](docs/notebook-support.md) -- Jupyter notebook versioning
+* [Structured Merge](docs/merge.md) -- key-level data merging
+* [Changelog](CHANGELOG.md)
+* [Agent Provenance](docs/provenance.md) -- AI agent tracking
+* [Object Storage](docs/storage.md) -- storage internals
+* [Python API Reference](docs/api-reference.md) -- complete Python API
+* [Architecture](docs/architecture.md) -- system design and internals
+* [Contributing](docs/CONTRIBUTING.md) -- development setup and guidelines
+
+## how it works
+
+every file you add gets hashed using SHA-256 and stored as a blob inside `.oxidize/objects/`
+
+a commit is just:
+
+* a snapshot of the file tree (with proper subtrees for nested dirs)
+* metadata (author, timestamp, agent provenance)
+* a pointer to the previous commit(s)
+
+```txt
+files -> blobs -> tree -> commit -> commit -> commit
+                                     ^
+                                    HEAD
+```
+
+## structure
+
+```txt
+oxidize/
+  objects/       blob tree commit types and serialization
+  storage/       content-addressable object store
+  index/         staging area
+  core/          repo context refs config ignores
+  diff/          myers diff engine
+  merge/         structured + text merge
+  notebook/      ipynb cell-level support
+  semantic/      ast-aware diffs via tree-sitter
+  security/      secret scanning
+  provenance/    ai agent tracking
+  undo/          operation journal and reversal
+  workflow/      stash, bisect, hooks, blame
+  network/       filesystem + github remote sync
+  staging/       stash
+  cli/           click commands and prompt_toolkit repl
+```
+
+## contributing
+
+see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
+
+## license
+
+MIT
+
+~ written by a guy who discovered hashing yesterday

pyoxidize-0.2.3/oxidize/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.3"

{pyoxidize-0.2.0 → pyoxidize-0.2.3}/oxidize/cli/__init__.py

@@ -1,3 +1,3 @@
-from .main import cli
-
-__all__ = ["cli"]
+from .main import cli
+
+__all__ = ["cli"]

pyoxidize-0.2.3/oxidize/cli/commands/add.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+from oxidize.core.repository import Repository, RepositoryNotFound
+from oxidize.undo.reverser import UndoManager
+
+console = Console()
+
+
+@click.command("add")
+@click.argument("paths", nargs=-1, required=True, type=click.Path(exists=True))
+@click.option("-f", "--force", is_flag=True, help="Add ignored files (bypass .oxignore)")
+def cmd_add(paths: tuple[str, ...], force: bool) -> None:
+    """Stage files for the next commit."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+
+    matcher = repo.ignore_matcher
+
+    undo_mgr = UndoManager(repo)
+    added_paths: list[str] = []
+    added_oids: list[str] = []
+    skipped_paths: list[str] = []
+
+    for raw_path in paths:
+        target = Path(raw_path).resolve()
+        if target.is_dir():
+            candidates = [f for f in target.rglob("*") if f.is_file()]
+        else:
+            candidates = [target]
+
+        if force:
+            files = candidates
+        else:
+            files = []
+            for f in candidates:
+                try:
+                    rel = f.relative_to(repo.work_tree).as_posix()
+                except ValueError:
+                    files.append(f)
+                    continue
+                if matcher.is_ignored(rel):
+                    skipped_paths.append(rel)
+                else:
+                    files.append(f)
+
+        for file_path in files:
+            rel = file_path.relative_to(repo.work_tree).as_posix()
+            oid = repo.db.store_blob(file_path.read_bytes())
+            repo.index.add(rel, oid, file_path)
+            added_paths.append(rel)
+            added_oids.append(oid)
+            click.echo(f"  staged: {rel}")
+
+    for skipped in skipped_paths:
+        console.print(f"  [dim]ignored: {skipped}[/]")
+
+    if added_paths:
+        undo_mgr.record_add(added_paths, added_oids)

pyoxidize-0.2.3/oxidize/cli/commands/bisect.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import click
+from rich.console import Console
+
+from oxidize.core.repository import Repository, RepositoryNotFound
+from oxidize.workflow.bisect import BisectState, midpoint
+
+console = Console()
+
+
+@click.group(invoke_without_command=True)
+@click.pass_context
+def cmd_bisect(ctx: click.Context) -> None:
+    """Find a regression by binary search."""
+    if ctx.invoked_subcommand is None:
+        try:
+            repo = Repository.discover()
+        except RepositoryNotFound as e:
+            raise click.ClickException(str(e))
+        state = BisectState(repo.oxidize_dir / "bisect.json")
+        status = state.status()
+        if not status:
+            click.echo("no bisect session; try `oxidize bisect start`")
+            return
+        console.print("current session:")
+        for k, v in status.items():
+            console.print(f"  [dim]{k}[/]: {v}")
+
+
+@cmd_bisect.command("start")
+@click.argument("good", required=False, default="")
+@click.argument("bad", required=False, default="")
+def cmd_bisect_start(good: str, bad: str) -> None:
+    """Start a bisect session. Optionally provide GOOD and BAD commits."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+
+    state = BisectState(repo.oxidize_dir / "bisect.json")
+    state.reset()
+
+    if good and bad:
+        good_oid = repo.refs.read(good) or good
+        bad_oid = repo.refs.read(bad) or bad
+        state.start(good_oid, bad_oid)
+        click.echo(
+            f"check out: {midpoint(repo, good_oid, bad_oid)} then run `oxidize bisect good` or `oxidize bisect bad`"
+        )
+    else:
+        click.echo("bisect armed; run `oxidize bisect bad HEAD`, then `oxidize bisect good <ref>`")
+
+
+@cmd_bisect.command("good")
+@click.argument("ref", required=False, default="HEAD")
+def cmd_bisect_good(ref: str) -> None:
+    """Mark the current commit (or ref) as good."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+    state = BisectState(repo.oxidize_dir / "bisect.json")
+    oid = repo.refs.read(ref) or ref
+    result = state.mark("good", oid)
+    if result.get("done"):
+        click.echo(f"FOUND regression: {result['found']}")
+    else:
+        click.echo(f"check out: {result['next']}")
+
+
+@cmd_bisect.command("bad")
+@click.argument("ref", required=False, default="HEAD")
+def cmd_bisect_bad(ref: str) -> None:
+    """Mark the current commit (or ref) as bad."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+    state = BisectState(repo.oxidize_dir / "bisect.json")
+    oid = repo.refs.read(ref) or ref
+    result = state.mark("bad", oid)
+    if result.get("done"):
+        click.echo(f"FOUND regression: {result['found']}")
+    else:
+        click.echo(f"check out: {result['next']}")
+
+
+@cmd_bisect.command("reset")
+def cmd_bisect_reset() -> None:
+    """End the bisect session."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+    BisectState(repo.oxidize_dir / "bisect.json").reset()
+    click.echo("bisect reset")

pyoxidize-0.2.3/oxidize/cli/commands/blame.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+from oxidize.core.repository import Repository, RepositoryNotFound
+from oxidize.workflow.blame import Blamer
+
+console = Console()
+logger = logging.getLogger(__name__)
+
+
+@click.command("blame")
+@click.argument("path")
+def cmd_blame(path: str) -> None:
+    """Show commit-by-commit annotation for a file."""
+    try:
+        repo = Repository.discover()
+    except RepositoryNotFound as e:
+        raise click.ClickException(str(e))
+
+    target = Path(path).resolve()
+    try:
+        rel = target.relative_to(repo.work_tree).as_posix()
+    except ValueError:
+        rel = path
+
+    annotations = Blamer(repo).annotate(rel)
+    if not annotations:
+        click.echo(f"no history for {rel}")
+        return
+
+    history = {oid for oid, _ in annotations}
+    name = _author_lookup(repo, history)
+
+    for oid, line in annotations:
+        author = name.get(oid, "?")
+        when = "?       "
+        console.print(f"{oid} {author:<10} {when} {line}")
+
+
+def _author_lookup(repo: Repository, oids: set[str]) -> dict[str, str]:
+    out: dict[str, str] = {}
+    for oid in oids:
+        try:
+            commit = repo.db.load_commit(oid)
+        except KeyError:
+            logger.warning("missing commit %s, skipping author lookup", oid)
+            continue
+        full = oid
+        out[full[:8]] = commit.author.name.split()[0]
+    return out