sampler-cli 0.2.0__tar.gz → 0.2.1__tar.gz

sampler_cli-0.2.1/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: sampler-cli
+Version: 0.2.1
+Summary: Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)
+Author: Samuel Ignacio Carmona Rodriguez
+License: MIT
+Project-URL: Homepage, https://github.com/sicr0/sampler-cli
+Project-URL: Repository, https://github.com/sicr0/sampler-cli
+Project-URL: Issues, https://github.com/sicr0/sampler-cli/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.23.0
+Requires-Dist: gitignore-parser>=0.1.11
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=0.1.0; extra == "mcp"
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Dynamic: license-file
+
+# Sampler
+
+**Token-efficient CLI for indexing and searching code symbols across multiple projects.**
+
+Current version: 0.2.1
+
+Designed for humans and LLMs/agents: default outputs are compact, single-line, with short paths and no noisy table formatting.
+
+## Requirements
+
+- Python 3.11+
+- (Optional) Go, if you plan to use Go parser support in the future
+
+## Installation
+
+```bash
+pip install sampler-cli
+```
+
+For development (tests, linters, etc.):
+
+```bash
+pip install -e '.[dev]'
+```
+
+## Quick Start
+
+```bash
+sampler init
+sampler project add myproj /absolute/path/to/project --language python
+sampler project list
+sampler index myproj
+sampler search add --project myproj
+sampler overview /absolute/path/to/project/some/file.py
+sampler symbols myproj
+```
+
+## Examples with Output
+
+**List projects (compact):**
+```bash
+$ sampler project list
+myproj /home/user/projects/myproj
+demo   ~/work/demo
+```
+
+**Search (default compact, LLM-friendly):**
+```bash
+$ sampler search worker --project myproj
+myproj:src/tasks/celery_app.py:70 function on_worker_ready  def on_worker_ready(sender)
+```
+
+**List all symbols for a project:**
+```bash
+$ sampler symbols myproj --type function --limit 5
+myproj:src/utils.py:10 function helper  def helper(x)
+myproj:src/models.py:25 function validate  def validate(data)
+...
+```
+
+**Overview of a file (supports relative paths):**
+```bash
+$ sampler overview src/app.py
+12: function main  def main()
+25: class App  class App
+```
+
+If the file has no indexed symbols (or was never indexed):
+```bash
+$ sampler overview nonexistent.py
+No symbols found for file: nonexistent.py
+Tip: Make sure the project is registered with 'sampler project add' and indexed with 'sampler index <project>'.
+The path must match a file that was indexed (relative paths are resolved to absolute).
+```
+
+## Why "project add" is required
+
+- `sampler project add <name> <path>` registers the project in `~/.sampler/config.yaml`.
+- `index` looks up the project there to know the root path and language.
+- Without it, commands like `index`, `symbols`, and filtered searches will fail with a clear "not found" message and usage hint.
+- The actual symbol data lives in the SQLite DB (`~/.sampler/graph.db`), but registration is the control plane.
+
+You can have data in the DB without the config entry (e.g. after `project remove`), but you won't be able to re-index or easily manage it.
+
+## Relative Paths
+
+- `overview` now resolves relative paths against the current working directory (e.g. `sampler overview ./src/app.py` or `sampler overview ../other/file.py`).
+- Stored paths are absolute (resolved at index time), so the resolution makes overview work naturally.
+- Other file-based commands behave similarly where applicable.
+
+## Error Messages & Help
+
+We try to give actionable errors:
+
+- Unknown project → tells you the exact `project add` command to run and suggests `project list`.
+- File with no symbols → clear "No symbols found" + tips.
+- Typer automatically shows command usage and available options on invalid arguments.
+
+Run any command with `--help` for full details (e.g. `sampler search --help`, `sampler symbols --help`).
+
+## Current Features
+
+- Global config in `~/.sampler/config.yaml`
+- Project management (`add`, `list`, `remove`)
+- Incremental indexing with file hashing (Python AST-based parser)
+- Compact, token-efficient output by default (great for LLMs)
+- Search with type filters and limits
+- `search-all` across every registered project
+- `symbols <project>` to dump/list symbols for a project
+- `overview <file>` (relative paths supported)
+- Basic relationship extraction (CALLS, CONTAINS)
+
+## Stability Note
+
+- Python parser uses stdlib `ast` (we switched from tree-sitter-python after native crashes on macOS ARM during real indexing).
+- Go and TypeScript/JavaScript parsers are stubs for now (return no symbols).
+
+## Project Structure
+
+```
+src/sampler/
+├── cli/main.py          # Typer commands (search, overview, symbols, index, project ...)
+├── config.py            # YAML config manager
+├── db.py                # SQLite layer
+├── indexer/
+│   ├── builder.py
+│   ├── discover.py
+│   ├── store.py
+│   └── parsers/python.py
+└── query/engine.py
+```
+
+## Running Tests
+
+```bash
+pytest -q
+```
+
+## Roadmap Highlights (see TODO.md and PLAN.md)
+
+- Cross-file relation improvements
+- Better call graph queries (`callers`, `usages`, ...)
+- Real Go / TypeScript parsers
+- Semantic search + MCP server (for agents)
+- More context-generation helpers

