litresearch 0.1.0__tar.gz

litresearch-0.1.0/.env.example

@@ -0,0 +1,7 @@
+# At least one LLM provider key is required.
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+OPENROUTER_API_KEY=
+
+# Optional: higher Semantic Scholar rate limits.
+S2_API_KEY=

litresearch-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,13 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv run nox

litresearch-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,16 @@
+name: Release
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv run nox
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

litresearch-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# IDEs
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+.env
+.venv/
+
+# Tool caches
+.ruff_cache/
+.pyright/
+.pytest_cache/
+.coverage
+htmlcov/
+.nox/
+.uv_cache/
+
+# Agent runtime artifacts
+.pi/plans/
+.pi/reviews/
+.pi/LESSONS.md

litresearch-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

litresearch-0.1.0/AGENTS.md

@@ -0,0 +1,38 @@
+# litresearch
+
+## Overview
+CLI-first Python package for automated literature research workflows. The scaffold
+supports a Typer CLI, importable package code, and standard OSS tooling.
+
+## Tech Stack
+- Language: Python 3.12
+- Framework: Typer
+- Core dependencies: LiteLLM, Semantic Scholar client, Pydantic, httpx, pypdf, Rich
+- Tooling: uv, Ruff, Pyright, Pytest, Nox, GitHub Actions
+
+## Directory Structure
+src/
+  litresearch/      Python package and CLI entrypoints
+
+tests/
+  unit/             Fast unit tests
+  integration/      Integration-level CLI checks
+
+docs/
+  decisions/        ADRs and design notes
+
+## Conventions
+- Keep scaffold files minimal until /plan defines implementation work.
+- Use `src/` layout for all package code.
+- Prefer small, typed modules with fail-fast validation.
+- Keep CLI wiring thin; business logic belongs in separate modules.
+
+## Architecture Decisions
+- Typer provides the public CLI surface.
+- Pydantic settings handle environment-backed configuration.
+- Nox is the single entrypoint for lint, typecheck, and test workflows.
+- GitHub Actions should mirror local `uv run nox` behavior.
+
+## Known Constraints
+- This repo is scaffold-only at init time. Pipeline stages and prompts are not implemented here.
+- Semantic Scholar and LLM provider details stay in configuration, not hard-coded in the scaffold.

litresearch-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-09
+
+
+### Added
+
+- **ci:** Add oss release workflows
+
+
+### Maintenance
+
+- Initial project setup
+

litresearch-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SilasPignotti
+
+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.

