methodproof 0.7.3__tar.gz → 0.7.5__tar.gz

{methodproof-0.7.3 → methodproof-0.7.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: methodproof
-Version: 0.7.3
+Version: 0.7.5
 Summary: See how you code. Capture and visualize your engineering process.
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -153,18 +153,24 @@ flowchart TB
 | Command | What it does |
 |---------|-------------|
 | `init` | Interactive consent selector, install hooks, create data directory |
-| `start [--dir .] [--tags t1,t2] [--public] [--live]` | Start recording |
+| `start [--dir .] [--tags t1,t2] [--public] [--live] [--journal] [--e2e]` | Start recording |
 | `stop` | Stop recording, build process graph |
 | `view [session_id]` | Open session graph in browser |
 | `log` | List sessions with sync status, visibility, tags |
-| `login` | Authenticate with the platform |
-| `push [session_id]` | Upload session |
-| `publish [session_id]` | Set public + push |
+| `login [--api-url URL]` | Authenticate with the platform |
+| `push [session_id] [--local]` | Upload session (`--local` targets localhost:8000) |
+| `publish [session_id] [--anonymous]` | Set public + push (redaction applied) |
 | `tag <session_id> <tags>` | Add tags |
 | `delete <session_id> [-f]` | Delete session and all its data |
-| `consent` | Change capture categories |
+| `consent` | Change capture, research, and redaction settings |
 | `review` | Inspect session data before pushing |
-| `update` | Check for and install CLI updates |
+| `journal on/off/status` | Toggle journal mode (full content capture) |
+| `e2e on/off/status/recover/release` | Manage personal E2E encryption keys |
+| `extension pair/status/install` | Browser extension pairing |
+| `proxy start/stop/status/cert` | Local AI API proxy (deep capture) |
+| `update [--auto/--no-auto]` | Check for and install CLI updates |
+| `lock [--purge]` | Destroy local encryption key (recoverable) |
+| `uninstall [--keep-sessions]` | Remove all hooks, data, and config |
 
 ## Privacy & Consent
 
@@ -307,6 +313,25 @@ methodproof start
 
 **Git commits** are detected automatically — only commits in a git repo rooted at (or above) the watch directory are captured.
 
+## Local Development
+
+Push sessions to a local API for testing:
+
+```bash
+# One-time: login to your local API
+mp login --api-url http://localhost:8000
+
+# Push with --local flag (overrides stored URL for this command)
+mp push --local
+
+# Or set the env var (works with any command)
+METHODPROOF_API_URL=http://localhost:8000 mp push
+```
+
+`--local` is a shorthand for `http://localhost:8000`. It does not clobber your production token — it only overrides the API URL for that invocation.
+
+You still need a valid JWT from the local API. Run `mp login --api-url http://localhost:8000` once to authenticate against your local platform.
+
 ## Data Directory
 
 `~/.methodproof/`

{methodproof-0.7.3 → methodproof-0.7.5}/README.md

@@ -138,18 +138,24 @@ flowchart TB
 | Command | What it does |
 |---------|-------------|
 | `init` | Interactive consent selector, install hooks, create data directory |
-| `start [--dir .] [--tags t1,t2] [--public] [--live]` | Start recording |
+| `start [--dir .] [--tags t1,t2] [--public] [--live] [--journal] [--e2e]` | Start recording |
 | `stop` | Stop recording, build process graph |
 | `view [session_id]` | Open session graph in browser |
 | `log` | List sessions with sync status, visibility, tags |
-| `login` | Authenticate with the platform |
-| `push [session_id]` | Upload session |
-| `publish [session_id]` | Set public + push |
+| `login [--api-url URL]` | Authenticate with the platform |
+| `push [session_id] [--local]` | Upload session (`--local` targets localhost:8000) |
+| `publish [session_id] [--anonymous]` | Set public + push (redaction applied) |
 | `tag <session_id> <tags>` | Add tags |
 | `delete <session_id> [-f]` | Delete session and all its data |
-| `consent` | Change capture categories |
+| `consent` | Change capture, research, and redaction settings |
 | `review` | Inspect session data before pushing |
-| `update` | Check for and install CLI updates |
+| `journal on/off/status` | Toggle journal mode (full content capture) |
+| `e2e on/off/status/recover/release` | Manage personal E2E encryption keys |
+| `extension pair/status/install` | Browser extension pairing |
+| `proxy start/stop/status/cert` | Local AI API proxy (deep capture) |
+| `update [--auto/--no-auto]` | Check for and install CLI updates |
+| `lock [--purge]` | Destroy local encryption key (recoverable) |
+| `uninstall [--keep-sessions]` | Remove all hooks, data, and config |
 
 ## Privacy & Consent
 
@@ -292,6 +298,25 @@ methodproof start
 
 **Git commits** are detected automatically — only commits in a git repo rooted at (or above) the watch directory are captured.
 
+## Local Development
+
+Push sessions to a local API for testing:
+
+```bash
+# One-time: login to your local API
+mp login --api-url http://localhost:8000
+
+# Push with --local flag (overrides stored URL for this command)
+mp push --local
+
+# Or set the env var (works with any command)
+METHODPROOF_API_URL=http://localhost:8000 mp push
+```
+
+`--local` is a shorthand for `http://localhost:8000`. It does not clobber your production token — it only overrides the API URL for that invocation.
+
+You still need a valid JWT from the local API. Run `mp login --api-url http://localhost:8000` once to authenticate against your local platform.
+
 ## Data Directory
 
 `~/.methodproof/`

{methodproof-0.7.3 → methodproof-0.7.5}/methodproof/__init__.py

@@ -1,3 +1,3 @@
 """MethodProof — see how you code."""
 
-__version__ = "0.7.3"
+__version__ = "0.7.5"

{methodproof-0.7.3 → methodproof-0.7.5}/methodproof/cli.py

@@ -466,6 +466,7 @@ def _print_commands() -> None:
     print(f"    {_G}mp start --live{R}        Stream your graph privately (only you can view)")
     print(f"    {_G}mp start --live-public{R} Stream your graph publicly (shareable link)")
     print(f"    {_G}mp start --journal{R}    Full content capture (2 free credits, then Pro)")
+    print(f"    {_G}mp start --e2e{R}         Encrypt session with your personal key {_D}(Pro){R}")
     print(f"    {_G}mp journal on{R}         Enable persistent journal mode")
     print(f"    {_G}mp journal status{R}     Check journal mode and remaining credits")
     print()
@@ -476,15 +477,29 @@ def _print_commands() -> None:
     print()
     print(f"  {_W}SHARE{R}")
     print(f"    {_Y}mp push{R}  {_D}[id]{R}          Upload privately to your account")
+    print(f"    {_Y}mp push --local{R}        Push to local dev API {_D}(localhost:8000){R}")
     print(f"    {_Y}mp publish{R} {_D}[id]{R}        Make session public (redaction applied)")
     print(f"    {_Y}mp publish --anonymous{R}  Public but identity hidden {_D}(Pro){R}")
     print(f"    {_Y}mp tag{R} {_D}<id> <tags>{R}     Tag a session")
     print()
+    print(f"  {_W}ENCRYPTION{R}")
+    print(f"    {_C}mp e2e on{R}              Enable E2E encryption (generates key on first use)")
+    print(f"    {_C}mp e2e off{R}             Disable E2E mode (key stays in keychain)")
+    print(f"    {_C}mp e2e status{R}          Show E2E mode and key status")
+    print(f"    {_C}mp e2e recover{R}         Recover key from recovery passphrase")
+    print(f"    {_C}mp e2e release{R} {_D}<id>{R}   Release a session from E2E encryption")
+    print()
     print(f"  {_W}EXTENSION{R}")
     print(f"    {_C}mp extension pair{R}      Pair browser extension to active session")
     print(f"    {_C}mp extension status{R}    Check extension connection")
     print(f"    {_C}mp extension install{R}   Open Chrome Web Store")
     print()
+    print(f"  {_W}PROXY{R}")
+    print(f"    {_C}mp proxy start{R}         Start local AI API proxy {_D}(deep capture){R}")
+    print(f"    {_C}mp proxy stop{R}          Stop proxy")
+    print(f"    {_C}mp proxy status{R}        Show proxy status")
+    print(f"    {_C}mp proxy cert{R}          CA certificate install instructions")
+    print()
     print(f"  {_W}ACCOUNT{R}")
     print(f"    {_M}mp login{R}              Connect to platform (opens browser)")
     print(f"    {_M}mp consent{R}            Change capture, research, and redaction settings")
@@ -497,6 +512,9 @@ def _print_commands() -> None:
     print(f"    {_M}mp update --no-auto{R}   Toggle auto-update off")
     print(f"    {_M}mp uninstall{R}           Remove all hooks, data, and config")
     print()
+    print(f"  {_W}ENVIRONMENT{R}")
+    print(f"    {_D}METHODPROOF_API_URL{R}    Override API endpoint {_D}(e.g. http://localhost:8000){R}")
+    print()
     print(f"  {_D}To view this at any time run: mp help{R}\n")
 
 
@@ -504,7 +522,12 @@ def _print_commands_plain() -> None:
     print("  RECORD")
     print("    mp start              Start recording a session")
     print("    mp stop               Stop recording, build process graph")
-    print("    mp start --live       Stream your graph in real time")
+    print("    mp start --live       Stream your graph privately")
+    print("    mp start --live-public  Stream your graph publicly (shareable link)")
+    print("    mp start --journal    Full content capture (2 free credits, then Pro)")
+    print("    mp start --e2e        Encrypt session with your personal key (Pro)")
+    print("    mp journal on         Enable persistent journal mode")
+    print("    mp journal status     Check journal mode and remaining credits")
     print()
     print("  REVIEW")
     print("    mp view  [id]         View session graph in browser")
@@ -513,15 +536,29 @@ def _print_commands_plain() -> None:
     print()
     print("  SHARE")
     print("    mp push  [id]         Upload privately to your account")
+    print("    mp push --local       Push to local dev API (localhost:8000)")
     print("    mp publish [id]       Make session public (redaction applied)")
     print("    mp publish --anonymous  Public but identity hidden (Pro)")
     print("    mp tag <id> <tags>    Tag a session")
     print()
+    print("  ENCRYPTION")
+    print("    mp e2e on             Enable E2E encryption (generates key on first use)")
+    print("    mp e2e off            Disable E2E mode (key stays in keychain)")
+    print("    mp e2e status         Show E2E mode and key status")
+    print("    mp e2e recover        Recover key from recovery passphrase")
+    print("    mp e2e release <id>   Release a session from E2E encryption")
+    print()
     print("  EXTENSION")
     print("    mp extension pair     Pair browser extension to active session")
     print("    mp extension status   Check extension connection")
     print("    mp extension install  Open Chrome Web Store")
     print()
+    print("  PROXY")
+    print("    mp proxy start        Start local AI API proxy (deep capture)")
+    print("    mp proxy stop         Stop proxy")
+    print("    mp proxy status       Show proxy status")
+    print("    mp proxy cert         CA certificate install instructions")
+    print()
     print("  ACCOUNT")
     print("    mp login              Connect to platform (opens browser)")
     print("    mp consent            Change capture, research, and redaction settings")
@@ -534,6 +571,9 @@ def _print_commands_plain() -> None:
     print("    mp update --no-auto   Toggle auto-update off")
     print("    mp uninstall          Remove all hooks, data, and config")
     print()
+    print("  ENVIRONMENT")
+    print("    METHODPROOF_API_URL   Override API endpoint (e.g. http://localhost:8000)")
+    print()
     print("  To view this at any time run: mp help\n")
 
 
@@ -1329,13 +1369,15 @@ def cmd_login(args: argparse.Namespace) -> None:
 
 
 def cmd_push(args: argparse.Namespace) -> None:
-    cfg = config.load()
+    local = getattr(args, "local", False)
+    cfg = config.load(local=local)
     if not cfg.get("token"):
-        print("Run `methodproof login` first.")
+        target = "local API" if local else "platform"
+        print(f"Run `methodproof login{' --api-url http://localhost:8000' if local else ''}` first.")
         sys.exit(1)
     from methodproof.sync import sync_research_consent
     sync_research_consent(cfg["token"], cfg["api_url"])
-    cfg = config.load()
+    cfg = config.load(local=local)
     sid = args.session_id or _latest()
     if not sid:
         print("No sessions to push.")
@@ -1343,7 +1385,7 @@ def cmd_push(args: argparse.Namespace) -> None:
     from methodproof.sync import push
     remote_id = push(sid, cfg["token"], cfg["api_url"])
     app = _app_url(cfg["api_url"])
-    print(f"Pushed {sid[:8]} (private).")
+    print(f"Pushed {sid[:8]} → {cfg['api_url']} (private).")
     print(f"  View: {app}/personal/sessions/{remote_id}")
     print(f"  Publish: mp publish {sid[:8]}")
 
@@ -1744,6 +1786,7 @@ def main() -> None:
     sub.add_parser("logout", help="Clear login credentials (keeps consent and sessions)")
     pu = sub.add_parser("push", help="Upload privately to your account")
     pu.add_argument("session_id", nargs="?")
+    pu.add_argument("--local", action="store_true", help="Push to local dev API (localhost:8000)")
     tg = sub.add_parser("tag", help="Tag a session")
     tg.add_argument("session_id", help="Session ID (prefix ok)")
     tg.add_argument("tags", help="Comma-separated tags")

{methodproof-0.7.3 → methodproof-0.7.5}/methodproof/config.py

@@ -134,10 +134,20 @@ def secure_file(path: Path) -> None:
         path.chmod(0o600)
 
 
-def load() -> dict[str, Any]:
+LOCAL_API_URL = "http://localhost:8000"
+
+
+def load(local: bool = False) -> dict[str, Any]:
     if not CONFIG.exists():
-        return dict(_DEFAULTS)
-    return {**_DEFAULTS, **json.loads(CONFIG.read_text())}
+        cfg = dict(_DEFAULTS)
+    else:
+        cfg = {**_DEFAULTS, **json.loads(CONFIG.read_text())}
+    env_url = os.environ.get("METHODPROOF_API_URL")
+    if local:
+        cfg["api_url"] = LOCAL_API_URL
+    elif env_url:
+        cfg["api_url"] = env_url
+    return cfg
 
 
 def save(cfg: dict[str, Any]) -> None:

{methodproof-0.7.3 → methodproof-0.7.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "methodproof"
-version = "0.7.3"
+version = "0.7.5"
 description = "See how you code. Capture and visualize your engineering process."
 requires-python = ">=3.11"
 dependencies = ["watchdog>=4.0", "websocket-client>=1.7", "cryptography>=43.0", "keyring>=25.0"]