raillog-cli 0.1.0__tar.gz

raillog_cli-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: raillog-cli
+Version: 0.1.0
+Summary: CLI for Raillog V2.0 — railway construction logistics planning
+Author-email: Boschetti Engineering <info@boschetti-engineering.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/boschetti-engineering/raillog
+Project-URL: Bug Tracker, https://github.com/boschetti-engineering/raillog/issues
+Keywords: railway,logistics,planning,cli,construction
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: supabase>=2.7
+Requires-Dist: rich>=13.7
+Requires-Dist: python-dateutil>=2.9
+
+# raillog-cli
+
+Command-line interface for **Raillog V2.0** — a spatiotemporal logistics planning system for railway construction sites.
+
+Manages waggons, Bauzüge (construction train groups), stations, tracks, and Fahrten (trips) within a time-bounded project. The core question the system answers: *"Where is waggon X at time T, and on which track?"*
+
+## Install
+
+```bash
+pip install raillog-cli
+```
+
+Requires Python 3.11+. Connects to a Supabase backend — you need a Raillog project URL and credentials.
+
+## Quick start
+
+```bash
+raillog auth login
+raillog project list
+raillog project select <n>
+raillog context
+```
+
+## Agent integration (Claude Code, Cursor, Codex, Gemini, opencode)
+
+After install, run once in your project directory:
+
+```bash
+raillog install-skill
+```
+
+This writes:
+- `~/.claude/skills/raillog.md` — Claude Code skill (auto-loaded)
+- `~/.claude/CLAUDE.md` — trigger phrase added
+- `./AGENTS.md` — skill file for Cursor, Codex, Gemini CLI, opencode
+
+For Cursor specifically, copy `AGENTS.md` to `.cursor/rules/raillog.mdc`.
+
+## Commands
+
+```
+raillog auth         login, status, refresh, logout
+raillog project      list, select, show, create
+raillog station      list, show, create, update, delete, impact
+raillog track        list, show, create, update, delete, impact, occupation
+raillog waggon       list, show, create, update, delete, impact, types,
+                     position, history, set-zustand, zustand
+raillog bauzug       list, show, create, update, compose, delete, impact,
+                     check-departure, history
+raillog travel       list, show, create, update, delete, impact, validate
+raillog restriction  list, show, create, delete
+raillog query        suggest-track, track-occupation, track-capacity,
+                     waggon-availability, conflicts
+raillog install-skill
+```
+
+All write commands support `--dry-run` and `--yes`.
+All list/query commands support `--json` for agent consumption.
+
+## License
+
+MIT

raillog_cli-0.1.0/README.md

@@ -0,0 +1,62 @@
+# raillog-cli
+
+Command-line interface for **Raillog V2.0** — a spatiotemporal logistics planning system for railway construction sites.
+
+Manages waggons, Bauzüge (construction train groups), stations, tracks, and Fahrten (trips) within a time-bounded project. The core question the system answers: *"Where is waggon X at time T, and on which track?"*
+
+## Install
+
+```bash
+pip install raillog-cli
+```
+
+Requires Python 3.11+. Connects to a Supabase backend — you need a Raillog project URL and credentials.
+
+## Quick start
+
+```bash
+raillog auth login
+raillog project list
+raillog project select <n>
+raillog context
+```
+
+## Agent integration (Claude Code, Cursor, Codex, Gemini, opencode)
+
+After install, run once in your project directory:
+
+```bash
+raillog install-skill
+```
+
+This writes:
+- `~/.claude/skills/raillog.md` — Claude Code skill (auto-loaded)
+- `~/.claude/CLAUDE.md` — trigger phrase added
+- `./AGENTS.md` — skill file for Cursor, Codex, Gemini CLI, opencode
+
+For Cursor specifically, copy `AGENTS.md` to `.cursor/rules/raillog.mdc`.
+
+## Commands
+
+```
+raillog auth         login, status, refresh, logout
+raillog project      list, select, show, create
+raillog station      list, show, create, update, delete, impact
+raillog track        list, show, create, update, delete, impact, occupation
+raillog waggon       list, show, create, update, delete, impact, types,
+                     position, history, set-zustand, zustand
+raillog bauzug       list, show, create, update, compose, delete, impact,
+                     check-departure, history
+raillog travel       list, show, create, update, delete, impact, validate
+raillog restriction  list, show, create, delete
+raillog query        suggest-track, track-occupation, track-capacity,
+                     waggon-availability, conflicts
+raillog install-skill
+```
+
+All write commands support `--dry-run` and `--yes`.
+All list/query commands support `--json` for agent consumption.
+
+## License
+
+MIT

raillog_cli-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "raillog-cli"
+version = "0.1.0"
+description = "CLI for Raillog V2.0 — railway construction logistics planning"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Boschetti Engineering", email = "info@boschetti-engineering.com" }
+]
+keywords = ["railway", "logistics", "planning", "cli", "construction"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.11"
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.27",
+    "supabase>=2.7",
+    "rich>=13.7",
+    "python-dateutil>=2.9",
+]
+
+[project.urls]
+Homepage = "https://github.com/boschetti-engineering/raillog"
+"Bug Tracker" = "https://github.com/boschetti-engineering/raillog/issues"
+
+[project.scripts]
+raillog = "raillog.cli:cli"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["raillog*"]
+
+[tool.setuptools.package-data]
+raillog = ["data/AGENTS.md"]

raillog_cli-0.1.0/raillog/__init__.py

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

raillog_cli-0.1.0/raillog/cli.py

