gitcast 1.0.17__tar.gz → 1.0.18__tar.gz

{gitcast-1.0.17/gitcast.egg-info → gitcast-1.0.18}/PKG-INFO

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

{gitcast-1.0.17 → gitcast-1.0.18}/ai/prompts.py

@@ -54,6 +54,7 @@ Rules:
   or the developer's raw thought. If the available
   context is thin or unclear, write a short, honest,
   low-key post rather than fabricating details.
+- If a git diff is provided, it is the primary source of truth. Screen text is secondary and may be noisy — ignore any browser UI text.
 - If OCR text looks like browser UI, tab names, or
   garbled text rather than code, IGNORE it completely
   and rely only on the raw thought and git diff.

{gitcast-1.0.17 → gitcast-1.0.18}/api/payload.py

@@ -104,13 +104,6 @@ def _build_user_message(
     if raw_thought.strip():
         parts.append(f"## Developer's raw thought\n{raw_thought.strip()}")
 
-    parts.append(
-        "## Priority\n"
-        "If a git diff is present below, treat it as "
-        "the primary source of truth for what changed. "
-        "Screen text is secondary context only."
-    )
-
     # git diff section comes first
     diff_text = git_diff.get("diff", "") if isinstance(git_diff, dict) else ""
     if diff_text:
@@ -118,13 +111,6 @@ def _build_user_message(
 
     # check if OCR text is fragmented
     ocr_text = "\n\n".join([s.get("ocr_text", "") for s in screenshots if s.get("ocr_text")]).strip()
-    if len(ocr_text.strip()) < 80:
-        parts.append(
-            "## Note\n"
-            "Screen context is fragmented/unreliable — "
-            "do not base the post on it. Rely on the "
-            "developer's raw thought and git diff only."
-        )
 
     # OCR section comes second, clearly labeled
     if ocr_text and not use_vision:
@@ -208,35 +194,55 @@ def _encode_image(image_path: str) -> str:
 
 # ── Payload validator ─────────────────────────────────────────────────────────
 
+GENERIC_THOUGHTS = [
+    "captured via hotkey trigger",
+    "",
+    "test",
+    "testing",
+    "...",
+    "thought",
+]
+
 def validate_payload(payload: dict) -> tuple[bool, list[str]]:
     """
     Checks the payload has the minimum viable content to generate a post.
     Returns (is_valid, list_of_warnings).
     """
     warnings = []
+
     raw_thought = payload.get("raw_thought", "").strip()
     ocr_text = payload.get("ocr_text", "").strip()
+    git_diff = payload.get("git_diff", "").strip()
     git_diff_available = payload.get("git_diff_available", False)
 
-    generic_thoughts = [
-        "captured via hotkey trigger",
-        "", "test", "testing",
-    ]
-    is_generic = raw_thought.lower() in generic_thoughts
-
-    has_real_content = (
-        not is_generic or
-        len(ocr_text) > 100 or
-        git_diff_available
+    is_generic_thought = (
+        raw_thought.lower() in GENERIC_THOUGHTS or
+        len(raw_thought) < 5
     )
+    has_real_ocr = len(ocr_text) >= 80
+    has_diff = git_diff_available and len(git_diff) > 20
+
+    # BLOCK generation if all three are weak
+    if is_generic_thought and not has_real_ocr and not has_diff:
+        return False, [
+            "Not enough context to generate a post. Please:\n"
+            "1. Capture from your code editor (not a browser)\n"
+            "2. Type a real thought about what you just built or fixed\n"
+            "3. Make sure you have uncommitted git changes for best results"
+        ]
+
+    # WARN but allow if thought is real but diff missing
+    if not has_diff:
+        warnings.append(
+            "No git diff — post will rely on your thought and screen context only."
+        )
 
-    if not has_real_content:
+    if not raw_thought or is_generic_thought:
         warnings.append(
-            "No meaningful context captured — type a "
-            "real thought or capture a code window")
+            "Generic thought detected — post quality will be lower. Try describing what you actually fixed or built."
+        )
 
-    is_valid = bool(raw_thought)  # still allow generation
-    return is_valid, warnings
+    return True, warnings
 
 
 # ── Test ──────────────────────────────────────────────────────────────────────

{gitcast-1.0.17 → gitcast-1.0.18}/api/routes.py

@@ -789,7 +789,11 @@ async def generate(request: Request, body: GenerateRequest, user_id: str = Depen
     if not is_valid:
         raise HTTPException(
             status_code=400,
-            detail="Payload has no raw thought — cannot generate posts."
+            detail={
+                "error": "insufficient_context",
+                "message": warnings[0] if warnings else "Not enough context.",
+                "warnings": warnings,
+            }
         )
 
     try:

{gitcast-1.0.17 → gitcast-1.0.18/gitcast.egg-info}/PKG-INFO

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

{gitcast-1.0.17 → gitcast-1.0.18}/setup.py

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

gitcast-1.0.18/ui/popup.py

@@ -0,0 +1,165 @@
+import tkinter as tk
+from tkinter import font as tkfont
+import threading
+
+
+# ── Constants ─────────────────────────────────────────────────────────────────
+
+POPUP_WIDTH = 520
+POPUP_HEIGHT = 120
+BG_COLOR = "#1a1a1a"
+BORDER_COLOR = "#333333"
+TEXT_COLOR = "#f0f0f0"
+PLACEHOLDER_COLOR = "#555555"
+ACCENT_COLOR = "#6366f1"  # indigo — matches tray icon
+FONT_FAMILY = "Segoe UI"
+FONT_SIZE = 13
+
+
+# ── Popup window ──────────────────────────────────────────────────────────────
+
+class CapturePopup:
+    def __init__(self, on_submit, on_dismiss):
+        """
+        Args:
+            on_submit:  Callback called with the user's raw thought string.
+            on_dismiss: Callback called when the user hits Esc or closes.
+        """
+        self.on_submit = on_submit
+        self.on_dismiss = on_dismiss
+        self.result = None
+        self.root = None
+
+    def show(self):
+        """Build and display the popup. Blocks until submitted or dismissed."""
+        self.root = tk.Tk()
+        self.root.withdraw()  # hide while building to prevent flicker
+
+        self._configure_window()
+        self._build_ui()
+        self._center_on_screen()
+        self._bind_keys()
+
+        self.root.deiconify()  # show fully built window
+        self.root.focus_force()
+        self.entry.focus_set()
+
+        self.root.mainloop()
+
+    def _configure_window(self):
+        self.root.title("")
+        self.root.configure(bg=BG_COLOR)
+        self.root.overrideredirect(True)   # removes title bar and border
+        self.root.attributes("-topmost", True)  # float above all windows
+        self.root.resizable(False, False)
+
+        # draw a 1px border using a frame
+        self.root.configure(highlightbackground=BORDER_COLOR, highlightthickness=1)
+
+    def _build_ui(self):
+        main_frame = tk.Frame(self.root, bg=BG_COLOR, padx=20, pady=16)
+        main_frame.pack(fill=tk.BOTH, expand=True)
+
+        # label
+        label_font = tkfont.Font(family=FONT_FAMILY, size=10)
+        label = tk.Label(
+            main_frame,
+            text="What was the struggle or win?",
+            bg=BG_COLOR,
+            fg=PLACEHOLDER_COLOR,
+            font=label_font,
+            anchor="w",
+        )
+        label.pack(fill=tk.X, pady=(0, 8))
+
+        # accent line under label
+        accent_line = tk.Frame(main_frame, bg=ACCENT_COLOR, height=1)
+        accent_line.pack(fill=tk.X, pady=(0, 10))
+
+        # text input
+        entry_font = tkfont.Font(family=FONT_FAMILY, size=FONT_SIZE)
+        self.entry = tk.Entry(
+            main_frame,
+            font=entry_font,
+            bg=BG_COLOR,
+            fg=TEXT_COLOR,
+            insertbackground=ACCENT_COLOR,  # cursor color
+            relief=tk.FLAT,
+            bd=0,
+            highlightthickness=0,
+        )
+        self.entry.pack(fill=tk.X)
+
+        # hint text at bottom
+        hint_font = tkfont.Font(family=FONT_FAMILY, size=9)
+        hint = tk.Label(
+            main_frame,
+            text="Enter to capture  ·  Esc to cancel",
+            bg=BG_COLOR,
+            fg=PLACEHOLDER_COLOR,
+            font=hint_font,
+            anchor="e",
+        )
+        hint.pack(fill=tk.X, pady=(10, 0))
+
+    def _center_on_screen(self):
+        self.root.update_idletasks()
+        screen_w = self.root.winfo_screenwidth()
+        screen_h = self.root.winfo_screenheight()
+        x = (screen_w - POPUP_WIDTH) // 2
+        y = int(screen_h * 0.38)  # slightly above center — feels more natural
+        self.root.geometry(f"{POPUP_WIDTH}x{POPUP_HEIGHT}+{x}+{y}")
+
+    def _bind_keys(self):
+        self.root.bind("<Return>", self._handle_submit)
+        self.root.bind("<Escape>", self._handle_dismiss)
+        self.root.bind("<FocusOut>", self._handle_focus_out)
+        self.root.protocol("WM_DELETE_WINDOW", self._handle_dismiss)
+
+    def _handle_submit(self, event=None):
+        text = self.entry.get().strip()
+        if not text:
+            # shake the entry to signal empty input
+            self._shake()
+            return
+        self.result = text
+        self.root.destroy()
+        self.on_submit(text)
+
+    def _handle_dismiss(self, event=None):
+        self.root.destroy()
+        self.on_dismiss()
+
+    def _handle_focus_out(self, event=None):
+        """Dismiss if user clicks away from the popup."""
+        self.root.destroy()
+        self.on_dismiss()
+
+    def _shake(self):
+        """Briefly shakes the window to signal empty input."""
+        x = self.root.winfo_x()
+        y = self.root.winfo_y()
+        for delta in [6, -6, 4, -4, 2, -2, 0]:
+            self.root.geometry(f"{POPUP_WIDTH}x{POPUP_HEIGHT}+{x + delta}+{y}")
+            self.root.update()
+            self.root.after(18)
+
+
+# ── Public interface ──────────────────────────────────────────────────────────
+
+def show_popup(on_submit, on_dismiss):
+    """
+    Shows the capture popup in a new thread so it doesn't block
+    the hotkey listener or the tray process.
+    """
+    def run():
+        try:
+            popup = CapturePopup(on_submit=on_submit, on_dismiss=on_dismiss)
+            popup.show()
+        except Exception as e:
+            print(f"[Gitcast] Popup display error: {e}")
+            on_dismiss()
+
+    thread = threading.Thread(target=run, daemon=True)
+    thread.start()
+    return thread

{gitcast-1.0.17 → gitcast-1.0.18}/web/index.html

@@ -2637,6 +2637,17 @@
                 }
                 if (!res.ok) {
                     const text = await res.text();
+                    let errorData = {};
+                    try {
+                        errorData = JSON.parse(text);
+                    } catch(e) {}
+                    const detail = errorData.detail || {};
+                    const error = typeof detail === 'object' ? (detail.error || '') : (detail || '');
+                    
+                    if (error.includes('insufficient_context') || res.status === 400) {
+                        showContextWarning(detail.message || errorData.message || error || text);
+                        return null;
+                    }
                     throw new Error(text || `Request failed with status ${res.status}`);
                 }
                 return res.json();
@@ -4989,7 +5000,15 @@
             }
         }
 
