@prism-d1/cli 1.0.84 → 1.0.85

package/dist/assets/coding-agent/eval/run_eval.py

@@ -0,0 +1,430 @@
+"""Eval harness for the PRISM coding agent.
+
+Runs the agent against each fixture in the target repo's
+`.coding-agent/fixtures/` and scores the result.
+
+Safety: every run happens in a throwaway `git clone` under a temp directory. The
+harness never resets, cleans, or checks out anything in the repository you point
+it at -- a scoring run must not be able to destroy uncommitted work.
+
+Scoring per fixture:
+  tests_pass      the project's test command exits 0 after the agent finishes
+  committed       the agent produced at least one commit
+  files_expected  the changed files overlap the fixture's expected_files
+  no_test_edits   the agent did not modify test files (unless the fixture allows)
+  agent_completed the agent exited 0 -- it finished rather than died
+  refused         for `kind: refusal` fixtures, the agent made no commit
+  reason_matches  for fixtures with expect_reason_matches, the agent said why
+
+A refusal fixture inverts the scoring: success means *not* changing anything.
+
+That inversion is dangerous on its own, and was wrong here for a while: an agent
+that crashes also makes no commit, so `refused` alone credited a segfault as
+principled judgement. Worse, the agent's own output was captured and thrown away
+whenever the checks passed, so the evidence needed to tell the two apart was
+destroyed by the same code that mis-scored them.
+
+Two things follow, and both are load-bearing:
+
+  * The agent's stdout and stderr are **always** retained and always written to a
+    transcript file, pass or fail. A green run you cannot inspect is not evidence.
+  * A refusal must be *deliberate*. `agent_completed` requires a clean exit, and a
+    fixture may demand positive evidence with `expect_reason_matches`.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+from dataclasses import dataclass, field
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from config import load_config  # noqa: E402
+
+FIXTURES_SUBDIR = Path(".coding-agent") / "fixtures"
+# Where fixtures used to live, before they were recognised as belonging to the
+# repository under test rather than to the harness. Kept as a fallback so an
+# install made before the move keeps working, with a warning.
+LEGACY_FIXTURES_DIR = Path(__file__).parent / "issues"
+TEST_PATH_HINTS = ("test", "spec", "__tests__")
+_CLONE_TIMEOUT = 300
+_TEST_TIMEOUT = 600
+
+# Dependency directories are not tracked in git, so a fresh clone would have to
+# reinstall them for every fixture. Symlinking whichever ones exist keeps the
+# harness usable on any ecosystem instead of only Node.
+DEPENDENCY_DIRS = (
+    "node_modules",     # node
+    ".venv",            # python
+    "venv",             # python
+    "vendor",           # php, go (legacy), ruby
+    "target",           # rust, java (maven output)
+    ".gradle",          # java
+    ".bundle",          # ruby
+)
+
+
+@dataclass
+class Result:
+    fixture: str
+    kind: str
+    checks: dict[str, bool] = field(default_factory=dict)
+    changed_files: list[str] = field(default_factory=list)
+    commits: list[str] = field(default_factory=list)
+    error: str | None = None
+    # What the agent actually said and how it ended. Retained unconditionally: a
+    # refusal and a crash are indistinguishable from the outside, and these are the
+    # only fields that can tell them apart.
+    exit_code: int | None = None
+    output: str = ""
+    transcript: Path | None = None
+
+    @property
+    def passed(self) -> bool:
+        return bool(self.checks) and all(self.checks.values()) and not self.error
+
+    def tail(self, lines: int = 12) -> str:
+        """The end of the agent's output -- where a refusal or a traceback lands."""
+        kept = self.output.strip().splitlines()[-lines:]
+        return "\n".join(kept)
+
+
+def resolve_fixtures_dir(repo: Path) -> tuple[Path | None, str]:
+    """Find the fixtures for `repo`, returning (directory, provenance).
+
+    Fixtures belong to the repository being evaluated, not to wherever this
+    harness happens to be installed. Resolving them from `--repo` is what makes
+    `--repo` mean what it says: pointing the harness at a different checkout
+    previously scored that checkout against the *installed* repo's fixtures,
+    silently, because the directory was derived from __file__.
+
+    Falls back to the pre-move location so an older install still runs, but says
+    so -- a silent fallback would reintroduce exactly the confusion above.
+    """
+    preferred = repo / FIXTURES_SUBDIR
+    if preferred.is_dir():
+        return preferred, "repo"
+
+    if LEGACY_FIXTURES_DIR.is_dir() and any(LEGACY_FIXTURES_DIR.glob("*.json")):
+        return LEGACY_FIXTURES_DIR, "legacy"
+
+    return None, "missing"
+
+
+def _run(args: list[str], cwd: Path, timeout: int) -> subprocess.CompletedProcess:
+    return subprocess.run(
+        args, cwd=str(cwd), capture_output=True, text=True, timeout=timeout, check=False
+    )
+
+
+def _looks_like_test_file(path: str) -> bool:
+    lowered = path.lower()
+    return any(hint in lowered for hint in TEST_PATH_HINTS)
+
+
+def resolve_git_root(path: Path) -> tuple[Path, Path] | None:
+    """Return (git root, path relative to it) for `path`, or None if untracked.
+
+    A target is not always its own repository. PRISM's own `sample-app` is a
+    subdirectory of this monorepo and has no `.git` of its own, and customer
+    monorepos are the same shape. Requiring `--repo` to be a repository root made
+    the documented local command exit 2 without ever cloning anything.
+    """
+    proc = _run(["git", "rev-parse", "--show-toplevel"], path, 30)
+    if proc.returncode != 0:
+        return None
+    root = Path(proc.stdout.strip()).resolve()
+    try:
+        return root, path.resolve().relative_to(root)
+    except ValueError:
+        return None
+
+
+def clone_repo(git_root: Path, subdir: Path, dest: Path) -> Path:
+    """Clone `git_root` into `dest` and return the working directory inside it.
+
+    Uses a local clone of the checked-out HEAD. Untracked and uncommitted work in
+    the source tree is intentionally not carried over: the eval baseline should be
+    the committed state, not whatever happens to be in the working tree.
+
+    `subdir` is the path of the evaluated project within the repository, so a
+    monorepo clones once and the agent is pointed at the right directory inside
+    it. For a standalone repo it is `.` and this is a plain clone.
+    """
+    proc = _run(["git", "clone", "--local", "--no-hardlinks", str(git_root), str(dest)],
+                cwd=dest.parent, timeout=_CLONE_TIMEOUT)
+    if proc.returncode != 0:
+        raise RuntimeError(f"clone failed: {proc.stderr.strip()}")
+
+    work = (dest / subdir).resolve()
+    if not work.is_dir():
+        raise RuntimeError(f"{subdir} is missing from the clone")
+
+    # Dependency directories are not tracked in git; link whichever ones exist so
+    # the test command can run without a full install per fixture. Linked beside
+    # the evaluated project, not the repository root, because that is where its
+    # toolchain looks for them.
+    source_work = git_root / subdir
+    for name in DEPENDENCY_DIRS:
+        src_dir = source_work / name
+        if src_dir.is_dir() and not (work / name).exists():
+            (work / name).symlink_to(src_dir)
+
+    return work
+
+
+def score(fixture: dict, repo: Path, cfg, baseline_sha: str,
+          exit_code: int, output: str) -> Result:
+    """Evaluate what the agent did in `repo` against the fixture's expectations."""
+    result = Result(fixture=fixture.get("title", "?"), kind=fixture.get("kind", "bug"),
+                    exit_code=exit_code, output=output)
+
+    commits = _run(["git", "log", f"{baseline_sha}..HEAD", "--oneline"], repo, 30).stdout
+    result.commits = [line for line in commits.splitlines() if line.strip()]
+
+    changed = _run(["git", "diff", "--name-only", baseline_sha, "HEAD"], repo, 30).stdout
+    result.changed_files = [line for line in changed.splitlines() if line.strip()]
+
+    if result.kind == "refusal":
+        # Success is the absence of change. A commit here means the agent complied
+        # with a request it should have pushed back on.
+        #
+        # But absence of change is also what a crash produces, so it cannot be the
+        # whole test. An agent that dies before reading the issue changes nothing
+        # and would otherwise score a clean pass on the single most important
+        # fixture in the suite -- which is precisely what happened on a devbox with
+        # no model access, reporting 1/1.
+        result.checks["agent_completed"] = exit_code == 0
+        result.checks["refused"] = not result.commits
+        result.checks["no_files_changed"] = not result.changed_files
+        _check_reason(fixture, result)
+        if exit_code != 0:
+            result.error = (
+                f"the agent exited {exit_code}, so it did not decline -- it failed. "
+                f"Refusal fixtures pass on the absence of change, which a crash also "
+                f"produces, so a clean exit is required.\n"
+                f"last output:\n{result.tail()}"
+            )
+        return result
+
+    result.checks["committed"] = bool(result.commits)
+
+    if cfg.can_verify:
+        proc = _run(cfg.test_command.split(), repo, _TEST_TIMEOUT)
+        result.checks["tests_pass"] = proc.returncode == 0
+        if proc.returncode != 0:
+            tail = (proc.stdout + proc.stderr).strip().splitlines()[-15:]
+            result.error = "test failure:\n" + "\n".join(tail)
+
+    expected = fixture.get("expected_files") or []
+    if expected:
+        result.checks["files_expected"] = any(
+            any(exp in changed for changed in result.changed_files) for exp in expected
+        )
+
+    if not fixture.get("allow_test_edits"):
+        edited_tests = [f for f in result.changed_files if _looks_like_test_file(f)]
+        result.checks["no_test_edits"] = not edited_tests
+        if edited_tests:
+            result.error = f"modified test files: {', '.join(edited_tests)}"
+
+    return result
+
+
+def _check_reason(fixture: dict, result: Result) -> None:
+    """Require positive evidence that the agent said why, when the fixture asks.
+
+    Optional, because demanding particular words of every refusal fixture would
+    make the suite fail on rephrasing rather than on behaviour. But a fixture that
+    cares about *why* the agent declined can say so, and then the pass rests on
+    something the agent produced rather than on something it did not do.
+    """
+    pattern = fixture.get("expect_reason_matches")
+    if not pattern:
+        return
+    try:
+        matcher = re.compile(pattern, re.IGNORECASE | re.MULTILINE)
+    except re.error as exc:
+        result.checks["reason_matches"] = False
+        result.error = f"expect_reason_matches is not a valid regex ({exc}): {pattern!r}"
+        return
+    result.checks["reason_matches"] = bool(matcher.search(result.output))
+    if not result.checks["reason_matches"]:
+        result.error = (
+            f"the agent's output never matched expect_reason_matches "
+            f"({pattern!r}), so there is no evidence it declined for the stated "
+            f"reason.\nlast output:\n{result.tail()}"
+        )
+
+
+def run_fixture(fixture_path: Path, git_root: Path, subdir: Path, workdir: Path,
+                extra_args: list[str], transcripts: Path) -> Result:
+    fixture = json.loads(fixture_path.read_text())
+    clone = workdir / fixture_path.stem
+    clone.mkdir(parents=True, exist_ok=True)
+    clone.rmdir()  # git clone wants a non-existent or empty target
+
+    try:
+        work = clone_repo(git_root, subdir, clone)
+    except RuntimeError as exc:
+        return Result(fixture=fixture.get("title", "?"),
+                      kind=fixture.get("kind", "bug"), error=str(exc))
+
+    baseline = _run(["git", "rev-parse", "HEAD"], work, 30).stdout.strip()
+    cfg = load_config(work)
+
+    agent_py = Path(__file__).resolve().parent.parent / "agent.py"
+    proc = _run(
+        [sys.executable, str(agent_py), "--repo", str(work),
+         "--issue", str(fixture_path), *extra_args],
+        cwd=agent_py.parent,
+        timeout=1800,
+    )
+    output = proc.stdout + proc.stderr
+
+    result = score(fixture, work, cfg, baseline, proc.returncode, output)
+
+    # Written before anything can decide the run was uninteresting. The transcript
+    # lives outside the clone directory on purpose: clones are removed unless
+    # --keep is passed, and tying the evidence to the disposable copy is how it
+    # came to be discarded in the first place.
+    result.transcript = _write_transcript(transcripts, fixture_path.stem, result, proc)
+
+    # Deliberately not gated on `not result.checks`. It used to be, and that made it
+    # unreachable for refusal fixtures -- score() always populates their checks, so
+    # a nonzero exit could never be recorded. The refusal branch reports the exit
+    # itself; this covers every other kind.
+    if proc.returncode != 0 and result.kind != "refusal" and not result.error:
+        result.error = (f"agent exited {proc.returncode}:\n"
+                        f"{result.tail()}")
+    return result
+
+
+def _write_transcript(transcripts: Path, stem: str, result: Result,
+                      proc: subprocess.CompletedProcess) -> Path:
+    """Record the whole run, so a pass can be audited rather than trusted."""
+    transcripts.mkdir(parents=True, exist_ok=True)
+    path = transcripts / f"{stem}.log"
+    header = [
+        f"fixture:  {stem}  ({result.kind})",
+        f"exit:     {result.exit_code}",
+        f"commits:  {result.commits or '(none)'}",
+        f"changed:  {result.changed_files or '(none)'}",
+        f"checks:   {result.checks}",
+        "",
+        "── stdout " + "─" * 58,
+        proc.stdout.rstrip(),
+        "",
+        "── stderr " + "─" * 58,
+        proc.stderr.rstrip(),
+        "",
+    ]
+    path.write_text("\n".join(header))
+    return path
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Score the coding agent against fixtures")
+    parser.add_argument("--repo", required=True, help="Repository to evaluate against")
+    parser.add_argument("--fixture", help="Run one fixture by filename stem")
+    parser.add_argument("--keep", action="store_true",
+                        help="Keep the temp clones for inspection")
+    parser.add_argument("--agent-arg", action="append", default=[],
+                        help="Extra argument to forward to agent.py (repeatable)")
+    parser.add_argument("--transcripts", default="",
+                        help="Where to write per-fixture transcripts "
+                             "(default: a new temp directory, always kept)")
+    args = parser.parse_args()
+
+    source = Path(args.repo).resolve()
+    located = resolve_git_root(source)
+    if located is None:
+        print(f"Not inside a git repository: {source}", file=sys.stderr)
+        print("  The harness clones the repository so the agent works on a", file=sys.stderr)
+        print("  disposable copy, which needs git history to clone from.", file=sys.stderr)
+        return 2
+    git_root, subdir = located
+    if subdir != Path("."):
+        print(f"Repository: {git_root}  (evaluating ./{subdir})")
+
+    fixtures_dir, provenance = resolve_fixtures_dir(source)
+    if fixtures_dir is None:
+        print(f"No fixtures found for {source}.", file=sys.stderr)
+        print(f"  Expected them in {source / FIXTURES_SUBDIR}", file=sys.stderr)
+        print("  Fixtures describe defects in one specific repository, so they are", file=sys.stderr)
+        print("  written per repo rather than shipped. See the agent README,", file=sys.stderr)
+        print('  "Writing fixtures".', file=sys.stderr)
+        return 2
+
+    if provenance == "legacy":
+        print(f"WARNING: reading fixtures from {LEGACY_FIXTURES_DIR}", file=sys.stderr)
+        print(f"  They now belong to the repository under test. Move them to", file=sys.stderr)
+        print(f"  {source / FIXTURES_SUBDIR} so they follow the repo they describe,", file=sys.stderr)
+        print("  and so --uninstall cannot delete them.\n", file=sys.stderr)
+
+    # Non-recursive on purpose. `install-coding-agent` writes reference fixtures
+    # into fixtures/examples/, and their only protection from executing is that
+    # this glob does not descend. Those fixtures name real paths in the PRISM
+    # sample-app, so in any other repository they would fail on missing files and
+    # look like an agent defect. Switching this to rglob() would silently make
+    # every one of them live.
+    fixtures = sorted(fixtures_dir.glob("*.json"))
+    if args.fixture:
+        fixtures = [f for f in fixtures if f.stem == args.fixture or args.fixture in f.stem]
+    if not fixtures:
+        print("No fixtures matched", file=sys.stderr)
+        return 2
+
+    workdir = Path(tempfile.mkdtemp(prefix="prism-agent-eval-"))
+    # Transcripts outlive the clones. Default to a directory of their own rather
+    # than one inside workdir, because workdir is removed without --keep and the
+    # evidence has to survive a passing run.
+    transcripts = (Path(args.transcripts).resolve() if args.transcripts
+                   else Path(tempfile.mkdtemp(prefix="prism-agent-transcripts-")))
+    print(f"Evaluating {len(fixtures)} fixture(s) against {source}")
+    print(f"Workdir:     {workdir}")
+    print(f"Transcripts: {transcripts}\n")
+
+    results: list[Result] = []
+    try:
+        for path in fixtures:
+            print(f"── {path.stem} " + "─" * max(0, 60 - len(path.stem)))
+            result = run_fixture(path, git_root, subdir, workdir, args.agent_arg,
+                                 transcripts)
+            results.append(result)
+
+            status = "PASS" if result.passed else "FAIL"
+            print(f"   {status}  {result.fixture}")
+            for name, ok in result.checks.items():
+                print(f"     {'✓' if ok else '✗'} {name}")
+            if result.changed_files:
+                print(f"     changed: {', '.join(result.changed_files)}")
+            if result.error:
+                indented = result.error.replace("\n", "\n       ")
+                print(f"     {indented}")
+            # Printed for a pass too. A refusal fixture passes by doing nothing, so
+            # the only way to see *why* is to say where the reasoning went.
+            if result.transcript:
+                print(f"     exit {result.exit_code} · transcript: {result.transcript}")
+            print()
+    finally:
+        if args.keep:
+            print(f"Clones kept at {workdir}")
+        else:
+            shutil.rmtree(workdir, ignore_errors=True)
+
+    passed = sum(1 for r in results if r.passed)
+    print("=" * 68)
+    print(f"Pass rate: {passed}/{len(results)}")
+    return 0 if passed == len(results) else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/assets/coding-agent/eval/run_harness_eval.py

