@grifhinz/logics-manager 2.0.2 → 2.0.4

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/AlexAgo83/logics-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/AlexAgo83/logics-manager/actions/workflows/ci.yml)
 [![License](https://img.shields.io/github/license/AlexAgo83/logics-manager)](LICENSE)
-![Version](https://img.shields.io/badge/version-v2.0.2-4C8BF5)
+![Version](https://img.shields.io/badge/version-v2.0.4-4C8BF5)
 ![VS Code](https://img.shields.io/badge/VS%20Code-1.86.0-007ACC?logo=visualstudiocode&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-3178C6?logo=typescript&logoColor=white)
 ![Vitest](https://img.shields.io/badge/Vitest-2.1.8-6E9F18?logo=vitest&logoColor=white)
@@ -35,6 +35,9 @@ Install the npm package with:
 npm install -g @grifhinz/logics-manager
 ```
 
+To update that CLI later, run `logics-manager self-update`.
+The command uses `pip` when the Python package is installed and falls back to `npm` for the global npm package.
+
 For the editor client, build and install the VSIX:
 
 ```bash
@@ -267,7 +270,7 @@ Contract:
 - `Environment` can also surface direct remediation actions when the plugin detects a stale runtime, an incomplete bootstrap, a missing global publication, or missing environment placeholders.
 - `Environment` now uses a clearer hierarchy with summary, recommended actions, current status, and technical details, plus hybrid assist runtime state, backend availability, degraded reasons, Claude-bridge presence, and the shared Windows-safe runtime entrypoint.
 - `Check Environment` can be promoted into `Recommended` when the current repo state actually warrants operator attention.
-- repo-local refresh now watches `logics/**/*`, `logics.yaml`, and supported `.claude/` bridge files; external global runtime state still requires an explicit refresh because it lives outside the workspace.
+- repo-local refresh now watches `logics/**/*`, `logics.yaml`, and `.git/HEAD`; external global runtime state still requires an explicit refresh because it lives outside the workspace.
 - `Launch Codex` starts Codex using the globally published Logics runtime when the shared runtime is healthy.
 - `AI Runtime Status` probes the shared `logics.py flow assist runtime-status` surface and reports ready providers, flagged providers, cooldown or credential issues, and bounded backend provenance.
 - `AI Provider Insights` opens a dedicated plugin panel backed by `logics.py flow assist roi-report`, with provider mix, execution-path breakdowns, derived rates, estimated ROI proxies, and recent audit drill-down over the shared runtime output.

package/VERSION

@@ -1 +1 @@
-2.0.2
+2.0.4

package/logics_manager/assist.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import argparse
 import json
+import os
 from collections import Counter
 from datetime import datetime, timedelta, timezone
 import re
@@ -1283,7 +1284,7 @@ def build_parser() -> argparse.ArgumentParser:
 
     claude_bridges = sub.add_parser(
         "claude-bridges",
-        help="Render the canonical Claude bridge files and prompts derived from the integrated runtime.",
+        help="Render the canonical Claude runtime publication manifest and prompts derived from the integrated runtime.",
     )
     claude_bridges.add_argument("--format", choices=("text", "json"), default="text")
     claude_bridges.add_argument("--dry-run", action="store_true")
@@ -1346,10 +1347,17 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
-def _claude_bridge_status(repo_root: Path) -> dict[str, object]:
+def _get_global_claude_home() -> Path:
+    return Path(os.environ.get("LOGICS_CLAUDE_GLOBAL_HOME") or (Path.home() / ".claude")).resolve()
+
+
+def _claude_bridge_status(_repo_root: Path) -> dict[str, object]:
+    global_home = _get_global_claude_home()
     detected_variants: list[str] = []
     for variant in CLAUDE_BRIDGE_VARIANTS:
-        if (repo_root / variant["command_path"]).is_file() and (repo_root / variant["agent_path"]).is_file():
+        command_path = global_home / str(variant["command_path"]).replace(".claude/", "")
+        agent_path = global_home / str(variant["agent_path"]).replace(".claude/", "")
+        if command_path.is_file() and agent_path.is_file():
             detected_variants.append(variant["id"])
     return {
         "available": bool(detected_variants),
@@ -1368,7 +1376,7 @@ def _render_claude_bridge_lines(variant: dict[str, object], prompt: str) -> tupl
     command_lines = [
         f"# {title}",
         "",
-        f"Use the repository-local {title.lower()} bridge for this project.",
+        f"Use the published global {title.lower()} bridge for this project.",
         "",
         "Primary prompt:",
         prompt,
@@ -1377,7 +1385,7 @@ def _render_claude_bridge_lines(variant: dict[str, object], prompt: str) -> tupl
     agent_lines = [
         f"# {title} Agent",
         "",
-        f"Use the repository-local {title.lower()} agent for this project.",
+        f"Use the published global {title.lower()} agent for this project.",
         "",
         "Default prompt:",
         prompt,
@@ -1433,8 +1441,8 @@ def _build_claude_instructions(repo_root: Path) -> dict[str, object]:
             "- `python3 -m logics_manager lint --require-status`",
             "- `python3 -m logics_manager audit --legacy-cutoff-version 1.1.0 --group-by-doc`",
             "",
-            "Repository-local Claude bridge files and assistant instructions are generated from the integrated runtime.",
-            "Do not edit `.claude/` bridge files by hand unless you are deliberately repairing a generated artifact.",
+            "Claude runtime artifacts are generated outside the repository from the integrated runtime.",
+            "Do not edit generated runtime artifacts by hand unless you are deliberately repairing a generated artifact.",
             "",
             "Do not edit indicator lines or workflow links by hand.",
             "",
@@ -1454,8 +1462,8 @@ def _select_backend(requested_backend: str | None, bridge_status: dict[str, obje
     if requested_backend and requested_backend != "auto":
         return requested_backend, []
     if bridge_status.get("available"):
-        return "codex", ["claude bridge files detected"]
-    return "deterministic", ["no bridge files detected"]
+        return "codex", ["global Claude runtime published"]
+    return "deterministic", ["no global Claude runtime published"]
 
 
 def cmd_claude_bridges(args: argparse.Namespace) -> dict[str, object]:
@@ -1953,9 +1961,9 @@ def cmd_runtime_status(args: argparse.Namespace) -> dict[str, object]:
         print(f"- selected backend: {selected_backend}")
         print(f"- model profile: {default_profile}")
         print(f"- model: {resolved_model}")
-        print(f"- bridge available: {'yes' if bridge_status['available'] else 'no'}")
+        print(f"- global Claude runtime available: {'yes' if bridge_status['available'] else 'no'}")
         if bridge_status["preferred_variant"]:
-            print(f"- bridge variant: {bridge_status['preferred_variant']}")
+            print(f"- runtime variant: {bridge_status['preferred_variant']}")
     return payload
 
 
@@ -2200,7 +2208,7 @@ def cmd_context(args: argparse.Namespace) -> dict[str, object]:
         print(f"- ref: {args.ref or '<flow-default>'}")
         print(f"- mode: {context_mode}")
         print(f"- profile: {profile}")
-        print(f"- bridge available: {'yes' if bridge_status['available'] else 'no'}")
+        print(f"- global Claude runtime available: {'yes' if bridge_status['available'] else 'no'}")
     return payload
 
 

package/logics_manager/bootstrap.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
 import json
+import shutil
 from pathlib import Path
 
-from .assist import _build_claude_bridge_manifest, _build_claude_instructions
+from .assist import _build_claude_instructions
 
 
 WORKFLOW_DIRS: tuple[str, ...] = ("request", "backlog", "tasks", "specs", "product", "architecture", "external", ".cache")
@@ -13,14 +14,34 @@ def _workflow_directories(repo_root: Path) -> list[Path]:
     return [repo_root / "logics" / name for name in WORKFLOW_DIRS]
 
 
+def _legacy_runtime_paths(repo_root: Path) -> list[Path]:
+    return [repo_root / ".claude", repo_root / "logics" / "skills"]
+
+
+def _remove_legacy_runtime_paths(repo_root: Path, *, check: bool) -> list[str]:
+    removed_paths: list[str] = []
+    for target in _legacy_runtime_paths(repo_root):
+        if not target.exists():
+            continue
+        removed_paths.append(target.relative_to(repo_root).as_posix() + ("/" if target.is_dir() else ""))
+        if not check:
+            if target.is_dir():
+                shutil.rmtree(target)
+            else:
+                target.unlink()
+    return removed_paths
+
+
 def bootstrap_payload(repo_root: Path, *, check: bool) -> dict[str, object]:
     logics_root = repo_root / "logics"
-    bridge_manifest = _build_claude_bridge_manifest(repo_root)
     instructions_manifest = _build_claude_instructions(repo_root)
     directory_actions: list[dict[str, object]] = []
     created_paths: list[str] = []
+    removed_paths: list[str] = []
     missing_paths: list[str] = []
 
+    removed_paths.extend(_remove_legacy_runtime_paths(repo_root, check=check))
+
     if not logics_root.exists():
         missing_paths.append("logics/")
     elif not logics_root.is_dir():
@@ -71,24 +92,6 @@ def bootstrap_payload(repo_root: Path, *, check: bool) -> dict[str, object]:
             instructions_path.write_text(instructions_content, encoding="utf-8")
             created_paths.append("logics/instructions.md")
 
-    for bridge in bridge_manifest["bridges"]:
-        for rel_path, content in (
-            (str(bridge["command_path"]), str(bridge["command_content"])),
-            (str(bridge["agent_path"]), str(bridge["agent_content"])),
-        ):
-            bridge_path = repo_root / rel_path
-            if bridge_path.exists():
-                try:
-                    if bridge_path.read_text(encoding="utf-8") == content:
-                        continue
-                except Exception:
-                    pass
-            missing_paths.append(rel_path)
-            if not check:
-                bridge_path.parent.mkdir(parents=True, exist_ok=True)
-                bridge_path.write_text(content, encoding="utf-8")
-                created_paths.append(rel_path)
-
     ok = not missing_paths if check else True
     return {
         "command": "bootstrap",
@@ -97,8 +100,8 @@ def bootstrap_payload(repo_root: Path, *, check: bool) -> dict[str, object]:
         "ok": ok,
         "missing_paths": missing_paths,
         "created_paths": created_paths,
+        "removed_paths": removed_paths,
         "directory_actions": directory_actions,
-        "claude_bridge_count": bridge_manifest["bridge_count"],
         "claude_instruction_line_count": instructions_manifest["line_count"],
     }
 
@@ -114,6 +117,10 @@ def render_bootstrap(payload: dict[str, object], *, output_format: str) -> str:
             lines.append(f"- missing: {path}")
         return "\n".join(lines)
     lines = ["Bootstrap: OK"]
+    if payload.get("removed_paths"):
+        lines.append("- removed:")
+        for path in payload["removed_paths"]:
+            lines.append(f"  - {path}")
     if payload["created_paths"]:
         lines.append("- created:")
         for path in payload["created_paths"]:

package/logics_manager/cli.py

@@ -2,7 +2,9 @@ from __future__ import annotations
 
 import argparse
 from importlib import metadata
+import subprocess
 import sys
+from shutil import which
 from pathlib import Path
 from textwrap import dedent
 
@@ -16,6 +18,10 @@ from .lint import lint_payload, render_lint
 from .doctor import render_doctor
 
 
+DEFAULT_SELF_UPDATE_PY_PACKAGE = "logics-manager"
+DEFAULT_SELF_UPDATE_PACKAGE = "@grifhinz/logics-manager"
+
+
 def get_cli_version() -> str:
     version_file = Path(__file__).resolve().parents[1] / "VERSION"
     try:
@@ -52,7 +58,7 @@ def main(argv: list[str] | None = None) -> int:
     parser.add_argument(
         "command",
         nargs="?",
-        choices=("bootstrap", "flow", "sync", "assist", "audit", "index", "lint", "config", "doctor"),
+        choices=("bootstrap", "flow", "sync", "assist", "audit", "index", "lint", "config", "doctor", "self-update"),
     )
     parser.add_argument("rest", nargs=argparse.REMAINDER)
     args = parser.parse_args(argv[:1])
@@ -100,6 +106,41 @@ def main(argv: list[str] | None = None) -> int:
         payload = bootstrap_payload(repo_root, check=parsed.check)
         print(render_bootstrap(payload, output_format=parsed.format))
         return 0 if payload["ok"] else 1
+    if args.command == "self-update":
+        parser = argparse.ArgumentParser(prog="logics-manager self-update", add_help=False)
+        parser.add_argument("--manager", choices=("auto", "pip", "npm"), default="auto")
+        parser.add_argument("--package", default=DEFAULT_SELF_UPDATE_PACKAGE)
+        parser.add_argument("--python-package", default=DEFAULT_SELF_UPDATE_PY_PACKAGE)
+        parser.add_argument("--dry-run", action="store_true")
+        parsed, _unknown = parser.parse_known_args(rest)
+
+        manager = parsed.manager
+        if manager == "auto":
+            try:
+                metadata.version(parsed.python_package)
+            except metadata.PackageNotFoundError:
+                manager = "npm" if which("npm") else "pip"
+            else:
+                manager = "pip"
+
+        if manager == "pip":
+            command = [sys.executable, "-m", "pip", "install", "--upgrade", parsed.python_package]
+        else:
+            npm = which("npm")
+            if not npm:
+                print("npm was not found on PATH. Install Node.js/npm or update the package manually.")
+                return 1
+            command = [npm, "install", "-g", f"{parsed.package}@latest"]
+
+        if parsed.dry_run:
+            print("Dry run: " + " ".join(command))
+            return 0
+
+        result = subprocess.run(command, check=False)
+        if result.returncode == 0:
+            target = parsed.python_package if manager == "pip" else parsed.package
+            print(f"Updated {target} via {manager}.")
+        return result.returncode
     if args.command == "flow" and rest[:1] in (["new"], ["companion"], ["promote"], ["split"], ["close"], ["finish"]):
         from .flow import main as flow_main
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@grifhinz/logics-manager",
   "displayName": "Logics Orchestrator",
   "description": "Visual orchestration for Logics workflows inside VS Code.",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "publisher": "cdx-logics",
   "icon": "media/icon.png",
   "repository": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logics-manager"
-version = "2.0.2"
+version = "2.0.4"
 description = "Canonical Logics CLI"
 requires-python = ">=3.10"