-        function appendLog(entry) {
+        function appendLog(entry, level = null, message = null) {
+            if (typeof entry === 'string') {
+                entry = {
+                    module: entry,
+                    level: level,
+                    message: message,
+                    time: new Date().toLocaleTimeString()
+                };
+            }
             state.logs.push(entry);
             if (state.logs.length > 50) state.logs = state.logs.slice(-50);
             if (state.logsOpen) {
@@ -4997,6 +5016,17 @@
             }
         }
 
+        function showContextWarning(message) {
+            const editor = document.getElementById('post-editor') || document.getElementById('main-editor');
+            if (editor) {
+                editor.value = '';
+                editor.placeholder = message ||
+                    'Not enough context — capture from ' +
+                    'your code editor and type a real thought.';
+            }
+            appendLog('GENERATOR', 'WARN', 'generation blocked — thin context');
+        }
+
         function renderLogs() {
             const body = document.getElementById('logs-body');
             if (!body) return;

gitcast-1.0.17/ui/popup.py

@@ -1,12 +0,0 @@
-def show_popup(on_submit, on_dismiss):
-    """
-    Tkinter popup fallback/mock.
-    Immediately submits a default thought to run the pipeline.
-    """
-    import threading
-    
-    def run():
-        print("[Gitcast] Mock popup triggered.")
-        on_submit("Captured via hotkey trigger")
-        
-    threading.Thread(target=run, daemon=True).start()