frontend-perception-engine 0.1.0__tar.gz → 0.1.2__tar.gz

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontend-perception-engine
-Version: 0.1.0
+Version: 0.1.2
 Summary: Frontend perception engine with optional CRG-powered navigation hints for Browser Use.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -55,13 +55,25 @@ Your coding agent (Cursor/Claude/Codex) remains the brain.
 
 ### Install
 
-Development install:
+Recommended (quiet output + next steps):
 
 ```bash
-pip install -e .
+uvx --from frontend-perception-engine frontend-perception-install
+```
+
+With Chromium for Browser Use:
+
+```bash
+uvx --from frontend-perception-engine frontend-perception-install --with-browser
+```
+
+Development install from this repo:
+
+```bash
+python -m navigation.cli.install --editable .
 ```
 
-Published package usage (when installed from index):
+Or classic pip:
 
 ```bash
 pip install frontend-perception-engine

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/README.md

@@ -42,13 +42,25 @@ Your coding agent (Cursor/Claude/Codex) remains the brain.
 
 ### Install
 
-Development install:
+Recommended (quiet output + next steps):
 
 ```bash
-pip install -e .
+uvx --from frontend-perception-engine frontend-perception-install
+```
+
+With Chromium for Browser Use:
+
+```bash
+uvx --from frontend-perception-engine frontend-perception-install --with-browser
+```
+
+Development install from this repo:
+
+```bash
+python -m navigation.cli.install --editable .
 ```
 
-Published package usage (when installed from index):
+Or classic pip:
 
 ```bash
 pip install frontend-perception-engine

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "frontend-perception-engine"
-version = "0.1.0"
+version = "0.1.2"
 description = "Frontend perception engine with optional CRG-powered navigation hints for Browser Use."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -13,6 +13,7 @@ dependencies = [
 
 [project.scripts]
 frontend-perception-mcp = "navigation.mcp.server:main"
+frontend-perception-install = "navigation.cli.install:main"
 
 [project.optional-dependencies]
 aws = ["boto3>=1.35.0"]

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/src/frontend_perception_engine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontend-perception-engine
-Version: 0.1.0
+Version: 0.1.2
 Summary: Frontend perception engine with optional CRG-powered navigation hints for Browser Use.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -55,13 +55,25 @@ Your coding agent (Cursor/Claude/Codex) remains the brain.
 
 ### Install
 
-Development install:
+Recommended (quiet output + next steps):
 
 ```bash
-pip install -e .
+uvx --from frontend-perception-engine frontend-perception-install
+```
+
+With Chromium for Browser Use:
+
+```bash
+uvx --from frontend-perception-engine frontend-perception-install --with-browser
+```
+
+Development install from this repo:
+
+```bash
+python -m navigation.cli.install --editable .
 ```
 
-Published package usage (when installed from index):
+Or classic pip:
 
 ```bash
 pip install frontend-perception-engine

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/src/frontend_perception_engine.egg-info/SOURCES.txt

@@ -12,6 +12,8 @@ src/navigation/browser_use/agent_runner.py
 src/navigation/browser_use/hints.py
 src/navigation/browser_use/integration.py
 src/navigation/browser_use/llm.py
+src/navigation/cli/__init__.py
+src/navigation/cli/install.py
 src/navigation/codeGraph/__init__.py
 src/navigation/codeGraph/crg_impl.py
 src/navigation/codeGraph/factory.py

{frontend_perception_engine-0.1.0 → frontend_perception_engine-0.1.2}/src/frontend_perception_engine.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+frontend-perception-install = navigation.cli.install:main
 frontend-perception-mcp = navigation.mcp.server:main

frontend_perception_engine-0.1.2/src/navigation/cli/__init__.py

@@ -0,0 +1 @@
+"""User-facing CLI helpers for frontend-perception-engine."""

frontend_perception_engine-0.1.2/src/navigation/cli/install.py

@@ -0,0 +1,204 @@
+"""Quiet install wrapper with a simple progress indicator."""
+
+from __future__ import annotations
+
+import argparse
+import itertools
+import platform
+import shutil
+import subprocess
+import sys
+import threading
+import time
+from collections.abc import Sequence
+from pathlib import Path
+
+PACKAGE_NAME = 'frontend-perception-engine'
+_SPINNER_FRAMES = '|/-\\'
+
+
+class _Spinner:
+	def __init__(self, message: str) -> None:
+		self._message = message
+		self._stop = threading.Event()
+		self._thread: threading.Thread | None = None
+
+	def __enter__(self) -> _Spinner:
+		self._thread = threading.Thread(target=self._run, daemon=True)
+		self._thread.start()
+		return self
+
+	def __exit__(self, *_args: object) -> None:
+		self._stop.set()
+		if self._thread is not None:
+			self._thread.join()
+		width = len(self._message) + 6
+		sys.stdout.write('\r' + (' ' * width) + '\r')
+		sys.stdout.flush()
+
+	def _run(self) -> None:
+		for frame in itertools.cycle(_SPINNER_FRAMES):
+			if self._stop.is_set():
+				break
+			sys.stdout.write(f'\r  {frame} {self._message}')
+			sys.stdout.flush()
+			time.sleep(0.1)
+
+
+def _pip_available() -> bool:
+	result = subprocess.run(
+		[sys.executable, '-m', 'pip', '--version'],
+		capture_output=True,
+	)
+	return result.returncode == 0
+
+
+def _build_install_command(*, upgrade: bool, editable: str | None) -> list[str]:
+	target: list[str]
+	if editable is not None:
+		target = ['-e', editable]
+	else:
+		target = [PACKAGE_NAME]
+
+	if _pip_available():
+		cmd = [
+			sys.executable,
+			'-m',
+			'pip',
+			'install',
+			'-q',
+			'--disable-pip-version-check',
+		]
+		if upgrade:
+			cmd.append('--upgrade')
+		cmd.extend(target)
+		return cmd
+
+	uv = shutil.which('uv')
+	if uv is not None:
+		cmd = [uv, 'pip', 'install', '-q']
+		if upgrade:
+			cmd.append('--upgrade')
+		cmd.extend(target)
+		return cmd
+
+	raise SystemExit(
+		'No installer available. Install pip or uv, or use:\n'
+		'  uvx --from frontend-perception-engine frontend-perception-mcp\n',
+	)
+
+
+def _build_browser_install_command() -> list[str]:
+	cmd = ['uvx', 'playwright', 'install', 'chromium']
+	if platform.system() == 'Linux':
+		cmd.append('--with-deps')
+	cmd.append('--no-shell')
+	return cmd
+
+
+def _run_quiet(cmd: Sequence[str], *, label: str) -> None:
+	with _Spinner(label):
+		result = subprocess.run(
+			list(cmd),
+			capture_output=True,
+			text=True,
+		)
+	if result.returncode != 0:
+		sys.stderr.write(f'\nInstallation failed ({label}).\n')
+		if result.stderr.strip():
+			sys.stderr.write(result.stderr.strip() + '\n')
+		raise SystemExit(result.returncode or 1)
+
+
+def _installed_version() -> str | None:
+	try:
+		from importlib.metadata import version
+
+		return version(PACKAGE_NAME)
+	except Exception:
+		return None
+
+
+def _print_success(*, with_browser: bool) -> None:
+	version = _installed_version()
+	version_suffix = f' ({version})' if version else ''
+	sys.stdout.write(f'\n  OK  Successfully installed {PACKAGE_NAME}{version_suffix}\n\n')
+	sys.stdout.write('  Run MCP server:\n')
+	sys.stdout.write('    frontend-perception-mcp\n\n')
+	sys.stdout.write('  Or with uvx (no global install):\n')
+	sys.stdout.write('    uvx --from frontend-perception-engine frontend-perception-mcp\n\n')
+	sys.stdout.write('  Cursor MCP config:\n')
+	sys.stdout.write('    {\n')
+	sys.stdout.write('      "mcpServers": {\n')
+	sys.stdout.write('        "frontend-perception": {\n')
+	sys.stdout.write('          "command": "uvx",\n')
+	sys.stdout.write('          "args": ["--from", "frontend-perception-engine", "frontend-perception-mcp"]\n')
+	sys.stdout.write('        }\n')
+	sys.stdout.write('      }\n')
+	sys.stdout.write('    }\n')
+	if with_browser:
+		sys.stdout.write('\n  Chromium is ready for Browser Use.\n')
+	sys.stdout.flush()
+
+
+def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
+	parser = argparse.ArgumentParser(
+		prog='frontend-perception-install',
+		description='Install frontend-perception-engine with minimal output.',
+	)
+	parser.add_argument(
+		'-U',
+		'--upgrade',
+		action='store_true',
+		help='Upgrade an existing installation.',
+	)
+	parser.add_argument(
+		'-e',
+		'--editable',
+		metavar='PATH',
+		help='Install from a local checkout (pip install -e PATH).',
+	)
+	parser.add_argument(
+		'--with-browser',
+		action='store_true',
+		help='Also install Chromium for Browser Use (via playwright).',
+	)
+	return parser.parse_args(list(argv) if argv is not None else None)
+
+
+def main(argv: Sequence[str] | None = None) -> None:
+	args = _parse_args(argv)
+
+	if args.editable is not None:
+		editable_path = str(Path(args.editable).expanduser().resolve())
+		label = 'Installing frontend-perception-engine (editable)'
+	else:
+		editable_path = None
+		label = 'Installing frontend-perception-engine'
+
+	if (
+		not args.upgrade
+		and editable_path is None
+		and _installed_version() is not None
+		and not _pip_available()
+	):
+		_print_success(with_browser=False)
+		return
+
+	_run_quiet(_build_install_command(upgrade=args.upgrade, editable=editable_path), label=label)
+
+	if args.with_browser:
+		browser_cmd = _build_browser_install_command()
+		if shutil.which(browser_cmd[0]) is None:
+			sys.stderr.write(
+				'\nSkipped browser setup: uvx not found on PATH.\n'
+				'Install uv (https://docs.astral.sh/uv/) or run: uvx playwright install chromium\n',
+			)
+		else:
+			_run_quiet(browser_cmd, label='Setting up Chromium')
+
+	_print_success(with_browser=args.with_browser)
+
+
+if __name__ == '__main__':
+	main()