debugbrief 1.1.0__py3-none-any.whl

debugbrief-1.1.0.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: debugbrief
+Version: 1.1.0
+Summary: Local-first CLI that records the meaningful context of a debugging session and turns it into a useful markdown brief.
+Author: DebugBrief
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/harihkk/Debug-Brief
+Project-URL: Repository, https://github.com/harihkk/Debug-Brief
+Project-URL: Changelog, https://github.com/harihkk/Debug-Brief/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/harihkk/Debug-Brief/issues
+Keywords: cli,debugging,pull-request,handoff,incident,report
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# DebugBrief
+
+[![CI](https://github.com/harihkk/Debug-Brief/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/harihkk/Debug-Brief/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/debugbrief)](https://pypi.org/project/debugbrief/)
+
+Turn a debugging session into an honest markdown brief for a PR, a handoff, or an
+incident note.
+
+You record notes and run commands through DebugBrief while you work. When you are
+done, it writes a report built only from what actually happened: what you tried,
+what failed, what then passed, and which files changed in between. It never
+invents a root cause and never claims a test result you did not get.
+
+It is local-first and dependency-free: standard library plus native `git`, no
+network, no AI, no telemetry. Unix-like systems only.
+
+See a real generated report: [examples/sample-pr.md](examples/sample-pr.md).
+
+## Install
+
+```bash
+pip install debugbrief
+```
+
+Or from a clone: `pip install -e .`. Needs Python 3.9+ and native `git` on a
+Unix-like system (Linux, macOS, BSD).
+
+## Quickstart
+
+```bash
+debugbrief start "Fix add() returning wrong result"
+debugbrief note "add() subtracts instead of adds; the test expects 5."
+debugbrief run -- python -m pytest -q test_calc.py   # fails
+# ... make your fix ...
+debugbrief redo                                      # same test again: passes
+debugbrief end                                       # writes the pr-style brief
+```
+
+Everything after `--` runs exactly as you typed it, with its output streaming
+live to your terminal; DebugBrief flags (`--timeout`, `--shell`, `--no-redact`)
+go before the `--`. Quoting the whole command also works: `debugbrief run
+"pytest -q"`. `redo` re-runs the last captured command, and `end` defaults to
+the `pr` report mode.
+
+Tip: a one-line alias makes the capture prefix disappear in daily use:
+
+```bash
+alias db="debugbrief run --"
+db pytest -q
+```
+
+`run` and `note` auto-start a session if you forget to, so a capture is never
+lost (and `debugbrief cancel` discards a session you did not mean to start).
+The resulting report leads with a derived one-liner like:
+
+> Failing check `python -m pytest -q test_calc.py` passed after 2 attempts over
+> 2s, changes touched calc.py.
+
+## How it works
+
+- `run` executes a command, records its real exit code, bounded output, duration,
+  and a per-command git snapshot, then returns the command's own exit code.
+- Pass/fail comes only from the exit code. A command counts as "verified" only if
+  a recognized test/build/lint/typecheck command actually exited `0`.
+- `end` derives the report from those events: the red-to-green window, the
+  reproduce/verify commands, a timeline, the observed error verbatim, and what
+  was ruled out. Empty sections are omitted, never padded.
+- Secret-like values in captured output are replaced with `[redacted]` before
+  anything is written to disk (best effort; `--no-redact` opts out).
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `start "<title>"` | Start a session |
+| `note <text ...>` | Record a note (quoting optional) |
+| `run -- <command ...>` | Execute and capture a command |
+| `redo` | Re-run the last captured command |
+| `end [--mode pr\|handoff\|incident]` | Finalize and write a report (default `pr`) |
+| `cancel [--yes]` | Discard the active session, no report |
+| `status` | Show the active session |
+| `doctor [--fix]` | Health-check the project and state |
+| `last` / `open` | Find or open the most recent report |
+| `list` / `show <id>` | Browse recorded sessions |
+
+Full detail, flags, and the report modes: [docs/COMMANDS.md](docs/COMMANDS.md).
+
+Post a brief straight to a PR (GitHub CLI optional):
+
+```bash
+debugbrief end --stdout | gh pr comment --body-file -
+```
+
+## Limitations
+
+- Unix-like only; no Windows/PowerShell.
+- Capture is explicit via `debugbrief run`. There is no terminal transcript or
+  PTY capture, and output is stored as bounded previews, not full logs.
+- Interactive and TUI commands (a pdb session, watch modes) will behave oddly
+  under `run`, because output is piped for capture rather than attached to a
+  terminal. Run those directly and record the outcome with `note`.
+- Redaction is conservative and best effort; it does not catch every secret.
+- Git sections need native `git`; outside a repo they are omitted honestly.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

debugbrief-1.1.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+debugbrief/__init__.py,sha256=U9RXSNXRZ49hiVPylXip9GMykmJT-hqL-g5lC2fTrp8,473
+debugbrief/__main__.py,sha256=r_zGncmcu79lLoxJ8MFvmmi4I-wZekC_bbXNdzntZgw,178
+debugbrief/cli.py,sha256=sITP8IaBxYGxVpYb7NG65pdfK6Q03bVswOvGQGER1aY,29139
+debugbrief/command_runner.py,sha256=fGq_-7akgmYZU5nGKINa57EaWuK3xwK6GPaTtDv0Ank,7721
+debugbrief/derive.py,sha256=Xs1PCRG65G6jdpORx6Ga4jG_NcUJN4okjnYfFewYk9s,10965
+debugbrief/doctor.py,sha256=_9Xb9NUx0j66nqcXKBT9xDmGayWS-xyXRjr16oAM9FE,9820
+debugbrief/filters.py,sha256=1z8e1_vokfsiV2Q5VIIKSkK9Q0Hz7gg2D36rQlMNgKg,8805
+debugbrief/git_utils.py,sha256=tuvBMg4vUgSpXvEZY0JK7sIgAlf-QaZULu-u8KnY5HM,8522
+debugbrief/models.py,sha256=o_Ir4Bfa-BWa6-eW8tptDEiVUFjb4jPAUSXp6JkFHSU,11253
+debugbrief/paths.py,sha256=Yd6L6zqQ5bOn5-DdAeJLj2h0bfiloE1MzstlcYGe1N4,4723
+debugbrief/redaction.py,sha256=sdMy7y_duJKLYIBvJQahMuGD4539XyJtvOAm75WQH4w,3983
+debugbrief/reports_index.py,sha256=eOq6G6scfaSyIa2GdJKVYZg1kTBQp_ejZvLBWWldOZI,1620
+debugbrief/session_manager.py,sha256=BszIqTWOeQVlZRw3Ejj7L2N873hfr7LhUV_S-sHfKuA,14098
+debugbrief/sessions_index.py,sha256=4jSFo09MGOl_TeDcM5Bh71lppV8z4g8pHULVmuOOZPo,2557
+debugbrief/utils.py,sha256=8x4lcapsB6yNLgY9KJZFUl-QTUX2pba4yR5DVi7Ocxs,5069
+debugbrief/reporters/__init__.py,sha256=ZT9GYK1WaqMTvbZeZEq-QXlQKX36W5qkRrYSYhhJzJA,3586
+debugbrief/reporters/base.py,sha256=0pavQeRbMWKdwMINOW70X8NP8MTRpGbKRne8SBjxu2w,13918
+debugbrief/reporters/handoff.py,sha256=Ff5j97Icg4_I84t_j_YLL078NCkOWyyHL28_xhl4zMs,3180
+debugbrief/reporters/incident.py,sha256=hWH2q2QbS8FWkejBedECwFGfXLbEn-EbQ2Kz12RcW4o,3433
+debugbrief/reporters/pr.py,sha256=clXcCMgm9ps2rwLSiBWwRLlsE8tNSwnnuh7PHNqGLEQ,870
+debugbrief-1.1.0.dist-info/licenses/LICENSE,sha256=eYmMPl8GglBY7HLqF8591XUvqzp3EtNaHY7Jo9Xo_EE,1080
+debugbrief-1.1.0.dist-info/METADATA,sha256=F1MVmjY-g2MgnYTEN4Y8PijU84gKN_XdfH4EpDXgmxY,5692
+debugbrief-1.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+debugbrief-1.1.0.dist-info/entry_points.txt,sha256=mRboPZabHVUMrsoRSP03A4NG-tp9nHs9kkZn3cV0rZg,51
+debugbrief-1.1.0.dist-info/top_level.txt,sha256=gAmlNjTo8vXktM46tvqQjwMrZ0YMzhTir-abiNLkmes,11
+debugbrief-1.1.0.dist-info/RECORD,,

debugbrief-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

debugbrief-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+debugbrief = debugbrief.cli:main

debugbrief-1.1.0.dist-info/licenses/LICENSE

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

debugbrief-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+debugbrief