@@ -0,0 +1,54 @@
+"""
+raillog — main CLI entry point.
+
+Registers all command groups. This is the `raillog` command installed by pip.
+"""
+
+from __future__ import annotations
+
+import click
+from rich.console import Console
+
+from raillog import __version__
+from raillog.cmd_auth         import auth_group
+from raillog.cmd_projects     import project_group
+from raillog.cmd_context      import context_cmd
+from raillog.cmd_stations     import station_group
+from raillog.cmd_tracks       import track_group
+from raillog.cmd_bauzuege     import bauzug_group
+from raillog.cmd_waggons      import waggon_group
+from raillog.cmd_travels      import travel_group
+from raillog.cmd_restrictions import restriction_group
+from raillog.cmd_queries      import query_group
+from raillog.cmd_install      import install_skill
+
+console = Console()
+
+
+@click.group()
+@click.version_option(__version__, prog_name="raillog")
+def cli() -> None:
+    """
+    Raillog V2.0 — railway construction logistics CLI.
+
+    \b
+    Quick start:
+      raillog auth login
+      raillog project list
+      raillog project select <n>
+      raillog context
+    """
+
+
+# ── Register all command groups ───────────────────────────────────────────────
+cli.add_command(auth_group)
+cli.add_command(project_group)
+cli.add_command(context_cmd)
+cli.add_command(station_group)
+cli.add_command(track_group)
+cli.add_command(bauzug_group)
+cli.add_command(waggon_group)
+cli.add_command(travel_group)
+cli.add_command(restriction_group)
+cli.add_command(query_group)
+cli.add_command(install_skill)

raillog_cli-0.1.0/raillog/client.py

@@ -0,0 +1,36 @@
+"""
+Supabase client factory.
+
+Builds a supabase-py client and injects the stored JWT so every
+request is authenticated as the logged-in user (respecting RLS).
+"""
+
+from __future__ import annotations
+
+from supabase import Client, create_client
+
+SUPABASE_URL = "https://ouilcwrgxsirpvkzsdkq.supabase.co"
+SUPABASE_ANON_KEY = (
+    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
+    ".eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Im91aWxjd3JneHNpcnB2a3pzZGtxIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjU4MzMzNzYsImV4cCI6MjA4MTQwOTM3Nn0"
+    ".WRR4puUXDvS46w7rsc1sHT6cz8_A1pL-1yzK47v7aqI"
+)
+
+
+def get_client(access_token: str | None = None) -> Client:
+    """
+    Return a Supabase client.
+    If access_token is provided, set it on the client so RLS applies.
+    """
+    sb = create_client(SUPABASE_URL, SUPABASE_ANON_KEY)
+    if access_token:
+        # Inject user JWT — required for RLS to work correctly
+        sb.postgrest.auth(access_token)
+    return sb
+
+
+def authed_client() -> Client:
+    """Shortcut: load session and return authenticated client."""
+    from raillog import session as sess
+    s = sess.require_auth()
+    return get_client(s["access_token"])

raillog_cli-0.1.0/raillog/cmd_auth.py

@@ -0,0 +1,92 @@
+"""raillog auth {login,status,logout}"""
+
+from __future__ import annotations
+
+import time
+
+import click
+from rich.console import Console
+
+from raillog import session as sess
+from raillog.client import get_client, SUPABASE_URL
+
+console = Console()
+
+
+@click.group("auth")
+def auth_group() -> None:
+    """Authenticate with Raillog (Supabase)."""
+
+
+@auth_group.command("login")
+def auth_login() -> None:
+    """Log in with email and password."""
+    console.print("[bold]Raillog Login[/bold]")
+    email = click.prompt("Email")
+    password = click.prompt("Password", hide_input=True)
+
+    sb = get_client()
+    try:
+        result = sb.auth.sign_in_with_password({"email": email, "password": password})
+    except Exception as e:
+        raise SystemExit(f"Login failed: {e}") from e
+
+    if not result.session:
+        raise SystemExit("Login failed: no session returned.")
+
+    s = result.session
+    user = result.user
+
+    sess.save({
+        "access_token":  s.access_token,
+        "refresh_token": s.refresh_token,
+        "expires_at":    s.expires_at or int(time.time()) + 3600,
+        "user_id":       str(user.id) if user else "",
+        "user_email":    user.email or email,
+        "project_id":    None,
+        "project_name":  None,
+        "access_level":  None,
+    })
+
+    console.print(f"[green]Logged in as[/green] [bold]{user.email}[/bold]")
+    console.print("Run [cyan]raillog project list[/cyan] to select a project.")
+
+
+@auth_group.command("status")
+def auth_status() -> None:
+    """Show current authentication status."""
+    s = sess.load()
+    if not s:
+        console.print("[red]Not authenticated.[/red]  Run: raillog auth login")
+        return
+
+    if not sess.is_valid(s):
+        console.print("[yellow]Session expired.[/yellow]  Run: raillog auth login")
+        return
+
+    remaining = s.get("expires_at", 0) - int(time.time())
+    hours = remaining // 3600
+    console.print(f"[green]Authenticated[/green] as [bold]{s.get('user_email')}[/bold]")
+    console.print(f"Session expires in ~{hours}h")
+    if s.get("project_id"):
+        console.print(f"Active project: [bold]{s.get('project_name')}[/bold]  ({s.get('project_id')})")
+    else:
+        console.print("[dim]No project selected.[/dim]")
+
+
+@auth_group.command("refresh")
+def auth_refresh() -> None:
+    """Silently renew the session using the stored refresh token."""
+    if sess._try_refresh():
+        s = sess.load()
+        remaining = ((s or {}).get("expires_at", 0) - int(time.time())) // 3600
+        console.print(f"[green]Session refreshed.[/green] Expires in ~{remaining}h")
+    else:
+        raise SystemExit("Refresh failed — run:  raillog auth login")
+
+
+@auth_group.command("logout")
+def auth_logout() -> None:
+    """Clear the local session."""
+    sess.clear()
+    console.print("[green]Logged out.[/green]")