agent-lineup 0.1.0__tar.gz

agent_lineup-0.1.0/LICENSE

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

agent_lineup-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: agent-lineup
+Version: 0.1.0
+Summary: See what your coding agent just changed, which edits are risky, and undo a file.
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+<p align="center"><img src="assets/lineup-logo.svg" alt="lineup logo" width="324"></p>
+
+# lineup
+
+`lineup` shows what your coding agent (Claude Code or Codex) just changed, flags the risky edits, and lets you undo a file.
+
+## Demo
+
+After the agent's reply, the hook prints a short line:
+
+```
+⚠ ≈ lineup: 2 HIGH
+  2 auth.py        auth or payment file changed
+  3 test_utils.py  assertion removed
+Undo: lineup rollback 2
+```
+
+`lineup risky` shows every changed file and the rule behind its score:
+
+```
+| ID | File          | Risk | Why (rule)                                  | Other           |
+| 1  | .env          | HIGH | .env or key file changed, contents not read | Can't roll back |
+| 2  | auth.py       | HIGH | auth or payment file changed                |                 |
+| 3  | test_utils.py | HIGH | assertion removed                           |                 |
+| 4  | utils.py      | LOW  | code edited, + function added: mul          |                 |
+```
+
+`lineup rollback 2` (or `lineup rollback auth.py`) puts the file back:
+
+```
+2   auth.py  restored
+Your versions from before this rollback are saved in .git/lineup/backups/2026-11-06_004042/.
+Also changed: .env (ID 1), test_utils.py (ID 3), utils.py (ID 4). Check whether they depend on this file.
+```
+
+## Install
+
+Needs Python 3.10 or newer, git, and [pipx](https://pipx.pypa.io).
+
+```
+pipx install git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup
+cd your-repo
+lineup init --agent claude
+```
+
+Use `--agent codex` if you use Codex, or leave `--agent` out for both.
+
+`lineup init` shows the hooks it will add and asks before writing. Then start a new Claude Code session. In Codex, run `/hooks` and trust the lineup hooks.
+
+- No pipx: `python -m pip install --user pipx`, then `python -m pipx ensurepath`, then open a new terminal.
+- No git: the install fails with "Cannot find command 'git'". Install git first.
+- Upgrade: `pipx upgrade agent-lineup`. If it says it's already up to date, run `pipx install --force git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup`.
+- Uninstall: run `lineup init --remove` in each repo first, then `pipx uninstall agent-lineup`. To delete lineup's saved data too, delete the `.git/lineup` folder in each repo.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `lineup init` | Adds the hooks for Claude Code (`.claude/settings.local.json`) and Codex (`.codex/hooks.json`). `--agent claude` or `--agent codex` picks one. `--remove` takes them out again. |
+| `lineup diff` | What changed since the session started, with a short AI summary. |
+| `lineup risky` | Scores each changed file HIGH, MED or LOW using fixed rules, and shows the rule. |
+| `lineup rollback 3 4` | Undoes files by ID or name. Your current version is backed up first. |
+| `lineup report` | Usage counts to send as tester feedback. No code or file names. |
+
+## What gets sent to the AI
+
+Only `lineup diff` uses AI. It sends the changed lines to the agent you already have (Claude Code with Haiku, or Codex), with no tools. Nothing goes anywhere else, and lineup needs no API key.
+
+- `.env`, key and credential files are never sent. They're listed by name only.
+- Lockfile contents are left out. Secret-looking text is hidden before sending.
+- The hooks, `risky`, `rollback` and `report` use no AI. They run only on your machine.
+- lineup keeps its photo, file copies and backups in `.git/lineup/` in your repo. Private files are kept as fingerprints only, never copied.
+
+## Run it in a second terminal
+
+You can run lineup with `!` in the same session (for example `! lineup risky`), but the agent may comment on the output. Its commentary isn't part of lineup's check: the scores come from fixed rules, not from the agent.
+
+To avoid this, open a second terminal in the same folder and run lineup there.
+
+## Known limits
+
+- **Claude Code is tested. Codex hooks aren't fully tested yet**, and you must trust them with `/hooks` before they run.
+- The secret scan can miss things. Don't rely on it alone.
+- Tested on Windows. Mac and Linux aren't tested yet.
+- Rollback can't undo private files, files over 10 MB, links, or changes that are already committed.
+- Scores come from simple rules, so expect some false flags.
+
+## Develop
+
+```
+pip install -e ".[dev]"
+pytest
+```
+
+Testers: [docs/testers.md](https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup/blob/main/docs/testers.md).

agent_lineup-0.1.0/README.md

@@ -0,0 +1,95 @@
+<p align="center"><img src="assets/lineup-logo.svg" alt="lineup logo" width="324"></p>
+
+# lineup
+
+`lineup` shows what your coding agent (Claude Code or Codex) just changed, flags the risky edits, and lets you undo a file.
+
+## Demo
+
+After the agent's reply, the hook prints a short line:
+
+```
+⚠ ≈ lineup: 2 HIGH
+  2 auth.py        auth or payment file changed
+  3 test_utils.py  assertion removed
+Undo: lineup rollback 2
+```
+
+`lineup risky` shows every changed file and the rule behind its score:
+
+```
+| ID | File          | Risk | Why (rule)                                  | Other           |
+| 1  | .env          | HIGH | .env or key file changed, contents not read | Can't roll back |
+| 2  | auth.py       | HIGH | auth or payment file changed                |                 |
+| 3  | test_utils.py | HIGH | assertion removed                           |                 |
+| 4  | utils.py      | LOW  | code edited, + function added: mul          |                 |
+```
+
+`lineup rollback 2` (or `lineup rollback auth.py`) puts the file back:
+
+```
+2   auth.py  restored
+Your versions from before this rollback are saved in .git/lineup/backups/2026-11-06_004042/.
+Also changed: .env (ID 1), test_utils.py (ID 3), utils.py (ID 4). Check whether they depend on this file.
+```
+
+## Install
+
+Needs Python 3.10 or newer, git, and [pipx](https://pipx.pypa.io).
+
+```
+pipx install git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup
+cd your-repo
+lineup init --agent claude
+```
+
+Use `--agent codex` if you use Codex, or leave `--agent` out for both.
+
+`lineup init` shows the hooks it will add and asks before writing. Then start a new Claude Code session. In Codex, run `/hooks` and trust the lineup hooks.
+
+- No pipx: `python -m pip install --user pipx`, then `python -m pipx ensurepath`, then open a new terminal.
+- No git: the install fails with "Cannot find command 'git'". Install git first.
+- Upgrade: `pipx upgrade agent-lineup`. If it says it's already up to date, run `pipx install --force git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup`.
+- Uninstall: run `lineup init --remove` in each repo first, then `pipx uninstall agent-lineup`. To delete lineup's saved data too, delete the `.git/lineup` folder in each repo.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `lineup init` | Adds the hooks for Claude Code (`.claude/settings.local.json`) and Codex (`.codex/hooks.json`). `--agent claude` or `--agent codex` picks one. `--remove` takes them out again. |
+| `lineup diff` | What changed since the session started, with a short AI summary. |
+| `lineup risky` | Scores each changed file HIGH, MED or LOW using fixed rules, and shows the rule. |
+| `lineup rollback 3 4` | Undoes files by ID or name. Your current version is backed up first. |
+| `lineup report` | Usage counts to send as tester feedback. No code or file names. |
+
+## What gets sent to the AI
+
+Only `lineup diff` uses AI. It sends the changed lines to the agent you already have (Claude Code with Haiku, or Codex), with no tools. Nothing goes anywhere else, and lineup needs no API key.
+
+- `.env`, key and credential files are never sent. They're listed by name only.
+- Lockfile contents are left out. Secret-looking text is hidden before sending.
+- The hooks, `risky`, `rollback` and `report` use no AI. They run only on your machine.
+- lineup keeps its photo, file copies and backups in `.git/lineup/` in your repo. Private files are kept as fingerprints only, never copied.
+
+## Run it in a second terminal
+
+You can run lineup with `!` in the same session (for example `! lineup risky`), but the agent may comment on the output. Its commentary isn't part of lineup's check: the scores come from fixed rules, not from the agent.
+
+To avoid this, open a second terminal in the same folder and run lineup there.
+
+## Known limits
+
+- **Claude Code is tested. Codex hooks aren't fully tested yet**, and you must trust them with `/hooks` before they run.
+- The secret scan can miss things. Don't rely on it alone.
+- Tested on Windows. Mac and Linux aren't tested yet.
+- Rollback can't undo private files, files over 10 MB, links, or changes that are already committed.
+- Scores come from simple rules, so expect some false flags.
+
+## Develop
+
+```
+pip install -e ".[dev]"
+pytest
+```
+
+Testers: [docs/testers.md](https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup/blob/main/docs/testers.md).

agent_lineup-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agent-lineup"
+version = "0.1.0"
+description = "See what your coding agent just changed, which edits are risky, and undo a file."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest"]
+
+[project.scripts]
+lineup = "lineup.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+lineup = ["lineup-banner.txt"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

agent_lineup-0.1.0/setup.cfg

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

agent_lineup-0.1.0/src/agent_lineup.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: agent-lineup
+Version: 0.1.0
+Summary: See what your coding agent just changed, which edits are risky, and undo a file.
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+<p align="center"><img src="assets/lineup-logo.svg" alt="lineup logo" width="324"></p>
+
+# lineup
+
+`lineup` shows what your coding agent (Claude Code or Codex) just changed, flags the risky edits, and lets you undo a file.
+
+## Demo
+
+After the agent's reply, the hook prints a short line:
+
+```
+⚠ ≈ lineup: 2 HIGH
+  2 auth.py        auth or payment file changed
+  3 test_utils.py  assertion removed
+Undo: lineup rollback 2
+```
+
+`lineup risky` shows every changed file and the rule behind its score:
+
+```
+| ID | File          | Risk | Why (rule)                                  | Other           |
+| 1  | .env          | HIGH | .env or key file changed, contents not read | Can't roll back |
+| 2  | auth.py       | HIGH | auth or payment file changed                |                 |
+| 3  | test_utils.py | HIGH | assertion removed                           |                 |
+| 4  | utils.py      | LOW  | code edited, + function added: mul          |                 |
+```
+
+`lineup rollback 2` (or `lineup rollback auth.py`) puts the file back:
+
+```
+2   auth.py  restored
+Your versions from before this rollback are saved in .git/lineup/backups/2026-11-06_004042/.
+Also changed: .env (ID 1), test_utils.py (ID 3), utils.py (ID 4). Check whether they depend on this file.
+```
+
+## Install
+
+Needs Python 3.10 or newer, git, and [pipx](https://pipx.pypa.io).
+
+```
+pipx install git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup
+cd your-repo
+lineup init --agent claude
+```
+
+Use `--agent codex` if you use Codex, or leave `--agent` out for both.
+
+`lineup init` shows the hooks it will add and asks before writing. Then start a new Claude Code session. In Codex, run `/hooks` and trust the lineup hooks.
+
+- No pipx: `python -m pip install --user pipx`, then `python -m pipx ensurepath`, then open a new terminal.
+- No git: the install fails with "Cannot find command 'git'". Install git first.
+- Upgrade: `pipx upgrade agent-lineup`. If it says it's already up to date, run `pipx install --force git+https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup`.
+- Uninstall: run `lineup init --remove` in each repo first, then `pipx uninstall agent-lineup`. To delete lineup's saved data too, delete the `.git/lineup` folder in each repo.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `lineup init` | Adds the hooks for Claude Code (`.claude/settings.local.json`) and Codex (`.codex/hooks.json`). `--agent claude` or `--agent codex` picks one. `--remove` takes them out again. |
+| `lineup diff` | What changed since the session started, with a short AI summary. |
+| `lineup risky` | Scores each changed file HIGH, MED or LOW using fixed rules, and shows the rule. |
+| `lineup rollback 3 4` | Undoes files by ID or name. Your current version is backed up first. |
+| `lineup report` | Usage counts to send as tester feedback. No code or file names. |
+
+## What gets sent to the AI
+
+Only `lineup diff` uses AI. It sends the changed lines to the agent you already have (Claude Code with Haiku, or Codex), with no tools. Nothing goes anywhere else, and lineup needs no API key.
+
+- `.env`, key and credential files are never sent. They're listed by name only.
+- Lockfile contents are left out. Secret-looking text is hidden before sending.
+- The hooks, `risky`, `rollback` and `report` use no AI. They run only on your machine.
+- lineup keeps its photo, file copies and backups in `.git/lineup/` in your repo. Private files are kept as fingerprints only, never copied.
+
+## Run it in a second terminal
+
+You can run lineup with `!` in the same session (for example `! lineup risky`), but the agent may comment on the output. Its commentary isn't part of lineup's check: the scores come from fixed rules, not from the agent.
+
+To avoid this, open a second terminal in the same folder and run lineup there.
+
+## Known limits
+
+- **Claude Code is tested. Codex hooks aren't fully tested yet**, and you must trust them with `/hooks` before they run.
+- The secret scan can miss things. Don't rely on it alone.
+- Tested on Windows. Mac and Linux aren't tested yet.
+- Rollback can't undo private files, files over 10 MB, links, or changes that are already committed.
+- Scores come from simple rules, so expect some false flags.
+
+## Develop
+
+```
+pip install -e ".[dev]"
+pytest
+```
+
+Testers: [docs/testers.md](https://github.com/HARSHAVARDHAN-RAJU5/agent-lineup/blob/main/docs/testers.md).

agent_lineup-0.1.0/src/agent_lineup.egg-info/SOURCES.txt

@@ -0,0 +1,53 @@
+LICENSE
+README.md
+pyproject.toml
+src/agent_lineup.egg-info/PKG-INFO
+src/agent_lineup.egg-info/SOURCES.txt
+src/agent_lineup.egg-info/dependency_links.txt
+src/agent_lineup.egg-info/entry_points.txt
+src/agent_lineup.egg-info/requires.txt
+src/agent_lineup.egg-info/top_level.txt
+src/lineup/__init__.py
+src/lineup/__main__.py
+src/lineup/banner.py
+src/lineup/changes.py
+src/lineup/cli.py
+src/lineup/functions.py
+src/lineup/git.py
+src/lineup/guard.py
+src/lineup/hookjson.py
+src/lineup/hooks.py
+src/lineup/lineup-banner.txt
+src/lineup/llm.py
+src/lineup/paths.py
+src/lineup/rollback.py
+src/lineup/rules.py
+src/lineup/snapshot.py
+src/lineup/store.py
+src/lineup/summary.py
+src/lineup/table.py
+tests/test_ai_input.py
+tests/test_banner.py
+tests/test_changes.py
+tests/test_cli.py
+tests/test_commits.py
+tests/test_compare_photo.py
+tests/test_diff_ai.py
+tests/test_functions.py
+tests/test_git.py
+tests/test_hooks.py
+tests/test_hooks_init.py
+tests/test_llm.py
+tests/test_output_fixes.py
+tests/test_private_copies.py
+tests/test_redact.py
+tests/test_report.py
+tests/test_rollback.py
+tests/test_rollback_safety.py
+tests/test_rules.py
+tests/test_session_start.py
+tests/test_snapshot.py
+tests/test_store.py
+tests/test_summary.py
+tests/test_symlinks.py
+tests/test_table.py

agent_lineup-0.1.0/src/agent_lineup.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agent_lineup-0.1.0/src/agent_lineup.egg-info/entry_points.txt

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

agent_lineup-0.1.0/src/agent_lineup.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[dev]
+pytest

agent_lineup-0.1.0/src/agent_lineup.egg-info/top_level.txt

@@ -0,0 +1 @@
+lineup

agent_lineup-0.1.0/src/lineup/__init__.py

@@ -0,0 +1,3 @@
+"""lineup: see what your coding agent just changed, flag risky edits, undo a file."""
+
+__version__ = "0.1.0"

agent_lineup-0.1.0/src/lineup/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from lineup.cli import main
+
+sys.exit(main())

agent_lineup-0.1.0/src/lineup/banner.py

@@ -0,0 +1,70 @@
+"""The lineup banner, for the user's own terminal only (init, --version, no command).
+
+Never printed by hooks, diff, risky or rollback, so nothing the agent reads ever contains it.
+"""
+
+import os
+import sys
+from importlib import resources
+
+BLUE = "\x1b[38;2;111;140;216m"  # #6F8CD8, readable on dark terminals
+BLUE_256 = "\x1b[38;5;68m"  # nearest 256-colour shade, for terminals without 24-bit colour
+RESET = "\x1b[0m"
+
+
+def text():
+    return resources.files("lineup").joinpath("lineup-banner.txt").read_text(encoding="utf-8")
+
+
+def _windows_colour_on(stream):
+    """Turn on colour codes in a Windows console. False if it can't be done."""
+    try:
+        import ctypes
+        import msvcrt
+        handle = msvcrt.get_osfhandle(stream.fileno())
+        kernel32 = ctypes.windll.kernel32
+        mode = ctypes.c_uint32()
+        if not kernel32.GetConsoleMode(handle, ctypes.byref(mode)):
+            return False
+        return bool(mode.value & 0x0004 or kernel32.SetConsoleMode(handle, mode.value | 0x0004))
+    except (AttributeError, OSError, ValueError, ImportError):
+        return False
+
+
+def colour(stream):
+    """The colour code to use, or "" for plain text."""
+    if "NO_COLOR" in os.environ or os.environ.get("TERM") == "dumb":
+        return ""
+    if not is_terminal(stream):
+        return ""
+    if sys.platform == "win32":
+        return BLUE if _windows_colour_on(stream) else ""
+    if os.environ.get("COLORTERM", "").lower() in ("truecolor", "24bit"):
+        return BLUE
+    return BLUE_256
+
+
+def is_terminal(stream):
+    try:
+        return stream.isatty()
+    except (AttributeError, ValueError):
+        return False
+
+
+def show(stream=None):
+    """Print the banner, only to a real terminal (piped or redirected output gets none)."""
+    stream = stream or sys.stdout
+    if not is_terminal(stream):
+        return
+    banner = text()
+    code = colour(stream)
+    if code:
+        banner = code + banner.rstrip("\n") + RESET + "\n"
+    try:
+        stream.write(banner)
+    except UnicodeEncodeError:  # e.g. piped output on Windows: send the exact UTF-8 bytes
+        stream.flush()
+        stream.buffer.write(banner.encode("utf-8"))
+        stream.buffer.flush()
+    stream.write("\n")
+    stream.flush()