lightnow-cli 1.3.0__tar.gz → 1.4.0__tar.gz

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/.github/workflows/release.yml

@@ -96,3 +96,27 @@ jobs:
 
       - name: Publish distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+  update-homebrew:
+    name: Update Homebrew formula
+    runs-on: ubuntu-latest
+    needs: publish-pypi
+
+    steps:
+      - name: Dispatch published version to Homebrew tap
+        env:
+          GH_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          version="${TAG_NAME#v}"
+          payload="$(jq -n \
+            --arg formula "lightnow-cli" \
+            --arg version "$version" \
+            '{event_type: "python-release-published", client_payload: {formula: $formula, version: $version}}')"
+          curl --fail-with-body --silent --show-error \
+            --request POST \
+            --header "Accept: application/vnd.github+json" \
+            --header "Authorization: Bearer ${GH_TOKEN}" \
+            --header "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/lightnow-ai/homebrew-tap/dispatches \
+            --data "$payload"

lightnow_cli-1.4.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.4.0"
+}

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to the LightNow CLI are documented here.
 
 This project follows semantic versioning.
 
+## [1.4.0](https://github.com/lightnow-ai/lightnow-cli/compare/v1.3.1...v1.4.0) (2026-07-17)
+
+
+### Features
+
+* **#13:** add managed updates ([844e9c5](https://github.com/lightnow-ai/lightnow-cli/commit/844e9c5cb0fb2134f9e6014f02a0a4ca49db019c))
+* add managed updates ([275387e](https://github.com/lightnow-ai/lightnow-cli/commit/275387e05fd40f5b0564d9001acf9d3ed19ced5a))
+
+
+### Bug Fixes
+
+* harden managed update checks ([0c3a285](https://github.com/lightnow-ai/lightnow-cli/commit/0c3a285ccdfab4b39e60f905c9274e242245b2d8))
+
+## [1.3.1](https://github.com/lightnow-ai/lightnow-cli/compare/v1.3.0...v1.3.1) (2026-07-17)
+
+
+### Bug Fixes
+
+* **sync:** replace existing codex proxy connection ([c09b7f7](https://github.com/lightnow-ai/lightnow-cli/commit/c09b7f75f9d78c943ed7556b10b10ff99dbb2008))
+
 ## [1.3.0](https://github.com/lightnow-ai/lightnow-cli/compare/v1.2.0...v1.3.0) (2026-07-15)
 
 

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lightnow-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: Official LightNow CLI for MCP registry discovery, client config sync, and local MCP runner workflows
 Project-URL: Homepage, https://github.com/lightnow-ai/lightnow-cli
 Project-URL: Repository, https://github.com/lightnow-ai/lightnow-cli
@@ -21,6 +21,7 @@ Requires-Python: >=3.11
 Requires-Dist: filelock>=3.16.1
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: jsonschema>=4.17.0
+Requires-Dist: packaging>=24.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyjwt>=2.8.0
 Requires-Dist: pyyaml>=6.0.0
@@ -88,6 +89,25 @@ If you prefer installing directly from the public repository:
 pipx install git+https://github.com/lightnow-ai/lightnow-cli.git
 ```
 
+## Update
+
+The CLI manages supported installations of both the CLI and Local Proxy:
+
+```bash
+lightnow update --check
+lightnow update
+```
+
+Use `lightnow update --yes` for an approved non-interactive update or
+`lightnow update --check --json` for automation. Managed updates support
+Homebrew, pipx and uv. Editable, plain pip and unknown virtual-environment
+installs are reported but never changed automatically.
+
+Interactive CLI sessions check the release catalog at most once per day and
+show a short notice when an update is ready across all supported channels. Set
+`LIGHTNOW_NO_UPDATE_CHECK=1` to disable this background check. The Local Proxy
+never installs updates itself.
+
 ## Sign In
 
 ```bash
@@ -227,6 +247,8 @@ machine and its client-specific Runtime Profile in the LightNow Control Plane.
 The CLI stores a stable installation UUID in its protected configuration and a
 separate stable client-instance UUID in each generated proxy configuration. It
 does not report IP or MAC addresses, serial numbers, local paths, or secrets.
+The Control Plane can additionally show the observed CLI and Proxy versions,
+their supported installation channel and whether an update is available.
 
 For details, examples, diagrams and troubleshooting, see
 [Connect MCP clients](https://docs.lightnow.ai/getting-started/sync-mcp-clients).

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/README.md

@@ -41,6 +41,25 @@ If you prefer installing directly from the public repository:
 pipx install git+https://github.com/lightnow-ai/lightnow-cli.git
 ```
 
+## Update
+
+The CLI manages supported installations of both the CLI and Local Proxy:
+
+```bash
+lightnow update --check
+lightnow update
+```
+
+Use `lightnow update --yes` for an approved non-interactive update or
+`lightnow update --check --json` for automation. Managed updates support
+Homebrew, pipx and uv. Editable, plain pip and unknown virtual-environment
+installs are reported but never changed automatically.
+
+Interactive CLI sessions check the release catalog at most once per day and
+show a short notice when an update is ready across all supported channels. Set
+`LIGHTNOW_NO_UPDATE_CHECK=1` to disable this background check. The Local Proxy
+never installs updates itself.
+
 ## Sign In
 
 ```bash
@@ -180,6 +199,8 @@ machine and its client-specific Runtime Profile in the LightNow Control Plane.
 The CLI stores a stable installation UUID in its protected configuration and a
 separate stable client-instance UUID in each generated proxy configuration. It
 does not report IP or MAC addresses, serial numbers, local paths, or secrets.
+The Control Plane can additionally show the observed CLI and Proxy versions,
+their supported installation channel and whether an update is available.
 
 For details, examples, diagrams and troubleshooting, see
 [Connect MCP clients](https://docs.lightnow.ai/getting-started/sync-mcp-clients).

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/docs/release.md

@@ -19,6 +19,9 @@ Required GitHub setup:
 - Repository secret: `RELEASE_PLEASE_TOKEN`
 - Token permissions: contents, pull requests, and issues read/write for this
   repository
+- Repository secret: `HOMEBREW_TAP_TOKEN`
+- Token permissions: contents read/write for `lightnow-ai/homebrew-tap`; the
+  token is used only to send the post-PyPI repository dispatch
 - Repository Actions setting: allow GitHub Actions to create pull requests
 
 Use a real PAT or GitHub App token for `RELEASE_PLEASE_TOKEN`, not the default
@@ -33,7 +36,11 @@ Normal release flow:
 4. Release Please creates the `vX.Y.Z` tag and GitHub Release.
 5. The existing tag-based `Release` workflow builds and publishes PyPI
    distributions through Trusted Publishing.
-6. Update the Homebrew tap after the release artifact is available.
+6. After PyPI succeeds, the release workflow dispatches the exact published
+   version to `lightnow-ai/homebrew-tap`. The tap regenerates, audits, installs,
+   and tests the formula before committing it together with `releases.json`.
+   The public catalog advances only after the Homebrew artifact is verified,
+   so `lightnow update` never advertises a release that the tap cannot install.
 
 Manual release checklist for fallback or first-time setup:
 
@@ -64,11 +71,15 @@ Manual release checklist for fallback or first-time setup:
    - `twine check` passes,
    - a GitHub Release is created with generated release notes and distribution artifacts,
    - PyPI publish succeeds through Trusted Publishing.
-8. Update the Homebrew tap after the release artifact is available:
-   - repository: `lightnow-ai/homebrew-tap`
-   - formula: `Formula/lightnow-cli.rb`
-   - replace the formula template URL, version and SHA256 with the released artifact,
-   - run `brew audit`, `brew install --build-from-source`, and `brew test`.
+8. Verify the `Update formula` workflow in `lightnow-ai/homebrew-tap`. For a
+    recovery run, dispatch it manually with formula `lightnow-cli` and the exact
+    already-published version; it uses the same generation and verification path
+    as the automatic release dispatch.
+9. Verify the catalog and managed update path:
+   ```bash
+   curl -fsSL https://raw.githubusercontent.com/lightnow-ai/homebrew-tap/main/releases.json
+   lightnow update --check
+   ```
 
 Do not publish with long-lived local PyPI tokens.
 

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/lightnow_cli/__init__.py

@@ -1,3 +1,3 @@
 """LightNow CLI - A command-line tool for managing MCP servers."""
 
-__version__ = "1.3.0"  # x-release-please-version
+__version__ = "1.4.0"  # x-release-please-version

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/lightnow_cli/commands/integrations.py

@@ -23,6 +23,7 @@ import yaml
 from rich.console import Console
 from typing_extensions import Annotated
 
+from .. import __version__, updates
 from ..authenticated_http import (
     authentication_error_from_response,
     request_with_refresh,
@@ -602,6 +603,8 @@ def sync(
         )
         if local_proxy and remove_unmanaged_client_servers:
             removed_direct_servers = direct_server_aliases(existing, export_format)
+        if local_proxy and client == "codex" and export_format == "toml":
+            existing = remove_codex_mcp_server_alias(existing, connection)
         if (
             local_proxy
             and remove_unmanaged_client_servers
@@ -1205,6 +1208,11 @@ def build_local_proxy_config(
         "client_instance_id": client_instance_id,
         "device_hostname": socket.gethostname(),
         "device_platform": runtime_device_platform(),
+        "cli_version": __version__,
+        "cli_install_method": updates.detect_install_method(
+            "lightnow-cli", shutil.which("lightnow") or sys.argv[0]
+        ),
+        "update_state_path": str(updates.UPDATE_STATE_PATH),
         "telemetry_enabled": True,
     }
     if isinstance(local_proxy_settings, dict):
@@ -1296,6 +1304,13 @@ def register_runtime_device_client(
                 "device": {
                     "reported_hostname": socket.gethostname(),
                     "platform": runtime_device_platform(),
+                    "cli_version": __version__,
+                    "cli_install_method": updates.detect_install_method(
+                        "lightnow-cli", shutil.which("lightnow") or sys.argv[0]
+                    ),
+                    "cli_latest_version": None,
+                    "cli_update_status": "unknown",
+                    "cli_update_checked_at": None,
                 },
                 "client": {
                     "name": client,
@@ -1303,6 +1318,12 @@ def register_runtime_device_client(
                     "profile": profile,
                     "runner_name": "lightnow-local-proxy",
                     "runner_version": None,
+                    "runner_install_method": updates.detect_install_method(
+                        "lightnow-proxy", local_proxy_command()
+                    ),
+                    "runner_latest_version": None,
+                    "runner_update_status": "unknown",
+                    "runner_update_checked_at": None,
                     "transport": transport,
                 },
             },
@@ -2281,6 +2302,16 @@ def prepare_codex_local_proxy_config(existing: str) -> str:
     return strip_codex_mcp_server_tables(existing, preserved)
 
 
+def remove_codex_mcp_server_alias(existing: str, alias: str) -> str:
+    """Remove one Codex MCP table before writing its managed replacement."""
+    if not existing.strip():
+        return existing
+    entries = extract_mcp_entries(existing, "toml")
+    if alias not in entries:
+        return existing
+    return strip_codex_mcp_server_tables(existing, set(entries) - {alias})
+
+
 def prepare_json_local_proxy_config(existing: str) -> str:
     """Remove direct JSON servers while preserving existing proxy connections."""
     if not existing.strip():

lightnow_cli-1.4.0/lightnow_cli/commands/updates.py

@@ -0,0 +1,93 @@
+"""User-facing managed update commands."""
+
+from __future__ import annotations
+
+import json as json_module
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from lightnow_cli import updates
+
+console = Console()
+
+
+def _render(state: dict, json_output: bool) -> None:
+    if json_output:
+        typer.echo(json_module.dumps(state, indent=2))
+        return
+    table = Table(title="LightNow updates")
+    table.add_column("Component")
+    table.add_column("Installed")
+    table.add_column("Latest")
+    table.add_column("Installer")
+    table.add_column("Status")
+    table.add_column("Result")
+    for package, entry in state.get("packages", {}).items():
+        table.add_row(
+            package,
+            entry.get("installed_version") or "not installed",
+            entry.get("latest_version") or "unknown",
+            entry.get("install_method") or "unknown",
+            entry.get("status") or "unknown",
+            entry.get("result") or "checked",
+        )
+        if entry.get("error"):
+            table.add_row("", "", "", "", "", f"[red]{entry['error']}[/red]")
+    console.print(table)
+
+
+def update(
+    yes: Annotated[
+        bool, typer.Option("--yes", "-y", help="Apply updates without prompting.")
+    ] = False,
+    check: Annotated[
+        bool, typer.Option("--check", help="Check only; do not install updates.")
+    ] = False,
+    json_output: Annotated[
+        bool, typer.Option("--json", help="Print machine-readable JSON.")
+    ] = False,
+) -> None:
+    """Check for and apply LightNow CLI and Local Proxy updates."""
+    if check and yes:
+        raise typer.BadParameter("--yes cannot be combined with --check")
+    if json_output and not check and not yes:
+        raise typer.BadParameter(
+            "--json requires --check or --yes to avoid an interactive prompt"
+        )
+    try:
+        state = updates.refresh_update_state()
+    except Exception as error:
+        if json_output:
+            typer.echo(
+                json_module.dumps({"error": str(error), "packages": {}}, indent=2)
+            )
+        else:
+            console.print(f"[red]Could not check for LightNow updates:[/red] {error}")
+        raise typer.Exit(1) from error
+
+    outdated = updates.cached_outdated_packages(state)
+    if check or not outdated:
+        _render(state, json_output)
+        return
+    if not yes and not typer.confirm(
+        f"Update {len(outdated)} LightNow component(s) now?"
+    ):
+        _render(state, json_output)
+        return
+
+    state, success = updates.apply_updates(state)
+    _render(state, json_output)
+    if not success:
+        raise typer.Exit(1)
+
+
+def refresh_update_state() -> None:
+    """Refresh update state in a detached helper process."""
+    try:
+        updates.refresh_update_state()
+    finally:
+        Path(updates.UPDATE_PENDING_PATH).unlink(missing_ok=True)

{lightnow_cli-1.3.0 → lightnow_cli-1.4.0}/lightnow_cli/main.py

@@ -3,8 +3,19 @@
 import typer
 from typing_extensions import Annotated
 
-from . import __version__
-from .commands import auth, context, integrations, publish, query, runner, validate
+from . import __version__, updates
+from .commands import (
+    auth,
+    context,
+    integrations,
+    publish,
+    query,
+    runner,
+)
+from .commands import updates as update_commands
+from .commands import (
+    validate,
+)
 from .tls import configure_tls_trust_store
 
 configure_tls_trust_store()
@@ -29,6 +40,8 @@ app.command("import-config")(integrations.import_config)
 app.command("sync")(integrations.sync)
 app.command("config-status")(integrations.config_status)
 app.command("run")(runner.run)
+app.command("update")(update_commands.update)
+app.command("_refresh-update-state", hidden=True)(update_commands.refresh_update_state)
 
 
 def version_callback(value: bool) -> None:
@@ -45,7 +58,14 @@ def main(
     ] = False,
 ) -> None:
     """LightNow CLI."""
-    pass
+    if updates.should_check_automatically():
+        outdated = updates.cached_outdated_packages(updates.read_update_state())
+        if outdated:
+            typer.echo(
+                f"LightNow update available for {', '.join(outdated)}. Run `lightnow update`.",
+                err=True,
+            )
+        updates.start_background_refresh()
 
 
 def cli() -> None: