paper-manager 0.11.1 → 0.11.2

package/README.md

@@ -5,6 +5,20 @@
 
 A CLI tool for managing academic papers with knowledge base and vector search support.
 
+## Features
+
+- **Semantic search** — FAISS vector indexing with configurable embedding models, query your papers by meaning rather than keywords
+- **PDF metadata extraction** — automatically extracts title, author, keywords, DOI, and more from PDF files
+- **DOI deduplication** — detects duplicate papers by DOI before adding, with `--force` override
+- **Multi-format support** — import from PDF, TXT, MD, TEX, and other text-based formats
+- **PDF-to-Markdown conversion** — optional high-quality conversion via [opendataloader-pdf](https://github.com/nicobailon/opendataloader-pdf) with image extraction
+- **Dual-scope data model** — user-level (`~/.paper-manager/`) for global collections and project-level (`./.paper-manager/`) for project-specific papers, with automatic scope resolution
+- **DOI-to-BibTeX** — convert DOI to BibTeX citation in one command
+- **Machine-readable output** — `--json` and `--jq` flags on all read commands for scripting and automation
+- **Literature notes** — attach key-value annotations to any paper
+- **Local-first** — SQLite + FAISS + filesystem, no cloud dependencies
+- **Agent skill** — installable as a [coding agent skill](https://github.com/vercel-labs/skills) for agent-driven paper management
+
 ## Installation
 
 ```bash

package/dist/config/index.js

@@ -5,12 +5,45 @@ import * as z from "zod";
 import { EmbeddingModelConfigSchema } from "../types/index.js";
 // ─── Path Utilities ─────────────────────────────────────────
 const USER_DATA_DIR = path.join(os.homedir(), ".paper-manager");
-const PROJECT_DATA_DIR = path.resolve(".paper-manager");
+const DIR_NAME = ".paper-manager";
+function findProjectDataDir() {
+    let dir = process.cwd();
+    while (true) {
+        const candidate = path.join(dir, DIR_NAME);
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: CWD (no .paper-manager/ found up the tree)
+    return path.resolve(DIR_NAME);
+}
+let cachedProjectDataDir;
 export function getUserDataDir() {
     return USER_DATA_DIR;
 }
+/**
+ * Returns the project-level `.paper-manager/` directory path, traversing
+ * up from CWD. Falls back to CWD if not found. Result is cached per process.
+ */
 export function getProjectDataDir() {
-    return PROJECT_DATA_DIR;
+    if (cachedProjectDataDir === undefined) {
+        cachedProjectDataDir = findProjectDataDir();
+    }
+    return cachedProjectDataDir;
+}
+/** @internal Reset cached project data dir. For testing only. */
+export function resetProjectDataDirCache() {
+    cachedProjectDataDir = undefined;
+}
+/**
+ * Returns CWD-based `.paper-manager/` path without traversal.
+ * Used by `config init` to always create in the current directory.
+ */
+export function getProjectInitDir() {
+    return path.resolve(DIR_NAME);
 }
 export function getFilesDir(base) {
     return path.join(base, "files");
@@ -22,7 +55,7 @@ function getUserConfigPath() {
     return path.join(USER_DATA_DIR, "config.json");
 }
 function getProjectConfigPath() {
-    return path.join(PROJECT_DATA_DIR, "config.json");
+    return path.join(getProjectDataDir(), "config.json");
 }
 // ─── Config Schema Map ─────────────────────────────────────
 const configSchemas = {

package/dist/config/init.js

@@ -1,9 +1,9 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { initializeDatabase, openDatabase } from "../db/index.js";
-import { getFilesDir, getProjectDataDir, getUserDataDir, getVectorStoreDir, writeConfigFile, } from "./index.js";
+import { getFilesDir, getProjectInitDir, getUserDataDir, getVectorStoreDir, writeConfigFile, } from "./index.js";
 export function initScope(options) {
-    const baseDir = options?.user ? getUserDataDir() : getProjectDataDir();
+    const baseDir = options?.user ? getUserDataDir() : getProjectInitDir();
     const items = [];
     // 1. Base directory
     if (fs.existsSync(baseDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paper-manager",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "A paper management system.",
   "keywords": [],
   "homepage": "https://github.com/EurFelux/paper-manager",