create-snowline-agents 1.0.0

package/context_mapper/context_mapper.py

@@ -0,0 +1,84 @@
+import os
+import sys
+
+if sys.stdout.encoding != 'utf-8':
+    sys.stdout.reconfigure(encoding='utf-8')
+
+IGNORE_DIRS = {'node_modules', '.git', 'vendor', 'dist', 'build', '.history', 'quarantine', '.backup_replace'}
+KNOWLEDGE_DIR = '.agents/knowledge'
+
+def generate_tree(dir_path, prefix=""):
+    tree_str = ""
+    try:
+        entries = sorted(os.listdir(dir_path))
+    except Exception:
+        return ""
+        
+    entries = [e for e in entries if e not in IGNORE_DIRS]
+    for i, entry in enumerate(entries):
+        path = os.path.join(dir_path, entry)
+        is_last = (i == len(entries) - 1)
+        connector = "└── " if is_last else "├── "
+        
+        if os.path.isdir(path):
+            tree_str += f"{prefix}{connector}📁 {entry}/\n"
+            extension = "    " if is_last else "│   "
+            tree_str += generate_tree(path, prefix + extension)
+        else:
+            if not entry.startswith('.'):
+                tree_str += f"{prefix}{connector}📄 {entry}\n"
+    return tree_str
+
+def main():
+    apply_mode = "--apply" in sys.argv
+    
+    target_dir = os.getcwd()
+    knowledge_path = os.path.join(target_dir, KNOWLEDGE_DIR)
+    
+    struct_path = os.path.join(knowledge_path, 'PROJECT_STRUCTURE.md')
+    tree = generate_tree(target_dir)
+    
+    struct_content = "# 🗺️ Project Structure Map\n\n"
+    struct_content += "This map was automatically generated by `context_mapper.py`. AI agents must read this file upon entering the project to grasp the architecture without scanning the whole folder.\n\n"
+    struct_content += "```text\n"
+    struct_content += f"📁 {os.path.basename(target_dir)}/\n"
+    struct_content += tree
+    struct_content += "```\n"
+
+    patterns_path = os.path.join(knowledge_path, 'COMMON_PATTERNS.md')
+    patterns_content = ""
+    if not os.path.exists(patterns_path):
+        patterns_content = "# 🧩 Common Patterns & Conventions\n\n"
+        patterns_content += "This file contains the fundamental rules of the project. The AI MUST read this file before writing code.\n\n"
+        patterns_content += "## 1. Architecture\n- Document architecture conventions here (e.g. all APIs are in `src/services`).\n\n"
+        patterns_content += "## 2. Code Style\n- Document styling rules here (e.g. no Tailwind, use Vanilla CSS).\n\n"
+        patterns_content += "## 3. Security\n- Never store credentials in code. Always use `.env`.\n"
+
+    if not apply_mode:
+        print("[DRY-RUN MODE] Context Mapper Preview")
+        print("=" * 50)
+        print(f"Target File: {struct_path}")
+        print("--- Content Preview ---")
+        print(struct_content[:500] + "\n... (truncated)")
+        if patterns_content:
+            print(f"\nTarget File: {patterns_path}")
+            print("--- Content Preview ---")
+            print(patterns_content[:200] + "\n... (truncated)")
+        print("=" * 50)
+        print("\n💡 PROMPT UNTUK AI (Copy-Paste ini):")
+        print('"Pratinjau berhasil. Silakan jalankan ulang perintah dengan tambahan flag --apply untuk menyimpan perubahan ini ke dalam disk."')
+    else:
+        os.makedirs(knowledge_path, exist_ok=True)
+        with open(struct_path, 'w', encoding='utf-8') as f:
+            f.write(struct_content)
+            
+        if patterns_content:
+            with open(patterns_path, 'w', encoding='utf-8') as f:
+                f.write(patterns_content)
+                
+        print(f"[OK] Knowledge Catalog berhasil dibuat/diperbarui di folder `{KNOWLEDGE_DIR}/`.")
+        print("\n💡 PROMPT UNTUK AI (Copy-Paste ini):")
+        print('"Mulai sekarang, setiap kali Anda menangani proyek ini, tolong panggil view_file pada .agents/knowledge/PROJECT_STRUCTURE.md dan COMMON_PATTERNS.md terlebih dahulu sebelum melakukan pencarian atau menulis kode."')
+
+if __name__ == "__main__":
+    main()

