reprompt-cli 2.2.0__tar.gz → 2.2.1__tar.gz

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.2.1] - 2026-04-01
+
+### Added
+- **MCP server expanded** — 6→9 tools: `check_prompt_quality` (unified diagnostic), `build_prompt_from_parts` (prompt constructor), `explain_prompt_quality` (educational analysis). IDE integration now covers all prompt quality features.
+- **File input** — all prompt commands (`check`, `score`, `explain`, `rewrite`, `compress`) accept `--file` to read from file and `-` for stdin. Enables pipeline integration and multi-line prompts.
+- Tests: 1846 → 1864
+
 ## [2.2.0] - 2026-04-01
 
 ### Added

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reprompt-cli
-Version: 2.2.0
+Version: 2.2.1
 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
@@ -230,7 +230,7 @@ Captured prompts sync locally via Native Messaging -- nothing leaves your machin
 # .pre-commit-config.yaml
 repos:
   - repo: https://github.com/reprompt-dev/reprompt
-    rev: v2.2.0
+    rev: v2.2.1
     hooks:
       - id: reprompt-lint
 ```

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/README.md

@@ -185,7 +185,7 @@ Captured prompts sync locally via Native Messaging -- nothing leaves your machin
 # .pre-commit-config.yaml
 repos:
   - repo: https://github.com/reprompt-dev/reprompt
-    rev: v2.2.0
+    rev: v2.2.1
     hooks:
       - id: reprompt-lint
 ```

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/pyproject.toml

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

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/src/reprompt/cli.py

@@ -15,6 +15,21 @@ if TYPE_CHECKING:
     from reprompt.storage.db import PromptDB
 
 
+def _resolve_text(text: str, file: str) -> str:
+    """Resolve prompt text from argument or --file option."""
+    if file:
+        p = Path(file)
+        if not p.is_file():
+            typer.echo(f"Error: file not found: {file}", err=True)
+            raise typer.Exit(1)
+        return p.read_text(encoding="utf-8").strip()
+    if text == "-":
+        import sys
+
+        return sys.stdin.read().strip()
+    return text
+
+
 def _copy_to_clip(text: str, quiet: bool = False) -> None:
     """Copy text to clipboard with user feedback."""
     from reprompt.sharing.clipboard import copy_to_clipboard
