devin-switch 0.1.0__tar.gz

devin_switch-0.1.0/LICENSE

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

devin_switch-0.1.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: devin-switch
+Version: 0.1.0
+Summary: Switch between Devin configuration profiles (hooks, MCP, models) with snapshot and verification.
+Author: Icaro0310
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# devin-switch — MOVED
+
+**This repository was absorbed into the
+[`devin-control`](https://github.com/Icaro0310/devin-control) monorepo.**
+
+The code now lives at `packages/switch/`. `pip install devin-switch` / `uv tool install devin-switch` still installs the same package, now released from devin-control.
+
+```bash
+# development moved
+git clone https://github.com/Icaro0310/devin-control
+cd devin-control/packages/switch
+```
+
+The repository is archived; open issues and PRs belong to devin-control.
+History remains readable here for reference.
+
+</div>
+
+---
+
+<details>
+<summary>Original README (pre-archive)</summary>
+
+<div align="center">
+
+<a href="https://github.com/Icaro0310/devin-switch/actions/workflows/ci.yml"><img src="https://github.com/Icaro0310/devin-switch/actions/workflows/ci.yml/badge.svg" alt="ci"/></a>
+
+<a href="https://scorecard.dev/viewer/?uri=github.com/Icaro0310/devin-switch"><img src="https://api.scorecard.dev/projects/github.com/Icaro0310/devin-switch/badge" alt="OpenSSF Scorecard"/></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"/></a>
+<a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+"/></a>
+<a href="https://github.com/Icaro0310/devin-switch"><img src="https://img.shields.io/github/stars/Icaro0310/devin-switch" alt="GitHub stars"/></a>
+<a href="https://github.com/Icaro0310/devin-switch/commits/main"><img src="https://img.shields.io/github/last-commit/Icaro0310/devin-switch" alt="Last commit"/></a>
+<a href="https://github.com/Icaro0310/awesome-devin"><img src="https://img.shields.io/badge/part%20of-devin--*-ecosystem-7c3aed" alt="devin-* ecosystem"/></a>
+<a href="https://github.com/Icaro0310/devin-switch/issues"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"/></a>
+</div>
+
+<!-- DEVIN-ECO:BEGIN -->
+> **Part of the [DEVIN ecosystem](https://github.com/Icaro0310/awesome-devin)**  
+> Track: Control · Nature: product  
+> For: Operations, Maintainers  
+> Interface: CLI
+<!-- DEVIN-ECO:END -->
+
+
+# devin-switch
+
+> **Unofficial community project.** Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.
+
+**[Linux](README.linux.md)** · **[Personal Windows](README.windows.md)** · **[Corporate Windows](README.corporate-windows.md)**
+
+Part of the [awesome-devin](https://github.com/Icaro0310/awesome-devin) ecosystem: the curated hub for the devin-* tools.
+
+`devin-switch` swaps between named **Devin configuration profiles** —
+hooks, MCP servers, models, cascade rules, UI settings — with a verified
+snapshot before every write and a journal you can roll back from.
+**Dry-run by default**: nothing is ever written unless you pass
+`--apply`.
+
+## The problem
+
+Devin's behaviour lives in a handful of JSONC files spread across two
+roots: `config.json` + `mcp_config.json` under the **data dir**
+(`~/.config/devin`, `%APPDATA%/devin`) and `User/settings.json` under the
+**UI config dir** (`~/.config/Devin`, `%APPDATA%/Devin`). Wanting a
+locked-down "work" setup and a permissive "personal" setup means editing
+the same files back and forth — by hand, with no undo.
+
+`devin-switch` treats each variant as a declarative overlay directory and
+does the swap safely.
+
+## Safety model
+
+- **Dry-run by default** — `use` and `rollback` print a masked plan and
+  write *nothing* (not even the journal) without `--apply`.
+- **Verified snapshot** — before any write, every file about to change is
+  copied into `.devin-ecosystem/switch-backups/<ts>/` with a sha256
+  manifest. The copies are re-hashed *and* compared against the live
+  sources; any mismatch aborts before a single byte is written.
+- **Atomic writes** — sibling tmp file + `os.replace`; no half-written
+  config.
+- **`credentials.toml` is never touched** — not read, not written, not
+  even opened for a hash. A profile that ships one gets a `skip`.
+- **Secrets masked in all output** — credential-named files
+  (`.env*`, `*.pem`, `*secret*`, …) never have contents printed; inside
+  printable files, values under sensitive key names (`token`, `secret`,
+  `password`, `api_key`, `auth`…) or that look like tokens (long alnum
+  blobs, JWTs, `sk-`/`ghp_`/`xox` prefixes) render as `<redacted>`.
+- **No network** — stdlib only, Python ≥ 3.10.
+
+## Install
+
+Requires Python ≥ 3.10 and `pipx` or `uv`. Per-OS setup lives in the platform guides: [Linux](README.linux.md) · [Personal Windows](README.windows.md) · [Corporate Windows](README.corporate-windows.md).
+
+<!-- DIST-STATUS:BEGIN — generated from devin-powerups/registry.json -->
+> **Source-only distribution.** This tool is not yet published to PyPI.
+> Install from source:
+>
+> ```bash
+> pipx install git+https://github.com/Icaro0310/devin-switch.git
+> # or
+> uv tool install git+https://github.com/Icaro0310/devin-switch.git
+> ```
+<!-- DIST-STATUS:END -->
+
+## Usage
+
+```bash
+devin-switch list                       # discovered profiles
+devin-switch show personal              # what a profile manages (keys, not values)
+devin-switch diff corporate personal    # masked diff between two profiles
+devin-switch use personal               # DRY-RUN: masked per-file plan
+devin-switch use personal --apply       # snapshot → verify → write → journal
+devin-switch rollback                   # DRY-RUN: what would be restored
+devin-switch rollback --apply           # restore the last verified backup
+devin-switch doctor                     # config sanity + closest profile
+```
+
+Every command accepts `--data-dir`, `--config-dir` and `--profiles-dir`
+to override the platform defaults (`--config-dir` falls back to
+`--data-dir` for single-root layouts). The profiles dir resolves in
+order: `--profiles-dir` → `$DEVIN_SWITCH_PROFILES_DIR` → `./profiles` →
+the bundled examples.
+
+Exit code is `0` on success/clean dry-run and `1` on errors — and for
+`doctor`, on any `FAIL` check (like `devin-doctor`).
+
+## Profiles
+
+A profile is a directory under `profiles/` whose files map 1:1 onto the
+managed config space — see [`profiles/README.md`](profiles/README.md):
+
+```
+profiles/
+  corporate/
+    profile.json          # metadata only — never copied
+    config.json           # → <data-dir>/config.json
+    mcp_config.json       # → <data-dir>/mcp_config.json
+    User/settings.json    # → <config-dir>/User/settings.json
+  personal/
+    ...
+```
+
+Overlays are **whole-file replacements**, not merges — what the profile
+ships is what the file becomes. Files are JSONC: `//` and `/* */`
+comments allowed, trailing commas not.
+
+### The `lab` profile (G3 A/B runs)
+
+`profiles/lab/` is a hermetic config for A/B skill evaluation: a pinned
+model — `SWE-2-High` (free tier as of 2026-10-04), the same id in
+`config.json`, `User/settings.json` and `profile.json`, **no hooks
+and no MCP servers at all** — deliberate, since learning-loop /
+prompt-logging hooks and the memory MCP would let attempt n learn from
+attempt n-1 — plus `autoGenerateMemories` off. Label sessions `g3-ab`.
+Caveat: it is still unconfirmed whether Devin can isolate the config dir
+per workspace; if it can't, run attempts **serially** and let
+`devin-switch` swap `lab` in/out between them (`rollback` restores the
+previous bytes exactly). See `profiles/README.md`.
+
+## What happens on `--apply`
+
+1. **Plan** — per file: `create` / `modify` / `unchanged` / `skip`
+   (`credentials.toml`, unsafe paths).
+2. **Snapshot** — pre-switch bytes copied to
+   `~/.config/Devin/.devin-ecosystem/switch-backups/<timestamp>/` with a
+   `manifest.json` recording sha256 per file (`existed: false` for files
+   the switch would create).
+3. **Verify** — every copy must hash to its recorded sha256 *and* still
+   match the live source (catches a mid-switch edit). Any problem →
+   abort, nothing written, backup kept as evidence.
+4. **Write** — atomic tmp+rename per file.
+5. **Journal** — one JSON line appended to
+   `.devin-ecosystem/switch-journal.jsonl`:
+   `{ts, action, profile, files_changed, backup_dir}`.
+
+`rollback` reads the newest `use` entry whose backup still exists,
+restores the snapshot (and deletes files the switch created), then
+appends a `rollback` entry — the backup is *not* consumed, so you can
+switch forward again afterwards.
+
+## Development
+
+```bash
+python -m pytest            # 62 tests, all on synthetic tmp-dir fixtures
+python -m devin_switch.cli doctor --profiles-dir profiles
+```
+
+The test suite runs entirely against fake Devin roots — no real
+installation is touched, and `credentials.toml` fixtures are only ever
+checked by digest.
+
+## Related
+
+- [`devin-doctor`](https://github.com/Icaro0310/devin-explore) — diagnoses
+  a Devin installation (read-only, always); `devin-switch doctor` covers
+  the config-file corner of that space, inline, with no dependency.
+
+</details>

devin_switch-0.1.0/README.md

@@ -0,0 +1,201 @@
+<div align="center">
+
+# devin-switch — MOVED
+
+**This repository was absorbed into the
+[`devin-control`](https://github.com/Icaro0310/devin-control) monorepo.**
+
+The code now lives at `packages/switch/`. `pip install devin-switch` / `uv tool install devin-switch` still installs the same package, now released from devin-control.
+
+```bash
+# development moved
+git clone https://github.com/Icaro0310/devin-control
+cd devin-control/packages/switch
+```
+
+The repository is archived; open issues and PRs belong to devin-control.
+History remains readable here for reference.
+
+</div>
+
+---
+
+<details>
+<summary>Original README (pre-archive)</summary>
+
+<div align="center">
+
+<a href="https://github.com/Icaro0310/devin-switch/actions/workflows/ci.yml"><img src="https://github.com/Icaro0310/devin-switch/actions/workflows/ci.yml/badge.svg" alt="ci"/></a>
+
+<a href="https://scorecard.dev/viewer/?uri=github.com/Icaro0310/devin-switch"><img src="https://api.scorecard.dev/projects/github.com/Icaro0310/devin-switch/badge" alt="OpenSSF Scorecard"/></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"/></a>
+<a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+"/></a>
+<a href="https://github.com/Icaro0310/devin-switch"><img src="https://img.shields.io/github/stars/Icaro0310/devin-switch" alt="GitHub stars"/></a>
+<a href="https://github.com/Icaro0310/devin-switch/commits/main"><img src="https://img.shields.io/github/last-commit/Icaro0310/devin-switch" alt="Last commit"/></a>
+<a href="https://github.com/Icaro0310/awesome-devin"><img src="https://img.shields.io/badge/part%20of-devin--*-ecosystem-7c3aed" alt="devin-* ecosystem"/></a>
+<a href="https://github.com/Icaro0310/devin-switch/issues"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"/></a>
+</div>
+
+<!-- DEVIN-ECO:BEGIN -->
+> **Part of the [DEVIN ecosystem](https://github.com/Icaro0310/awesome-devin)**  
+> Track: Control · Nature: product  
+> For: Operations, Maintainers  
+> Interface: CLI
+<!-- DEVIN-ECO:END -->
+
+
+# devin-switch
+
+> **Unofficial community project.** Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.
+
+**[Linux](README.linux.md)** · **[Personal Windows](README.windows.md)** · **[Corporate Windows](README.corporate-windows.md)**
+
+Part of the [awesome-devin](https://github.com/Icaro0310/awesome-devin) ecosystem: the curated hub for the devin-* tools.
+
+`devin-switch` swaps between named **Devin configuration profiles** —
+hooks, MCP servers, models, cascade rules, UI settings — with a verified
+snapshot before every write and a journal you can roll back from.
+**Dry-run by default**: nothing is ever written unless you pass
+`--apply`.
+
+## The problem
+
+Devin's behaviour lives in a handful of JSONC files spread across two
+roots: `config.json` + `mcp_config.json` under the **data dir**
+(`~/.config/devin`, `%APPDATA%/devin`) and `User/settings.json` under the
+**UI config dir** (`~/.config/Devin`, `%APPDATA%/Devin`). Wanting a
+locked-down "work" setup and a permissive "personal" setup means editing
+the same files back and forth — by hand, with no undo.
+
+`devin-switch` treats each variant as a declarative overlay directory and
+does the swap safely.
+
+## Safety model
+
+- **Dry-run by default** — `use` and `rollback` print a masked plan and
+  write *nothing* (not even the journal) without `--apply`.
+- **Verified snapshot** — before any write, every file about to change is
+  copied into `.devin-ecosystem/switch-backups/<ts>/` with a sha256
+  manifest. The copies are re-hashed *and* compared against the live
+  sources; any mismatch aborts before a single byte is written.
+- **Atomic writes** — sibling tmp file + `os.replace`; no half-written
+  config.
+- **`credentials.toml` is never touched** — not read, not written, not
+  even opened for a hash. A profile that ships one gets a `skip`.
+- **Secrets masked in all output** — credential-named files
+  (`.env*`, `*.pem`, `*secret*`, …) never have contents printed; inside
+  printable files, values under sensitive key names (`token`, `secret`,
+  `password`, `api_key`, `auth`…) or that look like tokens (long alnum
+  blobs, JWTs, `sk-`/`ghp_`/`xox` prefixes) render as `<redacted>`.
+- **No network** — stdlib only, Python ≥ 3.10.
+
+## Install
+
+Requires Python ≥ 3.10 and `pipx` or `uv`. Per-OS setup lives in the platform guides: [Linux](README.linux.md) · [Personal Windows](README.windows.md) · [Corporate Windows](README.corporate-windows.md).
+
+<!-- DIST-STATUS:BEGIN — generated from devin-powerups/registry.json -->
+> **Source-only distribution.** This tool is not yet published to PyPI.
+> Install from source:
+>
+> ```bash
+> pipx install git+https://github.com/Icaro0310/devin-switch.git
+> # or
+> uv tool install git+https://github.com/Icaro0310/devin-switch.git
+> ```
+<!-- DIST-STATUS:END -->
+
+## Usage
+
+```bash
+devin-switch list                       # discovered profiles
+devin-switch show personal              # what a profile manages (keys, not values)
+devin-switch diff corporate personal    # masked diff between two profiles
+devin-switch use personal               # DRY-RUN: masked per-file plan
+devin-switch use personal --apply       # snapshot → verify → write → journal
+devin-switch rollback                   # DRY-RUN: what would be restored
+devin-switch rollback --apply           # restore the last verified backup
+devin-switch doctor                     # config sanity + closest profile
+```
+
+Every command accepts `--data-dir`, `--config-dir` and `--profiles-dir`
+to override the platform defaults (`--config-dir` falls back to
+`--data-dir` for single-root layouts). The profiles dir resolves in
+order: `--profiles-dir` → `$DEVIN_SWITCH_PROFILES_DIR` → `./profiles` →
+the bundled examples.
+
+Exit code is `0` on success/clean dry-run and `1` on errors — and for
+`doctor`, on any `FAIL` check (like `devin-doctor`).
+
+## Profiles
+
+A profile is a directory under `profiles/` whose files map 1:1 onto the
+managed config space — see [`profiles/README.md`](profiles/README.md):
+
+```
+profiles/
+  corporate/
+    profile.json          # metadata only — never copied
+    config.json           # → <data-dir>/config.json
+    mcp_config.json       # → <data-dir>/mcp_config.json
+    User/settings.json    # → <config-dir>/User/settings.json
+  personal/
+    ...
+```
+
+Overlays are **whole-file replacements**, not merges — what the profile
+ships is what the file becomes. Files are JSONC: `//` and `/* */`
+comments allowed, trailing commas not.
+
+### The `lab` profile (G3 A/B runs)
+
+`profiles/lab/` is a hermetic config for A/B skill evaluation: a pinned
+model — `SWE-2-High` (free tier as of 2026-10-04), the same id in
+`config.json`, `User/settings.json` and `profile.json`, **no hooks
+and no MCP servers at all** — deliberate, since learning-loop /
+prompt-logging hooks and the memory MCP would let attempt n learn from
+attempt n-1 — plus `autoGenerateMemories` off. Label sessions `g3-ab`.
+Caveat: it is still unconfirmed whether Devin can isolate the config dir
+per workspace; if it can't, run attempts **serially** and let
+`devin-switch` swap `lab` in/out between them (`rollback` restores the
+previous bytes exactly). See `profiles/README.md`.
+
+## What happens on `--apply`
+
+1. **Plan** — per file: `create` / `modify` / `unchanged` / `skip`
+   (`credentials.toml`, unsafe paths).
+2. **Snapshot** — pre-switch bytes copied to
+   `~/.config/Devin/.devin-ecosystem/switch-backups/<timestamp>/` with a
+   `manifest.json` recording sha256 per file (`existed: false` for files
+   the switch would create).
+3. **Verify** — every copy must hash to its recorded sha256 *and* still
+   match the live source (catches a mid-switch edit). Any problem →
+   abort, nothing written, backup kept as evidence.
+4. **Write** — atomic tmp+rename per file.
+5. **Journal** — one JSON line appended to
+   `.devin-ecosystem/switch-journal.jsonl`:
+   `{ts, action, profile, files_changed, backup_dir}`.
+
+`rollback` reads the newest `use` entry whose backup still exists,
+restores the snapshot (and deletes files the switch created), then
+appends a `rollback` entry — the backup is *not* consumed, so you can
+switch forward again afterwards.
+
+## Development
+
+```bash
+python -m pytest            # 62 tests, all on synthetic tmp-dir fixtures
+python -m devin_switch.cli doctor --profiles-dir profiles
+```
+
+The test suite runs entirely against fake Devin roots — no real
+installation is touched, and `credentials.toml` fixtures are only ever
+checked by digest.
+
+## Related
+
+- [`devin-doctor`](https://github.com/Icaro0310/devin-explore) — diagnoses
+  a Devin installation (read-only, always); `devin-switch doctor` covers
+  the config-file corner of that space, inline, with no dependency.
+
+</details>

devin_switch-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devin-switch"
+version = "0.1.0"
+description = "Switch between Devin configuration profiles (hooks, MCP, models) with snapshot and verification."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Icaro0310" }]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.scripts]
+devin-switch = "devin_switch.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+devin_switch = ["profiles/**"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

devin_switch-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

devin_switch-0.1.0/src/devin_switch/__init__.py

@@ -0,0 +1,12 @@
+"""devin-switch — switch between Devin configuration profiles.
+
+Manages the config files in the Devin config/data dirs (``User/settings.json``,
+``config.json`` hooks, ``mcp_config.json`` MCP entries) as declarative
+profiles, with verified snapshots before any write and a rollback journal.
+
+``credentials.toml`` is never touched — not even read.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"