gitcast 1.0.4__tar.gz → 1.0.6__tar.gz

{gitcast-1.0.4/gitcast.egg-info → gitcast-1.0.6}/PKG-INFO

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

gitcast-1.0.6/api/ratelimit.py

@@ -0,0 +1,18 @@
+from slowapi import Limiter
+from slowapi.util import get_remote_address
+from fastapi import Request
+
+
+def get_client_ip(request: Request) -> str:
+    client_host = request.client.host if request.client else None
+    if client_host in ["127.0.0.1", "localhost", "::1"]:
+        return None
+    return get_remote_address(request)
+
+
+limiter = Limiter(key_func=get_client_ip, default_limits=["60/minute"], headers_enabled=False)
+
+
+if __name__ == "__main__":
+    print("[RateLimit] Default limit: 60/minute (bypassed for localhost)")
+

{gitcast-1.0.4 → gitcast-1.0.6}/api/routes.py

@@ -445,7 +445,8 @@ KEY_GUIDE = {
 
 
 def _env_path():
-    path = BASE_DIR / ".env"
+    from config.settings import get_active_env_path
+    path = get_active_env_path(for_write=True)
     path.touch(exist_ok=True)
     return path
 
@@ -540,8 +541,7 @@ def _update_settings_for_user(user_id: str, values: dict) -> dict:
 
 
 @router.get("/keys/status")
-def get_ai_keys_status():
-    user_id = LOCAL_USER_ID
+def get_ai_keys_status(user_id: str = Depends(get_current_user)):
     if _is_local_user(user_id):
         env_values = dotenv_values(_env_path())
         return {
@@ -667,9 +667,8 @@ def add_to_waitlist(request: WaitlistRequest):
 
 @router.patch("/settings")
 @router.post("/settings")
-def update_settings(update: SettingsUpdate):
+def update_settings(update: SettingsUpdate, user_id: str = Depends(get_current_user)):
     """Updates user project settings."""
-    user_id = LOCAL_USER_ID
     values = update.dict(exclude_unset=True)
     if "project_narrative" in values and values["project_narrative"] is not None:
         values["project_narrative"] = sanitize_text(values["project_narrative"])
@@ -679,9 +678,8 @@ def update_settings(update: SettingsUpdate):
 
 @router.post("/publish")
 @limiter.limit("10/minute")
-async def publish(request: Request, body: PublishRequest):
+async def publish(request: Request, body: PublishRequest, user_id: str = Depends(get_current_user)):
     """Publishes a post to X (Twitter)."""
-    user_id = LOCAL_USER_ID
     from publisher.twitter import publish_post
     try:
         post_text = sanitize_text(body.post_text)
@@ -782,8 +780,7 @@ async def get_framed_screenshot(filename: str):
 
 @router.post("/generate", response_model=GenerateResponse)
 @limiter.limit("10/minute")
-async def generate(request: Request, body: GenerateRequest):
-    user_id = LOCAL_USER_ID
+async def generate(request: Request, body: GenerateRequest, user_id: str = Depends(get_current_user)):
     payload = body.dict()
     for key, value in list(payload.items()):
         if isinstance(value, str):
@@ -865,9 +862,8 @@ def get_current_draft():
 
 @router.post("/chat")
 @limiter.limit("20/minute")
-async def chat_refine(request: Request, body: ChatRequest):
+async def chat_refine(request: Request, body: ChatRequest, user_id: str = Depends(get_current_user)):
     """Refines a post variation using AI chat."""
-    user_id = LOCAL_USER_ID
     if not CURRENT_DRAFT.exists():
         raise HTTPException(status_code=400, detail="No active draft to refine.")
 
@@ -925,9 +921,8 @@ async def chat_refine(request: Request, body: ChatRequest):
 
 
 @router.post("/cli/trigger")
-async def cli_trigger(request: CliTriggerRequest):
+async def cli_trigger(request: CliTriggerRequest, user_id: str = Depends(get_current_user)):
     """Triggers a capture workflow with a specific thought from the CLI."""
-    user_id = LOCAL_USER_ID
     from core.capture import run_capture
     from core.ocr import run_ocr
     from api.payload import build_payload
@@ -963,9 +958,8 @@ async def cli_trigger(request: CliTriggerRequest):
 
 
 @router.post("/capture/trigger")
-async def ui_trigger_capture(request: CaptureTriggerRequest):
+async def ui_trigger_capture(request: CaptureTriggerRequest, user_id: str = Depends(get_current_user)):
     """Triggers a capture workflow from the UI."""
-    user_id = LOCAL_USER_ID
     from core.capture import run_capture
     from core.ocr import run_ocr
     from api.payload import build_payload
@@ -1044,9 +1038,8 @@ def list_screenshots():
 
 
 @router.post("/screenshot/recommend")
-async def recommend_screenshot(request: RecommendRequest):
+async def recommend_screenshot(request: RecommendRequest, user_id: str = Depends(get_current_user)):
     """Uses AI to recommend where to post a specific screenshot."""
-    user_id = LOCAL_USER_ID
     from config.settings import STORAGE_DIR
     path = STORAGE_DIR / "screenshots" / sanitize_text(request.filename)
     if not path.exists():
@@ -1136,16 +1129,14 @@ def get_formats():
 
 
 @router.get("/settings/plan")
-def get_plan():
-    user_id = LOCAL_USER_ID
+def get_plan(user_id: str = Depends(get_current_user)):
     settings = _settings_for_user(user_id)
     preferred = settings.get("preferred_providers") or {}
     return {"plan": preferred.get("twitter_plan", get_twitter_plan())}
 
 
 @router.put("/settings/plan")
-def update_plan(update: PlanUpdate):
-    user_id = LOCAL_USER_ID
+def update_plan(update: PlanUpdate, user_id: str = Depends(get_current_user)):
     plan = sanitize_text(update.plan).lower()
     settings = _settings_for_user(user_id)
     preferred = settings.get("preferred_providers") or {}
@@ -1155,14 +1146,12 @@ def update_plan(update: PlanUpdate):
 
 
 @router.get("/settings")
-def get_all_settings():
-    user_id = LOCAL_USER_ID
+def get_all_settings(user_id: str = Depends(get_current_user)):
     return _settings_for_user(user_id)
 
 
 @router.post("/settings/sprint/toggle")
-def sprint_toggle():
-    user_id = LOCAL_USER_ID
+def sprint_toggle(user_id: str = Depends(get_current_user)):
     settings = _settings_for_user(user_id)
     new_state = not bool(settings.get("sprint_mode"))
     _update_settings_for_user(user_id, {"sprint_mode": new_state})
@@ -1170,15 +1159,13 @@ def sprint_toggle():
 
 
 @router.get("/settings/keys")
-def get_keys_status():
-    user_id = LOCAL_USER_ID
-    return get_ai_keys_status()
+def get_keys_status(user_id: str = Depends(get_current_user)):
+    return get_ai_keys_status(user_id=user_id)
 
 
 @router.get("/diagnose")
-async def diagnose_connectivity():
+async def diagnose_connectivity(user_id: str = Depends(get_current_user)):
     """Diagnoses network and authentication status of all configured AI providers."""
-    user_id = LOCAL_USER_ID
     import ai.generator
     import httpx
     
@@ -1247,9 +1234,8 @@ async def diagnose_connectivity():
 
 @router.post("/article/generate")
 @limiter.limit("5/minute")
-async def generate_article(request: Request, body: ArticleGenerateRequest):
+async def generate_article(request: Request, body: ArticleGenerateRequest, user_id: str = Depends(get_current_user)):
     """Generates a full technical article from sprint context."""
-    user_id = LOCAL_USER_ID
     if not CURRENT_DRAFT.exists():
         raise HTTPException(status_code=400, detail="No active draft to generate article from.")
 
@@ -1285,9 +1271,8 @@ async def generate_article(request: Request, body: ArticleGenerateRequest):
 
 
 @router.post("/article/refine")
-async def refine_article(request: ArticleRefineRequest):
+async def refine_article(request: ArticleRefineRequest, user_id: str = Depends(get_current_user)):
     """Refines an article draft based on user instructions."""
-    user_id = LOCAL_USER_ID
     current_article = sanitize_text(request.current_article)
     instruction = sanitize_text(request.instruction)
     injection = check_prompt_injection(instruction)
@@ -1315,8 +1300,7 @@ def thread_split(request: ThreadSplitRequest):
 
 
 @router.post("/posts/verify")
-async def verify_logged_post(request: PostVerifyRequest):
-    user_id = LOCAL_USER_ID
+async def verify_logged_post(request: PostVerifyRequest, user_id: str = Depends(get_current_user)):
     post_id = sanitize_text(request.post_id)
     post_url = sanitize_text(request.post_url or "")
     result = await safe_update_post(post_id, {
@@ -1332,8 +1316,7 @@ async def verify_logged_post(request: PostVerifyRequest):
 
 
 @router.post("/posts/decline")
-async def decline_logged_post(request: PostDeclineRequest):
-    user_id = LOCAL_USER_ID
+async def decline_logged_post(request: PostDeclineRequest, user_id: str = Depends(get_current_user)):
     result = await safe_update_post(sanitize_text(request.post_id), {"declined": True})
     if not result:
         raise HTTPException(status_code=404, detail="post not found")
@@ -1346,8 +1329,7 @@ async def unverified_posts():
 
 
 @router.post("/metrics/save")
-async def save_post_metrics(request: MetricsSaveRequest):
-    user_id = LOCAL_USER_ID
+async def save_post_metrics(request: MetricsSaveRequest, user_id: str = Depends(get_current_user)):
     values = {
         "impressions": request.impressions,
         "likes": request.likes,
@@ -1422,9 +1404,9 @@ async def get_post_metrics(post_id: str):
 
 
 @router.get("/insights")
-async def get_insights():
+async def get_insights(user_id: str = Depends(get_current_user)):
     now = time.time()
-    cache_key = f"data:{LOCAL_USER_ID}"
+    cache_key = f"data:{user_id}"
     if _INSIGHTS_CACHE.get(cache_key) is not None and now - _INSIGHTS_CACHE["timestamp"] < 3600:
         return _INSIGHTS_CACHE[cache_key]
     

{gitcast-1.0.4 → gitcast-1.0.6}/cli/gitcast.py

@@ -7,8 +7,8 @@ import webbrowser
 
 def main():
     if "--setup" in sys.argv:
-        env_path = os.path.join(
-            os.path.dirname(__file__), '..', '.env')
+        from config.settings import get_active_env_path
+        env_path = str(get_active_env_path(for_write=True))
         example_path = os.path.join(
             os.path.dirname(__file__), '..', '.env.example')
         if not os.path.exists(example_path):

{gitcast-1.0.4 → gitcast-1.0.6}/config/settings.py

@@ -5,11 +5,55 @@ from pathlib import Path
 from dotenv import load_dotenv
 
 
+import sys
+
 BASE_DIR = Path(__file__).resolve().parent.parent
 CONFIG_DIR = BASE_DIR / "config"
-load_dotenv(BASE_DIR / ".env")
-if not os.getenv("SUPABASE_URL"):
-    load_dotenv(Path(os.getcwd()) / ".env")
+
+def get_env_paths() -> list:
+    paths = []
+    # 1. Custom env path
+    custom_path = os.getenv("GITCAST_ENV_PATH")
+    if custom_path:
+        paths.append(Path(custom_path))
+    # 2. Current working directory
+    paths.append(Path(os.getcwd()) / ".env")
+    # 3. Virtual environment parent
+    if hasattr(sys, "prefix") and sys.prefix:
+        paths.append(Path(sys.prefix).parent / ".env")
+    # 4. User home directories
+    paths.append(Path.home() / ".gitcast" / ".env")
+    paths.append(Path.home() / ".gitcast.env")
+    # 5. Base directory
+    paths.append(BASE_DIR / ".env")
+    return [p for p in paths if p]
+
+def load_all_dotenvs(override: bool = False) -> None:
+    paths = get_env_paths()
+    if override:
+        for p in reversed(paths):
+            if p.exists() and p.is_file():
+                load_dotenv(p, override=True)
+    else:
+        for p in paths:
+            if p.exists() and p.is_file():
+                load_dotenv(p, override=False)
+
+def get_active_env_path(for_write: bool = False) -> Path:
+    paths = get_env_paths()
+    for p in paths:
+        if p.exists() and p.is_file():
+            return p
+    if for_write:
+        home_env = Path.home() / ".gitcast" / ".env"
+        try:
+            home_env.parent.mkdir(parents=True, exist_ok=True)
+            return home_env
+        except Exception:
+            pass
+    return BASE_DIR / ".env"
+
+load_all_dotenvs()
 STORAGE_DIR = BASE_DIR / "storage" / "data"
 POSTHOG_API_KEY = os.getenv("POSTHOG_API_KEY", "")
 SENTRY_DSN = os.getenv("SENTRY_DSN", "")
@@ -65,8 +109,13 @@ def reload_api_keys() -> None:
     global GEMINI_MODEL
     global CEREBRAS_MODEL
     global OPENROUTER_MODEL
+    global SUPABASE_URL
+    global SUPABASE_SERVICE_KEY
+    global SUPABASE_ANON_KEY
+    global SUPABASE_JWT_SECRET
+    global SUPABASE_JWT_AUDIENCE
 
-    load_dotenv(BASE_DIR / ".env", override=True)
+    load_all_dotenvs(override=True)
     GROQ_API_KEY = os.getenv("GROQ_API_KEY", "")
     MOONSHOT_API_KEY = os.getenv("MOONSHOT_API_KEY", "")
     GEMINI_API_KEY = os.getenv("GEMINI_API_KEY", "")
@@ -77,6 +126,12 @@ def reload_api_keys() -> None:
     GEMINI_MODEL = os.getenv("GEMINI_MODEL", "gemini-2.0-flash")
     CEREBRAS_MODEL = os.getenv("CEREBRAS_MODEL", "gpt-oss-120b")
     OPENROUTER_MODEL = os.getenv("OPENROUTER_MODEL", "qwen/qwen3-coder:free")
+    
+    SUPABASE_URL = os.getenv("SUPABASE_URL", "")
+    SUPABASE_SERVICE_KEY = os.getenv("SUPABASE_SERVICE_KEY", "")
+    SUPABASE_ANON_KEY = os.getenv("SUPABASE_ANON_KEY", "")
+    SUPABASE_JWT_SECRET = os.getenv("SUPABASE_JWT_SECRET", "")
+    SUPABASE_JWT_AUDIENCE = os.getenv("SUPABASE_JWT_AUDIENCE", "authenticated")
 
 
 reload_api_keys()

gitcast-1.0.6/docs/pypi-errors.md

@@ -0,0 +1,68 @@
+# PyPI Release & Execution Issues Log
+
+This document records the issues faced during the testing, packaging, and execution of `gitcast` on PyPI, along with their resolutions and current active status.
+
+---
+
+## 1. Resolved Issues
+
+### Fixed in `gitcast==1.0.6`
+
+#### Issue 1.4: FastAPI Server Rate Limiting on Localhost
+* **Symptom**: Browser console logs API call failures when calling `api/article/generate` or other endpoints via the dashboard UI with a 429 Too Many Requests status code.
+* **Root Cause**: The FastAPI server used slowapi's default `get_remote_address` rate-limiting key, which rate-limited local requests when they exceeded the threshold (e.g. 5/minute for article generation).
+* **Resolution**: Replaced the default `get_remote_address` with a custom `get_client_ip` function in `api/ratelimit.py`. This function returns `None` for any localhost client (`127.0.0.1`, `localhost`, `::1`), which tells slowapi to bypass rate limiting completely for local executions.
+
+#### Issue 1.5: BYOK (Bring Your Own Key) Feature Ignored Authenticated Users
+* **Symptom**: When a user logged in via GitHub/Supabase and configured their own provider keys (BYOK), the server would still hit rate limits or token exhaustion on the developer's default keys.
+* **Root Cause**: In `api/routes.py`, 19 routes hardcoded `user_id = LOCAL_USER_ID`. This caused the server to completely ignore the user ID of logged-in users, preventing their custom BYOK keys (stored in the Supabase DB) from being resolved and loaded.
+* **Resolution**: Updated all 19 endpoints in `api/routes.py` to accept and use the dynamically resolved user ID using FastAPI's dependency injection (`user_id: str = Depends(get_current_user)`). This allows logged-in users to load their custom keys dynamically.
+
+### Fixed in `gitcast==1.0.5`
+
+#### Issue 1.1: Supabase Configuration Load Failure
+* **Symptom**: Running `gitcast` from an external directory (e.g. `C:\Users\USER\Documents\snakegame`) outputs:
+  ```text
+  [STORAGE] Supabase get_posts failed: SUPABASE_URL and SUPABASE_SERVICE_KEY must be configured. Falling back to local JSON.
+  ```
+* **Root Cause**: The dynamic resolution of `BASE_DIR = Path(__file__).resolve().parent.parent` in `settings.py` evaluated to Python's virtualenv `site-packages/gitcast/` directory rather than the active workspace directory. As a result, the `.env` file containing the Supabase keys was not found.
+* **Resolution**: Replaced the direct loading of `BASE_DIR / ".env"` with a multi-path environment file loader. It now searches the following locations in order of priority:
+  1. A custom path defined in `GITCAST_ENV_PATH`
+  2. The current working directory (`os.getcwd() / ".env"`)
+  3. The parent directory of the active virtual environment (`sys.prefix / ".." / ".env"`), resolving to `context-engine/.env`
+  4. Standard user directories (`~/.gitcast/.env` and `~/.gitcast.env`)
+  5. The fallback package directory (`BASE_DIR / ".env"`)
+
+#### Issue 1.2: UI Settings/BYOK Writes to Package Internals
+* **Symptom**: Saving API keys via the dashboard (BYOK feature) or running `gitcast --setup` would write to `site-packages/gitcast/.env`, which was volatile (deleted on package updates) and sometimes generated permission access errors.
+* **Resolution**: Updated `api/routes.py` and `cli/gitcast.py` to write to the resolved active `.env` file, falling back to a persistent user-home folder `~/.gitcast/.env` if no local env file existed.
+
+#### Issue 1.3: Package Build Failure (`bdist_wheel` Invalid Command)
+* **Symptom**: Attempting to package the build output using `python setup.py sdist bdist_wheel` generated the error:
+  ```text
+  error: invalid command 'bdist_wheel'
+  ```
+* **Root Cause**: The `wheel` package was not installed in the python environment, causing `setuptools` to not register the command.
+* **Resolution**: Installed `wheel` package (`pip install wheel`) prior to building, enabling setuptools to build the binary wheel package successfully.
+
+---
+
+## 2. Active Issues (To be Addressed)
+
+### Issue 2.1: Post Generation Fails silently (gitcast>=1.0.5)
+* **Symptom**: `gitcast` starts up successfully, the FastAPI server listens on `http://127.0.0.1:8000`, the pygame modules load, and the CLI runs, but the application does not generate posts.
+* **Console Logs**:
+  ```text
+  (venv) PS C:\Users\USER\Documents\snakegame> gitcast
+  [Monitoring] Sentry not configured - skipping
+
+  [Auth] Session Token: 549cfdc2-c987-416d-8a70-8b0dc5f2315b
+  [Server] Starting Gitcast API on http://127.0.0.1:8000
+
+  [Auth] Session Token: 549cfdc2-c987-416d-8a70-8b0dc5f2315b
+  [Server] Starting Gitcast API on http://127.0.0.1:8000
+  pygame 2.6.1 (SDL 2.28.4, Python 3.10.0)
+  Hello from the pygame community. https://www.pygame.org/contribute.html
+  ```
+* **Status**: Logged and waiting for future triage. The application starts, but key bindings or endpoints triggers are failing to generate the actual post output.
+

{gitcast-1.0.4 → gitcast-1.0.6/gitcast.egg-info}/PKG-INFO

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

{gitcast-1.0.4 → gitcast-1.0.6}/gitcast.egg-info/SOURCES.txt

@@ -52,6 +52,7 @@ docs/insights.md
 docs/introduction.md
 docs/post-formats.md
 docs/providers.md
+docs/pypi-errors.md
 docs/quickstart.md
 docs/sprint-mode.md
 gitcast.egg-info/PKG-INFO

{gitcast-1.0.4 → gitcast-1.0.6}/setup.py

@@ -1,6 +1,38 @@
 import os
+import shutil
 from setuptools import setup, find_packages
 
+# Monkeypatch copystat, os.link, chmod, and utime to avoid "Operation not permitted" errors under WSL mounts
+try:
+    if hasattr(os, 'link'):
+        del os.link
+        
+    orig_chmod = os.chmod
+    def patched_chmod(path, mode, *args, **kwargs):
+        try:
+            orig_chmod(path, mode, *args, **kwargs)
+        except OSError:
+            pass
+    os.chmod = patched_chmod
+
+    orig_utime = os.utime
+    def patched_utime(path, times=None, *args, **kwargs):
+        try:
+            orig_utime(path, times, *args, **kwargs)
+        except OSError:
+            pass
+    os.utime = patched_utime
+
+    orig_copystat = shutil.copystat
+    def patched_copystat(src, dst, *args, **kwargs):
+        try:
+            orig_copystat(src, dst, *args, **kwargs)
+        except OSError:
+            pass
+    shutil.copystat = patched_copystat
+except Exception:
+    pass
+
 # Read the contents of README.md
 this_directory = os.path.abspath(os.path.dirname(__file__))
 with open(os.path.join(this_directory, "README.md"), encoding="utf-8") as f:
@@ -19,7 +51,7 @@ if os.path.exists(requirements_path):
 
 setup(
     name="gitcast",
-    version="1.0.4",
+    version="1.0.6",
     description="git diff → published post. under 60 seconds.",
     long_description=long_description,
     long_description_content_type="text/markdown",

{gitcast-1.0.4 → gitcast-1.0.6}/storage/supabase_client.py

@@ -1,22 +1,32 @@
 import threading
 from supabase import Client, create_client, ClientOptions
-from config.settings import SUPABASE_SERVICE_KEY, SUPABASE_URL
+import config.settings
 
 _thread_local = threading.local()
 
 def get_client() -> Client:
-    if not SUPABASE_URL or not SUPABASE_SERVICE_KEY:
+    url = getattr(config.settings, "SUPABASE_URL", "")
+    key = getattr(config.settings, "SUPABASE_SERVICE_KEY", "")
+    if not url or not key:
         raise RuntimeError("SUPABASE_URL and SUPABASE_SERVICE_KEY must be configured")
     
+    # Check if config changed and recreate if needed
+    if hasattr(_thread_local, "client"):
+        if getattr(_thread_local, "client_url", None) != url or getattr(_thread_local, "client_key", None) != key:
+            if hasattr(_thread_local, "client"):
+                delattr(_thread_local, "client")
+
     if not hasattr(_thread_local, "client"):
         _thread_local.client = create_client(
-            SUPABASE_URL,
-            SUPABASE_SERVICE_KEY,
+            url,
+            key,
             options=ClientOptions(
                 postgrest_client_timeout=10,
                 storage_client_timeout=10
             )
         )
+        _thread_local.client_url = url
+        _thread_local.client_key = key
     return _thread_local.client
 
 

gitcast-1.0.4/api/ratelimit.py

@@ -1,9 +0,0 @@
-from slowapi import Limiter
-from slowapi.util import get_remote_address
-
-
-limiter = Limiter(key_func=get_remote_address, default_limits=["60/minute"], headers_enabled=False)
-
-
-if __name__ == "__main__":
-    print("[RateLimit] Default limit: 60/minute")