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

receipts/interactive/repl.py

@@ -0,0 +1,755 @@
+"""Interactive slash-command REPL — chat-style UX for Receipts.
+
+A lightweight REPL using stdlib input() + typer echo for colors.
+Every CLI subcommand has a slash equivalent: /check, /setup, /ingest,
+/verify, /tui, /ama, /rewrite, /score, /dossier, /readiness, /export,
+/ledger, /dashboard, plus /status, /help, /quit.
+Fuzzy-matches mistyped commands and suggests the closest match.
+"""
+
+from __future__ import annotations
+
+import difflib
+from pathlib import Path
+
+import typer
+
+from receipts.errors import ReceiptsError
+
+# ---------------------------------------------------------------------------
+# Command registry
+# ---------------------------------------------------------------------------
+
+_COMMANDS: dict[str, Command] = {}
+
+
+class Command:
+    def __init__(self, name: str, aliases: list[str], help_text: str, handler):
+        self.name = name
+        self.aliases = aliases
+        self.help_text = help_text
+        self.handler = handler
+
+    @property
+    def all_names(self) -> list[str]:
+        return [self.name] + self.aliases
+
+
+def _register(name: str, aliases: list[str], help_text: str):
+    def decorator(fn):
+        cmd = Command(name, aliases, help_text, fn)
+        _COMMANDS[name] = cmd
+        for alias in aliases:
+            _COMMANDS[alias] = cmd
+        return fn
+
+    return decorator
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _echo(msg: str, color: str | None = None, bold: bool = False) -> None:
+    typer.secho(msg, fg=color, bold=bold)
+
+
+def _prompt(msg: str, default: str = "") -> str:
+    suffix = f" [{default}]" if default else ""
+    try:
+        val = input(f"  {msg}{suffix}: ").strip()
+    except (EOFError, KeyboardInterrupt):
+        print()
+        return default
+    return val or default
+
+
+def _prompt_path(msg: str, must_exist: bool = True) -> Path | None:
+    raw = _prompt(msg)
+    if not raw:
+        _echo("  (skipped)", color=typer.colors.YELLOW)
+        return None
+    p = Path(raw)
+    if must_exist and not p.exists():
+        _echo(f"  Not found: {p}", color=typer.colors.RED)
+        return None
+    return p
+
+
+def _prompt_int(msg: str, default: int = 5) -> int:
+    raw = _prompt(msg, str(default))
+    try:
+        return int(raw)
+    except ValueError:
+        return default
+
+
+def _prompt_sections() -> list[str] | None:
+    raw = _prompt("Sections to filter (comma-separated, or Enter for all)")
+    if not raw:
+        return None
+    return [s.strip() for s in raw.split(",") if s.strip()]
+
+
+def _prompt_source() -> str | None:
+    """Prompt for a codebase spec — local folder, git URL, or manifest alias.
+
+    Existence isn't checked here: URLs and aliases aren't paths. Resolution
+    (and the friendly known-aliases error) happens in the CLI backend.
+    """
+    raw = _prompt("Codebase (folder, git URL, or alias — already ingested)")
+    if not raw:
+        _echo("  (skipped)", color=typer.colors.YELLOW)
+        return None
+    return raw
+
+
+def _check_provider_ready() -> bool:
+    """Quick check if the configured provider is reachable."""
+    try:
+        from receipts.config import load_settings
+        from receipts.llm.factory import get_provider
+
+        settings = load_settings()
+        get_provider(settings, verify=True)
+        return True
+    except Exception as exc:
+        _echo(f"  Provider not ready: {exc}", color=typer.colors.RED)
+        _echo(
+            "  Check your .env config and that your provider is running.",
+            color=typer.colors.YELLOW,
+        )
+        return False
+
+
+# ---------------------------------------------------------------------------
+# /help
+# ---------------------------------------------------------------------------
+
+
+@_register("help", ["h", "?"], "Show available commands")
+def _cmd_help(args: str) -> None:
+    _echo("")
+    _echo("  Available commands:", bold=True)
+    _echo("")
+
+    seen: set[str] = set()
+    for cmd in _COMMANDS.values():
+        if cmd.name in seen:
+            continue
+        seen.add(cmd.name)
+        aliases_str = f" ({', '.join(cmd.aliases)})" if cmd.aliases else ""
+        _echo(f"    /{cmd.name:<10}{aliases_str}")
+        _echo(f"      {cmd.help_text}")
+    _echo("")
+    _echo("  Type a command, or just start typing — I'll suggest the right one.")
+    _echo(
+        "  Verification here uses the default evidence threshold (0.5);"
+        " use the CLI's --threshold flag to tune it.",
+        color=typer.colors.BRIGHT_BLACK,
+    )
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /status
+# ---------------------------------------------------------------------------
+
+
+@_register("status", ["s", "info"], "Show provider, KB stats, and token spend")
+def _cmd_status(args: str) -> None:
+    from receipts.config import load_settings
+    from receipts.ledger.token_ledger import TokenLedger
+
+    _echo("")
+    _echo("  Status", bold=True)
+    _echo("")
+
+    settings = load_settings()
+    _echo(f"  Provider:  {settings.provider}")
+    model_attr = {
+        "ollama": "ollama_chat_model",
+        "gemini": "gemini_chat_model",
+        "anthropic": "anthropic_chat_model",
+        "openai": "openai_chat_model",
+    }.get(settings.provider)
+    model = getattr(settings, model_attr, None) if model_attr else None
+    _echo(f"  Model:     {model or '(default)'}")
+
+    ready = _check_provider_ready()
+    if ready:
+        _echo("  Connected: Yes", color=typer.colors.GREEN)
+    else:
+        _echo("  Connected: No", color=typer.colors.RED)
+
+    tl = TokenLedger()
+    try:
+        lt = tl.lifetime_summary()
+    finally:
+        tl.close()
+
+    if lt.call_count > 0:
+        _echo("")
+        _echo(f"  LLM calls:     {lt.call_count}")
+        _echo(f"  Input tokens:  {lt.total_input:,}")
+        _echo(f"  Output tokens: {lt.total_output:,}")
+        _echo(f"  Est. cost:     ${lt.total_cost:.4f}")
+    else:
+        _echo("  No LLM calls recorded yet.")
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /check
+# ---------------------------------------------------------------------------
+
+
+@_register(
+    "check",
+    ["c", "connectivity"],
+    "Check provider configuration and connectivity (sends no content)",
+)
+def _cmd_check(args: str) -> None:
+    from receipts.cli import check as check_cmd
+
+    _echo("")
+    try:
+        check_cmd()
+    except (ReceiptsError, SystemExit, typer.Exit):
+        pass  # the command already printed the failure in red
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /setup
+# ---------------------------------------------------------------------------
+
+
+@_register(
+    "setup",
+    ["init", "configure"],
+    "First-time setup wizard — pick a provider, store your key, validate",
+)
+def _cmd_setup(args: str) -> None:
+    from receipts.cli import setup as setup_cmd
+
+    _echo("")
+    try:
+        setup_cmd()
+    except (ReceiptsError, SystemExit, typer.Exit):
+        pass  # the wizard already printed what went wrong
+    except (typer.Abort, EOFError, KeyboardInterrupt):
+        _echo("  Setup cancelled.", color=typer.colors.YELLOW)
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /ingest
+# ---------------------------------------------------------------------------
+
+
+@_register("ingest", ["i", "index"], "Ingest a codebase into the knowledge base")
+def _cmd_ingest(args: str) -> None:
+    _echo("")
+    _echo("  Ingest a codebase", bold=True)
+    _echo("")
+
+    if args:
+        source_path = Path(args)
+    else:
+        source_path = _prompt_path(
+            "Path to codebase (folder or git URL)", must_exist=False
+        )
+        if source_path is None:
+            return
+
+    budget_raw = _prompt("Token budget (Enter for auto)")
+    token_budget = int(budget_raw) if budget_raw.strip().isdigit() else None
+
+    if not _check_provider_ready():
+        return
+
+    _echo("")
+    _echo(f"  Ingesting: {source_path}")
+    budget_label = "auto" if token_budget is None else f"{token_budget:,} tokens"
+    _echo(f"  Budget:    {budget_label}")
+    _echo("")
+
+    from receipts.cli import _run_ingest
+    from receipts.ingest.git_source import cloned_repo, looks_like_git_url
+
+    source_str = str(source_path)
+    try:
+        if looks_like_git_url(source_str):
+            _echo("  Cloning...")
+            with cloned_repo(source_str) as root:
+                _run_ingest(root, token_budget)
+        else:
+            if not source_path.is_dir():
+                _echo(f"  Not a folder: {source_path}", color=typer.colors.RED)
+                return
+            _run_ingest(source_path, token_budget)
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /verify
+# ---------------------------------------------------------------------------
+
+
+@_register("verify", ["v", "check-resume"], "Verify resume claims against the KB")
+def _cmd_verify(args: str) -> None:
+    _echo("")
+    _echo("  Verify resume claims", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    source_spec = _prompt_source()
+    if source_spec is None:
+        return
+
+    sections = _prompt_sections()
+    threshold = 0.5
+
+    do_rewrite = _prompt("Include rewrites? (y/n)", "n").lower().startswith("y")
+    jd_raw = _prompt("Job description file path (or Enter to skip)")
+    jd_path = jd_raw if jd_raw else None
+
+    if not _check_provider_ready():
+        return
+
+    _echo("")
+    from receipts.cli import _run_verify
+
+    try:
+        _run_verify(resume_path, source_spec, do_rewrite, jd_path, threshold, sections)
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /tui
+# ---------------------------------------------------------------------------
+
+
+@_register("tui", ["t"], "Launch the Textual verify TUI (panelled, streaming)")
+def _cmd_tui(args: str) -> None:
+    _echo("")
+    _echo("  Verify TUI", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    source_spec = _prompt_source()
+    if source_spec is None:
+        return
+
+    sections = _prompt_sections()
+
+    if not _check_provider_ready():
+        return
+
+    from receipts.cli import _resolve_entries, _resolve_kb_source
+    from receipts.tui.app import ReceiptsApp
+
+    try:
+        kb_dir, _ = _resolve_kb_source(source_spec)
+        # Same entry picker the CLI uses: with no section filter it lists the
+        # project/experience entries and asks which match the ingested repo.
+        entries = _resolve_entries(resume_path, sections, None, False)
+        tui_app = ReceiptsApp(
+            resume_path,
+            Path(source_spec),
+            threshold=0.5,
+            sections=sections,
+            entries=entries,
+            kb_dir=kb_dir,
+        )
+        tui_app.run()
+    except (ReceiptsError, SystemExit, typer.Exit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /ama
+# ---------------------------------------------------------------------------
+
+
+@_register("ama", ["a", "interview", "mock"], "Start a mock interview session")
+def _cmd_ama(args: str) -> None:
+    _echo("")
+    _echo("  Mock Interview (AMA)", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    source_spec = _prompt_source()
+    if source_spec is None:
+        return
+
+    rounds = _prompt_int("Number of rounds", default=5)
+    sections = _prompt_sections()
+
+    use_tui = _prompt("Use TUI chat interface? (y/n)", "y").lower().startswith("y")
+
+    if not _check_provider_ready():
+        return
+
+    _echo("")
+    if use_tui:
+        from receipts.cli import _resolve_kb_source
+        from receipts.tui.ama_app import AmaApp
+
+        try:
+            kb_dir, _ = _resolve_kb_source(source_spec)
+        except ReceiptsError as exc:
+            _echo(f"  Error: {exc}", color=typer.colors.RED)
+            return
+
+        ama_app = AmaApp(
+            resume_path,
+            Path(source_spec),
+            n_rounds=rounds,
+            threshold=0.5,
+            sections=sections,
+            kb_dir=kb_dir,
+        )
+        ama_app.run()
+    else:
+        from receipts.cli import _run_ama
+
+        try:
+            _run_ama(resume_path, source_spec, rounds, 0.5, sections)
+        except (ReceiptsError, SystemExit) as exc:
+            _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /rewrite
+# ---------------------------------------------------------------------------
+
+
+@_register(
+    "rewrite",
+    ["r", "rw", "optimize"],
+    "Rewrite weak bullets and generate optimized .tex",
+)
+def _cmd_rewrite(args: str) -> None:
+    _echo("")
+    _echo("  ATS-Optimized Rewrite", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    source_path = _prompt_path("Codebase folder (already ingested)")
+    if source_path is None:
+        return
+
+    sections = _prompt_sections()
+    output_raw = _prompt("Output .tex path (or Enter for default)")
+    output_path = output_raw if output_raw else None
+
+    jd_raw = _prompt("Job description file (or Enter to skip)")
+    jd_path = jd_raw if jd_raw else None
+
+    compile_pdf = _prompt("Compile to PDF? (y/n)", "n").lower().startswith("y")
+
+    if not _check_provider_ready():
+        return
+
+    _echo("")
+    from receipts.cli import _run_rewrite_pipeline
+
+    try:
+        _run_rewrite_pipeline(
+            resume_path,
+            source_path,
+            output_path,
+            0.5,
+            sections,
+            compile_pdf,
+            jd_path,
+        )
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /score
+# ---------------------------------------------------------------------------
+
+
+@_register("score", ["sc", "ats"], "Score resume against a JD (ATS scoring engine)")
+def _cmd_score(args: str) -> None:
+    _echo("")
+    _echo("  ATS Score", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    jd_path = _prompt_path("Job description file path")
+    if jd_path is None:
+        return
+
+    compare_raw = _prompt("Compare against another .tex? (path or Enter to skip)")
+    compare_path = compare_raw if compare_raw else None
+
+    show_stats = False
+    if compare_path:
+        show_stats = (
+            _prompt("Show statistical analysis? (y/n)", "y").lower().startswith("y")
+        )
+
+    _echo("")
+    from receipts.cli import _run_score
+
+    try:
+        _run_score(resume_path, jd_path, compare_path, show_stats)
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /dossier
+# ---------------------------------------------------------------------------
+
+
+@_register("dossier", ["d", "prep"], "Generate the interview defense dossier")
+def _cmd_dossier(args: str) -> None:
+    _echo("")
+    _echo("  Interview Defense Dossier", bold=True)
+    _echo("")
+
+    resume_path = _prompt_path("Resume path (.tex or .pdf)")
+    if resume_path is None:
+        return
+
+    source_spec = _prompt_source()
+    if source_spec is None:
+        return
+
+    entries_raw = _prompt("Entry to cover (substring, or Enter for all)")
+    entries = [entries_raw] if entries_raw else None
+
+    output = _prompt("Output file", "dossier.md")
+
+    if not _check_provider_ready():
+        return
+
+    _echo("")
+    from receipts.cli import _run_dossier
+
+    try:
+        _run_dossier(resume_path, source_spec, output, 0.5, None, entries)
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /readiness
+# ---------------------------------------------------------------------------
+
+
+@_register("readiness", ["rd", "progress"], "Show mock-interview readiness trends")
+def _cmd_readiness(args: str) -> None:
+    from receipts.cli import readiness as readiness_cmd
+
+    _echo("")
+    try:
+        readiness_cmd()
+    except (ReceiptsError, SystemExit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /export
+# ---------------------------------------------------------------------------
+
+
+@_register("export", ["e", "pdf"], "Export a .md or .tex file to PDF")
+def _cmd_export(args: str) -> None:
+    _echo("")
+    _echo("  Export to PDF", bold=True)
+    _echo("")
+
+    if args:
+        source_path = Path(args)
+        if not source_path.is_file():
+            _echo(f"  Not found: {source_path}", color=typer.colors.RED)
+            return
+    else:
+        source_path = _prompt_path("File to export (.md or .tex)")
+        if source_path is None:
+            return
+
+    output_raw = _prompt("Output PDF path (or Enter for default)")
+
+    from receipts.cli import export as export_cmd
+
+    _echo("")
+    try:
+        # Pass both params explicitly — typer's OptionInfo defaults only
+        # resolve when invoked through the CLI, not in a direct call.
+        export_cmd(str(source_path), output_raw or None)
+    except (ReceiptsError, SystemExit, typer.Exit):
+        pass  # the command already printed the failure
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /ledger
+# ---------------------------------------------------------------------------
+
+
+@_register(
+    "ledger",
+    ["l", "tokens", "spend"],
+    "Show the token/cost ledger (lifetime or last session)",
+)
+def _cmd_ledger(args: str) -> None:
+    _echo("")
+    scope = _prompt("Lifetime or last session? (l/s)", "l").lower()
+
+    from receipts.cli import ledger as ledger_cmd
+
+    _echo("")
+    try:
+        ledger_cmd(session=scope.startswith("s"))
+    except (ReceiptsError, SystemExit, typer.Exit):
+        pass
+    _echo("")
+
+
+# ---------------------------------------------------------------------------
+# /dashboard
+# ---------------------------------------------------------------------------
+
+
+@_register(
+    "dashboard",
+    ["dash"],
+    "One-screen status TUI: provider, token spend, readiness",
+)
+def _cmd_dashboard(args: str) -> None:
+    from receipts.tui.hub import HubApp
+
+    try:
+        HubApp(start="dashboard").run()
+    except (ReceiptsError, SystemExit, typer.Exit) as exc:
+        _echo(f"  Error: {exc}", color=typer.colors.RED)
+
+
+# ---------------------------------------------------------------------------
+# /quit
+# ---------------------------------------------------------------------------
+
+
+@_register("quit", ["q", "exit", "bye"], "Exit the interactive session")
+def _cmd_quit(args: str) -> None:
+    _echo("")
+    _echo("  Later. Go crush that interview.", color=typer.colors.GREEN)
+    _echo("")
+    raise SystemExit(0)
+
+
+# ---------------------------------------------------------------------------
+# Fuzzy matching
+# ---------------------------------------------------------------------------
+
+
+def _find_command(raw: str) -> tuple[Command | None, str]:
+    """Match user input to a command. Returns (command, remaining_args)."""
+    raw = raw.strip()
+    if not raw:
+        return None, ""
+
+    if raw.startswith("/"):
+        raw = raw[1:]
+
+    parts = raw.split(None, 1)
+    cmd_str = parts[0].lower()
+    args = parts[1] if len(parts) > 1 else ""
+
+    if cmd_str in _COMMANDS:
+        return _COMMANDS[cmd_str], args
+
+    matches = difflib.get_close_matches(
+        cmd_str, list(_COMMANDS.keys()), n=1, cutoff=0.5
+    )
+    if matches:
+        return _COMMANDS[matches[0]], args
+
+    return None, raw
+
+
+# ---------------------------------------------------------------------------
+# Main REPL loop
+# ---------------------------------------------------------------------------
+
+_BANNER = """
+  ┌─────────────────────────────────────────────┐
+  │  RECEIPTS — Interactive Mode                │
+  │                                             │
+  │  Type /help for commands, /quit to exit.    │
+  │  Just start typing — I'll figure it out.    │
+  └─────────────────────────────────────────────┘
+"""
+
+
+def run_repl() -> None:
+    """Start the interactive REPL session."""
+    _echo(_BANNER, color=typer.colors.CYAN, bold=True)
+
+    while True:
+        try:
+            raw = input("  receipts> ").strip()
+        except (EOFError, KeyboardInterrupt):
+            _echo("")
+            _cmd_quit("")
+            break
+
+        if not raw:
+            continue
+
+        cmd, args = _find_command(raw)
+
+        if cmd is None:
+            matches = difflib.get_close_matches(
+                raw.lstrip("/").split()[0].lower(),
+                list(_COMMANDS.keys()),
+                n=3,
+                cutoff=0.4,
+            )
+            if matches:
+                suggestions = ", ".join(f"/{m}" for m in matches)
+                _echo(
+                    f"  Unknown command. Did you mean: {suggestions}?",
+                    color=typer.colors.YELLOW,
+                )
+            else:
+                _echo(
+                    f"  Unknown command: '{raw}'. Type /help for options.",
+                    color=typer.colors.YELLOW,
+                )
+            continue
+
+        try:
+            cmd.handler(args)
+        except SystemExit:
+            break
+        except Exception as exc:
+            _echo(f"  Unexpected error: {exc}", color=typer.colors.RED)