reprompt-cli 2.4.0__tar.gz → 2.5.0__tar.gz

reprompt_cli-2.5.0/.github/ISSUE_TEMPLATE/feedback.yml

@@ -0,0 +1,32 @@
+name: Feedback
+description: Share your experience, ideas, or anything on your mind
+labels: ["feedback"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        We'd love to hear from you — what's working, what's not, or any ideas you have.
+  - type: textarea
+    id: feedback
+    attributes:
+      label: Your feedback
+      description: Tell us anything — what you like, what could be better, or what you wish existed.
+      placeholder: "I tried reprompt rewrite and..."
+    validations:
+      required: true
+  - type: input
+    id: commands
+    attributes:
+      label: Which commands do you use most?
+      placeholder: "rewrite, check, patterns"
+  - type: input
+    id: tools
+    attributes:
+      label: Which AI tools do you use?
+      placeholder: "Claude Code, Cursor, ChatGPT"
+  - type: input
+    id: version
+    attributes:
+      label: reprompt version
+      description: "Run: reprompt --version"
+      placeholder: "2.4.1"

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reprompt-cli
-Version: 2.4.0
+Version: 2.5.0
 Summary: Discover, analyze, and optimize your prompts from AI coding sessions
 Project-URL: Homepage, https://github.com/reprompt-dev/reprompt
 Project-URL: Repository, https://github.com/reprompt-dev/reprompt
@@ -114,6 +114,7 @@ $ reprompt check "Fix the auth bug in src/login.ts where JWT expires"
 | `reprompt agent` | Agent workflow analysis -- error loops, tool patterns, session efficiency |
 | `reprompt sessions` | Session quality scores with frustration signal detection |
 | `reprompt repetition` | Cross-session repetition detection -- spot recurring prompts |
+| `reprompt patterns` | **Personal prompt weaknesses** -- recurring gaps by task type |
 | `reprompt projects` | Per-project quality breakdown -- sessions, scores, frustration signals |
 
 ### Optimize
@@ -210,7 +211,7 @@ reprompt install-hook               # adds post-session hook to Claude Code
 
 ### Browser extension
 
-Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser. Live score badge shows prompt quality as you type.
+Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser. Live score badge shows prompt quality as you type — click "Rewrite & Apply" to improve your prompt and replace the text directly in the input box.
 
 1. **Install the extension** from [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn) or [Firefox Add-ons](https://addons.mozilla.org/addon/reprompt-cli/)
 2. **Connect to the CLI:** `reprompt install-extension`
@@ -224,13 +225,40 @@ Captured prompts sync locally via Native Messaging -- nothing leaves your machin
 
 ```yaml
 # .github/workflows/prompt-lint.yml
-- uses: reprompt-dev/reprompt@main
-  with:
-    score-threshold: 50   # fail if avg prompt score < 50
-    strict: true          # fail on warnings too
-    comment-on-pr: true   # post quality report as PR comment
+name: Prompt Quality
+on: pull_request
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write    # needed for PR comments
+    steps:
+      - uses: actions/checkout@v4
+      - uses: reprompt-dev/reprompt@main
+        with:
+          score-threshold: 50   # fail if avg prompt score < 50
+          strict: true          # fail on warnings too
+          comment-on-pr: true   # post quality report as PR comment
 ```
 
+When `comment-on-pr: true`, every PR gets a quality report:
+
+```
+## reprompt lint 🟢 Passed
+
+| Metric          | Value          |
+|-----------------|----------------|
+| Prompts checked | 12             |
+| Errors          | 0              |
+| Warnings        | 2              |
+| Avg Score       | 62/100 ✅ (threshold: 50) |
+
+📋 2 violation(s) [click to expand]
+```
+
+The comment updates on each push — no duplicates. Uses `GITHUB_TOKEN` (no extra secrets needed).
+
 #### pre-commit
 
 ```yaml

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/README.md

@@ -69,6 +69,7 @@ $ reprompt check "Fix the auth bug in src/login.ts where JWT expires"
 | `reprompt agent` | Agent workflow analysis -- error loops, tool patterns, session efficiency |
 | `reprompt sessions` | Session quality scores with frustration signal detection |
 | `reprompt repetition` | Cross-session repetition detection -- spot recurring prompts |
+| `reprompt patterns` | **Personal prompt weaknesses** -- recurring gaps by task type |
 | `reprompt projects` | Per-project quality breakdown -- sessions, scores, frustration signals |
 
 ### Optimize
@@ -165,7 +166,7 @@ reprompt install-hook               # adds post-session hook to Claude Code
 
 ### Browser extension
 
-Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser. Live score badge shows prompt quality as you type.
+Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser. Live score badge shows prompt quality as you type — click "Rewrite & Apply" to improve your prompt and replace the text directly in the input box.
 
 1. **Install the extension** from [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn) or [Firefox Add-ons](https://addons.mozilla.org/addon/reprompt-cli/)
 2. **Connect to the CLI:** `reprompt install-extension`
@@ -179,13 +180,40 @@ Captured prompts sync locally via Native Messaging -- nothing leaves your machin
 
 ```yaml
 # .github/workflows/prompt-lint.yml
-- uses: reprompt-dev/reprompt@main
-  with:
-    score-threshold: 50   # fail if avg prompt score < 50
-    strict: true          # fail on warnings too
-    comment-on-pr: true   # post quality report as PR comment
+name: Prompt Quality
+on: pull_request
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write    # needed for PR comments
+    steps:
+      - uses: actions/checkout@v4
+      - uses: reprompt-dev/reprompt@main
+        with:
+          score-threshold: 50   # fail if avg prompt score < 50
+          strict: true          # fail on warnings too
+          comment-on-pr: true   # post quality report as PR comment
 ```
 
+When `comment-on-pr: true`, every PR gets a quality report:
+
+```
+## reprompt lint 🟢 Passed
+
+| Metric          | Value          |
+|-----------------|----------------|
+| Prompts checked | 12             |
+| Errors          | 0              |
+| Warnings        | 2              |
+| Avg Score       | 62/100 ✅ (threshold: 50) |
+
+📋 2 violation(s) [click to expand]
+```
+
+The comment updates on each push — no duplicates. Uses `GITHUB_TOKEN` (no extra secrets needed).
+
 #### pre-commit
 
 ```yaml

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reprompt-cli"
-version = "2.4.0"
+version = "2.5.0"
 description = "Discover, analyze, and optimize your prompts from AI coding sessions"
 readme = "README.md"
 license = { text = "MIT" }

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/src/reprompt/__init__.py

@@ -1,6 +1,6 @@
 """reprompt — Discover, analyze, and evolve your best prompts from AI coding sessions."""
 
-__version__ = "2.0.2"
+__version__ = "2.5.0"
 
 __all__ = [
     "__version__",

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/src/reprompt/cli.py

@@ -55,6 +55,22 @@ app = typer.Typer(
 )
 console = Console()
 
+
+def _show_hint(db: object, command: str, *, json_output: bool = False) -> None:
+    """Show journey hint or one-time feedback hint after a command."""
+    if json_output:
+        return
+    from reprompt.core.suggestions import get_suggestion, maybe_feedback_hint
+
+    fb = maybe_feedback_hint(db, command)
+    if fb:
+        console.print(f"  [dim]\u2192 {fb}[/dim]\n")
+        return
+    hint = get_suggestion(command)
+    if hint:
+        console.print(f"  [dim]\u2192 Try: {hint}[/dim]\n")
+
+
 # --- Template sub-app ---
 template_app = typer.Typer(help="Manage prompt templates.", invoke_without_command=True)
 
@@ -320,11 +336,8 @@ def scan(
         console.print("  reprompt template list         — see your prompt patterns")
         console.print("  reprompt insights             — personal analysis")
     else:
-        from reprompt.core.suggestions import get_suggestion
-
-        hint = get_suggestion("scan")
-        if hint and result.unique_after_dedup > 0:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        if result.unique_after_dedup > 0:
+            _show_hint(db, "scan")
 
 
 def _hook_registered() -> bool:
@@ -524,13 +537,11 @@ def report(
 
         print(format_json_report(data))
     else:
-        from reprompt.core.suggestions import get_suggestion
         from reprompt.output.terminal import render_report
+        from reprompt.storage.db import PromptDB
 
         print(render_report(data), end="")
-        hint = get_suggestion("report")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(PromptDB(settings.db_path), "report")
 
 
 @app.command(deprecated=True, hidden=True)
@@ -1017,11 +1028,11 @@ def check(
     if copy:
         _copy_to_clip(result.rewritten, quiet=json_output)
 
-    from reprompt.core.suggestions import get_suggestion
+    if not json_output:
+        from reprompt.config import Settings as _S
+        from reprompt.storage.db import PromptDB as _DB
 
-    hint = get_suggestion("check")
-    if hint and not json_output:
-        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+        _show_hint(_DB(_S().db_path), "check", json_output=json_output)
 
 
 @app.command(rich_help_panel="Analyze")
@@ -1063,11 +1074,11 @@ def explain(
 
         typer.echo(render_explain(result))
 
-    from reprompt.core.suggestions import get_suggestion
+    if not json_output:
+        from reprompt.config import Settings as _S
+        from reprompt.storage.db import PromptDB as _DB
 
-    hint = get_suggestion("explain")
-    if hint and not json_output:
-        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+        _show_hint(_DB(_S().db_path), "explain", json_output=json_output)
 
 
 @app.command(rich_help_panel="Analyze")
@@ -1171,11 +1182,10 @@ def score(
             ],
         }
         typer.echo(render_score(data))
-        from reprompt.core.suggestions import get_suggestion
+        from reprompt.config import Settings as _S
+        from reprompt.storage.db import PromptDB as _DB
 
-        hint = get_suggestion("score")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(_DB(_S().db_path), "score")
 
     if copy:
         import json as json_mod
@@ -1281,11 +1291,11 @@ def rewrite(
     if copy:
         _copy_to_clip(result.rewritten, quiet=json_output)
 
-    from reprompt.core.suggestions import get_suggestion
+    if not json_output:
+        from reprompt.config import Settings as _S
+        from reprompt.storage.db import PromptDB as _DB
 
-    hint = get_suggestion("rewrite")
-    if hint and not json_output:
-        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+        _show_hint(_DB(_S().db_path), "rewrite", json_output=json_output)
 
 
 @app.command(rich_help_panel="Optimize")
@@ -1348,11 +1358,11 @@ def build(
     if copy:
         _copy_to_clip(result.prompt, quiet=json_output)
 
-    from reprompt.core.suggestions import get_suggestion
+    if not json_output:
+        from reprompt.config import Settings as _S
+        from reprompt.storage.db import PromptDB as _DB
 
-    hint = get_suggestion("build")
-    if hint and not json_output:
-        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+        _show_hint(_DB(_S().db_path), "build", json_output=json_output)
 
 
 @app.command(rich_help_panel="Optimize")
@@ -1505,11 +1515,7 @@ def distill(
             else:
                 parts.append(render_distill(result))
         typer.echo("\n---\n".join(parts) if len(parts) > 1 else parts[0])
-        from reprompt.core.suggestions import get_suggestion
-
-        hint = get_suggestion("distill")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(db, "distill")
 
     if copy:
         if summary:
@@ -1794,7 +1800,6 @@ def insights(
         result["cross_session_repetition"] = rep_data
         typer.echo(json_mod.dumps(result, indent=2))
     else:
-        from reprompt.core.suggestions import get_suggestion
         from reprompt.output.terminal import (
             render_effectiveness_section,
             render_insights,
@@ -1824,9 +1829,7 @@ def insights(
                 console.print(f'    "{t["canonical_text"]}" \u2014 {t["session_count"]} sessions')
             console.print("  [dim]\u2192 Try: reprompt repetition (full analysis)[/dim]")
 
-        hint = get_suggestion("insights")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(db, "insights")
 
     if copy:
         import json as json_mod
@@ -1982,13 +1985,10 @@ def digest(
     if format == "json":
         print(json_mod.dumps(data, indent=2, default=str))
     else:
-        from reprompt.core.suggestions import get_suggestion
         from reprompt.output.terminal import render_digest
 
         print(render_digest(data), end="")
-        hint = get_suggestion("digest")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(db, "digest")
 
     if trends_flag:
         from reprompt.core.trends import compute_trends
@@ -2291,6 +2291,29 @@ debug-needs-reference = true
     console.print("  Edit rules, then run [bold]reprompt lint[/bold] to verify.")
 
 
+@app.command(rich_help_panel="Setup")
+def feedback() -> None:
+    """Open the feedback form — share your experience, ideas, or suggestions.
+
+    Opens a GitHub issue template in your browser. No account required to view,
+    but you'll need a GitHub account to submit.
+
+    Examples:
+
+        reprompt feedback
+    """
+    import webbrowser
+
+    from reprompt.core.suggestions import FEEDBACK_URL
+
+    console.print(
+        "\n  [bold]We'd love to hear from you![/bold]\n  Opening feedback form in your browser...\n"
+    )
+    opened = webbrowser.open(FEEDBACK_URL)
+    if not opened:
+        console.print(f"  [dim]Could not open browser. Visit:[/dim]\n  {FEEDBACK_URL}\n")
+
+
 @app.command(rich_help_panel="Analyze")
 def projects(
     source: str = typer.Option(
@@ -2335,11 +2358,7 @@ def projects(
         else:
             _copy_to_clip(output)
 
-    from reprompt.core.suggestions import get_suggestion
-
-    hint = get_suggestion("projects")
-    if hint and not json_output:
-        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+    _show_hint(db, "projects", json_output=json_output)
 
 
 @app.command(rich_help_panel="Analyze")
@@ -2385,12 +2404,7 @@ def sessions(
             typer.echo(json_mod.dumps(data, indent=2, default=str))
         else:
             typer.echo(render_sessions_table(data), nl=False)
-
-            from reprompt.core.suggestions import get_suggestion
-
-            hint = get_suggestion("sessions")
-            if hint:
-                console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+            _show_hint(db, "sessions")
 
     if copy:
         if detail:
@@ -2426,6 +2440,7 @@ def patterns(
         typer.echo(json_mod.dumps(asdict(report), indent=2, default=str))
     else:
         typer.echo(render_patterns(report), nl=False)
+        _show_hint(db, "patterns", json_output=json_output)
 
     if copy:
         copy_text = json_mod.dumps(asdict(report), indent=2, default=str)
@@ -2458,12 +2473,7 @@ def repetition(
         typer.echo(json_mod.dumps(asdict(report), indent=2, default=str))
     else:
         typer.echo(render_repetition_report(report), nl=False)
-
-        from reprompt.core.suggestions import get_suggestion
-
-        hint = get_suggestion("repetition")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(db, "repetition")
 
     if copy:
         copy_text = json_mod.dumps(asdict(report), indent=2, default=str)
@@ -2528,12 +2538,7 @@ def agent(
         from reprompt.output.agent_terminal import render_agent_report
 
         typer.echo(render_agent_report(agg), nl=False)
-
-        from reprompt.core.suggestions import get_suggestion
-
-        hint = get_suggestion("agent")
-        if hint:
-            console.print(f"\n  [dim]\u2192 Try: {hint}[/dim]")
+        _show_hint(db, "agent")
 
     if copy:
         import json as json_mod

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/src/reprompt/core/extractors.py

@@ -362,13 +362,11 @@ def _find_instruction_position(segments: list[PromptSegment]) -> float:
         # No instruction found -- default to start (assume the whole thing is instruction)
         return 0.0
 
-    # Single-segment prompt: the instruction starts at the beginning
-    if len(segments) == 1 and instruction_segments[0] is segments[0]:
-        return 0.0
-
-    # Multi-segment: use the midpoint of the first instruction segment
+    # Use the start position of the first instruction segment.
+    # Not the midpoint — the instruction *starts* at start_pos,
+    # and that's what matters for the Lost in the Middle effect.
     seg = instruction_segments[0]
-    return (seg.start_pos + seg.end_pos) / 2
+    return seg.start_pos
 
 
 def _classify_distribution(segments: list[PromptSegment]) -> str:

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/src/reprompt/core/suggestions.py

@@ -2,6 +2,11 @@
 
 from __future__ import annotations
 
+import sys
+
+FEEDBACK_URL = "https://github.com/reprompt-dev/reprompt/issues/new?template=feedback.yml"
+FEEDBACK_COMMANDS_THRESHOLD = 5  # show feedback hint after 5 distinct commands used
+
 SUGGESTIONS: dict[str, str] = {
     "scan": "reprompt report (see results) · reprompt insights (personal patterns)",
     "report": "reprompt insights (patterns) · reprompt distill --last (session review)",
@@ -35,3 +40,26 @@ SUGGESTIONS: dict[str, str] = {
 def get_suggestion(command: str) -> str | None:
     """Return the suggestion line for a command, or None."""
     return SUGGESTIONS.get(command)
+
+
+def maybe_feedback_hint(db: object, command: str) -> str | None:
+    """Return a one-time feedback hint if the user has used enough commands.
+
+    Returns the hint string (replacing the journey hint) exactly once,
+    then never again. Returns None in non-TTY / CI / JSON contexts.
+    """
+    if not sys.stdout.isatty():
+        return None
+    if hasattr(db, "get_setting") and db.get_setting("feedback_hint_shown"):  # type: ignore[union-attr]
+        return None
+    # Track distinct commands used
+    used_raw = db.get_setting("commands_used") if hasattr(db, "get_setting") else None  # type: ignore[union-attr]
+    used: set[str] = set(used_raw.split(",")) if used_raw else set()
+    used.add(command)
+    if hasattr(db, "set_setting"):
+        db.set_setting("commands_used", ",".join(sorted(used)))  # type: ignore[union-attr]
+    if len(used) >= FEEDBACK_COMMANDS_THRESHOLD:
+        if hasattr(db, "set_setting"):
+            db.set_setting("feedback_hint_shown", "1")  # type: ignore[union-attr]
+        return "Feedback or ideas? reprompt feedback"
+    return None

reprompt_cli-2.5.0/tests/test_feedback.py

@@ -0,0 +1,89 @@
+"""Tests for feedback hint and command tracking."""
+
+from __future__ import annotations
+
+from unittest.mock import MagicMock, patch
+
+from reprompt.core.suggestions import (
+    FEEDBACK_COMMANDS_THRESHOLD,
+    FEEDBACK_URL,
+    maybe_feedback_hint,
+)
+
+
+class TestFeedbackHint:
+    def _make_db(self, settings: dict[str, str] | None = None) -> MagicMock:
+        """Create a mock DB with get_setting/set_setting."""
+        store: dict[str, str] = dict(settings) if settings else {}
+        db = MagicMock()
+        db.get_setting = MagicMock(side_effect=lambda k: store.get(k))
+
+        def _set(k: str, v: str) -> None:
+            store[k] = v
+
+        db.set_setting = MagicMock(side_effect=_set)
+        db._store = store  # expose for assertions
+        return db
+
+    def test_returns_none_when_not_tty(self):
+        db = self._make_db()
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = False
+            assert maybe_feedback_hint(db, "score") is None
+
+    def test_returns_none_when_already_shown(self):
+        db = self._make_db({"feedback_hint_shown": "1"})
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            assert maybe_feedback_hint(db, "score") is None
+
+    def test_tracks_commands_used(self):
+        db = self._make_db()
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            maybe_feedback_hint(db, "score")
+            assert "score" in db._store.get("commands_used", "")
+
+    def test_returns_none_below_threshold(self):
+        db = self._make_db()
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            # Only 1 command used
+            result = maybe_feedback_hint(db, "score")
+            assert result is None
+
+    def test_returns_hint_at_threshold(self):
+        # Pre-populate with threshold - 1 commands
+        cmds = ["score", "rewrite", "check", "patterns"]
+        assert len(cmds) == FEEDBACK_COMMANDS_THRESHOLD - 1
+        db = self._make_db({"commands_used": ",".join(cmds)})
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            result = maybe_feedback_hint(db, "insights")  # 5th unique command
+            assert result is not None
+            assert "feedback" in result
+
+    def test_marks_shown_after_trigger(self):
+        cmds = ["score", "rewrite", "check", "patterns"]
+        db = self._make_db({"commands_used": ",".join(cmds)})
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            maybe_feedback_hint(db, "insights")
+            assert db._store.get("feedback_hint_shown") == "1"
+
+    def test_duplicate_commands_dont_count(self):
+        db = self._make_db()
+        with patch("reprompt.core.suggestions.sys") as mock_sys:
+            mock_sys.stdout.isatty.return_value = True
+            result = None
+            for _ in range(10):
+                result = maybe_feedback_hint(db, "score")
+            # Only 1 unique command, should not trigger
+            assert result is None
+
+    def test_feedback_url_is_valid(self):
+        assert "github.com" in FEEDBACK_URL
+        assert "feedback" in FEEDBACK_URL
+
+    def test_threshold_is_reasonable(self):
+        assert 3 <= FEEDBACK_COMMANDS_THRESHOLD <= 10

{reprompt_cli-2.4.0 → reprompt_cli-2.5.0}/uv.lock

@@ -2210,7 +2210,7 @@ wheels = [
 
 [[package]]
 name = "reprompt-cli"
-version = "2.4.0"
+version = "2.5.0"
 source = { editable = "." }
 dependencies = [
     { name = "pydantic-settings" },