package/crash_decoder/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: Error Trace Analyzer (Crash Decoder)
+description: Use this skill to parse huge raw error logs (stack traces, npm test failures, backend crashes) and instantly find which specific lines in the source code caused the problem, ignoring node_modules noise.
+---
+
+## Instructions for AI Agent
+
+**When to use this skill:**
+- When the user pastes a massive terminal error.
+- When `npm run test` or `npm run dev` fails with a huge traceback.
+- **NEVER read raw tracebacks manually.** Always save the user's terminal output to a temporary `.txt` file in the workspace, then run this tool.
+
+**Command to run:**
+```powershell
+# 1. Save the error to a temporary file (e.g. error.log)
+# 2. Run the decoder:
+python .agents/skills/crash_decoder/decoder.py "error.log"
+```
+
+**Expected Behavior & Next Steps:**
+1. The tool will output the exact `Error` message and the top 5 relevant file paths and line numbers (e.g. `at Object.<anonymous> (src/index.js:42:15)`).
+2. After seeing the exact line number, use `view_file` to read that specific line range.
+3. Fix the bug.

package/crash_decoder/decoder.py

@@ -0,0 +1,66 @@
+import os
+import sys
+import re
+
+if sys.stdout.encoding != 'utf-8':
+    sys.stdout.reconfigure(encoding='utf-8')
+
+def decode_crash(file_path):
+    print("🚨 CRASH DECODER 🚨")
+    print("=" * 60)
+    
+    if not os.path.exists(file_path):
+        print(f"[FAIL] File not found: {file_path}")
+        return
+        
+    try:
+        with open(file_path, 'r', encoding='utf-8') as f:
+            content = f.read()
+            
+        # Common error identifiers
+        error_lines = []
+        stack_lines = []
+        
+        for line in content.split('\n'):
+            line = line.strip()
+            # Capture actual error messages
+            if re.match(r'^(Error|TypeError|ReferenceError|SyntaxError|UnhandledPromiseRejectionWarning|Exception):', line, re.IGNORECASE):
+                error_lines.append(line)
+            # Capture stack trace lines
+            elif line.startswith('at '):
+                # Filter out node_modules and internal node scripts
+                if 'node_modules' not in line and 'node:internal' not in line:
+                    stack_lines.append(line)
+            # Python tracebacks
+            elif line.startswith('File "') and 'site-packages' not in line and 'Python\\' not in line:
+                stack_lines.append(line)
+                
+        if not error_lines and not stack_lines:
+            print("[WARN] No standard crash signature found in this log.")
+            print("[INFO] Make sure you copy-pasted the entire stack trace.")
+        else:
+            print("[FAIL] CRASH DETECTED:\n")
+            for e in error_lines[:3]: # limit to top 3 errors
+                print(f"  ❌ {e}")
+                
+            if stack_lines:
+                print("\n[INFO] RELEVANT SOURCE CODE TRACE (Noise Filtered):")
+                for s in stack_lines[:5]: # limit to top 5 traces
+                    print(f"  👉 {s}")
+                    
+            print("\n" + "=" * 60)
+            print("💡 PROMPT UNTUK AI (Copy-Paste ini):")
+            print('"Berdasarkan hasil Crash Decoder di atas, tolong gunakan tool view_file untuk memeriksa baris spesifik yang menyebabkan error tersebut, dan berikan solusinya."')
+            
+    except Exception as e:
+        print(f"[FAIL] Could not read log file: {e}")
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python decoder.py <path_to_error_log.txt>")
+        sys.exit(1)
+        
+    decode_crash(sys.argv[1])
+
+if __name__ == "__main__":
+    main()

