reprompt-cli 0.9.2__tar.gz → 1.2.0__tar.gz

{reprompt_cli-0.9.2 → reprompt_cli-1.2.0}/.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Format check
         run: ruff format --check src/ tests/
       - name: Test
-        run: pytest tests/ -v --cov=reprompt --cov-report=xml
+        run: pytest tests/ -v --cov=reprompt --cov-report=xml --cov-fail-under=88
       - name: Upload coverage
         if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
         uses: codecov/codecov-action@v5

{reprompt_cli-0.9.2 → reprompt_cli-1.2.0}/.github/workflows/publish.yml

@@ -15,6 +15,14 @@ jobs:
       - uses: actions/setup-python@v6
         with:
           python-version: "3.12"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+      - name: Lint
+        run: ruff check src/ tests/
+      - name: Test
+        run: pytest tests/ -v --cov=reprompt --cov-fail-under=88
       - name: Install build tools
         run: pip install build
       - name: Build

{reprompt_cli-0.9.2 → reprompt_cli-1.2.0}/CHANGELOG.md

@@ -2,6 +2,94 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0] - 2026-03-16
+
+### Changed
+- **Stability release** — no new features, focused on reliability and trust
+- Empty-state guidance for `report` and `digest` commands
+- Scan shows "Try next" hints for new users
+- Feature extraction errors logged instead of silently swallowed
+
+### Infrastructure
+- DB schema versioning via `PRAGMA user_version` — ordered migrations, no more ad-hoc ALTER TABLE
+- CI enforces ≥90% test coverage; publish workflow runs tests before PyPI upload
+- Removed unused `[science]` optional dependency group
+- CHANGELOG backfill for all versions since v0.7.4
+
+## [0.9.3] - 2026-03-16
+
+### Added
+- `reprompt report --source` and `reprompt search --source` — filter by source adapter
+
+## [0.9.2] - 2026-03-15
+
+### Added
+- **Wrapped reports** — `reprompt wrapped` generates an annual Prompt DNA report (terminal, HTML, shareable)
+- **6 prompt personas** — Architect, Debugger, Explorer, Novelist, Sniper, Teacher (auto-classified)
+- **Telemetry** — opt-in anonymous 26-dimension feature vectors (no prompt text, no PII)
+- **Share** — HMAC-SHA256 signed upload to getreprompt.dev/api/share
+- Open-core plugin system: `entry_points(group="reprompt.plugins")` loaded at startup
+
+### Changed
+- Migrated wrapped, personas, telemetry, share into open-source CLI (from reprompt-pro)
+
+## [0.9.1] - 2026-03-14
+
+### Added
+- **Multi-language PromptDNA** — Chinese feature extraction via jieba (optional `[chinese]` extra)
+- **Native messaging bridge** — Chrome/Firefox extension support (`reprompt install-extension`)
+- **Style fingerprint** — `reprompt style` shows personal prompting patterns
+- **Template variables** — `reprompt use template_name key=value` with `{placeholder}` substitution
+- **Enhanced recommendations** — `reprompt recommend` uses effectiveness data
+
+### Infrastructure
+- Plugin system for open-core architecture (reprompt-pro registers via entry_points)
+- DB aggregation queries for plugin data access
+
+## [0.9.0] - 2026-03-13
+
+### Added
+- **ChatGPT import** — `reprompt import conversations.json` parses OpenAI export format
+- **Claude.ai import** — `reprompt import claude-export.zip` parses Claude web chat exports
+- **`reprompt import` command** — unified import with auto-detection of source format
+- 7 non-coding prompt categories for Chat AI support (brainstorm, summarize, explain, translate, roleplay, creative, casual)
+
+### Changed
+- Tests: 580 → 680+
+
+## [0.8.2] - 2026-03-13
+
+### Added
+- **Digest category deltas** — `reprompt digest` shows per-category % change with arrows
+- **`reprompt digest --history`** — view past digest log entries
+
+## [0.8.1] - 2026-03-12
+
+### Added
+- **HTML dashboard** — `reprompt report --html` generates interactive Chart.js dashboard
+- Digest + cluster data wired into HTML report
+
+## [0.8.0] - 2026-03-12
+
+### Added
+- **Effectiveness columns** — `prompts.effectiveness_score`, `prompt_patterns.effectiveness_avg`
+- **`reprompt library`** shows Eff column with score + star rating
+- **`reprompt digest`** shows avg session quality
+- **OpenClaw `parse_session_meta()`** — session quality scoring for OpenClaw/OpenCode sessions
+- `db.update_prompt_effectiveness()` and `db.compute_pattern_effectiveness()` methods
+- Pipeline: `run_scan()` propagates session scores to prompts; `build_report_data()` recomputes pattern averages
+
+### Infrastructure
+- `_migrate_v08()` adds effectiveness columns via safe ALTER TABLE
+
+### Changed
+- Tests: 480 → 510+
+
+## [0.7.5] - 2026-03-12
+
+### Added
+- Expanded Chinese stop words — 65 function words from stopwords-iso added
+
 ## [0.7.4] - 2026-03-12
 
 ### Improved

