morphy-cli 0.5.0__py3-none-any.whl

morphy_cli-0.5.0.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: morphy-cli
+Version: 0.5.0
+Summary: MORPHY — governed natural-language database terminal
+Author-email: Ananya Kalia <ananyakalia2704@gmail.com>
+Project-URL: Homepage, https://morphy-web.vercel.app
+Project-URL: Repository, https://github.com/ananyakalia14/morphy
+Project-URL: Issues, https://github.com/ananyakalia14/morphy/issues
+Keywords: sql,cli,database,query,governed-sql,terminal,ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: prompt-toolkit<4,>=3.0
+Requires-Dist: keyring>=24.0.0
+
+# MORPHY CLI — Antigravity handoff
+
+Antigravity owns the terminal interface, commands and client experience in this folder. The shared engine lives in backend/. Read ../docs/API.md and ../AGENTS.md first.
+
+## Existing implementation
+
+The Python package exposes morphy and sq console commands. Install from the repository root with python -m pip install -e ./cli.
+
+morphy starts the sample REPL. Existing commands are /help, /schema, /examples, /ask <question>, /sql <SELECT> and /exit or /quit. The sample /ask uses curated example titles.
+
+morphy --database <UUID> selects a real organization database and reads MORPHY_ACCESS_TOKEN from the environment. --url selects the engine. --sql runs one query and exits. Live /ask previews SQL and requests confirmation before execution.
+
+The current CLI uses httpx and a simple input loop. Access tokens remain in the process environment. It has no persisted login session, token refresh, organization chooser, connection wizard or command completion yet.
+
+## Build on this foundation
+
+- [x] Add prompt-toolkit for slash completion, history, multiline SQL and interruption handling.
+- [x] Add login/logout/status using the same Supabase Auth project as the website.
+- [x] Store persisted refresh tokens in the OS credential store and support session expiry/refresh.
+- [x] Add organization and database selection, keeping current context visible.
+- [x] Add /connect and CSV import flows using the engine's authenticated endpoints.
+- [x] Add profile, invitation and member-management commands through the shared Supabase RPCs.
+- [x] Add readable tables, JSON output, CSV export, null handling and bounded output.
+- [x] Show generation stages, correction attempts and cache status without invented percentages.
+- [x] Add command cancellation, network-timeout messages and graceful Ctrl+C.
+- [x] Add noninteractive flags and stable exit codes for scripts.
+- [x] Add command tests and integration tests against a disposable development control plane.
+- [x] Document Windows, macOS and Linux installation. Validate both console aliases.
+
+## Features and Commands
+
+### Session & Identity
+- `/login <email>`: Authenticate via Supabase GoTrue with secure password prompt.
+- `/logout`: Clear active session, OS keyring credentials, and stored query results.
+- `/status`: Inspect active authentication, engine URL, active organization, and target database.
+- `/profile`: View your profile; `/profile claim <handle> <name>` or `/profile edit <name>` to edit display name.
+- `/dashboard`: Comprehensive terminal dashboard view; `/dashboard [render <id>]` to render a saved dashboard.
+- `/dashboards`: List saved dashboards in the active database.
+- `/dashboard-create <title> [shared]`: Create a saved dashboard definition.
+- `/dashboard-add <dash_id> <query_id>`: Add a saved query panel to a dashboard.
+- `/permissions`: Inspect effective permissions and row filtering rules on active database.
+- `/perm-revoke <role|user>`: Revoke permissions on active database.
+
+### Organizations & Databases
+- `/orgs`: List member organizations.
+- `/use-org <id|name>`: Switch active organization context.
+- `/dbs`: List databases registered in active organization.
+- `/use-db <id|name|sample>`: Switch target database context (or return to sample workspace).
+- `/connect <uri>`: Save and verify target PostgreSQL connection (admin).
+- `/import <path>`: Ingest UTF-8 CSV data up to 1 MB into SQLite target database (admin).
+
+### Team & Collaboration
+- `/members`: List members and assigned roles in the active organization.
+- `/invites`: View pending invitations.
+- `/invite <username>`: Search users and dispatch organization invitations.
+- `/accept <id>`: Accept an invitation to join an organization.
+- `/withdraw <id>`: Withdraw/cancel an existing invitation.
+
+### Queries & Saved Queries
+- `/schema`: View allowed tables and column types.
+- `/examples`: List curated natural-language query examples.
+- `/ask <question>`: Natural language query generation with pre-execution review.
+- `/sql <SELECT ...>`: Execute read-only SQL queries.
+- `/save-query <name> [sql]`: Save current or specified query.
+- `/queries`: List all saved queries.
+- `/run-query <name>`: Execute a saved query.
+- `/delete-query <name>`: Delete a saved query.
+- `/export <path.csv>`: Export last query results as RFC-4180 CSV.
+- `/json`: Print last query results as formatted JSON.
+
+### Scripting & Automation
+Run one-shot queries without entering interactive mode:
+```bash
+morphy --sql "SELECT * FROM orders LIMIT 5"
+morphy --sql "SELECT * FROM orders LIMIT 5" --json
+morphy --sql "SELECT * FROM orders LIMIT 5" --csv
+```
+Stable exit codes:
+- `0`: Success
+- `1`: Query, validation, or policy error
+- `2`: Network or engine connectivity error
+- `130`: Interrupted / cancelled via SIGINT (Ctrl+C)
+
+## Installation & Setup
+
+### Requirements
+- Python >= 3.11
+
+### Installation
+From the repository root:
+```bash
+python -m pip install -e ./cli
+```
+Both `morphy` and `sq` console commands are installed.
+
+On Windows, macOS and Linux:
+```bash
+morphy --help
+sq --help
+```
+
+## Required boundaries
+
+Keep SQL generation, target connections, encryption keys, policy enforcement and execution in the backend. The CLI sends the current user's bearer token to the configured engine. Verify HTTPS for remote authenticated endpoints.
+
+Use the same API request/response shapes as the web app. Never ask an LLM to decide whether a query is authorized. Never execute model output directly against a target database.
+
+Do not commit tokens, passwords or shell history. Source authentication settings from documented configuration. Support existing --url, --database and --sql callers as the interface evolves.
+
+## First PR
+
+Create cli/interactive-shell from main. Add the terminal framework, /help and completion around the existing HTTP client first. Include --help and interruption checks. Submit a PR with usage examples and testing evidence.
+