litresearch-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: litresearch
+Version: 0.1.0
+Summary: CLI tool for automated literature research workflows.
+Project-URL: Homepage, https://github.com/spignotti/litresearch
+Project-URL: Repository, https://github.com/spignotti/litresearch
+Author-email: Silas Pignotti <pignottisilas@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: litellm>=1.82.0
+Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pypdf>=6.7.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: semanticscholar>=0.11.0
+Requires-Dist: typer>=0.24.1
+Description-Content-Type: text/markdown
+
+# litresearch
+[![CI](https://github.com/spignotti/litresearch/actions/workflows/ci.yml/badge.svg)](https://github.com/spignotti/litresearch/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/litresearch.svg)](https://pypi.org/project/litresearch/)
+
+CLI tool that automates literature research from research questions to curated,
+ranked, and exported paper sets with structured reports.
+
+## Overview
+- Automates discovery, screening, analysis, ranking, and export steps.
+- Targets a CLI-first workflow with an importable Python API.
+- Uses Semantic Scholar for paper metadata and LiteLLM for provider-agnostic LLM access.
+
+## Planned Architecture
+- Framework: Typer CLI with package modules under `src/litresearch/`
+- Core dependencies: LiteLLM, Semantic Scholar client, Pydantic, httpx, pypdf, Rich
+- Outputs: Markdown reports, bibliographic exports, downloaded PDFs, and JSON pipeline state
+
+## Development
+```bash
+uv sync
+uv run nox
+uv run litresearch --help
+```
+
+## Status
+This repository currently contains project scaffolding only. Product logic will be added in later planning and task steps.

litresearch-0.1.0/PROJECT.md

@@ -0,0 +1,142 @@
+# litresearch
+
+## Identity
+- **What**: CLI tool that automates literature research — from research questions to a curated, ranked, and exported set of relevant papers with structured reports.
+- **Why**: Manual literature research (Elicit → PDF download → LLM summarization → manual ranking) is tedious and repetitive. This pipeline automates the entire flow end-to-end.
+- **Type**: cli
+- **Python**: 3.12
+
+## Architecture
+- **Framework**: Typer (CLI) + importable Python API
+- **Dependencies**:
+  - typer: CLI framework with type hints and auto-generated help
+  - litellm: Multi-provider LLM abstraction (100+ providers via unified interface)
+  - semanticscholar: Typed Python client for Semantic Scholar API (paper search, metadata, pagination)
+  - pypdf: PDF text extraction (pure Python, BSD license — MIT-compatible)
+  - pydantic / pydantic-settings: Config validation, typed models, TOML/ENV support
+  - httpx: Async HTTP client for PDF downloads
+  - rich: Terminal output formatting (progress bars, tables, status)
+- **Secrets**:
+  - LLM API key (provider-dependent, e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY) — required
+  - S2_API_KEY — optional (higher rate limits with key, works without)
+
+### Data Flow
+Research Questions → [Query Generation] → [Paper Discovery] → [Metadata Enrichment] → [LLM Analysis] → [Ranking] → [Export]
+- **Trigger**: Manual (CLI command)
+- **Volume**: ~50–200 candidate papers per run, ~20–50 analyzed in depth, Top-N exported
+
+### External Services
+| Service | Auth | Rate Limit | Purpose |
+|---------|------|------------|---------|
+| Semantic Scholar API | API Key (optional) | 1 RPS authenticated, shared pool unauthenticated | Paper search, metadata, OA-PDF links |
+| LLM Provider (via LiteLLM) | API Key (required) | Provider-dependent | Query generation, abstract screening, paper analysis, synthesis |
+
+### Data Model
+- **Input**: List of research questions (strings)
+- **Intermediate State** (JSON, resumable):
+  - Generated facets and search queries
+  - Candidate papers with metadata (title, abstract, authors, year, citations, venue, DOI, PDF URL)
+  - Screening scores (Stage A)
+  - Full analysis results (Stage B)
+- **Output**:
+  - report.md — Main report (questions, search strategy, top-N papers with analysis, synthesis with research gaps)
+  - paper_analyses.md — Detailed analysis of all screened papers
+  - references.bib — BibTeX for top-N papers
+  - references.ris — RIS format (Zotero, Mendeley, Citavi import)
+  - papers/ — Downloaded PDFs of top-N open access papers
+  - data.json — Machine-readable export of all metadata + analyses
+
+### Components
+| Component | Purpose | Priority |
+|-----------|---------|----------|
+| cli.py | Typer CLI with `run`, `resume`, `config` commands | MVP |
+| config.py | Pydantic Settings — all parameters configurable via TOML file + CLI flags + ENV | MVP |
+| models.py | Pydantic models: Paper, Analysis, SearchQuery, Facet, PipelineState | MVP |
+| pipeline.py | Orchestrator — runs stages sequentially, saves state after each stage | MVP |
+| stages/query_gen.py | Stage 1: LLM generates facets + search queries from research questions | MVP |
+| stages/discovery.py | Stage 2: Semantic Scholar API search, deduplication by DOI/Corpus-ID | MVP |
+| stages/enrichment.py | Stage 3: Fetch full metadata for all candidates via S2 API | MVP |
+| stages/analysis.py | Stage 4: Two-phase LLM analysis (A: abstract screening, B: extended with PDF text) | MVP |
+| stages/ranking.py | Stage 5: Multi-criteria ranking (relevance score → citations → year) | MVP |
+| stages/export.py | Stage 6: Generate report.md, paper_analyses.md, references.bib, references.ris, data.json, download PDFs | MVP |
+| pdf.py | PDF text extraction — page heuristic: first N + last M pages | MVP |
+| prompts/query_gen.md | Prompt template for facet + query generation | MVP |
+| prompts/screening.md | Prompt template for abstract screening (Stage A) | MVP |
+| prompts/analysis.md | Prompt template for extended analysis (Stage B) | MVP |
+| prompts/synthesis.md | Prompt template for literature synthesis in report | MVP |
+
+### Pipeline Stages Detail
+
+**Stage 1 — Query Generation**
+LLM receives research questions, derives thematic facets, generates 2–3 targeted search queries per facet. Output: list of Facet objects with queries.
+
+**Stage 2 — Paper Discovery**
+Each query hits Semantic Scholar relevance search endpoint. Results deduplicated by paperId/DOI. Output: candidate pool (typically 50–200 papers).
+
+**Stage 3 — Metadata Enrichment**
+Batch fetch via S2 API: title, abstract, authors, year, citationCount, venue, openAccessPdf, externalIds (DOI). Output: enriched Paper objects.
+
+**Stage 4A — Abstract Screening**
+Each paper's abstract + metadata sent to LLM. Returns relevance score (0–100). Papers below threshold (default: 40) are filtered out. Fast, cheap (short prompts).
+
+**Stage 4B — Extended Analysis**
+For papers passing screening: download PDF, extract first 4 + last 2 pages via pypdf, send to LLM with full analysis prompt. Returns: summary, key_findings, methodology, relevance_score (refined), relevance_rationale.
+
+**Stage 5 — Ranking**
+Sort by: relevance_score (desc) → citationCount (desc) → year (desc). Apply top_n cutoff.
+
+**Stage 6 — Export**
+Generate all output files. report.md includes a final LLM-generated synthesis section analyzing consensus, contradictions, and research gaps across top-N papers.
+
+## Objectives
+### MVP (v0.1)
+- [ ] Full pipeline runs end-to-end: questions in → report + PDFs + BibTeX out
+- [ ] All 6 stages implemented and working
+- [ ] Configuration via TOML file + CLI flags
+- [ ] Resume interrupted runs via --resume flag
+- [ ] Works with at least OpenAI and Anthropic via LiteLLM
+- [ ] Installable via pip install (proper pyproject.toml with entry point)
+- [ ] README with quickstart, usage examples, configuration reference
+- [ ] Tests for core logic (models, ranking, export formatting)
+- [ ] CI via GitHub Actions (nox: lint + typecheck + test)
+
+### Non-Goals
+- GUI / Web interface
+- NotebookLM integration
+- Citation graph analysis
+- Full-text PDF analysis (MVP uses page heuristic)
+- Configurable analysis schema (MVP uses fixed schema)
+- Section-aware PDF parsing (GROBID)
+- Multi-source search (OpenAlex) — S2 only for MVP
+
+## Constraints
+- Semantic Scholar API: 1 RPS with key, respect rate limits. Use async batch where possible.
+- LLM costs: Two-phase analysis minimizes tokens. Abstract screening is cheap (~200 tokens/paper). Extended analysis only for papers above threshold.
+- PDF downloads: Only open access papers. Fail gracefully if PDF unavailable.
+- License compatibility: All dependencies must be MIT/BSD/Apache-2.0 compatible. No AGPL.
+
+## Setup
+- **Category**: Open Source
+- **Git Remote**: https://github.com/SilasPignotti/litresearch
+- **License**: MIT
+- **Release**: PyPI via GitHub Actions (Trusted Publisher, tag-triggered)
+- **Versioning**: SemVer, start at 0.1.0, manual bumping + git-cliff for changelogs
+- **Python**: 3.12
+- **Package Manager**: uv
+- **Quality**: nox (sessions: lint, typecheck, test) + ruff + pyright + pytest
+- **CI**: GitHub Actions running nox on push/PR
+
+## Context
+- **Key Docs**:
+  - Semantic Scholar API: https://api.semanticscholar.org/api-docs/
+  - semanticscholar Python client: https://semanticscholar.readthedocs.io/
+  - LiteLLM: https://docs.litellm.ai/docs/
+  - Typer: https://typer.tiangolo.com/
+  - pypdf: https://pypdf.readthedocs.io/
+- **Decisions**:
+  - LiteLLM over direct API calls — provider-agnostic is critical for open source adoption
+  - pypdf over PyMuPDF — AGPL license incompatible with MIT project
+  - JSON state over SQLite — simpler for MVP, SQLite as future enhancement
+  - Page heuristic (first 4 + last 2 pages) over section-aware parsing — no external services needed
+  - Prompts as markdown files — editable without code changes, version-controlled
+  - Dual interface (CLI + Python API) — Typer for CLI, underlying functions importable as library

litresearch-0.1.0/README.md

@@ -0,0 +1,25 @@
+# litresearch
+[![CI](https://github.com/spignotti/litresearch/actions/workflows/ci.yml/badge.svg)](https://github.com/spignotti/litresearch/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/litresearch.svg)](https://pypi.org/project/litresearch/)
+
+CLI tool that automates literature research from research questions to curated,
+ranked, and exported paper sets with structured reports.
+
+## Overview
+- Automates discovery, screening, analysis, ranking, and export steps.
+- Targets a CLI-first workflow with an importable Python API.
+- Uses Semantic Scholar for paper metadata and LiteLLM for provider-agnostic LLM access.
+
+## Planned Architecture
+- Framework: Typer CLI with package modules under `src/litresearch/`
+- Core dependencies: LiteLLM, Semantic Scholar client, Pydantic, httpx, pypdf, Rich
+- Outputs: Markdown reports, bibliographic exports, downloaded PDFs, and JSON pipeline state
+
+## Development
+```bash
+uv sync
+uv run nox
+uv run litresearch --help
+```
+
+## Status
+This repository currently contains project scaffolding only. Product logic will be added in later planning and task steps.

litresearch-0.1.0/cliff.toml

@@ -0,0 +1,49 @@
+[changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+"""
+body = """
+{% if version %}
+## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}
+## [Unreleased]
+{% endif %}
+{% for group, commits in commits | group_by(attribute="group") %}
+### {{ group }}
+{% for commit in commits %}
+- {% if commit.scope %}**{{ commit.scope }}:** {% endif %}{{ commit.message | upper_first }}
+{% endfor %}
+{% endfor %}
+"""
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+tag_pattern = "v[0-9]*"
+split_commits = false
+
+commit_preprocessors = [
+  { pattern = "\\((#\\d+)\\)", replace = "" },
+]
+
+commit_parsers = [
+  { message = "^feat", group = "Added" },
+  { message = "^fix", group = "Fixed" },
+  { message = "^refactor", group = "Changed" },
+  { message = "^perf", group = "Changed" },
+  { message = "^docs", group = "Documentation" },
+  { message = "^test", group = "Tests" },
+  { message = "^chore", group = "Maintenance" },
+  { body = ".*security", group = "Security" },
+]
+
+protect_breaking_commits = false
+filter_commits = false
+toposort = false
+sort_commits = "oldest"

litresearch-0.1.0/noxfile.py

@@ -0,0 +1,51 @@
+import nox
+
+nox.options.sessions = ["lint", "typecheck", "test"]
+nox.options.stop_on_first_error = False
+
+
+@nox.session
+def lint(session: nox.Session) -> None:
+    """Check code with ruff."""
+    session.run("uv", "run", "ruff", "check", "src", "tests", external=True)
+    session.run("uv", "run", "ruff", "format", "--check", "src", "tests", external=True)
+
+
+@nox.session
+def format(session: nox.Session) -> None:
+    """Format code with ruff."""
+    session.run("uv", "run", "ruff", "format", "src", "tests", external=True)
+
+
+@nox.session
+def typecheck(session: nox.Session) -> None:
+    """Type check with pyright."""
+    session.run("uv", "run", "pyright", external=True)
+
+
+@nox.session
+def fix(session: nox.Session) -> None:
+    """Auto-fix lint issues and format code."""
+    session.run("uv", "run", "ruff", "check", "--fix", "src", "tests", external=True)
+    session.run("uv", "run", "ruff", "format", "src", "tests", external=True)
+
+
+@nox.session
+def test(session: nox.Session) -> None:
+    """Run tests."""
+    session.run("uv", "run", "pytest", "-v", external=True)
+
+
+@nox.session
+def coverage(session: nox.Session) -> None:
+    """Run tests with coverage."""
+    session.run("uv", "run", "pytest", "--cov=src", "--cov-report=term", "-v", external=True)
+
+
+@nox.session
+def ci(session: nox.Session) -> None:
+    """Run the full CI pipeline."""
+    session.run("uv", "run", "ruff", "check", "src", "tests", external=True)
+    session.run("uv", "run", "ruff", "format", "--check", "src", "tests", external=True)
+    session.run("uv", "run", "pyright", external=True)
+    session.run("uv", "run", "pytest", "--cov=src", "-v", external=True)

litresearch-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "litresearch"
+version = "0.1.0"
+description = "CLI tool for automated literature research workflows."
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    { name = "Silas Pignotti", email = "pignottisilas@gmail.com" },
+]
+license = { text = "MIT" }
+dependencies = [
+    "httpx>=0.28.1",
+    "litellm>=1.82.0",
+    "pydantic>=2.12.5",
+    "pydantic-settings>=2.13.1",
+    "pypdf>=6.7.5",
+    "rich>=14.3.3",
+    "semanticscholar>=0.11.0",
+    "typer>=0.24.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/spignotti/litresearch"
+Repository = "https://github.com/spignotti/litresearch"
+
+[project.scripts]
+litresearch = "litresearch.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "nox>=2026.2.9",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.15.5",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B"]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.12"
+venvPath = "."
+venv = ".venv"
+typeCheckingMode = "standard"
+
+[tool.pytest.ini_options]
+addopts = "-q"
+pythonpath = ["src"]
+testpaths = ["tests"]

litresearch-0.1.0/src/litresearch/__init__.py

@@ -0,0 +1,5 @@
+"""litresearch package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

litresearch-0.1.0/src/litresearch/__main__.py

@@ -0,0 +1,6 @@
+"""Module entrypoint for `python -m litresearch`."""
+
+from litresearch.cli import main
+
+if __name__ == "__main__":
+    main()

litresearch-0.1.0/src/litresearch/cli.py

@@ -0,0 +1,30 @@
+"""CLI entrypoints for litresearch."""
+
+import typer
+from rich.console import Console
+
+from litresearch import __version__
+from litresearch.config import Settings
+
+app = typer.Typer(help="Automated literature research workflow CLI.")
+console = Console()
+
+
+@app.command()
+def version() -> None:
+    """Print the installed version."""
+    console.print(__version__)
+
+
+@app.command()
+def config() -> None:
+    """Show basic configuration status without exposing secrets."""
+    settings = Settings()
+    console.print(f"default_model={settings.default_model}")
+    console.print(f"s2_api_key_configured={bool(settings.s2_api_key)}")
+    console.print(f"llm_api_key_configured={settings.has_llm_api_key}")
+
+
+def main() -> None:
+    """Run the Typer application."""
+    app()

litresearch-0.1.0/src/litresearch/config.py

@@ -0,0 +1,28 @@
+"""Application settings for litresearch."""
+
+from pydantic import computed_field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Environment-backed settings."""
+
+    model_config = SettingsConfigDict(env_file=".env", extra="ignore")
+
+    openai_api_key: str | None = None
+    anthropic_api_key: str | None = None
+    openrouter_api_key: str | None = None
+    s2_api_key: str | None = None
+    default_model: str = "gpt-4o-mini"
+
+    @computed_field
+    @property
+    def has_llm_api_key(self) -> bool:
+        """Return whether any supported LLM provider key is configured."""
+        return any(
+            [
+                self.openai_api_key,
+                self.anthropic_api_key,
+                self.openrouter_api_key,
+            ]
+        )

litresearch-0.1.0/src/litresearch/models.py

@@ -0,0 +1,9 @@
+"""Shared data models for the litresearch scaffold."""
+
+from pydantic import BaseModel, Field
+
+
+class ResearchRequest(BaseModel):
+    """Minimal input model for future pipeline work."""
+
+    questions: list[str] = Field(default_factory=list)

litresearch-0.1.0/tests/integration/test_module_entrypoint.py

@@ -0,0 +1,21 @@
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+
+def test_module_entrypoint_shows_help() -> None:
+    env = os.environ.copy()
+    src_path = str(Path(__file__).resolve().parents[2] / "src")
+    env["PYTHONPATH"] = src_path if not env.get("PYTHONPATH") else f"{src_path}:{env['PYTHONPATH']}"
+
+    result = subprocess.run(
+        [sys.executable, "-m", "litresearch", "--help"],
+        capture_output=True,
+        text=True,
+        check=False,
+        env=env,
+    )
+
+    assert result.returncode == 0
+    assert "Automated literature research workflow CLI" in result.stdout

litresearch-0.1.0/tests/unit/test_cli.py

@@ -0,0 +1,12 @@
+from typer.testing import CliRunner
+
+from litresearch.cli import app
+
+runner = CliRunner()
+
+
+def test_version_command() -> None:
+    result = runner.invoke(app, ["version"])
+
+    assert result.exit_code == 0
+    assert "0.1.0" in result.stdout