{reprompt_cli-0.9.2 → reprompt_cli-1.2.0}/CLAUDE.md

@@ -18,7 +18,7 @@ uv run python -m build                     # build wheel
 
 ```
 src/reprompt/
-├── cli.py              # Typer CLI (scan, import, report, search, library, recommend, demo, status, purge, install-hook, install-extension, extension-status, score, compare, insights, digest, style, use) + plugin loading
+├── cli.py              # Typer CLI (scan, import, report, search, library, recommend, demo, status, purge, install-hook, install-extension, extension-status, score, compare, insights, digest, style, use, privacy, compress) + plugin loading
 ├── config.py           # pydantic-settings, env vars (REPROMPT_ prefix) + TOML config
 ├── demo.py             # Built-in demo data generator (no network required)
 ├── core/
@@ -38,7 +38,9 @@ src/reprompt/
 │   ├── lang_detect.py   # Language detection (zh/ja/ko/en) via Unicode ranges
 │   ├── extractors_zh.py # Chinese feature extraction (jieba + Chinese regex)
 │   ├── persona.py       # 6 prompt personas (Architect/Debugger/Explorer/Novelist/Sniper/Teacher)
-│   └── wrapped.py       # WrappedReport dataclass + build_wrapped(db) aggregation
+│   ├── wrapped.py       # WrappedReport dataclass + build_wrapped(db) aggregation
+│   ├── privacy.py       # Privacy metadata registry + exposure summary per adapter
+│   └── compress.py      # 4-layer prompt compression (char norm + phrase simplify + filler delete + structure cleanup)
 ├── adapters/
 │   ├── base.py         # BaseAdapter ABC
 │   ├── claude_code.py  # Claude Code JSONL parser
@@ -80,7 +82,8 @@ src/reprompt/
     ├── json_out.py         # JSON for pipelines
     ├── markdown.py         # Markdown export
     ├── wrapped_terminal.py # Rich Prompt Wrapped report rendering
-    └── wrapped_html.py     # Self-contained HTML share card (dark theme)
+    ├── wrapped_html.py     # Self-contained HTML share card (dark theme)
+    └── compress_terminal.py # Rich output for compress command
 ```
 
 ## Data Flow
@@ -117,7 +120,7 @@ reprompt-extension (private)   ← Browser extension: Chrome/Firefox prompt capt
 - Pattern upsert (not clear+re-insert) for stable IDs
 - Prompts starting with `<` are filtered (system-injected XML)
 - Config: env vars (REPROMPT_ prefix) > TOML (~/.config/reprompt/config.toml) > defaults
-- Tests: pytest, 923 tests, 95% coverage target
+- Tests: pytest, 1153 tests, 95% coverage target
 
 ## Prompt Science Engine
 
@@ -128,3 +131,16 @@ Research-backed prompt analysis (added v0.6.0):
 
 Papers: Google 2512.14982 (repetition), Stanford 2307.03172 (position),
 SPELL EMNLP 2023 (perplexity), Prompt Report 2406.06608 (taxonomy).
+
+## Prompt Compression Engine
+
+Rule-based prompt optimization (added v1.2.0):
+- `reprompt compress "prompt"` — 4-layer compression with token savings display
+  - Layer 0: Character normalization (curly quotes, zero-width chars, NFKC)
+  - Layer 2: Phrase simplification (40+ zh, 50+ en rules)
+  - Layer 1: Filler word deletion (50+ zh, 40+ en phrases, jieba-aware)
+  - Layer 3: Structure cleanup (markdown strip, emoji, LLM output artifacts)
+- `--json` for pipeline integration, `--copy` to clipboard
+- `compressibility` field in PromptDNA, visible in insights + HTML dashboard
+
+Sources: LLMLingua (Microsoft), CompactPrompt, TSC, stopwords-iso/zh, Prompt Report 2406.06608.

