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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/PKG-INFO +85 -10
  2. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/README.md +84 -9
  3. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/pyproject.toml +1 -1
  4. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/__init__.py +1 -1
  5. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/init_cmd.py +41 -0
  6. auto_context_cli-1.0.2/src/auto_context/commands/memory.py +320 -0
  7. auto_context_cli-1.0.2/src/auto_context/commands/update_cmd.py +392 -0
  8. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/config.py +28 -0
  9. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/main.py +16 -3
  10. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/AGENTS.template.md +8 -4
  11. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/GEMINI.template.md +8 -4
  12. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/maintain_context.template.md +5 -4
  13. auto_context_cli-1.0.0/src/auto_context/commands/memory.py +0 -236
  14. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/.gitignore +0 -0
  15. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/LICENSE +0 -0
  16. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/__init__.py +0 -0
  17. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/import_cmd.py +0 -0
  18. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/mcp.py +0 -0
  19. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/share.py +0 -0
  20. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/security.py +0 -0
  21. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/context.local.template.md +0 -0
  22. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/context.template.md +0 -0
  23. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/mcp_config.template.json +0 -0
  24. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/profile.template.md +0 -0
  25. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rule.template.md +0 -0
  26. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rules/code-standards.md +0 -0
  27. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rules/security-boundaries.md +0 -0
  28. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skill.template.md +0 -0
  29. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/browser-testing/SKILL.md +0 -0
  30. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/docker-ops/SKILL.md +0 -0
  31. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/git-workflow/SKILL.md +0 -0
  32. {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/server-diagnostics/SKILL.md +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: auto-context-cli
3
- Version: 1.0.0
3
+ Version: 1.0.2
4
4
  Summary: Autonomous context & instruction manager for AI coding assistants
5
5
  Author: Arghya Biswas
6
6
  License: MIT
@@ -18,10 +18,12 @@ Description-Content-Type: text/markdown
18
18
 
19
19
  **Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
20
20
 
21
+ [![PyPI - Version](https://img.shields.io/pypi/v/auto-context-cli.svg?color=blue)](https://pypi.org/project/auto-context-cli/)
22
+ [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/auto-context-cli.svg)](https://pypi.org/project/auto-context-cli/)
23
+ [![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)
21
24
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
22
- [![Platform](https://img.shields.io/badge/Platform-Windows%20PowerShell%20%7C%20Linux%20WSL2%20%7C%20macOS-success.svg)](#-quick-one-line-install)
25
+ [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux%20WSL2-success.svg)](#-quick-one-line-install)
23
26
  [![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)
24
- [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Cyber-arghya/auto-context/pulls)
25
27
 
26
28
  *Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
27
29
 
@@ -33,19 +35,26 @@ Description-Content-Type: text/markdown
33
35
 
34
36
  ## ⚡ Quick One-Line Install
35
37
 
36
- No manual downloads or complex PATH configurations required. Run the command matching your terminal:
38
+ No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
37
39
 
38
- ### 📦 Universal via `uv` (Fastest, Windows / Mac / Linux / WSL2):
40
+ ### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
39
41
  ```bash
40
- uv tool install git+https://github.com/Cyber-arghya/auto-context.git
42
+ # Recommended via uv (fast & isolated):
43
+ uv tool install auto-context-cli
44
+
45
+ # Or via standard pip:
46
+ pip install auto-context-cli
47
+
48
+ # Or via pipx:
49
+ pipx install auto-context-cli
41
50
  ```
42
51
 
43
- ### 🪟 Windows (PowerShell / `pwsh` 1-Click):
52
+ ### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
44
53
  ```powershell
45
54
  irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
46
55
  ```
47
56
 
48
- ### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
57
+ ### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
49
58
  ```bash
50
59
  curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
51
60
  ```
@@ -86,6 +95,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
86
95
  memory status Show status of central memory brain
87
96
  share <NAME> Audit & publish skill or rule to GitHub Gist
88
97
  import <URL> Audit & import skill or rule from GitHub Gist or URL
98
+ update Safely update CLI, global plugin & public rules (Non-breaking)
99
+ update --check Check for updates without modifying files
100
+ update -w, --workspace Update managed system rules in active workspace
101
+ update -g, --global Sync global plugin (~/.gemini/config/plugins/auto-context/)
102
+ update -c, --cli Upgrade auto-context-cli package via uv/pipx/pip
89
103
  --as <NAME> Custom name when importing a skill or rule
90
104
  --public Publish shared Gist as public (default)
91
105
  --secret, --private Publish shared Gist as unlisted/secret
@@ -103,6 +117,38 @@ OPTIONS (MCP TOOLING):
103
117
 
104
118
  ---
105
119
 
120
+ ## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
121
+
122
+ 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:
123
+
124
+ ### 1️⃣ Automatic Background Notification
125
+ `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:
126
+ ```text
127
+ ╭─────────────────────────────────────────────────────────────────────────────╮
128
+ │ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2 │
129
+ │ New public rules, skills, and upstream capabilities are ready. │
130
+ │ Run 'init-context update' to sync modularly without breaking local context.│
131
+ ╰─────────────────────────────────────────────────────────────────────────────╯
132
+ ```
133
+
134
+ ### 2️⃣ 1-Command Safe Modular Update
135
+ Run:
136
+ ```bash
137
+ init-context update
138
+ ```
139
+ - **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
140
+ - **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
141
+ - **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
142
+
143
+ > [!TIP]
144
+ > **Strict Non-Breaking Guarantees:**
145
+ > - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
146
+ > - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
147
+ > - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
148
+ > - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
149
+
150
+ ---
151
+
106
152
  ## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
107
153
 
108
154
  Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
@@ -184,6 +230,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
184
230
  | **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` |
185
231
  | **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` |
186
232
 
233
+ > [!IMPORTANT]
234
+ > **Core Directives for AI Coding Agents:**
235
+ > - **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.
236
+ > - **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`.
237
+
187
238
  ---
188
239
 
189
240
  ### 1️⃣ How to Add a New Rule
@@ -454,11 +505,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
454
505
  3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
455
506
 
456
507
  ### ইনস্টলেশন ও ব্যবহার:
457
- * **উইন্ডোজ পাওয়ারশেল (PowerShell)-এ:**
508
+ * **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
509
+ ```bash
510
+ pip install auto-context-cli
511
+ # অথবা uv দিয়ে:
512
+ uv tool install auto-context-cli
513
+ ```
514
+ * **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
458
515
  ```powershell
459
516
  irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
460
517
  ```
461
- * **লিনাক্স / WSL2-এ:**
518
+ * **লিনাক্স / WSL2 / macOS (1-Click Installer):**
462
519
  ```bash
463
520
  curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
464
521
  ```
@@ -470,6 +527,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
470
527
  ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
471
528
 
472
529
  ### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
530
+ > [!IMPORTANT]
531
+ > **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
532
+ > - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
533
+ > - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
473
534
  * **নতুন রুল (Rule) তৈরি করতে:**
474
535
  ```bash
475
536
  init-context -r my-rule-name # বর্তমান প্রজেক্টের জন্য
@@ -513,6 +574,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
513
574
  ```
514
575
  > **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
515
576
 
577
+ ### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
578
+ অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
579
+ 1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
580
+ 2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
581
+ ```bash
582
+ init-context update # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
583
+ init-context update --check # কোনো আপডেট আছে কিনা শুধু চেক করতে
584
+ init-context update -w # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
585
+ ```
586
+ > **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
587
+ > * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
588
+ > * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
589
+ > * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
590
+
516
591
  ### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
517
592
  টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
518
593
  * **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**
@@ -4,10 +4,12 @@
4
4
 
5
5
  **Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
6
6
 
7
+ [![PyPI - Version](https://img.shields.io/pypi/v/auto-context-cli.svg?color=blue)](https://pypi.org/project/auto-context-cli/)
8
+ [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/auto-context-cli.svg)](https://pypi.org/project/auto-context-cli/)
9
+ [![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)
7
10
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
8
- [![Platform](https://img.shields.io/badge/Platform-Windows%20PowerShell%20%7C%20Linux%20WSL2%20%7C%20macOS-success.svg)](#-quick-one-line-install)
11
+ [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux%20WSL2-success.svg)](#-quick-one-line-install)
9
12
  [![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)
10
- [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Cyber-arghya/auto-context/pulls)
11
13
 
12
14
  *Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
13
15
 
@@ -19,19 +21,26 @@
19
21
 
20
22
  ## ⚡ Quick One-Line Install
21
23
 
22
- No manual downloads or complex PATH configurations required. Run the command matching your terminal:
24
+ No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
23
25
 
24
- ### 📦 Universal via `uv` (Fastest, Windows / Mac / Linux / WSL2):
26
+ ### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
25
27
  ```bash
26
- uv tool install git+https://github.com/Cyber-arghya/auto-context.git
28
+ # Recommended via uv (fast & isolated):
29
+ uv tool install auto-context-cli
30
+
31
+ # Or via standard pip:
32
+ pip install auto-context-cli
33
+
34
+ # Or via pipx:
35
+ pipx install auto-context-cli
27
36
  ```
28
37
 
29
- ### 🪟 Windows (PowerShell / `pwsh` 1-Click):
38
+ ### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
30
39
  ```powershell
31
40
  irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
32
41
  ```
33
42
 
34
- ### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
43
+ ### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
35
44
  ```bash
36
45
  curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
37
46
  ```
@@ -72,6 +81,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
72
81
  memory status Show status of central memory brain
73
82
  share <NAME> Audit & publish skill or rule to GitHub Gist
74
83
  import <URL> Audit & import skill or rule from GitHub Gist or URL
84
+ update Safely update CLI, global plugin & public rules (Non-breaking)
85
+ update --check Check for updates without modifying files
86
+ update -w, --workspace Update managed system rules in active workspace
87
+ update -g, --global Sync global plugin (~/.gemini/config/plugins/auto-context/)
88
+ update -c, --cli Upgrade auto-context-cli package via uv/pipx/pip
75
89
  --as <NAME> Custom name when importing a skill or rule
76
90
  --public Publish shared Gist as public (default)
77
91
  --secret, --private Publish shared Gist as unlisted/secret
@@ -89,6 +103,38 @@ OPTIONS (MCP TOOLING):
89
103
 
90
104
  ---
91
105
 
106
+ ## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
107
+
108
+ 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:
109
+
110
+ ### 1️⃣ Automatic Background Notification
111
+ `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:
112
+ ```text
113
+ ╭─────────────────────────────────────────────────────────────────────────────╮
114
+ │ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2 │
115
+ │ New public rules, skills, and upstream capabilities are ready. │
116
+ │ Run 'init-context update' to sync modularly without breaking local context.│
117
+ ╰─────────────────────────────────────────────────────────────────────────────╯
118
+ ```
119
+
120
+ ### 2️⃣ 1-Command Safe Modular Update
121
+ Run:
122
+ ```bash
123
+ init-context update
124
+ ```
125
+ - **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
126
+ - **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
127
+ - **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
128
+
129
+ > [!TIP]
130
+ > **Strict Non-Breaking Guarantees:**
131
+ > - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
132
+ > - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
133
+ > - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
134
+ > - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
135
+
136
+ ---
137
+
92
138
  ## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
93
139
 
94
140
  Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
@@ -170,6 +216,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
170
216
  | **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` |
171
217
  | **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` |
172
218
 
219
+ > [!IMPORTANT]
220
+ > **Core Directives for AI Coding Agents:**
221
+ > - **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.
222
+ > - **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`.
223
+
173
224
  ---
174
225
 
175
226
  ### 1️⃣ How to Add a New Rule
@@ -440,11 +491,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
440
491
  3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
441
492
 
442
493
  ### ইনস্টলেশন ও ব্যবহার:
443
- * **উইন্ডোজ পাওয়ারশেল (PowerShell)-এ:**
494
+ * **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
495
+ ```bash
496
+ pip install auto-context-cli
497
+ # অথবা uv দিয়ে:
498
+ uv tool install auto-context-cli
499
+ ```
500
+ * **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
444
501
  ```powershell
445
502
  irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
446
503
  ```
447
- * **লিনাক্স / WSL2-এ:**
504
+ * **লিনাক্স / WSL2 / macOS (1-Click Installer):**
448
505
  ```bash
449
506
  curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
450
507
  ```
@@ -456,6 +513,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
456
513
  ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
457
514
 
458
515
  ### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
516
+ > [!IMPORTANT]
517
+ > **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
518
+ > - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
519
+ > - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
459
520
  * **নতুন রুল (Rule) তৈরি করতে:**
460
521
  ```bash
461
522
  init-context -r my-rule-name # বর্তমান প্রজেক্টের জন্য
@@ -499,6 +560,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
499
560
  ```
500
561
  > **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
501
562
 
563
+ ### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
564
+ অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
565
+ 1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
566
+ 2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
567
+ ```bash
568
+ init-context update # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
569
+ init-context update --check # কোনো আপডেট আছে কিনা শুধু চেক করতে
570
+ init-context update -w # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
571
+ ```
572
+ > **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
573
+ > * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
574
+ > * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
575
+ > * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
576
+
502
577
  ### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
503
578
  টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
504
579
  * **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "auto-context-cli"
3
- version = "1.0.0"
3
+ version = "1.0.2"
4
4
  description = "Autonomous context & instruction manager for AI coding assistants"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -1,3 +1,3 @@
1
1
  """auto-context: Autonomous context & instruction manager for AI coding assistants."""
2
2
 
3
- __version__ = "1.0.0"
3
+ __version__ = "1.0.2"
@@ -307,3 +307,44 @@ def new_skill(
307
307
  f"[green] File: [/] {dest_file}",
308
308
  border_style="cyan",
309
309
  ))
310
+
311
+
312
+ # ── promote command ───────────────────────────────────────────────────────────
313
+
314
+ def promote(
315
+ name: Annotated[str, typer.Argument(help="Rule or skill name to promote to Central Memory.")],
316
+ target: Annotated[Optional[Path], typer.Option("--target", "-t")] = None,
317
+ ) -> None:
318
+ """Promote a local workspace rule or skill to Central Memory and global scope."""
319
+ project_dir = (target or Path.cwd()).resolve()
320
+ clean_name = name.lower().replace(" ", "-").replace("_", "-").removesuffix(".md")
321
+
322
+ local_rule = project_dir / AGENTS_SUBDIR / "rules" / f"{clean_name}.md"
323
+ local_skill = project_dir / AGENTS_SUBDIR / "skills" / clean_name / "SKILL.md"
324
+
325
+ promoted = False
326
+ if local_rule.exists():
327
+ content = local_rule.read_text(encoding="utf-8")
328
+ (config.GLOBAL_PLUGIN_DIR / "rules").mkdir(parents=True, exist_ok=True)
329
+ (config.GLOBAL_PLUGIN_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
330
+ if config.MEMORY_DIR.exists():
331
+ (config.MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
332
+ (config.MEMORY_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
333
+ console.print(f"[bold green][✓] Promoted local rule '{clean_name}' to Global Plugin and Central Memory![/]")
334
+ promoted = True
335
+
336
+ if local_skill.exists():
337
+ content = local_skill.read_text(encoding="utf-8")
338
+ (config.GLOBAL_PLUGIN_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
339
+ (config.GLOBAL_PLUGIN_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
340
+ if config.MEMORY_DIR.exists():
341
+ (config.MEMORY_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
342
+ (config.MEMORY_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
343
+ console.print(f"[bold green][✓] Promoted local skill '{clean_name}' to Global Plugin and Central Memory![/]")
344
+ promoted = True
345
+
346
+ if not promoted:
347
+ console.print(f"[red][✗] Rule or skill '{clean_name}' not found in local workspace ({project_dir}).[/]")
348
+ raise typer.Exit(1)
349
+
350
+ console.print(" [cyan]💡 Run 'init-context memory push' to push changes to your private GitHub repo.[/]\n")