dazzle-claude-code-patcher 0.2.0__py3-none-any.whl

dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env

@@ -0,0 +1,9 @@
+# dcc-env: put the dcc-patcher launcher on PATH in THIS shell, setting it up first if needed.
+# Source it: `. dcc-env` (run as a plain command it would only change a child shell).
+# pip installs it beside dcc-patcher.
+if DCC_ENV=1 dcc-patcher install-shim --if-needed; then
+  _dcc_folder="$(dcc-patcher shellenv sh --folder)"
+  [ -n "$_dcc_folder" ] && export PATH="$_dcc_folder:$PATH"
+  unset _dcc_folder
+  dcc-patcher status --brief
+fi

dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env.cmd

@@ -0,0 +1,11 @@
+@echo off
+rem dcc-env: put the dcc-patcher launcher on PATH in THIS cmd window, setting it up first if needed.
+rem pip installs it beside dcc-patcher.exe. No setlocal: the PATH change has to outlive this script.
+set "DCC_ENV=1"
+dcc-patcher install-shim --if-needed
+set "DCC_ENV_CODE=%ERRORLEVEL%"
+set "DCC_ENV="
+if not "%DCC_ENV_CODE%"=="0" (set "DCC_ENV_CODE=" & exit /b 1)
+set "DCC_ENV_CODE="
+for /f "delims=" %%i in ('dcc-patcher shellenv cmd --folder') do set "PATH=%%i;%PATH%"
+dcc-patcher status --brief

dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env.ps1

@@ -0,0 +1,12 @@
+# dcc-env: put the dcc-patcher launcher on PATH in THIS PowerShell, setting it up first if needed.
+# pip installs it beside dcc-patcher.exe. $env:Path belongs to the whole PowerShell process, so the
+# change outlives this script. Needs an execution policy that runs local scripts (RemoteSigned or
+# looser); otherwise use: dcc-patcher shellenv powershell | Invoke-Expression
+$env:DCC_ENV = '1'
+dcc-patcher install-shim --if-needed
+$dccCode = $LASTEXITCODE
+Remove-Item Env:\DCC_ENV -ErrorAction SilentlyContinue
+if ($dccCode -ne 0) { return }
+$dccFolder = dcc-patcher shellenv powershell --folder
+if ($dccFolder) { $env:Path = "$dccFolder;" + $env:Path }
+dcc-patcher status --brief

