aer1-scan 1.0.0__tar.gz

aer1_scan-1.0.0/LICENSE

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

aer1_scan-1.0.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: aer1-scan
+Version: 1.0.0
+Summary: Check every Zambo receipt link in a file, a web page, or stdin, right from your terminal. A Zambo receipt proves the saved result of an AI job was not changed after the fact.
+Author: Brennan Zambo
+License: MIT
+Project-URL: Homepage, https://zambo.dev/verify/
+Project-URL: Repository, https://github.com/zambodotdev/aer1-scan
+Keywords: aer-1,zambo,receipts,verification,ai-agents,mcp
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# aer1-scan
+
+Check every Zambo receipt in the work you were handed, from your terminal.
+
+Someone gives you AI work full of receipt links: a pull request, a report, a chat log. Instead of clicking each one, run one command. aer1-scan finds every Zambo receipt in a file, a web page, or piped text, checks each one live, and prints one line per receipt. It sends only the receipt ids, nothing else from the document.
+
+A Zambo receipt proves the saved result of an AI job was not changed after the fact. It does not prove the answer was right. It proves the record you are checking is the record that was saved at the time.
+
+## Install
+
+Node:
+```
+npx aer1-scan FILE
+```
+or `npm install -g aer1-scan`
+
+Python:
+```
+pipx run aer1-scan FILE
+```
+or `pip install aer1-scan`
+
+Same tool, same output, both published from this repo.
+
+## Use
+
+```
+aer1-scan report.md
+aer1-scan https://gist.github.com/zambodotdev/777872582b8dd2feefa43bf1d4fa1acf
+cat chat-log.txt | aer1-scan
+```
+
+Output, one line per receipt:
+```
+verified 5420f6f0-a635-4010-a7d4-311f7cd6b0ab https://zambo.dev/verify/?id=5420f6f0-a635-4010-a7d4-311f7cd6b0ab
+not found 00000000-0000-4000-8000-000000000000 https://zambo.dev/verify/?id=00000000-0000-4000-8000-000000000000
+```
+
+Exit code is 0 when every receipt verifies, 1 when any does not, so it drops straight into CI and pre-commit hooks.
+
+Prefer clicking? The same check runs in your browser at https://zambodotdev.github.io/receipt-scan/
+
+Want receipts on your own AI work: add Zambo in one URL, no key, at https://zambo.dev/add/?ref=aer1-scan
+
+Founder: Brennan Zambo (https://zambo.dev/founder/). Support: https://zambo.dev/add/?ref=aer1-scan

aer1_scan-1.0.0/README.md

@@ -0,0 +1,45 @@
+# aer1-scan
+
+Check every Zambo receipt in the work you were handed, from your terminal.
+
+Someone gives you AI work full of receipt links: a pull request, a report, a chat log. Instead of clicking each one, run one command. aer1-scan finds every Zambo receipt in a file, a web page, or piped text, checks each one live, and prints one line per receipt. It sends only the receipt ids, nothing else from the document.
+
+A Zambo receipt proves the saved result of an AI job was not changed after the fact. It does not prove the answer was right. It proves the record you are checking is the record that was saved at the time.
+
+## Install
+
+Node:
+```
+npx aer1-scan FILE
+```
+or `npm install -g aer1-scan`
+
+Python:
+```
+pipx run aer1-scan FILE
+```
+or `pip install aer1-scan`
+
+Same tool, same output, both published from this repo.
+
+## Use
+
+```
+aer1-scan report.md
+aer1-scan https://gist.github.com/zambodotdev/777872582b8dd2feefa43bf1d4fa1acf
+cat chat-log.txt | aer1-scan
+```
+
+Output, one line per receipt:
+```
+verified 5420f6f0-a635-4010-a7d4-311f7cd6b0ab https://zambo.dev/verify/?id=5420f6f0-a635-4010-a7d4-311f7cd6b0ab
+not found 00000000-0000-4000-8000-000000000000 https://zambo.dev/verify/?id=00000000-0000-4000-8000-000000000000
+```
+
+Exit code is 0 when every receipt verifies, 1 when any does not, so it drops straight into CI and pre-commit hooks.
+
+Prefer clicking? The same check runs in your browser at https://zambodotdev.github.io/receipt-scan/
+
+Want receipts on your own AI work: add Zambo in one URL, no key, at https://zambo.dev/add/?ref=aer1-scan
+
+Founder: Brennan Zambo (https://zambo.dev/founder/). Support: https://zambo.dev/add/?ref=aer1-scan

aer1_scan-1.0.0/aer1_scan.egg-info/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: aer1-scan
+Version: 1.0.0
+Summary: Check every Zambo receipt link in a file, a web page, or stdin, right from your terminal. A Zambo receipt proves the saved result of an AI job was not changed after the fact.
+Author: Brennan Zambo
+License: MIT
+Project-URL: Homepage, https://zambo.dev/verify/
+Project-URL: Repository, https://github.com/zambodotdev/aer1-scan
+Keywords: aer-1,zambo,receipts,verification,ai-agents,mcp
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# aer1-scan
+
+Check every Zambo receipt in the work you were handed, from your terminal.
+
+Someone gives you AI work full of receipt links: a pull request, a report, a chat log. Instead of clicking each one, run one command. aer1-scan finds every Zambo receipt in a file, a web page, or piped text, checks each one live, and prints one line per receipt. It sends only the receipt ids, nothing else from the document.
+
+A Zambo receipt proves the saved result of an AI job was not changed after the fact. It does not prove the answer was right. It proves the record you are checking is the record that was saved at the time.
+
+## Install
+
+Node:
+```
+npx aer1-scan FILE
+```
+or `npm install -g aer1-scan`
+
+Python:
+```
+pipx run aer1-scan FILE
+```
+or `pip install aer1-scan`
+
+Same tool, same output, both published from this repo.
+
+## Use
+
+```
+aer1-scan report.md
+aer1-scan https://gist.github.com/zambodotdev/777872582b8dd2feefa43bf1d4fa1acf
+cat chat-log.txt | aer1-scan
+```
+
+Output, one line per receipt:
+```
+verified 5420f6f0-a635-4010-a7d4-311f7cd6b0ab https://zambo.dev/verify/?id=5420f6f0-a635-4010-a7d4-311f7cd6b0ab
+not found 00000000-0000-4000-8000-000000000000 https://zambo.dev/verify/?id=00000000-0000-4000-8000-000000000000
+```
+
+Exit code is 0 when every receipt verifies, 1 when any does not, so it drops straight into CI and pre-commit hooks.
+
+Prefer clicking? The same check runs in your browser at https://zambodotdev.github.io/receipt-scan/
+
+Want receipts on your own AI work: add Zambo in one URL, no key, at https://zambo.dev/add/?ref=aer1-scan
+
+Founder: Brennan Zambo (https://zambo.dev/founder/). Support: https://zambo.dev/add/?ref=aer1-scan

aer1_scan-1.0.0/aer1_scan.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+aer1_scan.py
+pyproject.toml
+aer1_scan.egg-info/PKG-INFO
+aer1_scan.egg-info/SOURCES.txt
+aer1_scan.egg-info/dependency_links.txt
+aer1_scan.egg-info/entry_points.txt
+aer1_scan.egg-info/top_level.txt

aer1_scan-1.0.0/aer1_scan.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aer1_scan-1.0.0/aer1_scan.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aer1-scan = aer1_scan:main

aer1_scan-1.0.0/aer1_scan.egg-info/top_level.txt

@@ -0,0 +1 @@
+aer1_scan

aer1_scan-1.0.0/aer1_scan.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""aer1-scan: check every zambo receipt in a file, a web page, or stdin.
+
+A zambo receipt proves the saved result of an AI job was not changed
+after the fact. This tool sends only the receipt ids, nothing else.
+Pure standard library, no dependencies.
+"""
+import json
+import re
+import sys
+import urllib.error
+import urllib.request
+
+UUID = r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
+LINK_RE = re.compile(r"zambo\.dev/[^\s\"'<>\])]*?(" + UUID + r")", re.IGNORECASE)
+BARE_RE = re.compile(r"^\s*(" + UUID + r")\s*$", re.MULTILINE)
+MAX = 50
+TIMEOUT = 20
+
+
+def raw_url(u):
+    try:
+        from urllib.parse import urlparse
+        p = urlparse(u)
+        if p.hostname == "gist.github.com":
+            return u.rstrip("/") + "/raw"
+        if p.hostname == "github.com" and "/blob/" in p.path:
+            return u.replace("github.com", "raw.githubusercontent.com").replace("/blob/", "/")
+    except Exception:
+        pass
+    return u
+
+
+def extract(text):
+    seen = set()
+    ids = []
+
+    def add(rid):
+        rid = rid.lower()
+        if rid not in seen:
+            seen.add(rid)
+            ids.append(rid)
+
+    # A pasted receipt JSON export: its own top-level id is a receipt id.
+    if "receipt_schema_version" in text:
+        jm = re.search(r'"id"\s*:\s*"(' + UUID + r')"', text, re.IGNORECASE)
+        if jm:
+            add(jm.group(1))
+    for m in LINK_RE.finditer(text):
+        if m.group(0).lower().startswith("zambo.dev/workflow/"):
+            continue  # workflow ids are not receipt ids
+        add(m.group(1))
+    for m in BARE_RE.finditer(text):
+        add(m.group(1))
+    return ids[:MAX]
+
+
+def read_input(arg):
+    if not arg or arg == "-":
+        return sys.stdin.read()
+    if arg.lower().startswith(("http://", "https://")):
+        req = urllib.request.Request(raw_url(arg), headers={"User-Agent": "aer1-scan"})
+        with urllib.request.urlopen(req, timeout=TIMEOUT) as res:
+            return res.read().decode("utf-8", "replace")
+    with open(arg, "r", encoding="utf-8", errors="replace") as f:
+        return f.read()
+
+
+def verify(rid):
+    req = urllib.request.Request(
+        "https://zambo.dev/api/v2/receipt/" + rid + "/verify",
+        headers={"User-Agent": "aer1-scan"})
+    try:
+        with urllib.request.urlopen(req, timeout=TIMEOUT) as res:
+            data = json.loads(res.read().decode("utf-8", "replace"))
+    except urllib.error.HTTPError as e:
+        return "not found" if e.code == 404 else "could not verify"
+    except Exception:
+        return "could not verify"
+    status = data.get("verification_status")
+    return "verified" if status == "verified" else str(status or "could not verify")
+
+
+def main():
+    arg = sys.argv[1] if len(sys.argv) > 1 else None
+    try:
+        text = read_input(arg)
+    except Exception as e:
+        print("aer1-scan: " + str(e), file=sys.stderr)
+        return 1
+    ids = extract(text)
+    if not ids:
+        print("no zambo receipt links found. receipts look like zambo.dev/run/ followed by an id.",
+              file=sys.stderr)
+        return 1
+    failed = False
+    for rid in ids:
+        state = verify(rid)
+        if state != "verified":
+            failed = True
+        print(state + " " + rid + " https://zambo.dev/verify/?id=" + rid)
+    return 1 if failed else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

aer1_scan-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aer1-scan"
+version = "1.0.0"
+description = "Check every Zambo receipt link in a file, a web page, or stdin, right from your terminal. A Zambo receipt proves the saved result of an AI job was not changed after the fact."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "Brennan Zambo" }
+]
+keywords = ["aer-1", "zambo", "receipts", "verification", "ai-agents", "mcp"]
+
+[project.urls]
+Homepage = "https://zambo.dev/verify/"
+Repository = "https://github.com/zambodotdev/aer1-scan"
+
+[project.scripts]
+aer1-scan = "aer1_scan:main"
+
+[tool.setuptools]
+py-modules = ["aer1_scan"]

aer1_scan-1.0.0/setup.cfg

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