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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: auto-context-cli
-Version: 1.0.0
+Version: 1.0.1
 Summary: Autonomous context & instruction manager for AI coding assistants
 Author: Arghya Biswas
 License: MIT
@@ -18,10 +18,12 @@ Description-Content-Type: text/markdown
 
 **Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
 
+[![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)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Platform](https://img.shields.io/badge/Platform-Windows%20PowerShell%20%7C%20Linux%20WSL2%20%7C%20macOS-success.svg)](#-quick-one-line-install)
+[![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)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Cyber-arghya/auto-context/pulls)
 
 *Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
 
@@ -33,19 +35,26 @@ Description-Content-Type: text/markdown
 
 ## ⚡ Quick One-Line Install
 
-No manual downloads or complex PATH configurations required. Run the command matching your terminal:
+No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
 
-### 📦 Universal via `uv` (Fastest, Windows / Mac / Linux / WSL2):
+### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
 ```bash
-uv tool install git+https://github.com/Cyber-arghya/auto-context.git
+# Recommended via uv (fast & isolated):
+uv tool install auto-context-cli
+
+# Or via standard pip:
+pip install auto-context-cli
+
+# Or via pipx:
+pipx install auto-context-cli
 ```
 
-### 🪟 Windows (PowerShell / `pwsh` 1-Click):
+### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
 ```powershell
 irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
 ```
 
-### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
+### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
 ```bash
 curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
 ```
@@ -184,6 +193,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
 | **Rule** | Behavioral constraints, coding standards, security boundaries, or test requirements. | Always active (`trigger: always_on`) or context-triggered. | `.agents/rules/<name>.md` or `GEMINI.md` |
 | **Skill** | Step-by-step procedures, deployment runbooks, debugging steps, or CLI tool guides. | Activated on-demand when relevant task is requested. | `.agents/skills/<name>/SKILL.md` |
 
+> [!IMPORTANT]
+> **Core Directives for AI Coding Agents:**
+> - **Zero Token Waste:** DO NOT burn tokens manually searching directories or reading files to check for existing rules. Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
+> - **Mandatory Global Scope:** When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
+
 ---
 
 ### 1️⃣ How to Add a New Rule
@@ -454,11 +468,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
 3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
 
 ### ইনস্টলেশন ও ব্যবহার:
-* **উইন্ডোজ পাওয়ারশেল (PowerShell)-এ:**
+* **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
+  ```bash
+  pip install auto-context-cli
+  # অথবা uv দিয়ে:
+  uv tool install auto-context-cli
+  ```
+* **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
   ```powershell
   irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
   ```
-* **লিনাক্স / WSL2-এ:**
+* **লিনাক্স / WSL2 / macOS (1-Click Installer):**
   ```bash
   curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
   ```
@@ -470,6 +490,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
   ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
 
 ### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
+> [!IMPORTANT]
+> **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
+> - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
+> - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
 * **নতুন রুল (Rule) তৈরি করতে:**
   ```bash
   init-context -r my-rule-name       # বর্তমান প্রজেক্টের জন্য

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

@@ -4,10 +4,12 @@
 
 **Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
 
+[![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)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Platform](https://img.shields.io/badge/Platform-Windows%20PowerShell%20%7C%20Linux%20WSL2%20%7C%20macOS-success.svg)](#-quick-one-line-install)
+[![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)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Cyber-arghya/auto-context/pulls)
 
 *Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
 
@@ -19,19 +21,26 @@
 
 ## ⚡ Quick One-Line Install
 
-No manual downloads or complex PATH configurations required. Run the command matching your terminal:
+No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
 
-### 📦 Universal via `uv` (Fastest, Windows / Mac / Linux / WSL2):
+### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
 ```bash
-uv tool install git+https://github.com/Cyber-arghya/auto-context.git
+# Recommended via uv (fast & isolated):
+uv tool install auto-context-cli
+
+# Or via standard pip:
+pip install auto-context-cli
+
+# Or via pipx:
+pipx install auto-context-cli
 ```
 
-### 🪟 Windows (PowerShell / `pwsh` 1-Click):
+### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
 ```powershell
 irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
 ```
 
-### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
+### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
 ```bash
 curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
 ```
@@ -170,6 +179,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
 | **Rule** | Behavioral constraints, coding standards, security boundaries, or test requirements. | Always active (`trigger: always_on`) or context-triggered. | `.agents/rules/<name>.md` or `GEMINI.md` |
 | **Skill** | Step-by-step procedures, deployment runbooks, debugging steps, or CLI tool guides. | Activated on-demand when relevant task is requested. | `.agents/skills/<name>/SKILL.md` |
 
+> [!IMPORTANT]
+> **Core Directives for AI Coding Agents:**
+> - **Zero Token Waste:** DO NOT burn tokens manually searching directories or reading files to check for existing rules. Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
+> - **Mandatory Global Scope:** When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
+
 ---
 
 ### 1️⃣ How to Add a New Rule
@@ -440,11 +454,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
 3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
 
 ### ইনস্টলেশন ও ব্যবহার:
-* **উইন্ডোজ পাওয়ারশেল (PowerShell)-এ:**
+* **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
+  ```bash
+  pip install auto-context-cli
+  # অথবা uv দিয়ে:
+  uv tool install auto-context-cli
+  ```
+* **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
   ```powershell
   irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
   ```
-* **লিনাক্স / WSL2-এ:**
+* **লিনাক্স / WSL2 / macOS (1-Click Installer):**
   ```bash
   curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
   ```
@@ -456,6 +476,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
   ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
 
 ### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
+> [!IMPORTANT]
+> **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
+> - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
+> - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
 * **নতুন রুল (Rule) তৈরি করতে:**
   ```bash
   init-context -r my-rule-name       # বর্তমান প্রজেক্টের জন্য

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

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

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

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

{auto_context_cli-1.0.0 → auto_context_cli-1.0.1}/src/auto_context/commands/init_cmd.py

@@ -307,3 +307,44 @@ def new_skill(
         f"[green]   File: [/] {dest_file}",
         border_style="cyan",
     ))
