draftwatch 0.1.0__tar.gz

draftwatch-0.1.0/LICENSE

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

draftwatch-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: draftwatch
+Version: 0.1.0
+Summary: Review an AI agent's edits to your writing files as a real git word-diff — keep or revert changes hunk by hunk, then commit.
+Author: Mike Konczal
+License: MIT
+Keywords: git,diff,writing,review,ai,agent,markdown
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Editors
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: app
+Requires-Dist: pywebview>=4.0; extra == "app"
+Dynamic: license-file
+
+# Draftwatch
+
+Draftwatch is a lightweight IDE for writers that all them to review an AI agent's edits to their writing the way you'd review a pull request. Draftwatch shows the exact, git-backed word-diff of what changed in a file, lets you keep or revert each change, and commits when you're done.
+
+The diff comes from git on your machine, not from the AI vendor and not from a JavaScript approximation. You get independent verification of what the agent actually did.
+
+Python 3.9+ and git are the only requirements. The front-end libraries (CodeMirror 6, marked, DOMPurify, Turndown) are vendored and served locally, so it works offline and binds to localhost only.
+
+## Install
+
+Install straight from GitHub, no clone needed:
+
+```bash
+# uv (recommended): run without installing
+uvx --from git+https://github.com/mtkonczal/Draftwatch.git draftwatch draft.md
+
+# pipx: install the `draftwatch` command onto your PATH
+pipx install git+https://github.com/mtkonczal/Draftwatch.git
+
+# pip
+pip install git+https://github.com/mtkonczal/Draftwatch.git
+```
+
+For the native app window, add the `app` extra:
+
+```bash
+pipx install "draftwatch[app] @ git+https://github.com/mtkonczal/Draftwatch.git"
+```
+
+## Usage
+
+Run it from inside any git repository you write in:
+
+```bash
+draftwatch draft.md
+```
+
+Or to start with a specific file:
+
+```bash
+draftwatch draft.md
+```
+
+Draftwatch opens a two-panel review window: your source on the left (a real editor with markdown highlighting, search, and a live preview), the diff against your baseline on the right. Review the changes, revert the ones you don't want, apply, then commit. Committing advances the baseline, so the next agent pass starts clean.
+
+Start without a file (`draftwatch`) to pick one in the window.
+
+### Options
+
+```
+draftwatch [target] [--port 8787] [--host 127.0.0.1] [--no-open] [--app | --no-app]
+```
+
+- `target`: file to watch. Optional; omit it to pick one in the UI.
+- `--port`: default `8787`.
+- `--host`: default `127.0.0.1`. Changing this exposes the tool on your network and is not recommended.
+- `--no-open`: don't auto-open a window (useful headless or over SSH).
+- `--app` / `--no-app`: force or disable the native window. It is on by default when pywebview is installed and falls back to the browser otherwise.
+
+## Features
+
+- Real git word-diffs, so what you see is exactly what git sees.
+- Keep or revert changes one hunk at a time, or all at once, then commit from the UI.
+- Switchable baseline: last push, HEAD, or an earlier commit.
+- Jump between changes or collapse to a changes-only view for long documents.
+- Editable markdown preview alongside the raw source.
+- You and the agent can both edit; your unsaved work is never clobbered when the file changes on disk.
+
+## Security
+
+Draftwatch binds `127.0.0.1` only. Every request carries a per-session token, the Host and Origin headers are validated to defeat DNS-rebinding, and the markdown preview is sanitized with DOMPurify before rendering. The tool never talks to any LLM. Don't change `--host` unless you understand the exposure.
+
+## Tests
+
+```bash
+python3 testing/test_reconstruct.py   # reconstruction invariants
+python3 testing/test_acceptance.py    # end-to-end server tests
+```
+
+## Development
+
+The front-end libraries are vendored into `draftwatch/assets/` and committed, so end users never need Node. To rebuild them: `npm install && npm run build:vendor`.
+
+## Author
+
+Built by Mike Konczal. Vibe-coded with Fable 5.
+
+## License
+
+MIT. See `LICENSE`.

draftwatch-0.1.0/README.md

