codebase-receipts-cli 1.0.0__py3-none-any.whl

codebase_receipts_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,268 @@
+Metadata-Version: 2.4
+Name: codebase-receipts-cli
+Version: 1.0.0
+Summary: Receipts — resume claim verifier & codebase-grounded interview prep CLI
+Project-URL: Homepage, https://github.com/Ishaan-1606/receipts-cli
+Project-URL: Repository, https://github.com/Ishaan-1606/receipts-cli
+Project-URL: Issues, https://github.com/Ishaan-1606/receipts-cli/issues
+Author-email: Ishaan Sharma <ishaan406061@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,codebase,interview,llm,resume,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: chromadb>=1.0
+Requires-Dist: gitpython>=3.1.50
+Requires-Dist: google-genai>=1.0
+Requires-Dist: ollama>=0.4
+Requires-Dist: pathspec>=1.1.1
+Requires-Dist: pypdf>=5.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: textual>=0.80
+Requires-Dist: tiktoken>=0.13.0
+Requires-Dist: tree-sitter-language-pack>=1.12.2
+Requires-Dist: tree-sitter>=0.26.0
+Requires-Dist: typer>=0.12
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.30; extra == 'anthropic'
+Provides-Extra: openai
+Requires-Dist: openai>=1.30; extra == 'openai'
+Provides-Extra: pdf
+Requires-Dist: markdown>=3.5; extra == 'pdf'
+Requires-Dist: xhtml2pdf>=0.2.16; extra == 'pdf'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">RECEIPTS</h1>
+  <p align="center">
+    <strong>Your resume said it. Your code proves it.</strong>
+  </p>
+  <p align="center">
+    <a href="#quick-start">Quick Start</a> &bull;
+    <a href="#what-it-does">What It Does</a> &bull;
+    <a href="#how-it-works">How It Works</a> &bull;
+    <a href="#providers">Providers</a> &bull;
+    <a href="SETUP.md">Setup Guide</a> &bull;
+    <a href="LEARN.md">Deep Dive</a>
+  </p>
+</p>
+
+<br>
+
+> **The anti-flattery resume tool.** Most resume reviewers feed your bullets
+> into an LLM and hand you back compliments. Receipts does the opposite — it
+> embeds your actual codebase, searches it for evidence behind every claim you
+> made, and tells you the truth. If the code doesn't back it up, you'll know
+> before the interviewer does.
+
+<br>
+
+## Quick Start
+
+```bash
+pip install codebase-receipts-cli
+```
+
+```bash
+receipts check                                    # verify provider is working
+receipts ingest ./my-project                      # index your codebase
+receipts verify resume.tex ./my-project           # verify every claim
+receipts verify resume.tex ./my-project --rewrite # + honest rewrites
+receipts tui resume.tex ./my-project              # full-screen dashboard
+receipts ama resume.tex ./my-project              # mock interview mode
+receipts ledger                                   # token usage & costs
+```
+
+> [!TIP]
+> See **[SETUP.md](SETUP.md)** for the full walkthrough — provider config,
+> model setup, and first-run instructions. See **[LEARN.md](LEARN.md)** for
+> how every piece works under the hood.
+
+<br>
+
+## What It Does
+
+### Claim Verification
+
+Every bullet in your `.tex` resume gets broken into individual claims —
+percentages, counts, latency numbers, technology names — and each one is
+checked against the code.
+
+```
+Results: 5 verified, 3 plausible, 2 unsupported
+
+UNSUPPORTED CLAIMS:
+  [percentage] 40%
+    bullet: Reduced API latency by 40% through query optimization...
+    reason: No evidence of latency measurement or optimization in codebase
+```
+
+**The rule:** if the knowledge base has no relevant code for a claim, it's
+marked Unsupported *without even asking the LLM*. The model never gets a
+chance to talk itself into justifying something it can't find.
+
+### Honest Rewrites
+
+Weak bullets get rewritten to be exactly as strong as what the code can
+actually justify. No invented numbers. No inflated language.
+
+```
+ORIGINAL:  Reduced API latency by 40% through query optimization
+REWRITTEN: Optimized database queries in the API layer using indexed lookups
+```
+
+### Keyword Gap Analysis
+
+Paste a job description. Get back what's addable, what's ungrounded, and
+what's missing:
+
+```
+Can add (code supports it):
+  + Docker — Dockerfile and compose config found in codebase
+
+Ungrounded (resume claims, no code):
+  ? Kubernetes — mentioned in resume but no k8s config in codebase
+
+Gaps (JD wants, you don't have):
+  - Terraform
+```
+
+### Interactive TUI
+
+A full-screen terminal dashboard with a file tree, sortable claims table,
+side-by-side rewrite diffs, live LLM activity log, and a running token counter.
+
+| Shortcut | Action |
+|----------|--------|
+| `c` | Claims tab |
+| `r` | Rewrites tab |
+| `l` | Log tab |
+| `q` | Quit |
+
+### Mock Interview (`ama`)
+
+An AI interviewer that targets your weakest bullets. Unsupported claims get
+asked about 3x more often than verified ones. For each bullet:
+
+1. Pointed technical question about the specific claim
+2. Your answer
+3. Natural follow-up based on what you said
+4. Your follow-up answer
+5. Assessment: did it hold up?
+
+Ends with a summary of strengths, weaknesses, and overall readiness.
+
+### Token Ledger
+
+Every LLM call is metered and logged — even when the provider is free.
+`receipts ledger` shows lifetime totals across all sessions.
+
+<br>
+
+## How It Works
+
+```
+receipts/
+  cli.py ........................ Typer CLI: check, ingest, verify, tui, ama, ledger
+  config.py ..................... BYOK config (env vars / .env, never committed)
+  ama/
+    interviewer.py .............. Mock-interview loop, weighted toward weak claims
+  ingest/
+    scanner.py .................. Tree-style walk respecting .gitignore
+    git_source.py ............... Clone remote repos to temp dir
+    artifact_extractor.py ....... Tree-sitter extraction within a token budget
+    secrets_scanner.py .......... Pre-embedding secrets scan + redaction
+  ledger/
+    token_ledger.py ............. SQLite-backed token/cost log
+    pricing_table.py ............ $/1K-token rates per provider/model
+  llm/
+    provider.py ................. Abstract LLMProvider (complete, embed)
+    factory.py .................. Reads config, returns the active provider
+    ollama_provider.py .......... Local, free, no key needed
+    gemini_provider.py .......... Free-tier Google AI Studio key
+    anthropic_provider.py ....... BYOK adapter (paid)
+    openai_provider.py .......... BYOK adapter (paid)
+    fake_provider.py ............ Deterministic offline stub for tests
+  resume/
+    tex_parser.py ............... Parse .tex into structured sections/bullets
+    claim_extractor.py .......... Extract numeric + technology claims per bullet
+  tui/
+    app.py ...................... Textual App with panelled layout
+    widgets/ .................... StatusBar, ClaimsTable, DiffView
+  verify/
+    kb.py ....................... ChromaDB-backed vector store over code artifacts
+    verifier.py ................. Classify: Verified / Plausible / Unsupported
+    rewriter.py ................. Propose honest rewrites for weak bullets
+    keyword_gap.py .............. JD keyword gap analysis grounded in code
+```
+
+> [!NOTE]
+> For a narrative walkthrough of every module — what it does, why it exists,
+> and how to explain it in an interview — see **[LEARN.md](LEARN.md)**.
+
+<br>
+
+<h2 id="providers">Provider Support (BYOK)</h2>
+
+| Provider | Default | Key | Install |
+|----------|---------|-----|---------|
+| **Ollama** | Yes | None | Built-in |
+| **Gemini** | No | Free | Built-in |
+| **Anthropic** | No | Paid | `pip install codebase-receipts-cli[anthropic]` |
+| **OpenAI** | No | Paid | `pip install codebase-receipts-cli[openai]` |
+
+**Zero bundled keys. Zero silent paid API calls. Ever.**
+
+> [!IMPORTANT]
+> Anthropic does not offer an embeddings API, so Claude needs a split
+> config — chat via Claude, embeddings via a provider that has them:
+> `RECEIPTS_PROVIDER=anthropic` + `RECEIPTS_EMBED_PROVIDER=gemini` (or
+> `ollama`). The embed provider must match whatever embedded your
+> knowledge base — re-ingest if you switch embedding models.
+
+<br>
+
+## Development
+
+```bash
+uv sync --group dev          # install everything
+uv run pytest -v             # 233 tests, fully offline
+uv run ruff check receipts/  # lint
+uv run black --check receipts/ tests/  # format check
+uv run pre-commit install    # git hooks
+```
+
+The entire test suite runs with **zero network access** — a deterministic
+fake provider handles all LLM calls in tests.
+
+## Publishing
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+GitHub Actions runs the full test suite on Ubuntu + Windows (Python 3.10 +
+3.12), then publishes to PyPI via trusted publishing. No tokens in secrets.
+
+<br>
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<p align="center">
+  <sub>Built by <a href="mailto:ishaan406061@gmail.com">Ishaan Sharma</a></sub>
+</p>

