@rbinar/dev-kit 1.0.0

package/README.md

@@ -0,0 +1,103 @@
+# @blinkbrosai/dev-kit
+
+VS Code Copilot Agent Mode için blink.dev ajan sistemini projelerinize kuran CLI aracı.
+
+## Kurulum
+
+```bash
+npm install -g @blinkbrosai/dev-kit
+```
+
+> Node.js ≥18 gerektirir.
+
+## Kullanım
+
+### İlk kurulum
+
+```bash
+blink-dev init --key=SIFRE
+```
+
+Bu komut:
+- `.github/agents/` altına 14 uzmanlaşmış ajan dosyasını kurar
+- `.github/prompts/` altına prompt dosyalarını kurar
+- `.github/copilot-instructions.md` dosyasını oluşturur (mevcut içeriği korur)
+- `.blink/` scaffold dizinini oluşturur
+
+### Güncelleme
+
+```bash
+blink-dev update --key=SIFRE
+```
+
+Mevcut kurulumu en son sürüme günceller. Güncelleme öncesi otomatik backup alır.
+
+### Durum kontrolü
+
+```bash
+blink-dev status
+```
+
+Kurulu versiyon, ajan sayısı ve kurulum tarihini gösterir.
+
+### Sağlık kontrolü
+
+```bash
+blink-dev doctor
+```
+
+Kurulumun bütünlüğünü doğrular: eksik dosyalar, bozuk frontmatter, kırık handoff'lar.
+
+## Seçenekler
+
+| Seçenek | Komutlar | Açıklama |
+|---|---|---|
+| `--key <şifre>` | init, update | Şifreleme anahtarı |
+| `--force` | init | Mevcut kurulumu ez |
+| `--dry-run` | init, update | Değişiklikleri göster, uygulamadan |
+
+## Ortam Değişkenleri
+
+| Değişken | Açıklama |
+|---|---|
+| `BLINK_DEV_KEY` | `--key` yerine kullanılabilir |
+
+## Proje Yapısı (kurulum sonrası)
+
+```
+projeniz/
+├── .github/
+│   ├── agents/          ← 14 ajan dosyası
+│   ├── prompts/         ← prompt dosyaları
+│   └── copilot-instructions.md
+├── .blink/              ← proje konvansiyonları (scaffold)
+│   ├── architecture.md
+│   ├── conventions.md
+│   ├── stack.md
+│   ├── testing.md
+│   └── todo.md
+└── .blink-dev-version   ← versiyon takip dosyası
+```
+
+## Ajanlar
+
+| Ajan | Rol |
+|---|---|
+| blink.dev.Triage | Görev seçimi ve önceliklendirme |
+| blink.dev.Planner | Araştırma ve plan üretimi |
+| blink.dev.Coordinator | Paralel yürütme |
+| blink.dev.Reviewer | Kalite kapısı |
+| blink.dev.Shipper | Build, PR, merge, tag |
+| blink.dev.Debugger | Hata ayıklama |
+| blink.dev.Security | Güvenlik denetimi |
+| blink.dev.Analyst | Kod sağlığı analizi |
+| blink.dev.Scribe | Dokümantasyon |
+| blink.dev.Critic | Özellik eleştirisi |
+| blink.dev.Brainstorm | Fikir üretimi |
+| blink.dev.Ops | Sunucu teşhisi |
+| blink.dev.Initializer | Proje scaffold |
+| blink.dev.Guardian | Risk değerlendirme |
+
+## Lisans
+
+Tüm hakları saklıdır. Yeniden dağıtım yasaktır.

