auto-context-cli 1.0.6__tar.gz → 1.0.7__tar.gz

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: auto-context-cli
-Version: 1.0.6
+Version: 1.0.7
 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.6)
+[![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.7)
 [![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)
@@ -83,7 +83,7 @@ Auto-Context supports both modern subcommands (`init-context <command>`) and sta
 | :--- | :--- | :--- |
 | `init-context init [DIR]` | `init-context [DIR]` | Scaffolds 5-tier context in active or specified directory. |
 | `init-context scan [DIR]` | `init-context --scan` | Stack-adaptive codebase scanner: generates satellites (.agents/context/). |
-| `init-context rule <name>` | `init-context -r <name>` | Scaffolds a new agent rule with YAML frontmatter. |
+| `init-context rule <name>` | `init-context -r <name> [-a]` | Scaffolds a rule or appends to a domain with `registry.json` duplicate protection. |
 | `init-context skill <name>` | `init-context -s <name>` | Scaffolds a new agent skill directory with triggers & runbook. |
 | `init-context promote <name>` | — | Promotes local workspace rule/skill to Global Plugin & Central Memory. |
 | `init-context update` | — | Modular, non-breaking update for CLI, global plugin & system rules. |

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/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.6)
+[![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.7)
 [![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)
@@ -69,7 +69,7 @@ Auto-Context supports both modern subcommands (`init-context <command>`) and sta
 | :--- | :--- | :--- |
 | `init-context init [DIR]` | `init-context [DIR]` | Scaffolds 5-tier context in active or specified directory. |
 | `init-context scan [DIR]` | `init-context --scan` | Stack-adaptive codebase scanner: generates satellites (.agents/context/). |
-| `init-context rule <name>` | `init-context -r <name>` | Scaffolds a new agent rule with YAML frontmatter. |
+| `init-context rule <name>` | `init-context -r <name> [-a]` | Scaffolds a rule or appends to a domain with `registry.json` duplicate protection. |
 | `init-context skill <name>` | `init-context -s <name>` | Scaffolds a new agent skill directory with triggers & runbook. |
 | `init-context promote <name>` | — | Promotes local workspace rule/skill to Global Plugin & Central Memory. |
 | `init-context update` | — | Modular, non-breaking update for CLI, global plugin & system rules. |

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/pyproject.toml

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

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/commands/init_cmd.py

@@ -167,6 +167,10 @@ def init(
     for rule_file in (templates / "rules").glob("*.md"):
         _copy_if_missing(rule_file, rules_dest / rule_file.name, force=force, dry_run=dry_run)
 
+    reg_tmpl = templates / "rules" / "registry.json"
+    if reg_tmpl.exists():
+        _copy_if_missing(reg_tmpl, rules_dest / "registry.json", force=force, dry_run=dry_run)
+
     maintain_tmpl = templates / "maintain_context.template.md"
     if maintain_tmpl.exists():
         content = _render(maintain_tmpl, variables)
@@ -234,14 +238,116 @@ def init(
 
 # ── rule command ──────────────────────────────────────────────────────────────
 
+def _load_registry(registry_file: Path) -> dict:
+    if registry_file.exists():
+        try:
+            import json
+            return json.loads(registry_file.read_text(encoding="utf-8"))
+        except Exception:
+            pass
+    tmpl = get_templates_dir() / "rules" / "registry.json"
+    if tmpl.exists():
+        try:
+            import json
+            return json.loads(tmpl.read_text(encoding="utf-8"))
+        except Exception:
+            pass
+    return {"version": "1.0.0", "domains": {}}
+
+
+def _find_duplicate_rule(registry: dict, text_or_title: str) -> Optional[tuple[str, str, str]]:
+    import re
+    clean_query = re.sub(r"[^a-zA-Z0-9\s]", "", text_or_title).lower().strip()
+    query_words = set(w for w in clean_query.split() if len(w) > 3)
+
+    for d_key, domain in registry.get("domains", {}).items():
+        d_file = domain.get("file", f"{d_key}.md")
+        for r in domain.get("rules", []):
+            r_title = r.get("title", "")
+            r_id = r.get("id", "")
+            clean_title = re.sub(r"[^a-zA-Z0-9\s]", "", r_title).lower().strip()
+
+            if clean_query == clean_title or (len(clean_query) > 6 and clean_query in clean_title) or (len(clean_title) > 6 and clean_title in clean_query):
+                return d_key, r_title, d_file
+            if r_id and r_id in clean_query.replace(" ", "-"):
+                return d_key, r_title, d_file
+
+            r_keywords = set(k.lower() for k in r.get("keywords", []))
+            if query_words and len(query_words.intersection(r_keywords)) >= 2:
+                return d_key, r_title, d_file
+
+    return None
+
+
+def _register_rule_in_registry(registry_file: Path, domain_key: str, rule_title: str, file_name: str) -> None:
+    import json
+    import re
+    from datetime import date
+
+    registry = _load_registry(registry_file)
+    if "domains" not in registry:
+        registry["domains"] = {}
+
+    if domain_key not in registry["domains"]:
+        registry["domains"][domain_key] = {
+            "file": file_name,
+            "name": domain_key.replace("-", " ").title(),
+            "description": f"Domain rules for {domain_key}",
+            "rules": []
+        }
+
+    clean_first_line = rule_title.strip().splitlines()[0].strip("* ").strip()
+    slug = re.sub(r"[^a-zA-Z0-9\s-]", "", clean_first_line).strip().lower().replace(" ", "-")
+    clean_words = [w for w in re.sub(r"[^a-zA-Z0-9\s]", "", clean_first_line).lower().split() if len(w) > 3]
+
+    existing_ids = [r.get("id") for r in registry["domains"][domain_key].get("rules", [])]
+    if slug not in existing_ids:
+        registry["domains"][domain_key]["rules"].append({
+            "id": slug,
+            "title": clean_first_line,
+            "keywords": clean_words
+        })
+        registry["last_updated"] = date.today().isoformat()
+        registry_file.parent.mkdir(parents=True, exist_ok=True)
+        registry_file.write_text(json.dumps(registry, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+
+
+def _append_guideline_to_file(dest_file: Path, text_to_append: str) -> None:
+    import re
+    content = dest_file.read_text(encoding="utf-8")
+    existing_nums = [int(m) for m in re.findall(r"(?m)^(\d+)\.\s+\*", content)]
+    next_num = (max(existing_nums) + 1) if existing_nums else 1
+
+    clean_guideline = text_to_append.strip()
+    if not re.match(r"^\d+\.\s+", clean_guideline):
+        if not clean_guideline.startswith("**"):
+            lines = clean_guideline.splitlines()
+            title = lines[0]
+            rest = lines[1:] if len(lines) > 1 else []
+            entry = f"{next_num}. **{title}**\n"
+            for r in rest:
+                entry += f"   {r}\n"
+        else:
+            entry = f"{next_num}. {clean_guideline}\n"
+    else:
+        entry = f"{clean_guideline}\n"
+
+    if not content.endswith("\n"):
+        content += "\n"
+    content += entry
+    dest_file.write_text(content, encoding="utf-8")
+
+
 def new_rule(
     name: Annotated[str, typer.Argument(help="Rule name (e.g. code-standards).")],
     target: Annotated[Optional[Path], typer.Option("--target", "-t")] = None,
     global_: Annotated[bool, typer.Option("--global", "-g", help="Install into global plugin.")] = False,
     force: Annotated[bool, typer.Option("--force", "-f")] = False,
+    append: Annotated[bool, typer.Option("--append", "-a", help="Append guideline to existing rule domain.")] = False,
+    guideline: Annotated[Optional[str], typer.Option("--guideline", help="Guideline text to append to rule.")] = None,
     dry_run: Annotated[bool, typer.Option("--dry-run", "-d")] = False,
 ) -> None:
-    """Scaffold a new agent rule file."""
+    """Scaffold a new agent rule file or append to an existing domain rule with duplicate guard."""
     clean_name = name.lower().replace(" ", "-").replace("_", "-").removesuffix(".md")
     title = clean_name.replace("-", " ").title()
 
@@ -251,9 +357,43 @@ def new_rule(
         else (target or Path.cwd()).resolve() / AGENTS_SUBDIR / "rules"
     )
     dest_file = dest_dir / f"{clean_name}.md"
+    registry_file = dest_dir / "registry.json"
 
     if dest_file.exists() and not force:
-        console.print(f"[yellow][!] Rule already exists:[/] {dest_file}\n    Use --force to overwrite.")
+        if append or guideline:
+            text_to_append = guideline or "New domain constraint and best practice."
+
+            # Check duplicate against registry
+            dup = _find_duplicate_rule(_load_registry(registry_file), text_to_append)
+            if dup:
+                dup_domain, dup_title, dup_file = dup
+                console.print(Panel(
+                    f"[bold yellow]⚠️ Duplicate Rule Detected — Skipped![/]\n"
+                    f"[white]The guideline '[cyan]{text_to_append}[/]' matches existing rule:\n"
+                    f"[green]'{dup_title}'[/] inside [yellow]{dup_file}[/] (Domain: [cyan]{dup_domain}[/]).\n\n"
+                    f"[dim]Registry checked: {registry_file}[/]",
+                    border_style="yellow",
+                ))
+                return
+
+            if not dry_run:
+                _append_guideline_to_file(dest_file, text_to_append)
+                _register_rule_in_registry(registry_file, clean_name, text_to_append, dest_file.name)
+                if global_ and config.MEMORY_DIR.exists():
+                    mem_dest = config.MEMORY_DIR / "rules" / f"{clean_name}.md"
+                    if mem_dest.exists():
+                        _append_guideline_to_file(mem_dest, text_to_append)
+                        _register_rule_in_registry(config.MEMORY_DIR / "rules" / "registry.json", clean_name, text_to_append, dest_file.name)
+            console.print(Panel(
+                f"[bold green]✨ Rule Domain Updated & Registered![/]\n"
+                f"[yellow]   Rule:[/]     {clean_name}\n"
+                f"[cyan]   File:[/]     {dest_file}\n"
+                f"[cyan]   Registry:[/] {registry_file}\n"
+                f"[green]   Added:[/]    {text_to_append}",
+                border_style="green",
+            ))
+            return
+        console.print(f"[yellow][!] Rule already exists:[/] {dest_file}\n    Use --append (-a) with --guideline to add to this domain, or --force to overwrite.")
         raise typer.Exit(1)
 
     tmpl = get_templates_dir() / "rule.template.md"

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/commands/update_cmd.py

@@ -237,10 +237,20 @@ def update_global_plugin() -> int:
     core_files = [
         ("plugin.json", plugin_dir / "plugin.json"),
         ("plugin/rules/AGENTS.md", rules_dir / "AGENTS.md"),
+        ("plugin/rules/code-standards.md", rules_dir / "code-standards.md"),
+        ("plugin/rules/security-boundaries.md", rules_dir / "security-boundaries.md"),
+        ("plugin/rules/hub-satellite-architecture.md", rules_dir / "hub-satellite-architecture.md"),
+        ("plugin/rules/readme-docs-sync.md", rules_dir / "readme-docs-sync.md"),
+        ("plugin/rules/registry.json", rules_dir / "registry.json"),
         ("plugin/skills/auto-context/SKILL.md", skills_dir / "SKILL.md"),
+        ("plugin/skills/browser-testing/SKILL.md", plugin_dir / "skills" / "browser-testing" / "SKILL.md"),
+        ("plugin/skills/docker-ops/SKILL.md", plugin_dir / "skills" / "docker-ops" / "SKILL.md"),
+        ("plugin/skills/git-workflow/SKILL.md", plugin_dir / "skills" / "git-workflow" / "SKILL.md"),
+        ("plugin/skills/server-diagnostics/SKILL.md", plugin_dir / "skills" / "server-diagnostics" / "SKILL.md"),
     ]
 
     for rel_path, dest_path in core_files:
+        dest_path.parent.mkdir(parents=True, exist_ok=True)
         url = f"{config.RAW_GITHUB_BASE}/{rel_path}"
         content = _download_text(url)
         if content:
@@ -252,10 +262,16 @@ def update_global_plugin() -> int:
             tmpl_dir = config.get_templates_dir()
             fallback_map = {
                 "AGENTS.md": tmpl_dir / "AGENTS.template.md",
-                "SKILL.md": tmpl_dir / "skill.template.md",
+                "SKILL.md": tmpl_dir / "skills" / dest_path.parent.name / "SKILL.md" if (tmpl_dir / "skills" / dest_path.parent.name / "SKILL.md").exists() else tmpl_dir / "skill.template.md",
+                "code-standards.md": tmpl_dir / "rules" / "code-standards.md",
+                "security-boundaries.md": tmpl_dir / "rules" / "security-boundaries.md",
+                "hub-satellite-architecture.md": tmpl_dir / "rules" / "hub-satellite-architecture.md",
+                "readme-docs-sync.md": tmpl_dir / "rules" / "readme-docs-sync.md",
+                "registry.json": tmpl_dir / "rules" / "registry.json",
             }
-            if dest_path.name in fallback_map and fallback_map[dest_path.name].exists():
-                shutil.copy2(fallback_map[dest_path.name], dest_path)
+            fb = fallback_map.get(dest_path.name)
+            if fb and fb.exists():
+                shutil.copy2(fb, dest_path)
                 console.print(f"  [green][✓] Restored from bundled template:[/] {dest_path.name}")
                 updated_count += 1
 

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/main.py

@@ -54,6 +54,8 @@ def root(
     env: Annotated[Optional[str], typer.Option("--env", help="Environment variables (KEY=val,KEY2=val2).")] = None,
     global_: Annotated[bool, typer.Option("--global", "-g", help="Target global plugin scope.")] = False,
     force: Annotated[bool, typer.Option("--force", "-f", help="Overwrite existing files.")] = False,
+    append: Annotated[bool, typer.Option("--append", "-a", help="Append to existing domain rule.")] = False,
+    guideline: Annotated[Optional[str], typer.Option("--guideline", help="Guideline text to append to rule.")] = None,
     dry_run: Annotated[bool, typer.Option("--dry-run", "-d", help="Preview without writing.")] = False,
     scan: Annotated[bool, typer.Option("--scan", help="Run stack-adaptive scanner on target directory.")] = False,
     version: bool = typer.Option(False, "--version", "-v", help="Show version and exit."),
@@ -69,7 +71,7 @@ def root(
             try:
                 v = pkg_version("auto-context")
             except Exception:
-                v = "1.0.6"
+                v = "1.0.7"
         console.print(f"init-context v{v}")
         raise typer.Exit()
 
@@ -78,7 +80,7 @@ def root(
 
     # ── Legacy flag routing ────────────────────────────────────────────────────
     if new_rule:
-        init_cmd.new_rule(name=new_rule, target=target, global_=global_, force=force, dry_run=dry_run)
+        init_cmd.new_rule(name=new_rule, target=target, global_=global_, force=force, append=append, guideline=guideline, dry_run=dry_run)
         return
 
     if new_skill:

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/templates/AGENTS.template.md

@@ -45,3 +45,8 @@ Never blindly delete or truncate context:
   - `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.
+
+### 7. First-Principles Gatekeeper: Idempotency, KISS, DRY & The Brutal Truth Filter
+- **Strict Idempotency Proof ($f(f(x)) = f(x)$):** All code generation, filesystem operations, and context sync commands must be 100% idempotent. Running them once or 100 times must yield the exact same deterministic state without duplication or side-effects.
+- **Modular, KISS & DRY:** Maintain clean separation of concerns. Prohibit copy-paste duplication, unnecessary abstractions, and monolithic bloat across all project code and context.
+- **The Brutal Truth Filter:** Every idea, design proposal, or architectural suggestion must pass first-principles scrutiny. If an idea or approach fails "The Brutal Truth Filter" (adds needless complexity, breaks DRY/KISS, or solves the wrong problem), **immediately DROP the idea** and proactively notify the user with clear technical rationale instead of blindly building flawed requests.

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/templates/GEMINI.template.md

@@ -45,3 +45,8 @@ Never blindly delete or truncate context:
   - `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.
+
+### 7. First-Principles Gatekeeper: Idempotency, KISS, DRY & The Brutal Truth Filter
+- **Strict Idempotency Proof ($f(f(x)) = f(x)$):** All code generation, filesystem operations, and context sync commands must be 100% idempotent. Running them once or 100 times must yield the exact same deterministic state without duplication or side-effects.
+- **Modular, KISS & DRY:** Maintain clean separation of concerns. Prohibit copy-paste duplication, unnecessary abstractions, and monolithic bloat across all project code and context.
+- **The Brutal Truth Filter:** Every idea, design proposal, or architectural suggestion must pass first-principles scrutiny. If an idea or approach fails "The Brutal Truth Filter" (adds needless complexity, breaks DRY/KISS, or solves the wrong problem), **immediately DROP the idea** and proactively notify the user with clear technical rationale instead of blindly building flawed requests.

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/templates/maintain_context.template.md

@@ -46,3 +46,8 @@ Never blindly delete or truncate context:
   - `init-context scan`: Refresh stack-adaptive satellites (`routes.md`, `schema.md`, `gotchas.md`).
   - `init-context update`: Safely sync public rules and upstream capabilities (non-breaking).
   - `init-context memory push`: Push updates to central memory.
+
+### 7. First-Principles Gatekeeper: Idempotency, KISS, DRY & The Brutal Truth Filter
+- **Strict Idempotency Proof ($f(f(x)) = f(x)$):** All code generation, filesystem operations, and context sync commands must be 100% idempotent. Running them once or 100 times must yield the exact same deterministic state without duplication or side-effects.
+- **Modular, KISS & DRY:** Maintain clean separation of concerns. Prohibit copy-paste duplication, unnecessary abstractions, and monolithic bloat across all project code and context.
+- **The Brutal Truth Filter:** Every idea, design proposal, or architectural suggestion must pass first-principles scrutiny. If an idea or approach fails "The Brutal Truth Filter" (adds needless complexity, breaks DRY/KISS, or solves the wrong problem), **immediately DROP the idea** and proactively notify the user with clear technical rationale instead of blindly building flawed requests.

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/templates/rules/code-standards.md

@@ -22,3 +22,9 @@ Maintain readable, maintainable, modular, and type-safe codebases with clear err
    - Log actionable error messages that include relevant context (e.g. invalid inputs, resource identifiers).
 4. **Conventional Git Commits:**
    - Write semantic commit messages (`feat:`, `fix:`, `docs:`, `refactor:`, `chore:`).
+5. **Static Type Annotations & Null Safety:**
+   - Enforce explicit type annotations for public functions, parameters, and return types.
+   - Prohibit unchecked null / undefined dereferencing.
+6. **Named Constants Over Magic Values:**
+   - Replace literal strings and magic numbers with descriptive, uppercase module-level constants.
+7. **Immutable Data Structures**

{auto_context_cli-1.0.6 → auto_context_cli-1.0.7}/src/auto_context/templates/rules/hub-satellite-architecture.md

@@ -23,8 +23,8 @@ Prevent monolithic context file bloat, eliminate token waste, ensure 100% idempo
    - User-written notes, secrets, and manual entries outside anchored zones must remain 100% untouched.
    - Check content hashes before disk writes to avoid unnecessary I/O.
 
-3. **The Brutal Truth Filter (Zero Dead Logs):**
-   - If an idea, log entry, or feature fails first-principles scrutiny, drop it immediately and inform the user.
+3. **The Brutal Truth Filter (Zero Dead Logs & Flawed Ideas):**
+   - If an idea, design approach, log entry, or feature proposal fails first-principles scrutiny, breaks KISS/DRY principles, or does not pass 'The Brutal Truth Filter', **immediately drop the idea and notify the user** with honest technical reasons.
    - Prohibit chronological bug cemeteries (`history.md` dumps of trivial solved bugs).
    - In their place, maintain **`gotchas.md`**: high-impact institutional knowledge, non-obvious architecture traps, port collisions, and edge-case invariants.
 

auto_context_cli-1.0.7/src/auto_context/templates/rules/registry.json

@@ -0,0 +1,226 @@
+{
+  "version": "1.0.0",
+  "last_updated": "2026-11-02",
+  "description": "Registry of unique rules and guidelines to prevent duplicates and enforce domain consolidation.",
+  "domains": {
+    "code-standards": {
+      "file": "code-standards.md",
+      "name": "Code Quality & Architecture Standards",
+      "description": "Clean code, defensive programming, typing, naming, and error handling",
+      "rules": [
+        {
+          "id": "defensive-coding-early-return",
+          "title": "Defensive Coding & Early Return",
+          "keywords": [
+            "guard clauses",
+            "early return",
+            "nested indentation",
+            "input validation",
+            "defensive coding"
+          ]
+        },
+        {
+          "id": "clean-code-srp",
+          "title": "Clean Code & Self-Documenting Logic",
+          "keywords": [
+            "single responsibility",
+            "srp",
+            "clean code",
+            "variable names",
+            "docstrings"
+          ]
+        },
+        {
+          "id": "structured-error-handling",
+          "title": "Structured Error Handling",
+          "keywords": [
+            "exception handling",
+            "empty catch",
+            "error logging",
+            "try catch"
+          ]
+        },
+        {
+          "id": "conventional-git-commits",
+          "title": "Conventional Git Commits",
+          "keywords": [
+            "commit messages",
+            "feat",
+            "fix",
+            "docs",
+            "chore",
+            "refactor"
+          ]
+        },
+        {
+          "id": "static-type-annotations",
+          "title": "Static Type Annotations & Null Safety",
+          "keywords": [
+            "type hints",
+            "type annotations",
+            "null safety",
+            "typing",
+            "null pointer"
+          ]
+        },
+        {
+          "id": "named-constants-over-magic-values",
+          "title": "Named Constants Over Magic Values",
+          "keywords": [
+            "magic numbers",
+            "literal strings",
+            "constants",
+            "magic values"
+          ]
+        },
+        {
+          "id": "immutable-data-structures",
+          "title": "Immutable Data Structures",
+          "keywords": [
+            "immutable",
+            "data",
+            "structures"
+          ]
+        }
+      ]
+    },
+    "security-boundaries": {
+      "file": "security-boundaries.md",
+      "name": "Security Boundaries & Secret Safety",
+      "description": "Secret protection, API keys, sandbox isolation, and network exposure",
+      "rules": [
+        {
+          "id": "zero-hardcoded-secrets",
+          "title": "Zero Hardcoded Secrets",
+          "keywords": [
+            "api keys",
+            "passwords",
+            "tokens",
+            "private keys",
+            "secrets",
+            ".env"
+          ]
+        },
+        {
+          "id": "local-sandbox-test-data-isolation",
+          "title": "Local Sandbox Test Data Isolation",
+          "keywords": [
+            "context.local.md",
+            "mock credentials",
+            "dummy logins",
+            "test accounts",
+            "git-ignored"
+          ]
+        },
+        {
+          "id": "public-exposure-boundaries",
+          "title": "Public Exposure Boundaries",
+          "keywords": [
+            "port binding",
+            "127.0.0.1",
+            "localhost",
+            "exposure",
+            "tunneling"
+          ]
+        }
+      ]
+    },
+    "hub-satellite-architecture": {
+      "file": "hub-satellite-architecture.md",
+      "name": "Hub & Satellite Modular Architecture & Idempotency Proof",
+      "description": "Context budget, satelittes, deterministic idempotency, and gotchas invariants",
+      "rules": [
+        {
+          "id": "hub-satellite-token-budget",
+          "title": "Hub & Satellite Pattern (Strict Token Budget)",
+          "keywords": [
+            "context.md",
+            "satellites",
+            "routes.md",
+            "schema.md",
+            "gotchas.md",
+            "token budget"
+          ]
+        },
+        {
+          "id": "strict-idempotency-proof",
+          "title": "Strict Idempotency Proof",
+          "keywords": [
+            "idempotency",
+            "anchored blocks",
+            "re-running",
+            "deterministic",
+            "hash check"
+          ]
+        },
+        {
+          "id": "brutal-truth-filter",
+          "title": "The Brutal Truth Filter (Zero Dead Logs)",
+          "keywords": [
+            "gotchas.md",
+            "anti-patterns",
+            "dead logs",
+            "bug cemeteries",
+            "invariants"
+          ]
+        },
+        {
+          "id": "kiss-dry-heuristics",
+          "title": "KISS & DRY Heuristics",
+          "keywords": [
+            "convention heuristics",
+            "graceful degradation",
+            "lightweight scanners"
+          ]
+        }
+      ]
+    },
+    "readme-docs-sync": {
+      "file": "readme-docs-sync.md",
+      "name": "Mandatory README & Documentation Synchronization",
+      "description": "Documentation synchronization for CLI commands, options, and workflows",
+      "rules": [
+        {
+          "id": "zero-undocumented-features",
+          "title": "Zero Undocumented Features",
+          "keywords": [
+            "readme",
+            "documentation",
+            "docs sync",
+            "bengali guide",
+            "options table"
+          ]
+        },
+        {
+          "id": "clear-executable-instructions",
+          "title": "Clear & Executable Instructions",
+          "keywords": [
+            "executable commands",
+            "cli examples",
+            "options tables",
+            "syntax"
+          ]
+        },
+        {
+          "id": "safety-non-breaking-boundaries",
+          "title": "Safety & Non-Breaking Boundaries",
+          "keywords": [
+            "non-breaking",
+            "protection guarantees",
+            "custom rules preserve"
+          ]
+        },
+        {
+          "id": "release-version-alignment",
+          "title": "Release Version Alignment",
+          "keywords": [
+            "version bump",
+            "pyproject.toml",
+            "tags",
+            "release badges"
+          ]
+        }
+      ]
+    }
+  }
+}