litman 1.0.0__tar.gz

litman-1.0.0/LICENSE

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

litman-1.0.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: litman
+Version: 1.0.0
+Summary: Local-first, AI-augmented literature management CLI
+Author-email: Qingxin Wang <qingxinwong1999@gmail.com>
+License-Expression: MIT
+Keywords: literature,bibliography,reference-manager,papers,bibtex,knowledge-management,cli,local-first,claude-code,ai-agent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9,>=8.1
+Requires-Dist: ruamel.yaml>=0.18
+Requires-Dist: httpx>=0.27
+Requires-Dist: pypdf>=4.0
+Requires-Dist: pydantic>=2.5
+Requires-Dist: rich>=13.0
+Requires-Dist: platformdirs>=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Dynamic: license-file
+
+<h1>LITerature MANager <img src="assets/logo1.png" width="120" align="right"/></h1>
+
+<br clear="all"/>
+
+<div align="center">
+
+<img src="assets/logo2.svg" width="58%" alt="LITMAN"/>
+
+<p>
+<img src="https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white" alt="Python 3.12+"/>
+<img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"/>
+<img src="https://img.shields.io/badge/AI--native-Claude%20Code-D97757?logo=anthropic&logoColor=white" alt="AI-native: Claude Code"/>
+</p>
+
+<p><b>English</b> | <a href="README-CN.md">中文</a></p>
+
+</div>
+
+**Local-first, AI-augmented literature management CLI.**
+
+A local knowledge base for research papers, stored as plain files on your
+disk. Papers link explicitly to projects, code repositories, and each other
+through structured metadata and symlinks. Bundled Claude Code skills let an
+AI agent operate the CLI on your behalf; every command works equally well
+typed by hand.
+
+---
+
+## Know before you use
+
+A few things worth knowing up front:
+
+1. **Don't move a vault or project folder by hand.** Links (symlinks, project
+   bridges, the registry) are path-based and will break. If you must move one,
+   run `lit health-check` afterwards to find and repair what broke.
+2. **Figure/table reading needs a multimodal model.** A text-only model falls
+   back to plain-text extraction (pypdf) and cannot see figures or
+   image-based tables — don't ask it "what does Fig./Table N show?" without a
+   vision or OCR backend attached.
+3. **Don't edit metadata by hand.** Use `lit` commands to modify papers,
+   taxonomy, and config — or ask an AI agent if you're unsure which command
+   to use.
+4. **Windows users.** Symlink-based features (browsing views, project bridges)
+   require administrator privileges; all other commands work regardless.
+   [WSL](https://learn.microsoft.com/en-us/windows/wsl/) is recommended.
+
+## Key Features
+
+1. **Long-term reliable local knowledge vault.** Everything is plain
+   text on your filesystem — YAML metadata, markdown notes, original
+   PDFs. No cloud database, no proprietary container format. Back it up
+   anywhere, read every file as plain text, `grep` the whole library.
+
+2. **Consistent by design.** Topics, methods, projects, and data
+   sources are governed by a shared `TAXONOMY.md` controlled vocabulary.
+   Atomic operations keep cross-references clean as the library grows,
+   and `lit health-check` catches any drift before it accumulates.
+
+3. **Paper ↔ project ↔ code triangle.** One paper can be bound to
+   multiple projects without duplication; each project gets its own
+   symlinked working folder and an auto-generated `REFERENCES.md`. Each
+   paper can also be bound to its official code repository, cloned
+   inside the vault. Metadata fields and symlinks together form an
+   explicit, navigable knowledge graph — no manual upkeep required.
+
+4. **AI-native CLI.** Two bundled Claude Code skills (`lit-library` for
+   ingestion and retrieval, `lit-reading` for reading assistance) teach
+   an agent how to navigate the vault and operate the CLI on your
+   behalf. The agent emits structured JSON; the CLI validates and
+   writes the data — your library stays correct even when the model
+   isn't perfect.
+
+---
+
+## Install
+
+litman is a Python CLI tool. Install with **pipx** so `lit` is permanently
+available in every shell, isolated from your other Python environments.
+Don't have pipx? See [pipx.pypa.io](https://pipx.pypa.io).
+
+**From PyPI** (recommended):
+
+```bash
+pipx install litman   # first install
+pipx upgrade litman   # update
+```
+
+**From a local clone** (development):
+
+```bash
+# first install
+git clone https://github.com/wqx1999/litman.git
+cd litman
+pipx install .
+
+# update (pull latest code first)
+git pull
+pipx install --force .
+```
+
+Then run the one-shot setup wizard:
+
+```bash
+lit setup   # interactive wizard: shell completion → Claude Code skill → vault setup → (optional) cloud sync
+```
+
+## Quick start
+
+### With an AI agent
+
+```
+Create a new vault at /work/me/.
+Add ~/Downloads/attention_is_all_you_need.pdf to my vault.
+Show me all papers tagged with topic: transformer.
+Tag 2017_Vaswani_Attention with topic: attention.
+Link 2017_Vaswani_Attention to project MyResearchProject.
+Remove 2017_Vaswani_Attention from my vault.
+```
+
+### CLI
+
+```bash
+# create a vault (pass the parent dir; CLI creates the subdir and registers it)
+lit init /work/me/
+
+# add a paper
+lit add ~/Downloads/attention_is_all_you_need.pdf --doi 10.48550/arXiv.1706.03762
+
+# browse
+lit list
+lit show 2017_Vaswani_Attention
+
+# tag
+lit taxonomy add topics transformer
+lit modify 2017_Vaswani_Attention --add-tag topics=transformer
+
+# link to a project
+lit link 2017_Vaswani_Attention --project MyResearchProject
+
+# remove
+lit rm 2017_Vaswani_Attention
+```
+
+
+---
+
+## Agent model benchmark
+
+litman's agent layer (the bundled `lit-library` and `lit-reading` skills) is
+meant to work with whatever model you point Claude Code at, not only Anthropic's.
+To see how well different models drive it, we ran each one as the Claude Code
+backend and had it operate litman through the skills, over **22 everyday-workflow
+tasks** (add, read, tag, modify, link, export, taxonomy edits, health checks,
+...), 3 rounds each, on the **litman 1.0.0** codebase ([commit 876d11c](https://github.com/wqx1999/litman/commit/876d11c), June 2026).
+
+**What the score is.** Each task is a **single-turn prompt in a clean context**:
+a fresh agent gets one natural-language instruction and must complete it in that
+one turn, with no prior conversation and no follow-up. **TRR** (task-completion
+rate) is the fraction of tasks the resulting vault state passed; **RA** (routing
+accuracy) is how often the agent picked the correct skill for a request.
+
+**A low score does not mean the model cannot operate litman.** It means the model
+less often *one-shots* the task from a cold start. With more guidance (a more
+detailed request, or a few follow-up turns) a lower-scoring model can still do the
+same work. This is a deliberately hard zero-shot floor, not a ceiling.
+
+| Model | Task completion (TRR) | Routing (RA) |
+|:---|---:|---:|
+| [Claude Sonnet 4.6](https://www.anthropic.com) | 97% | 100% |
+| [Claude Haiku 4.5](https://www.anthropic.com) | 97% | 79% |
+| [DeepSeek-V4 Flash](https://www.deepseek.com) | 80% | 71% |
+| [DeepSeek-V4 Pro](https://www.deepseek.com) | 76% | 57% |
+| [MiniMax-M3](https://www.minimax.io) | 71% | 75% |
+| [GLM-5.1](https://z.ai/model-api) | 58% | 64% |
+| [MiMo-V2.5 Pro](https://mimo.mi.com/) | 26% | 0% |
+| [MiMo-V2.5](https://mimo.mi.com/) | 21% | 0% |
+
+TRR is the mean over the 22 auto-scored tasks across 3 rounds; network-dependent
+and multi-turn scenarios (code cloning, cloud sync, a multi-turn recovery case)
+are excluded from this single-turn score. Whatever the model scores, the data
+layer validates every write — a wrong command fails loudly rather than writing
+bad data into the vault, so a lower-scoring model needs more turns but never
+corrupts the library.
+
+---
+
+## Documentation
+
+Full documentation lives under [`docs/`](docs/). New to litman? The
+[tutorial](docs/5-tutorial.md) covers about 80% of everyday use; for anything
+else, ask the agent or check the command reference. [docs/0-readme.md](docs/0-readme.md)
+maps out the whole set.
+
+| Topic | File |
+|---|---|
+| Start here — docs map | [docs/0-readme.md](docs/0-readme.md) |
+| Design philosophy | [docs/1-philosophy.md](docs/1-philosophy.md) |
+| Four-layer architecture | [docs/2-architecture.md](docs/2-architecture.md) |
+| Concepts and field reference (`metadata.yaml`, `lit-config.yaml`, `TAXONOMY.md`) | [docs/3-concepts.md](docs/3-concepts.md) |
+| Command reference | [docs/4-commands.md](docs/4-commands.md) |
+| Tutorial | [docs/5-tutorial.md](docs/5-tutorial.md) |
+
+Local-preview the docs as a static site:
+
+```bash
+pip install mkdocs mkdocs-material
+mkdocs serve
+```
+
+## Acknowledgments
+
+This tool was developed in the [Süssmuth Lab](https://www.tu.berlin/en/biochemie/research/research-in-suessmuth-group), Technische Universität Berlin. Development was carried out with access to the [TU Berlin HPC cluster](https://www.tu.berlin/en/hpc-cluster/introduction-slurm-version).
+
+This project was built with the help of AI-powered development tools:
+
+[![Claude Code](https://img.shields.io/badge/Claude_Code-Anthropic-d4a574?logo=anthropic&logoColor=white)](https://claude.ai/code)
+[![Cursor](https://img.shields.io/badge/Cursor-AI_Editor-000000?logo=cursor&logoColor=white)](https://cursor.sh)
+
+Core dependencies that make litman possible:
+
+[![Click](https://img.shields.io/badge/Click-CLI_Framework-4B8BBE?logoColor=white)](https://click.palletsprojects.com/)
+[![ruamel.yaml](https://img.shields.io/badge/ruamel.yaml-YAML_Parser-FFDD54?logoColor=black)](https://pypi.org/project/ruamel.yaml/)
+[![pypdf](https://img.shields.io/badge/pypdf-PDF_Extraction-EE4C2C?logoColor=white)](https://pypdf.readthedocs.io/)
+[![Pydantic](https://img.shields.io/badge/Pydantic-Data_Validation-E92063?logo=pydantic&logoColor=white)](https://docs.pydantic.dev/)
+[![Rich](https://img.shields.io/badge/Rich-Terminal_UI-FAD000?logoColor=black)](https://rich.readthedocs.io/)
+[![httpx](https://img.shields.io/badge/httpx-HTTP_Client-2D9CDB?logoColor=white)](https://www.python-httpx.org/)
+
+Cloud sync (`lit sync`) is powered by [rclone](https://rclone.org/), the external
+CLI that mirrors the vault to any cloud backend it supports — the backbone of how
+a vault gets backed up and moved between machines:
+
+[![rclone](https://img.shields.io/badge/rclone-Cloud_Sync_Engine-3F87E5?logo=rclone&logoColor=white)](https://rclone.org/)
+
+Octopus mascot generated with [Doubao](https://www.doubao.com/) (AI image generation).
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).
+
+---
+
+<sub>AI agents: a condensed, link-dense map of this project lives in [README-Agent.md](README-Agent.md).</sub>

litman-1.0.0/README.md

@@ -0,0 +1,242 @@
+<h1>LITerature MANager <img src="assets/logo1.png" width="120" align="right"/></h1>
+
+<br clear="all"/>
+
+<div align="center">
+
+<img src="assets/logo2.svg" width="58%" alt="LITMAN"/>
+
+<p>
+<img src="https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white" alt="Python 3.12+"/>
+<img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"/>
+<img src="https://img.shields.io/badge/AI--native-Claude%20Code-D97757?logo=anthropic&logoColor=white" alt="AI-native: Claude Code"/>
+</p>
+
+<p><b>English</b> | <a href="README-CN.md">中文</a></p>
+
+</div>
+
+**Local-first, AI-augmented literature management CLI.**
+
+A local knowledge base for research papers, stored as plain files on your
+disk. Papers link explicitly to projects, code repositories, and each other
+through structured metadata and symlinks. Bundled Claude Code skills let an
+AI agent operate the CLI on your behalf; every command works equally well
+typed by hand.
+
+---
+
+## Know before you use
+
+A few things worth knowing up front:
+
+1. **Don't move a vault or project folder by hand.** Links (symlinks, project
+   bridges, the registry) are path-based and will break. If you must move one,
+   run `lit health-check` afterwards to find and repair what broke.
+2. **Figure/table reading needs a multimodal model.** A text-only model falls
+   back to plain-text extraction (pypdf) and cannot see figures or
+   image-based tables — don't ask it "what does Fig./Table N show?" without a
+   vision or OCR backend attached.
+3. **Don't edit metadata by hand.** Use `lit` commands to modify papers,
+   taxonomy, and config — or ask an AI agent if you're unsure which command
+   to use.
+4. **Windows users.** Symlink-based features (browsing views, project bridges)
+   require administrator privileges; all other commands work regardless.
+   [WSL](https://learn.microsoft.com/en-us/windows/wsl/) is recommended.
+
+## Key Features
+
+1. **Long-term reliable local knowledge vault.** Everything is plain
+   text on your filesystem — YAML metadata, markdown notes, original
+   PDFs. No cloud database, no proprietary container format. Back it up
+   anywhere, read every file as plain text, `grep` the whole library.
+
+2. **Consistent by design.** Topics, methods, projects, and data
+   sources are governed by a shared `TAXONOMY.md` controlled vocabulary.
+   Atomic operations keep cross-references clean as the library grows,
+   and `lit health-check` catches any drift before it accumulates.
+
+3. **Paper ↔ project ↔ code triangle.** One paper can be bound to
+   multiple projects without duplication; each project gets its own
+   symlinked working folder and an auto-generated `REFERENCES.md`. Each
+   paper can also be bound to its official code repository, cloned
+   inside the vault. Metadata fields and symlinks together form an
+   explicit, navigable knowledge graph — no manual upkeep required.
+
+4. **AI-native CLI.** Two bundled Claude Code skills (`lit-library` for
+   ingestion and retrieval, `lit-reading` for reading assistance) teach
+   an agent how to navigate the vault and operate the CLI on your
+   behalf. The agent emits structured JSON; the CLI validates and
+   writes the data — your library stays correct even when the model
+   isn't perfect.
+
+---
+
+## Install
+
+litman is a Python CLI tool. Install with **pipx** so `lit` is permanently
+available in every shell, isolated from your other Python environments.
+Don't have pipx? See [pipx.pypa.io](https://pipx.pypa.io).
+
+**From PyPI** (recommended):
+
+```bash
+pipx install litman   # first install
+pipx upgrade litman   # update
+```
+
+**From a local clone** (development):
+
+```bash
+# first install
+git clone https://github.com/wqx1999/litman.git
+cd litman
+pipx install .
+
+# update (pull latest code first)
+git pull
+pipx install --force .
+```
+
+Then run the one-shot setup wizard:
+
+```bash
+lit setup   # interactive wizard: shell completion → Claude Code skill → vault setup → (optional) cloud sync
+```
+
+## Quick start
+
+### With an AI agent
+
+```
+Create a new vault at /work/me/.
+Add ~/Downloads/attention_is_all_you_need.pdf to my vault.
+Show me all papers tagged with topic: transformer.
+Tag 2017_Vaswani_Attention with topic: attention.
+Link 2017_Vaswani_Attention to project MyResearchProject.
+Remove 2017_Vaswani_Attention from my vault.
+```
+
+### CLI
+
+```bash
+# create a vault (pass the parent dir; CLI creates the subdir and registers it)
+lit init /work/me/
+
+# add a paper
+lit add ~/Downloads/attention_is_all_you_need.pdf --doi 10.48550/arXiv.1706.03762
+
+# browse
+lit list
+lit show 2017_Vaswani_Attention
+
+# tag
+lit taxonomy add topics transformer
+lit modify 2017_Vaswani_Attention --add-tag topics=transformer
+
+# link to a project
+lit link 2017_Vaswani_Attention --project MyResearchProject
+
+# remove
+lit rm 2017_Vaswani_Attention
+```
+
+
+---
+
+## Agent model benchmark
+
+litman's agent layer (the bundled `lit-library` and `lit-reading` skills) is
+meant to work with whatever model you point Claude Code at, not only Anthropic's.
+To see how well different models drive it, we ran each one as the Claude Code
+backend and had it operate litman through the skills, over **22 everyday-workflow
+tasks** (add, read, tag, modify, link, export, taxonomy edits, health checks,
+...), 3 rounds each, on the **litman 1.0.0** codebase ([commit 876d11c](https://github.com/wqx1999/litman/commit/876d11c), June 2026).
+
+**What the score is.** Each task is a **single-turn prompt in a clean context**:
+a fresh agent gets one natural-language instruction and must complete it in that
+one turn, with no prior conversation and no follow-up. **TRR** (task-completion
+rate) is the fraction of tasks the resulting vault state passed; **RA** (routing
+accuracy) is how often the agent picked the correct skill for a request.
+
+**A low score does not mean the model cannot operate litman.** It means the model
+less often *one-shots* the task from a cold start. With more guidance (a more
+detailed request, or a few follow-up turns) a lower-scoring model can still do the
+same work. This is a deliberately hard zero-shot floor, not a ceiling.
+
+| Model | Task completion (TRR) | Routing (RA) |
+|:---|---:|---:|
+| [Claude Sonnet 4.6](https://www.anthropic.com) | 97% | 100% |
+| [Claude Haiku 4.5](https://www.anthropic.com) | 97% | 79% |
+| [DeepSeek-V4 Flash](https://www.deepseek.com) | 80% | 71% |
+| [DeepSeek-V4 Pro](https://www.deepseek.com) | 76% | 57% |
+| [MiniMax-M3](https://www.minimax.io) | 71% | 75% |
+| [GLM-5.1](https://z.ai/model-api) | 58% | 64% |
+| [MiMo-V2.5 Pro](https://mimo.mi.com/) | 26% | 0% |
+| [MiMo-V2.5](https://mimo.mi.com/) | 21% | 0% |
+
+TRR is the mean over the 22 auto-scored tasks across 3 rounds; network-dependent
+and multi-turn scenarios (code cloning, cloud sync, a multi-turn recovery case)
+are excluded from this single-turn score. Whatever the model scores, the data
+layer validates every write — a wrong command fails loudly rather than writing
+bad data into the vault, so a lower-scoring model needs more turns but never
+corrupts the library.
+
+---
+
+## Documentation
+
+Full documentation lives under [`docs/`](docs/). New to litman? The
+[tutorial](docs/5-tutorial.md) covers about 80% of everyday use; for anything
+else, ask the agent or check the command reference. [docs/0-readme.md](docs/0-readme.md)
+maps out the whole set.
+
+| Topic | File |
+|---|---|
+| Start here — docs map | [docs/0-readme.md](docs/0-readme.md) |
+| Design philosophy | [docs/1-philosophy.md](docs/1-philosophy.md) |
+| Four-layer architecture | [docs/2-architecture.md](docs/2-architecture.md) |
+| Concepts and field reference (`metadata.yaml`, `lit-config.yaml`, `TAXONOMY.md`) | [docs/3-concepts.md](docs/3-concepts.md) |
+| Command reference | [docs/4-commands.md](docs/4-commands.md) |
+| Tutorial | [docs/5-tutorial.md](docs/5-tutorial.md) |
+
+Local-preview the docs as a static site:
+
+```bash
+pip install mkdocs mkdocs-material
+mkdocs serve
+```
+
+## Acknowledgments
+
+This tool was developed in the [Süssmuth Lab](https://www.tu.berlin/en/biochemie/research/research-in-suessmuth-group), Technische Universität Berlin. Development was carried out with access to the [TU Berlin HPC cluster](https://www.tu.berlin/en/hpc-cluster/introduction-slurm-version).
+
+This project was built with the help of AI-powered development tools:
+
+[![Claude Code](https://img.shields.io/badge/Claude_Code-Anthropic-d4a574?logo=anthropic&logoColor=white)](https://claude.ai/code)
+[![Cursor](https://img.shields.io/badge/Cursor-AI_Editor-000000?logo=cursor&logoColor=white)](https://cursor.sh)
+
+Core dependencies that make litman possible:
+
+[![Click](https://img.shields.io/badge/Click-CLI_Framework-4B8BBE?logoColor=white)](https://click.palletsprojects.com/)
+[![ruamel.yaml](https://img.shields.io/badge/ruamel.yaml-YAML_Parser-FFDD54?logoColor=black)](https://pypi.org/project/ruamel.yaml/)
+[![pypdf](https://img.shields.io/badge/pypdf-PDF_Extraction-EE4C2C?logoColor=white)](https://pypdf.readthedocs.io/)
+[![Pydantic](https://img.shields.io/badge/Pydantic-Data_Validation-E92063?logo=pydantic&logoColor=white)](https://docs.pydantic.dev/)
+[![Rich](https://img.shields.io/badge/Rich-Terminal_UI-FAD000?logoColor=black)](https://rich.readthedocs.io/)
+[![httpx](https://img.shields.io/badge/httpx-HTTP_Client-2D9CDB?logoColor=white)](https://www.python-httpx.org/)
+
+Cloud sync (`lit sync`) is powered by [rclone](https://rclone.org/), the external
+CLI that mirrors the vault to any cloud backend it supports — the backbone of how
+a vault gets backed up and moved between machines:
+
+[![rclone](https://img.shields.io/badge/rclone-Cloud_Sync_Engine-3F87E5?logo=rclone&logoColor=white)](https://rclone.org/)
+
+Octopus mascot generated with [Doubao](https://www.doubao.com/) (AI image generation).
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).
+
+---
+
+<sub>AI agents: a condensed, link-dense map of this project lives in [README-Agent.md](README-Agent.md).</sub>

litman-1.0.0/pyproject.toml

@@ -0,0 +1,101 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "litman"
+dynamic = ["version"]
+description = "Local-first, AI-augmented literature management CLI"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Qingxin Wang", email = "qingxinwong1999@gmail.com" },
+]
+keywords = [
+    "literature", "bibliography", "reference-manager", "papers", "bibtex",
+    "knowledge-management", "cli", "local-first", "claude-code", "ai-agent",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "click>=8.1,<9",
+    "ruamel.yaml>=0.18",
+    "httpx>=0.27",
+    "pypdf>=4.0",
+    "pydantic>=2.5",
+    "rich>=13.0",
+    "platformdirs>=4.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+    "pytest-cov",
+    "ruff>=0.4",
+    "mypy>=1.10",
+]
+
+[project.scripts]
+lit = "litman.cli:main"
+
+# Single source of truth for the version: src/litman/__init__.py __version__.
+# pyproject reads it via attr so `lit --version`, the wheel metadata, and the
+# string in exported BibTeX / the Crossref User-Agent can never drift apart.
+# Bump __version__ following semver for each release; tag the commit v<X.Y.Z>.
+[tool.setuptools.dynamic]
+version = { attr = "litman.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["litman*"]
+
+# Bundle the skill markdown files so `lit install-skill` can copy them
+# from the installed package via importlib.resources. Without this, the
+# skill subdirectories are dropped by the wheel build because they
+# contain no Python sources. Add a pair of patterns for every new skill.
+[tool.setuptools.package-data]
+"litman.skills" = [
+    "lit-library/*", "lit-library/**/*",
+    "lit-reading/*", "lit-reading/**/*",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src"]
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "UP",   # pyupgrade
+    "SIM",  # flake8-simplify
+    "C4",   # flake8-comprehensions
+    "RUF",  # ruff-specific
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["B011"]  # tests can use `assert False`
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_unused_ignores = true
+files = ["src/litman", "tests"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"

litman-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

litman-1.0.0/src/litman/__init__.py

@@ -0,0 +1,3 @@
+"""litman — local-first, AI-augmented literature management CLI."""
+
+__version__ = "1.0.0"

litman-1.0.0/src/litman/__main__.py

@@ -0,0 +1,6 @@
+"""Allow `python -m litman` to invoke the CLI."""
+
+from litman.cli import main
+
+if __name__ == "__main__":
+    main()