package/db_extractor/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: Database Schema Extractor (db_extractor)
+description: Use this skill when you need to understand the database schema of a project (tables, columns, types, relations) without running raw SQL queries manually in the terminal. It parses `.env` to connect to MySQL/MariaDB or falls back to static code analysis for NoSQL (Firebase, MongoDB) and unknown DBs.
+---
+
+# Database Schema Extractor
+
+When a task requires you to interact with the database, DO NOT guess table names or run raw `SHOW TABLES` / `DESCRIBE` queries manually via terminal, as this risks formatting issues and consumes too many tokens.
+
+ALWAYS use this `db_extractor` tool first to get a clean Markdown representation of the database schema.
+
+## Usage
+Run the script using Python, passing the path to the project root (where the `.env` file and source code reside).
+
+```bash
+python .agents/skills/db_extractor/scripts/extractor.py <project_root_dir>
+```
+
+### Examples:
+Extract schema for the current project:
+```bash
+python .agents/skills/db_extractor/scripts/extractor.py .
+```
+
+Extract schema for a specific backend folder:
+```bash
+python .agents/skills/db_extractor/scripts/extractor.py src/backend
+```
+
+## How It Works
+1. **Network Extraction**: It reads the `.env` file (looking for `DB_CONNECTION`). If it's a supported SQL database (like MySQL) and the Python driver is available, it connects and generates a Markdown table of the schema.
+2. **Static Analysis Fallback**: If the database is NoSQL (e.g., Firebase, MongoDB), unknown, or the connection fails, the tool automatically switches to **Static Code Analysis Mode**. It scans the project's source code for Prisma files or Model directories (`lib/models`, `app/Models`, etc.) to reconstruct the schema purely from code. This guarantees you will always get structural context!

package/db_extractor/scripts/extractor.py

@@ -0,0 +1,138 @@
+import os
+import sys
+import re
+
+def parse_env(env_path):
+    config = {}
+    if os.path.exists(env_path):
+        with open(env_path, 'r', encoding='utf-8') as f:
+            for line in f:
+                line = line.strip()
+                if line and not line.startswith('#') and '=' in line:
+                    key, val = line.split('=', 1)
+                    config[key.strip()] = val.strip().strip("'\"")
+    return config
+
+def static_analysis_fallback(project_root):
+    print("### 🔄 Universal Fallback: Static Code Analysis Mode")
+    print("Could not connect via network driver or DB is unknown. Scanning source code for models...\n")
+    
+    found_models = False
+    
+    # 1. Check Prisma
+    prisma_path = os.path.join(project_root, 'prisma', 'schema.prisma')
+    if os.path.exists(prisma_path):
+        print("#### Prisma Schema Found")
+        found_models = True
+        with open(prisma_path, 'r', encoding='utf-8') as f:
+            content = f.read()
+            # simple extract model blocks
+            models = re.findall(r'model\s+(\w+)\s+\{([^}]+)\}', content)
+            for m_name, m_body in models:
+                print(f"- **{m_name}**")
+                lines = [l.strip() for l in m_body.strip().split('\n') if l.strip() and not l.strip().startswith('//')]
+                for l in lines:
+                    print(f"  - `{l}`")
+                print("")
+                
+    # 2. If not prisma, check if it's a typical MVC / models structure
+    if not found_models:
+        search_dirs = ['models', 'src/models', 'lib/models', 'app/Models']
+        for sdir in search_dirs:
+            full_path = os.path.join(project_root, sdir)
+            if os.path.exists(full_path) and os.path.isdir(full_path):
+                print(f"#### Application Models Found in `{sdir}`")
+                found_models = True
+                for root, _, files in os.walk(full_path):
+                    for file in files:
+                        if file.endswith(('.php', '.js', '.ts', '.dart', '.py')):
+                            print(f"- `{file}`")
+                print("\n*(Tip: Use Selective Reader on these model files to see their exact attributes)*")
+                break
+                
+    if not found_models:
+        print("No standard database schema or model folder found via static analysis. Project might not have a database layer yet, or it uses a custom structure.")
+
+
+def extract_mysql(config):
+    try:
+        import pymysql
+    except ImportError:
+        print("Error: `pymysql` module is not installed. Run `pip install pymysql` or fallback to static analysis.")
+        return False
+        
+    try:
+        host = config.get('DB_HOST', '127.0.0.1')
+        user = config.get('DB_USERNAME', config.get('DB_USER', 'root'))
+        password = config.get('DB_PASSWORD', '')
+        database = config.get('DB_DATABASE', config.get('DB_NAME', ''))
+        
+        if not database:
+            print("No DB_DATABASE or DB_NAME defined in .env")
+            return False
+            
+        connection = pymysql.connect(host=host, user=user, password=password, database=database, cursorclass=pymysql.cursors.DictCursor)
+        
+        with connection.cursor() as cursor:
+            cursor.execute("SHOW TABLES")
+            tables = [list(r.values())[0] for r in cursor.fetchall()]
+            
+            print(f"### MySQL Database: `{database}`\n")
+            for table in tables:
+                print(f"#### Table: `{table}`")
+                print("| Column | Type | Null | Key | Default | Extra |")
+                print("|---|---|---|---|---|---|")
+                cursor.execute(f"DESCRIBE `{table}`")
+                columns = cursor.fetchall()
+                for col in columns:
+                    print(f"| {col['Field']} | {col['Type']} | {col['Null']} | {col['Key']} | {col['Default']} | {col['Extra']} |")
+                print("")
+        connection.close()
+        return True
+    except Exception as e:
+        print(f"MySQL Connection Failed: {e}")
+        return False
+
+def main():
+    sys.stdout.reconfigure(encoding='utf-8')
+    if len(sys.argv) < 2:
+        print("Usage: python extractor.py <project_root_dir>")
+        sys.exit(1)
+        
+    project_root = sys.argv[1]
+    env_path = os.path.join(project_root, '.env')
+    
+    config = parse_env(env_path)
+    db_connection = config.get('DB_CONNECTION', '').lower()
+    
+    # Infer MySQL if missing DB_CONNECTION but has typical MySQL env vars (Node.js style)
+    if not db_connection and ('DB_HOST' in config or 'DB_USER' in config):
+        db_connection = 'mysql'
+    
+    print(f"Database Extractor (Target: {project_root})\n")
+    
+    success = False
+    
+    if db_connection == 'mysql' or db_connection == 'mariadb':
+        print(f"Detected Database Engine: {db_connection.upper()} via .env (or inferred)")
+        success = extract_mysql(config)
+    elif db_connection == 'sqlite':
+        print("Detected Database Engine: SQLITE. (Network extraction not fully implemented here yet, falling back to static analysis).")
+        # Could add sqlite3 extraction logic here
+    elif db_connection == 'pgsql' or db_connection == 'postgres':
+        print("Detected Database Engine: POSTGRESQL. (Network extraction not fully implemented here yet, falling back to static analysis).")
+        # Could add psycopg2 extraction logic here
+    elif db_connection == 'firebase' or db_connection == 'firestore':
+        print("Detected Database Engine: FIREBASE (NoSQL). Firebase is schemaless.")
+        # Firebase has no fixed schema, force fallback to model analysis
+    else:
+        if db_connection:
+            print(f"Unknown or Unsupported Database Engine: '{db_connection}'")
+        else:
+            print("No DB_CONNECTION found in .env, or .env is missing.")
+            
+    if not success:
+        static_analysis_fallback(project_root)
+
+if __name__ == "__main__":
+    main()

