backeer-agy 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# Backeer AGY — Otomatik Onay Eklentisi + IDE Durum Çubuğu
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Google Antigravity (`agy`) için resmi **Plugin + `PreToolUse` Hook** mimarisi ve eşlikçi **Antigravity IDE / VS Code Durum Çubuğu (`.vsix`)** eklentisi.
+
+## Neler Sağlar?
+
+1. **Dosya Erişimi Otomatik Onayı:** Hassas olmayan dosyalarda okuma, listeleme, arama ve yazma/düzenleme işlemlerini kesintisiz otomatik onaylar.
+2. **Zararsız Terminal Komutları Otomatik Onayı (`run_command`):**
+   - **Salt-Okunur İnceleme Komutları:** `ls`, `pwd`, `git status`, `git diff`, `git log`, `git branch -a`, `rg`, `grep`, `head`, `cat`, `<araç> --version`, `flutter doctor`, `agy plugin validate` vb.
+   - **Güvenli Geliştirme / Test Komutları:** `npm test`, `npm run lint`, `pytest`, `ruff check`, `mypy`, `tsc --noEmit`, `flutter analyze`, `cargo check`, `go test`, `swift test` vb.
+   - **Sıkı Güvenlik Filtresi:** Zincirleme komutlar (`&&`, `;`, `|`, `>`), alt kabuklar (`$()`, `` ` ``), tehlikeli bayraklar (`-exec`, `-delete`, `--fix`, `--ext-diff`), arka plan servisleri (`IsDaemon`) ve hassas dosyalara dokunan komutlar (`cat .env` vb.) **asla** otomatik onaylanmaz.
+3. **IDE Durum Çubuğu (Status Bar) Düğmesi:** Sağ alt köşeden tek tıkla (veya `Cmd+Shift+Y` / `Ctrl+Shift+Y` kısayoluyla) 4 mod arasında anında geçiş:
+   - `AGY: Açık` — Dosya Okuma/Yazma + Zararsız Komutlar
+   - `AGY: Sadece Dosya` — Dosya Okuma/Yazma (Komutlar sorulur)
+   - `AGY: Salt Okunur` — Dosya Okuma + Salt-Okunur İnceleme Komutları (Yazma sorulur)
+   - `AGY: Kapalı` — Otomatik Onay Devre Dışı
+4. **Hassas Dosya Koruması:** `.env` (`.env.example` hariç), `.ssh`, `.aws`, `.gnupg`, `.pem`/`.p8`/`.key`, `master.key`, sistem dizinleri ve eklenti yapılandırma dosyaları her zaman korunur.
+
+## Kurulum
+
+### Hızlı Kurulum (NPM / `npx`)
+
+```bash
+npx backeer-agy install
+```
+
+Diğer yönetim komutları:
+
+```bash
+npx backeer-agy status               # Aktif modu ve kurulum durumunu gösterir
+npx backeer-agy mode readonly        # Mod değiştirir (all | files_only | readonly | off)
+npx backeer-agy export-vsix          # .vsix dosyasını mevcut klasöre kopyalar
+npx backeer-agy uninstall            # Eklentiyi kaldırır
+```
+
+### Yerel Kaynak Koddan Kurulum
+
+```bash
+cd /Users/emre/Library/CloudStorage/SynologyDrive-DW/03_Yazilim_Sunucu_ve_Yedekler/mobileapps/backeer-agy
+agy plugin validate --strict .
+agy plugin install .
+```
+
+### 2. IDE Durum Çubuğu (`.vsix`) Eklentisini Kurun
+
+Hazır paketlenmiş dosya: `vscode-extension/backeer-agy-statusbar-1.1.0.vsix`
+
+- **Antigravity IDE Arayüzünden:** Komut Paletini (`Cmd + Shift + P`) açın → **`Extensions: Install from VSIX...`** seçin → `vscode-extension/backeer-agy-statusbar-1.1.0.vsix` dosyasını seçin.
+- *(Kaynak kodda değişiklik yaparsanız `python3 -B vscode-extension/build_vsix.py` komutuyla `.vsix` paketini yeniden üretebilirsiniz.)*
+
+## Testleri Çalıştırma
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 python3 -W error -m unittest discover -s tests -v
+```

package/assets/logo.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none">
+  <rect width="128" height="128" rx="28" fill="#0F172A"/>
+  <path d="M64 20L28 36V62C28 85.4 43.4 106.8 64 114C84.6 106.8 100 85.4 100 62V36L64 20Z" fill="#1E293B" stroke="#38BDF8" stroke-width="5" stroke-linejoin="round"/>
+  <path d="M49 65L59 75L80 54" stroke="#34D399" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/bin/cli.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+// @ts-check
+"use strict";
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const {
+  DEFAULT_STATE_PATH,
+  MODES,
+  VALID_MODE_IDS,
+  expandHome,
+  readStateMode,
+  writeStateMode,
+} = require("../vscode-extension/state_store");
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const PKG_JSON = JSON.parse(
+  fs.readFileSync(path.join(PACKAGE_ROOT, "package.json"), "utf8")
+);
+const VSIX_FILENAME = `backeer-agy-statusbar-${PKG_JSON.version}.vsix`;
+const BUNDLED_VSIX = path.join(PACKAGE_ROOT, "vscode-extension", VSIX_FILENAME);
+
+/**
+ * Resolve state file path using env override or default ~/.config/backeer-agy/state.json.
+ * @returns {string}
+ */
+function resolveStatePath() {
+  const envPath = process.env.BACKEER_AGY_STATE_FILE;
+  return expandHome(envPath && envPath.trim() ? envPath : DEFAULT_STATE_PATH);
+}
+
+/**
+ * Check if an executable exists and responds to `--version`.
+ * @param {string} bin
+ * @returns {boolean}
+ */
+function canRunBinary(bin) {
+  const res = spawnSync(bin, ["--version"], { stdio: "ignore" });
+  return !res.error && res.status === 0;
+}
+
+/**
+ * Detect Antigravity IDE or VS Code CLI binary if available.
+ * @param {boolean} includeVscode
+ * @returns {string | null}
+ */
+function detectIdeCli(includeVscode) {
+  const candidates = [
+    "antigravity",
+    "/Applications/Antigravity.app/Contents/Resources/app/bin/antigravity",
+    "/Applications/Google Antigravity.app/Contents/Resources/app/bin/antigravity",
+  ];
+  if (includeVscode) {
+    candidates.push("code");
+  }
+  for (const bin of candidates) {
+    if (canRunBinary(bin)) {
+      return bin;
+    }
+  }
+  return null;
+}
+
+function printHelp() {
+  console.log(`backeer-agy v${PKG_JSON.version} — Google Antigravity Otomatik Onay Eklentisi
+
+Kullanım:
+  npx backeer-agy install [--vscode] [--skip-vsix]   AGY eklentisini (ve varsa IDE .vsix paketini) kurar
+  npx backeer-agy uninstall                          AGY eklentisini kaldırır
+  npx backeer-agy status                             Aktif onay modunu ve kurulum durumunu gösterir
+  npx backeer-agy mode <all|files_only|readonly|off> Çalışma modunu değiştirir
+  npx backeer-agy export-vsix [dizin]                IDE .vsix dosyasını belirtilen dizine kopyalar
+  npx backeer-agy --version                          Sürüm bilgisini yazdırır
+`);
+}
+
+/**
+ * @param {string[]} flags
+ * @returns {number}
+ */
+function cmdInstall(flags) {
+  if (!canRunBinary("agy")) {
+    console.error(
+      "Hata: 'agy' komutu bulunamadı. Lütfen önce Google Antigravity CLI'nin kurulu olduğundan emin olun."
+    );
+    return 1;
+  }
+
+  console.log("→ AGY native eklentisi kuruluyor (backeer-agy)...");
+  const installRes = spawnSync("agy", ["plugin", "install", PACKAGE_ROOT], {
+    stdio: "inherit",
+  });
+  if (installRes.error || installRes.status !== 0) {
+    console.error("Hata: 'agy plugin install' başarısız oldu.");
+    return installRes.status || 1;
+  }
+  console.log("✔ AGY native eklentisi kuruldu.");
+
+  if (flags.includes("--skip-vsix")) {
+    return 0;
+  }
+
+  if (!fs.existsSync(BUNDLED_VSIX)) {
+    console.warn(`Uyarı: Paketlenmiş VSIX bulunamadı: ${BUNDLED_VSIX}`);
+    return 0;
+  }
+
+  const ideBin = detectIdeCli(flags.includes("--vscode"));
+  if (ideBin) {
+    console.log(`→ Durum çubuğu eklentisi kuruluyor (${ideBin})...`);
+    const vsixRes = spawnSync(ideBin, ["--install-extension", BUNDLED_VSIX], {
+      stdio: "inherit",
+    });
+    if (!vsixRes.error && vsixRes.status === 0) {
+      console.log("✔ Durum çubuğu (.vsix) eklentisi kuruldu.");
+      return 0;
+    }
+  }
+
+  console.log(
+    "\nℹ IDE Durum Çubuğu düğmesini kurmak için:\n" +
+      "  1) 'npx backeer-agy export-vsix' komutuyla .vsix dosyasını çalışma klasörünüze çıkarın,\n" +
+      "  2) Antigravity IDE'de Cmd+Shift+P → 'Extensions: Install from VSIX...' menüsünden seçin."
+  );
+  return 0;
+}
+
+/**
+ * @param {string[]} flags
+ * @returns {number}
+ */
+function cmdUninstall(flags) {
+  if (canRunBinary("agy")) {
+    console.log("→ AGY native eklentisi kaldırılıyor...");
+    spawnSync("agy", ["plugin", "uninstall", "backeer-agy"], {
+      stdio: "inherit",
+    });
+  }
+  const ideBin = detectIdeCli(flags.includes("--vscode"));
+  if (ideBin) {
+    spawnSync(
+      ideBin,
+      ["--uninstall-extension", "backeer.backeer-agy-statusbar"],
+      { stdio: "inherit" }
+    );
+  }
+  console.log("✔ Kaldırma işlemi tamamlandı.");
+  return 0;
+}
+
+/**
+ * @returns {number}
+ */
+function cmdStatus() {
+  const statePath = resolveStatePath();
+  const mode = readStateMode(statePath);
+  const info = MODES.find((m) => m.id === mode) || MODES[0];
+
+  console.log(`Aktif Mod   : ${mode} (${info.detail})`);
+  console.log(`Durum Dosyası: ${statePath}`);
+
+  if (canRunBinary("agy")) {
+    const listRes = spawnSync("agy", ["plugin", "list", "--json"], {
+      encoding: "utf8",
+    });
+    if (!listRes.error && listRes.status === 0) {
+      try {
+        const plugins = JSON.parse(listRes.stdout || "[]");
+        const found =
+          Array.isArray(plugins) &&
+          plugins.find((p) => p && p.name === "backeer-agy");
+        console.log(
+          `AGY Eklentisi: ${found ? "Kurulu" : "Kurulu değil ('npx backeer-agy install' çalıştırın)"}`
+        );
+      } catch {
+        // Ignore JSON parse errors
+      }
+    }
+  }
+  return 0;
+}
+
+/**
+ * @param {string | undefined} rawTargetMode
+ * @returns {number}
+ */
+function cmdMode(rawTargetMode) {
+  const candidate = /** @type {import("../vscode-extension/state_store").ApprovalMode} */ (
+    (rawTargetMode || "").trim().toLowerCase()
+  );
+  if (!VALID_MODE_IDS.has(candidate)) {
+    console.error(
+      `Hata: Geçersiz mod '${rawTargetMode || ""}'. Geçerli modlar: all, files_only, readonly, off`
+    );
+    return 1;
+  }
+  const statePath = resolveStatePath();
+  writeStateMode(statePath, candidate);
+  const info = MODES.find((m) => m.id === candidate) || MODES[0];
+  console.log(`✔ Mod güncellendi: ${candidate} — ${info.detail}`);
+  return 0;
+}
+
+/**
+ * @param {string | undefined} destArg
+ * @returns {number}
+ */
+function cmdExportVsix(destArg) {
+  if (!fs.existsSync(BUNDLED_VSIX)) {
+    console.error(`Hata: VSIX dosyası bulunamadı: ${BUNDLED_VSIX}`);
+    return 1;
+  }
+  const targetDir = path.resolve(destArg || process.cwd());
+  fs.mkdirSync(targetDir, { recursive: true });
+  const targetFile = path.join(targetDir, VSIX_FILENAME);
+  fs.copyFileSync(BUNDLED_VSIX, targetFile);
+  console.log(`✔ VSIX kopyalandı: ${targetFile}`);
+  return 0;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const sub = args[0];
+
+  if (!sub || sub === "help" || sub === "--help" || sub === "-h") {
+    printHelp();
+    return 0;
+  }
+  if (sub === "--version" || sub === "-v" || sub === "version") {
+    console.log(PKG_JSON.version);
+    return 0;
+  }
+  if (sub === "install") {
+    return cmdInstall(args.slice(1));
+  }
+  if (sub === "uninstall") {
+    return cmdUninstall(args.slice(1));
+  }
+  if (sub === "status") {
+    return cmdStatus();
+  }
+  if (sub === "mode") {
+    return cmdMode(args[1]);
+  }
+  if (sub === "export-vsix") {
+    return cmdExportVsix(args[1]);
+  }
+
+  console.error(`Bilinmeyen komut: ${sub}\n`);
+  printHelp();
+  return 1;
+}
+
+if (require.main === module) {
+  process.exitCode = main();
+}
+
+module.exports = { main };

package/hooks.json

@@ -0,0 +1,17 @@
+{
+  "file-access-auto-approve": {
+    "enabled": true,
+    "PreToolUse": [
+      {
+        "matcher": "read_file|write_file|edit_file|view_file|view_file_outline|view_code_item|write_to_file|replace_file_content|multi_replace_file_content|delete_file|list_dir|find_by_name|grep_search|run_command",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -B ./scripts/approve_file_access.py",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "backeer-agy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "Google Antigravity (AGY) plugin & IDE Status Bar extension to auto-approve non-sensitive file access and safe terminal commands.",
+  "author": "emresaracoglu",
+  "license": "MIT",
+  "bin": {
+    "backeer-agy": "./bin/cli.js"
+  },
+  "files": [
+    "plugin.json",
+    "hooks.json",
+    "assets/",
+    "scripts/",
+    "bin/",
+    "vscode-extension/backeer-agy-statusbar-1.1.0.vsix",
+    "vscode-extension/state_store.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:vsix": "python3 -B vscode-extension/build_vsix.py",
+    "prepack": "python3 -B vscode-extension/build_vsix.py",
+    "test": "PYTHONDONTWRITEBYTECODE=1 python3 -W error -m unittest discover -s tests -v"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "google-antigravity",
+    "antigravity",
+    "agy",
+    "agy-plugin",
+    "auto-approve",
+    "permissions",
+    "hooks",
+    "vscode-extension"
+  ]
+}

package/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "backeer-agy",
+  "displayName": "Backeer AGY Auto-Approve",
+  "version": "1.1.0",
+  "description": "Hassas dosyaları koruyarak dosya erişimlerini ve zararsız terminal komutlarını sessizce otomatik onaylayan, IDE Durum Çubuğu (Status Bar) destekli AGY eklentisi.",
+  "logo": "assets/logo.svg",
+  "suggestedPrompts": [
+    "Bu eklentinin hangi dosya erişimlerini ve terminal komutlarını otomatik onayladığını açıkla"
+  ]
+}