sampler_cli-0.2.1/README.md

@@ -0,0 +1,145 @@
+# Sampler
+
+**Token-efficient CLI for indexing and searching code symbols across multiple projects.**
+
+Current version: 0.2.1
+
+Designed for humans and LLMs/agents: default outputs are compact, single-line, with short paths and no noisy table formatting.
+
+## Requirements
+
+- Python 3.11+
+- (Optional) Go, if you plan to use Go parser support in the future
+
+## Installation
+
+```bash
+pip install sampler-cli
+```
+
+For development (tests, linters, etc.):
+
+```bash
+pip install -e '.[dev]'
+```
+
+## Quick Start
+
+```bash
+sampler init
+sampler project add myproj /absolute/path/to/project --language python
+sampler project list
+sampler index myproj
+sampler search add --project myproj
+sampler overview /absolute/path/to/project/some/file.py
+sampler symbols myproj
+```
+
+## Examples with Output
+
+**List projects (compact):**
+```bash
+$ sampler project list
+myproj /home/user/projects/myproj
+demo   ~/work/demo
+```
+
+**Search (default compact, LLM-friendly):**
+```bash
+$ sampler search worker --project myproj
+myproj:src/tasks/celery_app.py:70 function on_worker_ready  def on_worker_ready(sender)
+```
+
+**List all symbols for a project:**
+```bash
+$ sampler symbols myproj --type function --limit 5
+myproj:src/utils.py:10 function helper  def helper(x)
+myproj:src/models.py:25 function validate  def validate(data)
+...
+```
+
+**Overview of a file (supports relative paths):**
+```bash
+$ sampler overview src/app.py
+12: function main  def main()
+25: class App  class App
+```
+
+If the file has no indexed symbols (or was never indexed):
+```bash
+$ sampler overview nonexistent.py
+No symbols found for file: nonexistent.py
+Tip: Make sure the project is registered with 'sampler project add' and indexed with 'sampler index <project>'.
+The path must match a file that was indexed (relative paths are resolved to absolute).
+```
+
+## Why "project add" is required
+
+- `sampler project add <name> <path>` registers the project in `~/.sampler/config.yaml`.
+- `index` looks up the project there to know the root path and language.
+- Without it, commands like `index`, `symbols`, and filtered searches will fail with a clear "not found" message and usage hint.
+- The actual symbol data lives in the SQLite DB (`~/.sampler/graph.db`), but registration is the control plane.
+
+You can have data in the DB without the config entry (e.g. after `project remove`), but you won't be able to re-index or easily manage it.
+
+## Relative Paths
+
+- `overview` now resolves relative paths against the current working directory (e.g. `sampler overview ./src/app.py` or `sampler overview ../other/file.py`).
+- Stored paths are absolute (resolved at index time), so the resolution makes overview work naturally.
+- Other file-based commands behave similarly where applicable.
+
+## Error Messages & Help
+
+We try to give actionable errors:
+
+- Unknown project → tells you the exact `project add` command to run and suggests `project list`.
+- File with no symbols → clear "No symbols found" + tips.
+- Typer automatically shows command usage and available options on invalid arguments.
+
+Run any command with `--help` for full details (e.g. `sampler search --help`, `sampler symbols --help`).
+
+## Current Features
+
+- Global config in `~/.sampler/config.yaml`
+- Project management (`add`, `list`, `remove`)
+- Incremental indexing with file hashing (Python AST-based parser)
+- Compact, token-efficient output by default (great for LLMs)
+- Search with type filters and limits
+- `search-all` across every registered project
+- `symbols <project>` to dump/list symbols for a project
+- `overview <file>` (relative paths supported)
+- Basic relationship extraction (CALLS, CONTAINS)
+
+## Stability Note
+
+- Python parser uses stdlib `ast` (we switched from tree-sitter-python after native crashes on macOS ARM during real indexing).
+- Go and TypeScript/JavaScript parsers are stubs for now (return no symbols).
+
+## Project Structure
+
+```
+src/sampler/
+├── cli/main.py          # Typer commands (search, overview, symbols, index, project ...)
+├── config.py            # YAML config manager
+├── db.py                # SQLite layer
+├── indexer/
+│   ├── builder.py
+│   ├── discover.py
+│   ├── store.py
+│   └── parsers/python.py
+└── query/engine.py
+```
+
+## Running Tests
+
+```bash
+pytest -q
+```
+
+## Roadmap Highlights (see TODO.md and PLAN.md)
+
+- Cross-file relation improvements
+- Better call graph queries (`callers`, `usages`, ...)
+- Real Go / TypeScript parsers
+- Semantic search + MCP server (for agents)
+- More context-generation helpers