package/deep_analyzer/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: Deep Analyzer (Project Profiler)
+description: Use this skill to automatically extract project tech stack, dependencies, test commands, and file statistics without manually reading package.json or config files, saving tokens and time.
+---
+
+## Instructions for AI Agent
+
+**When to use this skill:**
+- When the user asks you to "analyze the project" or "find potential bugs" and you need to know what test scripts are available.
+- When you first enter a new project and need to know the Tech Stack (e.g. React vs Vue, Vite vs Next.js).
+- When you want to see what dependencies are installed without wasting 1000+ tokens reading the entire `package.json`.
+
+**Command to run:**
+```powershell
+python .agents/skills/deep_analyzer/analyzer.py
+```
+
+**Expected Behavior & Next Steps:**
+1. The script will output the Tech Stack, available NPM/Yarn commands (like `npm run test`), core dependencies, and directory statistics.
+2. If a test script like `npm run test` or `npm run lint` is found, you can use `run_command` to execute it to find potential bugs!
+3. NEVER read `package.json` manually using `view_file` unless you specifically need to modify a version number. Always use `analyzer.py` to get the overview.

package/deep_analyzer/analyzer.py

@@ -0,0 +1,97 @@
+import os
+import sys
+import json
+
+if sys.stdout.encoding != 'utf-8':
+    sys.stdout.reconfigure(encoding='utf-8')
+
+def analyze_project(target_dir):
+    print("\n🔬 DEEP ANALYZER: Project Profiler 🔬")
+    print("=" * 60)
+    
+    # 1. Tech Stack Detection
+    stack = []
+    if os.path.exists(os.path.join(target_dir, 'package.json')):
+        stack.append("Node.js")
+    if os.path.exists(os.path.join(target_dir, 'requirements.txt')) or os.path.exists(os.path.join(target_dir, 'Pipfile')):
+        stack.append("Python")
+    if os.path.exists(os.path.join(target_dir, 'vite.config.js')) or os.path.exists(os.path.join(target_dir, 'vite.config.ts')):
+        stack.append("Vite (React/Vue)")
+    if os.path.exists(os.path.join(target_dir, 'next.config.js')):
+        stack.append("Next.js")
+    if os.path.exists(os.path.join(target_dir, 'composer.json')):
+        stack.append("PHP/Laravel")
+        
+    stack_str = ", ".join(stack) if stack else "Unknown (Vanilla/Other)"
+    print(f"[{'OK' if stack else 'WARN'}] Tech Stack Detected: {stack_str}")
+    
+    # 2. Package.json Parsing (Commands & Deps)
+    pkg_path = os.path.join(target_dir, 'package.json')
+    if os.path.exists(pkg_path):
+        try:
+            with open(pkg_path, 'r', encoding='utf-8') as f:
+                pkg = json.load(f)
+                
+            scripts = pkg.get('scripts', {})
+            if scripts:
+                print("\n[INFO] Available npm/yarn Commands:")
+                for name, cmd in scripts.items():
+                    print(f"  - npm run {name:<12} : {cmd}")
+            else:
+                print("\n[WARN] No scripts found in package.json")
+                
+            deps = pkg.get('dependencies', {})
+            dev_deps = pkg.get('devDependencies', {})
+            print(f"\n[INFO] Core Dependencies: {len(deps)} runtime, {len(dev_deps)} dev")
+            # Print top 5 dependencies just for context
+            top_deps = list(deps.keys())[:5]
+            if top_deps:
+                print(f"  - Key libraries: {', '.join(top_deps)}...")
+                
+        except Exception as e:
+            print(f"[FAIL] Could not parse package.json: {e}")
+            
+    # 3. Quick Directory Stats
+    print("\n[INFO] Directory Statistics:")
+    ignore_dirs = {'.git', 'node_modules', 'vendor', 'dist', 'build', '.history'}
+    file_counts = {'.js': 0, '.jsx': 0, '.ts': 0, '.tsx': 0, '.py': 0, '.php': 0, '.html': 0, '.css': 0}
+    total_files = 0
+    total_size = 0
+    
+    for root, dirs, files in os.walk(target_dir):
+        dirs[:] = [d for d in dirs if d not in ignore_dirs]
+        for file in files:
+            total_files += 1
+            filepath = os.path.join(root, file)
+            try:
+                total_size += os.path.getsize(filepath)
+            except: pass
+            
+            ext = os.path.splitext(file)[1].lower()
+            if ext in file_counts:
+                file_counts[ext] += 1
+                
+    mb_size = total_size / (1024 * 1024)
+    print(f"  - Total Scanned Files: {total_files} ({mb_size:.2f} MB)")
+    
+    active_exts = {k: v for k, v in file_counts.items() if v > 0}
+    ext_str = ", ".join([f"{k} ({v})" for k, v in active_exts.items()])
+    if ext_str:
+        print(f"  - Source Files: {ext_str}")
+
+def main():
+    target = sys.argv[1] if len(sys.argv) > 1 else os.getcwd()
+    
+    if not os.path.isdir(target):
+        print(f"[FAIL] Target is not a directory: {target}")
+        sys.exit(1)
+        
+    analyze_project(target)
+    
+    print("\n" + "=" * 60)
+    print("[OK] Analisis proyek selesai dengan cepat tanpa membebani token.")
+    print("\n💡 PROMPT UNTUK AI (Copy-Paste ini):")
+    print('"Berdasarkan hasil Deep Analyzer di atas, gunakan perintah npm/test yang tersedia jika Anda perlu memvalidasi bug, atau gunakan alat lain untuk menyelidiki file spesifik."')
+
+if __name__ == "__main__":
+    main()