morphy_cli-0.5.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+morphy_cli/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+morphy_cli/__main__.py,sha256=jqsMIo3TrEswz9SOe77_J2pJciEzzbwhMh13CXfjmks,34
+morphy_cli/auth.py,sha256=zTkx_ht78w0-YYIl2rSUJb2vd4BkZWhLKUq7iUEYHv4,11687
+morphy_cli/client.py,sha256=RmySFjovErm8wVaiJG_yTesvcTRDEMJlwV-5FJtMlOI,7355
+morphy_cli/completer.py,sha256=8VkY1d3BVcSH0QmreJmACRIzNSk3EMRLhJw_JH1BzXg,3288
+morphy_cli/control.py,sha256=lhQMRcDNMB8FwfySQPDbMYbfK1g0xhFtoBDdObE8bSk,10789
+morphy_cli/formatting.py,sha256=N7S0XpVXEreroKIzmqGSVK_Znw-ch4M3HRrLMIzmD5U,5811
+morphy_cli/main.py,sha256=VsS-yhheWHgUSFw1dZioO7xJ-YLfzrk-cEJyUQPrVaA,3509
+morphy_cli/queries.py,sha256=qLVQ_RKX4ft7cVlELix572nRQHXAT4HUPZY3QWmcc3k,2530
+morphy_cli/shell.py,sha256=7maSs9HrM_sVa4IUf6P2vUtW5AG4vfEZWwioL6E2XEU,35113
+morphy_cli-0.5.0.dist-info/METADATA,sha256=50SXFwQv6iJsbhPbPlFmHvajtG1rBRtbj66kWatX020,6988
+morphy_cli-0.5.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+morphy_cli-0.5.0.dist-info/entry_points.txt,sha256=ec0605jB9g11fvy-hJS4YLCS6XdPkr5NNENxawrc4dE,74
+morphy_cli-0.5.0.dist-info/top_level.txt,sha256=uV2uYl6cbhB-b4zr0Mn3-G_7ibP0_qaGTYFadgVtu3o,11
+morphy_cli-0.5.0.dist-info/RECORD,,

morphy_cli-0.5.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

morphy_cli-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+morphy = morphy_cli.main:main
+sq = morphy_cli.main:main

morphy_cli-0.5.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+morphy_cli