reprompt-cli 1.9.0__tar.gz → 1.10.0__tar.gz

{reprompt_cli-1.9.0 → reprompt_cli-1.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reprompt-cli
-Version: 1.9.0
+Version: 1.10.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
@@ -96,6 +96,8 @@ $ reprompt compress "I was wondering if you could please help me refactor this c
 | `reprompt insights` | Personal patterns vs research-optimal benchmarks |
 | `reprompt style` | Prompting fingerprint with `--trends` for evolution tracking |
 | `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 |
 
 ### Optimize
 
@@ -104,7 +106,8 @@ $ reprompt compress "I was wondering if you could please help me refactor this c
 | `reprompt compress "prompt"` | 4-layer prompt compression (40-60% token savings typical) |
 | `reprompt distill` | Extract important turns from conversations with 6-signal scoring |
 | `reprompt distill --export` | Recover context when a session runs out -- paste into new session |
-| `reprompt lint` | Prompt quality linter with GitHub Action support |
+| `reprompt lint` | Configurable prompt quality linter with CI/GitHub Action support |
+| `reprompt init` | Generate `.reprompt.toml` config for your project |
 
 ### Manage
 
@@ -223,6 +226,24 @@ reprompt lint --strict              # exit 1 on warnings
 reprompt lint --json                # machine-readable output
 ```
 
+#### Project configuration
+
+```bash
+reprompt init   # generates .reprompt.toml with all rules documented
+```
+
+```toml
+# .reprompt.toml (or [tool.reprompt.lint] in pyproject.toml)
+[lint]
+score-threshold = 50       # fail if avg score < 50
+
+[lint.rules]
+min-length = 20            # error if prompt < 20 chars (0 = off)
+short-prompt = 40          # warning if < 40 chars (0 = off)
+vague-prompt = true        # error on "fix it" etc (false = off)
+debug-needs-reference = true
+```
+
 ## Privacy
 
 - All analysis runs locally. No prompts leave your machine.

{reprompt_cli-1.9.0 → reprompt_cli-1.10.0}/README.md

@@ -51,6 +51,8 @@ $ reprompt compress "I was wondering if you could please help me refactor this c
 | `reprompt insights` | Personal patterns vs research-optimal benchmarks |
 | `reprompt style` | Prompting fingerprint with `--trends` for evolution tracking |
 | `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 |
 
 ### Optimize
 
@@ -59,7 +61,8 @@ $ reprompt compress "I was wondering if you could please help me refactor this c
 | `reprompt compress "prompt"` | 4-layer prompt compression (40-60% token savings typical) |
 | `reprompt distill` | Extract important turns from conversations with 6-signal scoring |
 | `reprompt distill --export` | Recover context when a session runs out -- paste into new session |
-| `reprompt lint` | Prompt quality linter with GitHub Action support |
+| `reprompt lint` | Configurable prompt quality linter with CI/GitHub Action support |
+| `reprompt init` | Generate `.reprompt.toml` config for your project |
 
 ### Manage
 
@@ -178,6 +181,24 @@ reprompt lint --strict              # exit 1 on warnings
 reprompt lint --json                # machine-readable output
 ```
 
+#### Project configuration
+
+```bash
+reprompt init   # generates .reprompt.toml with all rules documented
+```
+
+```toml
+# .reprompt.toml (or [tool.reprompt.lint] in pyproject.toml)
+[lint]
+score-threshold = 50       # fail if avg score < 50
+
+[lint.rules]
+min-length = 20            # error if prompt < 20 chars (0 = off)
+short-prompt = 40          # warning if < 40 chars (0 = off)
+vague-prompt = true        # error on "fix it" etc (false = off)
+debug-needs-reference = true
+```
+
 ## Privacy
 
 - All analysis runs locally. No prompts leave your machine.

{reprompt_cli-1.9.0 → reprompt_cli-1.10.0}/pyproject.toml

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

{reprompt_cli-1.9.0 → reprompt_cli-1.10.0}/src/reprompt/__init__.py

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

{reprompt_cli-1.9.0 → reprompt_cli-1.10.0}/src/reprompt/cli.py

@@ -820,13 +820,19 @@ def lint(
     import json as json_mod
 
     from reprompt.config import Settings
-    from reprompt.core.lint import format_lint_results, lint_prompts
+    from reprompt.core.lint import format_lint_results, lint_prompts, load_lint_config
     from reprompt.core.pipeline import get_adapters
     from reprompt.storage.db import PromptDB
 
     settings = Settings()
     db = PromptDB(settings.db_path)
 
+    # Load lint config from .reprompt.toml / pyproject.toml
+    lint_config = load_lint_config()
+
+    # CLI flags override config file
+    effective_threshold = score_threshold if score_threshold > 0 else lint_config.score_threshold
+
     # Collect prompts from DB (already scanned)
     rows = db.get_all_prompts()
     texts = [r["text"] for r in rows]
@@ -858,11 +864,11 @@ def lint(
         console.print("No prompts found. Run [bold]reprompt scan[/bold] first.")
         raise typer.Exit(0)
 
-    violations = lint_prompts(texts)
+    violations = lint_prompts(texts, config=lint_config)
 
     # Score threshold mode (CI integration)
     score_data = None
-    if score_threshold > 0:
+    if effective_threshold > 0:
         from reprompt.core.extractors import extract_features
         from reprompt.core.scorer import score_prompt
 
@@ -875,8 +881,8 @@ def lint(
             "avg_score": round(avg_score, 1),
             "min_score": min(scores) if scores else 0,
             "max_score": max(scores) if scores else 0,
-            "threshold": score_threshold,
-            "pass": avg_score >= score_threshold,
+            "threshold": effective_threshold,
+            "pass": avg_score >= effective_threshold,
         }
 
     if json_output:
@@ -905,7 +911,7 @@ def lint(
             console.print(
                 f"\n  Score: avg {score_data['avg_score']}/100"
                 f" (min {score_data['min_score']}, max {score_data['max_score']})"
-                f" — threshold {score_threshold} → {status}"
+                f" — threshold {effective_threshold} → {status}"
             )
 
     if copy:
@@ -1059,6 +1065,58 @@ def compress(
         _copy_to_clip(result.compressed, quiet=json_output)
 
 
+@app.command(rich_help_panel="Optimize")
+def rewrite(
+    text: str = typer.Argument(..., help="Prompt text to improve"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+    copy: bool = typer.Option(False, "--copy", help="Copy rewritten text to clipboard"),
+) -> None:
+    """Rewrite a prompt to improve its score. Rule-based, no LLM needed.
+
+    Applies 4 layers: filler removal, instruction front-loading,
+    key requirement echo, and hedging cleanup. Also suggests manual
+    improvements you can make.
+
+    Examples:
+
+        reprompt rewrite "I was wondering if you could fix the authentication bug"
+
+        reprompt rewrite "please help me refactor this code to be better" --copy
+
+        reprompt rewrite "fix the login" --json
+    """
+    from reprompt.core.rewrite import rewrite_prompt
+
+    result = rewrite_prompt(text)
+
+    if json_output:
+        import json as json_mod
+
+        data = {
+            "original": result.original,
+            "rewritten": result.rewritten,
+            "score_before": result.score_before,
+            "score_after": result.score_after,
+            "score_delta": result.score_delta,
+            "changes": result.changes,
+            "manual_suggestions": result.manual_suggestions,
+        }
+        typer.echo(json_mod.dumps(data, indent=2, ensure_ascii=False))
+    else:
+        from reprompt.output.rewrite_terminal import render_rewrite
+
+        typer.echo(render_rewrite(result))
+
+    if copy:
+        _copy_to_clip(result.rewritten, quiet=json_output)
+
+    from reprompt.core.suggestions import get_suggestion
+
+    hint = get_suggestion("rewrite")
+    if hint and not json_output:
+        console.print(f"  [dim]→ Try: {hint}[/dim]\n")
+
+
 @app.command(rich_help_panel="Optimize")
 def distill(
     session_id: str = typer.Argument(None, help="Session ID to distill"),
@@ -1929,6 +1987,65 @@ def extension_status() -> None:
         console.print("  Last sync:         never")
 
 
+@app.command(rich_help_panel="Setup")
+def init(
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
+) -> None:
+    """Generate a .reprompt.toml config file in the current directory.
+
+    Creates a starter config with all lint rules documented and commented.
+    Use this to customize reprompt for your project or CI pipeline.
+
+    Examples:
+
+        reprompt init                     # create .reprompt.toml
+
+        reprompt init --force             # overwrite existing config
+    """
+    config_path = Path.cwd() / ".reprompt.toml"
+
+    if config_path.exists() and not force:
+        console.print(
+            f"[yellow]{config_path.name} already exists.[/yellow]"
+            " Use [bold]--force[/bold] to overwrite."
+        )
+        raise typer.Exit(1)
+
+    config_content = """\
+# reprompt configuration
+# Docs: https://github.com/reprompt-dev/reprompt
+#
+# This file configures `reprompt lint` rules and CI thresholds.
+# Place in your project root — reprompt walks up from CWD to find it.
+# Alternatively, add [tool.reprompt.lint] to pyproject.toml.
+
+[lint]
+# Fail `reprompt lint` if average prompt score < threshold (0 = disabled)
+# Useful for CI: reprompt lint --score-threshold reads this value
+# score-threshold = 50
+
+[lint.rules]
+# min-length: error if prompt < N chars (0 = disabled)
+min-length = 20
+
+# short-prompt: warning if prompt < N chars (0 = disabled)
+short-prompt = 40
+
+# vague-prompt: error on vague prompts like "fix it" (false = disabled)
+vague-prompt = true
+
+# debug-needs-reference: warning if debug prompt lacks file reference (false = disabled)
+debug-needs-reference = true
+
+# file-extensions: extensions recognized as file references
+# file-extensions = [".py", ".ts", ".js", ".go", ".rs", ".java", ".rb", ".cpp", ".c"]
+"""
+
+    config_path.write_text(config_content)
+    console.print(f"[green]Created[/green] {config_path.name}")
+    console.print("  Edit rules, then run [bold]reprompt lint[/bold] to verify.")
+
+
 @app.command(rich_help_panel="Analyze")
 def sessions(
     last: int = typer.Option(10, "--last", help="Show N most recent sessions"),

reprompt_cli-1.10.0/src/reprompt/core/lint.py

@@ -0,0 +1,242 @@
+"""Prompt quality linting rules.
+
+Checks prompts against configurable quality rules and returns violations.
+Designed for CI integration — each rule produces a severity + message.
+
+Configuration loaded from (highest priority wins):
+1. CLI flags (--score-threshold, --strict)
+2. .reprompt.toml in CWD or parents
+3. [tool.reprompt.lint] in pyproject.toml
+4. Built-in defaults
+"""
+
+from __future__ import annotations
+
+import sys
+from dataclasses import dataclass, field
+from pathlib import Path
+
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    try:
+        import tomllib
+    except ModuleNotFoundError:  # Python 3.10
+        import tomli as tomllib  # type: ignore[no-redefine]
+
+
+@dataclass
+class LintViolation:
+    """A single lint rule violation."""
+
+    rule: str
+    severity: str  # "error" | "warning"
+    message: str
+    prompt_text: str
+
+
+@dataclass
+class LintConfig:
+    """Configuration for lint rules. Loaded from .reprompt.toml or pyproject.toml."""
+
+    # Rule thresholds (0 = disabled)
+    min_length: int = 20
+    short_prompt: int = 40
+
+    # Boolean rules (False = disabled)
+    vague_prompt: bool = True
+    debug_needs_reference: bool = True
+
+    # File extensions for debug-needs-reference
+    file_extensions: list[str] = field(
+        default_factory=lambda: [".py", ".ts", ".js", ".go", ".rs", ".java", ".rb", ".cpp", ".c"]
+    )
+
+    # CI score threshold (0 = disabled, set via --score-threshold or config)
+    score_threshold: int = 0
+
+
+# --- Default config ---
+DEFAULT_CONFIG = LintConfig()
+
+VAGUE_STARTERS = frozenset(
+    {"fix it", "fix this", "do it", "help me", "change it", "update it", "make it work"}
+)
+
+
+def load_lint_config(start_dir: Path | None = None) -> LintConfig:
+    """Load lint config from .reprompt.toml or pyproject.toml, walking up from start_dir.
+
+    Returns DEFAULT_CONFIG if no config file found.
+    """
+    if start_dir is None:
+        start_dir = Path.cwd()
+
+    # Walk up to find config files
+    current = start_dir.resolve()
+    for _ in range(20):  # safety limit
+        # Check .reprompt.toml first (project-specific)
+        reprompt_toml = current / ".reprompt.toml"
+        if reprompt_toml.is_file():
+            return _parse_reprompt_toml(reprompt_toml)
+
+        # Check pyproject.toml
+        pyproject = current / "pyproject.toml"
+        if pyproject.is_file():
+            config = _parse_pyproject_toml(pyproject)
+            if config is not None:
+                return config
+
+        parent = current.parent
+        if parent == current:
+            break
+        current = parent
+
+    return LintConfig()
+
+
+def _parse_reprompt_toml(path: Path) -> LintConfig:
+    """Parse a .reprompt.toml file."""
+    try:
+        with open(path, "rb") as f:
+            data = tomllib.load(f)
+        return _build_config(data.get("lint", {}))
+    except Exception:
+        return LintConfig()
+
+
+def _parse_pyproject_toml(path: Path) -> LintConfig | None:
+    """Parse [tool.reprompt.lint] from pyproject.toml. Returns None if section missing."""
+    try:
+        with open(path, "rb") as f:
+            data = tomllib.load(f)
+        lint_section = data.get("tool", {}).get("reprompt", {}).get("lint")
+        if lint_section is None:
+            return None
+        return _build_config(lint_section)
+    except Exception:
+        return None
+
+
+def _build_config(lint_data: dict) -> LintConfig:
+    """Build LintConfig from a parsed TOML dict."""
+    config = LintConfig()
+
+    # Top-level lint settings
+    if "score-threshold" in lint_data:
+        config.score_threshold = int(lint_data["score-threshold"])
+
+    # Rule settings
+    rules = lint_data.get("rules", {})
+
+    # min-length: int threshold or false
+    if "min-length" in rules:
+        val = rules["min-length"]
+        config.min_length = int(val) if val else 0
+
+    # short-prompt: int threshold or false
+    if "short-prompt" in rules:
+        val = rules["short-prompt"]
+        config.short_prompt = int(val) if val else 0
+
+    # vague-prompt: bool
+    if "vague-prompt" in rules:
+        config.vague_prompt = bool(rules["vague-prompt"])
+
+    # debug-needs-reference: bool
+    if "debug-needs-reference" in rules:
+        config.debug_needs_reference = bool(rules["debug-needs-reference"])
+
+    # file-extensions: list
+    if "file-extensions" in rules:
+        config.file_extensions = list(rules["file-extensions"])
+
+    return config
+
+
+def lint_prompt(text: str, config: LintConfig | None = None) -> list[LintViolation]:
+    """Lint a single prompt against quality rules."""
+    if config is None:
+        config = DEFAULT_CONFIG
+
+    violations: list[LintViolation] = []
+    stripped = text.strip().lower()
+
+    # Rule 1: Too short
+    if config.min_length > 0 and len(stripped) < config.min_length:
+        violations.append(
+            LintViolation(
+                rule="min-length",
+                severity="error",
+                message=f"Prompt is too short ({len(stripped)} chars, minimum {config.min_length})",
+                prompt_text=text,
+            )
+        )
+    elif config.short_prompt > 0 and len(stripped) < config.short_prompt:
+        violations.append(
+            LintViolation(
+                rule="short-prompt",
+                severity="warning",
+                message=(f"Prompt is short ({len(stripped)} chars) — consider adding context"),
+                prompt_text=text,
+            )
+        )
+
+    # Rule 2: Vague starter
+    if config.vague_prompt and stripped in VAGUE_STARTERS:
+        violations.append(
+            LintViolation(
+                rule="vague-prompt",
+                severity="error",
+                message="Prompt is too vague — specify what to fix/change and where",
+                prompt_text=text,
+            )
+        )
+
+    # Rule 3: No file/function reference in debug prompts
+    if config.debug_needs_reference:
+        debug_words = {"fix", "debug", "bug", "error", "broken", "failing", "crash"}
+        has_debug_intent = any(w in stripped for w in debug_words)
+        indicators = list(config.file_extensions) + ["()", "line ", "file "]
+        has_reference = any(indicator in text for indicator in indicators)
+        min_len = config.min_length if config.min_length > 0 else 20
+        if has_debug_intent and not has_reference and len(stripped) >= min_len:
+            violations.append(
+                LintViolation(
+                    rule="debug-needs-reference",
+                    severity="warning",
+                    message="Debug prompt lacks file/function reference — add specifics",
+                    prompt_text=text,
+                )
+            )
+
+    return violations
+
+
+def lint_prompts(texts: list[str], config: LintConfig | None = None) -> list[LintViolation]:
+    """Lint multiple prompts and return all violations."""
+    violations: list[LintViolation] = []
+    for text in texts:
+        violations.extend(lint_prompt(text, config))
+    return violations
+
+
+def format_lint_results(violations: list[LintViolation], total_prompts: int) -> str:
+    """Format lint results for terminal/CI output."""
+    if not violations:
+        return f"✓ {total_prompts} prompts checked, no issues found"
+
+    errors = [v for v in violations if v.severity == "error"]
+    warnings = [v for v in violations if v.severity == "warning"]
+
+    lines: list[str] = []
+    lines.append(f"Checked {total_prompts} prompts\n")
+
+    for v in violations:
+        prefix = "✗" if v.severity == "error" else "!"
+        display = v.prompt_text[:60] + "..." if len(v.prompt_text) > 60 else v.prompt_text
+        lines.append(f'  {prefix} [{v.rule}] "{display}"')
+        lines.append(f"    {v.message}")
+
+    lines.append(f"\n{len(errors)} error(s), {len(warnings)} warning(s)")
+    return "\n".join(lines)