reprompt_cli-1.2.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: reprompt-cli
+Version: 1.2.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
+Project-URL: Issues, https://github.com/reprompt-dev/reprompt/issues
+Project-URL: Changelog, https://github.com/reprompt-dev/reprompt/blob/main/CHANGELOG.md
+License: MIT
+License-File: LICENSE
+Keywords: ai,analytics,claude-code,cli,llm,prompt
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: scikit-learn>=1.4
+Requires-Dist: typer>=0.9
+Provides-Extra: chinese
+Requires-Dist: jieba>=0.42; extra == 'chinese'
+Provides-Extra: dev
+Requires-Dist: jieba>=0.42; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: local
+Requires-Dist: sentence-transformers>=2.0; extra == 'local'
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=2.0; extra == 'mcp'
+Provides-Extra: ollama
+Requires-Dist: requests>=2.31; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# `re:prompt`
+
+**Grammarly for Prompts** -- analyze your AI conversations with research-backed scoring.
+
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-923-brightgreen)](https://github.com/reprompt-dev/reprompt)
+[![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/reprompt-dev/reprompt)
+
+---
+
+## See it in action
+
+```bash
+$ pip install reprompt-cli
+$ reprompt scan --source claude-code
+  Scanning 890 sessions... Found 1,063 prompts (295 unique)
+
+$ reprompt score "Fix the auth bug in src/login.ts where JWT expires"
+  Score: 74/100
+  Structure: 18/25 | Context: 22/25 | Position: 15/20 | Repetition: 9/15 | Clarity: 10/15
+  Tip: Add the error message for +15% accuracy
+
+$ reprompt wrapped --share
+  Your Prompt DNA: Architect (Score 78, better than 72% of prompters)
+  Share link: https://getreprompt.dev/w/abc123
+```
+
+## What it does
+
+| Command | Description |
+|---------|-------------|
+| `reprompt scan` | Scan 8+ AI tools for prompts (Claude Code, Cursor, Aider, Gemini CLI, Cline, OpenClaw, ChatGPT, Claude.ai) |
+| `reprompt score` | Instant 0-100 scoring with 30+ research-backed features |
+| `reprompt compare` | Side-by-side analysis of two prompts |
+| `reprompt wrapped` | Your Prompt DNA report -- persona, scores, shareable card |
+| `reprompt insights` | Personal patterns vs research-optimal |
+| `reprompt digest` | Weekly summary comparing current vs previous period |
+| `reprompt report` | Full analytics with hot terms, clusters, patterns |
+| `reprompt library` | Auto-extracted prompt patterns and templates |
+
+## Prompt Science
+
+Scoring is based on 4 research papers (Google, Stanford, EMNLP, Prompt Report) covering 30+ features across 5 dimensions:
+
+| Dimension | What it measures |
+|-----------|-----------------|
+| **Structure** | Markdown formatting, code blocks, explicit constraints |
+| **Context** | File paths, error messages, technical specificity |
+| **Position** | Instruction placement relative to context |
+| **Repetition** | Redundancy that degrades model attention |
+| **Clarity** | Readability, sentence length, ambiguity |
+
+All analysis runs locally in <1ms per prompt. No LLM calls, no network requests.
+
+## Supported AI tools
+
+| Tool | Format | Session location |
+|------|--------|-----------------|
+| Claude Code | JSONL | `~/.claude/projects/` |
+| Cursor | .vscdb | `~/Library/Application Support/Cursor/User/` |
+| Aider | Markdown | `.aider.chat.history.md` |
+| Gemini CLI | JSON | `~/.gemini/tmp/` |
+| Cline (VS Code) | JSON | `globalStorage/saoudrizwan.claude-dev/` |
+| OpenClaw / OpenCode | JSON | `~/.openclaw/` / `~/.opencode/sessions/` |
+| ChatGPT | JSON | `conversations.json` export |
+| Claude.ai | JSON/ZIP | Web chat export |
+
+## Installation
+
+```bash
+pip install reprompt-cli          # core
+pip install reprompt-cli[chinese] # + Chinese prompt support
+pip install reprompt-cli[mcp]     # + MCP server for Claude Code / Continue.dev / Zed
+```
+
+## Privacy
+
+- All analysis runs locally. No prompts leave your machine.
+- Optional telemetry sends only anonymous 26-dimension feature vectors -- never prompt text.
+- Open source: audit exactly what's collected.
+
+[Privacy policy](https://getreprompt.dev/privacy)
+
+## Links
+
+- **Website:** [getreprompt.dev](https://getreprompt.dev)
+- **PyPI:** [reprompt-cli](https://pypi.org/project/reprompt-cli/)
+- **Privacy:** [getreprompt.dev/privacy](https://getreprompt.dev/privacy)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

reprompt_cli-1.2.0/README.md

@@ -0,0 +1,98 @@
+# `re:prompt`
+
+**Grammarly for Prompts** -- analyze your AI conversations with research-backed scoring.
+
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-923-brightgreen)](https://github.com/reprompt-dev/reprompt)
+[![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/reprompt-dev/reprompt)
+
+---
+
+## See it in action
+
+```bash
+$ pip install reprompt-cli
+$ reprompt scan --source claude-code
+  Scanning 890 sessions... Found 1,063 prompts (295 unique)
+
+$ reprompt score "Fix the auth bug in src/login.ts where JWT expires"
+  Score: 74/100
+  Structure: 18/25 | Context: 22/25 | Position: 15/20 | Repetition: 9/15 | Clarity: 10/15
+  Tip: Add the error message for +15% accuracy
+
+$ reprompt wrapped --share
+  Your Prompt DNA: Architect (Score 78, better than 72% of prompters)
+  Share link: https://getreprompt.dev/w/abc123
+```
+
+## What it does
+
+| Command | Description |
+|---------|-------------|
+| `reprompt scan` | Scan 8+ AI tools for prompts (Claude Code, Cursor, Aider, Gemini CLI, Cline, OpenClaw, ChatGPT, Claude.ai) |
+| `reprompt score` | Instant 0-100 scoring with 30+ research-backed features |
+| `reprompt compare` | Side-by-side analysis of two prompts |
+| `reprompt wrapped` | Your Prompt DNA report -- persona, scores, shareable card |
+| `reprompt insights` | Personal patterns vs research-optimal |
+| `reprompt digest` | Weekly summary comparing current vs previous period |
+| `reprompt report` | Full analytics with hot terms, clusters, patterns |
+| `reprompt library` | Auto-extracted prompt patterns and templates |
+
+## Prompt Science
+
+Scoring is based on 4 research papers (Google, Stanford, EMNLP, Prompt Report) covering 30+ features across 5 dimensions:
+
+| Dimension | What it measures |
+|-----------|-----------------|
+| **Structure** | Markdown formatting, code blocks, explicit constraints |
+| **Context** | File paths, error messages, technical specificity |
+| **Position** | Instruction placement relative to context |
+| **Repetition** | Redundancy that degrades model attention |
+| **Clarity** | Readability, sentence length, ambiguity |
+
+All analysis runs locally in <1ms per prompt. No LLM calls, no network requests.
+
+## Supported AI tools
+
+| Tool | Format | Session location |
+|------|--------|-----------------|
+| Claude Code | JSONL | `~/.claude/projects/` |
+| Cursor | .vscdb | `~/Library/Application Support/Cursor/User/` |
+| Aider | Markdown | `.aider.chat.history.md` |
+| Gemini CLI | JSON | `~/.gemini/tmp/` |
+| Cline (VS Code) | JSON | `globalStorage/saoudrizwan.claude-dev/` |
+| OpenClaw / OpenCode | JSON | `~/.openclaw/` / `~/.opencode/sessions/` |
+| ChatGPT | JSON | `conversations.json` export |
+| Claude.ai | JSON/ZIP | Web chat export |
+
+## Installation
+
+```bash
+pip install reprompt-cli          # core
+pip install reprompt-cli[chinese] # + Chinese prompt support
+pip install reprompt-cli[mcp]     # + MCP server for Claude Code / Continue.dev / Zed
+```
+
+## Privacy
+
+- All analysis runs locally. No prompts leave your machine.
+- Optional telemetry sends only anonymous 26-dimension feature vectors -- never prompt text.
+- Open source: audit exactly what's collected.
+
+[Privacy policy](https://getreprompt.dev/privacy)
+
+## Links
+
+- **Website:** [getreprompt.dev](https://getreprompt.dev)
+- **PyPI:** [reprompt-cli](https://pypi.org/project/reprompt-cli/)
+- **Privacy:** [getreprompt.dev/privacy](https://getreprompt.dev/privacy)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

reprompt_cli-1.2.0/docs/roadmap.md

@@ -0,0 +1,74 @@
+# reprompt Roadmap
+
+> Last updated: 2026-03-16 · Current version: v1.0.0
+
+## Vision
+
+reprompt is the **prompt analytics** tool for AI sessions — understand your patterns, improve your prompting, track your progress. Zero-config, privacy-first, CLI-first.
+
+**Category definition:** reprompt analyzes *human inputs* (how you prompt), not *LLM outputs* (how models respond). Every other tool in the eval/observability space — Promptfoo, Braintrust, DeepEval, Langfuse — answers "did my AI system answer correctly?" reprompt answers "am I asking well?" This is an unoccupied category.
+
+---
+
+## Current State (v1.0.0) — Production Stable
+
+### Adapters (8)
+Claude Code · OpenClaw · Cursor IDE · Aider · Gemini CLI · Cline · ChatGPT · Claude.ai
+
+### Commands (23)
+`scan` · `import` · `report` · `library` · `trends` · `recommend` · `effectiveness` · `merge-view` · `save` · `templates` · `use` · `lint` · `search` · `demo` · `status` · `purge` · `install-hook` · `install-extension` · `extension-status` · `score` · `compare` · `insights` · `digest` · `style` · `wrapped` · `telemetry` · `mcp-serve`
+
+### Integrations
+- MCP server (`reprompt mcp-serve`) for IDE integration
+- GitHub Action (`action.yml`) for CI prompt quality checks
+- HTML dashboard (`reprompt report --html`)
+- Browser extension (Chrome/Firefox) via Native Messaging bridge
+- JSON output on all commands for pipeline integration
+
+### v1.0.0 Hardening (this release)
+- Empty-state UX guidance for `report` and `digest`
+- Scan "Try next" onboarding hints for new users
+- Feature extraction errors logged (no more silent swallowing)
+- DB schema versioning via `PRAGMA user_version`
+- CI: ≥90% coverage gate, pre-publish test step
+- Stable public API (`score_prompt`, `compare_prompts`, `extract_features`)
+- 935+ tests, ≥90% coverage
+
+---
+
+## v1.1+ — Future Work
+
+| Feature | Description |
+|---------|-------------|
+| `reprompt consolidate` | Automated prompt merging (currently read-only `merge-view` is sufficient) |
+| Homebrew formula | `brew install reprompt` via `homebrew-reprompt` tap |
+| SSE transport for MCP | Alternative to stdio for remote IDE setups |
+| More adapters | Perplexity, Mistral, Grok, Gemini Takeout |
+| `reprompt suggest` | Ollama-powered prompt improvement suggestions |
+| `.repromptignore` | Per-project filtering rules |
+| Team features | Anonymized pattern sharing, CI lint standards |
+| Windows Native Messaging | Extension support on Windows |
+
+Nothing beyond v1.1 is formally scheduled.
+
+---
+
+## Architecture Principles
+
+1. **Zero-config first** — Every feature works without LLM by default
+2. **Privacy by design** — All data stays local; extension has zero server
+3. **Adapter pattern** — New AI tools supported by adding ~50 lines
+4. **Input not output** — We analyze human prompts (inputs); LLM eval tools analyze model responses (outputs)
+5. **CLI first, GUI second** — Terminal is primary, HTML dashboard is secondary
+6. **Composable** — Every command supports JSON output for piping
+
+---
+
+## How to Contribute
+
+- **New adapter** (~50 lines) — see `src/reprompt/adapters/base.py`
+- **New lint rules** — see `src/reprompt/core/lint.py`
+- **Better categorization** — improve keyword rules in `core/library.py`
+- **Browser extension** — see `reprompt-extension` repo
+
+See [CONTRIBUTING.md](../CONTRIBUTING.md) for details.