duckgap 0.0.1__tar.gz

duckgap-0.0.1/.gitignore

@@ -0,0 +1,5 @@
+dist/
+build/
+*.egg-info
+__pycache__/
+.venv/

duckgap-0.0.1/LICENSE

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

duckgap-0.0.1/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: duckgap
+Version: 0.0.1
+Summary: Silent contract-drift detection for AI agents. Placeholder release.
+Author: Oleksandr
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# duckgap
+
+Silent contract-drift detection for AI agents.
+
+Status: placeholder release. Nothing is functional yet.
+
+Run `duckgap` to see the banner.

duckgap-0.0.1/README.md

@@ -0,0 +1,7 @@
+# duckgap
+
+Silent contract-drift detection for AI agents.
+
+Status: placeholder release. Nothing is functional yet.
+
+Run `duckgap` to see the banner.

duckgap-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "duckgap"
+version = "0.0.1"
+description = "Silent contract-drift detection for AI agents. Placeholder release."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{name = "Oleksandr"}]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Programming Language :: Python :: 3",
+]
+dependencies = []
+
+[project.scripts]
+duckgap = "duckgap.cli:main"

duckgap-0.0.1/src/duckgap/__init__.py

@@ -0,0 +1,3 @@
+"""Placeholder. Nothing here yet."""
+
+__version__ = "0.0.1"

duckgap-0.0.1/src/duckgap/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

duckgap-0.0.1/src/duckgap/_logo.py

@@ -0,0 +1,16 @@
+GRID = [
+    ".....XXXX...",
+    "....XX.XX...",
+    "....XXXXXBBB",
+    "....XXXXXBB.",
+    "XX...XXXX...",
+    "XXXXXXXXXX..",
+    ".XXXXXXXXXX.",
+    ".XXXXXXXXXX.",
+    "..XXXXXXXX..",
+    "...XXXXXX...",
+]
+
+DARK = "#1A1A1A"
+LIGHT = "#FAFAFA"
+ACCENT = "#0E7A82"

duckgap-0.0.1/src/duckgap/cli.py

@@ -0,0 +1,120 @@
+import argparse
+import os
+import sys
+
+from . import __version__
+from ._logo import ACCENT, DARK, GRID, LIGHT
+
+RESET = "\x1b[0m"
+BOLD = "\x1b[1m"
+WIDTH = 14
+HEIGHT = 12
+
+TEXT_LINES = {
+    1: BOLD + "duckgap {version}" + RESET,
+    2: "Silent contract-drift detection for AI agents",
+    3: "Placeholder release. Nothing is functional yet.",
+}
+
+
+def _rgb(hex_color):
+    h = hex_color.lstrip("#")
+    return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
+
+
+def build_matrix():
+    """Return HEIGHT x WIDTH pixels: hex string, or None for transparent."""
+    m = [[DARK] * WIDTH for _ in range(HEIGHT)]
+    for r, c in ((0, 0), (0, WIDTH - 1), (HEIGHT - 1, 0), (HEIGHT - 1, WIDTH - 1)):
+        m[r][c] = None
+    colors = {"X": LIGHT, "B": ACCENT, ".": DARK}
+    for y, row in enumerate(GRID):
+        for x, ch in enumerate(row):
+            m[y + 1][x + 1] = colors[ch]
+    return m
+
+
+def _xterm_index(rgb):
+    levels = (0, 95, 135, 175, 215, 255)
+    best, best_d = 16, None
+    candidates = []
+    for r in range(6):
+        for g in range(6):
+            for b in range(6):
+                candidates.append((16 + 36 * r + 6 * g + b,
+                                   (levels[r], levels[g], levels[b])))
+    for i in range(24):
+        v = 8 + 10 * i
+        candidates.append((232 + i, (v, v, v)))
+    for idx, c in candidates:
+        d = sum((a - b) ** 2 for a, b in zip(rgb, c))
+        if best_d is None or d < best_d:
+            best, best_d = idx, d
+    return best
+
+
+def _make_color(truecolor):
+    def fg_bg(hex_color):
+        rgb = _rgb(hex_color)
+        if truecolor:
+            return "2;%d;%d;%d" % rgb
+        return "5;%d" % _xterm_index(rgb)
+    return fg_bg
+
+
+def render_logo(truecolor):
+    code = _make_color(truecolor)
+    m = build_matrix()
+    lines = []
+    for y in range(0, HEIGHT, 2):
+        out = []
+        for x in range(WIDTH):
+            top, bot = m[y][x], m[y + 1][x]
+            if top and bot:
+                out.append("\x1b[38;%sm\x1b[48;%sm▀" % (code(top), code(bot)))
+            elif bot:
+                out.append("\x1b[38;%sm▄" % code(bot))
+            elif top:
+                out.append("\x1b[38;%sm▀" % code(top))
+            else:
+                out.append(" ")
+            if top or bot:
+                out.append(RESET)
+        lines.append("".join(out) + RESET)
+    return lines
+
+
+def _plain_mode():
+    return (
+        bool(os.environ.get("NO_COLOR"))
+        or os.environ.get("TERM") == "dumb"
+        or not sys.stdout.isatty()
+    )
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(prog="duckgap")
+    parser.add_argument("--version", action="version",
+                        version="duckgap " + __version__)
+    parser.add_argument("--no-logo", action="store_true")
+    args = parser.parse_args(argv)
+
+    if _plain_mode():
+        print("duckgap %s — placeholder release, not functional yet" % __version__)
+        return 0
+
+    if sys.platform == "win32":
+        os.system("")
+
+    text = {i: t.format(version=__version__) for i, t in TEXT_LINES.items()}
+    if args.no_logo:
+        rows = [text[i] for i in sorted(text)]
+    else:
+        truecolor = os.environ.get("COLORTERM") in {"truecolor", "24bit"}
+        logo = render_logo(truecolor)
+        rows = [
+            logo[i] + ("  " + text[i] if i in text else "")
+            for i in range(len(logo))
+        ]
+    sys.stdout.write("\n".join(rows) + "\n")
+    return 0