smartbiblia 0.1.0__tar.gz

smartbiblia-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+wheels/
+*.egg-info
+**/*.lock
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints
+
+# VS Code settings
+.vscode/
+
+# Pytest cache
+.pytest_cache/
+
+# Virtual environments
+.venv
+
+# Environment files (all locations)
+.env
+**/.env
+.env.*
+**/.env.*
+
+# Private
+outputs-examples/
+**/CHANGELOG.json
+**/*.zip
+**/DEPLOYMENT.md

smartbiblia-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: smartbiblia
+Version: 0.1.0
+Summary: CLI to install smartbiblia skills and MCP servers into your agent workspace
+Project-URL: Repository, https://github.com/smartbiblia-solutions/agentic-stack
+License: MIT
+Keywords: bibliography,claude,codex,hermes,library,mcp,openclaw,research,skills
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# smartbiblia
+
+CLI d'installation des skills [smartbiblia](https://github.com/smartbiblia-solutions/agentic-stack)
+dans un workspace agent.
+
+> Pour les MCP servers (OpenAlex, Sudoc SRU, Primo), voir les READMEs dans `mcp/` —
+> ils s'installent via `git clone` ou `uv run <url>` directement, sans passer par cette CLI.
+
+## Installation
+
+Aucune installation permanente requise — utilise [`uvx`](https://docs.astral.sh/uv/) pour lancer directement depuis PyPI :
+
+```bash
+uvx smartbiblia list
+```
+
+Ou installe globalement :
+
+```bash
+uv tool install smartbiblia
+# puis :
+smartbiblia list
+```
+
+## Commandes
+
+### Lister les skills disponibles
+
+```bash
+smartbiblia list
+smartbiblia list --tag french
+smartbiblia list --tag open-access
+```
+
+### Consulter le détail d'une skill
+
+```bash
+smartbiblia info idref
+smartbiblia info synthesize
+```
+
+### Installer une skill
+
+```bash
+# Installe dans ./skills/idref/
+smartbiblia add idref
+
+# Dossier personnalisé
+smartbiblia add sudoc --dest ./mon-projet/skills
+```
+
+### Mettre à jour une skill installée
+
+```bash
+smartbiblia update idref
+smartbiblia update synthesize
+```
+
+## Développement local
+
+```bash
+cd cli/
+uv sync
+uv run smartbiblia list
+```
+
+### Publier sur PyPI
+
+```bash
+uv build
+uv publish
+```
+
+> **Note :** mettre à jour `GITHUB_REPO` dans `installer.py` si le repo est renommé.

smartbiblia-0.1.0/README.md

@@ -0,0 +1,74 @@
+# smartbiblia
+
+CLI d'installation des skills [smartbiblia](https://github.com/smartbiblia-solutions/agentic-stack)
+dans un workspace agent.
+
+> Pour les MCP servers (OpenAlex, Sudoc SRU, Primo), voir les READMEs dans `mcp/` —
+> ils s'installent via `git clone` ou `uv run <url>` directement, sans passer par cette CLI.
+
+## Installation
+
+Aucune installation permanente requise — utilise [`uvx`](https://docs.astral.sh/uv/) pour lancer directement depuis PyPI :
+
+```bash
+uvx smartbiblia list
+```
+
+Ou installe globalement :
+
+```bash
+uv tool install smartbiblia
+# puis :
+smartbiblia list
+```
+
+## Commandes
+
+### Lister les skills disponibles
+
+```bash
+smartbiblia list
+smartbiblia list --tag french
+smartbiblia list --tag open-access
+```
+
+### Consulter le détail d'une skill
+
+```bash
+smartbiblia info idref
+smartbiblia info synthesize
+```
+
+### Installer une skill
+
+```bash
+# Installe dans ./skills/idref/
+smartbiblia add idref
+
+# Dossier personnalisé
+smartbiblia add sudoc --dest ./mon-projet/skills
+```
+
+### Mettre à jour une skill installée
+
+```bash
+smartbiblia update idref
+smartbiblia update synthesize
+```
+
+## Développement local
+
+```bash
+cd cli/
+uv sync
+uv run smartbiblia list
+```
+
+### Publier sur PyPI
+
+```bash
+uv build
+uv publish
+```
+
+> **Note :** mettre à jour `GITHUB_REPO` dans `installer.py` si le repo est renommé.

smartbiblia-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "smartbiblia"
+version = "0.1.0"
+description = "CLI to install smartbiblia skills and MCP servers into your agent workspace"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+keywords = ["claude", "codex", "openclaw", "hermes", "skills", "mcp", "bibliography", "library", "research"]
+dependencies = [
+    "typer>=0.12",
+    "httpx>=0.27",
+    "rich>=13",
+]
+
+[project.scripts]
+smartbiblia = "smartbiblia.cli:app"
+
+[project.urls]
+Repository = "https://github.com/smartbiblia-solutions/agentic-stack"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/smartbiblia"]

smartbiblia-0.1.0/src/smartbiblia/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

smartbiblia-0.1.0/src/smartbiblia/catalog.toml

@@ -0,0 +1,51 @@
+# Catalogue des skills disponibles.
+# Ce fichier est lu directement depuis GitHub par la CLI.
+# Mettre à jour ce fichier lors de l'ajout d'une nouvelle skill.
+
+[skills.resolve-idref]
+description = "Alignement automatique de noms de personnes vers des PPNs IdRef avec score de confiance"
+path = "skills/resolve-authorities-idref"
+maturity = "experimental"
+tags = ["authority", "french", "abes", "idref", "alignment"]
+
+[skills.sudoc]
+description = "Recherche dans le catalogue collectif SUDOC (livres, thèses, périodiques, manuscrits)"
+path = "skills/search-records-sudoc"
+maturity = "stable"
+tags = ["catalog", "french", "unimarc", "abes", "sudoc"]
+
+[skills.hal]
+description = "Recherche dans HAL, dépôt ouvert français (articles, thèses, rapports)"
+path = "skills/search-records-hal"
+maturity = "stable"
+tags = ["repository", "french", "open-access", "hal"]
+
+[skills.openalex]
+description = "Recherche dans OpenAlex, la plus grande base bibliographique mondiale en accès ouvert"
+path = "skills/search-works-openalex"
+maturity = "stable"
+tags = ["global", "open-access", "openalex", "doi"]
+
+[skills.generate-queries]
+description = "Génération de stratégies de recherche documentaire à partir d'une question de recherche (8-15 requêtes bilingues)"
+path = "skills/generate-search-queries"
+maturity = "stable"
+tags = ["search-strategy", "bilingual", "queries"]
+
+[skills.synthesize]
+description = "Synthèse de littérature académique (screening PRISMA, résumé, appréciation qualité, synthèse thématique/chronologique)"
+path = "skills/synthesize-literature"
+maturity = "stable"
+tags = ["synthesis", "review", "prisma", "literature"]
+
+[skills.convert-unimarc]
+description = "Conversion de notices UNIMARC entre formats XML, JSON et ISO 2709 binaire"
+path = "skills/convert-records-unimarc"
+maturity = "stable"
+tags = ["unimarc", "marc", "conversion", "format"]
+
+[skills.dmp]
+description = "Rédaction de Plans de Gestion de Données (PGD/DMP) selon les principes FAIR"
+path = "skills/write-data-management-plan"
+maturity = "experimental"
+tags = ["dmp", "fair", "open-science", "research"]

smartbiblia-0.1.0/src/smartbiblia/cli.py

@@ -0,0 +1,142 @@
+"""
+smartbiblia — CLI d'installation de skills pour agents.
+
+Usage:
+    smartbiblia list [--tag <tag>]
+    smartbiblia add <name> [--dest <path>] [--force]
+    smartbiblia info <name>
+    smartbiblia update <name> [--dest <path>]
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated, Optional
+
+import tomllib
+import typer
+from rich import print
+from rich.table import Table
+from rich.console import Console
+
+from .installer import fetch_catalog_raw, fetch_path
+
+app = typer.Typer(
+    name="smartbiblia",
+    help="Installe les skills smartbiblia dans ton workspace agent.",
+    no_args_is_help=True,
+)
+console = Console()
+
+
+def _load_catalog() -> dict:
+    try:
+        raw = fetch_catalog_raw()
+        return tomllib.loads(raw)
+    except Exception as exc:
+        print(f"[red]Impossible de charger le catalogue : {exc}[/red]")
+        raise typer.Exit(1)
+
+
+def _resolve(catalog: dict, name: str) -> dict:
+    meta = catalog.get("skills", {}).get(name)
+    if not meta:
+        print(f"[red]Skill '{name}' introuvable dans le catalogue.[/red]")
+        print(f"[dim]Utilisez [bold]smartbiblia list[/bold] pour voir les skills disponibles.[/dim]")
+        raise typer.Exit(1)
+    return meta
+
+
+# ---------------------------------------------------------------------------
+# list
+# ---------------------------------------------------------------------------
+
+@app.command("list")
+def list_cmd(
+    tag: Annotated[Optional[str], typer.Option("--tag", "-t", help="Filtrer par tag")] = None,
+):
+    """Liste les skills disponibles."""
+    catalog = _load_catalog()
+
+    table = Table(title="smartbiblia — skills disponibles", show_lines=False, highlight=True)
+    table.add_column("Nom", style="cyan bold", no_wrap=True)
+    table.add_column("Maturité")
+    table.add_column("Description")
+
+    for name, meta in catalog.get("skills", {}).items():
+        if tag and tag not in meta.get("tags", []):
+            continue
+        maturity = meta.get("maturity", "")
+        color = {"stable": "green", "beta": "yellow", "experimental": "red"}.get(maturity, "white")
+        table.add_row(
+            name,
+            f"[{color}]{maturity}[/{color}]",
+            meta.get("description", ""),
+        )
+
+    console.print(table)
+
+
+# ---------------------------------------------------------------------------
+# info
+# ---------------------------------------------------------------------------
+
+@app.command()
+def info(
+    name: Annotated[str, typer.Argument(help="Nom de la skill")],
+):
+    """Affiche les détails d'une skill."""
+    catalog = _load_catalog()
+    meta = _resolve(catalog, name)
+
+    print(f"\n[bold cyan]{name}[/bold cyan]")
+    print(f"[bold]Description :[/bold] {meta.get('description', '')}")
+    print(f"[bold]Maturité    :[/bold] {meta.get('maturity', '')}")
+    print(f"[bold]Tags        :[/bold] {', '.join(meta.get('tags', []))}")
+    print(f"[bold]Chemin repo :[/bold] {meta.get('path', '')}")
+    print()
+
+
+# ---------------------------------------------------------------------------
+# add
+# ---------------------------------------------------------------------------
+
+@app.command()
+def add(
+    name: Annotated[str, typer.Argument(help="Nom de la skill (ex: idref, sudoc, synthesize)")],
+    dest: Annotated[Optional[Path], typer.Option("--dest", "-d", help="Dossier de destination (défaut: ./skills/)")] = None,
+    force: Annotated[bool, typer.Option("--force", "-f", help="Écraser sans confirmation")] = False,
+):
+    """Installe une skill dans le workspace courant."""
+    catalog = _load_catalog()
+    meta = _resolve(catalog, name)
+
+    target: Path = (dest or Path("skills")) / name
+
+    if target.exists() and not force:
+        overwrite = typer.confirm(f"{target} existe déjà. Écraser ?", default=False)
+        if not overwrite:
+            raise typer.Exit(0)
+
+    with console.status(f"Téléchargement de la skill [cyan]{name}[/cyan]…"):
+        try:
+            fetch_path(meta["path"], target)
+        except Exception as exc:
+            print(f"[red]Erreur lors du téléchargement : {exc}[/red]")
+            raise typer.Exit(1)
+
+    print(f"[green]✓ Skill [bold]{name}[/bold] installée dans [bold]{target}[/bold][/green]")
+
+
+# ---------------------------------------------------------------------------
+# update
+# ---------------------------------------------------------------------------
+
+@app.command()
+def update(
+    name: Annotated[str, typer.Argument(help="Nom de la skill à mettre à jour")],
+    dest: Annotated[Optional[Path], typer.Option("--dest", "-d")] = None,
+):
+    """Met à jour une skill déjà installée (réinstalle depuis GitHub)."""
+    add(name=name, dest=dest, force=True)
+    print(f"[dim]Mise à jour terminée.[/dim]")

smartbiblia-0.1.0/src/smartbiblia/installer.py

@@ -0,0 +1,76 @@
+"""
+Télécharge un sous-dossier du repo GitHub et l'installe localement.
+Utilise l'API tarball de GitHub — pas besoin de git ni de clone complet.
+"""
+
+from __future__ import annotations
+
+import io
+import os
+import tarfile
+from pathlib import Path
+
+import httpx
+
+GITHUB_ORG = "smartbiblia-solutions"
+GITHUB_REPO = "agentic-stack"   # à mettre à jour si le repo est renommé
+BRANCH = "main"
+
+_TARBALL_URL = (
+    f"https://api.github.com/repos/{GITHUB_ORG}/{GITHUB_REPO}/tarball/{BRANCH}"
+)
+_CATALOG_URL = (
+    f"https://raw.githubusercontent.com/{GITHUB_ORG}/{GITHUB_REPO}"
+    f"/{BRANCH}/cli/src/smartbiblia/catalog.toml"
+)
+
+
+def _auth_headers() -> dict[str, str]:
+    token = os.environ.get("SMARTBIBLIA_GITHUB_TOKEN")
+    if token:
+        return {"Authorization": f"Bearer {token}"}
+    return {}
+
+
+def fetch_catalog_raw() -> str:
+    """Retourne le contenu brut du catalog.toml depuis GitHub."""
+    resp = httpx.get(_CATALOG_URL, headers=_auth_headers(), timeout=10, follow_redirects=True)
+    resp.raise_for_status()
+    return resp.text
+
+
+def fetch_path(remote_path: str, dest: Path) -> None:
+    """
+    Télécharge le tarball du repo et extrait uniquement le sous-dossier
+    `remote_path` vers `dest`.
+
+    Le tarball GitHub préfixe tous les chemins par "<org>-<repo>-<sha>/",
+    ce préfixe est retiré à l'extraction.
+    """
+    resp = httpx.get(
+        _TARBALL_URL,
+        headers=_auth_headers(),
+        timeout=60,
+        follow_redirects=True,
+    )
+    resp.raise_for_status()
+
+    with tarfile.open(fileobj=io.BytesIO(resp.content), mode="r:gz") as tar:
+        root_prefix = tar.getnames()[0].split("/")[0] + "/"
+        target_prefix = root_prefix + remote_path.strip("/") + "/"
+
+        members = [m for m in tar.getmembers() if m.name.startswith(target_prefix)]
+
+        if not members:
+            raise FileNotFoundError(
+                f"Chemin '{remote_path}' introuvable dans le tarball GitHub. "
+                "Vérifiez que le nom correspond bien à un dossier du repo."
+            )
+
+        dest.mkdir(parents=True, exist_ok=True)
+
+        for member in members:
+            member.name = member.name[len(target_prefix):]
+            if not member.name:
+                continue
+            tar.extract(member, path=dest, filter="data")