lestash 1.48.3__tar.gz

lestash-1.48.3/.gitignore

@@ -0,0 +1,20 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# Tauri app
+app/node_modules/
+app/src-tauri/target/
+app/src-tauri/gen/schemas/

lestash-1.48.3/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: lestash
+Version: 1.48.3
+Summary: Personal knowledge base CLI - aggregate content from multiple sources
+Requires-Python: >=3.12
+Requires-Dist: docling>=2.84.0
+Requires-Dist: google-api-python-client>=2.0.0
+Requires-Dist: google-auth-httplib2>=0.2.0
+Requires-Dist: google-auth-oauthlib>=1.0.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: sqlite-vec>=0.1.6
+Requires-Dist: toml>=0.10.2
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# lestash
+
+[![PyPI version](https://badge.fury.io/py/lestash.svg)](https://pypi.org/project/lestash/)
+[![GitHub](https://img.shields.io/github/license/thompsonson/lestash)](https://github.com/thompsonson/lestash)
+
+Core CLI and plugin system for Le Stash - a personal knowledge base that aggregates content from multiple sources into a unified, searchable database.
+
+> **Note**: For project overview, features, and quick start guide, see the [GitHub repository](https://github.com/thompsonson/lestash).
+
+## Installation
+
+```bash
+uv add lestash
+```
+
+Or install the full workspace from the repository root:
+
+```bash
+uv sync --all-packages
+```
+
+## CLI Commands
+
+### Items
+
+```bash
+# List all items (with date/time and resolved author names)
+lestash items list
+
+# Filter by source
+lestash items list --source linkedin
+
+# Search items
+lestash items search "query"
+
+# Show item details (includes reaction/comment target URLs)
+lestash items show <id>
+
+# Export items to JSON
+lestash items export --output backup.json
+
+# Create a Micro.blog draft from an item
+lestash items draft <id> --output ~/blog/content/drafts/
+```
+
+### Profiles
+
+Map person URNs (e.g., LinkedIn) to human-readable names and profile URLs:
+
+```bash
+# Add a profile mapping
+lestash profiles add "urn:li:person:abc123" --name "John Doe" --url "https://linkedin.com/in/johndoe"
+
+# List all profiles
+lestash profiles list
+
+# Show a specific profile
+lestash profiles show "urn:li:person:abc123"
+
+# Remove a profile
+lestash profiles remove "urn:li:person:abc123"
+```
+
+When profiles are configured, `items list` and `items search` display names instead of URNs, and `items show` includes the profile URL.
+
+### Sources
+
+```bash
+# List configured sources
+lestash sources list
+
+# Sync all sources
+lestash sources sync
+
+# View sync history
+lestash sources history
+```
+
+### Configuration
+
+```bash
+# Show current config
+lestash config show
+
+# Initialize config file
+lestash config init
+
+# Set a config value
+lestash config set logging.level DEBUG
+```
+
+## Plugin Architecture
+
+Le Stash uses entry points for plugin discovery. Plugins implement the `SourcePlugin` base class:
+
+```python
+from lestash.plugins.base import SourcePlugin
+from lestash.models.item import ItemCreate
+
+class MySource(SourcePlugin):
+    name = "my-source"
+    description = "My custom data source"
+
+    def get_commands(self) -> typer.Typer:
+        """Return Typer app with source-specific commands."""
+        app = typer.Typer()
+        # Add commands...
+        return app
+
+    def sync(self, config: dict) -> Iterator[ItemCreate]:
+        """Fetch items from the source."""
+        yield ItemCreate(
+            source_type="my-source",
+            source_id="unique-id",
+            content="Item content",
+        )
+```
+
+Register the plugin in `pyproject.toml`:
+
+```toml
+[project.entry-points."lestash.sources"]
+my-source = "my_package:MySource"
+```
+
+## Data Model
+
+### Item
+
+The core unit of content:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | int | Auto-generated primary key |
+| `source_type` | str | Plugin identifier (e.g., "arxiv", "linkedin") |
+| `source_id` | str | Unique ID within the source |
+| `url` | str | Optional URL to original content |
+| `title` | str | Optional title |
+| `content` | str | Main text content |
+| `author` | str | Optional author |
+| `created_at` | datetime | When the content was created |
+| `is_own_content` | bool | Whether user authored this |
+| `metadata` | dict | Source-specific data (JSON) |
+| `parent_id` | int | Optional FK to parent item (for grouping children) |
+
+### Database
+
+SQLite database with:
+
+- **items** - Main content table with unique constraint on (source_type, source_id) and optional `parent_id` for hierarchical grouping
+- **items_fts** - Full-text search virtual table (FTS5)
+- **vec_items** - Vector embeddings for semantic search (sqlite-vec)
+- **item_history** - Audit trail of content changes
+- **person_profiles** - URN to name/URL mapping for display
+- **post_cache** - Cached metadata for posts referenced by reactions/comments
+- **tags** / **item_tags** - Tagging system
+- **collections** / **collection_items** - Cross-source item grouping
+- **sources** - Plugin configuration storage
+- **sync_log** - Sync operation history
+
+## Configuration
+
+Default location: `~/.config/lestash/config.toml`
+
+```toml
+[general]
+database_path = "~/.config/lestash/lestash.db"
+
+[logging]
+level = "INFO"
+file_path = "~/.config/lestash/logs/lestash.log"
+```
+
+## License
+
+[MIT](../../LICENSE)

lestash-1.48.3/README.md

@@ -0,0 +1,176 @@
+# lestash
+
+[![PyPI version](https://badge.fury.io/py/lestash.svg)](https://pypi.org/project/lestash/)
+[![GitHub](https://img.shields.io/github/license/thompsonson/lestash)](https://github.com/thompsonson/lestash)
+
+Core CLI and plugin system for Le Stash - a personal knowledge base that aggregates content from multiple sources into a unified, searchable database.
+
+> **Note**: For project overview, features, and quick start guide, see the [GitHub repository](https://github.com/thompsonson/lestash).
+
+## Installation
+
+```bash
+uv add lestash
+```
+
+Or install the full workspace from the repository root:
+
+```bash
+uv sync --all-packages
+```
+
+## CLI Commands
+
+### Items
+
+```bash
+# List all items (with date/time and resolved author names)
+lestash items list
+
+# Filter by source
+lestash items list --source linkedin
+
+# Search items
+lestash items search "query"
+
+# Show item details (includes reaction/comment target URLs)
+lestash items show <id>
+
+# Export items to JSON
+lestash items export --output backup.json
+
+# Create a Micro.blog draft from an item
+lestash items draft <id> --output ~/blog/content/drafts/
+```
+
+### Profiles
+
+Map person URNs (e.g., LinkedIn) to human-readable names and profile URLs:
+
+```bash
+# Add a profile mapping
+lestash profiles add "urn:li:person:abc123" --name "John Doe" --url "https://linkedin.com/in/johndoe"
+
+# List all profiles
+lestash profiles list
+
+# Show a specific profile
+lestash profiles show "urn:li:person:abc123"
+
+# Remove a profile
+lestash profiles remove "urn:li:person:abc123"
+```
+
+When profiles are configured, `items list` and `items search` display names instead of URNs, and `items show` includes the profile URL.
+
+### Sources
+
+```bash
+# List configured sources
+lestash sources list
+
+# Sync all sources
+lestash sources sync
+
+# View sync history
+lestash sources history
+```
+
+### Configuration
+
+```bash
+# Show current config
+lestash config show
+
+# Initialize config file
+lestash config init
+
+# Set a config value
+lestash config set logging.level DEBUG
+```
+
+## Plugin Architecture
+
+Le Stash uses entry points for plugin discovery. Plugins implement the `SourcePlugin` base class:
+
+```python
+from lestash.plugins.base import SourcePlugin
+from lestash.models.item import ItemCreate
+
+class MySource(SourcePlugin):
+    name = "my-source"
+    description = "My custom data source"
+
+    def get_commands(self) -> typer.Typer:
+        """Return Typer app with source-specific commands."""
+        app = typer.Typer()
+        # Add commands...
+        return app
+
+    def sync(self, config: dict) -> Iterator[ItemCreate]:
+        """Fetch items from the source."""
+        yield ItemCreate(
+            source_type="my-source",
+            source_id="unique-id",
+            content="Item content",
+        )
+```
+
+Register the plugin in `pyproject.toml`:
+
+```toml
+[project.entry-points."lestash.sources"]
+my-source = "my_package:MySource"
+```
+
+## Data Model
+
+### Item
+
+The core unit of content:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | int | Auto-generated primary key |
+| `source_type` | str | Plugin identifier (e.g., "arxiv", "linkedin") |
+| `source_id` | str | Unique ID within the source |
+| `url` | str | Optional URL to original content |
+| `title` | str | Optional title |
+| `content` | str | Main text content |
+| `author` | str | Optional author |
+| `created_at` | datetime | When the content was created |
+| `is_own_content` | bool | Whether user authored this |
+| `metadata` | dict | Source-specific data (JSON) |
+| `parent_id` | int | Optional FK to parent item (for grouping children) |
+
+### Database
+
+SQLite database with:
+
+- **items** - Main content table with unique constraint on (source_type, source_id) and optional `parent_id` for hierarchical grouping
+- **items_fts** - Full-text search virtual table (FTS5)
+- **vec_items** - Vector embeddings for semantic search (sqlite-vec)
+- **item_history** - Audit trail of content changes
+- **person_profiles** - URN to name/URL mapping for display
+- **post_cache** - Cached metadata for posts referenced by reactions/comments
+- **tags** / **item_tags** - Tagging system
+- **collections** / **collection_items** - Cross-source item grouping
+- **sources** - Plugin configuration storage
+- **sync_log** - Sync operation history
+
+## Configuration
+
+Default location: `~/.config/lestash/config.toml`
+
+```toml
+[general]
+database_path = "~/.config/lestash/lestash.db"
+
+[logging]
+level = "INFO"
+file_path = "~/.config/lestash/logs/lestash.log"
+```
+
+## License
+
+[MIT](../../LICENSE)

lestash-1.48.3/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "lestash"
+version = "1.48.3"
+description = "Personal knowledge base CLI - aggregate content from multiple sources"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "typer>=0.12.0",
+    "pydantic>=2.5.0",
+    "pydantic-settings>=2.1.0",
+    "rich>=13.7.0",
+    "toml>=0.10.2",
+    "google-api-python-client>=2.0.0",
+    "google-auth-oauthlib>=1.0.0",
+    "google-auth-httplib2>=0.2.0",
+    "sqlite-vec>=0.1.6",
+    "sentence-transformers>=3.0.0",
+    "docling>=2.84.0",
+]
+
+[project.scripts]
+lestash = "lestash.cli.main:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lestash"]

lestash-1.48.3/src/lestash/__init__.py

@@ -0,0 +1,3 @@
+"""Le Stash - Personal knowledge base CLI."""
+
+__version__ = "0.1.0"

lestash-1.48.3/src/lestash/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m lestash."""
+
+from lestash.cli.main import app
+
+if __name__ == "__main__":
+    app()

lestash-1.48.3/src/lestash/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI module for Le Stash."""

lestash-1.48.3/src/lestash/cli/config.py

@@ -0,0 +1,85 @@
+"""Config commands for Le Stash CLI."""
+
+from typing import Annotated
+
+import typer
+from rich.console import Console
+
+from lestash.core.config import Config, get_config_path, init_config
+
+app = typer.Typer(help="Manage configuration.")
+console = Console()
+
+
+@app.command("show")
+def show_config() -> None:
+    """Show current configuration."""
+    config_path = get_config_path()
+
+    if not config_path.exists():
+        console.print(f"[dim]No config file at {config_path}[/dim]")
+        console.print("[dim]Run 'lestash config init' to create one.[/dim]")
+        return
+
+    config = Config.load()
+    console.print(f"[bold]Config file:[/bold] {config_path}")
+    console.print()
+
+    data = config.model_dump()
+    for section, values in data.items():
+        console.print(f"[bold][{section}][/bold]")
+        if isinstance(values, dict):
+            for key, value in values.items():
+                console.print(f"  {key} = {value}")
+        else:
+            console.print(f"  {values}")
+        console.print()
+
+
+@app.command("init")
+def init_config_cmd(
+    force: Annotated[bool, typer.Option("--force", "-f", help="Overwrite existing config")] = False,
+) -> None:
+    """Initialize configuration file with defaults."""
+    config_path = get_config_path()
+
+    if config_path.exists() and not force:
+        console.print(f"[yellow]Config already exists at {config_path}[/yellow]")
+        console.print("[dim]Use --force to overwrite.[/dim]")
+        raise typer.Exit(1)
+
+    init_config()
+    console.print(f"[green]Created config at {config_path}[/green]")
+
+
+@app.command("set")
+def set_config(
+    key: Annotated[str, typer.Argument(help="Config key (e.g., general.database_path)")],
+    value: Annotated[str, typer.Argument(help="Value to set")],
+) -> None:
+    """Set a configuration value."""
+    config = Config.load()
+
+    parts = key.split(".")
+    if len(parts) != 2:
+        console.print("[red]Key must be in format 'section.key'[/red]")
+        raise typer.Exit(1)
+
+    section, setting = parts
+
+    # Get current config as dict
+    data = config.model_dump()
+
+    if section not in data:
+        data[section] = {}
+
+    data[section][setting] = value
+
+    # Save updated config
+    try:
+        updated_config = Config(**data)
+        updated_config.save()
+        console.print(f"[green]Set {key} = {value}[/green]")
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise typer.Exit(1) from None