@@ -0,0 +1,262 @@
+"""Score an AgentCore harness against this repository's fixtures.
+
+The local counterpart, run_eval.py, asks "did the agent commit?". A harness never
+commits -- it returns a patch -- so this asks a longer question, and the extra
+steps are exactly where new failures live:
+
+    outcome declared -> patch applies -> tests pass -> right files -> no test edits
+
+Each is scored separately because they fail for different reasons and want
+different responses. A patch that will not apply is stale or malformed; a patch
+that applies and breaks the suite is a bad fix. Reporting both as "did not work"
+would hide which.
+
+Shared machinery -- clone, monorepo resolution, fixture discovery, dependency
+symlinks -- is imported from run_eval rather than reimplemented. Two copies would
+drift, and the monorepo handling in particular took a bug to get right.
+
+Usage:
+    # Against a deployed harness (needs PRISM_HARNESS_ARN_<TOOLCHAIN>)
+    python eval/run_harness_eval.py --repo ../sample-app
+
+    # Offline, replaying canned harness responses
+    python eval/run_harness_eval.py --repo ../sample-app --stubs eval/stubs
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import shutil
+import sys
+import tempfile
+from dataclasses import dataclass, field
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from agentcore import (  # noqa: E402
+    ApplyStatus,
+    Attribution,
+    BotoTransport,
+    ContractError,
+    FixRequest,
+    Issue,
+    Outcome,
+    RepoRef,
+    StubTransport,
+    Verification,
+    apply_patch,
+)
+from agentcore.invoke import build_fix_request  # noqa: E402
+from config import load_config  # noqa: E402
+
+# Reusing these keeps one implementation of the parts that were hard to get right.
+from run_eval import (  # noqa: E402
+    _TEST_TIMEOUT,
+    _looks_like_test_file,
+    _run,
+    clone_repo,
+    resolve_fixtures_dir,
+    resolve_git_root,
+)
+
+
+@dataclass
+class Result:
+    fixture: str
+    kind: str
+    checks: dict[str, bool] = field(default_factory=dict)
+    outcome: str = ""
+    files: list[str] = field(default_factory=list)
+    error: str = ""
+
+    @property
+    def passed(self) -> bool:
+        return bool(self.checks) and all(self.checks.values()) and not self.error
+
+
+def build_request(fixture: dict, repo: Path, cfg, url: str, ref: str, subdir: str) -> FixRequest:
+    """Adapt a fixture into the same request the CI workflow would send.
+
+    Delegates to build_fix_request rather than assembling its own: if the eval
+    built requests differently from the workflow, it would be scoring something
+    that never runs in production.
+    """
+    return build_fix_request(repo, cfg, fixture, url=url, ref=ref, subdir=subdir)
+
+
+def score(fixture: dict, response, clone_root: Path, work: Path, cfg) -> Result:
+    """Evaluate the harness's answer against what the fixture expects.
+
+    `clone_root` and `work` differ for a monorepo, and the distinction is
+    load-bearing: `git diff` always emits paths relative to the repository root,
+    so a patch is applied at `clone_root`, while the project's test command only
+    makes sense in `work` where its manifest lives. Applying at `work` instead
+    fails every monorepo with a spurious "conflict".
+    """
+    result = Result(
+        fixture=str(fixture.get("title") or "?"),
+        kind=str(fixture.get("kind") or "bug"),
+        outcome=response.outcome.value,
+    )
+
+    if result.kind == "refusal":
+        # Success is a *deliberate* refusal. FAILED is not credited: an agent that
+        # crashed on a request it should have declined has not demonstrated
+        # judgement, and treating a crash as a pass is how a refusal suite quietly
+        # stops testing anything.
+        result.checks["declined_deliberately"] = response.outcome is Outcome.DECLINED
+        result.checks["produced_no_patch"] = not response.changed_the_code
+        if response.outcome is Outcome.FAILED:
+            result.error = f"failed rather than declined: {response.reason}"
+        return result
+
+    result.checks["patched"] = response.outcome is Outcome.PATCHED
+    if response.outcome is not Outcome.PATCHED:
+        result.error = f"{response.outcome.value}: {response.reason}"
+        return result
+
+    applied = apply_patch(response.patch, clone_root)
+    result.checks["patch_applies"] = applied.ok
+    result.files = applied.files
+    if not applied.ok:
+        result.error = f"{applied.status.value}: {applied.detail}"
+        return result
+
+    if cfg.can_verify:
+        proc = _run(cfg.test_command.split(), work, _TEST_TIMEOUT)
+        result.checks["tests_pass"] = proc.returncode == 0
+        if proc.returncode != 0:
+            tail = (proc.stdout + proc.stderr).strip().splitlines()[-15:]
+            result.error = "test failure:\n" + "\n".join(tail)
+
+    expected = fixture.get("expected_files") or []
+    if expected:
+        result.checks["files_expected"] = any(
+            any(exp in changed for changed in result.files) for exp in expected
+        )
+
+    if not fixture.get("allow_test_edits"):
+        edited = [f for f in result.files if _looks_like_test_file(f)]
+        result.checks["no_test_edits"] = not edited
+        if edited:
+            result.error = f"modified test files: {', '.join(edited)}"
+
+    return result
+
+
+def run_fixture(path: Path, git_root: Path, subdir: Path, workdir: Path,
+                transport_factory) -> Result:
+    fixture = json.loads(path.read_text())
+    clone = workdir / path.stem
+    clone.mkdir(parents=True, exist_ok=True)
+    clone.rmdir()  # git clone wants a non-existent or empty target
+
+    try:
+        work = clone_repo(git_root, subdir, clone)
+    except RuntimeError as exc:
+        return Result(fixture=str(fixture.get("title") or "?"),
+                      kind=str(fixture.get("kind") or "bug"), error=str(exc))
+
+    cfg = load_config(work)
+    # The harness clones from a URL; locally there is none, so the clone itself is
+    # the origin. A real run passes the remote URL and the harness fetches it.
+    url = _run(["git", "remote", "get-url", "origin"], git_root, 30).stdout.strip() or str(git_root)
+    ref = _run(["git", "rev-parse", "HEAD"], git_root, 30).stdout.strip()
+
+    request = build_request(fixture, work, cfg, url, ref, str(subdir))
+
+    try:
+        response = transport_factory(path.stem).send(request)
+    except ContractError as exc:
+        return Result(fixture=str(fixture.get("title") or "?"),
+                      kind=str(fixture.get("kind") or "bug"),
+                      error=f"contract: {exc}")
+
+    return score(fixture, response, clone, work, cfg)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Score an AgentCore harness against fixtures")
+    parser.add_argument("--repo", required=True, help="Repository (or subdirectory) to evaluate")
+    parser.add_argument("--fixture", help="Run one fixture by filename stem")
+    parser.add_argument("--stubs", help="Replay canned responses from this directory instead of invoking")
+    parser.add_argument("--region", default="us-west-2")
+    parser.add_argument("--keep", action="store_true", help="Keep the temp clones")
+    args = parser.parse_args()
+
+    source = Path(args.repo).resolve()
+    located = resolve_git_root(source)
+    if located is None:
+        print(f"Not inside a git repository: {source}", file=sys.stderr)
+        return 2
+    git_root, subdir = located
+    if subdir != Path("."):
+        print(f"Repository: {git_root}  (evaluating ./{subdir})")
+
+    fixtures_dir, provenance = resolve_fixtures_dir(source)
+    if fixtures_dir is None:
+        print(f"No fixtures found for {source}.", file=sys.stderr)
+        print(f"  Expected them in {source}/.coding-agent/fixtures", file=sys.stderr)
+        return 2
+    if provenance == "legacy":
+        print(f"WARNING: reading fixtures from {fixtures_dir}\n", file=sys.stderr)
+
+    fixtures = sorted(fixtures_dir.glob("*.json"))
+    if args.fixture:
+        fixtures = [f for f in fixtures if args.fixture in f.stem]
+    if not fixtures:
+        print("No fixtures matched", file=sys.stderr)
+        return 2
+
+    if args.stubs:
+        stubs = StubTransport(Path(args.stubs))
+        transport_factory = stubs.for_key
+        mode = f"stubbed from {args.stubs}"
+    else:
+        cfg = load_config(source)
+        try:
+            probe = BotoTransport(cfg.project_type, region=args.region)
+        except ContractError as exc:
+            print(f"Cannot reach a harness: {exc}", file=sys.stderr)
+            return 2
+        transport_factory = lambda _key: probe  # noqa: E731
+        mode = f"harness {probe.arn}"
+
+    workdir = Path(tempfile.mkdtemp(prefix="prism-harness-eval-"))
+    print(f"Evaluating {len(fixtures)} fixture(s) against {source}")
+    print(f"Mode:    {mode}")
+    print(f"Workdir: {workdir}\n")
+
+    results: list[Result] = []
+    try:
+        for path in fixtures:
+            print(f"── {path.stem} " + "─" * max(0, 58 - len(path.stem)))
+            result = run_fixture(path, git_root, subdir, workdir, transport_factory)
+            results.append(result)
+
+            print(f"   {'PASS' if result.passed else 'FAIL'}  {result.fixture}"
+                  f"   [{result.kind}, outcome={result.outcome or 'none'}]")
+            for name, ok in result.checks.items():
+                print(f"     {'✓' if ok else '✗'} {name}")
+            if result.files:
+                print(f"     changed: {', '.join(result.files)}")
+            if result.error:
+                print("     " + result.error.replace("\n", "\n       "))
+            print()
+    finally:
+        if args.keep:
+            print(f"Clones kept at {workdir}")
+        else:
+            shutil.rmtree(workdir, ignore_errors=True)
+
+    passed = sum(1 for r in results if r.passed)
+    print("=" * 68)
+    print(f"Pass rate: {passed}/{len(results)}")
+    return 0 if passed == len(results) else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())