@alpacali/papyrus-cli 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Papyrus CLI - Configuration Management
+ */
+import type { CLIConfig } from "./types.js";
+/**
+ * Load CLI configuration
+ */
+export declare function loadConfig(): CLIConfig;
+/**
+ * Save CLI configuration
+ */
+export declare function saveConfig(config: CLIConfig): void;
+/**
+ * Get configuration value
+ */
+export declare function getConfig<K extends keyof CLIConfig>(key: K): CLIConfig[K];
+/**
+ * Set configuration value
+ */
+export declare function setConfig<K extends keyof CLIConfig>(key: K, value: CLIConfig[K]): void;
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetConfig(): void;
+/**
+ * Get data directory path
+ */
+export declare function getDataDir(): string;
+/**
+ * Get API URL
+ */
+export declare function getApiUrl(): string;
+/**
+ * Display current configuration
+ */
+export declare function displayConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmB5C;;GAEG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAetC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAGzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAItF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/config.js

@@ -0,0 +1,94 @@
+/**
+ * Papyrus CLI - Configuration Management
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const CONFIG_DIR = join(homedir(), ".papyrus");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const DEFAULT_CONFIG = {
+    apiUrl: "http://127.0.0.1:8000",
+    dataDir: join(homedir(), "Documents", "Papyrus"),
+};
+/**
+ * Ensure config directory exists
+ */
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Load CLI configuration
+ */
+export function loadConfig() {
+    ensureConfigDir();
+    if (!existsSync(CONFIG_FILE)) {
+        saveConfig(DEFAULT_CONFIG);
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const data = readFileSync(CONFIG_FILE, "utf-8");
+        const config = JSON.parse(data);
+        return { ...DEFAULT_CONFIG, ...config };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/**
+ * Save CLI configuration
+ */
+export function saveConfig(config) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+ * Get configuration value
+ */
+export function getConfig(key) {
+    const config = loadConfig();
+    return config[key];
+}
+/**
+ * Set configuration value
+ */
+export function setConfig(key, value) {
+    const config = loadConfig();
+    config[key] = value;
+    saveConfig(config);
+}
+/**
+ * Reset configuration to defaults
+ */
+export function resetConfig() {
+    saveConfig(DEFAULT_CONFIG);
+}
+/**
+ * Get data directory path
+ */
+export function getDataDir() {
+    const config = loadConfig();
+    if (!existsSync(config.dataDir)) {
+        mkdirSync(config.dataDir, { recursive: true });
+    }
+    return config.dataDir;
+}
+/**
+ * Get API URL
+ */
+export function getApiUrl() {
+    const config = loadConfig();
+    return config.apiUrl;
+}
+/**
+ * Display current configuration
+ */
+export function displayConfig() {
+    const config = loadConfig();
+    console.log("Current Configuration:");
+    console.log(`  API URL: ${config.apiUrl}`);
+    console.log(`  Data Directory: ${config.dataDir}`);
+    console.log(`  Config File: ${CONFIG_FILE}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Papyrus CLI - Library Exports
+ *
+ * This file exports the API client and types for programmatic use.
+ */
+export { healthCheck, isApiAvailable, listCards, getCard, createCard, updateCard, deleteCard, importCards, getReviewQueue, getReviewStats, submitReview, searchCards, exportData, importData, createBackup, } from "./api.js";
+export { loadConfig, saveConfig, getConfig, setConfig, resetConfig, getDataDir, getApiUrl, displayConfig, } from "./config.js";
+export type { Card, CreateCardInput, UpdateCardInput, CardsListResponse, CardResponse, DeleteResponse, ImportResponse, ReviewQueueItem, ReviewStats, ReviewStatsResponse, ReviewSubmission, ReviewSubmitResponse, HealthResponse, CLIConfig, BackupInfo, SearchResult, SearchResponse, Note, APIError, } from "./types.js";
+export { formatDate, formatRelativeTime, truncate, readFileSafe, isReadableFile, parseTags, formatFileSize, isValidCardId, escapeRegex, sleep, prompt, confirm, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,IAAI,EACJ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,IAAI,EACJ,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,KAAK,EACL,MAAM,EACN,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Papyrus CLI - Library Exports
+ *
+ * This file exports the API client and types for programmatic use.
+ */
+// API Client
+export { healthCheck, isApiAvailable, listCards, getCard, createCard, updateCard, deleteCard, importCards, getReviewQueue, getReviewStats, submitReview, searchCards, exportData, importData, createBackup, } from "./api.js";
+// Configuration
+export { loadConfig, saveConfig, getConfig, setConfig, resetConfig, getDataDir, getApiUrl, displayConfig, } from "./config.js";
+// Utilities
+export { formatDate, formatRelativeTime, truncate, readFileSafe, isReadableFile, parseTags, formatFileSize, isValidCardId, escapeRegex, sleep, prompt, confirm, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,gBAAgB;AAChB,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,aAAa,CAAC;AAyBrB,YAAY;AACZ,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,KAAK,EACL,MAAM,EACN,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Papyrus CLI - Type Definitions
+ */
+/** Card data structure */
+export interface Card {
+    id: string;
+    q: string;
+    a: string;
+    next_review: number;
+    interval: number;
+    ef: number;
+    repetitions: number;
+    tags: string[];
+}
+/** Card creation input */
+export interface CreateCardInput {
+    q: string;
+    a: string;
+    tags?: string[];
+}
+/** Card update input */
+export interface UpdateCardInput {
+    q?: string;
+    a?: string;
+    tags?: string[];
+}
+/** API response for card list */
+export interface CardsListResponse {
+    success: boolean;
+    cards: Card[];
+    count: number;
+}
+/** API response for single card */
+export interface CardResponse {
+    success: boolean;
+    card: Card;
+}
+/** API response for delete operation */
+export interface DeleteResponse {
+    success: boolean;
+}
+/** API response for import operation */
+export interface ImportResponse {
+    success: boolean;
+    count: number;
+}
+/** Review queue item */
+export interface ReviewQueueItem {
+    card: Card;
+    index: number;
+}
+/** Review stats */
+export interface ReviewStats {
+    total_cards: number;
+    due_today: number;
+    new_cards: number;
+    review_cards: number;
+}
+/** API response for review stats */
+export interface ReviewStatsResponse {
+    success: boolean;
+    stats: ReviewStats;
+}
+/** Review submission */
+export interface ReviewSubmission {
+    quality: number;
+}
+/** API response for review submit */
+export interface ReviewSubmitResponse {
+    success: boolean;
+    message: string;
+}
+/** Health check response */
+export interface HealthResponse {
+    status: string;
+}
+/** CLI Configuration */
+export interface CLIConfig {
+    apiUrl: string;
+    dataDir: string;
+    defaultEditor?: string;
+}
+/** Backup info */
+export interface BackupInfo {
+    path: string;
+    size: number;
+    created: Date;
+}
+/** Search result */
+export interface SearchResult {
+    card: Card;
+    score: number;
+}
+/** Search response */
+export interface SearchResponse {
+    success: boolean;
+    results: SearchResult[];
+    count: number;
+}
+/** Note data */
+export interface Note {
+    id: string;
+    title: string;
+    content: string;
+    created_at: string;
+    updated_at: string;
+    tags: string[];
+}
+/** API Error response */
+export interface APIError {
+    detail?: string;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Papyrus CLI - Type Definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Papyrus CLI - Utility Functions
+ */
+/**
+ * Format date for display
+ */
+export declare function formatDate(timestamp: number): string;
+/**
+ * Format relative time (e.g., "2 hours ago")
+ */
+export declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Truncate text to a maximum length
+ */
+export declare function truncate(text: string, maxLength: number): string;
+/**
+ * Read file content safely
+ */
+export declare function readFileSafe(path: string): string | null;
+/**
+ * Check if file exists and is readable
+ */
+export declare function isReadableFile(path: string): boolean;
+/**
+ * Parse tags from comma-separated string
+ */
+export declare function parseTags(tagsStr: string | undefined): string[];
+/**
+ * Format file size
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validate card ID format
+ */
+export declare function isValidCardId(id: string): boolean;
+/**
+ * Escape special regex characters
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Sleep for a given duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Prompt for user input (basic implementation)
+ */
+export declare function prompt(question: string): Promise<string>;
+/**
+ * Confirm action with user
+ */
+export declare function confirm(question: string): Promise<boolean>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB5D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAM/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9D;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhE"}

package/dist/utils.js

@@ -0,0 +1,141 @@
+/**
+ * Papyrus CLI - Utility Functions
+ */
+import { existsSync, readFileSync, statSync } from "fs";
+import { resolve } from "path";
+/**
+ * Format date for display
+ */
+export function formatDate(timestamp) {
+    return new Date(timestamp * 1000).toLocaleString();
+}
+/**
+ * Format relative time (e.g., "2 hours ago")
+ */
+export function formatRelativeTime(timestamp) {
+    const now = Date.now() / 1000;
+    const diff = timestamp - now;
+    if (diff < 0) {
+        const absDiff = Math.abs(diff);
+        if (absDiff < 60)
+            return "just now";
+        if (absDiff < 3600)
+            return `${Math.floor(absDiff / 60)} minutes ago`;
+        if (absDiff < 86400)
+            return `${Math.floor(absDiff / 3600)} hours ago`;
+        if (absDiff < 604800)
+            return `${Math.floor(absDiff / 86400)} days ago`;
+        return formatDate(timestamp);
+    }
+    if (diff < 60)
+        return "in a few seconds";
+    if (diff < 3600)
+        return `in ${Math.floor(diff / 60)} minutes`;
+    if (diff < 86400)
+        return `in ${Math.floor(diff / 3600)} hours`;
+    if (diff < 604800)
+        return `in ${Math.floor(diff / 86400)} days`;
+    return formatDate(timestamp);
+}
+/**
+ * Truncate text to a maximum length
+ */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3) + "...";
+}
+/**
+ * Read file content safely
+ */
+export function readFileSafe(path) {
+    try {
+        const resolved = resolve(path);
+        if (!existsSync(resolved))
+            return null;
+        return readFileSync(resolved, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if file exists and is readable
+ */
+export function isReadableFile(path) {
+    try {
+        const resolved = resolve(path);
+        if (!existsSync(resolved))
+            return false;
+        const stats = statSync(resolved);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse tags from comma-separated string
+ */
+export function parseTags(tagsStr) {
+    if (!tagsStr)
+        return [];
+    return tagsStr
+        .split(",")
+        .map(t => t.trim())
+        .filter(t => t.length > 0);
+}
+/**
+ * Format file size
+ */
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+/**
+ * Validate card ID format
+ */
+export function isValidCardId(id) {
+    return /^[a-zA-Z0-9_-]+$/.test(id);
+}
+/**
+ * Escape special regex characters
+ */
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Sleep for a given duration
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Prompt for user input (basic implementation)
+ */
+export async function prompt(question) {
+    const { createInterface } = await import("readline");
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Confirm action with user
+ */
+export async function confirm(question) {
+    const answer = await prompt(`${question} (y/N): `);
+    return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@alpacali/papyrus-cli",
+  "version": "1.0.0",
+  "description": "Papyrus CLI - Command line interface for Papyrus SRS learning system",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "papyrus": "dist/cli.js",
+    "papyrus-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "papyrus",
+    "srs",
+    "spaced-repetition",
+    "flashcards",
+    "learning",
+    "cli",
+    "study"
+  ],
+  "author": "Papyrus Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Papyrus/Papyrus-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Papyrus/Papyrus-cli/issues"
+  },
+  "homepage": "https://github.com/Papyrus/Papyrus-cli#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "fs-extra": "^11.3.0",
+    "inquirer": "^12.5.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.14.0",
+    "typescript": "^5.8.3"
+  }
+}