codebase_receipts_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,78 @@
+receipts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/cli.py,sha256=W8YUEuFmnA0HpxF1d0OKOAfn1zaMMx2dQ1bAISTg3ro,69238
+receipts/config.py,sha256=OdMAcnn0jaaDImrmYIxmIUv2UD5TOmhPVd6-5AMl5RM,4392
+receipts/errors.py,sha256=_lV1Usmk2UqmWIX0Ee0kzhU79YpkbIdcMUQbHgoqqHM,482
+receipts/export.py,sha256=qWbnU2kkDfBc4pKC5ARnq3EP2JmrMElys4jYiwDcmBg,4225
+receipts/ama/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/ama/interviewer.py,sha256=ZOftuAYQiZHWDkl9qTr_wEGpnoYHX6n0WI0LpGr5O3c,14541
+receipts/ats/__init__.py,sha256=XidKPKhkvOO1u7kz4_LZw7T4bZH6cWZRbgn-X67UPXA,39
+receipts/ats/comparator.py,sha256=IINuarlrOZ0wWTiNXKtApsmptsAAeUpBjQ7VcEuX5ag,2723
+receipts/ats/scorer.py,sha256=CqVit0gPrkBHAXx594tL9h2pFr3FRyrpDUzKgDJmLMg,18370
+receipts/ats/stats.py,sha256=b4kPlPZ9QUTecLAKa6efuY4xilkUw8D9wlofg1J1dKQ,5022
+receipts/ingest/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/ingest/artifact_extractor.py,sha256=HmW00S5Kr-p7ynrx7hc91EIh-Ot5WUidO-iW8PPMWuI,23140
+receipts/ingest/git_source.py,sha256=fgri8YTZ8zrw4-AwFjIShkUia7HTTS7xOv7bT-6PqyA,6204
+receipts/ingest/manifest.py,sha256=KgzdqcdzkdeMZeppGa5Qlem59GhhCe9gUnj3n-IgAQc,3450
+receipts/ingest/scanner.py,sha256=3YJKxjUtnPD7mK-Jimsfm4I17VT7qzKdpkAzCGbzDKE,4970
+receipts/ingest/secrets_scanner.py,sha256=O5Yf_EY2W9TQE9U2vIv6pl2oLtKd0UF3ra5fhWPZm4Q,8214
+receipts/interactive/__init__.py,sha256=aZVlXl2ugcHW0s9BhumLLTjNvOyHvC346eHn_Mfh5LU,51
+receipts/interactive/repl.py,sha256=g8t4dCLQc9XBasDTuBvnjep3SXzGE7gOPPHDe_V-tyk,22359
+receipts/ledger/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/ledger/pricing_table.py,sha256=uhPcrJpVDxjnBPzEFfvW0fzTdlzHHUfm9zgeAduwMqs,1695
+receipts/ledger/token_ledger.py,sha256=PPDo_l9bMZj4EIqFob4u1gW9WjfDgZU3sX8SsvjbHvc,6863
+receipts/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/llm/anthropic_provider.py,sha256=2SoVvLZ11ksl9BoqFZNPO2AdJlZvPc0Nlq07AdFHx_Q,3674
+receipts/llm/factory.py,sha256=zL1XEQ54p1WMZjKp0wWxC1WhI_DZ3xgd0p0sDA3bfNA,4293
+receipts/llm/fake_provider.py,sha256=eNTvNzf-SiTmcjJwQeMEv_XLZVJM7ORI7Qe0oGFw7hU,2607
+receipts/llm/gemini_provider.py,sha256=3smYn_gZvJDbnDxTFVjil-D2Hgyp0YIOStg_LD0FYw0,8494
+receipts/llm/json_utils.py,sha256=yBvfGJtcx_0ojyxxCDWneLbzKJ5ZarmWct8WOsJTJp8,1430
+receipts/llm/metered.py,sha256=Oogp0v4V-xoehHGLb5aZSm26nRvFJ5vIU6l4Bje4VAI,2402
+receipts/llm/ollama_provider.py,sha256=AEc1TGykSlZxh3rRSZMeS1arupwdTT5BSfVliT47BkY,4541
+receipts/llm/openai_provider.py,sha256=f848VrfmucrTWgHExx4lhFMPAx6FaZV5kAMLvlLzcBA,4600
+receipts/llm/provider.py,sha256=mL0adcyhmrYxTkIylGEVLSk7RnTadTCrotmHjx5zBj0,1218
+receipts/llm/split.py,sha256=8QcEPRE8Jc0WEFBcPueKDXhKRRVJndi4AlBqFZoWQvg,2740
+receipts/llm/token_estimate.py,sha256=-FKyWagDpOn7-brGIij8mMdi0adWcme_NoU52iH0QRA,1258
+receipts/mine/__init__.py,sha256=1GL97BJKV9QQX30xWpLSiYNvD64i6wQCsPTBpbkold8,84
+receipts/mine/code_metrics.py,sha256=keddSV-0l85FxgkMFdoAh9RItGaOQd56sM5BerXkGGE,7885
+receipts/mine/git_evidence.py,sha256=l_sKPyLfLkrs2km96muZ2KXPmEtsaU8bGmhDRt6CUnw,3871
+receipts/prep/__init__.py,sha256=C8bh2B7Lf9Jq3cE0paDHisF5Kmm72EltHlSsvF17ITo,75
+receipts/prep/dossier.py,sha256=-qOv5dU41bWfbDkOtPbVD_cTHAdbJvBSLSEBhKZPjok,10497
+receipts/prep/readiness.py,sha256=ozcIgvAT7Xupkq7tYMUYUplB6nsGimjUCf6kKCz_nZw,7235
+receipts/resume/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/resume/claim_extractor.py,sha256=BfdCd2K2l-l4n7hXru3BmXz32kGAa0Rv-XvsNi6iTb0,10615
+receipts/resume/loader.py,sha256=ij72GiJYqGCQZcymqDsiO6DQBOknaqAjdrAIb3_l9uI,1218
+receipts/resume/pdf_parser.py,sha256=orkfWjqe0W4KrH5ExFlGZQpynA8yrA9wcFvNKhjDqBU,8550
+receipts/resume/tex_parser.py,sha256=31tMXc1YUQ1l048hQFiHMY2lQ1GxfJOq0otOZczAl7k,12873
+receipts/rewrite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/rewrite/compiler.py,sha256=2aiyQKC1J9n-ahGkwvK_xzhMQpnzQ1Xg2MKj8wdb6qs,5778
+receipts/rewrite/optimizer.py,sha256=NphN0ws-e8Xe0demNwv3DLEDGUO4Jw6Sy1f3kjReD34,4915
+receipts/rewrite/tex_rewriter.py,sha256=gzksgLj50rQMO-zTZ9IwqLPI5-V3UsY4Ug_C_7fHHZs,7526
+receipts/tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/tui/ama_app.py,sha256=ERfaH-jlqW-MwBXBrokEQFFwT0QIooh3Bn9czVpRNiM,16496
+receipts/tui/app.py,sha256=9F_YdxtquYKjTO5E06VVAi__AR-OuL4HNCfo9Z0SKyE,11358
+receipts/tui/dossier_app.py,sha256=OjCY7s_cHyW56KNvulsDbbT_GPIT43dqxMXa4PmgcAU,5827
+receipts/tui/hub.py,sha256=OHfIXIR93a7a9lOaHC8HcbvmgyIHSRppivo2CYTctec,12526
+receipts/tui/ingest_app.py,sha256=30w7QA4o9hBipYlQsGLusc3R0HkPwsO4Tm_x-lm6cGg,6663
+receipts/tui/rewrite_app.py,sha256=q6bOCNV4QXi2Tq67D-c7ufl3oIgEOBnFQ_O3ljf72NE,17718
+receipts/tui/score_app.py,sha256=VvXtJYqCAA4sQeayEsyEM7Uku3qN9o3MvTKdKATMEeE,8603
+receipts/tui/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/tui/widgets/claims_table.py,sha256=2ocALjMw1LOOY75eKs-tR6addNMRoQmc0pMOM0b7U7w,1506
+receipts/tui/widgets/diff_view.py,sha256=RXe5D7E-6Z6DrgRdGTQPU6KMnS30OUwq7-mBL-3Ovbs,1086
+receipts/tui/widgets/status_bar.py,sha256=BPdWP6LsoVmXKT5XNzG9GLUn_SschZ9AAouZSBylmbM,1043
+receipts/verify/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+receipts/verify/bm25.py,sha256=baVlOYBVHUsqk1m8EdcGJ7W26uuY5MbaKKW10pCYXQM,3997
+receipts/verify/enrich.py,sha256=W_-FtbItY9f3VpRxwt1SD1cjonmZKmut0zZSC1oIwsw,4546
+receipts/verify/jd_fetch.py,sha256=-yX0R_9w_hEvq7JNzvaSGivRTYW7H90YQqCgot9kjac,3497
+receipts/verify/kb.py,sha256=Mim2Id-XLEwWWpOtczNf1JOgPrYO4mkStlnhBAbPld0,13611
+receipts/verify/keyword_gap.py,sha256=e8VbzmCY0VJj3YwBFxQhACQW4L3TPm81ACwuUXVpcOw,4253
+receipts/verify/query_expand.py,sha256=hWw2xvBpuFFFgKC3ip7Cfz82HDtywnHD1RIjEfLd1fY,3532
+receipts/verify/rerank.py,sha256=CMRyKQ9U4mSUfkTuYEpl_wgGJR_77tvJEo1RG50I3qQ,2660
+receipts/verify/rewriter.py,sha256=zM5T5vQxmy1ZQnBbB9rvhVRHOmpsu-2csf_jM4NYL0k,6132
+receipts/verify/router.py,sha256=dByAiZ0XvVQGFYMik7v-y4COVqCkeM8YmS-kLr-Sv24,7062
+receipts/verify/summaries.py,sha256=0Ihj17Th6CicZJbctf2QdoqSMDR86ATJjAMj6zY99Bk,8818
+receipts/verify/verifier.py,sha256=fcwp_PCrYDAJeFycFbpB5_0HAHDC8AWp4a11faddVAM,19709
+codebase_receipts_cli-1.0.0.dist-info/METADATA,sha256=9kdkEpoW3K12vN3o5F5nDLhPgAUTdvQG7kwXH-51D3U,9092
+codebase_receipts_cli-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+codebase_receipts_cli-1.0.0.dist-info/entry_points.txt,sha256=GW_kkDazAIFIVZd6sj6DM-5VrWcBakGCvPSJ84w9koE,47
+codebase_receipts_cli-1.0.0.dist-info/licenses/LICENSE,sha256=8Uz1XENAU_8FzLJWXQq_cWpdkoBr97ROq5N09lIhOv0,1070
+codebase_receipts_cli-1.0.0.dist-info/RECORD,,

codebase_receipts_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

codebase_receipts_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+receipts = receipts.cli:main

codebase_receipts_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ishaan Sharma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.