gitcast 1.0.0__tar.gz → 1.0.1__tar.gz

{gitcast-1.0.0 → gitcast-1.0.1}/MANIFEST.in

@@ -1,6 +1,7 @@
 include README.md
 include LICENSE
 include .env.example
+include cli/.env.example
 include requirements.txt
 recursive-include web *
 recursive-include assets *

{gitcast-1.0.0/gitcast.egg-info → gitcast-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcast
-Version: 1.0.0
+Version: 1.0.1
 Summary: git diff → published post. under 60 seconds.
 Home-page: https://github.com/drizzy765/gitcast
 Author: Timilehin Agoro

gitcast-1.0.1/assets/__init__.py

@@ -0,0 +1 @@
+# Make assets directory a Python package so it gets packaged and installed to site-packages.

gitcast-1.0.1/cli/.env.example

@@ -0,0 +1,26 @@
+# Groq — primary AI inference
+GROQ_API_KEY=your_groq_api_key_here
+
+# DeepSeek & Moonshot — specialized/free-tier fallbacks
+DEEPSEEK_API_KEY=your_deepseek_api_key_here
+MOONSHOT_API_KEY=your_moonshot_api_key_here
+CEREBRAS_API_KEY=your_cerebras_api_key_here
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+
+# Gemini — vision fallback (when OCR confidence is too low)
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# Optional model overrides
+GROQ_MODEL=llama-3.3-70b-versatile
+DEEPSEEK_MODEL=deepseek-chat
+MOONSHOT_MODEL=moonshot-v1-8k
+GEMINI_MODEL=gemini-2.0-flash
+CEREBRAS_MODEL=llama-3.3-70b
+OPENROUTER_MODEL=meta-llama/llama-3.3-70b-instruct:free
+
+# X (Twitter) API v2 — all five are required for posting
+TWITTER_API_KEY=your_twitter_api_key_here
+TWITTER_API_SECRET=your_twitter_api_secret_here
+TWITTER_ACCESS_TOKEN=your_twitter_access_token_here
+TWITTER_ACCESS_SECRET=your_twitter_access_secret_here
+TWITTER_BEARER_TOKEN=your_twitter_bearer_token_here

gitcast-1.0.1/cli/gitcast.py

@@ -0,0 +1,106 @@
+import sys
+import os
+import shutil
+import subprocess
+import httpx
+import webbrowser
+
+def main():
+    if "--setup" in sys.argv:
+        env_path = os.path.join(
+            os.path.dirname(__file__), '..', '.env')
+        example_path = os.path.join(
+            os.path.dirname(__file__), '..', '.env.example')
+        if not os.path.exists(example_path):
+            example_path = os.path.join(
+                os.path.dirname(__file__), '.env.example')
+        
+        if not os.path.exists(env_path):
+            if os.path.exists(example_path):
+                shutil.copy(example_path, env_path)
+            else:
+                # If neither is found, create an empty or minimal env file
+                with open(env_path, 'w') as f:
+                    f.write("# Gitcast Environment Variables\nGROQ_API_KEY=\nGEMINI_API_KEY=\n")
+        
+        try:
+            if sys.platform == "win32":
+                subprocess.run(["notepad", env_path])
+            elif sys.platform == "darwin":
+                subprocess.run(["open", "-t", env_path])
+            else:
+                try:
+                    subprocess.run(["xdg-open", env_path])
+                except Exception:
+                    print(f"[Gitcast] Created/configured .env at: {env_path}")
+                    print("Please open it in an editor to add your API keys.")
+        except Exception as e:
+            print(f"[Gitcast] Created/configured .env at: {env_path}")
+            print(f"Could not automatically open editor: {e}")
+        sys.exit(0)
+
+    if len(sys.argv) < 2:
+        # start FastAPI server in background thread
+        import threading
+        import webbrowser
+        import time
+        import urllib.request
+
+        def start_server():
+            from api.server import start_server as run
+            run()
+
+        server_thread = threading.Thread(
+            target=start_server, daemon=True)
+        server_thread.start()
+
+        # wait for server to be ready (max 5 seconds)
+        for _ in range(10):
+            try:
+                urllib.request.urlopen(
+                    "http://127.0.0.1:8000/health",
+                    timeout=1)
+                break
+            except Exception:
+                time.sleep(0.5)
+
+        # open browser
+        webbrowser.open("http://127.0.0.1:8000")
+
+        # start tray and hotkey
+        from core.tray import run_tray
+        from main import on_trigger
+        run_tray(trigger_callback=on_trigger)
+        return
+
+    command = sys.argv[1]
+
+    if command == "capture":
+        from core.screenshot_session import ScreenshotSession
+        session = ScreenshotSession()
+        session.run()
+        return
+
+    thought = " ".join(sys.argv[1:])
+    print(f"[Gitcast] Initializing capture with thought: '{thought}'")
+
+    try:
+        # Call the internal trigger endpoint
+        response = httpx.post(
+            "http://127.0.0.1:8000/api/cli/trigger",
+            json={"thought": thought},
+            timeout=30
+        )
+        
+        if response.status_code == 200:
+            print("[Gitcast] Context captured. Opening Draft Room...")
+            webbrowser.open("http://127.0.0.1:8000")
+        else:
+            print(f"[Gitcast Error] Failed to trigger: {response.text}")
+            
+    except Exception as e:
+        print(f"[Gitcast Error] Connection failed: {e}")
+        print("Is Gitcast running? (python -m gitcast or python main.py)")
+
+if __name__ == "__main__":
+    main()

{gitcast-1.0.0 → gitcast-1.0.1}/core/capture.py

@@ -7,6 +7,8 @@ from config.settings import STORAGE_DIR
 from core.log_stream import stream_log
 from api.analytics import track
 BASE_DIR = STORAGE_DIR.parent.parent
+screenshot_dir = STORAGE_DIR / "screenshots"
+screenshot_dir.mkdir(parents=True, exist_ok=True)
 from .framing import add_programming_frame
 
 
@@ -218,11 +220,13 @@ def run_capture(delay: float = 5.0) -> dict:
     # Apply programming frame if capture succeeded
     if screenshot.get("success") and screenshot.get("path"):
         try:
-            framed_path = add_programming_frame(screenshot["path"])
-            screenshot["framed_path"] = framed_path
+            abs_path = str(screenshot_dir / Path(screenshot["path"]).name)
+            framed_path = add_programming_frame(abs_path)
+            rel_framed_path = str(Path(framed_path).relative_to(BASE_DIR)).replace("\\", "/")
+            screenshot["framed_path"] = rel_framed_path
             # By default, use the framed path for downstream preview/publishing
             screenshot["raw_path"] = screenshot["path"]
-            screenshot["path"] = framed_path
+            screenshot["path"] = rel_framed_path
         except Exception as e:
             stream_log("Capture", "WARN", f"framing failed: {e}")
             screenshot["framed_path"] = ""

{gitcast-1.0.0 → gitcast-1.0.1}/core/screenshot_session.py

@@ -17,6 +17,8 @@ from core.ocr import run_ocr
 from core.security import scan_for_secrets, delete_capture
 from config.settings import STORAGE_DIR, CURRENT_DRAFT, get_project_narrative
 
+screenshot_dir = STORAGE_DIR / "screenshots"
+
 console = Console()
 
 class ScreenshotSession:
@@ -127,12 +129,13 @@ class ScreenshotSession:
                     return
 
                 # OCR and Security (Silent progress)
-                ocr = run_ocr(shot["path"])
+                abs_shot_path = str(screenshot_dir / Path(shot["path"]).name)
+                ocr = run_ocr(abs_shot_path)
                 security = scan_for_secrets(ocr["text"] or ocr["raw_text"])
 
                 if not security["clean"]:
                     console.print(f"\n[red]⚠️  Shot {len(self.screenshots)+1} blocked (sensitive content).[/red]")
-                    delete_capture(shot["path"])
+                    delete_capture(abs_shot_path)
                     return
 
                 # Add to list with default purpose
@@ -212,7 +215,7 @@ class ScreenshotSession:
             if keep:
                 final_shots.append(s)
             else:
-                delete_capture(s["path"])
+                delete_capture(str(screenshot_dir / Path(s["path"]).name))
         
         self.screenshots = final_shots
 

{gitcast-1.0.0 → gitcast-1.0.1/gitcast.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcast
-Version: 1.0.0
+Version: 1.0.1
 Summary: git diff → published post. under 60 seconds.
 Home-page: https://github.com/drizzy765/gitcast
 Author: Timilehin Agoro

{gitcast-1.0.0 → gitcast-1.0.1}/gitcast.egg-info/SOURCES.txt

@@ -21,11 +21,13 @@ api/ratelimit.py
 api/routes.py
 api/server.py
 api/validators.py
+assets/__init__.py
 assets/favicon-16x16.png
 assets/favicon-32x32.png
 assets/favicon-64x64.png
 assets/favicon.ico
 assets/icon.png
+cli/.env.example
 cli/__init__.py
 cli/gitcast.py
 config/__init__.py
@@ -61,19 +63,9 @@ gitcast.egg-info/top_level.txt
 publisher/__init__.py
 publisher/clipboard.py
 publisher/twitter.py
-storage/__init__.py
-storage/cleanup.py
-storage/engagement.py
-storage/insights.py
-storage/key_manager.py
-storage/logger.py
-storage/metrics.py
-storage/sprint.py
-storage/streak.py
-storage/supabase_client.py
-storage/tone_memory.py
 tests/test_keys.py
 tests/test_ocr_fix.py
 ui/__init__.py
+web/__init__.py
 web/index.html
 web/landing.html

{gitcast-1.0.0 → gitcast-1.0.1}/gitcast.egg-info/top_level.txt

@@ -1,8 +1,9 @@
 ai
 api
+assets
 cli
 config
 core
 publisher
-storage
 ui
+web

{gitcast-1.0.0 → gitcast-1.0.1}/setup.py

@@ -19,7 +19,7 @@ if os.path.exists(requirements_path):
 
 setup(
     name="gitcast",
-    version="1.0.0",
+    version="1.0.1",
     description="git diff → published post. under 60 seconds.",
     long_description=long_description,
     long_description_content_type="text/markdown",

gitcast-1.0.1/web/__init__.py

@@ -0,0 +1 @@
+# Make web directory a Python package so it gets packaged and installed to site-packages.

gitcast-1.0.0/cli/gitcast.py

@@ -1,56 +0,0 @@
-import sys
-import os
-import shutil
-import subprocess
-import httpx
-import webbrowser
-
-def main():
-    if "--setup" in sys.argv:
-        env_path = os.path.join(
-            os.path.dirname(__file__), '..', '.env')
-        example_path = os.path.join(
-            os.path.dirname(__file__), '..', '.env.example')
-        if not os.path.exists(env_path):
-            shutil.copy(example_path, env_path)
-        subprocess.run(["notepad", env_path])
-        sys.exit(0)
-
-    if len(sys.argv) < 2:
-        print("Usage:")
-        print("  gitcast \"your thought here\"  -> Quick single capture")
-        print("  gitcast capture            -> Start interactive multi-shot session")
-        print("  gitcast --setup            -> Setup environment variables")
-        sys.exit(1)
-
-    command = sys.argv[1]
-
-    if command == "capture":
-        from core.screenshot_session import ScreenshotSession
-        session = ScreenshotSession()
-        session.run()
-        return
-
-    thought = " ".join(sys.argv[1:])
-    print(f"[Gitcast] Initializing capture with thought: '{thought}'")
-
-    try:
-        # Call the internal trigger endpoint
-        response = httpx.post(
-            "http://127.0.0.1:8000/api/cli/trigger",
-            json={"thought": thought},
-            timeout=30
-        )
-        
-        if response.status_code == 200:
-            print("[Gitcast] Context captured. Opening Draft Room...")
-            webbrowser.open("http://127.0.0.1:8000")
-        else:
-            print(f"[Gitcast Error] Failed to trigger: {response.text}")
-            
-    except Exception as e:
-        print(f"[Gitcast Error] Connection failed: {e}")
-        print("Is Gitcast running? (python -m gitcast or python main.py)")
-
-if __name__ == "__main__":
-    main()

gitcast-1.0.0/storage/cleanup.py

@@ -1,60 +0,0 @@
-import os
-import time
-from pathlib import Path
-from config.settings import STORAGE_DIR, screenshot_retention_hours
-
-# [Cleanup] module for managing screenshot retention policy
-
-def run_cleanup():
-    """Deletes screenshots older than screenshot_retention_hours."""
-    screenshots_dir = STORAGE_DIR / "screenshots"
-    if not screenshots_dir.exists():
-        print("[Cleanup] No screenshots directory found.")
-        return
-
-    now = time.time()
-    retention_sec = screenshot_retention_hours * 3600
-    deleted_count = 0
-    
-    for file_path in screenshots_dir.glob("*.png"):
-        file_age = now - file_path.stat().st_mtime
-        if file_age > retention_sec:
-            try:
-                # Use secure delete if possible, but for cleanup standard unlink is usually fine
-                # unless the user specifically wants secure delete for all old files.
-                # Given core/security.py exists, we could use it, but it might be overkill for bulk cleanup.
-                file_path.unlink()
-                deleted_count += 1
-            except Exception as e:
-                print(f"[Cleanup] Error deleting {file_path.name}: {e}")
-
-    if deleted_count > 0:
-        print(f"[Cleanup] Deleted {deleted_count} old screenshots.")
-    else:
-        print("[Cleanup] No old screenshots to delete.")
-
-def get_storage_stats():
-    """Returns count of screenshots, total size in MB, and oldest file date."""
-    screenshots_dir = STORAGE_DIR / "screenshots"
-    if not screenshots_dir.exists():
-        return {"count": 0, "total_size_mb": 0.0, "oldest_file": "N/A"}
-
-    files = list(screenshots_dir.glob("*.png"))
-    if not files:
-        return {"count": 0, "total_size_mb": 0.0, "oldest_file": "N/A"}
-
-    total_size = sum(f.stat().st_size for f in files)
-    oldest_time = min(f.stat().st_mtime for f in files)
-    oldest_date = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(oldest_time))
-
-    return {
-        "count": len(files),
-        "total_size_mb": round(total_size / (1024 * 1024), 2),
-        "oldest_file": oldest_date
-    }
-
-if __name__ == "__main__":
-    print("=== STORAGE CLEANUP TEST ===")
-    stats = get_storage_stats()
-    print(f"Current stats: {stats}")
-    run_cleanup()

gitcast-1.0.0/storage/engagement.py

@@ -1,114 +0,0 @@
-import json
-import time
-import threading
-from pathlib import Path
-import tweepy
-from config.settings import ENGAGEMENT_LOG, TWITTER_BEARER_TOKEN, POST_LOG
-from storage.tone_memory import update_engagement
-
-# [Engagement] module for tracking X metrics 24h after publish
-
-def log_pending_fetch(tweet_id: str, post_text: str):
-    """Saves a tweet ID to ENGAGEMENT_LOG for background processing."""
-    entry = {
-        "tweet_id": tweet_id,
-        "post_text": post_text,
-        "publish_timestamp": time.time(),
-        "fetched": False
-    }
-    try:
-        with open(ENGAGEMENT_LOG, "a", encoding="utf-8") as f:
-            f.write(json.dumps(entry) + "\n")
-        print(f"[Engagement] Logged pending fetch for tweet {tweet_id}")
-    except Exception as e:
-        print(f"[Engagement] Error logging pending fetch: {e}")
-
-def get_pending_fetches():
-    """Returns list of entries due for metrics fetch (24h+ old, not fetched)."""
-    if not ENGAGEMENT_LOG.exists():
-        return []
-    
-    pending = []
-    now = time.time()
-    try:
-        with open(ENGAGEMENT_LOG, "r", encoding="utf-8") as f:
-            for line in f:
-                if not line.strip(): continue
-                entry = json.loads(line)
-                # 24 hours = 86400 seconds
-                if not entry.get("fetched") and (now - entry["publish_timestamp"] > 86400):
-                    pending.append(entry)
-    except Exception as e:
-        print(f"[Engagement] Error reading pending fetches: {e}")
-    
-    return pending
-
-def fetch_and_store_metrics(tweet_id: str, post_text: str):
-    """Calls X API v2 to get metrics and updates tone_memory."""
-    if not TWITTER_BEARER_TOKEN:
-        print("[Engagement] No Twitter Bearer Token found, skipping fetch.")
-        return False
-
-    try:
-        client = tweepy.Client(bearer_token=TWITTER_BEARER_TOKEN)
-        response = client.get_tweet(tweet_id, tweet_fields=["public_metrics"])
-        
-        if response.data:
-            metrics = response.data.public_metrics
-            likes = metrics.get("like_count", 0)
-            retweets = metrics.get("retweet_count", 0)
-            replies = metrics.get("reply_count", 0)
-            
-            update_engagement(post_text, likes, retweets, replies)
-            return True
-        else:
-            print(f"[Engagement] Could not find tweet {tweet_id}")
-            return False
-    except Exception as e:
-        print(f"[Engagement] X API error for {tweet_id}: {e}")
-        return False
-
-def mark_as_fetched(tweet_id: str):
-    """Updates ENGAGEMENT_LOG to mark a tweet as fetched."""
-    if not ENGAGEMENT_LOG.exists():
-        return
-    
-    entries = []
-    try:
-        with open(ENGAGEMENT_LOG, "r", encoding="utf-8") as f:
-            for line in f:
-                if not line.strip(): continue
-                entry = json.loads(line)
-                if entry["tweet_id"] == tweet_id:
-                    entry["fetched"] = True
-                entries.append(entry)
-        
-        with open(ENGAGEMENT_LOG, "w", encoding="utf-8") as f:
-            for e in entries:
-                f.write(json.dumps(e) + "\n")
-    except Exception as e:
-        print(f"[Engagement] Error marking as fetched: {e}")
-
-def run_engagement_worker():
-    """Background thread that runs hourly and processes pending fetches."""
-    def worker():
-        while True:
-            print("[Engagement] Checking for pending metrics fetches...")
-            pending = get_pending_fetches()
-            for entry in pending:
-                success = fetch_and_store_metrics(entry["tweet_id"], entry["post_text"])
-                if success:
-                    mark_as_fetched(entry["tweet_id"])
-            
-            # Sleep for 1 hour
-            time.sleep(3600)
-
-    thread = threading.Thread(target=worker, daemon=True)
-    thread.start()
-    print("[Engagement] Background worker started.")
-
-if __name__ == "__main__":
-    print("=== ENGAGEMENT TRACKING TEST ===")
-    log_pending_fetch("123456789", "Test post text")
-    print(f"Pending: {get_pending_fetches()}")
-    # Note: X API call will fail without real token in test