align-agent 0.4.3__tar.gz → 0.4.4__tar.gz

{align_agent-0.4.3 → align_agent-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: align-agent
-Version: 0.4.3
+Version: 0.4.4
 Summary: Find edits a coding agent made against a stale view of a file, and keep agents' views current with a write-through hook (Claude Code, any hook system, any MCP client, mini-swe-agent)
 License: MIT License
         
@@ -51,11 +51,11 @@ engine uses only the standard library.
 ### 1. Install the commands
 
 ```bash
-pipx install git+https://github.com/VA24d/align-agent@v0.4.3      # recommended: its own environment, commands on PATH
+pipx install align-agent                      # recommended: its own environment, commands on PATH
 # or, in a virtual environment:
-python3 -m venv ~/.align && ~/.align/bin/pip install git+https://github.com/VA24d/align-agent@v0.4.3
+python3 -m venv ~/.align && ~/.align/bin/pip install align-agent
 export PATH="$HOME/.align/bin:$PATH"                                 # add this line to ~/.zshrc or ~/.bashrc
-align-agent --version                                                # prints: align-agent 0.4.3
+align-agent --version                                                # prints: align-agent 0.4.4
 ```
 
 If the shell says `command not found: align-agent`, the install folder is not on `PATH`: run
@@ -130,7 +130,7 @@ the command once and shows those lines. Nothing earlier in the conversation is r
 prompt cache is kept.
 
 ```bash
-pip install git+https://github.com/VA24d/align-agent@v0.4.3   # the write-through engine itself uses only the standard library
+pip install align-agent   # the write-through engine itself uses only the standard library
 ```
 
 | Agent | Set up |
@@ -151,21 +151,22 @@ deleted after each call, and sessions idle for 7 days are deleted (`ALIGN_KEEP_D
 ## Find stale edits in trajectories
 
 ```bash
-pip install git+https://github.com/VA24d/align-agent@v0.4.3
-align-agent analyze examples/teleport_control.json examples/teleport_diff.json
+pip install align-agent
+align-agent analyze --examples        # the two example trajectories bundled with the package
+align-agent examples                  # where they are, to open or copy
 ```
 
 Or, with nothing to install or build (image for amd64 and arm64, examples included):
 
 ```bash
-docker run --rm ghcr.io/va24d/align-agent:0.4.3 analyze /opt/align-agent/examples/teleport_control.json
-docker run --rm -v "$PWD:/work" ghcr.io/va24d/align-agent:0.4.3 analyze /work/my_trajectories/
+docker run --rm ghcr.io/va24d/align-agent:0.4.4 analyze /opt/align-agent/examples/teleport_control.json
+docker run --rm -v "$PWD:/work" ghcr.io/va24d/align-agent:0.4.4 analyze /work/my_trajectories/
 ```
 
 ## `align-agent analyze`
 
 ```
-align-agent analyze PATH [PATH ...] [--format F] [--cwd DIR] [--json OUT] [--quiet]
+align-agent analyze [PATH ...] [--examples] [--format F] [--cwd DIR] [--json OUT] [--quiet] [-j N]
 ```
 
 Reads trajectory files, or directories of them. The format is detected:
@@ -206,7 +207,7 @@ align-agent run --repo DIR --task TEXT_OR_FILE --model NAME --base-url URL \
                [--arm control|viewport|diff|lean|dependency] [--image IMAGE] [--out trajectory.json]
 ```
 
-Needs the `[run]` extra: `pip install 'align-agent[run] @ git+https://github.com/VA24d/align-agent@v0.4.3'`. Runs mini-swe-agent 2.4.6 against any OpenAI-compatible endpoint. The API key is read from `$OPENAI_API_KEY`, or from the variable that `--api-key-env` names. After each command, the hook finds the files the command changed by content hash and appends one of these to that command's output:
+Needs the `[run]` extra: `pip install 'align-agent[run]'`. Runs mini-swe-agent 2.4.6 against any OpenAI-compatible endpoint. The API key is read from `$OPENAI_API_KEY`, or from the variable that `--api-key-env` names. After each command, the hook finds the files the command changed by content hash and appends one of these to that command's output:
 
 - `viewport`: a numbered window around each change.
 - `diff`: the net diff since the agent last saw the file.

{align_agent-0.4.3 → align_agent-0.4.4}/README.md

@@ -14,11 +14,11 @@ engine uses only the standard library.
 ### 1. Install the commands
 
 ```bash
-pipx install git+https://github.com/VA24d/align-agent@v0.4.3      # recommended: its own environment, commands on PATH
+pipx install align-agent                      # recommended: its own environment, commands on PATH
 # or, in a virtual environment:
-python3 -m venv ~/.align && ~/.align/bin/pip install git+https://github.com/VA24d/align-agent@v0.4.3
+python3 -m venv ~/.align && ~/.align/bin/pip install align-agent
 export PATH="$HOME/.align/bin:$PATH"                                 # add this line to ~/.zshrc or ~/.bashrc
-align-agent --version                                                # prints: align-agent 0.4.3
+align-agent --version                                                # prints: align-agent 0.4.4
 ```
 
 If the shell says `command not found: align-agent`, the install folder is not on `PATH`: run
@@ -93,7 +93,7 @@ the command once and shows those lines. Nothing earlier in the conversation is r
 prompt cache is kept.
 
 ```bash
-pip install git+https://github.com/VA24d/align-agent@v0.4.3   # the write-through engine itself uses only the standard library
+pip install align-agent   # the write-through engine itself uses only the standard library
 ```
 
 | Agent | Set up |
@@ -114,21 +114,22 @@ deleted after each call, and sessions idle for 7 days are deleted (`ALIGN_KEEP_D
 ## Find stale edits in trajectories
 
 ```bash
-pip install git+https://github.com/VA24d/align-agent@v0.4.3
-align-agent analyze examples/teleport_control.json examples/teleport_diff.json
+pip install align-agent
+align-agent analyze --examples        # the two example trajectories bundled with the package
+align-agent examples                  # where they are, to open or copy
 ```
 
 Or, with nothing to install or build (image for amd64 and arm64, examples included):
 
 ```bash
-docker run --rm ghcr.io/va24d/align-agent:0.4.3 analyze /opt/align-agent/examples/teleport_control.json
-docker run --rm -v "$PWD:/work" ghcr.io/va24d/align-agent:0.4.3 analyze /work/my_trajectories/
+docker run --rm ghcr.io/va24d/align-agent:0.4.4 analyze /opt/align-agent/examples/teleport_control.json
+docker run --rm -v "$PWD:/work" ghcr.io/va24d/align-agent:0.4.4 analyze /work/my_trajectories/
 ```
 
 ## `align-agent analyze`
 
 ```
-align-agent analyze PATH [PATH ...] [--format F] [--cwd DIR] [--json OUT] [--quiet]
+align-agent analyze [PATH ...] [--examples] [--format F] [--cwd DIR] [--json OUT] [--quiet] [-j N]
 ```
 
 Reads trajectory files, or directories of them. The format is detected:
@@ -169,7 +170,7 @@ align-agent run --repo DIR --task TEXT_OR_FILE --model NAME --base-url URL \
                [--arm control|viewport|diff|lean|dependency] [--image IMAGE] [--out trajectory.json]
 ```
 
-Needs the `[run]` extra: `pip install 'align-agent[run] @ git+https://github.com/VA24d/align-agent@v0.4.3'`. Runs mini-swe-agent 2.4.6 against any OpenAI-compatible endpoint. The API key is read from `$OPENAI_API_KEY`, or from the variable that `--api-key-env` names. After each command, the hook finds the files the command changed by content hash and appends one of these to that command's output:
+Needs the `[run]` extra: `pip install 'align-agent[run]'`. Runs mini-swe-agent 2.4.6 against any OpenAI-compatible endpoint. The API key is read from `$OPENAI_API_KEY`, or from the variable that `--api-key-env` names. After each command, the hook finds the files the command changed by content hash and appends one of these to that command's output:
 
 - `viewport`: a numbered window around each change.
 - `diff`: the net diff since the agent last saw the file.

{align_agent-0.4.3 → align_agent-0.4.4}/align_agent/__init__.py

@@ -8,4 +8,4 @@ held the view, how the view was delivered, and whether the edit went wrong
 because of it.
 """
 
-__version__ = "0.4.3"
+__version__ = "0.4.4"

{align_agent-0.4.3 → align_agent-0.4.4}/align_agent/cli.py

@@ -11,6 +11,13 @@ from . import __version__
 from .core import FORMATS, analyze, load, summarize
 from .run import add_parser as add_run
 
+EXAMPLES = os.path.join(os.path.dirname(os.path.abspath(__file__)), "examples")
+
+
+def example_files():
+    """The trajectories bundled with the package (two runs of one SWE-Bench Pro task)."""
+    return sorted(glob.glob(os.path.join(EXAMPLES, "*.json")))
+
 
 def _files(paths):
     for p in paths:
@@ -50,7 +57,18 @@ def _analyzed(args):
         yield from pool.imap(_one, jobs, chunksize=8)
 
 
+def cmd_examples(args):
+    for f in example_files():
+        print(f)
+    return 0
+
+
 def cmd_analyze(args):
+    if args.examples:
+        args.paths = list(args.paths) + example_files()
+    if not args.paths:
+        print("align-agent analyze: give trajectory files or directories, or --examples", file=sys.stderr)
+        return 2
     results, skipped, t0 = [], [], time.time()
     for r, skip in _analyzed(args):
         if skip:
@@ -85,13 +103,16 @@ def main(argv=None):
     ap.add_argument("--version", action="version", version=f"align-agent {__version__}")
     sub = ap.add_subparsers(dest="cmd", required=True)
     a = sub.add_parser("analyze", help="find stale edits in trajectories")
-    a.add_argument("paths", nargs="+", help="trajectory files or directories (searched for *.json and *.jsonl)")
+    a.add_argument("paths", nargs="*", help="trajectory files or directories (searched for *.json and *.jsonl)")
+    a.add_argument("--examples", action="store_true", help="also analyze the example trajectories bundled with the package")
     a.add_argument("--format", choices=sorted(FORMATS), help="skip format detection")
     a.add_argument("--cwd", help="the agent's working directory, for resolving relative paths")
     a.add_argument("--json", help="write per-edit results here")
     a.add_argument("--quiet", action="store_true", help="print the summary only")
     a.add_argument("-j", "--jobs", type=int, default=1, help="analyze this many files in parallel (default 1)")
     a.set_defaults(fn=cmd_analyze)
+    e = sub.add_parser("examples", help="print the paths of the bundled example trajectories")
+    e.set_defaults(fn=cmd_examples)
     add_run(sub)
     args = ap.parse_args(argv)
     return args.fn(args)