package/import_fixer/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: Smart Import Fixer
+description: Use this skill to automatically find and fix broken relative imports (e.g. ones reported by Project Guardian).
+---
+
+## Instructions for AI Agent
+
+**When to use this skill:**
+- When Project Guardian reports `Relative import '../services/api' does not exist physically!`.
+- **NEVER use grep to manually hunt for the correct path.** Let this tool compute the exact relative path (`../../`) automatically.
+
+**Command to run:**
+```powershell
+# 1. Dry Run (Preview the correct path)
+python .agents/skills/import_fixer/fixer.py "src/backend/routes/user.js" "../services/api"
+
+# 2. Apply Changes (Actually fixes the file)
+python .agents/skills/import_fixer/fixer.py "src/backend/routes/user.js" "../services/api" --apply
+```
+
+**Expected Behavior:**
+1. The tool will search the entire project for the basename (`api.js` or `api.jsx`).
+2. It will compute the exact relative path from the `source_file` to the `target_file`.
+3. If `--apply` is used, it safely backs up the file and rewrites the import string.

package/import_fixer/fixer.py

@@ -0,0 +1,111 @@
+import os
+import sys
+import re
+import shutil
+from datetime import datetime
+
+if sys.stdout.encoding != 'utf-8':
+    sys.stdout.reconfigure(encoding='utf-8')
+
+IGNORE_DIRS = {'.git', 'node_modules', 'vendor', 'dist', 'build', '.history'}
+EXTENSIONS = ['.js', '.jsx', '.ts', '.tsx']
+
+def find_file(filename, root_dir):
+    matches = []
+    # If filename has no extension, we will search for it with common extensions
+    has_ext = any(filename.endswith(ext) for ext in EXTENSIONS)
+    search_names = [filename] if has_ext else [filename + ext for ext in EXTENSIONS]
+    
+    for r, dirs, files in os.walk(root_dir):
+        dirs[:] = [d for d in dirs if d not in IGNORE_DIRS]
+        for f in files:
+            if f in search_names:
+                matches.append(os.path.join(r, f))
+    return matches
+
+def compute_relative_path(source_file, target_file):
+    source_dir = os.path.dirname(os.path.abspath(source_file))
+    target_abs = os.path.abspath(target_file)
+    # Get relative path from source_dir to target_file
+    rel_path = os.path.relpath(target_abs, source_dir)
+    # Convert Windows backslashes to forward slashes for imports
+    rel_path = rel_path.replace('\\', '/')
+    # Ensure it starts with ./ or ../
+    if not rel_path.startswith('.'):
+        rel_path = './' + rel_path
+    # Remove extension for JS/TS imports
+    for ext in EXTENSIONS:
+        if rel_path.endswith(ext):
+            rel_path = rel_path[:-len(ext)]
+            break
+    return rel_path
+
+def fix_import(source_file, broken_import, apply_mode):
+    print("🔗 SMART IMPORT FIXER 🔗")
+    print("=" * 60)
+    
+    if not os.path.exists(source_file):
+        print(f"[FAIL] Source file not found: {source_file}")
+        return
+        
+    basename = os.path.basename(broken_import)
+    print(f"[INFO] Searching for actual location of '{basename}'...")
+    
+    root_dir = os.getcwd()
+    matches = find_file(basename, root_dir)
+    
+    if not matches:
+        print(f"[FAIL] Could not find any file named {basename} in the project.")
+        return
+        
+    target_file = matches[0]
+    if len(matches) > 1:
+        print(f"[WARN] Multiple files found. Using the first one: {target_file}")
+        
+    new_import = compute_relative_path(source_file, target_file)
+    print(f"\n[INFO] Broken Import : {broken_import}")
+    print(f"[INFO] Correct Import: {new_import}")
+    
+    try:
+        with open(source_file, 'r', encoding='utf-8') as f:
+            content = f.read()
+            
+        if broken_import not in content:
+            print(f"[WARN] The string '{broken_import}' was not found in {source_file}.")
+            return
+            
+        new_content = content.replace(broken_import, new_import)
+        
+        if not apply_mode:
+            print("\n" + "=" * 60)
+            print("[OK] Dry-run complete. Found the correct path.")
+            print("\n💡 PROMPT UNTUK AI (Copy-Paste ini):")
+            print(f'"Berdasarkan hasil pencarian Smart Import Fixer di atas, jalankan ulang perintah dengan tambahan flag --apply untuk memperbaiki rute secara otomatis."')
+        else:
+            backup_dir = os.path.join(root_dir, '.backup_replace', datetime.now().strftime("%Y%m%d_%H%M%S"))
+            os.makedirs(backup_dir, exist_ok=True)
+            backup_path = os.path.join(backup_dir, os.path.basename(source_file) + ".bak")
+            shutil.copy2(source_file, backup_path)
+            
+            with open(source_file, 'w', encoding='utf-8') as f:
+                f.write(new_content)
+                
+            print("\n" + "=" * 60)
+            print(f"[OK] Import fixed! Backup saved to {backup_dir}")
+            
+    except Exception as e:
+        print(f"[FAIL] Error processing file: {e}")
+
+def main():
+    if len(sys.argv) < 3:
+        print("Usage: python fixer.py <source_file> <broken_import_string> [--apply]")
+        sys.exit(1)
+        
+    source_file = sys.argv[1]
+    broken_import = sys.argv[2]
+    apply_mode = "--apply" in sys.argv
+    
+    fix_import(source_file, broken_import, apply_mode)
+
+if __name__ == "__main__":
+    main()