package/bin/cli.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+'use strict';
+
+const { Command } = require('commander');
+const { version } = require('../package.json');
+const readline = require('readline');
+
+/**
+ * Anahtar çözümleme: option → env → interaktif prompt
+ */
+async function resolveKey(options) {
+  if (options.key) return options.key;
+  if (process.env.BLINK_DEV_KEY) return process.env.BLINK_DEV_KEY;
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question('Anahtar: ', (answer) => {
+      rl.close();
+      if (!answer || !answer.trim()) {
+        console.error('Hata: Anahtar belirtilmedi.');
+        process.exit(1);
+      }
+      resolve(answer.trim());
+    });
+  });
+}
+
+const program = new Command();
+
+program
+  .name('blink-dev')
+  .description('blink.dev agent dosyalarını yönetme CLI aracı')
+  .version(version);
+
+// init
+program
+  .command('init')
+  .description('Agent dosyalarını projeye kur')
+  .option('--key <password>', 'Şifre')
+  .option('--force', 'Mevcut kurulumu ez', false)
+  .option('--dry-run', 'Sadece göster, değişiklik yapma', false)
+  .action(async (options) => {
+    try {
+      const key = await resolveKey(options);
+      await require('../lib/commands/init')({ key, force: options.force, dryRun: options.dryRun });
+    } catch (err) {
+      console.error('init hatası:', err.message);
+      process.exit(1);
+    }
+  });
+
+// update
+program
+  .command('update')
+  .description('Mevcut kurulumu güncelle')
+  .option('--key <password>', 'Şifre')
+  .option('--dry-run', 'Sadece göster, değişiklik yapma', false)
+  .action(async (options) => {
+    try {
+      const key = await resolveKey(options);
+      await require('../lib/commands/update')({ key, dryRun: options.dryRun });
+    } catch (err) {
+      console.error('update hatası:', err.message);
+      process.exit(1);
+    }
+  });
+
+// status
+program
+  .command('status')
+  .description('Kurulum durumunu göster')
+  .action(async () => {
+    try {
+      await require('../lib/commands/status')();
+    } catch (err) {
+      console.error('status hatası:', err.message);
+      process.exit(1);
+    }
+  });
+
+// doctor
+program
+  .command('doctor')
+  .description('Kurulumu doğrula ve sorunları raporla')
+  .action(async () => {
+    try {
+      await require('../lib/commands/doctor')();
+    } catch (err) {
+      console.error('doctor hatası:', err.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/bundle/manifest.json

@@ -0,0 +1,23 @@
+{
+  "version": "1.0.0",
+  "createdAt": "2026-04-05T15:05:51.237Z",
+  "files": [
+    "agents/Analyst.agent.md",
+    "agents/Brainstorm.agent.md",
+    "agents/Coordinator.agent.md",
+    "agents/Critic.agent.md",
+    "agents/Debugger.agent.md",
+    "agents/Guardian.agent.md",
+    "agents/Initializer.agent.md",
+    "agents/Ops.agent.md",
+    "agents/Planner.agent.md",
+    "agents/Reviewer.agent.md",
+    "agents/Scribe.agent.md",
+    "agents/Security.agent.md",
+    "agents/Shipper.agent.md",
+    "agents/Triage.agent.md",
+    "prompts/blink-dev-close-issue.prompt.md",
+    "copilot-instructions.md"
+  ],
+  "checksum": "ee5f3bdae4c8f6689997769770b28d0c42b5523b902cbe7d6bf3407958a627bc"
+}

package/lib/commands/doctor.js

@@ -0,0 +1,251 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { isInitialized } = require('../installer');
+const {
+  TARGET_AGENTS_DIR,
+  TARGET_BLINK_DIR,
+  TARGET_INSTRUCTIONS,
+  EXPECTED_AGENTS,
+  MARKER_START,
+  MARKER_END,
+  SCAFFOLD_FILES,
+} = require('../constants');
+
+/**
+ * Basit frontmatter kontrolü — `name:` ve `description:` satırlarını arar.
+ * Tam YAML parser kullanmaz.
+ */
+function checkFrontmatter(content) {
+  const lines = content.split('\n');
+  if (lines[0] !== '---') return false;
+
+  const endIdx = lines.indexOf('---', 1);
+  if (endIdx === -1) return false;
+
+  const block = lines.slice(1, endIdx).join('\n');
+  const hasName = /^name\s*:/m.test(block);
+  const hasDescription = /^description\s*:/m.test(block);
+
+  return hasName && hasDescription;
+}
+
+/**
+ * Agent dosyasındaki handoff referanslarını çıkarır.
+ * `agent: blink.dev.XYZ` → 'XYZ'
+ */
+function extractHandoffTargets(content) {
+  const targets = [];
+  const re = /^\s*agent\s*:\s*blink\.dev\.(\w+)/gm;
+  let match;
+  while ((match = re.exec(content)) !== null) {
+    targets.push(match[1]);
+  }
+  return targets;
+}
+
+async function doctor() {
+  const cwd = process.cwd();
+  const checks = [];
+
+  // ── Kontrol 1: Kurulum dosyası mevcut mu ──
+  const initialized = isInitialized(cwd);
+  checks.push({
+    name: 'Kurulum dosyası',
+    status: initialized ? 'ok' : 'error',
+    detail: initialized ? 'Kurulum dosyası mevcut' : 'Kurulum dosyası bulunamadı',
+  });
+
+  // ── Kontrol 2: Agent dizini mevcut mu ──
+  const agentsDir = path.join(cwd, TARGET_AGENTS_DIR);
+  const agentsDirExists = fs.existsSync(agentsDir);
+  checks.push({
+    name: 'Agent dizini',
+    status: agentsDirExists ? 'ok' : 'error',
+    detail: agentsDirExists ? 'Agent dizini mevcut' : 'Agent dizini bulunamadı',
+  });
+
+  // ── Kontrol 3: Beklenen agent dosyaları ──
+  const missingAgents = [];
+  for (const agent of EXPECTED_AGENTS) {
+    if (!fs.existsSync(path.join(agentsDir, agent))) {
+      missingAgents.push(agent.replace('.agent.md', ''));
+    }
+  }
+  const foundCount = EXPECTED_AGENTS.length - missingAgents.length;
+  const totalCount = EXPECTED_AGENTS.length;
+  if (missingAgents.length === 0) {
+    checks.push({
+      name: 'Agent dosyaları',
+      status: 'ok',
+      detail: `${totalCount}/${totalCount} agent dosyası mevcut`,
+    });
+  } else {
+    checks.push({
+      name: 'Agent dosyaları',
+      status: 'warn',
+      detail: `${foundCount}/${totalCount} agent dosyası mevcut (eksik: ${missingAgents.join(', ')})`,
+    });
+  }
+
+  // ── Kontrol 4: Agent YAML frontmatter geçerli mi ──
+  const brokenFrontmatter = [];
+  if (agentsDirExists) {
+    for (const agent of EXPECTED_AGENTS) {
+      const filePath = path.join(agentsDir, agent);
+      try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        if (!checkFrontmatter(content)) {
+          brokenFrontmatter.push(agent.replace('.agent.md', ''));
+        }
+      } catch {
+        // Dosya okunamadıysa frontmatter kontrolü atla (eksik dosya zaten Kontrol 3'te raporlandı)
+      }
+    }
+  }
+  if (brokenFrontmatter.length === 0) {
+    checks.push({
+      name: 'Agent frontmatter',
+      status: 'ok',
+      detail: 'Tüm agent dosyalarının frontmatter\'ı geçerli',
+    });
+  } else {
+    checks.push({
+      name: 'Agent frontmatter',
+      status: 'error',
+      detail: `${brokenFrontmatter.length} dosyada frontmatter bozuk: ${brokenFrontmatter.join(', ')}`,
+    });
+  }
+
+  // ── Kontrol 5: copilot-instructions.md mevcut ve marker'lar sağlam mı ──
+  const instructionsPath = path.join(cwd, TARGET_INSTRUCTIONS);
+  if (!fs.existsSync(instructionsPath)) {
+    checks.push({
+      name: 'copilot-instructions.md',
+      status: 'error',
+      detail: 'Dosya bulunamadı',
+    });
+  } else {
+    try {
+      const content = fs.readFileSync(instructionsPath, 'utf8');
+      const startIdx = content.indexOf(MARKER_START);
+      const endIdx = content.indexOf(MARKER_END);
+
+      if (startIdx === -1 || endIdx === -1) {
+        checks.push({
+          name: 'copilot-instructions.md',
+          status: 'warn',
+          detail: 'Marker\'lar eksik',
+        });
+      } else if (startIdx >= endIdx) {
+        checks.push({
+          name: 'copilot-instructions.md',
+          status: 'warn',
+          detail: 'Marker sırası bozuk',
+        });
+      } else {
+        checks.push({
+          name: 'copilot-instructions.md',
+          status: 'ok',
+          detail: 'copilot-instructions.md sağlam',
+        });
+      }
+    } catch {
+      checks.push({
+        name: 'copilot-instructions.md',
+        status: 'error',
+        detail: 'Dosya okunamadı',
+      });
+    }
+  }
+
+  // ── Kontrol 6: .blink/ scaffold mevcut mi ──
+  const blinkDir = path.join(cwd, TARGET_BLINK_DIR);
+  const scaffoldKeys = Object.keys(SCAFFOLD_FILES);
+  const missingScaffold = [];
+  if (!fs.existsSync(blinkDir)) {
+    missingScaffold.push(...scaffoldKeys);
+  } else {
+    for (const file of scaffoldKeys) {
+      if (!fs.existsSync(path.join(blinkDir, file))) {
+        missingScaffold.push(file);
+      }
+    }
+  }
+  const scaffoldFound = scaffoldKeys.length - missingScaffold.length;
+  const scaffoldTotal = scaffoldKeys.length;
+  if (missingScaffold.length === 0) {
+    checks.push({
+      name: '.blink/ scaffold',
+      status: 'ok',
+      detail: `.blink/ scaffold tam (${scaffoldTotal}/${scaffoldTotal})`,
+    });
+  } else {
+    checks.push({
+      name: '.blink/ scaffold',
+      status: 'warn',
+      detail: `${missingScaffold.length}/${scaffoldTotal} dosya eksik`,
+    });
+  }
+
+  // ── Kontrol 7: Handoff hedefleri tutarlı mı ──
+  const brokenHandoffs = [];
+  if (agentsDirExists) {
+    for (const agent of EXPECTED_AGENTS) {
+      const filePath = path.join(agentsDir, agent);
+      try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        const targets = extractHandoffTargets(content);
+        for (const target of targets) {
+          const targetFile = `${target}.agent.md`;
+          if (!fs.existsSync(path.join(agentsDir, targetFile))) {
+            const source = agent.replace('.agent.md', '');
+            const entry = `blink.dev.${source} → ${targetFile} bulunamadı`;
+            if (!brokenHandoffs.includes(entry)) {
+              brokenHandoffs.push(entry);
+            }
+          }
+        }
+      } catch {
+        // Dosya okunamadıysa handoff kontrolü atla
+      }
+    }
+  }
+  if (brokenHandoffs.length === 0) {
+    checks.push({
+      name: 'Handoff hedefleri',
+      status: 'ok',
+      detail: 'Tüm handoff hedefleri mevcut',
+    });
+  } else {
+    checks.push({
+      name: 'Handoff hedefleri',
+      status: 'error',
+      detail: `${brokenHandoffs.length} kırık handoff: ${brokenHandoffs.join(', ')}`,
+    });
+  }
+
+  // ── Çıktı ──
+  const icons = { ok: '✅', warn: '⚠️ ', error: '❌' };
+  const lines = ['blink-dev sağlık raporu', '═══════════════════════', ''];
+
+  for (const check of checks) {
+    lines.push(`${icons[check.status]} ${check.detail}`);
+  }
+
+  const okCount = checks.filter((c) => c.status === 'ok').length;
+  const warnCount = checks.filter((c) => c.status === 'warn').length;
+  const errorCount = checks.filter((c) => c.status === 'error').length;
+
+  lines.push('');
+  lines.push(`Sonuç: ${okCount} başarılı, ${warnCount} uyarı, ${errorCount} hata`);
+
+  console.log(lines.join('\n'));
+
+  if (errorCount > 0) {
+    process.exit(1);
+  }
+}
+
+module.exports = doctor;

package/lib/commands/init.js

@@ -0,0 +1,184 @@
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const zlib = require('node:zlib');
+const { Readable } = require('node:stream');
+const { pipeline } = require('node:stream/promises');
+const tar = require('tar');
+
+const { decrypt } = require('../crypto');
+const {
+  installFiles,
+  mergeCopilotInstructions,
+  createScaffold,
+  isInitialized,
+  writeVersion,
+} = require('../installer');
+const {
+  BUNDLE_PATH,
+  TARGET_AGENTS_DIR,
+  TARGET_PROMPTS_DIR,
+} = require('../constants');
+
+/**
+ * Tarball buffer'ından dosya haritası çıkarır.
+ * @param {Buffer} tarBuffer - Gunzip edilmiş .tar.gz buffer
+ * @returns {Promise<{ fileMap: Map<string, Buffer>, copilotInstructions: string | null }>}
+ */
+async function extractFileMap(tarBuffer) {
+  const fileMap = new Map();
+  let copilotInstructions = null;
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'blink-dev-'));
+  const tmpTarGz = path.join(tmpDir, 'bundle.tar.gz');
+
+  try {
+    // 1. Buffer'ı geçici dosyaya yaz
+    fs.writeFileSync(tmpTarGz, tarBuffer);
+
+    // 2. Geçici dizine extract et
+    const extractDir = path.join(tmpDir, 'extracted');
+    fs.mkdirSync(extractDir, { recursive: true });
+
+    await tar.x({
+      file: tmpTarGz,
+      cwd: extractDir,
+    });
+
+    // 3. Extract edilen dosyaları oku ve fileMap'e ekle
+    function walkDir(dir, prefix) {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relPath = prefix ? path.join(prefix, entry.name) : entry.name;
+
+        if (entry.isDirectory()) {
+          walkDir(fullPath, relPath);
+        } else if (entry.isFile()) {
+          const content = fs.readFileSync(fullPath);
+          const mapped = mapFilePath(relPath);
+
+          if (mapped === null) {
+            // copilot-instructions.md — ayrı tut
+            copilotInstructions = content.toString('utf8');
+          } else if (mapped) {
+            fileMap.set(mapped, content);
+          }
+        }
+      }
+    }
+
+    walkDir(extractDir, '');
+  } finally {
+    // Geçici dosyaları temizle
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+
+  return { fileMap, copilotInstructions };
+}
+
+/**
+ * Tarball içi yolu hedef yola dönüştürür.
+ * @param {string} entryPath - Tarball içi dosya yolu
+ * @returns {string | null} - null = copilot-instructions.md (ayrı merge)
+ */
+function mapFilePath(entryPath) {
+  // Normalize separators
+  const normalized = entryPath.split(path.sep).join('/');
+
+  if (normalized === 'copilot-instructions.md') {
+    return null;
+  }
+
+  if (normalized.startsWith('agents/')) {
+    return path.join(TARGET_AGENTS_DIR, normalized.slice('agents/'.length));
+  }
+
+  if (normalized.startsWith('prompts/')) {
+    return path.join(TARGET_PROMPTS_DIR, normalized.slice('prompts/'.length));
+  }
+
+  // Diğer dosyalar olduğu gibi kalsın
+  return normalized;
+}
+
+/**
+ * blink-dev init --key=SIFRE komutu handler'ı.
+ * @param {{ key: string, force?: boolean, dryRun?: boolean }} options
+ */
+async function init({ key, force = false, dryRun = false }) {
+  const cwd = process.cwd();
+
+  // 1. Kurulum kontrolü
+  if (isInitialized(cwd) && !force) {
+    console.error('Bu proje zaten blink-dev ile kurulmuş. --force ile yeniden kurabilirsiniz.');
+    process.exit(1);
+  }
+
+  // 2. Bundle oku
+  let encBuffer;
+  try {
+    encBuffer = fs.readFileSync(BUNDLE_PATH);
+  } catch (_) {
+    console.error('Bundle dosyası bulunamadı: ' + BUNDLE_PATH);
+    process.exit(1);
+  }
+
+  // 3. Decrypt
+  let tarBuffer;
+  try {
+    tarBuffer = decrypt(encBuffer, key);
+  } catch (_) {
+    console.error('Hata: Geçersiz anahtar.');
+    process.exit(1);
+  }
+
+  // 4. Extract
+  const { fileMap, copilotInstructions } = await extractFileMap(tarBuffer);
+
+  // 5. Dry-run kontrolü
+  if (dryRun) {
+    const result = installFiles(fileMap, cwd, { dryRun: true });
+    if (result.installed.length > 0) {
+      console.log('Kurulacak dosyalar:');
+      for (const f of result.installed) {
+        console.log('  ' + f);
+      }
+    }
+    if (result.skipped.length > 0) {
+      console.log('Atlanacak dosyalar:');
+      for (const f of result.skipped) {
+        console.log('  ' + f);
+      }
+    }
+    return;
+  }
+
+  // 6. Dosyaları yaz
+  const { installed, skipped } = installFiles(fileMap, cwd, { force });
+
+  // 7. Copilot instructions merge
+  if (copilotInstructions) {
+    mergeCopilotInstructions(copilotInstructions, cwd);
+  }
+
+  // 8. Scaffold oluştur
+  const scaffold = createScaffold(cwd);
+
+  // 9. Versiyon yaz
+  writeVersion(cwd, require('../../package.json').version);
+
+  // 10. Başarı mesajı
+  console.log('');
+  console.log('✅ blink-dev başarıyla kuruldu!');
+  console.log('');
+  console.log('📁 Kurulan dosyalar: ' + installed.length);
+  console.log('⏩ Atlanan dosyalar: ' + skipped.length);
+  console.log('📝 .blink/ scaffold: ' + scaffold.created.length + ' dosya oluşturuldu');
+  console.log('');
+  console.log('Sonraki adım: VS Code Agent Mode\'u açın ve ajanları kullanmaya başlayın.');
+}
+
+module.exports = init;