prosicht 1.5.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
@@ -38,7 +50,16 @@ Tür yüklemeyle birlikte gönderilir (`manifest.kind`); sunucu ayrıca dosyalar
 
 Yalnızca `index.html`, `css/`, `js/` ve `assets/` yüklenir (en fazla 50 MB, dosya başına 25 MB, 500 dosya). `/` ile başlayan yollar için uyarı verilir. Kayıtlı key panelde yenilendiyse CLI yenisini sorar.
 
-Seçenekler: `--key <key>`, `--host <url>`, `-y` (soruları atla; tür klasörden tespit edilir).
+Seçenekler: `--key <key>`, `--host <url>`, `-y` (soruları atla; tür klasörden tespit edilir), `-f, --force` (aşağıdaki iki denetimi atla, üzerine yaz).
+
+### Ortak çalışma (CLI 1.6+)
+
+İçeriğin sahibi Pro veya Ekip planındaysa panelden başka hesapları (ücretsiz olabilir) içeriğe ekler. Eklenen kişi panelde **Benimle paylaşılanlar** altından:
+1. **Kaynak dosyalarını indir** ile yayındaki sürümü ZIP olarak alır ve açar (içinde `AGENTS.md` ve key'siz `.prosicht/publish.json` var),
+2. **Yayın keyi al** ile kendine ait keyi alır,
+3. klasörde `npx prosicht publish` çalıştırır; key ilk seferde sorulur.
+
+Her yayından sonra klasörün hangi sürümün üzerine kurulu olduğu `.prosicht/publish.json`'a (`baseVersion`) yazılır ve sonraki yayında gönderilir. Bu arada başka biri (sahip ya da başka bir ortak çalışan) yeni sürüm yayınladıysa yayın reddedilir; güncel kaynağı indirip değişiklikleri aktarın ya da bilerek üzerine yazmak için `--force` kullanın. Klasörün ait olduğu içerikten başka bir içeriğin keyi girilirse de yayın reddedilir (`--force` ile o içeriğe yayınlanır). Sahibin planı ortak çalışmayı artık içermiyorsa ortak çalışanların yayını reddedilir.
 
 ## Sunum hazırlama
 

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}`);
@@ -282,6 +309,7 @@ program
   .option('-k, --key <key>', 'Panelden alinan 32 karakterlik yayin keyi')
   .option('--host <url>', 'Yayin adresi (varsayilan: https://deck.prosicht.com)')
   .option('-y, --yes', 'Sorulari atla: tur klasorden tespit edilir, key kaydedilir')
+  .option('-f, --force', 'Bu klasorden sonra yayinlanan surumun ve klasorun ait oldugu icerigin denetimini atla (uzerine yazar)')
   .action((options) => publish(options));
 
 program.parse(process.argv);

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/lib/publish.js

@@ -62,12 +62,17 @@ async function chooseHost(saved, flag) {
   return normalizeHost(custom);
 }
 
-async function chooseKey(saved, flag) {
+async function chooseKey(saved, flag, config = {}) {
   if (flag) return KEY_PATTERN.test(flag) ? flag : fail('Key 32 karakter olmali (harf ve rakam).');
   if (saved && KEY_PATTERN.test(saved)) {
     console.log(`Kayitli key kullaniliyor (....${saved.slice(-4)}). Degistirmek icin: --key`);
     return saved;
   }
+  // panelden indirilen klasör: hangi içeriğe ait olduğu belli, key kişiye özel
+  if (config.deckId && config.url) {
+    console.log(`Bu klasor ${config.url} icerigine ait. Keyinizi panelden alin:`);
+    console.log('  sahibiyseniz Iceriklerim, ortak calisiyorsaniz Benimle paylasilanlar -> Yayin keyi al.');
+  }
   return ask({
     type: 'password', name: 'key', message: 'Lutfen keyi giriniz',
     validate: (v) => (KEY_PATTERN.test(String(v).trim()) ? true : 'Key 32 karakter olmali (harf ve rakam)'),
@@ -75,10 +80,13 @@ async function chooseKey(saved, flag) {
   });
 }
 
-// Sunucu türü dosyalardan da anlar; kind yine de gönderilir (panelde rozet, MCP'de doğru kit)
-async function upload(host, key, files, title, kind) {
+// Sunucu türü dosyalardan da anlar; kind yine de gönderilir (panelde rozet, MCP'de doğru kit).
+// base: klasörün geldiği içerik ve sürüm; arada başkası yayınladıysa sunucu reddeder (409)
+async function upload(host, key, files, title, kind, base) {
   const form = new FormData();
-  form.append('manifest', JSON.stringify({ title, kind, files: files.map((f) => ({ path: f.path, size: f.size })) }));
+  const manifest = { title, kind, files: files.map((f) => ({ path: f.path, size: f.size })) };
+  if (base) Object.assign(manifest, { deckId: base.deckId, baseVersion: base.version });
+  form.append('manifest', JSON.stringify(manifest));
   for (const f of files) {
     const type = MIME_TYPES[path.extname(f.path).toLowerCase()];
     form.append('files', new Blob([fs.readFileSync(f.abs)], { type }), path.basename(f.path));
@@ -100,6 +108,22 @@ const PANEL_CHOICE = { presentation: 'Sunum', blog: 'Blog yazisi' };
 
 function explain(status, body) {
   if (status === 401) fail('Key gecersiz veya yenilenmis. Panelden guncel keyi alin.');
+  if (status === 403 && body.code === 'collaboration_inactive') {
+    fail('Icerigin sahibinin plani ortak calismayi icermiyor (Pro veya Ekip gerekir); su an yalnizca sahibi yayinlayabilir.');
+  }
+  // indirildikten (ya da son yayından) sonra başka biri yeni sürüm yayınlamış
+  if (status === 409 && body.code === 'version_conflict') {
+    fail(`Bu klasor surum ${body.baseVersion} uzerine kurulu, ama bu arada surum ${body.version} yayinlanmis. Yayinlarsaniz o surumdeki degisiklikler kaybolur.`, [
+      'Panelden "Kaynak dosyalarini indir" ile guncel surumu alip degisikliklerinizi ona aktarin, sonra tekrar yayinlayin.',
+      'Ya da bilerek uzerine yazmak icin: npx prosicht publish --force'
+    ]);
+  }
+  if (status === 409 && body.code === 'deck_mismatch') {
+    fail(`Bu klasor ${body.folderDeckId} icerigine ait, girilen key ise ${body.deckId} icerigine.`, [
+      'Klasorun ait oldugu icerigin keyini --key ile verin.',
+      `Klasoru bilerek ${body.deckId} uzerine yayinlamak icin: npx prosicht publish --force`
+    ]);
+  }
   // key, daha önce başka türde yayınlanmış bir içeriğe ait
   if (status === 409 && DATIVE[body.deckKind] && NOUN[body.kind]) {
     fail(`Bu key bir ${DATIVE[body.deckKind]} ait; bu klasordeki icerik bir ${NOUN[body.kind]}.`, [
@@ -145,14 +169,18 @@ async function publish(options = {}) {
 
   const config = readConfig(root);
   const host = await chooseHost(options.host ? null : config.host, options.host);
-  let key = await chooseKey(options.key ? null : config.key, options.key);
+  let key = await chooseKey(options.key ? null : config.key, options.key, config);
   if (!key) process.exit(0);
 
+  // --force: çakışma denetimi yok, klasör keyin içeriğine yayınlanır
+  const base = !options.force && config.deckId && Number.isInteger(config.baseVersion)
+    ? { deckId: config.deckId, version: config.baseVersion }
+    : null;
   const title = readTitle(root, kind);
   const send = async () => {
     console.log(`\n[Pro Sicht] ${files.length} dosya (${formatBytes(total)}) yukleniyor...`);
     try {
-      return await upload(host, key, files, title, kind);
+      return await upload(host, key, files, title, kind, base);
     } catch (error) {
       return fail(`${host} adresine ulasilamadi: ${error.cause?.code || error.message}`);
     }
@@ -161,28 +189,37 @@ async function publish(options = {}) {
   // kayıtlı key panelden yenilenmişse bir kez yenisini sor ve tekrar dene
   if (result.status === 401 && key === config.key && !options.key && !options.yes) {
     console.log('Kayitli key gecersiz; panelde yenilenmis olabilir.');
-    key = await chooseKey(null, null);
+    key = await chooseKey(null, null, config);
     if (!key) process.exit(0);
     result = await send();
   }
   if (result.status !== 200 || !result.body.url) explain(result.status, result.body);
 
-  const { url, privacy, version } = result.body;
+  const { url, privacy, version, deckId, role } = result.body;
   console.log(`Yayinlandi (${label}, surum ${version}): ${url}`);
-  if (privacy === 'private') {
+  // ortak çalışan gizliliği değiştiremez; yalnızca sahibi
+  if (role === 'collaborator') {
+    console.log(privacy === 'private'
+      ? 'Gizlilik: yalnizca sahibi ve ortak calisanlar gorebilir. Paylasmayi sahibi panelden acar.'
+      : `Gizlilik: ${privacy === 'password' ? 'baglanti ve sifreyle' : 'baglantiya sahip herkes'} gorebilir (sahibinin ayari).`);
+  } else if (privacy === 'private') {
     console.log('Gizlilik: yalnizca siz gorebilirsiniz. Paylasmak icin panelden "Baglantiya sahip herkes" secin.');
   } else {
     console.log('Gizlilik: baglantiya sahip herkes gorebilir.');
   }
 
+  // baseVersion her yayında güncellenir: sonraki yayın bu sürümün üzerine kurulu sayılır
+  const published = { deckId, url, baseVersion: version };
   if (config.key !== key || config.host !== host) {
     const remember = options.yes ? true : await ask({
       type: 'confirm', name: 'save', initial: true,
       message: 'Key ve adres bu klasor icin kaydedilsin mi? (.prosicht/, git disi)'
     });
-    if (remember) saveConfig(root, { host, key, deckId: result.body.deckId, url });
+    const rest = { ...config };
+    delete rest.key;
+    saveConfig(root, remember ? { ...rest, host, key, ...published } : { ...rest, host, ...published });
   } else {
-    saveConfig(root, { ...config, deckId: result.body.deckId, url });
+    saveConfig(root, { ...config, ...published });
   }
   console.log('');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prosicht",
-  "version": "1.5.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",