auto-context-cli 1.0.1__tar.gz → 1.0.2__tar.gz

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: auto-context-cli
-Version: 1.0.1
+Version: 1.0.2
 Summary: Autonomous context & instruction manager for AI coding assistants
 Author: Arghya Biswas
 License: MIT
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI - Version](https://img.shields.io/pypi/v/auto-context-cli.svg?color=blue)](https://pypi.org/project/auto-context-cli/)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/auto-context-cli.svg)](https://pypi.org/project/auto-context-cli/)
-[![GitHub Release](https://img.shields.io/github/v/release/Cyber-arghya/auto-context?color=green)](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.1)
+[![GitHub Release](https://img.shields.io/github/v/release/Cyber-arghya/auto-context?color=green)](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.2)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux%20WSL2-success.svg)](#-quick-one-line-install)
 [![AI Supported](https://img.shields.io/badge/AI%20Supported-Antigravity%20%7C%20Cursor%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Windsurf-orange.svg)](#-supported-ai-assistants)
@@ -95,6 +95,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
   memory status             Show status of central memory brain
   share <NAME>              Audit & publish skill or rule to GitHub Gist
   import <URL>              Audit & import skill or rule from GitHub Gist or URL
+  update                    Safely update CLI, global plugin & public rules (Non-breaking)
+  update --check            Check for updates without modifying files
+  update -w, --workspace    Update managed system rules in active workspace
+  update -g, --global       Sync global plugin (~/.gemini/config/plugins/auto-context/)
+  update -c, --cli          Upgrade auto-context-cli package via uv/pipx/pip
   --as <NAME>               Custom name when importing a skill or rule
   --public                  Publish shared Gist as public (default)
   --secret, --private       Publish shared Gist as unlisted/secret
@@ -112,6 +117,38 @@ OPTIONS (MCP TOOLING):
 
 ---
 
+## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
+
+When new public rules, skills, or agent capabilities are added to the official [Cyber-arghya/auto-context](https://github.com/Cyber-arghya/auto-context) repository:
+
+### 1️⃣ Automatic Background Notification
+`auto-context` includes a lightweight, cached (24h TTL) update notifier. Whenever you or an AI agent runs `init-context`, it unobtrusively checks PyPI and GitHub. If new upstream rules or versions are available, a clean banner is displayed:
+```text
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2                           │
+│    New public rules, skills, and upstream capabilities are ready.           │
+│    Run 'init-context update' to sync modularly without breaking local context.│
+╰─────────────────────────────────────────────────────────────────────────────╯
+```
+
+### 2️⃣ 1-Command Safe Modular Update
+Run:
+```bash
+init-context update
+```
+- **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
+- **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
+- **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
+
+> [!TIP]
+> **Strict Non-Breaking Guarantees:**
+> - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
+> - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
+> - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
+> - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
+
+---
+
 ## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
 
 Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
@@ -537,6 +574,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
   ```
   > **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
 
+### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
+অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
+1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
+2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
+   ```bash
+   init-context update           # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
+   init-context update --check   # কোনো আপডেট আছে কিনা শুধু চেক করতে
+   init-context update -w        # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
+   ```
+> **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
+> * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
+> * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
+> * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
+
 ### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
 টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
 * **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/README.md

@@ -6,7 +6,7 @@
 
 [![PyPI - Version](https://img.shields.io/pypi/v/auto-context-cli.svg?color=blue)](https://pypi.org/project/auto-context-cli/)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/auto-context-cli.svg)](https://pypi.org/project/auto-context-cli/)
-[![GitHub Release](https://img.shields.io/github/v/release/Cyber-arghya/auto-context?color=green)](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.1)
+[![GitHub Release](https://img.shields.io/github/v/release/Cyber-arghya/auto-context?color=green)](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.2)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux%20WSL2-success.svg)](#-quick-one-line-install)
 [![AI Supported](https://img.shields.io/badge/AI%20Supported-Antigravity%20%7C%20Cursor%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Windsurf-orange.svg)](#-supported-ai-assistants)
@@ -81,6 +81,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
   memory status             Show status of central memory brain
   share <NAME>              Audit & publish skill or rule to GitHub Gist
   import <URL>              Audit & import skill or rule from GitHub Gist or URL
+  update                    Safely update CLI, global plugin & public rules (Non-breaking)
+  update --check            Check for updates without modifying files
+  update -w, --workspace    Update managed system rules in active workspace
+  update -g, --global       Sync global plugin (~/.gemini/config/plugins/auto-context/)
+  update -c, --cli          Upgrade auto-context-cli package via uv/pipx/pip
   --as <NAME>               Custom name when importing a skill or rule
   --public                  Publish shared Gist as public (default)
   --secret, --private       Publish shared Gist as unlisted/secret
@@ -98,6 +103,38 @@ OPTIONS (MCP TOOLING):
 
 ---
 
+## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
+
+When new public rules, skills, or agent capabilities are added to the official [Cyber-arghya/auto-context](https://github.com/Cyber-arghya/auto-context) repository:
+
+### 1️⃣ Automatic Background Notification
+`auto-context` includes a lightweight, cached (24h TTL) update notifier. Whenever you or an AI agent runs `init-context`, it unobtrusively checks PyPI and GitHub. If new upstream rules or versions are available, a clean banner is displayed:
+```text
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2                           │
+│    New public rules, skills, and upstream capabilities are ready.           │
+│    Run 'init-context update' to sync modularly without breaking local context.│
+╰─────────────────────────────────────────────────────────────────────────────╯
+```
+
+### 2️⃣ 1-Command Safe Modular Update
+Run:
+```bash
+init-context update
+```
+- **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
+- **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
+- **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
+
+> [!TIP]
+> **Strict Non-Breaking Guarantees:**
+> - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
+> - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
+> - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
+> - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
+
+---
+
 ## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
 
 Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
@@ -523,6 +560,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
   ```
   > **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
 
+### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
+অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
+1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
+2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
+   ```bash
+   init-context update           # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
+   init-context update --check   # কোনো আপডেট আছে কিনা শুধু চেক করতে
+   init-context update -w        # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
+   ```
+> **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
+> * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
+> * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
+> * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
+
 ### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
 টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
 * **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "auto-context-cli"
-version = "1.0.1"
+version = "1.0.2"
 description = "Autonomous context & instruction manager for AI coding assistants"
 readme = "README.md"
 requires-python = ">=3.11"

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/__init__.py

@@ -1,3 +1,3 @@
 """auto-context: Autonomous context & instruction manager for AI coding assistants."""
 
-__version__ = "1.0.1"
+__version__ = "1.0.2"

auto_context_cli-1.0.2/src/auto_context/commands/update_cmd.py

@@ -0,0 +1,392 @@
+"""
+update_cmd.py — Modular, non-breaking update manager and upstream notification engine.
+
+Ensures users stay synchronized with public rules, skills, and tools added to
+https://github.com/Cyber-arghya/auto-context without breaking local project context,
+custom user rules, or private memory.
+"""
+from importlib.metadata import version as get_pkg_version
+import json
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+import time
+from typing import Annotated, Optional
+import urllib.error
+import urllib.request
+
+from rich.console import Console
+from rich.panel import Panel
+import typer
+
+from auto_context import config
+
+console = Console()
+
+
+def _parse_version(v_str: str) -> tuple[int, ...]:
+    """Parse version string like '1.0.1' or 'v1.0.2' into an integer tuple."""
+    clean = v_str.strip().lstrip("v").split("-")[0]
+    parts = []
+    for p in clean.split("."):
+        try:
+            parts.append(int(p))
+        except ValueError:
+            break
+    return tuple(parts) if parts else (0, 0, 0)
+
+
+def get_installed_version() -> str:
+    """Return the currently installed package version."""
+    for pkg in (config.PYPI_PACKAGE, "auto-context"):
+        try:
+            return get_pkg_version(pkg)
+        except Exception:
+            pass
+    return "1.0.1"
+
+
+# ── Update Checking & Cache Engine ────────────────────────────────────────────
+
+def check_upstream_version(timeout: float = 2.0) -> Optional[dict]:
+    """
+    Query PyPI and GitHub to determine the latest upstream version.
+    Returns dict with metadata or None if offline/error.
+    """
+    # 1. Try PyPI first (fastest, no rate limits)
+    try:
+        req = urllib.request.Request(
+            config.PYPI_JSON_URL,
+            headers={"User-Agent": f"auto-context-cli/{get_installed_version()}"},
+        )
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+            latest = data.get("info", {}).get("version")
+            if latest:
+                return {
+                    "latest_version": latest,
+                    "source": "pypi",
+                    "package": config.PYPI_PACKAGE,
+                }
+    except Exception:
+        pass
+
+    # 2. Fallback to GitHub Latest Release API
+    try:
+        req = urllib.request.Request(
+            config.GITHUB_LATEST_RELEASE_URL,
+            headers={"User-Agent": f"auto-context-cli/{get_installed_version()}"},
+        )
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+            tag = data.get("tag_name", "").lstrip("v")
+            if tag:
+                return {
+                    "latest_version": tag,
+                    "source": "github",
+                    "url": data.get("html_url"),
+                }
+    except Exception:
+        pass
+
+    return None
+
+
+def get_cached_update_status(force_check: bool = False) -> Optional[dict]:
+    """
+    Retrieve update status from local cache or refresh if cache expired.
+    Cached for 24 hours to ensure 0ms latency for daily CLI usage.
+    """
+    now = time.time()
+    cache_file = config.UPDATE_CACHE_FILE
+
+    try:
+        if not force_check and cache_file.exists():
+            cached = json.loads(cache_file.read_text(encoding="utf-8"))
+            timestamp = cached.get("timestamp", 0)
+            if now - timestamp < config.UPDATE_CHECK_INTERVAL:
+                return cached
+    except Exception:
+        pass
+
+    # Cache expired or missing — refresh in background
+    upstream = check_upstream_version()
+    if not upstream:
+        return None
+
+    current_v = get_installed_version()
+    latest_v = upstream["latest_version"]
+    update_available = _parse_version(latest_v) > _parse_version(current_v)
+
+    cache_data = {
+        "timestamp": now,
+        "current_version": current_v,
+        "latest_version": latest_v,
+        "update_available": update_available,
+        "source": upstream.get("source"),
+    }
+
+    try:
+        cache_file.parent.mkdir(parents=True, exist_ok=True)
+        cache_file.write_text(json.dumps(cache_data, indent=2), encoding="utf-8")
+    except Exception:
+        pass
+
+    return cache_data
+
+
+def maybe_notify_update() -> None:
+    """
+    Subtle, non-intrusive notification banner rendered at CLI termination.
+    Only displays if an update is genuinely available and cache confirms it.
+    """
+    try:
+        status = get_cached_update_status(force_check=False)
+        if not status or not status.get("update_available"):
+            return
+
+        cur = status.get("current_version", "")
+        latest = status.get("latest_version", "")
+        console.print()
+        console.print(Panel(
+            f"[bold cyan]🔔 Auto-Context Update Available:[/] [yellow]v{cur}[/] → [bold green]v{latest}[/]\n"
+            f"[white]   New public rules, skills, and upstream capabilities are ready.[/]\n"
+            f"[cyan]   Run:[/] [bold yellow]init-context update[/] [dim]to sync modularly without breaking local context.[/]",
+            border_style="cyan",
+            title="[bold yellow]✨ Upstream Sync[/]",
+        ))
+    except Exception:
+        # Never fail user command due to notification error
+        pass
+
+
+# ── Modular Update Implementations ───────────────────────────────────────────
+
+def update_cli_package() -> bool:
+    """Upgrade the auto-context-cli package using the user's active environment."""
+    console.print("  [cyan][*] Upgrading auto-context-cli package...[/]")
+
+    # 1. uv tool upgrade
+    if shutil.which("uv"):
+        try:
+            res = subprocess.run(["uv", "tool", "upgrade", config.PYPI_PACKAGE], capture_output=True, text=True)
+            if res.returncode == 0:
+                console.print(f"  [green][✓] Upgraded via uv tool:[/] {config.PYPI_PACKAGE}")
+                return True
+        except Exception:
+            pass
+
+    # 2. pipx upgrade
+    if shutil.which("pipx"):
+        try:
+            res = subprocess.run(["pipx", "upgrade", config.PYPI_PACKAGE], capture_output=True, text=True)
+            if res.returncode == 0:
+                console.print(f"  [green][✓] Upgraded via pipx:[/] {config.PYPI_PACKAGE}")
+                return True
+        except Exception:
+            pass
+
+    # 3. pip fallback
+    try:
+        res = subprocess.run(
+            [sys.executable, "-m", "pip", "install", "--upgrade", config.PYPI_PACKAGE],
+            capture_output=True, text=True
+        )
+        if res.returncode == 0:
+            console.print(f"  [green][✓] Upgraded via pip:[/] {config.PYPI_PACKAGE}")
+            return True
+        else:
+            console.print(f"  [yellow][!] pip upgrade notice:[/] {res.stderr.strip()[:100]}")
+    except Exception as e:
+        console.print(f"  [yellow][!] Could not auto-upgrade CLI package:[/] {e}")
+
+    return False
+
+
+def _download_text(url: str, timeout: float = 4.0) -> Optional[str]:
+    """Download raw text file from remote repository."""
+    try:
+        req = urllib.request.Request(url, headers={"User-Agent": "auto-context-cli"})
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            return resp.read().decode("utf-8")
+    except Exception:
+        return None
+
+
+def update_global_plugin() -> int:
+    """
+    Sync upstream public rules and plugin definitions into ~/.gemini/config/plugins/auto-context/.
+    Preserves all existing user-defined custom rules and private skills.
+    """
+    console.print(f"  [cyan][*] Syncing Global AI Plugin:[/] {config.GLOBAL_PLUGIN_DIR}")
+    updated_count = 0
+
+    plugin_dir = config.GLOBAL_PLUGIN_DIR
+    rules_dir = plugin_dir / "rules"
+    skills_dir = plugin_dir / "skills" / "auto-context"
+
+    try:
+        rules_dir.mkdir(parents=True, exist_ok=True)
+        skills_dir.mkdir(parents=True, exist_ok=True)
+    except PermissionError:
+        console.print(f"  [yellow][!] Sandbox notice: Permission denied creating {plugin_dir}. Run in host terminal.[/]")
+        return 0
+
+    # Sync core plugin files from upstream repository
+    core_files = [
+        ("plugin.json", plugin_dir / "plugin.json"),
+        ("plugin/rules/AGENTS.md", rules_dir / "AGENTS.md"),
+        ("plugin/skills/auto-context/SKILL.md", skills_dir / "SKILL.md"),
+    ]
+
+    for rel_path, dest_path in core_files:
+        url = f"{config.RAW_GITHUB_BASE}/{rel_path}"
+        content = _download_text(url)
+        if content:
+            dest_path.write_text(content, encoding="utf-8")
+            console.print(f"  [green][✓] Updated public definition:[/] {dest_path.name}")
+            updated_count += 1
+        else:
+            # Fallback to locally bundled templates if offline
+            tmpl_dir = config.get_templates_dir()
+            fallback_map = {
+                "AGENTS.md": tmpl_dir / "AGENTS.template.md",
+                "SKILL.md": tmpl_dir / "skill.template.md",
+            }
+            if dest_path.name in fallback_map and fallback_map[dest_path.name].exists():
+                shutil.copy2(fallback_map[dest_path.name], dest_path)
+                console.print(f"  [green][✓] Restored from bundled template:[/] {dest_path.name}")
+                updated_count += 1
+
+    return updated_count
+
+
+def update_workspace(target_dir: Path, force: bool = False) -> int:
+    """
+    Safely update system-managed standing rules in the current project workspace.
+    
+    NON-BREAKING SAFETY GUARANTEES:
+    - NEVER touches context.md (preserves project architecture, credentials & problem log).
+    - NEVER touches context.local.md or .env (zero test credential or secret loss).
+    - NEVER touches custom user rules in .agents/rules/*.md.
+    - Only updates system standing rules (maintain_context.md, AGENTS.md, GEMINI.md).
+    """
+    console.print(f"  [cyan][*] Updating workspace system rules:[/] {target_dir.name}")
+    updated_count = 0
+    templates = config.get_templates_dir()
+
+    # System-managed files to refresh
+    system_rules = [
+        (templates / "maintain_context.template.md", target_dir / config.AGENTS_SUBDIR / "rules" / "maintain_context.md"),
+        (templates / "AGENTS.template.md", target_dir / "AGENTS.md"),
+        (templates / "GEMINI.template.md", target_dir / "GEMINI.md"),
+    ]
+
+    variables = {
+        "PROJECT_NAME": target_dir.name,
+        "PROJECT_DIR": str(target_dir),
+    }
+
+    for tmpl_path, dest_path in system_rules:
+        if not tmpl_path.exists():
+            continue
+
+        content = tmpl_path.read_text(encoding="utf-8")
+        for k, v in variables.items():
+            content = content.replace(f"{{{{{k}}}}}", v)
+
+        if dest_path.exists() and not force:
+            existing = dest_path.read_text(encoding="utf-8")
+            if existing == content:
+                console.print(f"  [dim]— Up to date:[/] {dest_path.name}")
+                continue
+
+            # Backup modified file if different
+            bak_path = dest_path.with_suffix(".md.bak")
+            shutil.copy2(dest_path, bak_path)
+            console.print(f"  [yellow][*] Backed up customized file:[/] {bak_path.name}")
+
+        dest_path.parent.mkdir(parents=True, exist_ok=True)
+        dest_path.write_text(content, encoding="utf-8")
+        console.print(f"  [green][✓] Updated system rule:[/] {dest_path.name}")
+        updated_count += 1
+
+    return updated_count
+
+
+# ── CLI update Command ────────────────────────────────────────────────────────
+
+def update(
+    workspace: Annotated[bool, typer.Option("--workspace", "-w", help="Update managed system rules in active project.")] = False,
+    global_: Annotated[bool, typer.Option("--global", "-g", help="Update global plugin and public rules only.")] = False,
+    cli: Annotated[bool, typer.Option("--cli", "-c", help="Upgrade auto-context-cli package only.")] = False,
+    check: Annotated[bool, typer.Option("--check", help="Check for available updates without modifying files.")] = False,
+    force: Annotated[bool, typer.Option("--force", "-f", help="Force overwrite without creating backups.")] = False,
+    target: Annotated[Optional[Path], typer.Option("--target", "-t", help="Target project directory.")] = None,
+) -> None:
+    """
+    Safely update auto-context CLI, public rulebooks, and global agent plugins.
+
+    Guaranteed Non-Breaking:
+    - Never modifies context.md, context.local.md, or .env.
+    - Never overwrites custom user-created rules or private skills.
+    - Seamlessly pulls new upstream guidelines and capabilities.
+    """
+    console.print(Panel(
+        "[bold cyan]🔄 Auto-Context: Modular Upstream Sync & Updater[/]\n"
+        f"[dim]Upstream Repository: https://github.com/{config.GITHUB_REPO}[/]",
+        border_style="cyan",
+    ))
+
+    # 1. Check upstream status
+    status = get_cached_update_status(force_check=True)
+    cur = get_installed_version()
+    latest = status.get("latest_version", cur) if status else cur
+    has_update = status.get("update_available", False) if status else False
+
+    console.print(f"  [yellow]Installed Version:[/] v{cur}")
+    console.print(f"  [cyan]Upstream Version: [/] v{latest}")
+    if has_update:
+        console.print(f"  [bold green]✨ New version available:[/] v{latest}")
+    else:
+        console.print("  [green][✓] You are running the latest version.[/]")
+
+    if check:
+        # Check-only mode ends here
+        console.print("\n[dim]Run 'init-context update' to apply updates.[/]\n")
+        return
+
+    console.print()
+
+    # Determine what to update
+    all_selected = not (workspace or global_ or cli)
+    project_dir = (target or Path.cwd()).resolve()
+    has_project_context = (project_dir / "context.md").exists() or (project_dir / config.AGENTS_SUBDIR).exists()
+
+    # Step A: Upgrade CLI Package
+    if all_selected or cli:
+        update_cli_package()
+
+    # Step B: Sync Global Plugin & Public Rules
+    if all_selected or global_:
+        update_global_plugin()
+
+    # Step C: Workspace System Rules
+    if (all_selected and has_project_context) or workspace:
+        update_workspace(project_dir, force=force)
+
+    # Invalidate cache so notification disappears after successful update
+    if config.UPDATE_CACHE_FILE.exists():
+        try:
+            config.UPDATE_CACHE_FILE.unlink()
+        except Exception:
+            pass
+
+    console.print(Panel(
+        "[bold green]✨ Modular update completed successfully![/]\n"
+        "[white]• Custom user rules & private skills: [green]Untouched (Safe)[/]\n"
+        "• Project context.md & credentials:   [green]Untouched (Zero Data Loss)[/]\n"
+        "• Global plugin & system rules:       [bold green]Synchronized[/]",
+        border_style="green",
+    ))

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/config.py

@@ -63,3 +63,31 @@ STACK_INDICATORS: list[tuple[str, str, str]] = [
 GIT_COMMIT_INIT = "feat(memory): initialize central agent brain knowledge base"
 GIT_COMMIT_SYNC = "chore(memory): sync agent brain knowledge base"
 
+# ── Update & Upstream Configuration ──────────────────────────────────────────
+GITHUB_REPO = "Cyber-arghya/auto-context"
+PYPI_PACKAGE = "auto-context-cli"
+RAW_GITHUB_BASE = "https://raw.githubusercontent.com/Cyber-arghya/auto-context/main"
+PYPI_JSON_URL = f"https://pypi.org/pypi/{PYPI_PACKAGE}/json"
+GITHUB_LATEST_RELEASE_URL = f"https://api.github.com/repos/{GITHUB_REPO}/releases/latest"
+
+import tempfile
+
+def get_cache_dir() -> Path:
+    """Return user cache directory, falling back to tempdir if permission restricted."""
+    try:
+        p = HOME / ".auto-context" / "cache"
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+    except Exception:
+        p = Path(tempfile.gettempdir()) / "auto-context-cache"
+        try:
+            p.mkdir(parents=True, exist_ok=True)
+        except Exception:
+            pass
+        return p
+
+CACHE_DIR: Path = get_cache_dir()
+UPDATE_CACHE_FILE: Path = CACHE_DIR / "update_check.json"
+UPDATE_CHECK_INTERVAL: int = 86400  # 24 hours in seconds
+
+

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/main.py

@@ -11,7 +11,7 @@ from typing import Annotated, Optional
 import typer
 from rich.console import Console
 
-from auto_context.commands import init_cmd, memory, mcp, share, import_cmd
+from auto_context.commands import init_cmd, memory, mcp, share, import_cmd, update_cmd
 
 app = typer.Typer(
     name="init-context",
@@ -32,6 +32,7 @@ app.command("skill")(init_cmd.new_skill)
 app.command("promote")(init_cmd.promote)
 app.command("share")(share.share)
 app.command("import")(import_cmd.import_item)
+app.command("update")(update_cmd.update)
 
 
 @app.callback(invoke_without_command=True)
@@ -119,4 +120,15 @@ def main() -> None:  # pragma: no cover
             sys.stderr.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[union-attr]
         except AttributeError:
             pass
-    app()
+
+    try:
+        app()
+    except SystemExit as e:
+        if e.code == 0 and not any(arg in sys.argv for arg in ("--version", "-v", "update", "--help", "-h")):
+            update_cmd.maybe_notify_update()
+        raise
+    except Exception:
+        raise
+    else:
+        if not any(arg in sys.argv for arg in ("--version", "-v", "update", "--help", "-h")):
+            update_cmd.maybe_notify_update()

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/templates/AGENTS.template.md

@@ -32,6 +32,7 @@ You have native access to run `init-context` via terminal commands:
 - `init-context`: Scaffolds or repairs project context.
 - `init-context -r <rule-name> [-g]`: Creates a new rule with frontmatter.
 - `init-context -s <skill-name> [-g]`: Creates a new skill with frontmatter.
+- `init-context update`: Safely syncs public rules and upstream capabilities (non-breaking).
 - `init-context memory push`: Synchronizes central brain memory to private Git repository.
 
 ### 4. Required Content & Structure in `context.md`

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/templates/GEMINI.template.md

@@ -32,6 +32,7 @@ You have native access to run `init-context` via terminal commands:
 - `init-context`: Scaffolds or repairs project context.
 - `init-context -r <rule-name> [-g]`: Creates a new rule with frontmatter.
 - `init-context -s <skill-name> [-g]`: Creates a new skill with frontmatter.
+- `init-context update`: Safely syncs public rules and upstream capabilities (non-breaking).
 - `init-context memory push`: Synchronizes central brain memory to private Git repository.
 
 ### 4. Required Content & Structure in `context.md`

{auto_context_cli-1.0.1 → auto_context_cli-1.0.2}/src/auto_context/templates/maintain_context.template.md

@@ -22,6 +22,7 @@ trigger: always_on
      - `init-context`: Initialize/repair context.
      - `init-context -r <name> [-g]`: Create rule.
      - `init-context -s <name> [-g]`: Create skill.
+     - `init-context update`: Safely sync public rules and upstream capabilities (non-breaking).
      - `init-context memory push`: Push updates to central memory.
 
 4. **No User Reminder Needed**: The user must never need to ask the agent to update `context.md` or learn rules. This is a strict automated post-condition for all actions.