prosicht 1.6.0 → 1.7.0

package/README.md

@@ -25,6 +25,18 @@ npx prosicht update
 ```
 Sunum klasörlerinde `update` yalnızca çekirdek dosyaları (`index.html`, `css/core/`, `js/core/`, `AGENTS.md`) yeniler; `js/scenes.js`, `js/sims/`, `css/theme.css`, `css/sims/`, `assets/` ve `sources.md` dokunulmadan kalır. Blog klasörlerinde de yalnızca çekirdek yenilenir (`js/post.js`, `js/sims/`, `css/theme.css`, `css/sims/`, `assets/`, `sources.md` dokunulmaz). Eski (1.x) klasör yapısındaki sunumlar onayla yeni yapıya taşınır (`--yes` sormadan taşır). Sunum ve blog aynı çekirdek yollarını kullanır: bir kitin klasörüne diğeri yazılmadan önce onay istenir, `--yes` ile bu durumda işlem yapılmaz.
 
+### Projeye özel kurallar
+
+`init` ve `update`, `AGENTS.md`'yi şablondan baştan yazar. Projeye özel kuralları (ör. Next.js şablonunu Nuxt'a uyarlayan eşlemeler) şu işaretler arasına yazın; CLI bu bloğu olduğu gibi korur ve yeni şablonda ilk `## ` başlığının önüne (başlık ve giriş paragrafından sonra) koyar:
+
+```markdown
+<!-- BEGIN:project-overrides -->
+## 0. Project Overrides
+- ...
+<!-- END:project-overrides -->
+```
+İşaretler eksik, ters sırada ya da birden fazlaysa CLI hata verir ve `AGENTS.md`'ye dokunmaz. Uygulama şablonlarında ve sunum / blog kitlerinde aynı şekilde çalışır (CLI 1.7+).
+
 ## Yayınlama
 
 ```bash

package/index.js

@@ -8,6 +8,7 @@ const { version } = require('./package.json');
 const { detectLayout } = require('./lib/layout');
 const { migrateV1 } = require('./lib/migrate');
 const { publish } = require('./lib/publish');
+const { insertOverrides, readExistingOverrides } = require('./lib/overrides');
 
 // PROSICHT_TEMPLATES_URL: sablonlari push etmeden yerel bir sunucudan denemek icin
 const BASE_URL = (process.env.PROSICHT_TEMPLATES_URL || 'https://raw.githubusercontent.com/ProSicht/ai-standards/main/templates').replace(/\/+$/, '');
@@ -71,6 +72,26 @@ function withTemplateTag(content, templateKey) {
   return `<!-- template: ${templateKey} -->\n` + content.replace(TAG_PATTERN, '');
 }
 
+// Yeni AGENTS.md: şablon + etiket + projedeki mevcut AGENTS.md'nin proje bloğu (varsa)
+function buildAgentsMd(content, templateKey, overrides) {
+  return withTemplateTag(overrides ? insertOverrides(content, overrides) : content, templateKey);
+}
+
+// Mevcut AGENTS.md'nin proje bloğu; işaretler bozuksa hatayı yazar ve undefined döner (hiçbir şey yazılmaz)
+function loadOverrides() {
+  try {
+    return readExistingOverrides(process.cwd());
+  } catch (error) {
+    console.error(`Hata: ${error.message} AGENTS.md degistirilmedi.`);
+    process.exitCode = 1;
+    return undefined;
+  }
+}
+
+function reportOverrides(overrides) {
+  if (overrides) console.log('Projeye ozel blok (project-overrides) korundu.');
+}
+
 async function download(url) {
   const response = await fetch(url);
   if (!response.ok) {
@@ -117,14 +138,17 @@ async function askTemplate(message) {
 async function fetchAndSaveTemplate(templateKey) {
   const selected = APP_TEMPLATES[templateKey];
   const fileUrl = `${BASE_URL}/${selected.file}`;
+  const overrides = loadOverrides();
+  if (overrides === undefined) return;
   console.log(`\n[Pro Sicht] "${selected.name}" sablonu indiriliyor...`);
 
   try {
     const content = (await download(fileUrl)).toString('utf8');
     const targetPath = path.join(process.cwd(), 'AGENTS.md');
-    fs.writeFileSync(targetPath, withTemplateTag(content, templateKey), 'utf8');
+    fs.writeFileSync(targetPath, buildAgentsMd(content, templateKey, overrides), 'utf8');
 
     console.log(`Basarili: AGENTS.md kaydedildi! (Sablon: ${templateKey})`);
+    reportOverrides(overrides);
     console.log(`Konum: ${targetPath}\n`);
   } catch (error) {
     console.error('Indirme hatasi:', error.message);
@@ -169,6 +193,8 @@ async function installKit(key, mode, options = {}) {
     }
   }
 
+  const overrides = loadOverrides();
+  if (overrides === undefined) return;
   console.log(`\n[Pro Sicht] ${kit.name} ${mode === 'update' ? 'guncelleniyor' : 'indiriliyor'}...`);
 
   try {
@@ -188,7 +214,7 @@ async function installKit(key, mode, options = {}) {
       const url = `${base}/${job.file.split('/').map(encodeURIComponent).join('/')}`;
       let data = await download(url);
       if (job.file === 'AGENTS.md') {
-        data = Buffer.from(withTemplateTag(data.toString('utf8'), key), 'utf8');
+        data = Buffer.from(buildAgentsMd(data.toString('utf8'), key, overrides), 'utf8');
       }
       return { ...job, data };
     }));
@@ -211,6 +237,7 @@ async function installKit(key, mode, options = {}) {
     for (const job of kept) console.log(`  = ${job.file} (mevcut, korundu)`);
 
     console.log(`Basarili: ${files.length} dosya yazildi (${kit.name} v${manifest.version || '?'}).`);
+    if (files.some((file) => file.file === 'AGENTS.md')) reportOverrides(overrides);
     if (mode === 'init') {
       console.log('\nSonraki adimlar:');
       for (const step of kit.nextSteps) console.log(`  ${step}`);

package/lib/overrides.js

@@ -0,0 +1,42 @@
+const fs = require('fs');
+const path = require('path');
+
+// Projeye özel kurallar AGENTS.md içinde bu işaretler arasında durur; init ve update
+// şablonu yeniden yazarken bloğu olduğu gibi korur (ör. Next.js şablonunu Nuxt'a uyarlayan kurallar)
+const BEGIN = '<!-- BEGIN:project-overrides -->';
+const END = '<!-- END:project-overrides -->';
+
+function count(text, marker) {
+  return text.split(marker).length - 1;
+}
+
+// Bloğu (işaretler dahil) döndürür; blok yoksa null. Bozuk işaretlerde hata fırlatır:
+// yazmaya devam etmek bloğu sessizce siler.
+function extractOverrides(content) {
+  const begins = count(content, BEGIN);
+  const ends = count(content, END);
+  if (begins === 0 && ends === 0) return null;
+  const start = content.indexOf(BEGIN);
+  const end = content.indexOf(END);
+  if (begins !== 1 || ends !== 1 || end < start) {
+    throw new Error(`AGENTS.md icindeki proje blogu bozuk: tam olarak bir "${BEGIN}" ve ondan sonra bir "${END}" olmali.`);
+  }
+  return content.slice(start, end + END.length);
+}
+
+// Bloğu şablonun ilk "## " başlığının önüne koyar (başlık ve giriş paragrafından sonra);
+// başlık yoksa sona ekler
+function insertOverrides(content, block) {
+  const heading = content.search(/^## /m);
+  if (heading === -1) return `${content.replace(/\n*$/, '')}\n\n${block}\n`;
+  return `${content.slice(0, heading)}${block}\n\n${content.slice(heading)}`;
+}
+
+// Projedeki mevcut AGENTS.md'den blok; dosya yoksa null
+function readExistingOverrides(root) {
+  const file = path.join(root, 'AGENTS.md');
+  if (!fs.existsSync(file)) return null;
+  return extractOverrides(fs.readFileSync(file, 'utf8'));
+}
+
+module.exports = { BEGIN, END, extractOverrides, insertOverrides, readExistingOverrides };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prosicht",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Pro Sicht AI Standards CLI: AGENTS.md sablonlari, sunum ve blog altyapisi",
   "main": "index.js",
   "bin": {
@@ -14,7 +14,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --test"
   },
   "keywords": [
     "ai",