{sampler_cli-0.2.0 → sampler_cli-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sampler-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)"
 readme = "README.md"
 license = { text = "MIT" }

{sampler_cli-0.2.0 → sampler_cli-0.2.1}/src/sampler/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{sampler_cli-0.2.0 → sampler_cli-0.2.1}/src/sampler/cli/main.py

@@ -9,7 +9,7 @@ from sampler.db import Database
 from sampler.indexer.builder import IndexBuilder
 from sampler.query.engine import QueryEngine
 
-app = typer.Typer(help="Sampler CLI")
+app = typer.Typer(help="Sampler CLI", no_args_is_help=True)
 project_app = typer.Typer(help="Project management commands")
 app.add_typer(project_app, name="project")
 console = Console()
@@ -93,7 +93,7 @@ def project_add(name: str, path: str, language: str = "python") -> None:
     try:
         project = config.add_project(name=name, path=path, language=language)
     except ValueError as exc:
-        raise typer.BadParameter(str(exc)) from exc
+        raise typer.BadParameter(f"{exc}\nTip: Use an absolute path that exists.") from exc
     console.print(f"Added project [bold]{project.name}[/bold]")
 
 
@@ -147,13 +147,57 @@ def search_all(
     search(query=query, project=None, type=type, limit=limit)
 
 
+@app.command("symbols")
+def symbols(
+    project: str,
+    type: str | None = typer.Option(None, "--type", "-t", help="filter e.g. function,class"),
+    limit: int = typer.Option(100, "--limit", "-l"),
+) -> None:
+    """List all symbols for a project (useful for getting a quick overview)."""
+    config = ConfigManager()
+    if config.get_project(project) is None:
+        raise typer.BadParameter(
+            f"Project '{project}' not found.\n"
+            f"Run: sampler project add {project} <absolute/path> --language python\n"
+            "Use 'sampler project list' to see registered projects."
+        )
+
+    engine = QueryEngine(db=_database())
+    types = [x.strip() for x in type.split(",")] if type else None
+    if types:
+        exp = set(types)
+        for t in list(types):
+            if t == "function":
+                exp.add("async function")
+            elif t == "method":
+                exp.add("async method")
+        types = list(exp)
+
+    rows = engine.list_symbols(project_name=project, types=types, limit=limit)
+    roots = _get_project_roots()
+
+    for r in rows:
+        shortf = _short_path(r["project_name"], r["file_path"], roots)
+        name = r["qualified_name"] or r["name"]
+        sig = r.get("signature") or ""
+        line = f"{r['project_name']}:{shortf}:{r['start_line'] or '-'} {r['type']} {name}"
+        if sig:
+            line += f"  {sig}"
+        console.print(line)
+
+
 @app.command("index")
 def index(project: str) -> None:
     """Index selected project."""
     config = ConfigManager()
     project_cfg = config.get_project(project)
     if project_cfg is None:
-        raise typer.BadParameter(f"Project '{project}' not found. Use 'sampler project list'.")
+        raise typer.BadParameter(
+            f"Project '{project}' not found.\n"
+            f"Run: sampler project add {project} <absolute/path> --language python\n"
+            "Then: sampler index {project}\n"
+            "Use 'sampler project list' to see registered projects."
+        )
 
     builder = IndexBuilder(db=_database())
     stats = builder.index_project(
@@ -170,9 +214,47 @@ def index(project: str) -> None:
 
 @app.command("overview")
 def overview(filepath: str) -> None:
-    """Show symbols for file."""
+    """Show symbols for a file.
+
+    Supports absolute and relative paths.
+    Relative paths are first resolved from cwd; if nothing matches we also try
+    resolving relative to each registered project's root (very convenient).
+    """
+    config = ConfigManager()
+    projects = config.list_projects()
+
+    candidates = []
+    try:
+        candidates.append(str(Path(filepath).resolve()))
+    except Exception:
+        candidates.append(filepath)
+
+    # Try resolving relative to each project root (helps when you're inside the project)
+    for p in projects:
+        try:
+            root = Path(p.path).resolve()
+            rel = root / filepath
+            candidates.append(str(rel.resolve()))
+        except Exception:
+            pass
+
+    # Dedup while preserving order
+    seen = set()
+    candidates = [c for c in candidates if not (c in seen or seen.add(c))]
+
     engine = QueryEngine(db=_database())
-    rows = engine.overview(filepath=filepath)
+    rows = []
+    matched_path = None
+    for cand in candidates:
+        rows = engine.overview(filepath=cand)
+        if rows:
+            matched_path = cand
+            break
+
+    if not rows:
+        console.print(f"No symbols found for file: {filepath}")
+        console.print("Tip: Make sure the project is registered with 'sampler project add' and indexed with 'sampler index <project>'.")
+        return
 
     for r in rows:
         name = r["qualified_name"] or r["name"]

{sampler_cli-0.2.0 → sampler_cli-0.2.1}/src/sampler/db.py

@@ -314,3 +314,33 @@ class Database:
                 """,
                 params,
             ).fetchall()
+
+    def list_symbols(self, project_name: str, types: list[str] | None = None, limit: int | None = None, offset: int = 0) -> list[sqlite3.Row]:
+        where = "WHERE p.name = ?"
+        params: list = [project_name]
+        if types:
+            ph = ",".join("?" * len(types))
+            where += f" AND s.type IN ({ph})"
+            params.extend(types)
+
+        sql = f"""
+                SELECT
+                    s.type,
+                    s.name,
+                    s.qualified_name,
+                    s.signature,
+                    s.start_line,
+                    f.path AS file_path,
+                    p.name AS project_name
+                FROM symbols s
+                JOIN files f ON s.file_id = f.id
+                JOIN projects p ON f.project_id = p.id
+                {where}
+                ORDER BY f.path, s.start_line
+                """
+        if limit is not None:
+            sql += " LIMIT ? OFFSET ?"
+            params.extend([limit, offset])
+
+        with self.connect() as conn:
+            return conn.execute(sql, params).fetchall()

{sampler_cli-0.2.0 → sampler_cli-0.2.1}/src/sampler/query/engine.py

@@ -14,3 +14,7 @@ class QueryEngine:
     def overview(self, filepath: str, project_name: str | None = None) -> list[dict]:
         rows = self.db.get_symbols_by_filepath(filepath=filepath, project_name=project_name)
         return [dict(row) for row in rows]
+
+    def list_symbols(self, project_name: str, types: list[str] | None = None, limit: int | None = None, offset: int = 0) -> list[dict]:
+        rows = self.db.list_symbols(project_name=project_name, types=types, limit=limit, offset=offset)
+        return [dict(row) for row in rows]

sampler_cli-0.2.1/src/sampler_cli.egg-info/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: sampler-cli
+Version: 0.2.1
+Summary: Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)
+Author: Samuel Ignacio Carmona Rodriguez
+License: MIT
+Project-URL: Homepage, https://github.com/sicr0/sampler-cli
+Project-URL: Repository, https://github.com/sicr0/sampler-cli
+Project-URL: Issues, https://github.com/sicr0/sampler-cli/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.23.0
+Requires-Dist: gitignore-parser>=0.1.11
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=0.1.0; extra == "mcp"
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Dynamic: license-file
+
+# Sampler
+
+**Token-efficient CLI for indexing and searching code symbols across multiple projects.**
+
+Current version: 0.2.1
+
+Designed for humans and LLMs/agents: default outputs are compact, single-line, with short paths and no noisy table formatting.
+
+## Requirements
+
+- Python 3.11+
+- (Optional) Go, if you plan to use Go parser support in the future
+
+## Installation
+
+```bash
+pip install sampler-cli
+```
+
+For development (tests, linters, etc.):
+
+```bash
+pip install -e '.[dev]'
+```
+
+## Quick Start
+
+```bash
+sampler init
+sampler project add myproj /absolute/path/to/project --language python
+sampler project list
+sampler index myproj
+sampler search add --project myproj
+sampler overview /absolute/path/to/project/some/file.py
+sampler symbols myproj
+```
+
+## Examples with Output
+
+**List projects (compact):**
+```bash
+$ sampler project list
+myproj /home/user/projects/myproj
+demo   ~/work/demo
+```
+
+**Search (default compact, LLM-friendly):**
+```bash
+$ sampler search worker --project myproj
+myproj:src/tasks/celery_app.py:70 function on_worker_ready  def on_worker_ready(sender)
+```
+
+**List all symbols for a project:**
+```bash
+$ sampler symbols myproj --type function --limit 5
+myproj:src/utils.py:10 function helper  def helper(x)
+myproj:src/models.py:25 function validate  def validate(data)
+...
+```
+
+**Overview of a file (supports relative paths):**
+```bash
+$ sampler overview src/app.py
+12: function main  def main()
+25: class App  class App
+```
+
+If the file has no indexed symbols (or was never indexed):
+```bash
+$ sampler overview nonexistent.py
+No symbols found for file: nonexistent.py
+Tip: Make sure the project is registered with 'sampler project add' and indexed with 'sampler index <project>'.
+The path must match a file that was indexed (relative paths are resolved to absolute).
+```
+
+## Why "project add" is required
+
+- `sampler project add <name> <path>` registers the project in `~/.sampler/config.yaml`.
+- `index` looks up the project there to know the root path and language.
+- Without it, commands like `index`, `symbols`, and filtered searches will fail with a clear "not found" message and usage hint.
+- The actual symbol data lives in the SQLite DB (`~/.sampler/graph.db`), but registration is the control plane.
+
+You can have data in the DB without the config entry (e.g. after `project remove`), but you won't be able to re-index or easily manage it.
+
+## Relative Paths
+
+- `overview` now resolves relative paths against the current working directory (e.g. `sampler overview ./src/app.py` or `sampler overview ../other/file.py`).
+- Stored paths are absolute (resolved at index time), so the resolution makes overview work naturally.
+- Other file-based commands behave similarly where applicable.
+
+## Error Messages & Help
+
+We try to give actionable errors:
+
+- Unknown project → tells you the exact `project add` command to run and suggests `project list`.
+- File with no symbols → clear "No symbols found" + tips.
+- Typer automatically shows command usage and available options on invalid arguments.
+
+Run any command with `--help` for full details (e.g. `sampler search --help`, `sampler symbols --help`).
+
+## Current Features
+
+- Global config in `~/.sampler/config.yaml`
+- Project management (`add`, `list`, `remove`)
+- Incremental indexing with file hashing (Python AST-based parser)
+- Compact, token-efficient output by default (great for LLMs)
+- Search with type filters and limits
+- `search-all` across every registered project
+- `symbols <project>` to dump/list symbols for a project
+- `overview <file>` (relative paths supported)
+- Basic relationship extraction (CALLS, CONTAINS)
+
+## Stability Note
+
+- Python parser uses stdlib `ast` (we switched from tree-sitter-python after native crashes on macOS ARM during real indexing).
+- Go and TypeScript/JavaScript parsers are stubs for now (return no symbols).
+
+## Project Structure
+
+```
+src/sampler/
+├── cli/main.py          # Typer commands (search, overview, symbols, index, project ...)
+├── config.py            # YAML config manager
+├── db.py                # SQLite layer
+├── indexer/
+│   ├── builder.py
+│   ├── discover.py
+│   ├── store.py
+│   └── parsers/python.py
+└── query/engine.py
+```
+
+## Running Tests
+
+```bash
+pytest -q
+```
+
+## Roadmap Highlights (see TODO.md and PLAN.md)
+
+- Cross-file relation improvements
+- Better call graph queries (`callers`, `usages`, ...)
+- Real Go / TypeScript parsers
+- Semantic search + MCP server (for agents)
+- More context-generation helpers

sampler_cli-0.2.0/PKG-INFO

@@ -1,130 +0,0 @@
-Metadata-Version: 2.4
-Name: sampler-cli
-Version: 0.2.0
-Summary: Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)
-Author: Samuel Ignacio Carmona Rodriguez
-License: MIT
-Project-URL: Homepage, https://github.com/sicr0/sampler-cli
-Project-URL: Repository, https://github.com/sicr0/sampler-cli
-Project-URL: Issues, https://github.com/sicr0/sampler-cli/issues
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.12.0
-Requires-Dist: rich>=13.7.0
-Requires-Dist: tree-sitter>=0.21.0
-Requires-Dist: tree-sitter-python>=0.23.0
-Requires-Dist: gitignore-parser>=0.1.11
-Requires-Dist: pydantic>=2.6.0
-Requires-Dist: pyyaml>=6.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: ruff>=0.5.0; extra == "dev"
-Requires-Dist: mypy>=1.7.0; extra == "dev"
-Provides-Extra: mcp
-Requires-Dist: fastmcp>=0.1.0; extra == "mcp"
-Provides-Extra: semantic
-Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
-Dynamic: license-file
-
-# Sampler
-
-CLI indexer para navegar símbolos y relaciones en codebases multiproyecto.
-
-Versión actual: 0.1.2
-
-## Requisitos
-
-- Python 3.11+
-- `uv` (recomendado)
-- Go (instalado para soporte parser Fase 1)
-
-## Instalación de Go (macOS)
-
-```bash
-brew install go
-go version
-```
-
-## Instalación
-
-```bash
-pip install sampler-cli
-```
-
-Para desarrollo (incluye tests, linters):
-
-```bash
-pip install -e '.[dev]'
-```
-
-## Uso rápido
-
-```bash
-pip install sampler-cli
-sampler init
-sampler project add myproj /absolute/path --language python
-sampler project list
-sampler index myproj
-sampler search add --project myproj
-sampler overview /absolute/path/file.py
-```
-
-**Demo / LLM use (token-efficient by design):**
-- Default outputs are compact single-line (no tables, short paths, no noise).
-- Ideal for pasting into agents/LLMs with minimal context size.
-- Example: `sampler search worker --project myproj` → `myproj:src/tasks.py:42 function process  def process()`
-
-## Estado actual
-
-Implementado:
-
-- Bootstrap inicial de Fase 0
-- Configuración global con archivo `~/.sampler/config.yaml`
-- CRUD de proyectos en config (`add`, `list`, `remove`)
-- Esquema SQLite core + queries de index/search en `src/sampler/db.py`
-- Discovery de archivos por lenguaje con soporte `.gitignore`
-- Parser Python estable basado en AST
-- Indexer real (hash incremental + persistencia)
-- Query engine real (`search`, `overview`)
-- CI básico con GitHub Actions (`pytest -q`)
-- Tests: smoke, config, db, cli, discovery, python_parser, index_query
-
-Nota de estabilidad:
-
-- Se desactivó uso runtime de tree-sitter en parser Python por crash nativo (`BUS/SEGV`) en indexación real.
-- Se mantiene estrategia AST para estabilidad en producción local.
-
-Pendiente inmediato:
-
-- Filtros y paginación en búsqueda
-- Comandos `callers`, `usages`, `related`
-- Parsers Go y TypeScript/JavaScript
-
-## Estructura clave
-
-```text
-src/sampler/cli/main.py          # comandos CLI
-src/sampler/config.py            # config global YAML
-src/sampler/db.py                # capa SQLite
-src/sampler/indexer/builder.py   # indexación de proyectos
-src/sampler/indexer/store.py     # persistencia de símbolos/relaciones
-src/sampler/indexer/parsers/python.py # parser python estable
-src/sampler/query/engine.py      # search/overview
-src/sampler/indexer/discover.py  # discovery y filtros
-tests/                           # pruebas base
-```
-
-## Ejecutar pruebas
-
-```bash
-pytest -q
-```

sampler_cli-0.2.0/README.md

@@ -1,93 +0,0 @@
-# Sampler
-
-CLI indexer para navegar símbolos y relaciones en codebases multiproyecto.
-
-Versión actual: 0.1.2
-
-## Requisitos
-
-- Python 3.11+
-- `uv` (recomendado)
-- Go (instalado para soporte parser Fase 1)
-
-## Instalación de Go (macOS)
-
-```bash
-brew install go
-go version
-```
-
-## Instalación
-
-```bash
-pip install sampler-cli
-```
-
-Para desarrollo (incluye tests, linters):
-
-```bash
-pip install -e '.[dev]'
-```
-
-## Uso rápido
-
-```bash
-pip install sampler-cli
-sampler init
-sampler project add myproj /absolute/path --language python
-sampler project list
-sampler index myproj
-sampler search add --project myproj
-sampler overview /absolute/path/file.py
-```
-
-**Demo / LLM use (token-efficient by design):**
-- Default outputs are compact single-line (no tables, short paths, no noise).
-- Ideal for pasting into agents/LLMs with minimal context size.
-- Example: `sampler search worker --project myproj` → `myproj:src/tasks.py:42 function process  def process()`
-
-## Estado actual
-
-Implementado:
-
-- Bootstrap inicial de Fase 0
-- Configuración global con archivo `~/.sampler/config.yaml`
-- CRUD de proyectos en config (`add`, `list`, `remove`)
-- Esquema SQLite core + queries de index/search en `src/sampler/db.py`
-- Discovery de archivos por lenguaje con soporte `.gitignore`
-- Parser Python estable basado en AST
-- Indexer real (hash incremental + persistencia)
-- Query engine real (`search`, `overview`)
-- CI básico con GitHub Actions (`pytest -q`)
-- Tests: smoke, config, db, cli, discovery, python_parser, index_query
-
-Nota de estabilidad:
-
-- Se desactivó uso runtime de tree-sitter en parser Python por crash nativo (`BUS/SEGV`) en indexación real.
-- Se mantiene estrategia AST para estabilidad en producción local.
-
-Pendiente inmediato:
-
-- Filtros y paginación en búsqueda
-- Comandos `callers`, `usages`, `related`
-- Parsers Go y TypeScript/JavaScript
-
-## Estructura clave
-
-```text
-src/sampler/cli/main.py          # comandos CLI
-src/sampler/config.py            # config global YAML
-src/sampler/db.py                # capa SQLite
-src/sampler/indexer/builder.py   # indexación de proyectos
-src/sampler/indexer/store.py     # persistencia de símbolos/relaciones
-src/sampler/indexer/parsers/python.py # parser python estable
-src/sampler/query/engine.py      # search/overview
-src/sampler/indexer/discover.py  # discovery y filtros
-tests/                           # pruebas base
-```
-
-## Ejecutar pruebas
-
-```bash
-pytest -q
-```

sampler_cli-0.2.0/src/sampler_cli.egg-info/PKG-INFO

@@ -1,130 +0,0 @@
-Metadata-Version: 2.4
-Name: sampler-cli
-Version: 0.2.0
-Summary: Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)
-Author: Samuel Ignacio Carmona Rodriguez
-License: MIT
-Project-URL: Homepage, https://github.com/sicr0/sampler-cli
-Project-URL: Repository, https://github.com/sicr0/sampler-cli
-Project-URL: Issues, https://github.com/sicr0/sampler-cli/issues
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.12.0
-Requires-Dist: rich>=13.7.0
-Requires-Dist: tree-sitter>=0.21.0
-Requires-Dist: tree-sitter-python>=0.23.0
-Requires-Dist: gitignore-parser>=0.1.11
-Requires-Dist: pydantic>=2.6.0
-Requires-Dist: pyyaml>=6.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: ruff>=0.5.0; extra == "dev"
-Requires-Dist: mypy>=1.7.0; extra == "dev"
-Provides-Extra: mcp
-Requires-Dist: fastmcp>=0.1.0; extra == "mcp"
-Provides-Extra: semantic
-Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
-Dynamic: license-file
-
-# Sampler
-
-CLI indexer para navegar símbolos y relaciones en codebases multiproyecto.
-
-Versión actual: 0.1.2
-
-## Requisitos
-
-- Python 3.11+
-- `uv` (recomendado)
-- Go (instalado para soporte parser Fase 1)
-
-## Instalación de Go (macOS)
-
-```bash
-brew install go
-go version
-```
-
-## Instalación
-
-```bash
-pip install sampler-cli
-```
-
-Para desarrollo (incluye tests, linters):
-
-```bash
-pip install -e '.[dev]'
-```
-
-## Uso rápido
-
-```bash
-pip install sampler-cli
-sampler init
-sampler project add myproj /absolute/path --language python
-sampler project list
-sampler index myproj
-sampler search add --project myproj
-sampler overview /absolute/path/file.py
-```
-
-**Demo / LLM use (token-efficient by design):**
-- Default outputs are compact single-line (no tables, short paths, no noise).
-- Ideal for pasting into agents/LLMs with minimal context size.
-- Example: `sampler search worker --project myproj` → `myproj:src/tasks.py:42 function process  def process()`
-
-## Estado actual
-
-Implementado:
-
-- Bootstrap inicial de Fase 0
-- Configuración global con archivo `~/.sampler/config.yaml`
-- CRUD de proyectos en config (`add`, `list`, `remove`)
-- Esquema SQLite core + queries de index/search en `src/sampler/db.py`
-- Discovery de archivos por lenguaje con soporte `.gitignore`
-- Parser Python estable basado en AST
-- Indexer real (hash incremental + persistencia)
-- Query engine real (`search`, `overview`)
-- CI básico con GitHub Actions (`pytest -q`)
-- Tests: smoke, config, db, cli, discovery, python_parser, index_query
-
-Nota de estabilidad:
-
-- Se desactivó uso runtime de tree-sitter en parser Python por crash nativo (`BUS/SEGV`) en indexación real.
-- Se mantiene estrategia AST para estabilidad en producción local.
-
-Pendiente inmediato:
-
-- Filtros y paginación en búsqueda
-- Comandos `callers`, `usages`, `related`
-- Parsers Go y TypeScript/JavaScript
-
-## Estructura clave
-
-```text
-src/sampler/cli/main.py          # comandos CLI
-src/sampler/config.py            # config global YAML
-src/sampler/db.py                # capa SQLite
-src/sampler/indexer/builder.py   # indexación de proyectos
-src/sampler/indexer/store.py     # persistencia de símbolos/relaciones
-src/sampler/indexer/parsers/python.py # parser python estable
-src/sampler/query/engine.py      # search/overview
-src/sampler/indexer/discover.py  # discovery y filtros
-tests/                           # pruebas base
-```
-
-## Ejecutar pruebas
-
-```bash
-pytest -q
-```