dazzle_claude_code_patcher-0.2.0.dist-info/METADATA

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: dazzle-claude-code-patcher
+Version: 0.2.0
+Summary: Windows-first patch tool for the native Claude Code CLI: apply, verify and diagnose community patches across releases.
+Author-email: "Dustin Darcy (djdarcy)" <djdarcy@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/DazzleML/dazzle-claude-code-patcher
+Project-URL: Repository, https://github.com/DazzleML/dazzle-claude-code-patcher
+Project-URL: Issues, https://github.com/DazzleML/dazzle-claude-code-patcher/issues
+Keywords: claude-code,patcher,bun,windows,anthropic,cli
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# dazzle-claude-code-patcher
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-Windows%20(first)-lightgrey.svg)](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/docs/platform-support.md)
+
+> **Fix problematic Claude Code bugs in your local copy now, and keep the fixes working across updates.**
+
+`dcc-patcher` diagnoses, verifies, and applies patches to the native Claude Code CLI (`claude.exe`). When Claude Code updates (roughly every two days), one command tells you which patches re-apply as-is and which need attention, and shows exactly what changed. Once set up, `claude` runs the patched build and re-patches each update by itself.
+
+> [!NOTE]
+> **Pre-alpha, Windows only.** Five patches apply unchanged on every Claude Code build from 2.1.278 to 2.1.295. The history patch is in daily use: a resumed session scrolls back past every compaction, and the model still receives exactly the same request as stock Claude Code. See the [Roadmap](https://github.com/DazzleML/dazzle-claude-code-patcher/issues/1).
+
+## The Problem
+
+Some Claude Code bugs sit in code you can't configure around. For example, after a restart or `claude --resume`, everything before the last compaction disappears from the screen. It's still in the session file, but nothing brings it back. Waiting for an upstream improvement or fix can take a while, and patching by hand doesn't survive the next update (Claude Code is minified, so almost every internal name changes from one release to the next).
+
+## Patches
+
+| Patch | Fixes | Status |
+|---|---|---|
+| [History past compaction](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/dcc_patcher/patches/H-history-past-compaction/README.md) | After a restart or `--resume`, scroll back past compactions to the start of the session file | `check` passes on 2.1.278 to 2.1.295; live-tested on 2.1.289 to 2.1.295 |
+| [History across session files](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/dcc_patcher/patches/J-history-across-files/README.md) | A conversation that continued into a new session file (after running out of context, or a fork) scrolls back into the file it came from, and on to its first message. Needs the history patch. Derived from ojura/claude-patches' Patch J | `check` passes on 2.1.278 to 2.1.295; not yet live-tested |
+| [Version label](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/dcc_patcher/patches/V-version-label/patch.toml) | `--version` says it is a patched build and which patcher made it: `2.1.295 + dcc 0.1.11 (Dazzle Claude Code)`. Only the displayed text changes; the version Claude Code checks against is untouched | `check` passes on 2.1.278 to 2.1.295 |
+| Banner label ([classic](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/dcc_patcher/patches/B-banner-label/patch.toml), [flicker-free](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/dcc_patcher/patches/B2-banner-label-flicker-free/patch.toml)) | The header at the top of every session reads `Dazzle Claude Code v2.1.295 · dcc 0.1.11`, in both rendering modes. Only the drawn text changes | `check` passes on 2.1.278 to 2.1.295; flicker-free live-tested on 2.1.291 to 2.1.295 |
+
+> [!CAUTION]
+> **This project ships the tool and patch definitions only *NEVER* patched binaries.** You patch your own copy of Claude Code, locally. Use at your own risk. No warranty. Backup anything important first. I'd recommend: [claude-session-backup](https://github.com/DazzleML/Claude-Session-Backup).
+
+## Installation
+
+Python 3.11 or newer, and nothing else.
+
+```bash
+pip install dazzle-claude-code-patcher
+dcc-patcher validate             # lists the bundled patches
+```
+
+To work on it, install from source instead (`pip install -e ".[dev]"` in a clone). Builds then go to the checkout's `private\builds\` rather than `%LOCALAPPDATA%\dazzle-claude-code-patcher\builds\`.
+
+## Usage
+
+```bash
+# Does every patch still apply to this build? (read-only)
+dcc-patcher check %USERPROFILE%\.local\bin\claude.exe
+
+# Build a patched copy into the builds folder, with a lockfile recording every edit
+dcc-patcher apply %USERPROFILE%\.local\bin\claude.exe
+#   wrote <builds>\claude-dcc-2.1.295+dcc0.1.11.exe
+#     and <builds>\claude-dcc-2.1.295+dcc0.1.11.exe.dcc-lock.json
+#   <builds>\claude-dcc.exe -> claude-dcc-2.1.295+dcc0.1.11.exe (hardlink)
+
+# Run the patched copy instead of claude
+<builds>\claude-dcc.exe --resume
+```
+
+The official `claude.exe` is never modified. Older builds stay in the builds folder for rollback, and the original Claude Code each build was made from is kept beside it. After an update, `check` again; if an edit fails, nothing is written and `check --baseline` shows what changed. Where everything goes, and every option: [docs/launcher.md](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/docs/launcher.md).
+
+### Make the patched build just `claude`
+
+```bash
+dcc-env                         # cmd or PowerShell; in Git Bash: . dcc-env
+dcc-patcher status              # which claude this shell runs, and anything left to do
+```
+
+`dcc-env` exists because no program can change the `PATH` of the shell that started it: it's a small script that runs inside your shell, so it works in one that was already open. The first time, it writes `claude` and `claude-stock` shims and adds their folder to your user `PATH` (after asking, and after saving the old value as a `.reg` file). Every time, it puts that folder on the `PATH` of the shell you typed it in. Shells opened afterwards don't need it.
+
+From then on, `claude` runs the current patched build. When Claude Code updates, the next start says so, rebuilds in a few seconds, and runs the new build; if a patch no longer applies, it runs stock instead and says which patch needs attention. `claude-stock` always runs the official build; `dcc-patcher use stock` makes `claude` do the same; `dcc-patcher uninstall-shim` puts everything back. The details, including how to check or undo any of it by hand: [docs/launcher.md](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/docs/launcher.md).
+
+## How it works
+
+- **Patches are written by structure, not by exact text.** Each patch names a stable landmark (a string that survives builds), the shape of the code to change near it, and a replacement. Minified names are wildcards, captured once and reused by later edits. Measured on the 7 Claude Code builds from 2.1.278 to 2.1.289 (2026-09-19 to 10-03): the same edits written as exact text applied in full on only one build, while the structural patch applies unchanged on all seven.
+- **It fails closed.** Every edit must match exactly the number of times it expects, or nothing is written. The output is a new file beside the official `claude.exe`, never an in-place change, and everything except the patched module is verified byte-identical.
+- **It knows when to stop.** A patched module carries a signature, so a patch is never applied twice; and a patch can say how to recognise that Anthropic fixed the bug, so it reports *fixed upstream* instead of *broken*.
+- **It diagnoses.** When an edit no longer matches, `check` shows a diff of that code region against the last build where the patch worked, with minified names normalised so that only real code changes show.
+
+## Development
+
+```bash
+python -P -m pytest tests/ -v   # tests that need a local claude.exe are skipped without one
+bash scripts/repokit-common/install-hooks.sh   # version sync and pre-push checks
+```
+
+## Related Projects
+
+- [ojura/claude-patches](https://github.com/ojura/claude-patches): patches for the Claude Code VS Code extension, and the inspiration for this project's approach (structural matching, failing closed, byte-stable verification). This project is its Windows-first, native-CLI counterpart.
+- [claude-session-logger](https://github.com/DazzleML/claude-session-logger), [Claude-Session-Backup](https://github.com/DazzleML/Claude-Session-Backup), [claude-bookmarks](https://github.com/DazzleML/claude-bookmarks): other DazzleML Claude Code tools.
+
+## Disclaimer
+
+Not affiliated with or endorsed by Anthropic. Patching modifies your local copy of Claude Code and removes its code signature; use it at your own risk, and keep the official `claude.exe` in place.
+
+## License
+
+dazzle-claude-code-patcher, copyright (C) 2026 Dustin Darcy.
+
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/DazzleML/dazzle-claude-code-patcher/blob/main/LICENSE) file for details.

dazzle_claude_code_patcher-0.2.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env,sha256=OJDtJKF1x4EK_Aj0jiNsn-HJ7Sg7ivG8sDyJ0aXMbPA,438
+dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env.cmd,sha256=6pi7RgrPjMY0DOP9dwGtTB-U8_2UYl0XxsysDQzvR6s,520
+dazzle_claude_code_patcher-0.2.0.data/scripts/dcc-env.ps1,sha256=FKeL0fuyFH-_-IFqdvxx9S-ygod2gdBvaL27-np9GYs,693
+dazzle_claude_code_patcher-0.2.0.dist-info/licenses/LICENSE,sha256=DlZy6_97dpafvd_ObU8YNvyk5Gzk_qX070j7pKyDJBY,1069
+dcc_patcher/__init__.py,sha256=V46Q-K6E4TdmY02o4v6vY-hi_8JxyUK_N5OlLTP4WEs,147
+dcc_patcher/__main__.py,sha256=0nWgP61tL90yXqIEqaFluX3oUy2mAGWnxWG8Z6q_z9Y,129
+dcc_patcher/_version.py,sha256=zOHDXvnGbyJgqEHBFqGoKTIYQKk7OMEWmJ0sJhOS8Io,2805
+dcc_patcher/builds.py,sha256=N9UqJT98ITTosXb1iFjhq1AMHxFSwqvDCjjKxfvn4aE,3526
+dcc_patcher/cli.py,sha256=S3viS7c5sNmsYSRY9R-oQtjDO1sUcVbG8N6rl0k77uA,21169
+dcc_patcher/diagnose.py,sha256=dTW2JZhxWMy7k26FB6O75dm9iPybDQ-Xs2azygNXKBo,3175
+dcc_patcher/engine.py,sha256=XwBD-nSEDD4aoT3Pti8tLf0e1gf9X7wQAuIjIs8Z7yo,8372
+dcc_patcher/install.py,sha256=rDdLK5qFqCVpdD2CxBevgAjbMyRqoBe8nvYq8tfGAoA,24718
+dcc_patcher/launch.py,sha256=kHehry827BLmuPUfldyZ6zey9A65DGWq9wN1ASNsbVA,7559
+dcc_patcher/lock.py,sha256=lX43Ulsageh4NFAj6VXsRqP2NcD4Etj_NbROwdqBYs8,1850
+dcc_patcher/originals.py,sha256=Vhs2L6B5pWFGxNKqgcrzE6fgrg5pQR04zjADoJbZAlM,4409
+dcc_patcher/regfile.py,sha256=QhsLh0Kr2MHqgYSroRgDKyCeHS49wFkMKrsGKhMFNGA,2902
+dcc_patcher/resolve.py,sha256=qhDhBVTl4ZPdj-EE8Yne4c6nNYlaYsN3o3gJP7j24WU,1596
+dcc_patcher/spec.py,sha256=bFl98aCw18Z-Jw6F35fPo8SYdsSn2m-cYM41yvE8O3A,7193
+dcc_patcher/style.py,sha256=8kIFwjSCS7vKm0wB18PxmZNZDcXzhqM7Smeze31LeBg,2524
+dcc_patcher/winpath.py,sha256=Xgar7ozkIUDwHd3T5OvJJ-d0d29DA4DpXzZqvSRuPow,6025
+dcc_patcher/containers/__init__.py,sha256=vBHbRTWND7ra65bY5uSQCrD7OGUxZPkUEogBjlySDtQ,3114
+dcc_patcher/containers/pe.py,sha256=1MmsUb7MO2ttB8_IPxE1KFhn-Spxj6fJ4Q8s-mo1lqg,6740
+dcc_patcher/patches/B-banner-label/patch.toml,sha256=xlnQJJ34AGaiwvfOE5OGfqC_VnBTWzJrNzOB5Ri43Y0,1504
+dcc_patcher/patches/B2-banner-label-flicker-free/patch.toml,sha256=VlWDmQ2gQUo4arFickatBbdj-DqHT4iDLcgy0srHQoU,1319
+dcc_patcher/patches/H-history-past-compaction/README.md,sha256=5YWRmsqJHNHbdYVNPcSHMAMw0ggIEayn-dEp5cQnXFY,4432
+dcc_patcher/patches/H-history-past-compaction/patch.toml,sha256=FmlpR8aDFk5BMB923vWps04XGnyJADv1zIur53vUdnk,4221
+dcc_patcher/patches/J-history-across-files/README.md,sha256=GPj68XDk8hemVGwjzGluKK0f39pktLs2_AAQKqgaCbU,2714
+dcc_patcher/patches/J-history-across-files/patch.toml,sha256=H7FFCa0Y7w-zmnqSnXLDlR8ajwxJx6INyintswmZb5U,3652
+dcc_patcher/patches/V-version-label/patch.toml,sha256=kOZ2Aiw9Y4cdhc11_dKJ8bQ6VMmwGnxnqBZBRqeQxb0,934
+dcc_patcher/shims/claude.cmd.in,sha256=Z-3pgpbmZDxbZlftl5Ism-J-WjCmcc8LZhRbz9657Vg,194
+dcc_patcher/shims/claude.sh.in,sha256=uENxtkvIntZzaQNL3vMlEg3EHk3B05uWudC5J_s_Tog,172
+dazzle_claude_code_patcher-0.2.0.dist-info/METADATA,sha256=lZgwHFbnymyGLAxOJ24_T8Bg2ELlgSGtcbiyEJv3dkQ,10115
+dazzle_claude_code_patcher-0.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+dazzle_claude_code_patcher-0.2.0.dist-info/entry_points.txt,sha256=Wcemx_iFEhrwrmDCmDntyIYGqAbd-4oQucnX8TlmJdQ,53
+dazzle_claude_code_patcher-0.2.0.dist-info/top_level.txt,sha256=8pNEQQq0GOeIQdu9-8CHDtIPHmj9084IGB9lcj3Dre0,12
+dazzle_claude_code_patcher-0.2.0.dist-info/RECORD,,

dazzle_claude_code_patcher-0.2.0.dist-info/WHEEL

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

dazzle_claude_code_patcher-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dcc-patcher = dcc_patcher.cli:main

dazzle_claude_code_patcher-0.2.0.dist-info/licenses/LICENSE

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

dazzle_claude_code_patcher-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dcc_patcher

dcc_patcher/__init__.py

@@ -0,0 +1,2 @@
+"""dcc_patcher - apply, verify and diagnose patches to the native Claude Code CLI."""
+from ._version import __version__, __app_name__, PIP_VERSION

dcc_patcher/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running as: python -m dcc_patcher"""
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

dcc_patcher/_version.py

@@ -0,0 +1,92 @@
+"""
+Version information for dazzle-claude-code-patcher.
+
+This file is the canonical source for version numbers.
+The __version__ string is automatically updated by git hooks
+with build metadata (branch, build number, date, commit hash).
+
+Format: MAJOR.MINOR.PATCH[-PHASE]_BRANCH_BUILD-YYYYMMDD-COMMITHASH
+Example: 0.1.0_main_1-20260101-a1b2c3d4
+
+Version levels:
+  PROJECT_PHASE: Global project maturity (prealpha -> alpha -> beta -> stable).
+       Changes rarely, when the overall project hits a threshold.
+  PHASE:         Per-MINOR feature set maturity (alpha -> beta -> "" for stable).
+       Drops when a MINOR's feature set is complete.
+"""
+
+# Version components - edit these for version bumps
+MAJOR = 0
+MINOR = 2
+PATCH = 0
+PHASE = ""  # Per-MINOR feature set: "" (stable), "alpha", "beta", "rc1", etc.
+
+# Project-level phase (independent of version phase)
+PROJECT_PHASE = ""  # "prealpha", "alpha", "beta", "stable", or ""
+
+# Auto-updated by git hooks - do not edit manually
+__version__ = "0.2.0_main_17-20261009-e0aa8ec3"
+__app_name__ = "dazzle-claude-code-patcher"
+
+
+def get_version():
+    """Return the full version string including branch and build info."""
+    return __version__
+
+
+def get_base_version():
+    """Return the semantic version string (MAJOR.MINOR.PATCH[-PHASE])."""
+    if "_" in __version__:
+        return __version__.split("_")[0]
+    base = f"{MAJOR}.{MINOR}.{PATCH}"
+    if PHASE:
+        base = f"{base}-{PHASE}"
+    return base
+
+
+def get_display_version():
+    """Return a human-friendly version string with project phase.
+
+    Example: 'PREALPHA 0.1.0-alpha' or 'BETA 0.5.1' or '1.0.0'
+    """
+    base = get_base_version()
+    if PROJECT_PHASE and PROJECT_PHASE != "stable":
+        return f"{PROJECT_PHASE.upper()} {base}"
+    return base
+
+
+def get_pip_version():
+    """
+    Return PEP 440 compliant version for pip/setuptools.
+
+    Converts our version format to PEP 440:
+    - Main branch: 0.1.0_main_3-20260404-hash -> 0.1.0
+    - Dev branch: 0.1.0_dev_3-20260404-hash -> 0.1.0.dev3
+    - Alpha: 0.1.0-alpha_main_3 -> 0.1.0a0
+    """
+    base = f"{MAJOR}.{MINOR}.{PATCH}"
+
+    # Map phase to PEP 440 pre-release segment
+    phase_map = {"alpha": "a0", "beta": "b0"}
+    if PHASE:
+        base += phase_map.get(PHASE, PHASE)
+
+    if "_" not in __version__:
+        return base
+
+    parts = __version__.split("_")
+    branch = parts[1] if len(parts) > 1 else "unknown"
+
+    if branch == "main":
+        return base
+    else:
+        build_info = "_".join(parts[2:]) if len(parts) > 2 else ""
+        build_num = build_info.split("-")[0] if "-" in build_info else "0"
+        return f"{base}.dev{build_num}"
+
+
+# For convenience in imports
+VERSION = get_version()
+BASE_VERSION = get_base_version()
+PIP_VERSION = get_pip_version()
+DISPLAY_VERSION = get_display_version()

dcc_patcher/builds.py

@@ -0,0 +1,100 @@
+"""Where builds go and what they are called (#3).
+
+`apply` without `-o` writes `claude-dcc-<claude version>+dcc<patcher version><ext>`
+and its lockfile into one fixed builds folder, whatever folder it is run from,
+and points `claude-dcc<ext>` there at the newest build. The folder is
+`DCC_BUILDS_DIR` when set; `private/builds/` in the repository when the package
+runs from a checkout (djdarcy, 2026-10-07); otherwise a per-user data folder.
+
+Nothing is ever written inside Claude Code's own config folder (`~/.claude`, or
+`CLAUDE_CONFIG_DIR`): a relative `-o` run from there once put a 258 MB build
+into a folder kept under git (#3's comment).
+"""
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import sys
+from pathlib import Path
+
+from ._version import BASE_VERSION
+
+REPO = Path(__file__).resolve().parents[1]
+CURRENT = 'claude-dcc'
+
+
+def builds_dir() -> Path:
+    env = os.environ.get('DCC_BUILDS_DIR')
+    if env:
+        return Path(env).resolve()
+    if (REPO / '.git').exists():
+        return REPO / 'private' / 'builds'
+    if sys.platform == 'win32':
+        base = os.environ.get('LOCALAPPDATA') or os.path.expanduser('~/AppData/Local')
+    else:
+        base = os.environ.get('XDG_DATA_HOME') or os.path.expanduser('~/.local/share')
+    return Path(base) / 'dazzle-claude-code-patcher' / 'builds'
+
+
+def build_name(claude_version: str, suffix: str) -> str:
+    return f'{CURRENT}-{claude_version}+dcc{BASE_VERSION}{suffix}'
+
+
+def version_of(data: bytes) -> str:
+    """Claude Code's version, from the VERSION constant its bundle carries."""
+    m = re.search(rb'VERSION:"(\d+\.\d+\.\d+)"', data)
+    return m.group(1).decode() if m else 'unknown'
+
+
+def exe_suffix(path) -> str:
+    """'.exe' for a Windows build, '' otherwise -- also for the updater's
+    `claude.exe.old.<ms>` copies, whose last suffix is the timestamp."""
+    return '.exe' if '.exe' in Path(path).name.lower() else ''
+
+
+def posix_shim_dir() -> Path:
+    """Where the sh shims go on Windows: ~/bin, which Git for Windows puts first on
+    Git Bash's PATH (/etc/profile.d/env.sh) and Windows itself never searches. An
+    extensionless script in a folder on the Windows PATH is picked by resolvers that
+    try the bare name (Python 3.12.0's shutil.which), and CreateProcess can't run it."""
+    return Path(os.path.expanduser('~')) / 'bin'
+
+
+def config_dirs() -> list[Path]:
+    dirs = [Path(os.path.expanduser('~')) / '.claude']
+    if os.environ.get('CLAUDE_CONFIG_DIR'):
+        dirs.append(Path(os.environ['CLAUDE_CONFIG_DIR']))
+    return [d.resolve() for d in dirs]
+
+
+def inside_config(path) -> Path | None:
+    """The Claude Code config folder `path` would land in, or None."""
+    target = Path(path).resolve()
+    for d in config_dirs():
+        if target == d or d in target.parents:
+            return d
+    return None
+
+
+def point_current(build: Path) -> tuple[Path, str]:
+    """Make `<folder>/claude-dcc<ext>` the newest build: a hardlink, else a copy.
+
+    Returns (link path, 'hardlink' | 'copy'). Raises PermissionError when the
+    current build is running (Windows will not replace an exe in use)."""
+    link = build.with_name(CURRENT + build.suffix)
+    tmp = link.with_name(f'.dcc-{link.name}.tmp')
+    if tmp.exists():
+        tmp.unlink()
+    try:
+        os.link(build, tmp)
+        how = 'hardlink'
+    except OSError:
+        shutil.copyfile(build, tmp)
+        how = 'copy'
+    try:
+        os.replace(tmp, link)
+    except BaseException:
+        tmp.unlink()
+        raise
+    return link, how