+
+
+# ── promote command ───────────────────────────────────────────────────────────
+
+def promote(
+    name: Annotated[str, typer.Argument(help="Rule or skill name to promote to Central Memory.")],
+    target: Annotated[Optional[Path], typer.Option("--target", "-t")] = None,
+) -> None:
+    """Promote a local workspace rule or skill to Central Memory and global scope."""
+    project_dir = (target or Path.cwd()).resolve()
+    clean_name = name.lower().replace(" ", "-").replace("_", "-").removesuffix(".md")
+
+    local_rule = project_dir / AGENTS_SUBDIR / "rules" / f"{clean_name}.md"
+    local_skill = project_dir / AGENTS_SUBDIR / "skills" / clean_name / "SKILL.md"
+
+    promoted = False
+    if local_rule.exists():
+        content = local_rule.read_text(encoding="utf-8")
+        (config.GLOBAL_PLUGIN_DIR / "rules").mkdir(parents=True, exist_ok=True)
+        (config.GLOBAL_PLUGIN_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
+        if config.MEMORY_DIR.exists():
+            (config.MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
+            (config.MEMORY_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
+        console.print(f"[bold green][✓] Promoted local rule '{clean_name}' to Global Plugin and Central Memory![/]")
+        promoted = True
+
+    if local_skill.exists():
+        content = local_skill.read_text(encoding="utf-8")
+        (config.GLOBAL_PLUGIN_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
+        (config.GLOBAL_PLUGIN_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
+        if config.MEMORY_DIR.exists():
+            (config.MEMORY_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
+            (config.MEMORY_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
+        console.print(f"[bold green][✓] Promoted local skill '{clean_name}' to Global Plugin and Central Memory![/]")
+        promoted = True
+
+    if not promoted:
+        console.print(f"[red][✗] Rule or skill '{clean_name}' not found in local workspace ({project_dir}).[/]")
+        raise typer.Exit(1)
+
+    console.print("   [cyan]💡 Run 'init-context memory push' to push changes to your private GitHub repo.[/]\n")

auto_context_cli-1.0.1/src/auto_context/commands/memory.py

@@ -0,0 +1,320 @@
+"""
+commands/memory.py — Central memory brain management.
+
+Wraps git CLI via subprocess.run. Runs security.audit_path()
+before every commit or push — zero-bypass hard-block.
+
+Subcommands: init, push, pull, status
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+from datetime import datetime
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+from auto_context import config, security
+
+app = typer.Typer(help="Central memory brain management.")
+console = Console()
+
+MEMORY_DIR = config.MEMORY_DIR
+
+_GITIGNORE_ENTRIES = """\
+# Security: Prohibit credentials and environment files from central memory
+.env
+.env.*
+*.local.md
+context.local.md
+*.key
+*.pem
+*.p12
+*.pfx
+*.kdbx
+id_rsa*
+id_ed25519*
+id_ecdsa*
+id_dsa*
+authorized_keys
+known_hosts
+"""
+
+
+def _git(cwd: Path, *args: str, check: bool = True) -> subprocess.CompletedProcess:
+    """Run a git command in *cwd*, capturing output."""
+    return subprocess.run(
+        ["git", "-C", str(cwd), *args],
+        capture_output=True,
+        text=True,
+        check=check,
+    )
+
+
+def _has_gh() -> bool:
+    return shutil.which("gh") is not None
+
+
+# ── init ──────────────────────────────────────────────────────────────────────
+
+@app.command("init")
+def memory_init(
+    repo_name: Annotated[str, typer.Argument(help="GitHub repo name.")] = "auto-context-memory",
+) -> None:
+    """Initialize a private central memory brain repository."""
+    console.print(Panel(
+        f"[bold green]🧠 Initializing Private Central Memory Brain[/]\n"
+        f"[yellow]   Directory:[/] {MEMORY_DIR}\n"
+        f"[cyan]   Repo:     [/] {repo_name} (Strictly Private)",
+        border_style="cyan",
+    ))
+
+    (MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
+    (MEMORY_DIR / "skills").mkdir(parents=True, exist_ok=True)
+
+    # Init git repo
+    if not (MEMORY_DIR / ".git").exists():
+        _git(MEMORY_DIR, "init")
+        console.print("  [green][✓] Initialized Git repository[/]")
+
+    # Hardened .gitignore
+    (MEMORY_DIR / ".gitignore").write_text(_GITIGNORE_ENTRIES, encoding="utf-8")
+    console.print("  [green][✓] Hardened .gitignore written[/]")
+
+    # profile.md
+    _write_profile(repo_name)
+
+    # Security audit before first commit
+    console.print("  [cyan][*] Running pre-commit security audit...[/]")
+    violations = security.audit_path(MEMORY_DIR)
+    security.abort_if_violations(violations)
+
+    _git(MEMORY_DIR, "add", "-A", check=False)
+    _git(MEMORY_DIR, "commit", "-m", config.GIT_COMMIT_INIT, check=False)
+    _git(MEMORY_DIR, "branch", "-M", "main", check=False)
+
+    if _has_gh():
+        console.print("  [cyan][*] Creating strictly private GitHub repository via gh...[/]")
+        result = subprocess.run(
+            ["gh", "repo", "create", repo_name,
+             "--private", f"--source={MEMORY_DIR}", "--remote=origin", "--push"],
+            capture_output=True, text=True,
+        )
+        if result.returncode == 0:
+            console.print("  [green][✓] Private GitHub memory repository created and pushed![/]")
+        else:
+            _print_manual_push(repo_name)
+    else:
+        console.print("  [yellow][!] GitHub CLI ('gh') not found. Install it or connect manually:[/]")
+        _print_manual_push(repo_name)
+
+    console.print(f"\n[bold green]🎉 Central Memory Initialized![/]")
+    console.print(f"   [yellow]Local Brain:[/]  {MEMORY_DIR}")
+    console.print(f"   [green]Sync Command:[/] init-context memory push\n")
+
+
+def _print_manual_push(repo_name: str) -> None:
+    console.print(f"   [dim]git -C \"{MEMORY_DIR}\" remote add origin git@github.com:<username>/{repo_name}.git[/]")
+    console.print(f"   [dim]git -C \"{MEMORY_DIR}\" push -u origin main[/]")
+
+
+def _write_profile(repo_name: str) -> None:
+    profile = MEMORY_DIR / "profile.md"
+    if profile.exists():
+        return
+    import getpass
+    username = getpass.getuser()
+    date_now = datetime.now().strftime("%Y-%m-%d")
+    profile.write_text(
+        f"# Agent Memory & Developer Profile\n\n"
+        f"> **Owner:** {username}  \n"
+        f"> **Initialized:** {date_now}  \n"
+        f"> **Repository:** {repo_name}  \n"
+        f"> **Visibility:** Private Central Agent Brain  \n\n---\n\n"
+        f"## 1. Developer Preferences\n- Edit this file to personalise agent behaviour.\n\n"
+        f"## 2. Central Knowledge Base Index\n"
+        f"- **Global Rules:** `rules/`\n"
+        f"- **Reusable Skills:** `skills/`\n",
+        encoding="utf-8",
+    )
+    console.print("  [green][✓] Generated Developer Profile: profile.md[/]")
+
+
+# ── local harvester ─────────────────────────────────────────────────────────
+
+def _sync_local_to_memory(project_dir: Path) -> int:
+    """Harvest newly created local project rules & skills into central memory."""
+    harvested = 0
+    try:
+        local_rules = project_dir / config.AGENTS_SUBDIR / "rules"
+        if local_rules.exists():
+            (MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
+            for rfile in local_rules.glob("*.md"):
+                # Skip standard default boilerplates from polluting memory if already synced
+                dest = MEMORY_DIR / "rules" / rfile.name
+                if not dest.exists():
+                    shutil.copy2(rfile, dest)
+                    harvested += 1
+                    console.print(f"  [green][✓] Harvested local rule to Central Memory:[/] {rfile.name}")
+                elif rfile.stat().st_mtime > dest.stat().st_mtime:
+                    shutil.copy2(rfile, dest)
+                    harvested += 1
+                    console.print(f"  [green][✓] Updated local rule in Central Memory:[/] {rfile.name}")
+
+        local_skills = project_dir / config.AGENTS_SUBDIR / "skills"
+        if local_skills.exists():
+            (MEMORY_DIR / "skills").mkdir(parents=True, exist_ok=True)
+            for sdir in local_skills.iterdir():
+                if sdir.is_dir() and (sdir / "SKILL.md").exists():
+                    dest_dir = MEMORY_DIR / "skills" / sdir.name
+                    dest_file = dest_dir / "SKILL.md"
+                    src_file = sdir / "SKILL.md"
+                    if not dest_file.exists() or src_file.stat().st_mtime > dest_file.stat().st_mtime:
+                        dest_dir.mkdir(parents=True, exist_ok=True)
+                        shutil.copy2(src_file, dest_file)
+                        harvested += 1
+                        console.print(f"  [green][✓] Harvested local skill to Central Memory:[/] {sdir.name}")
+    except OSError:
+        pass
+    return harvested
+
+
+# ── push ──────────────────────────────────────────────────────────────────────
+
+@app.command("push")
+def memory_push(
+    harvest: Annotated[bool, typer.Option("--harvest/--no-harvest", "-h/-n", help="Auto-harvest local workspace rules/skills into central memory.")] = True,
+) -> None:
+    """Audit secrets and push memory brain to private GitHub repo."""
+    console.print(Panel(
+        "[bold green]🧠 Synchronizing Central Memory Brain[/]\n"
+        f"[yellow]   Location:[/] {MEMORY_DIR}",
+        border_style="cyan",
+    ))
+
+    try:
+        if not MEMORY_DIR.exists():
+            console.print(f"[red][✗] Memory directory not found:[/] {MEMORY_DIR}")
+            console.print("    Run: [cyan]init-context memory init[/]")
+            raise typer.Exit(1)
+
+        # Harvest local rules/skills if in a project directory
+        if harvest:
+            _sync_local_to_memory(Path.cwd().resolve())
+
+        console.print("  [cyan][*] Running Zero-Bypass Security Auditor...[/]")
+        violations = security.audit_path(MEMORY_DIR)
+        security.abort_if_violations(violations)
+
+        timestamp = datetime.now().strftime("%Y-%m-%d %H:%M")
+        _git(MEMORY_DIR, "add", "-A", check=False)
+        _git(MEMORY_DIR, "commit", "-m", f"{config.GIT_COMMIT_SYNC} [{timestamp}]", check=False)
+
+        remote = _git(MEMORY_DIR, "remote", "get-url", "origin", check=False).stdout.strip()
+        if remote:
+            console.print("  [cyan][*] Pushing to private remote repository...[/]")
+            result = _git(MEMORY_DIR, "push", "origin", "main", check=False)
+            if result.returncode == 0:
+                console.print("  [green][✓] Memory brain pushed successfully![/]")
+            else:
+                console.print(f"  [red][✗] Push failed:[/] {result.stderr.strip()}")
+        else:
+            console.print("  [yellow][!] No remote 'origin' configured. Run memory init first.[/]")
+
+        console.print("\n[bold green]✨ Memory synchronization complete![/]\n")
+
+    except PermissionError as pe:
+        console.print(Panel(
+            f"[bold red][✗] Permission Denied Accessing Central Memory[/]\n"
+            f"[yellow]   Path:[/] {MEMORY_DIR}\n\n"
+            f"[white]   Cause:[/] Running inside a restricted sandbox without host filesystem access.\n"
+            f"[cyan]   Fix:[/] Run this command in your external terminal (PowerShell / Bash), or enable unsandboxed mode.",
+            border_style="red",
+        ))
+        raise typer.Exit(1)
+    except OSError as err:
+        console.print(f"[red][✗] Central memory error:[/] {err}")
+        raise typer.Exit(1)
+
+
+# ── pull ──────────────────────────────────────────────────────────────────────
+
+@app.command("pull")
+def memory_pull(
+    repo_url: Annotated[Optional[str], typer.Argument(help="Remote repo URL (required for first pull).")] = None,
+) -> None:
+    """Pull and sync the central memory brain from remote."""
+    console.print(Panel(
+        "[bold green]🧠 Pulling Central Memory Brain[/]",
+        border_style="cyan",
+    ))
+
+    try:
+        if not MEMORY_DIR.exists():
+            if not repo_url:
+                console.print("[red][✗] Memory directory not found. Provide a repo URL:[/]")
+                console.print("    [cyan]init-context memory pull <url>[/]")
+                raise typer.Exit(1)
+            subprocess.run(["git", "clone", repo_url, str(MEMORY_DIR)], check=True)
+        else:
+            _git(MEMORY_DIR, "pull", "origin", "main")
+
+        console.print("  [cyan][*] Running post-pull security audit...[/]")
+        violations = security.audit_path(MEMORY_DIR)
+        security.abort_if_violations(violations)
+        console.print("\n[bold green]✨ Central memory updated successfully![/]\n")
+
+    except PermissionError as pe:
+        console.print(Panel(
+            f"[bold red][✗] Permission Denied Accessing Central Memory[/]\n"
+            f"[yellow]   Path:[/] {MEMORY_DIR}\n\n"
+            f"[white]   Fix:[/] Run in external terminal or enable unsandboxed execution mode.",
+            border_style="red",
+        ))
+        raise typer.Exit(1)
+
+
+# ── status ────────────────────────────────────────────────────────────────────
+
+@app.command("status")
+def memory_status() -> None:
+    """Show status of the central memory brain."""
+    console.print(Panel(
+        "[bold green]🧠 Central Memory Status[/]",
+        border_style="cyan",
+    ))
+
+    try:
+        if not MEMORY_DIR.exists():
+            console.print("  [yellow][!] Central memory not initialized.[/]")
+            console.print("      Run: [cyan]init-context memory init[/]")
+            return
+
+        remote = _git(MEMORY_DIR, "remote", "get-url", "origin", check=False).stdout.strip()
+        rules_path = MEMORY_DIR / "rules"
+        skills_path = MEMORY_DIR / "skills"
+
+        rules_count = len(list(rules_path.glob("*.md"))) if rules_path.exists() else 0
+        skills_count = len([d for d in skills_path.iterdir() if d.is_dir()]) if skills_path.exists() else 0
+
+        console.print(f"  [yellow]Location:[/] {MEMORY_DIR}")
+        console.print(f"  [cyan]Remote:  [/] {remote or '(none)'}")
+        console.print(f"  [green]Rules:   [/] {rules_count} registered")
+        console.print(f"  [green]Skills:  [/] {skills_count} registered")
+        console.print()
+
+    except PermissionError:
+        console.print(Panel(
+            f"[bold red][✗] Permission Denied Accessing Central Memory[/]\n"
+            f"[yellow]   Path:[/] {MEMORY_DIR}\n\n"
+            f"[white]   Cause:[/] Sandboxed IDE terminal lacks access to host directory ~/.auto-context.\n"
+            f"[cyan]   Fix:[/] Run 'init-context memory status' in your host terminal (PowerShell / Bash), or grant filesystem access.",
+            border_style="red",
+        ))
+    except OSError as err:
+        console.print(f"  [yellow][!] Central memory status warning:[/] {err}")
+

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

@@ -29,6 +29,7 @@ app.add_typer(mcp.app, name="mcp", help="MCP tool registry management.")
 app.command("init")(init_cmd.init)
 app.command("rule")(init_cmd.new_rule)
 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)
 
@@ -65,7 +66,7 @@ def root(
             try:
                 v = pkg_version("auto-context")
             except Exception:
-                v = "1.0.0"
+                v = "1.0.1"
         console.print(f"init-context v{v}")
         raise typer.Exit()
 

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

@@ -17,10 +17,12 @@ Whenever you learn a new pattern, receive a correction, observe a coding prefere
 1. **Identify the Type:**
    - **Rule:** If it is a constraint, coding standard, safety boundary, or architectural preference -> Create a Rule (`init-context -r <name>`).
    - **Skill:** If it is a multi-step procedure, deployment workflow, diagnosis runbook, or CLI sequence -> Create a Skill (`init-context -s <name>`).
-2. **Scope Decision:**
-   - **Project-Specific:** Save in `.agents/rules/` or `.agents/skills/`.
-   - **Machine-Wide / Global:** If it applies to all projects, use `--global` (`-g`) to register in `~/.gemini/config/plugins/auto-context/`.
-3. **Execution:**
+2. **Zero Token Waste:**
+   - **DO NOT burn tokens manually searching directories or reading files to check for existing rules.** Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
+3. **Mandatory Global Scope:**
+   - When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
+   - **Project-Specific:** Only omit `-g` if strictly confined to this specific project repository.
+4. **Execution:**
    - Use the `init-context` CLI tool to scaffold the file.
    - Populate it with clear objectives, constraints, or step-by-step instructions.
    - Inform the user of the new rule or skill codified.
@@ -30,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 memory push`: Synchronizes central brain memory to private Git repository.
 
 ### 4. Required Content & Structure in `context.md`
 1. **Master Credentials & Configuration Vault (Section 1):** Keep all ports, IPs, secrets, tokens, and endpoints synchronized.

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

@@ -17,10 +17,12 @@ Whenever you learn a new pattern, receive a correction, observe a coding prefere
 1. **Identify the Type:**
    - **Rule:** If it is a constraint, coding standard, safety boundary, or architectural preference -> Create a Rule (`init-context -r <name>`).
    - **Skill:** If it is a multi-step procedure, deployment workflow, diagnosis runbook, or CLI sequence -> Create a Skill (`init-context -s <name>`).
-2. **Scope Decision:**
-   - **Project-Specific:** Save in `.agents/rules/` or `.agents/skills/`.
-   - **Machine-Wide / Global:** If it applies to all projects, use `--global` (`-g`) to register in `~/.gemini/config/plugins/auto-context/`.
-3. **Execution:**
+2. **Zero Token Waste:**
+   - **DO NOT burn tokens manually searching directories or reading files to check for existing rules.** Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
+3. **Mandatory Global Scope:**
+   - When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
+   - **Project-Specific:** Only omit `-g` if strictly confined to this specific project repository.
+4. **Execution:**
    - Use the `init-context` CLI tool to scaffold the file.
    - Populate it with clear objectives, constraints, or step-by-step instructions.
    - Inform the user of the new rule or skill codified.
@@ -30,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 memory push`: Synchronizes central brain memory to private Git repository.
 
 ### 4. Required Content & Structure in `context.md`
 1. **Master Credentials & Configuration Vault (Section 1):** Keep all ports, IPs, secrets, tokens, and endpoints synchronized.

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

@@ -13,16 +13,16 @@ trigger: always_on
    - Architectural decisions or operational runbooks.
 
 2. **Autonomous Learning & Skill Crystallization**:
-   - Whenever a new pattern, user preference, architectural guideline, or multi-step procedure is discovered or instructed:
-     - Scaffolds a **Rule** (`init-context -r <name> [-g]`) if it is a constraint, coding standard, or guideline.
-     - Scaffolds a **Skill** (`init-context -s <name> [-g]`) if it is a multi-step procedure or deployment runbook.
-     - Populates the file with clear instructions and notifies the user.
+   - **Zero Token Waste:** DO NOT burn tokens manually searching directories or reading files to check for existing rules. Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
+   - **Mandatory Global Scope:** When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
+   - Populates the file with clear instructions and notifies the user.
 
 3. **CLI Tool Availability**:
    - The agent has full access to run `init-context` directly via terminal:
      - `init-context`: Initialize/repair context.
      - `init-context -r <name> [-g]`: Create rule.
      - `init-context -s <name> [-g]`: Create skill.
+     - `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.
 

auto_context_cli-1.0.0/src/auto_context/commands/memory.py

@@ -1,236 +0,0 @@
-"""
-commands/memory.py — Central memory brain management.
-
-Wraps git CLI via subprocess.run. Runs security.audit_path()
-before every commit or push — zero-bypass hard-block.
-
-Subcommands: init, push, pull, status
-"""
-from __future__ import annotations
-
-import shutil
-import subprocess
-from datetime import datetime
-from pathlib import Path
-from typing import Annotated, Optional
-
-import typer
-from rich.console import Console
-from rich.panel import Panel
-
-from auto_context import config, security
-
-app = typer.Typer(help="Central memory brain management.")
-console = Console()
-
-MEMORY_DIR = config.MEMORY_DIR
-
-_GITIGNORE_ENTRIES = """\
-# Security: Prohibit credentials and environment files from central memory
-.env
-.env.*
-*.local.md
-context.local.md
-*.key
-*.pem
-*.p12
-*.pfx
-*.kdbx
-id_rsa*
-id_ed25519*
-id_ecdsa*
-id_dsa*
-authorized_keys
-known_hosts
-"""
-
-
-def _git(cwd: Path, *args: str, check: bool = True) -> subprocess.CompletedProcess:
-    """Run a git command in *cwd*, capturing output."""
-    return subprocess.run(
-        ["git", "-C", str(cwd), *args],
-        capture_output=True,
-        text=True,
-        check=check,
-    )
-
-
-def _has_gh() -> bool:
-    return shutil.which("gh") is not None
-
-
-# ── init ──────────────────────────────────────────────────────────────────────
-
-@app.command("init")
-def memory_init(
-    repo_name: Annotated[str, typer.Argument(help="GitHub repo name.")] = "auto-context-memory",
-) -> None:
-    """Initialize a private central memory brain repository."""
-    console.print(Panel(
-        f"[bold green]🧠 Initializing Private Central Memory Brain[/]\n"
-        f"[yellow]   Directory:[/] {MEMORY_DIR}\n"
-        f"[cyan]   Repo:     [/] {repo_name} (Strictly Private)",
-        border_style="cyan",
-    ))
-
-    (MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
-    (MEMORY_DIR / "skills").mkdir(parents=True, exist_ok=True)
-
-    # Init git repo
-    if not (MEMORY_DIR / ".git").exists():
-        _git(MEMORY_DIR, "init")
-        console.print("  [green][✓] Initialized Git repository[/]")
-
-    # Hardened .gitignore
-    (MEMORY_DIR / ".gitignore").write_text(_GITIGNORE_ENTRIES, encoding="utf-8")
-    console.print("  [green][✓] Hardened .gitignore written[/]")
-
-    # profile.md
-    _write_profile(repo_name)
-
-    # Security audit before first commit
-    console.print("  [cyan][*] Running pre-commit security audit...[/]")
-    violations = security.audit_path(MEMORY_DIR)
-    security.abort_if_violations(violations)
-
-    _git(MEMORY_DIR, "add", "-A", check=False)
-    _git(MEMORY_DIR, "commit", "-m", config.GIT_COMMIT_INIT, check=False)
-    _git(MEMORY_DIR, "branch", "-M", "main", check=False)
-
-    if _has_gh():
-        console.print("  [cyan][*] Creating strictly private GitHub repository via gh...[/]")
-        result = subprocess.run(
-            ["gh", "repo", "create", repo_name,
-             "--private", f"--source={MEMORY_DIR}", "--remote=origin", "--push"],
-            capture_output=True, text=True,
-        )
-        if result.returncode == 0:
-            console.print("  [green][✓] Private GitHub memory repository created and pushed![/]")
-        else:
-            _print_manual_push(repo_name)
-    else:
-        console.print("  [yellow][!] GitHub CLI ('gh') not found. Install it or connect manually:[/]")
-        _print_manual_push(repo_name)
-
-    console.print(f"\n[bold green]🎉 Central Memory Initialized![/]")
-    console.print(f"   [yellow]Local Brain:[/]  {MEMORY_DIR}")
-    console.print(f"   [green]Sync Command:[/] init-context memory push\n")
-
-
-def _print_manual_push(repo_name: str) -> None:
-    console.print(f"   [dim]git -C \"{MEMORY_DIR}\" remote add origin git@github.com:<username>/{repo_name}.git[/]")
-    console.print(f"   [dim]git -C \"{MEMORY_DIR}\" push -u origin main[/]")
-
-
-def _write_profile(repo_name: str) -> None:
-    profile = MEMORY_DIR / "profile.md"
-    if profile.exists():
-        return
-    import getpass
-    username = getpass.getuser()
-    date_now = datetime.now().strftime("%Y-%m-%d")
-    profile.write_text(
-        f"# Agent Memory & Developer Profile\n\n"
-        f"> **Owner:** {username}  \n"
-        f"> **Initialized:** {date_now}  \n"
-        f"> **Repository:** {repo_name}  \n"
-        f"> **Visibility:** Private Central Agent Brain  \n\n---\n\n"
-        f"## 1. Developer Preferences\n- Edit this file to personalise agent behaviour.\n\n"
-        f"## 2. Central Knowledge Base Index\n"
-        f"- **Global Rules:** `rules/`\n"
-        f"- **Reusable Skills:** `skills/`\n",
-        encoding="utf-8",
-    )
-    console.print("  [green][✓] Generated Developer Profile: profile.md[/]")
-
-
-# ── push ──────────────────────────────────────────────────────────────────────
-
-@app.command("push")
-def memory_push() -> None:
-    """Audit secrets and push memory brain to private GitHub repo."""
-    console.print(Panel(
-        "[bold green]🧠 Synchronizing Central Memory Brain[/]\n"
-        f"[yellow]   Location:[/] {MEMORY_DIR}",
-        border_style="cyan",
-    ))
-
-    if not MEMORY_DIR.exists():
-        console.print(f"[red][✗] Memory directory not found:[/] {MEMORY_DIR}")
-        console.print("    Run: [cyan]init-context memory init[/]")
-        raise typer.Exit(1)
-
-    console.print("  [cyan][*] Running Zero-Bypass Security Auditor...[/]")
-    violations = security.audit_path(MEMORY_DIR)
-    security.abort_if_violations(violations)
-
-    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M")
-    _git(MEMORY_DIR, "add", "-A", check=False)
-    _git(MEMORY_DIR, "commit", "-m", f"{config.GIT_COMMIT_SYNC} [{timestamp}]", check=False)
-
-    remote = _git(MEMORY_DIR, "remote", "get-url", "origin", check=False).stdout.strip()
-    if remote:
-        console.print("  [cyan][*] Pushing to private remote repository...[/]")
-        result = _git(MEMORY_DIR, "push", "origin", "main", check=False)
-        if result.returncode == 0:
-            console.print("  [green][✓] Memory brain pushed successfully![/]")
-        else:
-            console.print(f"  [red][✗] Push failed:[/] {result.stderr.strip()}")
-    else:
-        console.print("  [yellow][!] No remote 'origin' configured. Run memory init first.[/]")
-
-    console.print("\n[bold green]✨ Memory synchronization complete![/]\n")
-
-
-# ── pull ──────────────────────────────────────────────────────────────────────
-
-@app.command("pull")
-def memory_pull(
-    repo_url: Annotated[Optional[str], typer.Argument(help="Remote repo URL (required for first pull).")] = None,
-) -> None:
-    """Pull and sync the central memory brain from remote."""
-    console.print(Panel(
-        "[bold green]🧠 Pulling Central Memory Brain[/]",
-        border_style="cyan",
-    ))
-
-    if not MEMORY_DIR.exists():
-        if not repo_url:
-            console.print("[red][✗] Memory directory not found. Provide a repo URL:[/]")
-            console.print("    [cyan]init-context memory pull <url>[/]")
-            raise typer.Exit(1)
-        subprocess.run(["git", "clone", repo_url, str(MEMORY_DIR)], check=True)
-    else:
-        _git(MEMORY_DIR, "pull", "origin", "main")
-
-    console.print("  [cyan][*] Running post-pull security audit...[/]")
-    violations = security.audit_path(MEMORY_DIR)
-    security.abort_if_violations(violations)
-    console.print("\n[bold green]✨ Central memory updated successfully![/]\n")
-
-
-# ── status ────────────────────────────────────────────────────────────────────
-
-@app.command("status")
-def memory_status() -> None:
-    """Show status of the central memory brain."""
-    console.print(Panel(
-        "[bold green]🧠 Central Memory Status[/]",
-        border_style="cyan",
-    ))
-
-    if not MEMORY_DIR.exists():
-        console.print("  [yellow][!] Central memory not initialized.[/]")
-        console.print("      Run: [cyan]init-context memory init[/]")
-        return
-
-    remote = _git(MEMORY_DIR, "remote", "get-url", "origin", check=False).stdout.strip()
-    rules_count = len(list((MEMORY_DIR / "rules").glob("*.md"))) if (MEMORY_DIR / "rules").exists() else 0
-    skills_count = len([d for d in (MEMORY_DIR / "skills").iterdir() if d.is_dir()]) if (MEMORY_DIR / "skills").exists() else 0
-
-    console.print(f"  [yellow]Location:[/] {MEMORY_DIR}")
-    console.print(f"  [cyan]Remote:  [/] {remote or '(none)'}")
-    console.print(f"  [green]Rules:   [/] {rules_count} registered")
-    console.print(f"  [green]Skills:  [/] {skills_count} registered")
-    console.print()
-