package/install.ps1

@@ -0,0 +1,68 @@
+Write-Host "Installing Snowline Agent Ecosystem (Project-Level)..." -ForegroundColor Cyan
+
+$ProjectRoot = (Get-Location).Path
+$AgentsDir = Join-Path $ProjectRoot ".agents"
+$SkillsDir = Join-Path $AgentsDir "skills"
+$KnowledgeDir = Join-Path $AgentsDir "knowledge"
+$RepoUrl = "https://github.com/UsmanAzizz/snowline-agent-tools.git"
+$IsNewInstall = $false
+
+# Ensure .agents and .agents/knowledge exist
+if (-not (Test-Path $AgentsDir)) {
+    New-Item -ItemType Directory -Force -Path $AgentsDir | Out-Null
+}
+if (-not (Test-Path $KnowledgeDir)) {
+    New-Item -ItemType Directory -Force -Path $KnowledgeDir | Out-Null
+}
+
+# Scaffold skills
+if (Test-Path $SkillsDir) {
+    Write-Host "Found existing skills directory at $SkillsDir" -ForegroundColor Yellow
+    if (Test-Path (Join-Path $SkillsDir ".git")) {
+        Write-Host "Pulling latest updates..." -ForegroundColor Cyan
+        Set-Location $SkillsDir
+        try {
+            git pull origin main
+        } catch {
+            Write-Host "Failed to update repository." -ForegroundColor Red
+        }
+        Set-Location $ProjectRoot
+    } else {
+        Write-Host "Existing skills directory is not a git repository. Skipping git pull." -ForegroundColor Yellow
+    }
+} else {
+    $IsNewInstall = $true
+    Write-Host "Downloading Snowline Agent skills..." -ForegroundColor Cyan
+    try {
+        git clone $RepoUrl $SkillsDir
+    } catch {
+        Write-Host "Failed to clone repository. Make sure git is installed." -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Copy AGENTS_TEMPLATE.md to AGENTS.md
+$TemplatePath = Join-Path $SkillsDir "AGENTS_TEMPLATE.md"
+$LocalAgentsPath = Join-Path $AgentsDir "AGENTS.md"
+
+if (Test-Path $TemplatePath) {
+    if (-not (Test-Path $LocalAgentsPath)) {
+        Write-Host "Creating Project AGENTS.md..." -ForegroundColor Cyan
+        Copy-Item -Path $TemplatePath -Destination $LocalAgentsPath -Force
+        Write-Host "Project AGENTS.md created successfully." -ForegroundColor Green
+    } else {
+        Write-Host "Project AGENTS.md already exists. Skipping overwrite." -ForegroundColor Yellow
+    }
+}
+
+# Scaffold PLAN.md
+$PlanPath = Join-Path $ProjectRoot "PLAN.md"
+if (-not (Test-Path $PlanPath)) {
+    Write-Host "Creating PLAN.md..." -ForegroundColor Cyan
+    Set-Content -Path $PlanPath -Value "# Project Plan / Task Tracker`n`n- [ ] Initial task" -Encoding UTF8
+}
+
+if ($IsNewInstall) {
+    Write-Host "`nInstallation Complete!" -ForegroundColor Green
+    Write-Host "This project is now powered by the Snowline Agent Ecosystem." -ForegroundColor Cyan
+}