@@ -0,0 +1,90 @@
+# Draftwatch
+
+Draftwatch is a lightweight IDE for writers that all them to review an AI agent's edits to their writing the way you'd review a pull request. Draftwatch shows the exact, git-backed word-diff of what changed in a file, lets you keep or revert each change, and commits when you're done.
+
+The diff comes from git on your machine, not from the AI vendor and not from a JavaScript approximation. You get independent verification of what the agent actually did.
+
+Python 3.9+ and git are the only requirements. The front-end libraries (CodeMirror 6, marked, DOMPurify, Turndown) are vendored and served locally, so it works offline and binds to localhost only.
+
+## Install
+
+Install straight from GitHub, no clone needed:
+
+```bash
+# uv (recommended): run without installing
+uvx --from git+https://github.com/mtkonczal/Draftwatch.git draftwatch draft.md
+
+# pipx: install the `draftwatch` command onto your PATH
+pipx install git+https://github.com/mtkonczal/Draftwatch.git
+
+# pip
+pip install git+https://github.com/mtkonczal/Draftwatch.git
+```
+
+For the native app window, add the `app` extra:
+
+```bash
+pipx install "draftwatch[app] @ git+https://github.com/mtkonczal/Draftwatch.git"
+```
+
+## Usage
+
+Run it from inside any git repository you write in:
+
+```bash
+draftwatch draft.md
+```
+
+Or to start with a specific file:
+
+```bash
+draftwatch draft.md
+```
+
+Draftwatch opens a two-panel review window: your source on the left (a real editor with markdown highlighting, search, and a live preview), the diff against your baseline on the right. Review the changes, revert the ones you don't want, apply, then commit. Committing advances the baseline, so the next agent pass starts clean.
+
+Start without a file (`draftwatch`) to pick one in the window.
+
+### Options
+
+```
+draftwatch [target] [--port 8787] [--host 127.0.0.1] [--no-open] [--app | --no-app]
+```
+
+- `target`: file to watch. Optional; omit it to pick one in the UI.
+- `--port`: default `8787`.
+- `--host`: default `127.0.0.1`. Changing this exposes the tool on your network and is not recommended.
+- `--no-open`: don't auto-open a window (useful headless or over SSH).
+- `--app` / `--no-app`: force or disable the native window. It is on by default when pywebview is installed and falls back to the browser otherwise.
+
+## Features
+
+- Real git word-diffs, so what you see is exactly what git sees.
+- Keep or revert changes one hunk at a time, or all at once, then commit from the UI.
+- Switchable baseline: last push, HEAD, or an earlier commit.
+- Jump between changes or collapse to a changes-only view for long documents.
+- Editable markdown preview alongside the raw source.
+- You and the agent can both edit; your unsaved work is never clobbered when the file changes on disk.
+
+## Security
+
+Draftwatch binds `127.0.0.1` only. Every request carries a per-session token, the Host and Origin headers are validated to defeat DNS-rebinding, and the markdown preview is sanitized with DOMPurify before rendering. The tool never talks to any LLM. Don't change `--host` unless you understand the exposure.
+
+## Tests
+
+```bash
+python3 testing/test_reconstruct.py   # reconstruction invariants
+python3 testing/test_acceptance.py    # end-to-end server tests
+```
+
+## Development
+
+The front-end libraries are vendored into `draftwatch/assets/` and committed, so end users never need Node. To rebuild them: `npm install && npm run build:vendor`.
+
+## Author
+
+Built by Mike Konczal. Vibe-coded with Fable 5.
+
+## License
+
+MIT. See `LICENSE`.

draftwatch-0.1.0/draftwatch/__init__.py

@@ -0,0 +1,9 @@
+"""draftwatch — review an AI agent's edits to your writing as a real git word-diff.
+
+The diff is produced by git on your machine, never by the AI vendor: independent
+verification of what the agent changed, with hunk-by-hunk keep/revert and a
+commit loop.
+"""
+
+from .app import *                  # noqa: F401,F403  (re-export the engine for tests/embedding)
+from .app import main, __version__  # noqa: F401  (version lives in app.py, single source)

draftwatch-0.1.0/draftwatch/__main__.py

@@ -0,0 +1,6 @@
+"""`python -m draftwatch` entry point."""
+
+from .app import main
+
+if __name__ == "__main__":
+    main()