@@ -948,9 +963,10 @@ def lint(
 
 @app.command(rich_help_panel="Analyze")
 def check(
-    text: str = typer.Argument(..., help="Prompt text to check"),
+    text: str = typer.Argument(..., help="Prompt text to check (use '-' for stdin)"),
     model: str = typer.Option("", "--model", "-m", help="Target model (claude/gpt/gemini)"),
     max_tokens: int = typer.Option(0, "--max-tokens", help="Token budget (0 = disabled)"),
+    file: str = typer.Option("", "--file", "-f", help="Read prompt from file"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
     copy: bool = typer.Option(False, "--copy", help="Copy rewritten prompt to clipboard"),
 ) -> None:
@@ -967,6 +983,7 @@ def check(
 
         reprompt check "help me debug this crash" --json
     """
+    text = _resolve_text(text, file)
     from reprompt.core.check import check_prompt
 
     result = check_prompt(text, model=model, max_tokens=max_tokens)
@@ -1009,7 +1026,8 @@ def check(
 
 @app.command(rich_help_panel="Analyze")
 def explain(
-    text: str = typer.Argument(..., help="Prompt text to explain"),
+    text: str = typer.Argument(..., help="Prompt text to explain (use '-' for stdin)"),
+    file: str = typer.Option("", "--file", "-f", help="Read prompt from file"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ) -> None:
     """Explain what makes a prompt good or bad in plain English.
@@ -1021,8 +1039,9 @@ def explain(
 
         reprompt explain "fix the auth bug"
 
-        reprompt explain "Fix the JWT expiration in src/auth.ts line 42" --json
+        reprompt explain --file prompt.txt --json
     """
+    text = _resolve_text(text, file)
     from reprompt.core.explain import explain_prompt
 
     result = explain_prompt(text)
@@ -1053,7 +1072,8 @@ def explain(
 
 @app.command(rich_help_panel="Analyze")
 def score(
-    text: str = typer.Argument(..., help="Prompt text to score"),
+    text: str = typer.Argument(..., help="Prompt text to score (use '-' for stdin)"),
+    file: str = typer.Option("", "--file", "-f", help="Read prompt from file"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
     copy: bool = typer.Option(False, "--copy", help="Copy result to clipboard"),
 ) -> None:
@@ -1063,10 +1083,11 @@ def score(
 
         reprompt score "Fix the auth bug in login.ts where JWT expires"
 
-        reprompt score "Refactor auth module to use refresh tokens" --json
+        reprompt score --file prompt.txt --json
 
         reprompt score "Fix bug" --copy
     """
+    text = _resolve_text(text, file)
     from reprompt.core.cost import estimate_cost, format_cost, model_for_source
     from reprompt.core.extractors import extract_features
     from reprompt.core.scorer import score_prompt
@@ -1174,7 +1195,8 @@ def score(
 
 @app.command(rich_help_panel="Optimize")
 def compress(
-    text: str = typer.Argument(..., help="Prompt text to compress"),
+    text: str = typer.Argument(..., help="Prompt text to compress (use '-' for stdin)"),
+    file: str = typer.Option("", "--file", "-f", help="Read prompt from file"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
     copy: bool = typer.Option(False, "--copy", help="Copy compressed text to clipboard"),
 ) -> None:
@@ -1184,10 +1206,11 @@ def compress(
 
         reprompt compress "Can you please help me refactor this code?"
 
-        reprompt compress "I was wondering if you could fix the bug" --json
+        reprompt compress --file prompt.txt --json
 
         reprompt compress "verbose prompt here" --copy
     """
+    text = _resolve_text(text, file)
     from reprompt.core.compress import compress_text
 
     result = compress_text(text)
@@ -1208,7 +1231,8 @@ def compress(
 
 @app.command(rich_help_panel="Optimize")
 def rewrite(
-    text: str = typer.Argument(..., help="Prompt text to improve"),
+    text: str = typer.Argument(..., help="Prompt text to improve (use '-' for stdin)"),
+    file: str = typer.Option("", "--file", "-f", help="Read prompt from file"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
     diff: bool = typer.Option(False, "--diff", help="Show unified diff (red/green)"),
     copy: bool = typer.Option(False, "--copy", help="Copy rewritten text to clipboard"),
@@ -1223,10 +1247,11 @@ def rewrite(
 
         reprompt rewrite "I was wondering if you could fix the authentication bug"
 
-        reprompt rewrite "fix the login" --diff
+        reprompt rewrite --file prompt.txt --diff
 
         reprompt rewrite "please help me refactor this code to be better" --copy
     """
+    text = _resolve_text(text, file)
     from reprompt.core.rewrite import rewrite_prompt
 
     result = rewrite_prompt(text)

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/src/reprompt/mcp.py

@@ -1,4 +1,4 @@
-"""MCP server for reprompt — exposes prompt analytics as 6 focused tools.
+"""MCP server for reprompt — exposes prompt analytics as 9 focused tools.
 
 Usage:
     python -m reprompt.mcp          # stdio transport (default)
@@ -297,6 +297,133 @@ def scan_sessions(source: str | None = None) -> str:
         return json.dumps({"error": str(exc)})
 
 
+@mcp.tool
+def check_prompt_quality(text: str, model: str | None = None) -> str:
+    """Full prompt diagnostic — score + lint + rewrite in one call.
+
+    Returns score breakdown, strengths, suggestions with point values,
+    lint issues, and an auto-rewritten version. The most comprehensive
+    single-call analysis available.
+
+    Args:
+        text: The prompt text to analyze
+        model: Target model for model-specific lint (claude/gpt/gemini). Optional.
+    """
+    try:
+        from reprompt.core.check import check_prompt as _check
+
+        result = _check(text, model=model or "")
+        return json.dumps(
+            {
+                "total": result.total,
+                "tier": result.tier,
+                "clarity": result.clarity,
+                "context": result.context,
+                "position": result.position,
+                "structure": result.structure,
+                "repetition": result.repetition,
+                "word_count": result.word_count,
+                "token_count": result.token_count,
+                "confirmations": result.confirmations[:3],
+                "suggestions": result.suggestions[:3],
+                "lint_issues": result.lint_issues,
+                "rewritten": result.rewritten,
+                "rewrite_delta": result.rewrite_delta,
+                "rewrite_changes": result.rewrite_changes,
+            },
+            indent=2,
+        )
+    except Exception as exc:
+        logger.debug("check_prompt_quality error: %s", exc)
+        return json.dumps({"error": str(exc)})
+
+
+@mcp.tool
+def build_prompt_from_parts(
+    task: str,
+    context: str = "",
+    files: str = "",
+    error: str = "",
+    constraints: str = "",
+    role: str = "",
+    model: str = "",
+) -> str:
+    """Build a well-structured prompt from components.
+
+    Assembles a prompt that maximizes quality score from individual parts.
+    Model-aware: uses XML tags for Claude, markdown for GPT.
+
+    Args:
+        task: What the AI should do (required)
+        context: Background information
+        files: Comma-separated file paths (e.g., "src/auth.ts,src/token.ts")
+        error: Error message or stack trace
+        constraints: Comma-separated constraints (e.g., "keep tests,no breaking changes")
+        role: AI role/persona (e.g., "senior backend engineer")
+        model: Target model (claude/gpt/gemini) for format optimization
+    """
+    try:
+        from reprompt.core.build import build_prompt as _build
+
+        file_list = [f.strip() for f in files.split(",") if f.strip()] if files else None
+        constraint_list = (
+            [c.strip() for c in constraints.split(",") if c.strip()] if constraints else None
+        )
+
+        result = _build(
+            task,
+            context=context,
+            files=file_list,
+            error=error,
+            constraints=constraint_list,
+            role=role,
+            model=model,
+        )
+        return json.dumps(
+            {
+                "prompt": result.prompt,
+                "score": result.score,
+                "tier": result.tier,
+                "components_used": result.components_used,
+                "suggestions": result.suggestions,
+            },
+            indent=2,
+        )
+    except Exception as exc:
+        logger.debug("build_prompt_from_parts error: %s", exc)
+        return json.dumps({"error": str(exc)})
+
+
+@mcp.tool
+def explain_prompt_quality(text: str) -> str:
+    """Explain what makes a prompt good or bad in plain English.
+
+    Returns educational feedback: what's working, what's missing,
+    and specific tips to improve. No LLM needed.
+
+    Args:
+        text: The prompt text to explain
+    """
+    try:
+        from reprompt.core.explain import explain_prompt as _explain
+
+        result = _explain(text)
+        return json.dumps(
+            {
+                "score": result.score,
+                "tier": result.tier,
+                "summary": result.summary,
+                "strengths": result.strengths,
+                "weaknesses": result.weaknesses,
+                "tips": result.tips,
+            },
+            indent=2,
+        )
+    except Exception as exc:
+        logger.debug("explain_prompt_quality error: %s", exc)
+        return json.dumps({"error": str(exc)})
+
+
 # ─── Resources ──────────────────────────────────────────────────────────────
 
 

reprompt_cli-2.2.1/tests/test_file_input.py

@@ -0,0 +1,107 @@
+"""Tests for --file input support across prompt commands."""
+
+import json
+
+from typer.testing import CliRunner
+
+from reprompt.cli import app
+
+runner = CliRunner()
+
+
+def _write_prompt(tmp_path, content="Fix the auth bug in src/auth.ts"):
+    f = tmp_path / "prompt.txt"
+    f.write_text(content)
+    return str(f)
+
+
+class TestFileInputCheck:
+    def test_check_from_file(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["check", "ignored", "--file", path])
+        assert result.exit_code == 0
+        assert "Clarity" in result.output
+
+    def test_check_file_not_found(self, tmp_path):
+        result = runner.invoke(app, ["check", "x", "--file", "/nonexistent/file.txt"])
+        assert result.exit_code == 1
+
+    def test_check_file_json(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["check", "x", "--file", path, "--json"])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert data["total"] > 0
+
+
+class TestFileInputScore:
+    def test_score_from_file(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["score", "ignored", "--file", path])
+        assert result.exit_code == 0
+
+    def test_score_file_json(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["score", "x", "--file", path, "--json"])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert "total" in data
+
+
+class TestFileInputExplain:
+    def test_explain_from_file(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["explain", "x", "--file", path])
+        assert result.exit_code == 0
+        assert "Analysis" in result.output
+
+    def test_explain_file_json(self, tmp_path):
+        path = _write_prompt(tmp_path)
+        result = runner.invoke(app, ["explain", "x", "--file", path, "--json"])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert "summary" in data
+
+
+class TestFileInputRewrite:
+    def test_rewrite_from_file(self, tmp_path):
+        path = _write_prompt(
+            tmp_path, "I was wondering if you could maybe fix the authentication bug"
+        )
+        result = runner.invoke(app, ["rewrite", "x", "--file", path])
+        assert result.exit_code == 0
+
+    def test_rewrite_file_diff(self, tmp_path):
+        path = _write_prompt(
+            tmp_path, "I was wondering if you could maybe fix the authentication bug"
+        )
+        result = runner.invoke(app, ["rewrite", "x", "--file", path, "--diff"])
+        assert result.exit_code == 0
+
+
+class TestFileInputCompress:
+    def test_compress_from_file(self, tmp_path):
+        path = _write_prompt(tmp_path, "Can you please help me refactor this code to be better?")
+        result = runner.invoke(app, ["compress", "x", "--file", path])
+        assert result.exit_code == 0
+
+    def test_compress_file_json(self, tmp_path):
+        path = _write_prompt(tmp_path, "Please help me with the thing")
+        result = runner.invoke(app, ["compress", "x", "--file", path, "--json"])
+        assert result.exit_code == 0
+
+
+class TestMultilineFile:
+    def test_multiline_prompt(self, tmp_path):
+        content = (
+            "Fix the authentication middleware.\n\n"
+            "Context: JWT tokens expire after 1 hour.\n"
+            "Error: 401 on /api/users endpoint.\n\n"
+            "Don't modify existing tests."
+        )
+        path = _write_prompt(tmp_path, content)
+        result = runner.invoke(app, ["check", "x", "--file", path, "--json"])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert data["total"] > 0
+        assert data["word_count"] > 10

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/tests/test_mcp.py

@@ -170,11 +170,78 @@ def test_mcp_serve_cli(tmp_path, monkeypatch):
 
 
 def test_tool_count():
-    """Verify the MCP server exposes exactly 6 tools."""
+    """Verify the MCP server exposes exactly 9 tools."""
     import asyncio
 
     from reprompt.mcp import mcp as _mcp
 
     tools = asyncio.run(_mcp.list_tools())
     names = [t.name for t in tools]
-    assert len(tools) == 6, f"Expected 6 tools, got {len(tools)}: {names}"
+    assert len(tools) == 9, f"Expected 9 tools, got {len(tools)}: {names}"
+
+
+# ─── New tools (check, build, explain) ────────────────────────────────────
+
+
+def test_check_prompt_quality():
+    from reprompt.mcp import check_prompt_quality
+
+    result = json.loads(check_prompt_quality("fix the auth bug in login.ts"))
+    assert "total" in result
+    assert "tier" in result
+    assert "lint_issues" in result
+    assert "rewritten" in result
+    assert "suggestions" in result
+
+
+def test_check_prompt_quality_with_model():
+    from reprompt.mcp import check_prompt_quality
+
+    result = json.loads(check_prompt_quality("fix the auth bug", model="claude"))
+    assert "total" in result
+
+
+def test_build_prompt_from_parts():
+    from reprompt.mcp import build_prompt_from_parts
+
+    result = json.loads(
+        build_prompt_from_parts(
+            task="fix the auth bug",
+            files="src/auth.ts",
+            error="TypeError: null",
+            constraints="keep tests,no breaking changes",
+        )
+    )
+    assert "prompt" in result
+    assert "score" in result
+    assert "tier" in result
+    assert "src/auth.ts" in result["prompt"]
+    assert "components_used" in result
+
+
+def test_build_prompt_from_parts_minimal():
+    from reprompt.mcp import build_prompt_from_parts
+
+    result = json.loads(build_prompt_from_parts(task="fix the bug"))
+    assert "prompt" in result
+    assert result["score"] > 0
+
+
+def test_explain_prompt_quality():
+    from reprompt.mcp import explain_prompt_quality
+
+    result = json.loads(explain_prompt_quality("fix the auth bug in login.ts"))
+    assert "score" in result
+    assert "tier" in result
+    assert "summary" in result
+    assert "strengths" in result
+    assert "weaknesses" in result
+    assert "tips" in result
+
+
+def test_explain_prompt_quality_short():
+    from reprompt.mcp import explain_prompt_quality
+
+    result = json.loads(explain_prompt_quality("fix it"))
+    assert result["score"] > 0
+    assert len(result["summary"]) > 0

{reprompt_cli-2.2.0 → reprompt_cli-2.2.1}/uv.lock

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